Realism 武器附件补丁属性规则指南
<NolebasePageProperties />
本文档旨在为《现实主义 (Realism)》模组的武器附件补丁生成提供参考规则。这些属性直接从“现实主义物品模板 (attatchments)”文件夹中提取,专门用于武器附件(MOD)类物品,其数据结构与武器(Gun)完全不同。
1. 附件物品(WeaponMod)必填基础字段
所有附件物品(WeaponMod)补丁必须包含的以下基础属性:
- "$type": "RealismMod.WeaponMod, RealismMod"
- "ItemID": 物品的 MongoID
- "ModType":
- "Stock*"(附件类型:枪托)
- "stock_adapter"(附件类型:枪托转接器)
- "sight"(附件类型:所有瞄具)
- "mount"(附件类型:可安装配件/带皮轨)
- "grip_stock_adapter"(附件类型:握把枪托转接器)
- "booster"(附件类型:枪口助推器)
- "muzzle_supp_adapter"(附件类型:可用作消声器转接器)
- "sig_taper_brake"(附件类型:Sig消声器专用转接器)
- "bayonet"(附件类型:刺刀)
- "foregrip_adapter"(附件类型:前握把专用转接器)
- "long_mag"(附件类型:长弹匣)
- "shotTube"(附件类型:霰弹枪弹仓)
- "shot_pump_grip_adapt"(附件类型:泵动霰弹枪前握把转接器)
- "gas"(附件类型:消声器/抑制器优化型拉机柄)
- "short_barrel"(附件类型:短枪管,长度在178 - 292mm范围内)
- "bipod"(附件类型:两脚架)
- "Weight": 物品的重量(kg)
- "LoyaltyLevel": 商店解锁等级(1到4)
2. 各分类属性解析 (现实主义标准)
所有配件可用属性的说明及示范值**
- "ReloadSpeed [更换弹匣速度,数值越高越快]": 5
- "LoadUnloadModifier [子弹压弹/退弹速度乘数,数值越高越快]": 20
- "CheckTimeModifier [检查弹匣速度乘数,数值越高越快]": 3
- "VerticalRecoil [数值越低越好]": 0,
- "HorizontalRecoil [数值越低越好]": -3,
- "Dispersion [数值越低越好,整体散布]": -15,
- "CameraRecoil [数值越低越好]": -10,
- "AutoROF [1代表1%射速提升]": 1,
- "SemiROF [2.5代表2.5%射速提升]": 2.5,
- "ModMalfunctionChance [数值越低越好]": -10,
- "CanCycleSubs [是否让无法循环亚音速弹的口径循环亚音速弹药,supressor/silencer必须true]": false,
- "Accuracy [数值越高越好]": -5,
- "HeatFactor [数值越高越差]": 1.13,
- "CoolFactor [数值越高越好]": 0.95,
- "DurabilityBurnModificator [数值越高越差]": 1.1,
- "Velocity [2=2%初速提升,如果是枪管,则使用同口径相近长度枪管的现实主义模组数据]": 2,
- "RecoilAngle [5=后坐角度增加5%以上,趋向90度(垂直向上)]": 5,
- "ConflictingItems [应冲突的物品,将与原冲突列表合并,而非覆盖]": [],
- "Ergonomics [数值越高越好]": 0,
- "Weight [重量,制作补丁时使用输入文件的同属性值]": 0.354,
- "Loudness [负值表示更安静,用于致聋机制和SAIN模组]": -32,
- "Convergence [数值越高越好,响应更迅速,更不飘,枪口上扬和后坐爬升更小]": 0,
- "LoyaltyLevel[商店解锁等级(1-4),制作补丁时使用输入文件的同属性值]": 3,
- "Flash [数值越高,若为消音器或非枪口装置则气体更多,否则火焰更明显]": 15,
- "Handling [武器在移动鼠标或行走/侧移时惯性阻力更小]": 6,
- "AimStability [武器瞄准稳定性,越高越好]": 7.5,
- "AimSpeed [越高越好]": 5,
- "StockAllowADS [覆盖被设定为阻止开镜的装备物品]": false,
- "HasShoulderContact [枪托是否实际接触玩家肩部]": true,
- "CenterOfImpact [影响枪管精度,数值越高精度越差]": 0.042,
- "ModShotDispersion [负值减小鹿弹散布]": -25
🚀 枪口装置 (MuzzleDevice)
主要影响后坐力、隐蔽性及枪口状态。补丁应根据功能细分属性。
消声器 (Suppressor/Silencer)属性数值范围:
- "Ergonomics": -8 到 -18
- "CameraRecoil": -3 到 -8
- "VerticalRecoil": -8 到 -15
- "HorizontalRecoil": -5 到 -10
- "Dispersion": -1 到 -5
- "Accuracy": -1 到 -5
- "Velocity": 0.2 到 1.0
- "Loudness": -20 到 -40
- "Flash": -30 到 -80
- "ModMalfunctionChance": 10 到 25
- "DurabilityBurnModificator": 1.2 到 1.5
- "AimSpeed": -8 到 -20
- "CanCycleSubs": 是否允许循环亚音速弹:True/False。
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
消焰器 (Flash Hider)属性数值范围:
- "Ergonomics": -2 到 -5
- "CameraRecoil": -1 到 -2
- "VerticalRecoil": -2 到 -5
- "HorizontalRecoil": -1 到 -3
- "Dispersion": 2 到 -2
- "Accuracy": 0
- "Velocity": 0
- "Loudness": 0 到 10
- "Flash": -40 到 -70
- "ModMalfunctionChance": 0
- "DurabilityBurnModificator": 1.0
- "AimSpeed": -1 到 -3
- "CanCycleSubs": false
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
制退器/补偿器 (Muzzle Brake/Compensator)属性数值范围:
- "Ergonomics": -3 到 -8
- "CameraRecoil": -3 到 -10
- "VerticalRecoil": -12 到 -20
- "HorizontalRecoil": -8 到 -15
- "Dispersion": -2 到 -5
- "Accuracy": -1 到 -2
- "Velocity": 0.5 到 1.0
- "Loudness": 10 到 20
- "Flash": 3 到 15
- "ModMalfunctionChance": 0
- "DurabilityBurnModificator": 1.0
- "AimSpeed": -2 到 -6
- "CanCycleSubs": false
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
枪口保护器 (Thread Protector)属性数值范围:
- "Ergonomics": 0 到 1
- "CameraRecoil": 0
- "VerticalRecoil": 0
- "HorizontalRecoil": 0
- "Dispersion": 0
- "Accuracy": 0
- "Velocity": 0
- "Loudness": 0
- "Flash": 0
- "ModMalfunctionChance": 0
- "DurabilityBurnModificator": 1.0
- "AimSpeed": 0
- "CanCycleSubs": false
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
🎒 弹匣 (Magazine)
影响装填效率和供弹可靠性。
核心属性数值范围:
- "Ergonomics": -1 到 -25 (视容量及材质)
- "ReloadSpeed": -10 到 5 (数值越高越快,大容量弹匣应为 -15 到 -25)
- "LoadUnloadModifier": 5 到 15
- "CheckTimeModifier": 1 到 5
- "MalfunctionChance": -2 到 5 (高质量弹匣为负)
- "AimSpeed": -1 到 -8
- "Handling": -1 到 -8
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
⚙️ 导气箍 (Gasblock) & 辅助模块 (AuxiliaryMod)
内部运作部件,影响武器循环的可靠性和速度。
导气箍 (Gasblock)属性数值范围:
- "Ergonomics": 0 到 -2
- "VerticalRecoil": 0 到 -2
- "HorizontalRecoil": 0 到 -1
- "ModMalfunctionChance": -2 到 5 (可调节导气箍通常有利有弊)
- "DurabilityBurnModificator": 0.95 到 1.05
- "HeatFactor": 0.98 到 1.02
- "CoolFactor": 0.98 到 1.02
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
辅助模块 (AuxiliaryMod)属性数值范围:
- "ChamberSpeed": 1 到 5
- "ReloadSpeed": 1 到 5
- "FixSpeed": 5 到 15
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
🎯 瞄准镜 (Scope)
主要影响瞄准性能。
光学镜 (Magnified)属性数值范围:
- "AimSpeed": -5 到 -15 (倍率越大负值越高)
- "AimStability": 5 到 20
- "Ergonomics": -5 到 -12
- "Handling": -3 到 -10
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
红点镜属性数值范围:
- "AimSpeed": 2 到 8
- "AimStability": 0 到 5
- "Ergonomics": 0 到 -3
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
🎯 机械瞄具 (IronSight)
主要影响瞄准性能。
核心属性数值范围:
- "AimSpeed": 2 到 10 (比红点通常更快)
- "Ergonomics": 0 到 2
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
🪵 枪托 (Stock)
主要影响后坐力控制和稳定性。
枪托("ModType": "Stock")属性数值范围:
- "VerticalRecoil": -5 到 -15
- "HorizontalRecoil": -2 到 -10
- "CameraRecoil": -5 到 -20
- "Convergence": 5 到 20
- "HasShoulderContact": true (折叠状态为 false)
- "AimSpeed": -2 到 -12
- "AimStability": 5 到 15
- "Handling": -2 到 -10
- "StockAllowADS": false (常规枪托为 false,高基座或特殊设计除外)
- "Ergonomics": -2 到 -15
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
缓冲管("ModType": "buffer_adapter")属性数值范围:
- "VerticalRecoil": -2 到 -6
- "HorizontalRecoil": 0 到 -5
- "Ergonomics": -2 到 -10
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
枪托适配器("ModType": "stock_adapter")属性数值范围:
- "VerticalRecoil": 0
- "HorizontalRecoil": 0
- "CameraRecoil": 0
- "Convergence": 0
- "AimSpeed": 0
- "AimStability": 0
- "Handling": 0
- "Ergonomics": 0
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
🔫 枪管 (Barrel)
决定武器的精度、初速和发热表现。
短枪管属性数值范围:
- "CenterOfImpact": 0.05 到 0.15
- "Velocity": -5 到 -15 (负值表示初速降低)
- "Accuracy": -5 到 -20
- "HeatFactor": 1.1 到 1.3
- "CoolFactor": 1.05 到 1.2 (冷却更快但更易过热)
- "Convergence": 10 到 25
- "DurabilityBurnModificator": 1.1 到 1.3
- "RecoilAngle": 5 到 15
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
中枪管属性数值范围:
- "CenterOfImpact": 0.02 到 0.05
- "Velocity": -2 到 5
- "Accuracy": -2 到 5
- "HeatFactor": 0.95 到 1.05
- "CoolFactor": 0.95 到 1.05
- "Convergence": 0 到 10
- "DurabilityBurnModificator": 0.95 到 1.05
- "RecoilAngle": -5 到 5
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
长枪管属性数值范围:
- "CenterOfImpact": 0.005 到 0.02
- "Velocity": 10 到 25
- "Accuracy": 10 到 25
- "HeatFactor": 0.8 到 0.95
- "CoolFactor": 0.8 到 0.95
- "Convergence": -5 到 -15
- "DurabilityBurnModificator": 0.7 到 0.9
- "RecoilAngle": -5 到 -15
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
🖐️ 手枪握把 (PistolGrip)
主要影响操作性和舒适度。
核心属性数值范围:
- "Ergonomics": 2 到 15
- "AimSpeed": 1 到 5
- "AimStability": 1 到 5
- "Handling": 2 到 8
- "VerticalRecoil": -1 到 -5
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
🖐️ 前握把 (Foregrip)
主要影响操作性和舒适度。
核心属性数值范围:
- "VerticalRecoil": -2 到 -7
- "HorizontalRecoil": -1 到 -4
- "CameraRecoil": -1 到 -6
- "Convergence": 0 到 5
- "AimSpeed": -2 到 6
- "AimStability": 5 到 12
- "Handling": 8 到 18
- "Ergonomics": -2 到 6
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
🛠️ 机匣 (Receiver)
作为武器骨架,影响重量分布和散热。
核心属性数值范围:
- "AutoROF": 0 到 2
- "SemiROF": 0 到 5
- "ModMalfunctionChance": -5 到 5
- "CanCycleSubs": false
- "Accuracy": -5 到 5
- "HeatFactor": 0.95 到 1.05
- "CoolFactor": 0.95 到 1.05
- "Ergonomics": -2 到 5
- "Convergence": 0 到 10
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
🛠️ 护木 (Handguard)
作为武器骨架,影响重量分布和散热。
短护木属性数值范围:
- "VerticalRecoil": -1 到 -3
- "HorizontalRecoil": -1 到 -2
- "HeatFactor": 1.05 到 1.1
- "CoolFactor": 1.05 到 1.15
- "AimStability": 1 到 5
- "AimSpeed": 2 到 8
- "Handling": 5 到 12
- "Ergonomics": 2 到 10
- "DurabilityBurnModificator": 1.0
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
中护木属性数值范围:
- "VerticalRecoil": -3 到 -8
- "HorizontalRecoil": -2 到 -5
- "HeatFactor": 0.95 到 1.05
- "CoolFactor": 0.95 到 1.05
- "AimStability": 5 到 10
- "AimSpeed": 0 到 5
- "Handling": 2 到 8
- "Ergonomics": 0 到 5
- "DurabilityBurnModificator": 1.0
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
长护木属性数值范围:
- "VerticalRecoil": -8 到 -15
- "HorizontalRecoil": -5 到 -10
- "HeatFactor": 0.85 到 0.95
- "CoolFactor": 0.85 到 0.95
- "AimStability": 10 到 20
- "AimSpeed": -2 到 -8
- "Handling": -2 到 -8
- "Ergonomics": -2 到 -5
- "DurabilityBurnModificator": 0.9 到 1.0
- "Weight": 取输入文件中的同属性的值
- "LoyaltyLevel": 取输入文件中的同属性的值
🔋 导轨/支架 (Mount)
通常仅微调重量和极少量的人机。
核心属性:
- "Weight": 取输入文件中的同属性的值
- "Ergonomics": -1 到 1
- "StockAllowADS": false (高基座支架为 true)
🔦 战术配件 (FlashlightLaser)
核心属性:
- "Weight": 取输入文件中的同属性的值
- "Ergonomics": -1 到 -3
- "Handling": -2 到 -8
贡献者
<NolebaseGitContributors />
文件历史
<NolebaseGitChangelog />