TACZ:Ammo Box

# TACZ Ammo Box

TACZ Ammo Box turns loose TACZ ammunition into a compact industrial supply chain: pack ammo into boxes and crates, fill TACZ ammo boxes by hand or with machines, and keep third-party gun packs working.

This is a TACZ 1.1.8 addon for Minecraft 1.20.1 / Forge.

## What it adds

- Ammo boxes and crates for TACZ ammunition
- 9 boxes <-> 1 crate
- 1 box -> one full stack of loose ammo
- Packer: loose ammo -> box, 9 boxes -> crate, and reverse
- Loader: fills TACZ ammo boxes from loose ammo, boxes or crates
- Manual V-key filling from the main hand or a hovered inventory slot
- Loose ammo aggregation from the player inventory, Curios and Sophisticated Backpacks
- Box/crate aggregation with configurable waste behavior
- Third-party ammo registration
- Generated models, textures and recipes for third-party ammo types
- Optional Create deployer, Jade, WTHIT, Curios and Sophisticated Backpacks integration

## Capacity compatibility

TACZ ammo box capacity normally follows:

ammo stack size x AmmoBoxStackSize x (AmmoLevel + 1)

This addon supports third-party capacity changes through:

- Automatic capacity detection
- Absolute capacity overrides
- Capacity multipliers
- round / floor / ceil rounding for fractional multipliers
- Native DCSharp compatibility for its 6 / 12 / 20 stack iron/gold/diamond boxes

Overrides can be set with commands or in config/taczammobox/settings.json.

## Manual filling

- Hold loose ammo, a box or a crate and press V to fill a matching ammo box.
- With an inventory open, hover ammo, a box or a crate and press V.
- Loose ammo fills as much as possible and never wastes.
- Boxes and crates follow the waste setting:
  - waste=true: the last package may be partially consumed and the remainder discarded
  - waste=false: filling stops before a package that does not fit
- When the held stack runs out, a matching item can be pulled from the inventory, Curios or supported backpacks.
- Auto refill can be disabled with /taczammobox autorefill false.

When a Sophisticated Backpacks GUI is open, boxes and ammo can be in the open backpack, the player inventory or Curios. Nested backpacks are intentionally ignored. Without an open backpack GUI, only the player inventory and Curios are searched.

## Machines

### Ammo Packer

- Two slots: input and output
- Packs loose ammo into boxes and 9 boxes into a crate
- Unpacks crates and boxes
- GUI mode switch
- Six-sided input/output/disabled configuration
- Redstone control
- Automatic item input/output
- Comparator progress output
- Drops its contents when broken

### Ammo Loader

- Three slots: ammo box input, source, ammo box output
- Accepts loose ammo, boxes or crates as source
- Loose ammo fills as much as possible
- Boxes and crates follow the waste setting
- Outputs a box only when it is full
- Six-sided configuration and redstone control
- Comparator output
- Drops its contents when broken

## Third-party gun packs

Add third-party ammo types in config/taczammobox/ammo_boxes.json, or run:

/taczammobox scan

Then restart the server. Generated recipes are placed in a data pack, with a runtime fallback when the data pack cannot be written.

## Requirements

- Minecraft 1.20.1
- Forge 47.3.19
- TACZ 1.1.8-hotfix2

Optional:

- Create 6.0.x
- Jade
- WTHIT
- Curios
- Sophisticated Backpacks

## Installation

1. Install Minecraft Forge 1.20.1.
2. Install TACZ 1.1.8-hotfix2.
3. Put taczammobox-1.20.1-0.1.0-beta.jar into the mods folder.
4. Install Create, Jade, WTHIT, Curios or Sophisticated Backpacks only if you want the optional integrations.

Server and clients must use the same jar and the same ammo_boxes.json. Run /taczammobox reload after editing settings.json.

## Beta note

This is a beta release. Back up your world and config before testing. When reporting an issue, include:

- Minecraft, Forge and TACZ versions
- Installed backpack/Curios/Create versions
- latest.log
- Steps to reproduce

## Links

- GitHub: https://github.com/jmywork/tacz-ammobox
- Issues: https://github.com/jmywork/tacz-ammobox/issues

---

## 中文简介

TACZ Ammo Box 是 TACZ 1.1.8 的弹药包装附属，适用于 Minecraft 1.20.1 / Forge。

它把散装弹药打包成盒和箱，提供打包机、装填机、手动 V 键装填、背包与 Curios 聚合，并兼容第三方枪包和自定义弹药盒容量。

- 9 盒 <-> 1 箱
- 1 盒 -> 一组散弹
- 打包机：散弹 <-> 盒 <-> 箱
- 装填机：自动把弹药装进 TACZ 弹药盒
- 支持绝对容量、倍率、round/floor/ceil 取整
- 原生兼容 DCSharp 的 6/12/20 组容量
- 可选 Create、Jade、WTHIT、Curios、精妙背包兼容

这是 beta 版本，测试前请备份世界和配置。