本页列出枪械 xxx_display.json 的所有可用字段，详情见各小节。
| 字段 | 类型 | 必填 | 说明 | 详情 |
|---|
| model | 字符串 | 是 | 枪械模型，在 models/ 下寻找 | 模型与贴图 |
| texture | 字符串 | 是 | 枪械贴图，在 textures/ 下寻找 | 模型与贴图 |
| lod | 对象 | 否 | 低模配置（远距离渲染） | 模型与贴图 |
| animation | 字符串 | 否 | 调用的动画文件 | 动画与状态机 |
| state_machine | 字符串 | 否 | 状态机脚本路径 | 动画与状态机 |
| use_default_animation | 枚举 | 否 | 可选 rifle / pistol | 动画与状态机 |
| third_person_animation | 枚举 | 否 | 第三人称动画类型，默认 default | 动画与状态机 |
| player_animator_3rd | 字符串 | 否 | Player Animator 模组的第三人称动画 | 动画与状态机 |
| 字段 | 类型 | 必填 | 说明 | 详情 |
|---|
| hud | 字符串 | 否 | HUD 界面贴图，为空则会变成黑紫 | HUD 与 GUI |
| hud_empty | 字符串 | 否 | 空弹时 HUD 贴图，为空则红色着色替换 | HUD 与 GUI |
| slot | 字符串 | 否 | 背包/快捷栏槽位贴图 | HUD 与 GUI |
| ammo_count_style | 枚举 | 否 | 弹药显示样式，可选 normal / percent，默认 normal | HUD 与 GUI |
| damage_style | 枚举 | 否 | 伤害显示样式，可选 total / per_projectile，默认 per_projectile | HUD 与 GUI |
| show_crosshair | 布尔值 | 否 | 瞄准时是否显示准星，默认 false（隐藏） | HUD 与 GUI |
| 字段 | 类型 | 必填 | 说明 | 详情 |
|---|
| transform | 对象 | 否 | 各视角下的模型缩放 | 视角与变换 |
| iron_zoom | 数值 | 否 | 机瞄放大倍数，默认 1.2 | 视角与变换 |
| model_fov | 数值 | 否 | 常驻持枪状态的 FOV（内测版功能） | 视角与变换 |
| zoom_model_fov | 数值 | 否 | 开镜时的 FOV | 视角与变换 |
| 字段 | 类型 | 必填 | 说明 | 详情 |
|---|
| muzzle_flash | 对象 | 否 | 枪口火焰的贴图和缩放 | 枪口火焰 |
| 字段 | 类型 | 必填 | 说明 | 详情 |
|---|
| shell | 对象 | 否 | 抛壳效果，为空则不抛壳 | 抛壳 |
| 字段 | 类型 | 必填 | 说明 | 详情 |
|---|
| ammo.tracer_color | 字符串 | 否 | 曳光弹颜色（RGB 十六进制），如 #FF8888 | 子弹特效 |
| ammo.enable_bullet_hole | 布尔值 | 否 | 是否保留弹孔贴花 | 子弹特效 |
| ammo.hit_surface_particles | 数组 | 否 | 命中方块表面时播放的粒子效果（内测版功能） | 子弹特效 |
| ammo.particle | 对象 | 否 | 子弹飞行时拖尾粒子 | 子弹特效 |
| 字段 | 类型 | 必填 | 说明 | 详情 |
|---|
| sounds | 对象 | 否 | 枪械所有音效配置 | 音效 |
| 字段 | 类型 | 必填 | 说明 | 详情 |
|---|
| offhand_show | 对象 | 否 | 副手持枪时的显示配置 | 副手与快捷栏 |
| hotbar_show | 对象 | 否 | 快捷栏持枪时的显示配置 | 副手与快捷栏 |
| 字段 | 类型 | 必填 | 说明 | 详情 |
|---|
| text_show | 对象 | 否 | 枪械模型上的文本渲染 | 枪身文字 |
| controllable | 对象 | 否 | Controllable 模组手柄震动配置 | 手柄震动 |