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). 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, **Shulker Boxes**, and even **Sophisticated Backpacks** to pull out loose ammo instantly.
* **⚙️ 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.
* **🖥️ Interactive Settings GUI**: Press the V key to open a visual UI. Players can toggle auto-crafting and freely exclude specific containers (like Shulker Boxes or Backpacks) from being scanned to protect their resources. (UI automatically hides if Sophisticated Backpacks is not installed).
* **🛡️ Snapshot & Verify Safety**: Uses a "scan first, verify, then deduct" architecture with overflow protection. It 100% prevents item duplication or swallowing bugs. The deduction order is strictly hardcoded for safety.
* **🔧 Dynamic Config Updates**: Server owners can tweak settings in the .toml file on the fly. No server restart required! (If it doesn't update immediately on some dedicated servers, simply type /reload once).

🎮 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. **Player Settings**: Press the **V** key to open the settings panel to toggle auto-crafting or exclude containers.

🔧 Server Configs

Located in serverconfig/ammotobox-server.toml:

• enableAutoCraft: Globally enable/disable auto-crafting.
• autoCraftDefault: Default auto-craft state for new players.
• maxCraftsPerOperation: Max crafting batches per operation.
• ammoBoxMaxCount: Maximum capacity per ammo box.
• compatShulkerBox: Allow extracting from Shulker Boxes.
• compatSophisticatedBackpacks: Allow extracting from Sophisticated Backpacks. *(Safe to leave as true even if the mod is not installed).*

📌 Dependencies

• **Requires**: Timeless and Classics Zero (TaCZ)
• **Optional**: Sophisticated Backpacks
• **Minecraft Version**: 1.20.1
• **Mod Loader**: Forge

📢 Project Status & Community-Driven Updates

The core features of AmmoToBox are now fully implemented. This mod has entered **Community-Driven Mode**.
Future updates will primarily focus on bug fixes and compatibility requests. If you want your favorite backpack mod to be supported, please leave a comment below! Your feedback decides the future of this mod.

📢 Community Co-creation Bonus!

AmmoToBox features a **"First-to-Suggest Naming Rights"** system. If you suggest a new feature or a mod compatibility, and I implement it:
👉 **The FIRST player who suggested it will have their name permanently engraved on the corresponding UI button!** (Press V in-game to see the UI).

**How to claim your spot:**
Leave a comment below using this exact format:
> "Suggest compatibility with [Mod Name], my game ID is: [Your ID]"

*Example: "Suggest compatibility with Travelers' Backpacks, my game ID is: Steve123"*
First come, first served! Leave your ideas below! 👇

******************************

弹药打包机 (AmmoToBox)

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

这是一个为 永恒枪械工坊：零 (TaCZ) 量身定制的轻量级实用模组。它可以让你一键将背包里的散装子弹打包进弹药箱，并在材料充足时自动为你现场合成子弹并装箱。

✨ 核心特性

* **⚡ 一键打包**：自动扫描主背包、**潜影盒内部**，以及**精妙背包**，瞬间提取所有同型号的散装弹药。
* **⚙️ 智能自动合成**：自动读取 TaCZ 枪械工作台配方。材料足够时，自动扣除材料并合成弹药直接装箱，完美支持物品标签。
* **🖥️ 交互式设置面板**：按下 **V** 键即可呼出可视化 UI。玩家可直观地开关自动合成，并自由选择排除不想被检索的容器（如潜影盒、精妙背包），防止误用珍贵材料。（*注：若未安装精妙背包，面板会自动隐藏其对应按钮*）。
* **🛡️ 快照校验，绝对安全**：采用“快照-校验-扣除”的严格事务机制与 long 防溢出保护，彻底杜绝刷物品/吞物品的 Bug。扣除顺序已采用安全的硬编码逻辑，无需担心配置出错。
* **🔧 极速热重载**：服主修改 .toml 配置文件并保存后，设置即刻生效，**无需重启服务器**！（若部分独立服务器未即时刷新，只需输入一次 /reload 即可）。

🎮 如何使用

1. **确定型号**：先手动往弹药箱里装入至少一发子弹。
2. **一键装填**：手持弹药箱，**潜行 (Shift) + 右键**。
3. **玩家设置**：按 **V** 键呼出面板，可直观管理自动合成状态与容器检索白名单。

🔧 服主配置说明

配置文件位于 serverconfig/ammotobox-server.toml：

• enableAutoCraft：全局启用/禁用自动合成。
• autoCraftDefault：新玩家的默认自动合成状态。
• maxCraftsPerOperation：单次打包允许的最大合成批次。
• ammoBoxMaxCount：单个弹药箱的最大容量。
• compatShulkerBox：是否允许从潜影盒中提取弹药/材料。
• compatSophisticatedBackpacks：是否允许从精妙背包中提取。*（即使未安装精妙背包，开启此项也完全安全，不会报错）*。

📌 前置依赖

• **必须安装**：永恒枪械工坊：零 (TaCZ)
• **可选依赖**：精妙背包 (Sophisticated Backpacks)
• **游戏版本**：1.20.1
• **加载器**：Forge

📢 模组状态与后续更新

弹药打包机的核心功能已全部开发完毕。本模组现正式进入**“社区驱动模式”**。
后续更新将主要以修复 Bug 和响应玩家需求为主。如果您希望兼容某款特定的背包模组，或者有绝佳的改进建议，请在评论区留言！你们的反馈将决定本模组未来的走向。

---

📢 社区共创福利（首发冠名制）

想要你的名字永久出现在模组的游戏内 UI 界面里吗？现在机会来了！
本模组开启了**“首发冠名制”**。如果你提出新功能或兼容建议且被我采纳：
👉 **第一个提出该建议的玩家，名字将被永久刻在对应的 UI 按钮上！**（游戏内按 V 键即可查看）。

**如何认领你的专属位置：**
请在下方评论区严格按照以下格式留言：
> 建议兼容 [模组名]，我的游戏ID是：[你的ID]

*名额有限，先到先得！快在下面留下你的点子，让我们一起把这个模组做得更好！👇*