武器属性规则指南（v2.0）
字数
985 字
阅读时间
5 分钟
本文档对应当前 C# 版武器规则链路，内容以 RealismItemRules/weapon_rules.json 为准，并与 RealismPatchGenerator.Core/WeaponRuleData.cs、RealismPatchGenerator.Core/RealismPatchGenerator.cs 的当前行为保持一致。
1. 规则文件结构
当前武器规则文件包含 6 组核心数据：
- weaponParentGroups：按 parentId 把武器归入大类
- gunClampRules：武器最终安全夹紧范围
- gunPriceRanges：按武器基础 profile 约束 Price 的价格区间
- weaponProfileRanges：武器基础 profile 区间
- weaponCaliberRuleModifiers：按口径或弹种语义叠加修正
- weaponStockRuleModifiers：按枪托/结构形态叠加修正
2. 武器基础大类
当前 weaponParentGroups 覆盖这些主类：
- assault
- pistol
- smg
- sniper
- shotgun
- machinegun
- launcher
这一步决定武器先落入哪一套基础区间。
3. 全局夹紧范围
当前 gunClampRules 为：
- Ergonomics：10 到 100
- VerticalRecoil：10 到 700
- HorizontalRecoil：20 到 700
- Convergence：1 到 40
- Price：5000 到 250000
- LoyaltyLevel：1 到 5
说明：无论基础 profile、口径修正、枪托修正如何叠加，最终都会被收口到这个安全范围内。
4. Price 定价区间
当前 gunPriceRanges 覆盖：
实现上，生成器会先识别 weaponProfile，再综合 Ergonomics、后坐、散布、射速、口径档位、枪托结构与重量信号计算一个价格分数，最后把 Price 收口到对应 profile 的价格区间中。
- sniper
- shotgun
- machinegun
- Dispersion
- VisualMulti
- Ergonomics
- RecoilIntensity
其中当前几个典型范围是：
- assault：VerticalRecoil 80 到 110，HorizontalRecoil 140 到 185，Ergonomics 85 到 95
- assault：VerticalRecoil 95 到 130，HorizontalRecoil 155 到 210，Ergonomics 85 到 95
- pistol：VerticalRecoil 325 到 525，HorizontalRecoil 250 到 380，Ergonomics 92 到 100
- smg：VerticalRecoil 55 到 82，HorizontalRecoil 95 到 145，Ergonomics 88 到 98
- sniper：VerticalRecoil 115 到 185，HorizontalRecoil 150 到 300，Ergonomics 68 到 83
- shotgun：VerticalRecoil 245 到 425，HorizontalRecoil 240 到 460，ShotgunDispersion 固定 1
- machinegun：VerticalRecoil 150 到 245，HorizontalRecoil 200 到 360，Ergonomics 70 到 90
- launcher：VerticalRecoil 185 到 365，HorizontalRecoil 240 到 500，Ergonomics 45 到 68
6. 口径与弹种修正
当前 weaponCaliberRuleModifiers 覆盖这些修正档：
- pistol_caliber
- small_high_velocity
- intermediate_rifle_58x42
- intermediate_rifle_762x39
- subsonic_heavy_9x39
- full_power_rifle
- full_power_rifle_rimmed
- magnum_heavy
- shotgun_shell_12g
- shotgun_shell_20g
- shotgun_shell_23x75
- pdw_high_pen_small
这些修正主要影响：
- VerticalRecoil
- HorizontalRecoil
- Convergence
- Velocity
- RecoilIntensity
- ShotgunDispersion
几个当前明显的特征：
- full_power_rifle / full_power_rifle_rimmed 会明显提高后坐和初速修正
- magnum_heavy 会把 VerticalRecoil 提到 80 到 180 的额外修正区间
- subsonic_heavy_9x39 会降低 Velocity，并叠加较重的后坐特征
- shotgun_shell_12g 保持主流 12 号霰弹枪的标准后坐与散布修正
- shotgun_shell_20g 偏向更轻的后坐和更易控的收束
- shotgun_shell_23x75 会显著提高大口径霰弹枪的后坐与散布波动
- pdw_high_pen_small 更偏“小口径高穿”路线，带来更高 Velocity 与更紧的收束
7. 枪托与结构修正
当前 weaponStockRuleModifiers 覆盖：
- fixed_stock
- folding_stock_extended
- folding_stock_collapsed
- bullpup
- stockless
这层主要影响：
- VerticalRecoil
- HorizontalRecoil
- Convergence
- CameraRecoil
- VisualMulti
- Ergonomics
- BaseReloadSpeedMulti
- BaseChamberCheckSpeed
- RecoilIntensity
当前几个典型特征：
- fixed_stock 偏稳，通常给更低的 HorizontalRecoil 和更高的 Convergence
- folding_stock_collapsed 后坐与视觉扰动更高，但 Ergonomics 会上升
- bullpup 现在只保留轻微的后坐优势，重点仍放在紧凑布局与换弹速度代价
- stockless 现在会直接提高后坐并放大 VisualMulti 与 CameraRecoil，更贴近无托武器难控的现实表现
7. 当前文档对应关系
如果你要改当前武器规则，优先看这几个入口：
- RealismItemRules/weapon_rules.json：规则真值
- docs/规则说明.md：GUI 分类与规则文件映射
- docs/使用说明.md：日常操作流程
8. 调整建议
- 想改某一类武器整体风格，先改 weaponProfileRanges
- 想改某种口径的整体手感，改 weaponCaliberRuleModifiers
- 想改 bullpup、折叠托、无托这类结构差异，改 weaponStockRuleModifiers
- 改完后先生成小样本 output，再跑审计确认没有大面积越界
贡献者
SamuelNOTCuriousMeow