Difference between revisions of "Weapons"

From GECK

(Flags: Revised section, grammar changes.)
(General)
 
(50 intermediate revisions by 16 users not shown)
Line 4: Line 4:
 
*'''Name:''' The weapon’s name displayed in-game.
 
*'''Name:''' The weapon’s name displayed in-game.
 
*'''Script:''' Defines a script to play continuously on the weapon.
 
*'''Script:''' Defines a script to play continuously on the weapon.
*'''[[Object Effect]]:''' The Object Effect applied to the target when struck with the weapon.
+
*'''[[Object Effect]]:''' The Object Effect applied to the target when struck with the weapon. The effect will not be applied unless the weapon has at least 1 point of damage.
*'''[[Ammo|Ammunition]]:''' Specifies what type of ammo the weapon will use. This setting will also accept objects in a [[FormList]]. For more information, see [[Ammunition Tricks]].
+
*'''[[Ammo|Ammunition]]:''' Specifies what type of ammo the weapon will use. This setting will also accept objects in a [[FormList|Form List]]. For more information, see [[Ammunition Tricks]].
 
*'''Clip Rounds:''' The maximum number of rounds that can be stored in the weapon's clip.
 
*'''Clip Rounds:''' The maximum number of rounds that can be stored in the weapon's clip.
 +
*'''Regen Rate:''' Time in seconds to regenerate 1 unit of ammunition. Decimal values are allowed but on opening/reopening of the menu become rounded to the nearest whole number.
 +
**'''Example:''' A value of 0.1 will regenerate 10 units in one second (1 unit every tenth of a second), but upon reopening will display a value of 0, if this is not refixed before closing again the value will resave as the rounded value.
 
*'''Skill:''' Defines which skill factors into the weapon's damage and spread calculations. See [[Weapon Damage Formula]] & [[Gun Spread Formula]] for more details.
 
*'''Skill:''' Defines which skill factors into the weapon's damage and spread calculations. See [[Weapon Damage Formula]] & [[Gun Spread Formula]] for more details.
*'''Damage Per Second:''' The estimated damage done per second with the weapon's associated skill at 0 and 100.
+
*'''Damage Per Second:''' The estimated damage done per second with the weapon's associated skill at 0 and 100. The following settings factor into the GECK's DPS calculator:
*'''Repair Item List:''' The specified [[FormList]] containing objects used to repair the weapon.
+
**'''Damage:''' Damage done per melee swing or gun shot.  The primary factor in the DPS calculation.
*'''[[Equip Type]]:''' Categorization of the weapon used in-game.
+
**'''Fire Rate:''' The number of rounds fired every 2 seconds.  Only affects the DPS formula if the "Automatic" box is checked.
:''Note:'' ''It's unknown if this setting does anything beyond changing the hotkey icon.''
+
**'''Mulitplier & Attack Multiplier:''' The DPS can only be calculated if these variables are set above zero.
 +
*'''Repair Item List:''' The specified [[FormList|Form List]] containing objects used to repair the weapon.
 +
*'''[[Equip Type]]:''' Determines the weapon's categorization and hotkey icon.''
  
 
=='''Flags'''==
 
=='''Flags'''==
*'''NPCs Use Ammo:''' NPCs will use the associated ammo in their inventory; if their ammo is depleted, they cannot use the weapon. (This setting is disabled by default.)
+
*'''NPCs Use Ammo:''' NPCs will use up the associated ammo in their inventory like the player does. (This setting is disabled by default.)
*'''Ignores Normal Weapon Resistance:''' ''This setting is obsolete.''
+
*'''Ignores Normal Weapon Resistance:''' ''Broken as of 1.5 patch.'' Causes the weapon to ignore the target's armour when calculating damage.
*'''Automatic:''' Holding the attack button down will cause the weapon to fire continuously.
+
*'''Automatic:''' Holding the attack button down will cause the weapon to fire continuously.  May not function properly if an incompatible firing animation is selected.
*'''Can't Drop:''' The weapon cannot be disarmed from actors, nor will it drop when the actor dies; however, the player can remove it from the actor’s inventory if the “Playable” option is checked. This setting is usually reserved for weapons that are mounted into the actor.
+
*'''Can't Drop:''' The weapon cannot be disarmed from actors, nor will it drop when the actor dies; however, the player can remove it from the actor’s inventory if the “Playable” option is checked.
 
*'''Not Used in Normal Combat:''' Prevents NPCs from using the weapon unless specified in the [[Use Weapon Package]].
 
*'''Not Used in Normal Combat:''' Prevents NPCs from using the weapon unless specified in the [[Use Weapon Package]].
 
*'''Quest Item:''' The weapon cannot be removed from the world, nor can it be removed from the player’s inventory.
 
*'''Quest Item:''' The weapon cannot be removed from the world, nor can it be removed from the player’s inventory.
*'''Playable:''' The weapon can be used and picked up by the player. When disabled, the "Can't Drop" setting will be checked automatically, and the weapon won't show up in the NPC inventory screen.
+
*'''Playable:''' The weapon can be used and picked up by the player. When disabled, the "Can't Drop" setting will be checked automatically, and the weapon won't show up in the NPC inventory screen. This setting is generally unchecked for weapons that are mounted into the actor.
 
*'''Player Only:''' NPCs will not use or pick up the weapon.
 
*'''Player Only:''' NPCs will not use or pick up the weapon.
*'''No Jam After Reload:''' Prevents the weapon from jamming.
+
*'''No Jam After Reload:''' The weapon will never jam after a reload. See [[fWeaponConditionReloadJamXX]] for more details.
*'''Minor Crime:''' Attacking an NPC with the weapon will be considered a minor crime (as opposed to assault, a major crime).
+
*'''Minor Crime:''' Attacking an NPC with the weapon will be considered a minor crime (as opposed to assault, a major crime). For more information, see [[:Category:Crime|Crime]].
*'''Hide Backpack:''' ''Unknown''
+
*'''Hide Backpack:''' Hides any equipped armor or armor addon that occupies the "Backpack" biped slot.
  
 
=='''Game Data Tab'''==
 
=='''Game Data Tab'''==
*'''Weight:''' The weight of the object.
+
*'''Weight:''' The weight of the weapon.
*'''Health:''' The condition of the object; How much damage the  weapon can take before being destroyed/useless.
+
*'''Health:''' The weapon's condition, which determines the damage it can take before being destroyed.
*'''Reach:''' For melee weapons, this is a multiplier used in the reach formula: fCombatDistance * NPCScale * WeaponReach (where fCombatDistance is a gamesetting).
+
*'''Reach:''' For melee weapons, this is a multiplier used in the reach formula: [[fCombatDistance]] * NPCScale * Reach (where fCombatDistance is a game setting).
*'''Fire Rate:''' Number of shots per second. This is only valid for automatic weapons. Single shot weapons are restricted by their attack animation. Their "rate of fire" can be altered by changing the Attack Multiplier in the Animation group.
+
*'''Fire Rate:''' The number of shots the weapon can fire per second.
** As mentioned above, this variable only affects the GECK's DPS calculation if the "Automatic" box is checked.
+
:'''Note:''' This only applies to automatic weapons;  the rate of fire for single-shot weapons is dictated by the "Attack Multiplier," which can be found under "Art & Sound" -> "Animation."
*'''Spread:''' Not used.
+
*'''Spread:''' ''This value has no known effect on the aim of the weapon (see discussion for more details.)''
*'''Min Spread:''' Spread of the projectiles, in degrees.
+
*'''Min Spread:''' The median angle, in degrees, at which projectiles will radiate out of the gun's barrel. Projectiles will deviate at a minimum angle of 0° and a maximum angle of twice this value. For more information, see [[Gun Spread Formula]].
*'''Sight FOV:''' The angle of view when using Iron Sights. Done by zooming in.
+
*'''Sight FOV:''' The angle of view when using iron sights (zooming in). The applicable values, and their corresponding effect, is as follows:
*'''Sight Usage:'''
+
 
*'''Crit Dmg:''' How much extra damage the weapon does on a critical hit. This is not a multiplier. It's added damage. Additionally, this damage is added after armor, effectively making it bypass the target's armor.
+
 
*'''Aim Arc:''': Probably unused, as the projectile arc is actually controlled in the [[Projectile]] object itself.
+
{|border="1" cellpadding="5" cellspacing="0" align="center"
*'''Value:''' Monetary value in bottlecaps.
+
|-
*'''Damage:''' Damage this weapon does per hit. See the [[Weapon Damage Formula]] for more information.
+
! style="background:#efefef;" align="center" | Value
** This variable affects the GECK-calculated DPS stat in real time.
+
! style="background:#efefef;" | Effect
*'''Ammo Use:''' How much ammo is used from the clip when this weapon is fired.
+
|-
*'''# Projectiles:''' Number of projectiles per single ammo object.
+
|align="center"| 1-5, 75 || No change in field of vision.
*'''Limb Dmg Mult:''' Affects how much damage the weapon does to limbs. ''Note: This is unconfirmed, but if this setting is set to zero or lower, it will revert to the regular damage multiplier.''
+
|-
*'''Base VATS To-Hit Chance:''' Before distance, gun skill and screen percentage are applied, the base chance to hit this weapon in VATS. Should vary by the size of the weapon. (This is for when the player is aiming at weapons on enemies).
+
|align="center"|75 >|| Narrows the field of vision, allowing the player to see further away.
*'''Crit % Mult:''' Modifier to actor's critical chance derived attribute. Usually set to one. If set to zero, the weapon will not cause critical hits. Automatic weapons use this value divided by the Fire Rate. For example, an Assault Rifle has a Crit % Mult of 1.0, and a Fire Rate of 8. Therefore each bullet has a 0.125 multiplier to the critical percent chance. See the [[Critical Hit Chance Formula]] for specific information as to how this value effects the critical hit chance.
+
|-
*'''Burst Shot''': Checkbox.  Probably unused, as burst weapons like the SMG and Assault Rifle do not have it checked.
+
|align="center"|75 <|| Widens the field of vision, increasing the player's peripheral vision.
*'''Long Bursts''' Checkbox. Weapons like the Minigun, Gatling Laser, and Flamer have this checked, and may indicate that the weapon continues firing even after the trigger stops being held down. It may also be unused as this may actually be controlled elsewhere.
+
|-
 +
|align="center"|0 || Essentially disables iron sights. Sight FOV can't be set lower than zero.
 +
|}
 +
 
 +
 
 +
*'''Sight Usage:''' <font color="#800000"> ''Unknown'' </font>
 +
*'''Crit Dmg:''' The added damage the weapon will do on a critical hit. This value does not take the target's DR into account, effectively bypassing armor.
 +
*'''Value:''' Base monetary value in bottle caps, before barter skill and weapon condition is factored in.  
 +
*'''Damage:''' The amount of damage done per hit. See the [[Weapon Damage Formula]] for more information.
 +
*'''Ammo Use:''' The amount of ammo used per shot.
 +
*'''# Projectiles:''' The number of projectiles fired per shot.
 +
*'''Limb Dmg Mult:''' Affects how much damage the weapon does to limbs.
 +
:'''Note:''' This is unconfirmed, but if this setting is set to zero or lower, it will revert to the default damage multiplier.
 +
*'''Base VATS To-Hit Chance:''' In VATS, this variable controls the chance to hit the weapon when it's held by another actor; this is factored before distance, gun skill, and [[FVATSScreenPercentFactor|screen percentage]] are taken into account. Usually, this value is set based upon the size of the weapon.
 +
*'''Crit % Mult:''' The weapon multiplier used in the critical hit chance formula. If set to zero, the weapon will not cause any critical hits, even for sneak attacks. Normally, this setting is left at one. See the [[Critical Hit Chance Formula]] for more details.
 +
:'''Note:''' For automatic weapons, this value is divided by the "Fire Rate." For example, an Assault Rifle has a "Crit % Mult" of 1.0, and a "Fire Rate" of 8, so the actual multiplier would be 0.125 per shot.
 +
*'''Burst Shot:''' <font color="#800000"> ''Unknown; burst weapons like the SMG and Assault Rifle do not have this setting checked.'' </font>
 +
*'''Long Bursts:''' If this box is checked, the weapon will fire in longer bursts during VATS. This setting only applies to automatic weapons.
 +
<blockquote>
 +
'''Possible GECK v1.1 Bug:''' If you close the Weapon Form window while "Long Bursts" is checked, you will no longer be able to disable the setting (i.e. every time you uncheck it, it will remain checked the next time you open the window). However, [[FO3Edit]] can be used to disable this setting if necessary.
 +
</blockquote>
 +
*'''Aim Arc:''' The arc along which the projectile travels. At 0, the projectile travels along a straight line and there is no need for vertical aim adjustment. [Unconfirmed but this is the best educated guess] <font color="#800000"> ''Unknown; it seems the only setting that affects the projectile's arc is the "Gravity" setting in the [[Projectile]] form.'' </font>
 +
*'''Kill Impulse:''' A number that probably relates to damage caused to a target; it is unknown how the number represents that damage, but what is confirmed is that it determines at which level the target is pushed back.
 +
*'''Impulse Dist:''' If the number in "Kill Impulse" is achieved, this is the distance that the target is pushed back.
 
*'''Semi-Automatic Fire Delay Min:'''
 
*'''Semi-Automatic Fire Delay Min:'''
*'''Semi-Automatic Fire Delay Max:'''  
+
*'''Semi-Automatic Fire Delay Max:'''
** This allows semi-auto weapons to have a "sticky trigger" effect.  This variable affects the GECK-calculated DPS stat.  However, the affect only appears after you click OK and close the Weapon window.
+
** Determines semi-auto weapon's fire rate when used by NPCs.  This variable affects the GECK-calculated DPS stat.  However, the affect only appears after you click OK and close the Weapon window.
*'''Crit Effect:''' The "spell" that is applied to the target on a critical hit. Must have ONLY self-targeted effects. See [[Critical Tricks]].
+
*'''Crit Effect:''' The [[Actor Effect]] that is applied to the target on a critical hit. In order for an Actor Effect to be listed, its range must be set to "Self." See [[Critical Tricks]].
**'''On Death:''' If checked, critical effect is only applied when the target is killed.
+
**'''On Death:''' If checked, the Critical Effect is only applied when the target is killed.
 
*'''Resist:''' This determines the Damage Type of the weapon, by specifying the resistance value that affects the damage dealt.  For example, the Flamer is set to FireResist, which sets the damage type as Fire.
 
*'''Resist:''' This determines the Damage Type of the weapon, by specifying the resistance value that affects the damage dealt.  For example, the Flamer is set to FireResist, which sets the damage type as Fire.
** '''Options''': NONE, DamageResist, ElectricResist, EmpResist, EnergyResist, FireResist, FrostResist, PoisonResist, and RadResist.
+
** '''Options:''' NONE, DamageResist, ElectricResist, EmpResist, EnergyResist, FireResist, FrostResist, PoisonResist, and RadResist.
  
 
==='''On Hit'''===
 
==='''On Hit'''===
Line 65: Line 92:
 
*'''Min Range:''' Tells combat AI they don't need to be closer than this value.
 
*'''Min Range:''' Tells combat AI they don't need to be closer than this value.
 
*'''Max Range:''' Tells combat AI they don't want to be any further away than this value.
 
*'''Max Range:''' Tells combat AI they don't want to be any further away than this value.
*'''Range is Fixed:''' Tells the combat AI not to use combat style multipliers for this weapon.
+
*'''Fixed:''' If checked, the combat AI will not use [[Combat Style]] multipliers for the weapon.
  
 
==='''Override'''===
 
==='''Override'''===
*'''Action Points:''' Override the standard number of action points a weapon uses.
+
*'''Action Points:''' Overrides the standard number of action points the weapon uses.
*'''Damage to Weapon Multiplier:''' Override the multiplier that determines the amount of damage the weapon will take. (0.0 causes the weapon to take no damage. > 1.0 causes the weapon to take more damage than it delivers)
+
*'''Damage to Weapon Multiplier:''' Overrides the multiplier that determines the amount of damage the weapon will take. (0.0 causes the weapon to take no damage. > 1.0 causes the weapon to take more damage than it delivers)
  
==='''Embedded Weapon:'''===
+
==='''Embedded Weapon'''===
 
Checked if the weapon is a built in part of the creature.
 
Checked if the weapon is a built in part of the creature.
 
*'''Node:''' Node that the weapon is attached to.
 
*'''Node:''' Node that the weapon is attached to.
*'''Actor Value:''' The condition value affected when the weapon is targetted.
+
*'''Actor Value:''' The condition value affected when the weapon is targeted.
  
 
=='''Art and Sound Tab'''==
 
=='''Art and Sound Tab'''==
*'''Inventory Image:''' The image the weapon is identified with in inventory.
+
*'''Inventory Image:''' The image the weapon is identified with in the inventory screen.
*'''Message Icon:''' The icon that appears on aquiring the weapon.
+
*'''Message Icon:''' The icon that appears on acquiring the weapon.
*'''[[Projectile]]:''' The Projectile object used by the weapon, found in the Miscellaneous list.
+
*'''Projectile:''' The projectile used by the weapon, found under [[Special Effects]] -> [[Projectile]] in the [[Object Window]].
*'''[[ImpactDataSet|Impact Data Set]]:''' Determines how this weapon effects different material types.
+
*'''[[ImpactDataSet|Impact Data Set]]:''' Determines how the weapon affects different material types on impact.
*'''Reload Anim:''' The animation object used for reloading this weapon.
+
*'''Reload Anim:''' The reload animation used for the weapon.
*'''Hand Grip:''' Determines the type of hand grip used for this weapon.
+
*'''Hand Grip:''' Determines how the weapon is gripped.
*'''Attack Anim:''' The firing animation used for this weapon.
+
*'''Attack Anim:''' The firing animation used for the weapon.
*'''Shell Casing:''' The name of the file used for the 3D model of the shell casing expended by this weapon.
+
*'''Shell Casing:''' The file containing the 3D model of the weapon's shell casings.
*'''Attack Sound:''' The sound made by this weapon when it is fired.
+
*'''Animation Type:''' Determines which animations the weapon can use. For more details on how this value can be used in scripts, see [[GetWeaponAnimType]].
*'''Attack Sound (First Person):''' Determines the sound file used in first person attacks with this weapon.
+
*'''Attack Sound:''' The sound form played when an NPC fires the weapon.
*'''Attack Fail (No Ammo/Melee Miss):''' The sound made by this weapon when it runs out of ammunition or misses.
+
*'''Attack Sound (2D):''' The sound form played when the player fires the weapon.
*'''Animation Type:''' Determines the type of animations the wielder of this weapon will use.  
+
*'''Attack Loop:''' The sound loop used when the weapon is fired. For instance, the Flamer and the Minigun use this instead of "Attack Sound."
*'''Detection Sound Level:''' Volume of weapon as it is fired.
+
*'''Attack Fail (No Ammo/Melee Miss):''' The sound form used by the weapon when it runs out of ammunition or, in the case of melee weapons, when it misses.
 +
*'''Melee Block:''' The sound form played whenever the weapon is hit while blocking.
 +
*'''Detection Sound Level:''' Volume of the weapon as it is fired.
 
*'''Add Destruction Data:''' Used to define what the weapon will look like when it's damaged.
 
*'''Add Destruction Data:''' Used to define what the weapon will look like when it's damaged.
*'''Pickup Sound:''' Sound file payed on picking up the weapon
+
*'''Idle Sound:''' The sound form played whenever the weapon is held. For example, the Flamer makes a hissing noise when idle.
*'''Putdown Sound:''' Sound file played when the weapon is put down.
+
*'''Equip Sound:''' The sound form played when the weapon is drawn.
 +
*'''Unequip Sound:''' The sound form played when the weapon is holstered.
 +
*'''Pickup Sound:''' The sound form played when the weapon is added to the player's inventory, or when it's equipped.
 +
*'''Putdown Sound:''' The sound played when the weapon is removed from the player's inventory, or when it's unequipped.
  
 
==='''Model'''===
 
==='''Model'''===
*'''Model:''' The model used for this weapon when it appears in the world or in use by NPCs.
+
*'''Model:''' The file containing the weapon's default model.
*'''1st Person Model Object:''' The model used for this weapon when used by the player.  It is listed as a [[static|static object]] entry pointing to the same mesh as the Model, usually with higher-res [[TextureSet|texture set]] overrides.
+
:'''Note:''' This is the only setting that dictates how the weapon will appear on NPCs.
*'''Armor List:''' Used when a weapon requires skin geometry (such as the oven mitten on the Shiskebab).
+
*'''1st Person Model Object:''' The [[Static|static object]] that overrides the default model when the player uses the weapon. Usually, this is the same mesh as the "Model," but with higher resolution [[TextureSet|Texture Set]] overrides.
*'''World Model:''' Used to differentiate between the world model and the model seen on actors.
+
*'''Armor List:''' The [[FormList|Form List]] containing [[Armor]], or [[ArmorAddon|Armor Addons]], which an actor will wear when they equip the weapon. For example, the Shishkebab uses a Form List containing the Armor Addon "ARMAShishkebabGlove" (an oven mitt worn on the right hand).
 
+
*'''World Model:''' The model that overrides the default model when the weapon is placed in the world.
'''Note''': In order to change textures for a weapon, you must change the textures for both the Models listed here, as well as the textures for the corresponding 1st Person Model Object, which can be found under [[WorldObjects]] -> [[Static|Statics]] in the [[Object Window]]
+
<blockquote>
 +
'''Regarding Textures''': In order to change textures for a weapon, you must change the textures for both the Models listed here, as well as the textures for the corresponding 1st Person Model Object, which can be found under [[WorldObjects|World Objects]] -> [[Static|Static]] in the [[Object Window]]
 +
</blockquote>
  
 
==='''Animation'''===
 
==='''Animation'''===
*'''Multiplier:''' Speeds up or slows down the weapon's animation speeds.
+
*'''Multiplier:''' Increases or decreases the weapon's firing and holstering animation speed.
*'''Attack Multiplier:''' Speeds up or slows down just the attack animations.
+
:'''Note:''' This setting does not actually affect reload or jam animation speed, despite what the GECK says.
*'''Don't Use 1st Person IS Animations:''' Check to keep the weapon from using iron sights animations in 1st person mode.
+
*'''Attack Multiplier:''' Speeds up or slows down just the attack animation.  
*'''Don't Use 3rd Person IS Animations:''' Check to keep the weapon from using iron sights animations in 3rd person mode.
+
*'''Don't Use 1st Person IS Animations:''' When checked, the player will not use the weapon's iron sight animation in 1st person mode.
*'''Attack Shots/Sec:''' How many shots
+
*'''Don't Use 3rd Person IS Animations:''' When checked, actors, including the player when in 3rd person mode, will not use the weapon's iron sight animation.
*'''Reload Time:''' How many reload animations can play per sec.
+
*'''Attack Shots/Sec:''' How many shots the weapon can fire per second.
*'''Jam Time:''' How many Jam animations can to play.
+
*'''Reload Time:''' ''Unused.''
 +
*'''Jam Time:''' ''Unused.''
  
 
==='''Has Scope'''===
 
==='''Has Scope'''===
The weapon can zoom in on a target in iron sights mode.
+
*'''Target NIF:''' The file containing the overlay effect used in iron sights mode.
*'''Target NIF:''' The file name of the overlay effect.
+
*'''Effect:''' The shader effect applied to the target, or the view, when the scope is used.
*'''Effect:''' The effect shader applied to the target or the view when the scope is used.
+
:'''Note:''' It appears that this value is ignored by the game engine.
*:'''Note:''' It appears that this value is ignored by the game engine.
+
  
 
=='''Rumble Tab'''==
 
=='''Rumble Tab'''==
Line 121: Line 155:
 
*'''Right motor strength:''' Sets the rumble strength for the right side of the controller.
 
*'''Right motor strength:''' Sets the rumble strength for the right side of the controller.
 
*'''Duration:''' Sets the duration for the controller to rumble.
 
*'''Duration:''' Sets the duration for the controller to rumble.
 +
*'''Pattern:''' Determines the vibration waveform used.
 +
*'''Wavelength:''' <font color="#800000"> ''Unknown'' </font>
 +
*'''Alternate:''' <font color="#800000"> ''Unknown'' </font>
  
=='''Misc Info'''==
+
=='''Custom Weapons'''==
For those who have created a custom weapon and would like to add it to their inventory via the console...its quite simple.  First you need to get the Form ID number of your weapon. This is found in the [[Object Window]] in the GECK right next to your weapon's Editor ID. By default, the Form ID column is hidden, so you will need to expand it to make it visible.  Write this value down.  Next open Fallout Mod Manager and find your mod.  Substitute the first 2 numbers in the Form ID you wrote down for the mod index number of your mod.  You can now add the weapon to your inventory in-game using the console command player.additem FORMID COUNT, where FORMID is the value you wrote down and count is the number to add.
+
To find out how to make weapon models, see [[Creating A Custom Weapon]].
  
'''Example:''' If my weapon's Form ID in the GECK was 01010b5c and my mod index number is 17, then the command I would type in-game would be: player.additem 17010b5c 1.
+
To add a custom weapon to your inventory via the console, follow these steps:
 +
# In the GECK, find the Form ID number of your weapon. By default, the Form ID column is hidden, so you will need to expand it to make it visible (it's found in the [[Object Window]] between ''Editor ID'' and ''Count'').
 +
# Open the [[Fallout Mod Manager]] and find the index number of your mod. Substitute the first 2 numbers in the Form ID for the mod index number of your mod. For example, if your weapon's Form ID is '''01'''010b5c, and your mod index number is 17, the number would be '''17'''010b5c.
 +
# In game, bring up the console by pressing the tilde (~) key, then type:
 +
<blockquote>
 +
player.additem ''FormID'' ''Count''
 +
</blockquote>
 +
''FormID'' stands for the modified Form ID and ''Count'' refers to the number of objects you wish to add. So for example, you might type:
 +
<blockquote>
 +
player.additem 17010b5c 1
 +
</blockquote>
  
 
[[Category:Items]]
 
[[Category:Items]]
 
[[Category:VATS]]
 
[[Category:VATS]]

Latest revision as of 23:04, 17 April 2018

This article is incomplete. You can help by filling in any blank descriptions.
Further information might be found in a section of the discussion page. Please remove this message when no longer necessary.

General

  • ID: The weapon's Editor ID.
  • Name: The weapon’s name displayed in-game.
  • Script: Defines a script to play continuously on the weapon.
  • Object Effect: The Object Effect applied to the target when struck with the weapon. The effect will not be applied unless the weapon has at least 1 point of damage.
  • Ammunition: Specifies what type of ammo the weapon will use. This setting will also accept objects in a Form List. For more information, see Ammunition Tricks.
  • Clip Rounds: The maximum number of rounds that can be stored in the weapon's clip.
  • Regen Rate: Time in seconds to regenerate 1 unit of ammunition. Decimal values are allowed but on opening/reopening of the menu become rounded to the nearest whole number.
    • Example: A value of 0.1 will regenerate 10 units in one second (1 unit every tenth of a second), but upon reopening will display a value of 0, if this is not refixed before closing again the value will resave as the rounded value.
  • Skill: Defines which skill factors into the weapon's damage and spread calculations. See Weapon Damage Formula & Gun Spread Formula for more details.
  • Damage Per Second: The estimated damage done per second with the weapon's associated skill at 0 and 100. The following settings factor into the GECK's DPS calculator:
    • Damage: Damage done per melee swing or gun shot. The primary factor in the DPS calculation.
    • Fire Rate: The number of rounds fired every 2 seconds. Only affects the DPS formula if the "Automatic" box is checked.
    • Mulitplier & Attack Multiplier: The DPS can only be calculated if these variables are set above zero.
  • Repair Item List: The specified Form List containing objects used to repair the weapon.
  • Equip Type: Determines the weapon's categorization and hotkey icon.

Flags

  • NPCs Use Ammo: NPCs will use up the associated ammo in their inventory like the player does. (This setting is disabled by default.)
  • Ignores Normal Weapon Resistance: Broken as of 1.5 patch. Causes the weapon to ignore the target's armour when calculating damage.
  • Automatic: Holding the attack button down will cause the weapon to fire continuously. May not function properly if an incompatible firing animation is selected.
  • Can't Drop: The weapon cannot be disarmed from actors, nor will it drop when the actor dies; however, the player can remove it from the actor’s inventory if the “Playable” option is checked.
  • Not Used in Normal Combat: Prevents NPCs from using the weapon unless specified in the Use Weapon Package.
  • Quest Item: The weapon cannot be removed from the world, nor can it be removed from the player’s inventory.
  • Playable: The weapon can be used and picked up by the player. When disabled, the "Can't Drop" setting will be checked automatically, and the weapon won't show up in the NPC inventory screen. This setting is generally unchecked for weapons that are mounted into the actor.
  • Player Only: NPCs will not use or pick up the weapon.
  • No Jam After Reload: The weapon will never jam after a reload. See fWeaponConditionReloadJamXX for more details.
  • Minor Crime: Attacking an NPC with the weapon will be considered a minor crime (as opposed to assault, a major crime). For more information, see Crime.
  • Hide Backpack: Hides any equipped armor or armor addon that occupies the "Backpack" biped slot.

Game Data Tab

  • Weight: The weight of the weapon.
  • Health: The weapon's condition, which determines the damage it can take before being destroyed.
  • Reach: For melee weapons, this is a multiplier used in the reach formula: fCombatDistance * NPCScale * Reach (where fCombatDistance is a game setting).
  • Fire Rate: The number of shots the weapon can fire per second.
Note: This only applies to automatic weapons; the rate of fire for single-shot weapons is dictated by the "Attack Multiplier," which can be found under "Art & Sound" -> "Animation."
  • Spread: This value has no known effect on the aim of the weapon (see discussion for more details.)
  • Min Spread: The median angle, in degrees, at which projectiles will radiate out of the gun's barrel. Projectiles will deviate at a minimum angle of 0° and a maximum angle of twice this value. For more information, see Gun Spread Formula.
  • Sight FOV: The angle of view when using iron sights (zooming in). The applicable values, and their corresponding effect, is as follows:


Value Effect
1-5, 75 No change in field of vision.
75 > Narrows the field of vision, allowing the player to see further away.
75 < Widens the field of vision, increasing the player's peripheral vision.
0 Essentially disables iron sights. Sight FOV can't be set lower than zero.


  • Sight Usage: Unknown
  • Crit Dmg: The added damage the weapon will do on a critical hit. This value does not take the target's DR into account, effectively bypassing armor.
  • Value: Base monetary value in bottle caps, before barter skill and weapon condition is factored in.
  • Damage: The amount of damage done per hit. See the Weapon Damage Formula for more information.
  • Ammo Use: The amount of ammo used per shot.
  • # Projectiles: The number of projectiles fired per shot.
  • Limb Dmg Mult: Affects how much damage the weapon does to limbs.
Note: This is unconfirmed, but if this setting is set to zero or lower, it will revert to the default damage multiplier.
  • Base VATS To-Hit Chance: In VATS, this variable controls the chance to hit the weapon when it's held by another actor; this is factored before distance, gun skill, and screen percentage are taken into account. Usually, this value is set based upon the size of the weapon.
  • Crit % Mult: The weapon multiplier used in the critical hit chance formula. If set to zero, the weapon will not cause any critical hits, even for sneak attacks. Normally, this setting is left at one. See the Critical Hit Chance Formula for more details.
Note: For automatic weapons, this value is divided by the "Fire Rate." For example, an Assault Rifle has a "Crit % Mult" of 1.0, and a "Fire Rate" of 8, so the actual multiplier would be 0.125 per shot.
  • Burst Shot: Unknown; burst weapons like the SMG and Assault Rifle do not have this setting checked.
  • Long Bursts: If this box is checked, the weapon will fire in longer bursts during VATS. This setting only applies to automatic weapons.

Possible GECK v1.1 Bug: If you close the Weapon Form window while "Long Bursts" is checked, you will no longer be able to disable the setting (i.e. every time you uncheck it, it will remain checked the next time you open the window). However, FO3Edit can be used to disable this setting if necessary.

  • Aim Arc: The arc along which the projectile travels. At 0, the projectile travels along a straight line and there is no need for vertical aim adjustment. [Unconfirmed but this is the best educated guess] Unknown; it seems the only setting that affects the projectile's arc is the "Gravity" setting in the Projectile form.
  • Kill Impulse: A number that probably relates to damage caused to a target; it is unknown how the number represents that damage, but what is confirmed is that it determines at which level the target is pushed back.
  • Impulse Dist: If the number in "Kill Impulse" is achieved, this is the distance that the target is pushed back.
  • Semi-Automatic Fire Delay Min:
  • Semi-Automatic Fire Delay Max:
    • Determines semi-auto weapon's fire rate when used by NPCs. This variable affects the GECK-calculated DPS stat. However, the affect only appears after you click OK and close the Weapon window.
  • Crit Effect: The Actor Effect that is applied to the target on a critical hit. In order for an Actor Effect to be listed, its range must be set to "Self." See Critical Tricks.
    • On Death: If checked, the Critical Effect is only applied when the target is killed.
  • Resist: This determines the Damage Type of the weapon, by specifying the resistance value that affects the damage dealt. For example, the Flamer is set to FireResist, which sets the damage type as Fire.
    • Options: NONE, DamageResist, ElectricResist, EmpResist, EnergyResist, FireResist, FrostResist, PoisonResist, and RadResist.

On Hit

  • Normal formula behavior: The weapon will calculate the chance to sever and explode limbs.
  • Dismember only: The weapon will only calculate the chance to sever limbs.
  • Explode only: The weapon will only calculate the chance to explode limbs.
  • No Dismember/Explode: All limbs hit by the weapon will remain intact.

Range

  • Min Range: Tells combat AI they don't need to be closer than this value.
  • Max Range: Tells combat AI they don't want to be any further away than this value.
  • Fixed: If checked, the combat AI will not use Combat Style multipliers for the weapon.

Override

  • Action Points: Overrides the standard number of action points the weapon uses.
  • Damage to Weapon Multiplier: Overrides the multiplier that determines the amount of damage the weapon will take. (0.0 causes the weapon to take no damage. > 1.0 causes the weapon to take more damage than it delivers)

Embedded Weapon

Checked if the weapon is a built in part of the creature.

  • Node: Node that the weapon is attached to.
  • Actor Value: The condition value affected when the weapon is targeted.

Art and Sound Tab

  • Inventory Image: The image the weapon is identified with in the inventory screen.
  • Message Icon: The icon that appears on acquiring the weapon.
  • Projectile: The projectile used by the weapon, found under Special Effects -> Projectile in the Object Window.
  • Impact Data Set: Determines how the weapon affects different material types on impact.
  • Reload Anim: The reload animation used for the weapon.
  • Hand Grip: Determines how the weapon is gripped.
  • Attack Anim: The firing animation used for the weapon.
  • Shell Casing: The file containing the 3D model of the weapon's shell casings.
  • Animation Type: Determines which animations the weapon can use. For more details on how this value can be used in scripts, see GetWeaponAnimType.
  • Attack Sound: The sound form played when an NPC fires the weapon.
  • Attack Sound (2D): The sound form played when the player fires the weapon.
  • Attack Loop: The sound loop used when the weapon is fired. For instance, the Flamer and the Minigun use this instead of "Attack Sound."
  • Attack Fail (No Ammo/Melee Miss): The sound form used by the weapon when it runs out of ammunition or, in the case of melee weapons, when it misses.
  • Melee Block: The sound form played whenever the weapon is hit while blocking.
  • Detection Sound Level: Volume of the weapon as it is fired.
  • Add Destruction Data: Used to define what the weapon will look like when it's damaged.
  • Idle Sound: The sound form played whenever the weapon is held. For example, the Flamer makes a hissing noise when idle.
  • Equip Sound: The sound form played when the weapon is drawn.
  • Unequip Sound: The sound form played when the weapon is holstered.
  • Pickup Sound: The sound form played when the weapon is added to the player's inventory, or when it's equipped.
  • Putdown Sound: The sound played when the weapon is removed from the player's inventory, or when it's unequipped.

Model

  • Model: The file containing the weapon's default model.
Note: This is the only setting that dictates how the weapon will appear on NPCs.
  • 1st Person Model Object: The static object that overrides the default model when the player uses the weapon. Usually, this is the same mesh as the "Model," but with higher resolution Texture Set overrides.
  • Armor List: The Form List containing Armor, or Armor Addons, which an actor will wear when they equip the weapon. For example, the Shishkebab uses a Form List containing the Armor Addon "ARMAShishkebabGlove" (an oven mitt worn on the right hand).
  • World Model: The model that overrides the default model when the weapon is placed in the world.

Regarding Textures: In order to change textures for a weapon, you must change the textures for both the Models listed here, as well as the textures for the corresponding 1st Person Model Object, which can be found under World Objects -> Static in the Object Window

Animation

  • Multiplier: Increases or decreases the weapon's firing and holstering animation speed.
Note: This setting does not actually affect reload or jam animation speed, despite what the GECK says.
  • Attack Multiplier: Speeds up or slows down just the attack animation.
  • Don't Use 1st Person IS Animations: When checked, the player will not use the weapon's iron sight animation in 1st person mode.
  • Don't Use 3rd Person IS Animations: When checked, actors, including the player when in 3rd person mode, will not use the weapon's iron sight animation.
  • Attack Shots/Sec: How many shots the weapon can fire per second.
  • Reload Time: Unused.
  • Jam Time: Unused.

Has Scope

  • Target NIF: The file containing the overlay effect used in iron sights mode.
  • Effect: The shader effect applied to the target, or the view, when the scope is used.
Note: It appears that this value is ignored by the game engine.

Rumble Tab

  • Left motor strength: Sets the rumble strength for the left side of the controller.
  • Right motor strength: Sets the rumble strength for the right side of the controller.
  • Duration: Sets the duration for the controller to rumble.
  • Pattern: Determines the vibration waveform used.
  • Wavelength: Unknown
  • Alternate: Unknown

Custom Weapons

To find out how to make weapon models, see Creating A Custom Weapon.

To add a custom weapon to your inventory via the console, follow these steps:

  1. In the GECK, find the Form ID number of your weapon. By default, the Form ID column is hidden, so you will need to expand it to make it visible (it's found in the Object Window between Editor ID and Count).
  2. Open the Fallout Mod Manager and find the index number of your mod. Substitute the first 2 numbers in the Form ID for the mod index number of your mod. For example, if your weapon's Form ID is 01010b5c, and your mod index number is 17, the number would be 17010b5c.
  3. In game, bring up the console by pressing the tilde (~) key, then type:

player.additem FormID Count

FormID stands for the modified Form ID and Count refers to the number of objects you wish to add. So for example, you might type:

player.additem 17010b5c 1

Personal tools