Difference between revisions of "Gun Spread Formula"

From the Fallout3 GECK Wiki
Jump to navigation Jump to search
imported>SnakeChomp
(Describe arm condition more accurately)
imported>DomFada
 
(5 intermediate revisions by 3 users not shown)
Line 5: Line 5:
'''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.
'''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
'''IronSightsBonus''' = fGunSpreadIronSightsBase + fGunSpreadIronSightsMult * ''IsUsingIronSights''
:*fGunSpreadIronSightsBase defaults to: 1.0
:*fGunSpreadIronSightsMult defaults to: -0.65
:*:This value is 0 unless aiming with iron sights (holding the right mouse button with the default control scheme)


'''CrouchBonus''' = fGunSpreadCrouchBase + fGunSpreadCrouchMult
'''CrouchBonus''' = fGunSpreadCrouchBase + fGunSpreadCrouchMult * ''IsSneaking''
:*fGunSpreadCrouchBase defaults to: 1.0
:*fGunSpreadCrouchMult defaults to: -0.4
:*:This value is 0 unless the actor is crouched (sneaking)


'''ConditionPenalty''' = fGunSpreadCondBase + WeaponCondition * fGunSpreadCondMult
'''ConditionPenalty''' = fGunSpreadCondBase + fGunSpreadCondMult * ''WeaponCondition''
:*fGunSpreadCondBase defaults to: 0.0
:*fGunSpreadCondMult defaults to: 0.0
:*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%


'''SkillBonus''' = fGunSpreadSkillBase + ActorSkillValue * fGunSpreadSkillMult
'''SkillBonus''' = fGunSpreadSkillBase + fGunSpreadSkillMult * ''ActorSkillValue''
:*fGunSpreadSkillBase defaults to: 0.5
:*fGunSpreadSkillMult defaults to: -0.0050
:*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]]


'''WalkPenalty''' = fGunSpreadWalkBase + fGunSpreadWalkMult
'''WalkPenalty''' = fGunSpreadWalkBase * !''IsRunning'' + fGunSpreadWalkMult * ''IsWalking''
:*fGunSpreadWalkBase defaults to: 1.0
:!''IsRunning'' means that if ''IsRunning'' is 1, !''IsRunning'' is 0, and vice versa.
:*:This value is zero unless the actor is walking or not moving
:*fGunSpreadWalkMult defaults to: 0.0
:*:This value is zero unless the actor is walking


'''RunPenalty''' = fGunSpreadRunBase + fGunSpreadRunMult
'''RunPenalty''' = (fGunSpreadRunBase + fGunSpreadRunMult) * ''IsRunning''
:*fGunSpreadRunBase defaults to: 1.0
:*:This value is zero unless the actor is running
:*fGunSpreadRunMult defaults to: 0.0
:*:This value is zero unless the actor is running


'''ArmPenalty''' = fGunSpreadArmBase + ArmCondition * fGunSpreadArmMult
'''ArmPenalty''' = fGunSpreadArmBase + fGunSpreadArmMult * ''ArmCondition''
:*fGunSpreadArmBase defaults to: 0.5
 
:*fGunSpreadArmMult defaults to: -0.5
 
:*When using a one handed weapon, ArmCondition is 1 with a healthy right arm and 0 with a crippled right arm.  
''IsUsingIronSights'' is 1 if the actor is aiming with iron sights and 0 otherwise, but there is no function by this name.
:*When using a two handed weapon, ArmCondition is 1 with both arms healthy, 0.5 with 1 arm crippled, 0 with two arms crippled.  
 
''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 ===
=== Minimum Spread ===
Line 49: Line 122:
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.
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.
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 ===
=== Notes ===
Line 60: Line 133:
The "spread" value on the [[Weapons|weapon form]] is ignored by the game engine. Only the "min spread" value is used.
The "spread" value on the [[Weapons|weapon form]] is ignored by the game engine. Only the "min spread" value is used.


=== Variables not used by this formula ===
=== 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?
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?


Line 69: Line 142:
*fNPCMaxGunWobbleAngle
*fNPCMaxGunWobbleAngle


=== Other notable settings ===
=== Other notable game settings ===
;fGunWobbleMultScope
;fGunWobbleMultScope
:Default value: 1.0
: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 of this, you should avoid modifying this setting, or else you will confuse players.
: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.

Latest revision as of 20:41, 11 November 2009


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 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[edit | edit source]

Setting Default Description
fGunSpreadIronSightsBase 1 Used when calculating IronSightsBonus
fGunSpreadIronSightsMult -0.65 Used when calculating IronSightsBonus
fGunSpreadCrouchBase 1 Used when calculating CrouchBonus
fGunSpreadCrouchMult -0.4 Used when calculating CrouchBonus
fGunSpreadCondBase 0 Used when calculating ConditionPenalty
fGunSpreadCondMult 0 Used when calculating ConditionPenalty
fGunSpreadSkillBase 0.5 Used when calculating SkillBonus
fGunSpreadSkillMult -0.0050 Used when calculating SkillBonus
fGunSpreadWalkBase 1 Used when calculating WalkPenalty
fGunSpreadWalkMult 0 Used when calculating WalkPenalty
fGunSpreadRunBase 1 Used when calculating RunPenalty
fGunSpreadRunMult 0 Used when calculating RunPenalty
fGunSpreadArmBase 0.5 Used when calculating ArmPenalty
fGunSpreadArmMult -0.5 Used when calculating ArmPenalty


Second spread formula[edit | edit source]

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[edit | edit source]

The gun spread value used by the game engine will never be less than the "Min Spread" value specified on the 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[edit | edit source]

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.

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

Game settings not used by this formula[edit | edit source]

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[edit | edit source]

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.