附录 · 速查表与说明
路径速查
| 内容 |
路径 |
| 命名空间 |
gunpack.meta.json → {"namespace":"mypack"} |
| 包信息 |
assets/<ns>/gunpack_info.json |
| 枪登记 |
data/<ns>/index/guns/<id>.json |
| 枪数值 |
data/<ns>/data/guns/<id>_data.json |
| 枪表现 |
assets/<ns>/display/guns/<id>_display.json |
| 模型 |
assets/<ns>/geo_models/gun/<id>_geo.json |
| 动画 |
assets/<ns>/animations/<id>.animation.json |
| 枪贴图 |
assets/<ns>/textures/gun/uv/<id>.png |
| 背包图标 |
assets/<ns>/textures/gun/slot/<id>.png |
| HUD |
assets/<ns>/textures/gun/hud/<id>.png |
| 音效 |
assets/<ns>/tacz_sounds/<id>/shoot.ogg |
| 语言 |
assets/<ns>/lang/zh_cn.json |
| 弹药 |
data/<ns>/index/ammo/<id>.json + assets/<ns>/display/ammo/… |
| 配件 |
data/<ns>/index|data/attachments/… + assets/<ns>/display|geo_models|textures/attachment/… |
| 配件匹配 |
data/<ns>/tacz_tags/attachments/allow_attachments/<枪>.json |
| 配方 |
data/<ns>/recipes/gun/<id>.json |
| 安装（客户端） |
.minecraft/tacz/ |
| 安装（服务端） |
<服务器>/tacz/ |
字段速查
| 想改什么 |
字段 |
| 伤害 |
bullet.damage |
| 弹丸数（霰弹） |
bullet.bullet_amount |
| 爆头倍率 |
bullet.extra_damage.head_shot_multiplier |
| 距离衰减 |
bullet.extra_damage.damage_adjust |
| 射速 |
rpm |
| 弹匣容量 |
ammo_amount（扩容 extended_mag_ammo_amount） |
| 换弹时间 |
reload.feed/cooldown.empty|tactical |
| 开镜 |
aim_time、display.iron_zoom、zoom_model_fov |
| 切枪 |
draw_time / put_away_time |
| 移速 |
movement_speed.base|aim|reload |
| 音量 |
fire_sound.fire_multiplier |
| 模型缩放 |
display.transform.scale.thirdperson|ground|fixed |
| 缺动画兜底 |
display.use_default_animation（如 "rifle"） |
| 名字/描述 |
lang/*.json（键与 index 的 name/tooltip 一致） |
命令速查
# 打 zip（根目录直接是 data/ assets/ gunpack.meta.json）
cd mypack && zip -r ../mypack.zip . -x '.*' -x '__MACOSX*'
# 看 zip 层级对不对
unzip -l ../mypack.zip | head
# 音效转 Ogg
ffmpeg -i a.wav -c:a libvorbis -q:a 5 -ac 1 -ar 44100 shoot.ogg
# 格式化/检查 JSON（有 jq 的话）
jq . data/mypack/data/guns/m4a1_data.json > /dev/null && echo OK
命名速查
| 东西 |
规则 |
| namespace |
全小写 [a-z0-9_] |
| id / 文件名 |
小写 + 下划线（snake_case） |
| 数值文件 |
<id>_data.json |
| 表现文件 |
<id>_display.json |
| 模型文件 |
<id>_geo.json |
| 动画文件 |
<id>.animation.json |
| 引用格式 |
命名空间:路径，不带扩展名 |
| 语言键 |
<ns>.gun.<id>.name / .desc |
三句话口诀
index 登记、data 定数、assets 定貌。
模型动画从默认枪抄起，改数值只动 data 并两端同步。
出问题先查三件事：目录层级、引用路径、名字大小写。
字段来源与版本差异说明
- 本教程的目录结构、字段名与示例值，来自公开枪包的实际文件与 TaCZ 默认枪包的实际结构（
data/<ns>/index|data、assets/<ns>/display|geo_models|animations|textures|tacz_sounds|lang；bullet.extra_damage.head_shot_multiplier、reload.feed/cooldown、use_default_animation、iron_zoom、tacz:gun_smith_table_crafting 等字段/类型均为实际存在）。
- TaCZ 版本之间存在字段微调：不同 MC 版本（1.20.1 / 1.21.x）与不同模组版本的字段可能增删或改名；动画模板与状态机脚本差异更大。
- 因此本文所有"具体字段"都请以你本机安装版本的默认枪包
tacz/tacz_default_gun 为准；本站示例用于说明"结构与套路"，而不是"唯一正确的取值"。
- 涉及许可：TaCZ 本体与多数枪包采用 GPL-3.0，二次分发请遵循其许可证；模型/贴图/音效素材请注意原始版权。
本站由 FFGS 文档总站维护 · 环境示例：Minecraft 1.20.1 / Forge 47.x