附件属性规则指南（v2.0）
字数
708 字
阅读时间
4 分钟
本文档对应当前 C# 版附件规则链路，内容以 RealismItemRules/attachment_rules.json 为准，并与 RealismPatchGenerator.Core/AttachmentRuleData.cs、RealismPatchGenerator.Core/RealismPatchGenerator.cs 的当前行为保持一致。
1. 规则文件结构
当前附件规则文件包含 4 组核心数据：
- modClampRules：最终安全夹紧范围
- modPriceRanges：按附件 profile 约束 Price 的价格区间
- modParentBaseProfiles：按 parentId 指定默认 profile
- modProfileRanges：各附件 profile 的字段区间
2. 全局夹紧范围
当前 modClampRules 为：
- VerticalRecoil：-35 到 35
- HorizontalRecoil：-35 到 35
- Dispersion：-55 到 55
- Loudness：-45 到 50
- Accuracy：-15 到 15
- Price：300 到 120000
- LoyaltyLevel：1 到 4
说明：任何附件 profile 的结果最终都要落回这层边界。
3. Price 定价区间
当前 modPriceRanges 为主要附件 profile 提供独立价格带，例如：
- muzzle_suppressor：18000 到 65000
- scope_magnified：15000 到 90000
- scope_red_dot：7000 到 35000
- magazine_drum：18000 到 65000
- receiver：10000 到 45000
- ubgl：40000 到 120000
- handguard_short / medium / long：5000 到 36000 的分层区间
实现上，生成器会结合后坐改善、操控改善、消音/抑焰、装弹或供弹能力、枪管长度、弹匣容量等信号形成价格分数，再把 Price 夹紧到对应 profile 的价格带。
4. 当前附件 profile
当前 modProfileRanges 覆盖这些档位：
- 枪口类：muzzle_suppressor、muzzle_suppressor_compact、muzzle_flashhider、muzzle_brake、muzzle_thread、muzzle_adapter
- 弹匣类：magazine_compact、magazine_standard、magazine_extended、magazine_drum、magazine
- 识具类：scope_magnified、scope_red_dot、iron_sight、optic_eyecup、optic_killflash
- 枪托类：stock_fixed、stock_folding、stock_ads_support、stock_buttpad、stock、buffer_adapter、stock_adapter、stock_rear_hook
- 握把与结构件：pistol_grip、foregrip、receiver、mount、catch、hammer、trigger、charging_handle
- 枪管与护木：barrel_short、barrel_medium、barrel_integral_suppressed、barrel_long、handguard_short、handguard_medium、handguard_long
- 其他：gasblock、flashlight_laser、bipod、rail_panel
5. 当前典型字段
附件 profile 常见覆盖字段包括：
- Ergonomics
- CameraRecoil
- VerticalRecoil
- HorizontalRecoil
- Dispersion
- Accuracy
- Velocity
- Loudness
- Flash
- ModMalfunctionChance
- DurabilityBurnModificator
- AimSpeed
- AimStability
- Handling
- ReloadSpeed
- LoadUnloadModifier
- CheckTimeModifier
6. 当前几类典型区间
几个当前最有代表性的档位：
- muzzle_suppressor：Loudness -40 到 -20，Flash -80 到 -30，AimSpeed -20 到 -8，DurabilityBurnModificator 1.2 到 1.5
- muzzle_brake：VerticalRecoil -20 到 -12，HorizontalRecoil -18 到 -10，但 Loudness 会提高到 10 到 20
- booster：AutoROF 1.03 到 1.10，SemiROF 1.00 到 1.04，只保留有限的导气助退收益，不再提供夸张射速增幅
- magazine_compact：Ergonomics 0 到 6，ReloadSpeed 0 到 8，Handling 0 到 5
- magazine_drum：Ergonomics -15 到 -8，ReloadSpeed -20 到 -5，Handling -12 到 -4
- scope_red_dot / scope_magnified 主要集中在 Ergonomics、Accuracy、AimSpeed、AimStability 的取舍
- barrel_long 与 handguard_long 更偏稳定、初速和控制，短型版本更偏轻快与机动
7. 调整建议
- 想改某一类附件整体风格，直接改 modProfileRanges 对应 profile
- 想只收口极端值，优先改 modClampRules
- 想修某个 parentId 默认落入错误 profile，再看 modParentBaseProfiles
8. 审计与例外说明
- attachment 的 mod_profile_unresolved 当前默认不记入主噪音结果
- 已在 item_exceptions 中明确覆盖的字段，会在审计中按字段豁免
- 例外物品更适合处理少数特殊附件，不应代替 attachment_rules.json 做整类调参
贡献者
SamuelNOTCuriousMeow