枪械数据进阶

枪械数据配置（Data）

本页列出枪械 xxx_data.json 的所有可用字段，详情见各小节。

字段总览

弹药

字段	类型	必填	说明	详情
ammo	字符串	是	指定弹药类型，如 tacz:762x39	弹药
ammo_amount	数值	是	弹匣容量	弹药
extended_mag_ammo_amount	数组	否	扩容弹匣容量，按等级从低到高	弹药
reload.type	枚举	是	供弹方式，可选 magazine / manual / fuel / inventory	供弹
reload.infinite	布尔值	否	无限备弹，与 inventory 模式不兼容	供弹
reload.feed.empty	数值	否	空仓换弹子弹补充时间点（秒）	供弹
reload.feed.tactical	数值	否	战术换弹子弹补充时间点（秒）	供弹
reload.cooldown.empty	数值	否	空仓换弹总耗时（秒）	供弹
reload.cooldown.tactical	数值	否	战术换弹总耗时（秒）	供弹

逻辑脚本

字段	类型	必填	说明	详情
script	字符串	否	指定枪械逻辑脚本，位于 data/{命名空间}/scripts	逻辑脚本
script_param	对象	否	传给脚本的参数，内容取决于脚本需要	逻辑脚本

枪械行为与射速

字段	类型	必填	说明	详情
bolt	枚举	是	枪栓类型，可选 open_bolt / closed_bolt / manual_action	枪械行为
bolt_action_time	数值	否	拉栓上膛时长（秒），仅 manual_action 有效	枪械行为
can_crawl	布尔值	否	是否允许趴下，默认 true	枪械行为
can_slide	布尔值	否	是否允许斜握，默认 true	枪械行为
rpm	数值	是	每分钟射速，最大 1200	开火机制
fire_mode	数组	是	开火模式列表，可选 semi / auto / burst	开火机制
fire_mode_adjust	对象	否	不同开火模式下的数值修正（伤害、射速、精度等）	开火机制
burst_data	对象	否	连发模式数据（仅在 fire_mode 含 burst 时调用）	开火机制
charging	对象	否	蓄力/延迟扳机配置	开火机制
force_aim_exit_on_reload	布尔值	否	换弹时强制退出瞄准，换弹期间禁止重新开镜(内测版功能)	枪械行为
force_aim_exit_on_bolt	布尔值	否	拉栓时强制退出瞄准，拉栓期间禁止重新开镜(内测版功能)	枪械行为

子弹实体属性

字段	类型	必填	说明	详情
bullet.life	数值	是	子弹存活时间（秒）	子弹实体属性
bullet.damage	数值	是	单发基础伤害	子弹实体属性
bullet.bullet_amount	数值	否	霰弹弹丸数，默认 1	子弹实体属性
bullet.speed	数值	是	子弹初速度（m/s），游戏内默认全局弹速乘2	子弹实体属性
bullet.gravity	数值	否	重力系数	子弹实体属性
bullet.friction	数值	否	空气阻力	子弹实体属性
bullet.knockback	数值	否	击退效果	子弹实体属性
bullet.pierce	数值	否	穿透数	子弹实体属性
bullet.ignite	布尔值/对象	否	是否点燃实体或方块	子弹实体属性
bullet.ignite_entity_time	数值	否	点燃实体时间（秒），默认 2	子弹实体属性
bullet.explosion	对象	否	爆炸配置（半径、伤害、是否破坏方块等）	子弹实体属性
bullet.tracer_count_interval	数值	否	曳光弹间隔，0 为每发都是曳光弹，无此字段不发射	子弹特效

额外伤害

字段	类型	必填	说明	详情
extra_damage.armor_ignore	数值	否	护甲穿透率，默认 0	额外伤害
extra_damage.head_shot_multiplier	数值	否	爆头伤害倍率	额外伤害
extra_damage.damage_adjust	数组	否	距离衰减表，超过最远距离伤害为 0	额外伤害

后坐力

字段	类型	必填	说明	详情
recoil.pitch	数组	否	纵向后坐力曲线（time/value 关键帧）	后坐力
recoil.yaw	数组	否	横向后坐力曲线（time/value 关键帧）	后坐力
crawl_recoil_multiplier	数值	否	趴下后坐力倍率	后坐力
recoil_push.ground_strength	数值	否	射击反推强度（地面）(内测版功能)	后坐力
recoil_push.air_strength	数值	否	射击反推强度（空中）(内测版功能)	后坐力
recoil_push.sneak_strength	数值	否	射击反推强度（潜行）(内测版功能)	后坐力
recoil_push.crawl_strength	数值	否	射击反推强度（趴下）(内测版功能)	后坐力
recoil_push.per_projectile	布尔值	否	多弹丸分别施加反推(内测版功能)	后坐力
recoil_push.projectile_multiplier	数值	否	单弹丸反推倍率(内测版功能)	后坐力

精度与晃动

字段	类型	必填	说明	详情
inaccuracy.stand	数值	否	站立散布	精度与晃动
inaccuracy.move	数值	否	移动散布	精度与晃动
inaccuracy.sneak	数值	否	潜行散布	精度与晃动
inaccuracy.lie	数值	否	趴下散布	精度与晃动
inaccuracy.aim	数值	否	瞄准散布	精度与晃动
hurt_bob_tweak_multiplier	数值	否	受伤摇晃倍率，默认 0.05	精度与晃动

动作时长

字段	类型	必填	说明	详情
draw_time	数值	否	抬枪动作时长（秒）	动作时长
put_away_time	数值	否	收枪动作时长（秒）	动作时长
aim_time	数值	否	瞄准时长（秒）	动作时长
sprint_time	数值	否	跑射延迟（秒）	动作时长

移动速度

字段	类型	必填	说明	详情
weight	数值	否	枪械重量（kg），影响移速	移动速度
movement_speed.base	数值	否	默认移速修正（MULTIPLY_TOTAL 修饰器）	移动速度
movement_speed.aim	数值	否	瞄准时移速修正	移动速度
movement_speed.reload	数值	否	换弹时移速修正	移动速度

音效传播

字段	类型	必填	说明	详情
fire_sound.fire_multiplier	数值	否	射击声音传播距离乘数	音效
fire_sound.silence_multiplier	数值	否	消音射击声音传播距离乘数	音效

枪械近战

字段	类型	必填	说明	详情
melee.distance	数值	否	近战攻击范围，与配件加和	枪械近战
melee.cooldown	数值	否	近战冷却时间（秒），与配件加和	枪械近战
melee.default.animation_type	枚举	否	动画类型，可选 melee_push / melee_stock	枪械近战
melee.default.damage	数值	否	近战伤害	枪械近战
melee.default.knockback	数值	否	近战击退	枪械近战
melee.default.range_angle	数值	否	近战攻击范围角度	枪械近战
melee.default.prep	数值	否	近战前摇时长（秒）	枪械近战

配件槽

字段	类型	必填	说明	详情
allow_attachment_types	枚举数组	否	开放的配件槽，可选 scope / stock / muzzle / grip / laser / extended_mag	配件槽
builtin_attachments	对象	否	原厂配件候选列表及默认预装件 （内测版功能）	配件槽
exclusive_attachments	对象	否	为特定配件指派独立属性	配件槽

过热

字段	类型	必填	说明	详情
heat.max	数值	否	过热上限	过热
heat.per_shot	数值	否	每发子弹过热值	过热
heat.cooling_multiplier	数值	否	冷却倍率	过热
heat.cooling_delay	数值	否	冷却延迟（ms）	过热
heat.over_heat_time	数值	否	过热后延迟（ms）	过热
heat.min_inaccuracy	数值	否	过热对精度的最小影响倍率	过热
heat.max_inaccuracy	数值	否	过热对精度的最大影响倍率	过热
heat.min_rpm_mod	数值	否	过热对射速的最小影响倍率	过热
heat.max_rpm_mod	数值	否	过热对射速的最大影响倍率	过热