Realism 武器数值规则指南

<NolebasePageProperties />

本文档说明当前武器规则的一级基础档、二级细分修正、应用顺序和调参入口。内容与 weapon_rule_ranges.py、weapon_refinement_rules.py 以及 generate_realism_patch.py 中的武器主流程保持同步。

0. 文档同步说明（2026-03-13 / v3.15）

• 当前一级规则源文件：weapon_rule_ranges.py
• 当前二级规则源文件：weapon_refinement_rules.py
• 当前全局夹紧来源：generate_realism_patch.py 中的 GUN_CLAMP_RULES
• 当前 stockless、bullpup、5.8x42、9x39 等细分逻辑均以代码配置为准

1. 武器规则怎么应用

在 apply_realism_sanity_check() 中，Gun 的处理顺序为：

1. 先补齐武器必填字段
2. 应用材质、尺寸、枪管长度等启发式预处理
3. 应用 GUN_CLAMP_RULES 全局夹紧
4. 推断 weapon_profile
5. 按 weapon_rule_ranges.py 的一级区间重算
6. 按 weapon_refinement_rules.py 叠加口径与枪托二级修正
7. 再做一次全局夹紧

如果 weapon_profile 被识别为 pistol，当前会额外强制 HasShoulderContact = false。

2. 当前一级基础档

当前 WEAPON_PROFILE_RANGES 包含以下主档位：

• assault
• pistol
• smg
• sniper
• shotgun
• machinegun
• launcher

其中几项当前关键区间如下：

• assault：VerticalRecoil 75 到 105，HorizontalRecoil 140 到 185，Ergonomics 85 到 95
• pistol：VerticalRecoil 320 到 520，HorizontalRecoil 280 到 480，BaseTorque -2.0 到 -1.0
• smg：VerticalRecoil 32 到 59，HorizontalRecoil 70 到 120，RecoilIntensity 0.08 到 0.16
• sniper：VerticalRecoil 110 到 180，Dispersion 0.5 到 3.0
• shotgun：VerticalRecoil 240 到 420，ShotgunDispersion 固定档为 1
• machinegun：VerticalRecoil 130 到 240，RecoilIntensity 0.2 到 0.35
• launcher：VerticalRecoil 180 到 360，Ergonomics 45 到 68

完整区间请直接查看 weapon_rule_ranges.py。

3. 当前二级口径修正

当前 WEAPON_CALIBER_RULE_MODIFIERS 包含以下细分档位：

• 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
• pdw_high_pen_small

这些修正会在一级基础档之上叠加，常用于拉开不同口径在后坐、收束、初速和程序后坐强度上的差异。

当前关键词入口在 CALIBER_PROFILE_KEYWORDS，新增口径识别时优先改这个配置。

4. 当前二级枪托形态修正

当前 WEAPON_STOCK_RULE_MODIFIERS 包含：

• fixed_stock
• folding_stock_extended
• folding_stock_collapsed
• bullpup
• stockless

这些修正主要影响：

• VerticalRecoil / HorizontalRecoil
• Convergence
• CameraRecoil
• VisualMulti
• Ergonomics
• BaseReloadSpeedMulti
• BaseChamberCheckSpeed
• RecoilIntensity

说明：

• bullpup 当前同时影响 BaseReloadSpeedMulti 与 BaseChamberCheckSpeed
• stockless 当前仍会影响 RecoilIntensity，但已相对早期版本收敛

5. 当前全局夹紧边界

主流程当前对武器关键字段的全局边界为：

• Ergonomics：10 到 100
• VerticalRecoil：10 到 700
• HorizontalRecoil：20 到 700
• Convergence：1 到 40
• LoyaltyLevel：1 到 5

另外：

• RecoilAngle 若小于 30 或大于 150，会被重置为 90

6. 调参建议

想改某类武器整体手感

改 weapon_rule_ranges.py 中对应一级档位。

想拉开不同口径差异

改 weapon_refinement_rules.py 中的 WEAPON_CALIBER_RULE_MODIFIERS。

想调整无托、折叠托、bullpup 差异

改 WEAPON_STOCK_RULE_MODIFIERS。

想补充新口径命名

改 CALIBER_PROFILE_KEYWORDS。

7. 验证建议

1. 用目标枪型小样本生成一次输出
2. 检查一级档是否命中
3. 再检查口径和枪托二级修正是否叠加到位
4. 最后通过审计脚本确认没有明显越界项

8. 文档策略

本指南描述当前武器规则结构与关键边界；精确区间和增量以 weapon_rule_ranges.py 与 weapon_refinement_rules.py 为准。发版时请同步更新 CHANGELOG.md 与 规则文件与文档同步对照清单.md。

贡献者

<NolebaseGitContributors />

文件历史

<NolebaseGitChangelog />