Guard’s Gun

En_US

TacZ Guard Compat

A NeoForge 1.21.1 compatibility mod that bridges [UNOFFICIAL] TaCZ 1.21.1 NeoForge Port and Guard Villagers , allowing guard villagers to wield and use TacZ firearms.

Features

Gun AI for Guards — Guards can pick up, draw, aim, and shoot TacZ guns. They position themselves at optimal range, strafe away from close targets, and check for friendly fire before shooting.

Ammo & Reload — Guards reload automatically when the magazine is empty. The reload bypasses inventory ammo checks (no backpack ammo consumed), and the gun refills to full capacity. Guards look up during reload as a visual indicator (configurable).

Death Drops — When a guard dies, it drops its held gun along with 1x to max-capacity of the corresponding ammo type (both configurable).

Probabilistic Spawn — Guards have a configurable chance (default 30%) to spawn with a random TacZ gun. An optional whitelist restricts which guns guards can receive.

Gun Data Respect — Damage, fire rate, and reload time all come from the gun’s data pack values — the guard’s gun behaves identically to the player’s.

Configuration

Config file: config/tacz_guard_compat-common.toml

| Option | Default | Description |
|——–|———|————-|
| gunSpawnChance | 0.3 | Probability a guard spawns with a gun (0.0–1.0) |
| allowedGuns | [] | Gun ID whitelist (e.g. ["tacz:ak47"]), empty = all |
| guardAttackRadius | 15.0 | Engagement range in blocks |
| guardAccuracy | 0.7 | Aim progress threshold (0.0–1.0), lower = faster but less accurate |
| reloadLookUp | true | Whether guards look up during reload |
| dropGunOnDeath | true | Drop held gun on death |
| dropAmmoOnDeath | true | Drop matching ammo (1–max capacity) on death |

Other

Before installing this mod, please back up your save files. This mod is still in the testing phase and may be unstable.

This mod is made by TRAE

Zh_CN

警卫村民的枪

一个为 NeoForge 1.21.1 开发的兼容模组，用于兼容 [UNOFFICIAL] TaCZ 1.21.1 NeoForge Port 和 Guard Villagers（警卫村民模组），让警卫村民能够持有并使用 TacZ 枪械。

功能

警卫枪械 AI — 警卫可以拾取、拔出、瞄准并射击 TacZ 枪械。它们会自行调整到最佳射程，在近距离目标时横向拉开距离，并在射击前检查友军火力。

弹药与装填 — 当弹匣为空时，警卫会自动装填。装填过程绕过背包弹药检查（不消耗背包中的弹药），枪械直接恢复至满容量。装填时警卫会抬头作为视觉提示（可配置）。

死亡掉落 — 警卫死亡时，会掉落其持有的枪械以及 1 份至最大容量之间的对应弹药（两者均可配置）。

概率生成 — 警卫有可配置的概率（默认 30%）携带一把随机的 TacZ 枪械生成。可选的允许列表用于限制守卫能获得的枪械类型。

枪械数据遵循 — 伤害、射速、装填时间均来自枪械数据包中的值 — 警卫使用的枪械表现与玩家完全一致。

配置文件

配置文件：config/tacz_guard_compat-common.toml

| 选项 | 默认值 | 描述 |
|——|——–|——|
| gunSpawnChance | 0.3 | 守卫携带枪支生成的概率（0.0–1.0） |
| allowedGuns | [] | 枪支 ID 白名单（例如 ["tacz:ak47"]），空列表表示允许所有枪支 |
| guardAttackRadius | 15.0 | 攻击/交战范围（方块数） |
| guardAccuracy | 0.7 | 瞄准进度阈值（0.0–1.0），值越低瞄准越快但精度越低 |
| reloadLookUp | true | 换弹时守卫是否抬头看 |
| dropGunOnDeath | true | 死亡时是否掉落持有的枪支 |
| dropAmmoOnDeath | true | 死亡时是否掉落对应的弹药（数量为 1 至弹匣容量上限） |

其他

安装本模组前，请备份您的存档文件。本模组仍处于测试阶段，可能存在不稳定的情况。

本模组由 TRAE 制作