TACZ:Ammo Box

# English

**0.4.0** · Minecraft 1.20.1 · Forge 47.3.19 · Requires **TACZ 1.2.0**

Pack loose ammo into boxes and crates, fill them automatically, and feed the gun itself with an ammo chain or an auto-fire magazine — the missing logistics layer between a cartridge and the chamber.

## ⚠ Compatibility

| Mod version | Supported TACZ |
|---|---|
| **0.4.0** | **TACZ 1.2.0+** |
| 0.3.0 and older | TACZ 1.1.8-hotfix2, **no 1.2.0 support** |

**No version below 0.4.0 supports TACZ 1.2.0.** Server and clients must run the same version (0.4.0 uses protocol 8, 0.3.0 uses 5), or connections are refused.

## What it does

- **Ammo packaging**: loose ammo → boxes → crates (9 boxes = 1 crate), plus box piles (up to 12 per pile)
- **Three machines**: Packer (ammo ↔ boxes ↔ crates), Loader (fills TACZ ammo boxes), Assembler (crafts ammo from TACZ gun smith table recipes)
- **Ammo chain**: keep it in your inventory and TACZ reloads pull rounds straight from boxes/crates/loose ammo — no ammo box needed
- **Auto-fire extended magazines**: turn bolt-action guns full auto, with the rate taken from TACZ's RPM formula
- **Satellite rack**: mounts up to 10 guns in a fan behind you; each gun picks its own target, press `X` to focus
- **TACZ 1.2.0 integration**: ammo storage tiers (iron/gold/diamond), the new `.300 BLK` ammo type, native 32x32 box icons

## What you can get

**Survival (craftable)**

- Ammo boxes / crates / box piles
- Packer, Loader, Assembler
- Ammo chain: 4 iron ingots + 4 leather + chest
- Service satellite rack: 4 netherite blocks + beacon + ammo chain + 2 dragon breath + dragon head
- Standard auto-fire magazines, crafted in the TACZ gun smith table:
  - I: 10 rounds / 200 RPM — sniper extended mag III + 4 netherite ingots + 4 nether stars
  - II: 20 rounds / 400 RPM — standard I + 4 netherite ingots + 4 nether stars
  - III: 30 rounds / 600 RPM — standard II + 8 netherite blocks

**Easter eggs (creative only, no recipes)**

- Auto ammo belt
- Easter auto-fire magazine III: 300 rounds / 1000 RPM / no recoil
- Easter satellite rack (10 guns)

**Keys**: `V` fill ammo box, `H` one-key pack, `X` mark satellite focus target (all rebindable).

## Commands

| Command | Description |
|---|---|
| `/taczammobox help` | Show common commands and config paths |
| `/taczammobox pack` | Pack full loose-ammo stacks into new boxes |
| `/taczammobox packtoggle <true\|false>` | Toggle one-key packing |
| `/taczammobox doctor` | Self-check config, generated assets and compatibility |
| `/taczammobox reload` | Reload every config and sync clients |
| `/taczammobox reloadrecipes` | Reload data packs and third-party recipes |
| `/taczammobox scan` | Scan third-party gun packs and add missing ammo types |
| `/taczammobox clean` / `cleanup [radius]` | Remove invalid ammo entries / orphan boxes |
| `/taczammobox dump` | Export loaded ammo types to JSON |
| `/taczammobox waste <true\|false>` | Whether partially fitting packages are wasted |
| `/taczammobox autorefill <true\|false>` | Auto-refill toggle |
| `/taczammobox capacity held <capacity>` | Override the held box's capacity |

## Things to know

- **Versions must match**: TACZ 1.2.0 needs 0.4.0; 0.3.0 and older only work with 1.1.8-hotfix2
- **Back up before updating**: 0.4.0 rewrites `autofire.json` and prunes retired attachments from the gun pack folder
- **Easter items are not balanced** and are creative-only; their tooltip says so
- **Old attachments disappear**: easter magazines I and II were removed; reinstall a magazine on guns that had them
- **Do not remove the mod casually**: standard magazines, the assembler and the chain belong to this mod and become missing items
- **The server game directory must be writable**: the gun pack is generated in `tacz/taczammobox_autofire/` on startup
- Optional integrations (not required): Create, JEI, Jade, WTHIT, Curios, Sophisticated Backpacks, DCSharp

Config lives in `config/taczammobox/`: `settings.json` (packing/filling speed, waste, refill), `features.json` (feature toggles), `autofire.json` (magazine capacity and RPM).

When reporting issues include `logs/latest.log`, TACZ version, mod version and reproduction steps. License GPL-3.0-only · Author jmywork

--------------------------------------------------------------

# TACZ：弹药压制 · TACZ: Ammo Suppression

**0.4.0** · Minecraft 1.20.1 · Forge 47.3.19 · 需要 **TACZ 1.2.0**

把散装子弹装成盒、箱，用机器自动装填，再用弹链和自动击发弹匣把弹药送进枪里——补上 TACZ 从「子弹」到「枪膛」的后勤链。

---

## ⚠ 兼容性提醒

| 模组版本 | 支持的 TACZ |
|---|---|
| **0.4.0** | **TACZ 1.2.0 及以上** |
| 0.3.0 及以下 | TACZ 1.1.8-hotfix2，**不支持 1.2.0** |

**0.4.0 以下的版本都不支持 TACZ 1.2.0。** 服务端与客户端必须是同一版本（0.4.0 协议 8，0.3.0 协议 5），否则会被拒绝连接。

---

## 我们做了什么

- **弹药包装**：散弹 → 弹药盒 → 弹药箱（9 盒 = 1 箱），还能摞成盒堆（每堆 12 盒）
- **三台机器**：打包机（散弹 ↔ 盒 ↔ 箱）、装填机（往 TACZ 弹药盒灌弹）、装配机（直接按 TACZ 枪械工作台配方产弹药）
- **供弹弹链**：放在背包里，TACZ 枪换弹时直接从盒/箱/散弹取弹，不用再带弹药盒
- **自动击发扩容弹匣**：把拉栓枪变成全自动，射速按弹匣档位走 TACZ 的 RPM 公式
- **浮游炮机架**：最多 10 把枪挂在背后展开成扇面，每把枪自己索敌，按 `X` 集火
- **TACZ 1.2.0 联动**：支持弹药库（铁/金/钻石）、新增 `.300 BLK` 弹种、盒箱图标用原生 32×32

## 能拿到什么

**生存内容（可合成）**

- 弹药盒 / 弹药箱 / 盒堆
- 打包机、装填机、装配机
- 供弹弹链：铁锭 ×4 + 皮革 ×4 + 箱子
- 制式浮游炮机架：下界合金块 ×4 + 信标 + 弹链 + 龙息 ×2 + 龙头
- 自动击发扩容弹匣（标准），在 TACZ 枪械工作台合成：
  - I：10 发 / 200 RPM ｜ 狙击扩容弹匣 III + 下界合金锭 ×4 + 下界之星 ×4
  - II：20 发 / 400 RPM ｜ 标准 I + 下界合金锭 ×4 + 下界之星 ×4
  - III：30 发 / 600 RPM ｜ 标准 II + 下界合金块 ×8

**彩蛋内容（创造模式限定，无合成表）**

- 自动供弹弹链
- 彩蛋自动击发扩容弹匣 III：300 发 / 1000 RPM / 无后座
- 彩蛋浮游炮机架（挂 10 把枪）

**按键**：`V` 装填弹药盒，`H` 一键打包，`X` 标记浮游炮集火目标（均可改键）。

## 指令

| 指令 | 作用 |
|---|---|
| `/taczammobox help` | 查看常用指令与配置位置 |
| `/taczammobox pack` | 一键把满组散弹打成新盒 |
| `/taczammobox packtoggle <true\|false>` | 开关一键打包 |
| `/taczammobox doctor` | 自检配置、生成资源与兼容状态 |
| `/taczammobox reload` | 重读全部配置并同步客户端 |
| `/taczammobox reloadrecipes` | 重载数据包与第三方配方 |
| `/taczammobox scan` | 扫描第三方枪包，追加缺失弹种 |
| `/taczammobox clean` / `cleanup [半径]` | 清理失效弹种 / 清理孤儿盒 |
| `/taczammobox dump` | 导出当前弹种到 JSON |
| `/taczammobox waste <true\|false>` | 盒/箱装不满时是否浪费 |
| `/taczammobox autorefill <true\|false>` | 自动补货开关 |
| `/taczammobox capacity held <容量>` | 覆盖主手盒子容量 |

## 需要注意

- **版本必须对得上**：TACZ 1.2.0 只能用 0.4.0；0.3.0 及以下只能用 1.1.8-hotfix2
- **更新前备份存档**：0.4.0 会重写 `autofire.json`，并清理枪包目录里的旧附件
- **彩蛋物品不参与平衡**，只有创造模式能拿到，物品说明会标注「彩蛋物品」
- **老存档会掉附件**：彩蛋弹匣 I / II 已删除，之前装过的枪需要重新装
- **别直接删模组**：标准弹匣、装配机、弹链都是本模组的物品，删除后会变成缺失物品
- **服务端目录要可写**：启动时会在 `tacz/taczammobox_autofire/` 生成枪包
- 可选联动（不装也能玩）：Create、JEI、Jade、WTHIT、Curios、精妙背包、DCSharp

配置在 `config/taczammobox/`：`settings.json`（打包/装填速度、浪费、补货）、`features.json`（功能开关）、`autofire.json`（弹匣弹容与射速）。

反馈请附 `logs/latest.log`、TACZ 版本、模组版本与复现步骤。协议 GPL-3.0-only · 作者 jmywork