Editing Gun Spread Formula

__NOTOC__

 Spread = PerkModifiers(IronSightsBonus * CrouchBonus * (ConditionPenalty + SkillBonus) * (WalkPenalty + RunPenalty) + ArmPenalty)

'''PerkModifiers''' is a function that modifies the input value using any perks active on the actor that have a "Calculate Gun Spread" [[Entry Point]] and returns the result.

'''IronSightsBonus''' = fGunSpreadIronSightsBase + fGunSpreadIronSightsMult * ''IsUsingIronSights''

'''CrouchBonus''' = fGunSpreadCrouchBase + fGunSpreadCrouchMult * ''IsSneaking''

'''ConditionPenalty''' = fGunSpreadCondBase + fGunSpreadCondMult * ''WeaponCondition''

'''SkillBonus''' = fGunSpreadSkillBase + fGunSpreadSkillMult * ''ActorSkillValue''

'''WalkPenalty''' = fGunSpreadWalkBase * !''IsRunning'' + fGunSpreadWalkMult * ''IsWalking''
:!''IsRunning'' means that if ''IsRunning'' is 1, !''IsRunning'' is 0, and vice versa.

'''RunPenalty''' = (fGunSpreadRunBase + fGunSpreadRunMult) * ''IsRunning''

'''ArmPenalty''' = fGunSpreadArmBase + fGunSpreadArmMult * ''ArmCondition''


''IsUsingIronSights'' is 1 if the actor is aiming with iron sights and 0 otherwise, but there is no function by this name.

''IsSneaking'' is the [[IsSneaking]] function.

''WeaponCondition'' is the condition of the weapon equipped by the actor.
:This value is 1.0 at 100%, 0.5 at 50% and 0.0 at 0%

''ActorSkillValue'' is the actor's skill value for the skill used by the weapon.
:The skill value used is specified on the [[Weapons|weapon form]]

''IsRunning'' is the [[IsRunning]] function.

''IsWalking'' is 1 if the actor is walking and 0 otherwise, but there is no function by this name.

''ArmCondition'' is the condition of the actor's arm.
:*When using a one handed weapon, ''ArmCondition'' is 1 with a healthy right arm and 0 with a crippled right arm.
:*When using a two handed weapon, ''ArmCondition'' is 1 with both arms healthy, 0.5 with 1 arm crippled, 0 with two arms crippled. 

=== Game settings used by this formula ===

{{SettingGroupHeader}}
{{SettingGroupSetting
|Name = fGunSpreadIronSightsBase
|Default = 1
|Description = Used when calculating ''IronSightsBonus''
}}
{{SettingGroupSetting
|Name = fGunSpreadIronSightsMult
|Default = -0.65
|Description = Used when calculating ''IronSightsBonus''
}}
{{SettingGroupSetting
|Name = fGunSpreadCrouchBase
|Default = 1
|Description = Used when calculating ''CrouchBonus''
}}
{{SettingGroupSetting
|Name = fGunSpreadCrouchMult
|Default = -0.4
|Description = Used when calculating ''CrouchBonus''
}}
{{SettingGroupSetting
|Name = fGunSpreadCondBase
|Default = 0
|Description = Used when calculating ''ConditionPenalty''
}}
{{SettingGroupSetting
|Name = fGunSpreadCondMult
|Default = 0
|Description = Used when calculating ''ConditionPenalty''
}}
{{SettingGroupSetting
|Name = fGunSpreadSkillBase
|Default = 0.5
|Description = Used when calculating ''SkillBonus''
}}
{{SettingGroupSetting
|Name = fGunSpreadSkillMult
|Default = -0.0050
|Description = Used when calculating ''SkillBonus''
}}
{{SettingGroupSetting
|Name = fGunSpreadWalkBase
|Default = 1
|Description = Used when calculating ''WalkPenalty''
}}
{{SettingGroupSetting
|Name = fGunSpreadWalkMult
|Default = 0
|Description = Used when calculating ''WalkPenalty''
}}
{{SettingGroupSetting
|Name = fGunSpreadRunBase
|Default = 1
|Description = Used when calculating ''RunPenalty''
}}
{{SettingGroupSetting
|Name = fGunSpreadRunMult
|Default = 0
|Description = Used when calculating ''RunPenalty''
}}
{{SettingGroupSetting
|Name = fGunSpreadArmBase
|Default = 0.5
|Description = Used when calculating  ''ArmPenalty''
}}
{{SettingGroupSetting
|Name = fGunSpreadArmMult
|Default = -0.5
|Description = Used when calculating ''ArmPenalty''
}}
{{SettingGroupFooter}}

=== Second spread formula ===

Use of an additional formula for the gun's own spread has been suggested, taking into account the role of Min. Spread and Spread. Until it's been validated and this page changed, see the "Discussion" page for details.

=== Minimum Spread ===

The gun spread value used by the game engine will never be less than the "Min Spread" value specified on the [[Weapons|weapon form]] for the equipped weapon. If the value given by the formula is less than the "Min Spread" value, the value from the formula will be ignored and the "Min Spread" value for the weapon will be used instead.

Most weapons have a non zero value for "Min Spread". Therefore, no matter how skilled you are with the weapon or what perks you have, your weapon will always have a slight amount of spread. One notable exception to this are sniper rifles, which have 0 minimum spread, allowing weapon spread to be eliminated with a small guns skill of 100.  The laser pistol and rifle also have 0 min spread.

=== Notes ===
This formula has been derived by systematically tweaking the settings using the console and observing the effects on the magnitude of weapon sway.

Spread is also taken into account when determining VATS accuracy, and is the primary way that weapon skill affects VATS accuracy.

The default value of 1 for fGunSpreadWalkBase is important in this formula. Without it, the (WalkPenalty + RunPenalty) part of the equation would be 0 when not moving, negating the other spread calculations. Also note that the fGunSpreadWalkBase value is 0 when running, but because fGunSpreadRunBase and fGunSpreadRunMult are also 0, you actually have ''less'' spread while running than you do while stationary with default settings!

The "spread" value on the [[Weapons|weapon form]] is ignored by the game engine. Only the "min spread" value is used.

=== Game settings not used by this formula ===
These are variables that should logically have an impact on this formula but do not appear to have any effect on the player character's gun spread when tweaked. Further research into these settings should be performed. Perhaps they only effect NPC gun spread?

*fGunSpreadHeadMult
*fGunSpreadHeadBase
*fGunSpreadNPCArmBase
*fGunSpreadNPCArmMult
*fNPCMaxGunWobbleAngle

=== Other notable game settings ===
;fGunWobbleMultScope
:Default value: 1.0
:This setting controls how much scoped weapons will wobble when aiming with the scope, but '''it does not modify the weapon spread.''' If you modify some game settings to give the sniper rifle considerable wobble and set this setting to 0, the cross hairs will not wobble when you use the scope, but the bullets will still fly off course because the gun is still wobbling (you just don't notice it anymore). Because of this, you should avoid modifying this setting, or else you will confuse players.