AmmoToBox

# AmmoToBox
**Tired of manually clicking hundreds of loose bullets into your ammo boxes? Let AmmoToBox handle it for you!**

AmmoToBox is a lightweight utility mod designed for [Timeless and Classics Zero (TaCZ)](https://www.curseforge.com/minecraft/mc-mods/timeless-and-classics-zero). It allows you to instantly pack loose ammo and auto-craft missing rounds directly into your ammo boxes.

## ✨ Features
* **⚡ One-Click Packing**: Scans your main inventory, offhand, and even **Shulker Boxes** inside your inventory to pull out loose ammo.
* **⚙️ Smart Auto-Crafting**: Automatically reads TaCZ Gun Smith Table recipes. If you have the materials, it will auto-craft the bullets and put them directly into the box. Supports item tags perfectly.
* **🛡️ Absolutely Safe**: Uses a two-stage deduction algorithm (scan first, deduct later) with overflow protection. Never lose items due to glitches or stacking limits.
* **📜 Detailed Feedback**: Tells you exactly how many bullets were packed, how many were crafted, and which materials were consumed in the chat.
* **🔧 Highly Configurable**: Server owners can adjust the maximum capacity, toggle Shulker Box support, and globally disable auto-crafting.

## 🎮 How to Use
1. **Set the Ammo Type**: Manually put at least ONE bullet into an empty ammo box.
2. **One-Click Pack**: Hold the ammo box in your main hand, **Sneak (Shift) + Right-Click**.
3. **Toggle Auto-Craft**: Press the **`V`** key (configurable in controls) to turn auto-crafting ON/OFF.

## 🔧 Commands & Configs
For Server Owners, the config file is located in `serverconfig/ammotobox-server.toml`:
- `enableAutoCraft`: Globally enable/disable auto-crafting (default: true).
- `autoCraftDefault`: Default state for new players (default: true).
- `processShulkerBox`: Allow extracting from Shulker Boxes (default: true).
- `ammoBoxMaxCount`: Maximum capacity per ammo box (default: 2147483647).

## 📌 Dependencies
- **Requires**: [Timeless and Classics Zero (TaCZ)](https://www.curseforge.com/minecraft/mc-mods/timeless-and-classics-zero)
- **Minecraft Version**: 1.20.1
- **Mod Loader**: Forge

---
---

# 弹药打包机 (AmmoToBox)
**厌倦了手动把几百发零散子弹一发发塞进弹药箱？让弹药打包机来帮你！**

这是一个为 [永恒枪械工坊：零 (TaCZ)](https://www.curseforge.com/minecraft/mc-mods/timeless-and-classics-zero) 量身定制的轻量级实用模组。它可以让你一键将背包里的散装子弹打包进弹药箱，并在材料充足时自动为你现场合成子弹并装箱。

## ✨ 核心特性
* **⚡ 一键打包**：自动扫描主背包、副手，甚至**潜影盒内部**，找出所有同型号的散装弹药。
* **⚙️ 智能自动合成**：自动读取 TaCZ 枪械工作台配方。材料足够时，自动扣除材料并合成弹药直接装箱，完美支持物品标签。
* **🛡️ 绝对安全**：采用“先统计后扣除”的两阶段算法及 long 防溢出保护，彻底杜绝吞物品或刷物品的 Bug。
* **📜 详细反馈**：聊天栏会详细播报本次装入了多少发（其中多少是散装、多少是合成），以及具体消耗了哪些材料。
* **🔧 高度可定制**：服主可通过配置文件自由修改弹药箱容量上限、是否允许翻潜影盒、以及全服禁用合成。

## 🎮 如何使用
1. **确定型号**：先手动往弹药箱里装入至少一发子弹。
2. **一键装填**：手持弹药箱，**潜行 (Shift) + 右键**。
3. **切换合成**：按 `V` 键（可改键）开关自动合成。

## 📌 前置依赖
- **必须安装**：[永恒枪械工坊：零 (TaCZ)](https://www.curseforge.com/minecraft/mc-mods/timeless-and-classics-zero)
- **游戏版本**：1.20.1
- **加载器**：Forge