Difference between revisions of "Weapons.tbl"

From FreeSpace Wiki
Jump to: navigation, search
m (fixed 'player allowed' flag)
m (unfinished atm..)
Line 1: Line 1:
 +
Revision information.. <!-- Please update this information when page is updated -->
 +
::'''3.6.x branch:''' 2.180.2.20
 +
::'''3.7 branch:''' 2.207
 +
 +
 
==Special Case Weapons==
 
==Special Case Weapons==
 
===Beam Cannons===
 
===Beam Cannons===
Line 25: Line 30:
  
 
===Core Table===
 
===Core Table===
 +
  
 
====$Name:====
 
====$Name:====
 
*This is the name of the weapon. If it's going to be used by the player, keep it under 12 characters so it doesn't spill over the HUD box. If the weapon has an @ symbol in front of it, it means it's allowed in the demo. It doesn't really do anything in the retail version.
 
*This is the name of the weapon. If it's going to be used by the player, keep it under 12 characters so it doesn't spill over the HUD box. If the weapon has an @ symbol in front of it, it means it's allowed in the demo. It doesn't really do anything in the retail version.
*Syntax: ''Name''
+
*Syntax: '''''String'''''
 +
 
  
 
====$Subtype:====
 
====$Subtype:====
 
{{Table36| }}
 
{{Table36| }}
 +
  
 
====+Title:====
 
====+Title:====
*This is the title of the weapon in the Weapons loadout screen. Only needed for player allowed weapons. Title may be anything.
+
*This is the title of the weapon in the Weapons loadout screen. Only needed for player allowed weapons. Title may be anything. Numerical value is a reference to translations in [[Tstrings.tbl]]
*Syntax: XSTR(''"Title"'', -1)
+
*Syntax: XSTR('''''"String"''''', -1)
 +
 
  
 
====+Description:====
 
====+Description:====
*This is the description you see in the weapons loadout screen. Again, these aren't based on any hard numbers, just approximations. Only needed for player allowed weapons.
+
*This is the description you see in the weapons loadout screen. Again, these aren't based on any hard numbers, just approximations. Only needed for player allowed weapons. Numerical value is a reference to translations in [[Tstrings.tbl]]
 +
 
 +
=====Example=====
 +
 
 +
<pre>
 +
XSTR(
 +
"''Standard Issue
 +
''Level 3 Hull Damage
 +
''Level 2 Shield Damage''", -1)
 +
$end_multi_text
 +
</pre>
  
  XSTR(
 
  "''Standard Issue
 
  ''Level 3 Hull Damage
 
  ''Level 2 Shield Damage''", -1)
 
  $end_multi_text
 
  
 
====+Tech Title:====
 
====+Tech Title:====
 
*Title of the weapon in the Tech room. Only needed for player allowed weapons.
 
*Title of the weapon in the Tech room. Only needed for player allowed weapons.
*Syntax: XSTR(''"Title"'', -1)
+
*Syntax: XSTR('''''"String"''''', -1)
 +
 
  
 
====+Tech Anim:====
 
====+Tech Anim:====
 
*Animation used for the weapon in the Tech room. Only needed for player allowed weapons.
 
*Animation used for the weapon in the Tech room. Only needed for player allowed weapons.
*Syntax: ''Filename''
+
*Syntax: '''''String''''', animation filename
 
**Example: ''Tech_Subach_HL-7''
 
**Example: ''Tech_Subach_HL-7''
 +
  
 
====+Tech Description:====
 
====+Tech Description:====
*Descriptive text you see in the tech room. Only needed for player allowed weapons.
+
*Descriptive text you see in the tech room. Only needed for player allowed weapons. Numerical value is a reference to translations in [[Tstrings.tbl]]
  
  XSTR(
+
<pre>
  "''The Subach-Innes HL-7...''", 3245)
+
XSTR(
  $end_multi_text
+
"''The Subach-Innes HL-7...''", 3245)
 +
$end_multi_text
 +
</pre>
  
  
Line 66: Line 84:
 
{{Table36|
 
{{Table36|
 
*Defines model used in wing loadout screen and in Tech Room for the weapon.
 
*Defines model used in wing loadout screen and in Tech Room for the weapon.
*Syntax: ''Filename.pof''}}
+
*Syntax: '''''String.pof''''', model filename}}
  
  
Line 72: Line 90:
 
{{Table36|
 
{{Table36|
 
*Defines the picture used to represent the weapon in HUD loadout list
 
*Defines the picture used to represent the weapon in HUD loadout list
*Syntax: ???}}
+
*Syntax: '''''String''''', filename}}
  
  
Line 79: Line 97:
 
*Standard primaries and beam cannons do not use specific models so for those the name is 'none'.
 
*Standard primaries and beam cannons do not use specific models so for those the name is 'none'.
 
*Flak weapons and secondaries use models, though the exact model is not important with the flak weapons.
 
*Flak weapons and secondaries use models, though the exact model is not important with the flak weapons.
*Syntax: ''Filename.pof'' or ''none''
+
*Syntax: '''''String.pof''''' or ''none'', model filename
 
**Example: ''none''
 
**Example: ''none''
 +
  
 
====$POF target LOD:====
 
====$POF target LOD:====
 
{{Table36|
 
{{Table36|
 
*Defines the LOD (Level-Of-Detail) of the model used in HUD targetting view
 
*Defines the LOD (Level-Of-Detail) of the model used in HUD targetting view
*Syntax: ''Value''}}
+
*Syntax: '''''Integer'''''}}
  
  
Line 91: Line 110:
 
{{Table36|
 
{{Table36|
 
*Defines the models shown on the gunpoint, used with Bobb's external-visible-weapon code.
 
*Defines the models shown on the gunpoint, used with Bobb's external-visible-weapon code.
*Syntax: ''Filename.pof''}}
+
*Syntax: '''''String.pof''''', model filename}}
  
  
 
====$Submodel Rotation Speed:====
 
====$Submodel Rotation Speed:====
{{Table36| }}
+
{{Table36|  
 +
*Defines the rotation speed of the external weapon model
 +
*Syntax: '''''Float'''''}}
  
  
 
====$Submodel Rotation Acceleration:====
 
====$Submodel Rotation Acceleration:====
{{Table36| }}
+
{{Table36|  
 +
*Defines the rotation acceleration of the external weapon model
 +
*Syntax: '''''Float'''''}}
  
  
 
====@Laser Bitmap:====
 
====@Laser Bitmap:====
 
**The graphic file to be used as the weapon effect if no model is defined.
 
**The graphic file to be used as the weapon effect if no model is defined.
**Syntax: ''Filename''
+
**Syntax: '''''String''''', filename
 +
 
  
 
====@Laser Glow:====
 
====@Laser Glow:====
 
**The graphic file that determines the glow of the weapon effect if no model is defined
 
**The graphic file that determines the glow of the weapon effect if no model is defined
**Syntax: ''Filename''
+
**Syntax: '''''String''''', filename
 +
 
  
 
====@Laser Color:====
 
====@Laser Color:====
 
**The color of the weapon effect when you fire it.
 
**The color of the weapon effect when you fire it.
**Syntax: ''Value, Value, Value'' (Red, Green, Blue respectively, value from 0 to 255)
+
**Syntax: '''''Color''''', red, green, blue respectively, value from 0 to 255
 
***Example: ''250, 0, 0''
 
***Example: ''250, 0, 0''
 +
  
 
====@Laser Color2:====
 
====@Laser Color2:====
 
**The color of the weapon effect at its maximum range.
 
**The color of the weapon effect at its maximum range.
**Syntax: ''Value, Value, Value'' (Red, Green, Blue respectively, value from 0 to 255)
+
**Syntax: '''''Color''''', red, green, blue respectively, value from 0 to 255
 
***Example: ''0, 0, 250''
 
***Example: ''0, 0, 250''
 +
  
 
====@Laser Length:====
 
====@Laser Length:====
 
**Length of the weapon effect.
 
**Length of the weapon effect.
**Syntax: ''Value'', (1/10 of a meters)
+
**Syntax: '''''Float''''', meters
 +
 
  
 
====@Laser Head Radius:====
 
====@Laser Head Radius:====
 
**Width of the head of the weapon effect.
 
**Width of the head of the weapon effect.
**Syntax: ''Value'', (meters ?)
+
**Syntax: '''''Float''''', meters
 +
 
  
 
====@Laser Tail Radius:====
 
====@Laser Tail Radius:====
 
**Width of the tail of the weapon effect.
 
**Width of the tail of the weapon effect.
**Syntax: ''Value'' (meters ?)
+
**Syntax: '''''Float''''', meters
 +
 
  
 
====$Mass:====
 
====$Mass:====
 
*How much of a kinetic effect this weapon has on its target. 3+ gives you the Flail effect. Set it to 10 and you can knock cruisers around.
 
*How much of a kinetic effect this weapon has on its target. 3+ gives you the Flail effect. Set it to 10 and you can knock cruisers around.
*This is somehow multiplied by the speed. ie ''$Mass: 3'' and ''$Velocity: 200'' has much weaker kinetic effect than ''$Mass: 3'' and ''$Velocity: 1000''. Also $Mass is used to calculate intencity of "shudder" effect if flagged.
+
*This is somehow multiplied by the speed. ie ''$Mass: 3'' and ''$Velocity: 200'' has much weaker kinetic effect than ''$Mass: 3'' and ''$Velocity: 1000''. Also $Mass is used to calculate intensity of "shudder" effect if flagged.
*Syntax: ''Value'', (blast effect)
+
*Syntax: '''''Float''''', blast effect
 +
 
  
 
====$Velocity:====
 
====$Velocity:====
 
*How fast the weapon travels. Is also used to define the weapon range, '''''$Velocity x $Lifetime = range'''''.
 
*How fast the weapon travels. Is also used to define the weapon range, '''''$Velocity x $Lifetime = range'''''.
 
*Beams travel instantly so this field has effect only on weapon range and AI beam targetting with certain beam types. $Velocity of beam also applies to its kinetic effect along with $Mass.
 
*Beams travel instantly so this field has effect only on weapon range and AI beam targetting with certain beam types. $Velocity of beam also applies to its kinetic effect along with $Mass.
*Syntax: ''Value'', (meters per second)
+
*Syntax: '''''Float''''', meters per second
 +
 
  
 
====$Fire Wait:====
 
====$Fire Wait:====
 
*Time in seconds between firings
 
*Time in seconds between firings
*Syntax: ''Value'', (seconds)
+
*Syntax: '''''Float''''', seconds
 +
 
  
 
====$Damage:====
 
====$Damage:====
 
*Base damage this weapon does. The actual damage is this number multiplied by the factors below.
 
*Base damage this weapon does. The actual damage is this number multiplied by the factors below.
*Base damage this beam does is continous damage, damage is 5.5 times the damage value per second. The actual damage is this number multiplied by one of the factors below.
+
*Base damage this beam does is continuous damage, damage is 5.5 times the damage value per second. The actual damage is this number multiplied by one of the factors below.
*Syntax: ''Value'', (damage value)
+
*Syntax: '''''Float''''', damage
  
  
Line 155: Line 188:
 
{{Table36|
 
{{Table36|
 
*Defines the damage type that this weapon uses. All armor effects are applied after shield and have no function against shockwave or subsystem damage. '''REQUIRES ADDITIONAL TABLE'''.
 
*Defines the damage type that this weapon uses. All armor effects are applied after shield and have no function against shockwave or subsystem damage. '''REQUIRES ADDITIONAL TABLE'''.
*Syntax: ''Name'', of the damage type as defined in armor.tbl}}
+
*Syntax: '''''String''''', name of the damage type as defined in [[armor.tbl]]}}
  
  
Line 162: Line 195:
 
*Defines the time after the launch that is required before the weapon comes hot
 
*Defines the time after the launch that is required before the weapon comes hot
 
*If the time has not been reached when the weapon detonates the Dinky explosion is used
 
*If the time has not been reached when the weapon detonates the Dinky explosion is used
*Syntax: ''Value'', (seconds)}}
+
*Syntax: '''''Float''''', seconds}}
  
  
Line 169: Line 202:
 
*Defines the distance from the firing ships that is required before the weapon comes hot
 
*Defines the distance from the firing ships that is required before the weapon comes hot
 
*If the distance has not been reached when the weapon detonates the Dinky explosion is used
 
*If the distance has not been reached when the weapon detonates the Dinky explosion is used
*Syntax: ''Value'', (meters)}}
+
*Syntax: '''''Float''''', meters}}
  
  
Line 175: Line 208:
 
{{Table36|
 
{{Table36|
 
*Defines the distance from the target where the weapon will arm itself
 
*Defines the distance from the target where the weapon will arm itself
*Syntax: ''Value'', (meters)}}
+
*Syntax: '''''Float''''', meters}}
  
  
Line 181: Line 214:
 
{{Table36|
 
{{Table36|
 
*Defines the distance from the point in space that the weapon was launched where the weapon will detonate
 
*Defines the distance from the point in space that the weapon was launched where the weapon will detonate
*Syntax: ''Value'', (meters)}}
+
*Syntax: '''''Float''''', meters}}
 +
 
 +
 
 +
====$Detonation Radius:====
 +
{{Table37|
 +
*Defines the distance between the target center point point and the weapon which detonates the weapon.
 +
*Syntax: '''''Float''''', meters}}
  
  
Line 187: Line 226:
 
{{Table36|
 
{{Table36|
 
*Override for the damage caused by shockwaves
 
*Override for the damage caused by shockwaves
*Syntax: ''Value'', (damage value)}}
+
*Syntax: '''''Float''''', damage}}
  
  
Line 193: Line 232:
 
{{Table36|
 
{{Table36|
 
*'''REQUIRES ADDITIONAL TABLE'''. Defines the damage type used for the weapon explosions
 
*'''REQUIRES ADDITIONAL TABLE'''. Defines the damage type used for the weapon explosions
*Syntax: ''Name'', as defined in armor.tbl}}
+
*Syntax: '''''String''''', name as defined in [[armor.tbl]]}}
  
  
 
====$Blast Force:====
 
====$Blast Force:====
 
*The intensity of the blast effect when ship is within the outer radius of the explosion. Comes in effect only if inner and outer radius are defined.
 
*The intensity of the blast effect when ship is within the outer radius of the explosion. Comes in effect only if inner and outer radius are defined.
*Syntax: ''Value'', (blast effect)
+
*Syntax: '''''Float''''', blast effect
 +
 
  
 
====$Inner Radius:====
 
====$Inner Radius:====
 
*Radius at which the full explosion damage is done. Marks the line where damage attenuation begins.
 
*Radius at which the full explosion damage is done. Marks the line where damage attenuation begins.
*Syntax: ''Value'', (meters)
+
*Syntax: '''''Float''''', meters
 +
 
  
 
====$Outer Radius:====
 
====$Outer Radius:====
 
*Maximum radius at which any damage is done
 
*Maximum radius at which any damage is done
*Syntax: ''Value'', (meters)
+
*Syntax: '''''Float''''', meters
  
  
 
====$Shockwave Speed:====
 
====$Shockwave Speed:====
 
*Speed shockwave expands at. Zero means no shockwave and that damage is applied immediately
 
*Speed shockwave expands at. Zero means no shockwave and that damage is applied immediately
*Syntax: ''Value'', (meters per second)
+
*Syntax: '''''Float''''', meters per second
  
  
 
====$Shockwave rotation:====
 
====$Shockwave rotation:====
 
{{Table36|
 
{{Table36|
*Defines how the shockwave is rotated.
+
*Defines how the 3D shockwave is rotated.
*Syntax:}}
+
*Syntax: '''''Angle''''', three values, pitch, bank, heading respectively, in degrees}}
  
  
 
====$Shockwave model:====
 
====$Shockwave model:====
 
{{Table36|
 
{{Table36|
*Defines the model file (.pof) used as a shockwave for 3D shockwaves.
+
*Defines the model file (.pof) used as a shockwave for the 3D shockwaves.
*Implemented before FS_Open 3.6.5
+
*Syntax: '''''String.pof''''', model filename}}
*Syntax: ''Name.pof''}}
 
  
  
 
====$Shockwave name:====
 
====$Shockwave name:====
 
{{Table36|
 
{{Table36|
*Defines the name of the animation used for the shockwave
+
*Defines the name of the animation used for the 2D shockwave
*Syntax: ''Name''}}
+
*Syntax: '''''String''''', filename}}
  
  
 
====$Dinky shockwave:====
 
====$Dinky shockwave:====
 
{{Table36|
 
{{Table36|
*Dinky shockwave are used if the weapon is shot down or if the conditions marked at Arm time and Arm distance are not reached
+
*Dinky shockwave are used if the weapon is shot down before arming or if the conditions marked at '''Arm time''' and '''Arm distance''' are not reached before impact
 
*It uses exactly same entries as the standard shockwaves
 
*It uses exactly same entries as the standard shockwaves
*'''+Shockwave damage:'''
+
*'''''+Shockwave damage:'''''
*'''+Shockwave damage type:'''
+
*'''''+Shockwave damage type:'''''
*'''+Blast Force:'''
+
*'''''+Blast Force:'''''
*'''+Inner Radius:'''
+
*'''''+Inner Radius:'''''
*'''+Outer Radius:'''
+
*'''''+Outer Radius:'''''
*'''+Shockwave Speed:'''
+
*'''''+Shockwave Speed:'''''
*'''+Shockwave Rotation:'''
+
*'''''+Shockwave Rotation:'''''
*'''+Shockwave Model:'''
+
*'''''+Shockwave Model:'''''
*'''+Shockwave Name:'''}}
+
*'''''+Shockwave Name:'''''}}
  
  
 
====$Armor Factor:====
 
====$Armor Factor:====
 
*Multiplier for the damage done to armor
 
*Multiplier for the damage done to armor
*Syntax: ''Value'', (damage multiplier)
+
*Syntax: '''''Float''''', damage multiplier
 +
 
  
 
====$Shield Factor:====
 
====$Shield Factor:====
 
*Multiplier for the damage done to shields
 
*Multiplier for the damage done to shields
*Syntax: ''Value'', (damage multiplier)
+
*Syntax: '''''Float''''', damage multiplier
 +
 
  
 
====$Subsystem Factor:====
 
====$Subsystem Factor:====
 
*Multiplier for the damage done to subsystems
 
*Multiplier for the damage done to subsystems
*Syntax: ''Value'', (damage multiplier)
+
*Syntax: '''''Float''''', damage multiplier
  
  
 
====$Lifetime Min:====
 
====$Lifetime Min:====
 
{{Table36|
 
{{Table36|
*Defines the minimum lifetime of the weapon (countermeasure)
+
*Defines the minimum lifetime of the weapon
*Syntax: ''Value'', (seconds)}}
+
*Syntax: '''''Float''''', seconds}}
  
  
 
====$Lifetime Max:====
 
====$Lifetime Max:====
 
{{Table36|
 
{{Table36|
*Defines the maximum lifetime of the weapon (countermeasure)
+
*Defines the maximum lifetime of the weapon
*Syntax: ''Value'', (seconds)}}
+
*Syntax: '''''Float''''', seconds}}
  
  
 
====$Lifetime:====
 
====$Lifetime:====
 
*Time before the standard primaries fizzle out and secondaries self destruct. Multiply this by the speed to get the range. If values are too low (below framerate) then the collision detection and graphic effects may suffer.
 
*Time before the standard primaries fizzle out and secondaries self destruct. Multiply this by the speed to get the range. If values are too low (below framerate) then the collision detection and graphic effects may suffer.
*This field has no effect for the beams apart from weapon range and AI beam targetting with certain beam types
+
*This field has no effect for the beams apart from weapon range and AI beam targeting with certain beam types
*Syntax: ''Value'', (seconds)
+
*Syntax: '''''Float''''', seconds
 +
 
  
 
====$Energy Consumed:====
 
====$Energy Consumed:====
 
*The amount of energy each bolt drains firing ship. Has no effect on turretted weapons.
 
*The amount of energy each bolt drains firing ship. Has no effect on turretted weapons.
*Syntax: ''Value''
+
*Syntax: '''''Float'''''
 +
 
  
 
====$Cargo Size:====
 
====$Cargo Size:====
 
*Cargo size, is not used with primaries.
 
*Cargo size, is not used with primaries.
 
*Amount of missiles available = Bank capacity / Cargo Size.
 
*Amount of missiles available = Bank capacity / Cargo Size.
*Syntax: ''Value''
+
*Syntax: '''''Float'''''
 +
 
  
 
====$Homing:====
 
====$Homing:====
 
*Only for secondaries. You can't have homing primaries. If this is set to YES with primaries, then the bolts turn to face their target but keep moving in the same direction. If the field is set to NO then following fields are not required in the table.
 
*Only for secondaries. You can't have homing primaries. If this is set to YES with primaries, then the bolts turn to face their target but keep moving in the same direction. If the field is set to NO then following fields are not required in the table.
 
*Defines if the missiles in question is homing
 
*Defines if the missiles in question is homing
*Syntax: ''YES'' or ''NO''
+
*Syntax: '''''Boolean''''', yes or no
 
*'''+Type:'''
 
*'''+Type:'''
 
**Defines the homing method
 
**Defines the homing method
**Syntax: ''ASPECT'' or ''HEAT''
+
**Syntax: '''''String''''', ''ASPECT'' or ''HEAT''
 
*'''+Turn Time:'''
 
*'''+Turn Time:'''
**Defines how well missile manouvers. Number of seconds it takes the missile to do a 360 degree circle
+
**Defines how well missile maneuvers. Number of seconds it takes the missile to do a 360 degree circle
**Syntax: ''Value'', (seconds)
+
**Syntax: '''''Float''''', seconds
 
*'''+View Cone:'''
 
*'''+View Cone:'''
 
**'''Heat-seeking missiles only''', this is then number of degrees the missile sees. Value / 2 gives the angle from the missiles centerline.  
 
**'''Heat-seeking missiles only''', this is then number of degrees the missile sees. Value / 2 gives the angle from the missiles centerline.  
**Syntax: ''Value'', (degrees)
+
**Syntax: '''''Float''''', degrees
{{Table36| Has been enabled also to aspect seekers.}}
+
{{Table36| Has been enabled also to aspect seekers as an option.}}
 +
 
 
*'''+Min Lock Time:'''
 
*'''+Min Lock Time:'''
 
**'''For aspect missiles only''', the minimum number of seconds to gain target lock
 
**'''For aspect missiles only''', the minimum number of seconds to gain target lock
**Syntax: ''Value'', (seconds)
+
**Syntax: '''''Float''''', seconds
 
*'''+Lock Pixels/Sec:'''
 
*'''+Lock Pixels/Sec:'''
 
**'''For aspect missiles only''', pixels the aspect triangle moves per second while attempting lock-on
 
**'''For aspect missiles only''', pixels the aspect triangle moves per second while attempting lock-on
**Syntax: ''Value'', (pixels per second)
+
**Syntax: '''''Integer''''', pixels per second
 
*'''+Catch-up Pixels/Sec:'''
 
*'''+Catch-up Pixels/Sec:'''
 
**'''For aspect missiles only''', pixels moved per second while attempting to catch up to the target
 
**'''For aspect missiles only''', pixels moved per second while attempting to catch up to the target
**Syntax: ''Value'', (pixels per second)
+
**Syntax: '''''Integer''''', pixels per second
 
*'''+Catch-up Penalty:'''
 
*'''+Catch-up Penalty:'''
 
**'''For aspect missiles only''', extra pixels to move after catching up ????
 
**'''For aspect missiles only''', extra pixels to move after catching up ????
**Syntax: ''Value'', (pixels)
+
**Syntax: '''''Integer''''', pixels
 
{{Table36|
 
{{Table36|
 
*'''+Seeker Strength:'''
 
*'''+Seeker Strength:'''
 
**Defines the seeking ability of the homing system. Default of heat seekers is 3 and for aspect seekers 2. Spoofing change is defined as '''cm type effectiveness'''/'''seeker strength'''.
 
**Defines the seeking ability of the homing system. Default of heat seekers is 3 and for aspect seekers 2. Spoofing change is defined as '''cm type effectiveness'''/'''seeker strength'''.
**Syntax: ''Value'', (seeker strength)}}
+
**Syntax: '''''Float''''', seeker strength}}
  
  
 
====$Swarm:====
 
====$Swarm:====
 
*The number of missiles to fire per volley if it's a swarm missile
 
*The number of missiles to fire per volley if it's a swarm missile
*Can be issued to Standard primaries also. Causes singlepart turrets to malfunction but causes multipart turrets to fire only on their barrel line. Can be used for 'burst fire weapons'.
+
*Can be issued to Standard primaries also. Causes single part turrets to malfunction but causes multi part turrets to fire only on their barrel line. Can be used for 'burst fire weapons'.
 
*Is incompatible with "Corkscrew" option.
 
*Is incompatible with "Corkscrew" option.
*Syntax: ''Value''
+
*Syntax: '''''Integer''''', number of shots in a swarm
 
{{Table36|
 
{{Table36|
 
*'''+SwarmWait:'''
 
*'''+SwarmWait:'''
**Implemented before FS_Open 3.6.5
 
 
**Defines the time between weapons fired in a swarm
 
**Defines the time between weapons fired in a swarm
**Syntax: ''Value'', (seconds)
+
**Syntax: '''''Float''''', seconds
 
***Default: 0.150}}
 
***Default: 0.150}}
  
Line 335: Line 380:
 
{{Table36|
 
{{Table36|
 
*Defines the free flight time of homing weapons. During this time weapon flies at 1/4 of its velocity + firing ships velocity in a straight line.
 
*Defines the free flight time of homing weapons. During this time weapon flies at 1/4 of its velocity + firing ships velocity in a straight line.
*Syntax: ''Value'', (seconds)
+
*Syntax: '''''Float''''', seconds
 
**Default: 0.25}}
 
**Default: 0.25}}
  
Line 341: Line 386:
 
====$LaunchSnd:====
 
====$LaunchSnd:====
 
*Corresponding sound effect when the weapon is launched.
 
*Corresponding sound effect when the weapon is launched.
*Syntax: ''Value'', name or identification number of the sound as defined in sounds.tbl
+
*Syntax: '''''Integer''''' or '''''String''''', name or identification number of the sound as defined in [[sounds.tbl]]
 +
 
  
 
====$ImpactSnd:====
 
====$ImpactSnd:====
 
*Sound the weapon makes when it hits a hull.
 
*Sound the weapon makes when it hits a hull.
*Syntax: ''Value'', name or identification number of the sound as defined in sounds.tbl
+
*Syntax: '''''Integer''''' or '''''String''''', name or identification number of the sound as defined in [[sounds.tbl]]
  
  
Line 351: Line 397:
 
{{Table36|
 
{{Table36|
 
*Sound the weapon makes when it hits a hull before being armed.
 
*Sound the weapon makes when it hits a hull before being armed.
*Syntax: ''Value'', identification number of the sound as defined in sounds.tbl}}
+
*Syntax: '''''Integer''''' or '''''String''''', name or identification number of the sound as defined in [[sounds.tbl]]}}
  
  
 
====$FlyBySnd:====
 
====$FlyBySnd:====
 
*The sound this weapon makes if it narrowly misses you. -1 is no sound.
 
*The sound this weapon makes if it narrowly misses you. -1 is no sound.
*Syntax: ''Value'', name or identification number of the sound as defined in sounds.tbl, usually -1
+
*Syntax: '''''Integer''''' or '''''String''''', name or identification number of the sound as defined in [[sounds.tbl]], usually -1
  
  
Line 362: Line 408:
 
{{Table36|
 
{{Table36|
 
*Defines used model file. Included for compatibility with countermeasures as they have been merged with weapons in the code.  
 
*Defines used model file. Included for compatibility with countermeasures as they have been merged with weapons in the code.  
*Syntax: ''Filename.pof''}}
+
*Syntax: '''''String.pof''''', model filename}}
  
  
 
====$Rearm Rate:====
 
====$Rearm Rate:====
 
*Defines the rate the weapons are loaded to the ship
 
*Defines the rate the weapons are loaded to the ship
*Syntax: ''Value'', (missiles per s)
+
*Syntax: '''''Float''''', missiles loaded per second
 +
 
  
 
====+Weapon Range:====
 
====+Weapon Range:====
*Defines the range to the target where the weapons under AI will start firing.??
+
*Defines the range to the target where the weapons under AI will start firing.
*Syntax: ''Value'', (meters)
+
*Syntax: '''''Float''''', meters
  
  
Line 378: Line 425:
 
*Defines the minimum range to the target where the weapons under AI will still fire.
 
*Defines the minimum range to the target where the weapons under AI will still fire.
 
*Implemented before FS_Open 3.6.5
 
*Implemented before FS_Open 3.6.5
*Syntax: ''Value'', (meters)}}
+
*Syntax: '''''Float''''', meters}}
  
  
 
====$Flags:====
 
====$Flags:====
 
*Flags are detailed below, in [[weapons.tbl#Weapon_Flags|weapon flags section]].
 
*Flags are detailed below, in [[weapons.tbl#Weapon_Flags|weapon flags section]].
 +
  
 
====$Trail:====
 
====$Trail:====
Line 404: Line 452:
 
**The graphic file to use for the trail.
 
**The graphic file to use for the trail.
 
**Syntax: ''Filename''
 
**Syntax: ''Filename''
 +
  
 
====$Icon:====
 
====$Icon:====
 
*Loadout icon used in the weapons selection screen.
 
*Loadout icon used in the weapons selection screen.
 
*Syntax: ''Filename''
 
*Syntax: ''Filename''
 +
  
 
====$Anim:====
 
====$Anim:====
Line 437: Line 487:
 
*Impact explosion used. Must be defined in weapon_expl.tbl,
 
*Impact explosion used. Must be defined in weapon_expl.tbl,
 
*Syntax: ''Filename'' or ''none''
 
*Syntax: ''Filename'' or ''none''
 +
  
 
====$Impact Explosion Radius:====
 
====$Impact Explosion Radius:====
Line 457: Line 508:
 
*Defines the muzzle flash the weapon uses
 
*Defines the muzzle flash the weapon uses
 
*Syntax: ''Muzzleflash name'', as defined in mflash.tbl
 
*Syntax: ''Muzzleflash name'', as defined in mflash.tbl
 +
  
 
====$EMP Intensity:====
 
====$EMP Intensity:====
 
**If it has an EMP effect, how deeply it scrambles your electronics
 
**If it has an EMP effect, how deeply it scrambles your electronics
 
**Syntax: ''Value''
 
**Syntax: ''Value''
 +
  
 
====$EMP Time:====
 
====$EMP Time:====
Line 469: Line 522:
 
**The amount of weapon energy to drain with each hit
 
**The amount of weapon energy to drain with each hit
 
**Syntax: ''Value''
 
**Syntax: ''Value''
 +
  
 
====$Leech Afterburner:====
 
====$Leech Afterburner:====
 
**The amount of afterburner fuel to drain with each hit
 
**The amount of afterburner fuel to drain with each hit
 
**Syntax: ''Value''
 
**Syntax: ''Value''
 +
  
 
====$Corkscrew:====
 
====$Corkscrew:====
Line 702: Line 757:
 
*TAG Level 3 has no effect in retail.
 
*TAG Level 3 has no effect in retail.
 
*Syntax: ''TAG level'' ''Value'', (seconds)
 
*Syntax: ''TAG level'' ''Value'', (seconds)
 +
  
 
====$SSM:====
 
====$SSM:====
Line 754: Line 810:
  
 
==Weapon Flags==
 
==Weapon Flags==
 +
  
 
==="Electronics"===
 
==="Electronics"===
 
*Will seize up the weapons and engines systems of any ship for a short period of time.
 
*Will seize up the weapons and engines systems of any ship for a short period of time.
 +
  
 
==="Spawn ''Name'',''Value''"===
 
==="Spawn ''Name'',''Value''"===
 
*Will spawn the specified number of defined missiles upon detonation.
 
*Will spawn the specified number of defined missiles upon detonation.
 +
  
 
==="Remote Detonate"===
 
==="Remote Detonate"===
 
*Can be triggered remotely via a second press on the trigger
 
*Can be triggered remotely via a second press on the trigger
 +
  
 
==="Puncture"===
 
==="Puncture"===
 
*Reduces hull damage by 25%
 
*Reduces hull damage by 25%
 +
  
 
==="Big Ship"===
 
==="Big Ship"===
 
*These weapons cannot be mounted on small ships like fighters, bombers, sentry guns etc.
 
*These weapons cannot be mounted on small ships like fighters, bombers, sentry guns etc.
 +
  
 
==="Huge"===
 
==="Huge"===
 
*Allows this weapon to do the final 10% damage to a ship with the "Big Damage" flag.
 
*Allows this weapon to do the final 10% damage to a ship with the "Big Damage" flag.
 +
  
 
==="Supercap"===
 
==="Supercap"===
 
*Allows this weapon to do the final 75% damage to a ship with the "supercap" flag.
 
*Allows this weapon to do the final 75% damage to a ship with the "supercap" flag.
 +
  
 
==="Bomber+"===
 
==="Bomber+"===
 
*The AI will prefer to use this weapon against bombers
 
*The AI will prefer to use this weapon against bombers
 +
  
 
==="child"===
 
==="child"===
 
*Cannot be set as a weapon on any ship, but is instead a child of a weapon. Usually defined with "Spawn ''Name'',''Value''"
 
*Cannot be set as a weapon on any ship, but is instead a child of a weapon. Usually defined with "Spawn ''Name'',''Value''"
 +
  
 
==="Bomb"===
 
==="Bomb"===
 
*Makes this weapon targetable with the B key, and the AI prefers to use it against large ships
 
*Makes this weapon targetable with the B key, and the AI prefers to use it against large ships
 +
  
 
==="No Dumbfire"===
 
==="No Dumbfire"===
 
*Missile will not fire without a lock
 
*Missile will not fire without a lock
 +
  
 
==="in tech database"===
 
==="in tech database"===
 
*Has the weapon in the tech database at the start of the campaign
 
*Has the weapon in the tech database at the start of the campaign
 +
  
 
==="Player allowed"===
 
==="Player allowed"===
Line 810: Line 879:
 
*This weapon will have an EMP effect on any ship within the blast radius
 
*This weapon will have an EMP effect on any ship within the blast radius
 
*Can be defined with [[Weapons.tbl#$EMP_Intensity:|EMP Intensity]] and [[Weapons.tbl#$EMP_Time:|EMP Time]]
 
*Can be defined with [[Weapons.tbl#$EMP_Intensity:|EMP Intensity]] and [[Weapons.tbl#$EMP_Time:|EMP Time]]
 +
  
 
==="Esuck"===
 
==="Esuck"===
 
*Drains the target's energy banks
 
*Drains the target's energy banks
 
*Can be defined with [[Weapons.tbl#$Leech_Weapon:|Leech Weapon]] and [[Weapons.tbl#$Leech_Afterburner:|Leech Afterburner]]
 
*Can be defined with [[Weapons.tbl#$Leech_Weapon:|Leech Weapon]] and [[Weapons.tbl#$Leech_Afterburner:|Leech Afterburner]]
 +
  
 
==="Flak"===
 
==="Flak"===
*Makes this weapon a [[weapons.tbl#Flak Guns|flak gun]]
+
*Makes this weapon a [[weapons.tbl#Flak_Guns|flak gun]]
 +
 
  
 
==="Corkscrew"===
 
==="Corkscrew"===
Line 826: Line 898:
 
==="Shudder"===
 
==="Shudder"===
 
*Makes your ship shudder while you're firing the weapon
 
*Makes your ship shudder while you're firing the weapon
 +
  
 
==="lockarm"===
 
==="lockarm"===
 
*Requires a target lock in order to arm its warhead. In other words weapon causes less damage if it hits the target without target lock.
 
*Requires a target lock in order to arm its warhead. In other words weapon causes less damage if it hits the target without target lock.
 +
  
 
==="beam"===
 
==="beam"===
 
*Makes this weapon a [[weapons.tbl#Beam Cannons|beam cannon]]
 
*Makes this weapon a [[weapons.tbl#Beam Cannons|beam cannon]]
 +
  
 
==="stream"===
 
==="stream"===
 
*Gives this weapon a streaming effect. In effect weapon keeps firing when firing button is kept pressed.
 
*Gives this weapon a streaming effect. In effect weapon keeps firing when firing button is kept pressed.
 +
  
 
==="puncture"===
 
==="puncture"===
 
*Reduces hull damage by 25%
 
*Reduces hull damage by 25%
 +
  
 
==="supercap"===
 
==="supercap"===
 
*Makes weapon capable of causing real damage against ships with "supercap" flag.
 
*Makes weapon capable of causing real damage against ships with "supercap" flag.
 +
  
 
==="countermeasure"===
 
==="countermeasure"===
Line 895: Line 973:
 
{{Table36|
 
{{Table36|
 
*Prevents light from being applied to the weapon model.}}
 
*Prevents light from being applied to the weapon model.}}
 +
 +
 +
==="inherit parent target"===
 +
{{Table37|
 +
*Sets spawned 'chield' weapons to use parent weapon's target-}}
 +
 +
 +
==="training"===
 +
{{Table37|
 +
*Sets weapon to be of training weapon type. ?}}
  
  
Line 906: Line 994:
 
*Name of the countermeasure
 
*Name of the countermeasure
 
*Syntax: ''Name'', usually Type One
 
*Syntax: ''Name'', usually Type One
 +
  
 
===$Velocity:===
 
===$Velocity:===
 
*Defines the spped of the countermeasure, relative to the ship.
 
*Defines the spped of the countermeasure, relative to the ship.
 
*Syntax: ''Value'', (meter per second)
 
*Syntax: ''Value'', (meter per second)
 +
  
 
===$Fire Wait:===
 
===$Fire Wait:===
 
*Definies the minumum time between the countermeasure launches
 
*Definies the minumum time between the countermeasure launches
 
*Syntax: ''Value'', (seconds)
 
*Syntax: ''Value'', (seconds)
 +
  
 
===Lifetime===
 
===Lifetime===
Line 921: Line 1,012:
 
*'''$Lifetime Max:'''
 
*'''$Lifetime Max:'''
 
**Syntax: ''Value'', (seconds)
 
**Syntax: ''Value'', (seconds)
 +
  
 
===$LaunchSnd:===
 
===$LaunchSnd:===
 
*Defines the sound for the countermeasure launch
 
*Defines the sound for the countermeasure launch
 
*Syntax: ''Value'', refers to sounds.tbl
 
*Syntax: ''Value'', refers to sounds.tbl
 +
  
 
===$Model:===
 
===$Model:===
 
*Defines the used model file (.pof)
 
*Defines the used model file (.pof)
 
*Syntax: ''Filename.pof'', usually cmeasure01.pof
 
*Syntax: ''Filename.pof'', usually cmeasure01.pof
 +
  
 
==Player Weapon Precedence==
 
==Player Weapon Precedence==
Line 935: Line 1,029:
 
*Example:
 
*Example:
  
  $Player Weapon Precedence: (
+
<pre>
        "UD-8 Kayser"
+
$Player Weapon Precedence: (
        "Prometheus R"
+
    "UD-8 Kayser"
        "Subach HL-7"
+
    "Prometheus R"
        "Harpoon"
+
    "Subach HL-7"
        "Tempest"
+
    "Harpoon"
        "Rockeye"  )
+
    "Tempest"
 +
    "Rockeye"  )
 +
</pre>
  
 
==Sample==
 
==Sample==
  
  #Primary Weapons
+
<pre>
  $Name:                            @Subach HL-7
+
#Primary Weapons
      +Title:                          XSTR("GTW Subach HL-7", 3243)
+
 
      +Description:
+
$Name:                            @Subach HL-7
  XSTR( "Standard Issue
+
  +Title:                          XSTR("GTW Subach HL-7", 3243)
  Level 3 Hull Damage
+
  +Description:
  Level 2 Shield Damage", 3244)
+
XSTR( "Standard Issue
  $end_multi_text
+
Level 3 Hull Damage
      +Tech Title:                      XSTR("Subach HL-7", 146)
+
Level 2 Shield Damage", 3244)
      +Tech Anim:                      Tech_Subach_HL-7
+
$end_multi_text
      +Tech Description:
+
  +Tech Title:                      XSTR("Subach HL-7", 146)
  XSTR(
+
  +Tech Anim:                      Tech_Subach_HL-7
  "Descriptive text...", -1)
+
  +Tech Description:
  $end_multi_text
+
XSTR(
  $Model File:                      none
+
"Descriptive text...", -1)
      @Laser Bitmap:                    newglo9
+
$end_multi_text
      @Laser Glow:                      2_laserglow03
+
$Model File:                      none
      @Laser Color:                    250, 0, 0
+
  @Laser Bitmap:                    newglo9
      @Laser Color2:                    0, 0, 250
+
  @Laser Glow:                      2_laserglow03
      @Laser Length:                    10.0
+
  @Laser Color:                    250, 0, 0
      @Laser Head Radius:              0.90
+
  @Laser Color2:                    0, 0, 250
      @Laser Tail Radius:              0.90
+
  @Laser Length:                    10.0
  $Mass:                            0.2
+
  @Laser Head Radius:              0.90
  $Velocity:                        450.0
+
  @Laser Tail Radius:              0.90
  $Fire Wait:                      0.2
+
$Mass:                            0.2
  $Damage:                          15
+
$Velocity:                        450.0
  $Armor Factor:                    0.9
+
$Fire Wait:                      0.2
  $Shield Factor:                  0.7
+
$Damage:                          15
  $Subsystem Factor:                0.3
+
$Armor Factor:                    0.9
  $Lifetime:                        2.0
+
$Shield Factor:                  0.7
  $Energy Consumed:                0.20
+
$Subsystem Factor:                0.3
  $Cargo Size:                       0.0
+
$Lifetime:                        2.0
  $Homing:                          NO
+
$Energy Consumed:                0.20
  $LaunchSnd:                      76
+
$Cargo Size:                     0.0
  $ImpactSnd:                      85
+
$Homing:                          NO
  $Flags:                          (  "in tech database"
+
$LaunchSnd:                      76
                                        "player allowed"
+
$ImpactSnd:                      85
                                        "stream")
+
$Flags:                          (  "in tech database"
  $Icon:                            iconSD4
+
                                    "player allowed"
  $Anim:                            SD4
+
                                    "stream")
  $Impact Explosion:                none
+
$Icon:                            iconSD4
  #End
+
$Anim:                            SD4
  #Secondary Weapons
+
$Impact Explosion:                none
  $Name:                            EMP Adv.
+
 
      +Title:                          XSTR("GTM-14 EMP Adv.", 3396)
+
#End
      +Description:
+
 
  XSTR( "Advanced Missile
+
 
  Electromagnetic Pulse Weapon
+
#Secondary Weapons
  General Purpose Suppression", 3397)
+
 
  $end_multi_text
+
$Name:                            EMP Adv.
      +Tech Title:                      XSTR("GTM-14 EM Pulse Adv.", 3398)
+
  +Title:                          XSTR("GTM-14 EMP Adv.", 3396)
      +Tech Anim:                      Tech_EMP
+
  +Description:
      +Tech Description:
+
XSTR( "Advanced Missile
  XSTR(
+
Electromagnetic Pulse Weapon
  "Descriptive text...", -1)
+
General Purpose Suppression", 3397)
  $end_multi_text
+
$end_multi_text
  $Model File:                      EMPulse2.pof
+
  +Tech Title:                      XSTR("GTM-14 EM Pulse Adv.", 3398)
  $Mass:                            15.0
+
  +Tech Anim:                      Tech_EMP
  $Velocity:                        275.0
+
  +Tech Description:
  $Fire Wait:                      2.0
+
XSTR(
  $Damage:                          45
+
"Descriptive text...", -1)
  $Blast Force:                    20.0
+
$end_multi_text
  $Inner Radius:                    80.0
+
$Model File:                      EMPulse2.pof
  $Outer Radius:                    300.0
+
$Mass:                            15.0
  $Shockwave Speed:                120.0
+
$Velocity:                        275.0
  $Armor Factor:                    1.0
+
$Fire Wait:                      2.0
  $Shield Factor:                  0.8
+
$Damage:                          45
  $Subsystem Factor:                0.5
+
$Blast Force:                    20.0
  $Lifetime:                        5.0
+
$Inner Radius:                    80.0
  $Energy Consumed:                0.0
+
$Outer Radius:                    300.0
  $Cargo Size:                      4.0
+
$Shockwave Speed:                120.0
  $Homing:                          YES
+
$Armor Factor:                    1.0
      +Type:                            ASPECT
+
$Shield Factor:                  0.8
      +Turn Time:                      1.0
+
$Subsystem Factor:                0.5
      +Min Lock Time:                  2.0
+
$Lifetime:                        5.0
      +Lock Pixels/Sec:                70
+
$Energy Consumed:                0.0
      +Catch-up Pixels/Sec:            100
+
$Cargo Size:                      4.0
      +Catch-up Penalty:                30
+
$Homing:                          YES
  $LaunchSnd:                      118
+
  +Type:                            ASPECT
  $ImpactSnd:                      88
+
  +Turn Time:                      1.0
  $FlyBySnd:                        -1
+
  +Min Lock Time:                  2.0
  $Rearm Rate:                      2.0
+
  +Lock Pixels/Sec:                70
  $Flags:                          (  "player allowed"
+
  +Catch-up Pixels/Sec:            100
                                        "EMP")
+
  +Catch-up Penalty:                30
  $Trail:
+
$LaunchSnd:                      118
      +Start Width:                    0.25
+
$ImpactSnd:                      88
      +End Width:                      0.75
+
$FlyBySnd:                        -1
      +Start Alpha:                    1.0
+
$Rearm Rate:                      2.0
      +End Alpha:                      0.0
+
$Flags:                          (  "player allowed"
      +Max Life:                        1.5
+
                                    "EMP")
      +Bitmap:                          MissileTrail04
+
$Trail:
  $Icon:                            iconEMPulse
+
  +Start Width:                    0.25
  $Anim:                            ecm
+
  +End Width:                      0.75
  $Impact Explosion:                ExpMissileHit1
+
  +Start Alpha:                    1.0
  $Impact Explosion Radius:        10.0
+
  +End Alpha:                      0.0
  $EMP Intensity:                  375.0
+
  +Max Life:                        1.5
  $EMP Time:                        20.0
+
  +Bitmap:                          MissileTrail04
  #End
+
$Icon:                            iconEMPulse
  $Player Weapon Precedence: (
+
$Anim:                            ecm
        "Subach HL-7"
+
$Impact Explosion:                ExpMissileHit1
        "EMP Adv."  )
+
$Impact Explosion Radius:        10.0
 +
$EMP Intensity:                  375.0
 +
$EMP Time:                        20.0
 +
 
 +
#End
 +
 
 +
$Player Weapon Precedence: (
 +
    "Subach HL-7"
 +
    "EMP Adv."  )
 +
</pre>
  
 
[[Category:Tables]]
 
[[Category:Tables]]

Revision as of 09:34, 26 July 2007

Revision information..

3.6.x branch: 2.180.2.20
3.7 branch: 2.207


Contents

Special Case Weapons

Beam Cannons

Flak Guns

  • REQUIRE: "flak" and "particle spew" flags
  • Must have inner and outer radius defined to have any effect.
  • Does not use any model or weapon effect though model must be defined, usually Hornet.pof. Instead it uses particle spew. Trails can also be added.

Weapons Table

General Format

  • The weapons table consist of several sections
  • All sections beginning with # need #End before the next section.
    • #Primary Weapons
      • Defines all standard primaries weapons as well as beam cannons and flak cannons.
    • #Secondary Weapons
      • Defines all secondary weapons.
    • #Beam Weapons
      • I haven't got any ideas for this one.
    • #Countermeasures
      • Defines the used countermeasure.
    • $Player Weapon Precedence
      • Player Weapon Precedence is used in weapon selection when a default specified by the mission designer is not available to the player. The next weapon on the list is used in its place (assuming that weapon is allowed for the player).

Core Table

$Name:

  • This is the name of the weapon. If it's going to be used by the player, keep it under 12 characters so it doesn't spill over the HUD box. If the weapon has an @ symbol in front of it, it means it's allowed in the demo. It doesn't really do anything in the retail version.
  • Syntax: String


$Subtype:

FS2 Open, 3.6.x:


+Title:

  • This is the title of the weapon in the Weapons loadout screen. Only needed for player allowed weapons. Title may be anything. Numerical value is a reference to translations in Tstrings.tbl
  • Syntax: XSTR("String", -1)


+Description:

  • This is the description you see in the weapons loadout screen. Again, these aren't based on any hard numbers, just approximations. Only needed for player allowed weapons. Numerical value is a reference to translations in Tstrings.tbl
Example
XSTR(
"''Standard Issue
''Level 3 Hull Damage
''Level 2 Shield Damage''", -1)
$end_multi_text


+Tech Title:

  • Title of the weapon in the Tech room. Only needed for player allowed weapons.
  • Syntax: XSTR("String", -1)


+Tech Anim:

  • Animation used for the weapon in the Tech room. Only needed for player allowed weapons.
  • Syntax: String, animation filename
    • Example: Tech_Subach_HL-7


+Tech Description:

  • Descriptive text you see in the tech room. Only needed for player allowed weapons. Numerical value is a reference to translations in Tstrings.tbl
XSTR(
"''The Subach-Innes HL-7...''", 3245)
$end_multi_text


$Tech Model:

FS2 Open, 3.6.x:
  • Defines model used in wing loadout screen and in Tech Room for the weapon.
  • Syntax: String.pof, model filename


$HUD Image:

FS2 Open, 3.6.x:
  • Defines the picture used to represent the weapon in HUD loadout list
  • Syntax: String, filename


$Model File:

  • Filename of the model file (.pof) at data/models folder. Additional fields beginning from @Laser Bitmap: and ending to @Laser Tail Radius: are not needed if a model has been defined for the weapon.
  • Standard primaries and beam cannons do not use specific models so for those the name is 'none'.
  • Flak weapons and secondaries use models, though the exact model is not important with the flak weapons.
  • Syntax: String.pof or none, model filename
    • Example: none


$POF target LOD:

FS2 Open, 3.6.x:
  • Defines the LOD (Level-Of-Detail) of the model used in HUD targetting view
  • Syntax: Integer


$External Model File:

FS2 Open, 3.6.x:
  • Defines the models shown on the gunpoint, used with Bobb's external-visible-weapon code.
  • Syntax: String.pof, model filename


$Submodel Rotation Speed:

FS2 Open, 3.6.x:
  • Defines the rotation speed of the external weapon model
  • Syntax: Float


$Submodel Rotation Acceleration:

FS2 Open, 3.6.x:
  • Defines the rotation acceleration of the external weapon model
  • Syntax: Float


@Laser Bitmap:

    • The graphic file to be used as the weapon effect if no model is defined.
    • Syntax: String, filename


@Laser Glow:

    • The graphic file that determines the glow of the weapon effect if no model is defined
    • Syntax: String, filename


@Laser Color:

    • The color of the weapon effect when you fire it.
    • Syntax: Color, red, green, blue respectively, value from 0 to 255
      • Example: 250, 0, 0


@Laser Color2:

    • The color of the weapon effect at its maximum range.
    • Syntax: Color, red, green, blue respectively, value from 0 to 255
      • Example: 0, 0, 250


@Laser Length:

    • Length of the weapon effect.
    • Syntax: Float, meters


@Laser Head Radius:

    • Width of the head of the weapon effect.
    • Syntax: Float, meters


@Laser Tail Radius:

    • Width of the tail of the weapon effect.
    • Syntax: Float, meters


$Mass:

  • How much of a kinetic effect this weapon has on its target. 3+ gives you the Flail effect. Set it to 10 and you can knock cruisers around.
  • This is somehow multiplied by the speed. ie $Mass: 3 and $Velocity: 200 has much weaker kinetic effect than $Mass: 3 and $Velocity: 1000. Also $Mass is used to calculate intensity of "shudder" effect if flagged.
  • Syntax: Float, blast effect


$Velocity:

  • How fast the weapon travels. Is also used to define the weapon range, $Velocity x $Lifetime = range.
  • Beams travel instantly so this field has effect only on weapon range and AI beam targetting with certain beam types. $Velocity of beam also applies to its kinetic effect along with $Mass.
  • Syntax: Float, meters per second


$Fire Wait:

  • Time in seconds between firings
  • Syntax: Float, seconds


$Damage:

  • Base damage this weapon does. The actual damage is this number multiplied by the factors below.
  • Base damage this beam does is continuous damage, damage is 5.5 times the damage value per second. The actual damage is this number multiplied by one of the factors below.
  • Syntax: Float, damage


$Damage Type:

FS2 Open, 3.6.x:
  • Defines the damage type that this weapon uses. All armor effects are applied after shield and have no function against shockwave or subsystem damage. REQUIRES ADDITIONAL TABLE.
  • Syntax: String, name of the damage type as defined in armor.tbl


$Arm time:

FS2 Open, 3.6.x:
  • Defines the time after the launch that is required before the weapon comes hot
  • If the time has not been reached when the weapon detonates the Dinky explosion is used
  • Syntax: Float, seconds


$Arm distance:

FS2 Open, 3.6.x:
  • Defines the distance from the firing ships that is required before the weapon comes hot
  • If the distance has not been reached when the weapon detonates the Dinky explosion is used
  • Syntax: Float, meters


$Arm radius:

FS2 Open, 3.6.x:
  • Defines the distance from the target where the weapon will arm itself
  • Syntax: Float, meters


$Detonation Range:

FS2 Open, 3.6.x:
  • Defines the distance from the point in space that the weapon was launched where the weapon will detonate
  • Syntax: Float, meters


$Detonation Radius:

FS2 Open, 3.7:
  • Defines the distance between the target center point point and the weapon which detonates the weapon.
  • Syntax: Float, meters


$Shockwave damage:

FS2 Open, 3.6.x:
  • Override for the damage caused by shockwaves
  • Syntax: Float, damage


$Shockwave Damage Type:

FS2 Open, 3.6.x:
  • REQUIRES ADDITIONAL TABLE. Defines the damage type used for the weapon explosions
  • Syntax: String, name as defined in armor.tbl


$Blast Force:

  • The intensity of the blast effect when ship is within the outer radius of the explosion. Comes in effect only if inner and outer radius are defined.
  • Syntax: Float, blast effect


$Inner Radius:

  • Radius at which the full explosion damage is done. Marks the line where damage attenuation begins.
  • Syntax: Float, meters


$Outer Radius:

  • Maximum radius at which any damage is done
  • Syntax: Float, meters


$Shockwave Speed:

  • Speed shockwave expands at. Zero means no shockwave and that damage is applied immediately
  • Syntax: Float, meters per second


$Shockwave rotation:

FS2 Open, 3.6.x:
  • Defines how the 3D shockwave is rotated.
  • Syntax: Angle, three values, pitch, bank, heading respectively, in degrees


$Shockwave model:

FS2 Open, 3.6.x:
  • Defines the model file (.pof) used as a shockwave for the 3D shockwaves.
  • Syntax: String.pof, model filename


$Shockwave name:

FS2 Open, 3.6.x:
  • Defines the name of the animation used for the 2D shockwave
  • Syntax: String, filename


$Dinky shockwave:

FS2 Open, 3.6.x:
  • Dinky shockwave are used if the weapon is shot down before arming or if the conditions marked at Arm time and Arm distance are not reached before impact
  • It uses exactly same entries as the standard shockwaves
  • +Shockwave damage:
  • +Shockwave damage type:
  • +Blast Force:
  • +Inner Radius:
  • +Outer Radius:
  • +Shockwave Speed:
  • +Shockwave Rotation:
  • +Shockwave Model:
  • +Shockwave Name:


$Armor Factor:

  • Multiplier for the damage done to armor
  • Syntax: Float, damage multiplier


$Shield Factor:

  • Multiplier for the damage done to shields
  • Syntax: Float, damage multiplier


$Subsystem Factor:

  • Multiplier for the damage done to subsystems
  • Syntax: Float, damage multiplier


$Lifetime Min:

FS2 Open, 3.6.x:
  • Defines the minimum lifetime of the weapon
  • Syntax: Float, seconds


$Lifetime Max:

FS2 Open, 3.6.x:
  • Defines the maximum lifetime of the weapon
  • Syntax: Float, seconds


$Lifetime:

  • Time before the standard primaries fizzle out and secondaries self destruct. Multiply this by the speed to get the range. If values are too low (below framerate) then the collision detection and graphic effects may suffer.
  • This field has no effect for the beams apart from weapon range and AI beam targeting with certain beam types
  • Syntax: Float, seconds


$Energy Consumed:

  • The amount of energy each bolt drains firing ship. Has no effect on turretted weapons.
  • Syntax: Float


$Cargo Size:

  • Cargo size, is not used with primaries.
  • Amount of missiles available = Bank capacity / Cargo Size.
  • Syntax: Float


$Homing:

  • Only for secondaries. You can't have homing primaries. If this is set to YES with primaries, then the bolts turn to face their target but keep moving in the same direction. If the field is set to NO then following fields are not required in the table.
  • Defines if the missiles in question is homing
  • Syntax: Boolean, yes or no
  • +Type:
    • Defines the homing method
    • Syntax: String, ASPECT or HEAT
  • +Turn Time:
    • Defines how well missile maneuvers. Number of seconds it takes the missile to do a 360 degree circle
    • Syntax: Float, seconds
  • +View Cone:
    • Heat-seeking missiles only, this is then number of degrees the missile sees. Value / 2 gives the angle from the missiles centerline.
    • Syntax: Float, degrees
FS2 Open, 3.6.x: Has been enabled also to aspect seekers as an option.
  • +Min Lock Time:
    • For aspect missiles only, the minimum number of seconds to gain target lock
    • Syntax: Float, seconds
  • +Lock Pixels/Sec:
    • For aspect missiles only, pixels the aspect triangle moves per second while attempting lock-on
    • Syntax: Integer, pixels per second
  • +Catch-up Pixels/Sec:
    • For aspect missiles only, pixels moved per second while attempting to catch up to the target
    • Syntax: Integer, pixels per second
  • +Catch-up Penalty:
    • For aspect missiles only, extra pixels to move after catching up ????
    • Syntax: Integer, pixels
FS2 Open, 3.6.x:
  • +Seeker Strength:
    • Defines the seeking ability of the homing system. Default of heat seekers is 3 and for aspect seekers 2. Spoofing change is defined as cm type effectiveness/seeker strength.
    • Syntax: Float, seeker strength


$Swarm:

  • The number of missiles to fire per volley if it's a swarm missile
  • Can be issued to Standard primaries also. Causes single part turrets to malfunction but causes multi part turrets to fire only on their barrel line. Can be used for 'burst fire weapons'.
  • Is incompatible with "Corkscrew" option.
  • Syntax: Integer, number of shots in a swarm
FS2 Open, 3.6.x:
  • +SwarmWait:
    • Defines the time between weapons fired in a swarm
    • Syntax: Float, seconds
      • Default: 0.150


$Free Flight Time:

FS2 Open, 3.6.x:
  • Defines the free flight time of homing weapons. During this time weapon flies at 1/4 of its velocity + firing ships velocity in a straight line.
  • Syntax: Float, seconds
    • Default: 0.25


$LaunchSnd:

  • Corresponding sound effect when the weapon is launched.
  • Syntax: Integer or String, name or identification number of the sound as defined in sounds.tbl


$ImpactSnd:

  • Sound the weapon makes when it hits a hull.
  • Syntax: Integer or String, name or identification number of the sound as defined in sounds.tbl


$Disarmed ImpactSnd:

FS2 Open, 3.6.x:
  • Sound the weapon makes when it hits a hull before being armed.
  • Syntax: Integer or String, name or identification number of the sound as defined in sounds.tbl


$FlyBySnd:

  • The sound this weapon makes if it narrowly misses you. -1 is no sound.
  • Syntax: Integer or String, name or identification number of the sound as defined in sounds.tbl, usually -1


$Model:

FS2 Open, 3.6.x:
  • Defines used model file. Included for compatibility with countermeasures as they have been merged with weapons in the code.
  • Syntax: String.pof, model filename


$Rearm Rate:

  • Defines the rate the weapons are loaded to the ship
  • Syntax: Float, missiles loaded per second


+Weapon Range:

  • Defines the range to the target where the weapons under AI will start firing.
  • Syntax: Float, meters


+Weapon Min Range:

FS2 Open, 3.6.x:
  • Defines the minimum range to the target where the weapons under AI will still fire.
  • Implemented before FS_Open 3.6.5
  • Syntax: Float, meters


$Flags:


$Trail:

  • This is used if you want your weapon to have a trail. Trail is often used only with secondaries though it works with standard primaries as well.
  • +Start Width:
    • How wide the head of the trail is.
    • Syntax: Value, (meters)
  • +End Width:
    • How wide the tail of the trail is.
    • Syntax: Value, (meters)
  • +Start Alpha:
    • The opacity of the trail head.
    • Syntax: Value value between 0 and 1
  • +End Alpha:
    • The opacity of the trail tail.
    • Syntax: Value, value between 0 and 1
  • +Max Life:
    • How long the trail lasts.
    • Syntax: Value, (seconds)
  • +Bitmap:
    • The graphic file to use for the trail.
    • Syntax: Filename


$Icon:

  • Loadout icon used in the weapons selection screen.
  • Syntax: Filename


$Anim:

  • Green grid animation used on the weapons screen.
  • Syntax: Filename


$Collide Ship:

FS2 Open, 3.6.x:
  • Hook for Lua scripting
  • Globals: "Self", weapon with class that the hook is defined in. "Ship", ship that the weapon collided with.
  • Override: Turns off all damage effects from weapon, as well as weapon being destroyed.


FS2 Open, 3.7:


$Collide Weapon:

FS2 Open, 3.6.x:
  • Hook for Lua scripting
  • Globals: "Self", weapon with class that the hook is defined in. "Weapon", other weapon.
  • Override: Turns off weapon killing types with bombs. If two weapons, weapon "A" (arbitrary) is preferred


FS2 Open, 3.7:


$Impact Explosion:

  • Impact explosion used. Must be defined in weapon_expl.tbl,
  • Syntax: Filename or none


$Impact Explosion Radius:

  • Radius of the defined impact explosion.
  • Syntax: Value


$Dinky impact explosion:

FS2 Open, 3.6.x:
  • Same as Impact explosion but for Dinky (not armed) explosions


$Dinky impact explosion radius:

FS2 Open, 3.6.x:
  • Same as Impact explosion radius but for Dinky explosions


$Muzzleflash:

  • Normally only with flak cannons.
  • Defines the muzzle flash the weapon uses
  • Syntax: Muzzleflash name, as defined in mflash.tbl


$EMP Intensity:

    • If it has an EMP effect, how deeply it scrambles your electronics
    • Syntax: Value


$EMP Time:

    • Duration of the EMP effect
    • Syntax: Value, (seconds)

$Leech Weapon:

    • The amount of weapon energy to drain with each hit
    • Syntax: Value


$Leech Afterburner:

    • The amount of afterburner fuel to drain with each hit
    • Syntax: Value


$Corkscrew:

FS2 Open, 3.6.x:
  • Allow corkscrew parameters to be defined
  • +Num Fired:
    • Defines the number of weapons fired in sequence. Same as the standard swarm entry but for corkscrew missiles
    • Syntax: Value
  • +Radius:
    • Defines the radius used in the corkscrew motion
    • Syntax: Value, (meters)
  • +Fire Delay:
    • Defines the delay between missile firings
    • Syntax: Value, (milliseconds)
  • +Counter rotate:
    • Defines if every other missile rotates to a different direction (clockwise / anticlockwise)
    • Syntax: 0 or 1, no or yes
  • +Twist:
    • Defines the speed of rotation movement on the radius of corkscrew motion.
    • Syntax: Value (radians per second)


$Electronics:

FS2 Open, 3.6.x:
  • Defines the weapons effect against electronics. Requires "electronics" flag. +New Style: and +Old Style: options are mutually exclusive.
  • +New Style:
    • Defines that the electronics use the new style which enables more options.
  • +Old Style:
    • Defines that the electronics use the old style. The old style was the way the D-Missile worked in Descent:Freespace.
  • +Intensity:
    • May only be used with +New Style: electronics. Defines how much the electronics hit affects larger ships. An intensity of 1.0 will disrupt a cruiser without trouble.
    • Syntax: Value
  • +Lifetime:
    • Syntax: Value, (milliseconds)
  • +Engine Multiplier:
    • May only be used with +New Style: electronics. Defines how much longer the disruption effect lasts for engine subsytems.
    • Syntax: Value
  • +Weapon Multiplier:
    • May only be used with +New Style: electronics. Defines how much longer the disruption effect lasts for non-beam turrets.
    • Syntax: Value
  • +Beam Turret Multiplier:
    • May only be used with +New Style: electronics. Defines how much longer the disruption effect lasts for beam turrets.
    • Syntax: Value
  • +Sensors Multiplier:
    • May only be used with +New Style: electronics. Defines how much longer the disruption effect lasts for sensor subsystems.
    • Syntax: Value
  • +Randomness Time:
    • Defines the randomness of duration target suffers from the electronics hit. A random number between 0 and this time will be added or subtracted from the disruption time.
    • Syntax: Value, (milliseconds)
  • Without any electronics parameters, a weapon with the "electronics" flag will default to the Old Style mode with a lifetime of 6000 milliseconds and a randomness of 4000 milliseconds. Thus any ship that gets hit can get disrupted for anywhere between 2 to 10 seconds.


$Spawn Angle:

FS2 Open, 3.6.x:
  • Defines the cone (with an angle) where the spawned weapons appear. Value gives the angle from the missiles centerline. The maximum possible angle between any two child weapons would be Value*2.
  • Syntax: Value, (degrees)


$Local SSM:

FS2 Open, 3.6.x:
  • Defines the local SSM (Subspace Missile). In effect missile moves via subspace to a position close to the target and starts homing.
  • Weapon must be aspect seeking missile and must have local ssm flag.
  • +Warpout Delay:
    • Defines the time between the missile launch and the subspace jump.
    • Syntax: Value, (milliseconds)
  • +Warpin Delay:
    • Defines the time missile stays in subspace before exiting.
    • Syntax: Value, (milliseconds)
  • +Stage 5 Velocity:
    • Defines the velocity of the missile after the subspace jump.
    • Syntax: Value, (meters per second)
  • +Warpin Radius:
    • Defines how far from the SSM will appear from the outer radius of the target.
    • Syntax: Value, (meters)
  • +Lock Range:
    • Defines the maximum range where SSM can achieve target lock
    • Syntax: Value, (meters)


$Countermeasure:

FS2 Open, 3.6.x:
  • Defines the countermeasure effectiveness and radius
  • +Heat Effectiveness:
    • Defines the countermeasures effectiveness against heat seeking missiles
    • Syntax: Value, (cm type effectiveness)
      • Default: 1
  • +Aspect Effectiveness:
    • Defines the countermeasures effectiveness against aspect seeking missiles
    • Syntax: Value, (cm type effectiveness)
      • Default: 1
  • +Effective Radius:
    • Defines the countermeasures effective radius
    • Syntax: Value, (meters)
      • Default: 300


$BeamInfo:

  • +Type:
    • Defines the type of beam in question. Beam types: 0 is a standard non-slashing type beam. 1 is a slashing type beam. 2 is a targetting beam that doesn't seem to have much of an effect on anything. 3 is a beam type that fires pulses in anti-fighter role and acts like type 0 beam in other roles. 4 is a beam that is restricted to what is directly in front of it, along turrets firepoints normal.
    • Syntax: Value, only values from 0 to 4 are legal
  • +Life:
    • How long it lasts once the beam is actually firing.
    • Syntax: Value, (seconds)
  • +Warmup:
    • Warmup time
    • Syntax: Value, (milliseconds)
  • +Warmdown:
    • Warmdown time
    • Syntax: Value, (milliseconds)
  • +Radius:
    • Muzzle glow radius
    • Syntax: Value (meters)
  • +PCount:
    • Particles spewed every interval. ??
    • Syntax: Value
  • +PRadius:
    • Particle radius
    • Syntax: Value, (meters)
  • +PAngle:
    • Defines the random "cone" where the particles are generated
    • Syntax: Value, (angle of the cone)
  • +PAni:
    • Animation used to represent the particles
    • Syntax: Filename
  • +Miss Factor:
    • The higher the numbers, the more likely that this beam will miss. One value for every difficulty level
    • Syntax: Value Value Value Value Value, Very Easy, Easy, Moderate, Hard, Very Hard respectively.
      • Example: 0.5 0.975 1.35 1.875 2.5
  • +BeamSound:
    • Corresponding looping sound effect when the beam is firing.
    • Syntax: Value, identification number of the sound as defined in sounds.tbl
  • +WarmupSound:
    • Corresponding sound effect when the beam is beam warmed up.
    • Syntax: Value, identification number of the sound as defined in sounds.tbl
  • +WarmdownSound:
    • Corresponding sound effect when the beam is warming down.
    • Syntax: Value, identification number of the sound as defined in sounds.tbl
  • +Muzzleglow:
    • Defines the bitmap used t create the muzzle glow
    • Syntax: Filename
  • +Shots:
    • Defines into how may invidual shots the type 3 (AAA) beams are divided. Note total firing is the same as the +Life:
    • Syntax: Value
  • +ShrinkFactor:
    • What percentage of lifetime where beam starts shrinking (0.1 == 10% life left)
    • Syntax: Value
  • +ShrinkPct:
    • What percentage of max width we subtract per second
    • Syntax: Value
FS2 Open, 3.6.x:
  • +Range:
    • Defines the maximum range where the beam still has any effect.
    • Syntax: Value, (meters)
  • +Attenuation:
    • Defines the point where the damage caused by the beam starts to attenuate. At maximum range damage is zero.
    • Syntax: Value, (from 0 - firing point to 1 - no effect)
      • Default: 1
  • $Section:
    • Beams are made up of up to five sections layered atop one another to create the effect. Each section has its own parameters.
FS2 Open, 3.6.x:
  • +Index:
    • Field used to define with Modular Tables the beam section which is edited.
    • Syntax: Value, (index number legal values are from 0 to 5)
  • +Width:
    • Width of the section
    • Syntax: Value (meters)
  • +Texture:
    • Texture for the section
    • Syntax: Filename
  • +RGBA Inner:
    • Defines the color and transparency of the center of the section
    • Syntax: Value Value Value Value, (Red, Green, Blue, and Alpha respectively, value from 0 to 255)
      • Example: 255 255 255 255
  • +RGBA Outer:
    • Defines the color and transparency of the edges of the section
    • Syntax: Value Value Value Value, (Red, Green, Blue, and Alpha respectively, value from 0 to 255)
      • Example: 150 150 150 10
  • +Flicker:
    • Defines how much the section flickers
    • Syntax: Value, value from 0 to 1
  • +Zadd:
    • Defines the 'thickness' of the section. The higher the Zadd, the closer the section appears to be.
    • Syntax: Value
FS2 Open, 3.6.x:
  • +Tile Factor:
    • Defines the beam texture tileing factor. Second number defines the tileing type. Type 0 tiles the graphic in the beam as many times as defined by the 1st number. Type 1 uses the 1st value as the lenght of the tile.
    • Syntax: Value, Value
  • +Translation:
    • Implemented before FS_Open 3.6.5
    • Defines the speed of translation of the beam, a positive value moves from the impact point to the firing point, while a negative value moves away from the firing point towards the impact point. Measured in tiles per second, where the tile count is defined in the "+Tile Factor:" field above.
    • Syntax: Value


$Pspew:

FS2 Open, 3.6.x:
  • Defines a particle spew effect for the given weapon
  • +Count:
    • Defines how many particles are spawn when they are ready to be created
    • Syntax: Value
  • +Time:
    • Defines the time in millseconds between next particle(s) spewed
    • Syntax: Value, (milliseconds)
  • +Vel:
    • Defines the created particles velocity as percentage of the weapons velocity
    • Syntax: Value
  • +Radius:
    • Defines the size of the created particles
    • Syntax: Value, (meters)
  • +Life:
    • Defines how long the particles last.
    • Syntax: Value, (seconds)
  • +Scale:
    • Defines the particle spread. Small value will make particles group together
    • Syntax: Value
  • +Bitmap:
    • Defines the animation used to create the particle spew effect
    • Syntax: Filename


$Tag:

  • Allowed for secondary weapons
  • Location: After $Impact Explosion Radius:
  • Sets this weapon as a TAG missile, level 1, 2, or 3. The second number is the duration in seconds.
  • TAG Level 1 will illuminate hidden targets such as stealth fighters or ships normally obscured by nebula conditions.
  • TAG Level 2 illiminates targets much like TAG Level 1, but turrets will prefer to shoot at them over other ships.
  • TAG Level 3 has no effect in retail.
  • Syntax: TAG level Value, (seconds)


$SSM:

FS2 Open, 3.6.x:
  • Defines the weapons SSM index number:
  • Syntax: Value


$FOF:

FS2 Open, 3.6.x:
  • Defines the field of fire for the weapon. Causes weapon to fire into a firing cone instead of direct firing line thus causing light inaccuracy
  • Syntax: Value, (degrees)


$Shots:

FS2 Open, 3.6.x:
  • Defines the number of shots every time the weapon is fired.
  • Syntax: Value, (number of shots)


$decal:

FS2 Open, 3.6.x:
  • Defines impact decals if they are in use
  • Currently broken
  • +texture:
    • Defines the texture used for impact decals (can use -burn and -glow textures)
    • Syntax: Filename
  • +backface texture:
    • Defines ???
    • Syntax: Filename
  • +radius:
    • Defines the size of the impact decals on target
    • Syntax: Value, (meters)
  • +burn time:
    • Defines the time the -burn texture appears on the target
    • Syntax: Value


$Transparent:

FS2 Open, 3.6.x:
  • Defines weapon effect as transparent. Enables optional fields for 'alpha animations'
  • +Alpha:
    • Defines the strenght of the alpha (transparency). And also the maximum value for the alpha cycle option
    • Syntax: Value, from 0 to 1
  • +Alpha Min:
    • Defines the minimum alpha value for alpha cycle option
    • Syntax: Value, from 0 to 1
  • +Alpha Cycle:
    • Defines the change in alpha per frame, between Alpha and Alpha Min values
    • Syntax: Value


Weapon Flags

"Electronics"

  • Will seize up the weapons and engines systems of any ship for a short period of time.


"Spawn Name,Value"

  • Will spawn the specified number of defined missiles upon detonation.


"Remote Detonate"

  • Can be triggered remotely via a second press on the trigger


"Puncture"

  • Reduces hull damage by 25%


"Big Ship"

  • These weapons cannot be mounted on small ships like fighters, bombers, sentry guns etc.


"Huge"

  • Allows this weapon to do the final 10% damage to a ship with the "Big Damage" flag.


"Supercap"

  • Allows this weapon to do the final 75% damage to a ship with the "supercap" flag.


"Bomber+"

  • The AI will prefer to use this weapon against bombers


"child"

  • Cannot be set as a weapon on any ship, but is instead a child of a weapon. Usually defined with "Spawn Name,Value"


"Bomb"

  • Makes this weapon targetable with the B key, and the AI prefers to use it against large ships


"No Dumbfire"

  • Missile will not fire without a lock


"in tech database"

  • Has the weapon in the tech database at the start of the campaign


"Player allowed"

  • Allows this weapon as a player weapon.
FS2 Open, 3.6.x:
  • EXTREMELY IMPORTANT NOTE:
    • Whenever you plan to use a weapon as a player one in your campaign or missions, DO USE THIS FLAG.
    • Not using it can cause problems within fs_open and it's a BAD MOD DESIGN.
    • In the future, fs_open will maybe be able to avoid these problems but, nevertheless, it's still a BAD DESIGN.
    • As another possible example: be careful to update "retail" tables if you plan to use Shivan weapons in player fighters.


"Particle Spew"

  • Makes the weapon projectile spew out particles
FS2 Open, 3.6.x:


"EMP"

  • This weapon will have an EMP effect on any ship within the blast radius
  • Can be defined with EMP Intensity and EMP Time


"Esuck"


"Flak"


"Corkscrew"

  • Makes this weapon spiral AND swarm 4.
FS2 Open, 3.6.x:


"Shudder"

  • Makes your ship shudder while you're firing the weapon


"lockarm"

  • Requires a target lock in order to arm its warhead. In other words weapon causes less damage if it hits the target without target lock.


"beam"


"stream"

  • Gives this weapon a streaming effect. In effect weapon keeps firing when firing button is kept pressed.


"puncture"

  • Reduces hull damage by 25%


"supercap"

  • Makes weapon capable of causing real damage against ships with "supercap" flag.


"countermeasure"

FS2 Open, 3.6.x:
  • Defines the weapon as a countermeasure


"Ballistic"

FS2 Open, 3.6.x:
  • Defines the weapon as a ballistic weapon that needs ammunition.
  • Make sure you define the size and reload rate for ballistic weapons


"pierce shields"

FS2 Open, 3.6.x:
  • Causes weapons to penetrate shield without causing damage to it.


"no pierce shields"

FS2 Open, 3.6.x:
  • Prevents weapons (beams) from piercing shields causing shields to be damaged by weapons first.


"local ssm"

FS2 Open, 3.6.x:


"tagged only"

FS2 Open, 3.6.x:
  • Weapon can only be fired at tagged targets


"beam no whack"

FS2 Open, 3.6.x:
  • Disables beam whacking (push). Practically same as setting beam mass to zero.


"cycle"

FS2 Open, 3.6.x:
  • Causes weapon to alternate between firing points


"small only"

FS2 Open, 3.6.x:
  • Causes AI to use the weapon only on small targets (fighters, bombers etc.)


"same turret cooldown"

FS2 Open, 3.6.x:
  • Forces the turrets to fire on the designated rate of fire on all difficulty levels and all AI levels


"apply no light"

FS2 Open, 3.6.x:
  • Prevents light from being applied to the weapon model.


"inherit parent target"

FS2 Open, 3.7:
  • Sets spawned 'chield' weapons to use parent weapon's target-


"training"

FS2 Open, 3.7:
  • Sets weapon to be of training weapon type. ?


Countermeasures

  • Usually not altered. Only one can exist
FS2 Open, 3.6.x:
  • More than one can exist


$Name:

  • Name of the countermeasure
  • Syntax: Name, usually Type One


$Velocity:

  • Defines the spped of the countermeasure, relative to the ship.
  • Syntax: Value, (meter per second)


$Fire Wait:

  • Definies the minumum time between the countermeasure launches
  • Syntax: Value, (seconds)


Lifetime

  • Countermeasure's life time is defined between with minimum and maximum lifetime
  • $Lifetime Min:
    • Syntax: Value, (seconds)
  • $Lifetime Max:
    • Syntax: Value, (seconds)


$LaunchSnd:

  • Defines the sound for the countermeasure launch
  • Syntax: Value, refers to sounds.tbl


$Model:

  • Defines the used model file (.pof)
  • Syntax: Filename.pof, usually cmeasure01.pof


Player Weapon Precedence

  • First the primary weapons are defined, from most powerful to least powerful, and then the same for secondaries
  • Syntax: ( "Name" "Name")
  • Example:
$Player Weapon Precedence: (
     "UD-8 Kayser"
     "Prometheus R"
     "Subach HL-7"
     "Harpoon"
     "Tempest"
     "Rockeye"   )

Sample

#Primary Weapons

$Name:                            @Subach HL-7
   +Title:                           XSTR("GTW Subach HL-7", 3243)
   +Description:
XSTR( "Standard Issue
Level 3 Hull Damage
Level 2 Shield Damage", 3244)
$end_multi_text
   +Tech Title:                      XSTR("Subach HL-7", 146)
   +Tech Anim:                       Tech_Subach_HL-7
   +Tech Description:
XSTR(
"Descriptive text...", -1)
$end_multi_text
$Model File:                      none
   @Laser Bitmap:                    newglo9
   @Laser Glow:                      2_laserglow03
   @Laser Color:                     250, 0, 0
   @Laser Color2:                    0, 0, 250
   @Laser Length:                    10.0
   @Laser Head Radius:               0.90
   @Laser Tail Radius:               0.90
$Mass:                            0.2
$Velocity:                        450.0
$Fire Wait:                       0.2
$Damage:                          15
$Armor Factor:                    0.9
$Shield Factor:                   0.7
$Subsystem Factor:                0.3
$Lifetime:                        2.0
$Energy Consumed:                 0.20
$Cargo Size:                      0.0
$Homing:                          NO
$LaunchSnd:                       76
$ImpactSnd:                       85
$Flags:                           (  "in tech database"
                                     "player allowed"
                                     "stream")
$Icon:                            iconSD4
$Anim:                            SD4
$Impact Explosion:                none

#End


#Secondary Weapons

$Name:                            EMP Adv.
   +Title:                           XSTR("GTM-14 EMP Adv.", 3396)
   +Description:
XSTR( "Advanced Missile
Electromagnetic Pulse Weapon
General Purpose Suppression", 3397)
$end_multi_text
   +Tech Title:                      XSTR("GTM-14 EM Pulse Adv.", 3398)
   +Tech Anim:                       Tech_EMP
   +Tech Description:
XSTR(
"Descriptive text...", -1)
$end_multi_text
$Model File:                      EMPulse2.pof
$Mass:                            15.0
$Velocity:                        275.0
$Fire Wait:                       2.0
$Damage:                          45
$Blast Force:                     20.0
$Inner Radius:                    80.0
$Outer Radius:                    300.0
$Shockwave Speed:                 120.0
$Armor Factor:                    1.0
$Shield Factor:                   0.8
$Subsystem Factor:                0.5
$Lifetime:                        5.0
$Energy Consumed:                 0.0
$Cargo Size:                      4.0
$Homing:                          YES
   +Type:                            ASPECT
   +Turn Time:                       1.0
   +Min Lock Time:                   2.0
   +Lock Pixels/Sec:                 70
   +Catch-up Pixels/Sec:             100
   +Catch-up Penalty:                30
$LaunchSnd:                       118
$ImpactSnd:                       88
$FlyBySnd:                        -1
$Rearm Rate:                      2.0
$Flags:                           (  "player allowed"
                                     "EMP")
$Trail:
   +Start Width:                     0.25
   +End Width:                       0.75
   +Start Alpha:                     1.0
   +End Alpha:                       0.0
   +Max Life:                        1.5
   +Bitmap:                          MissileTrail04
$Icon:                            iconEMPulse
$Anim:                            ecm
$Impact Explosion:                ExpMissileHit1
$Impact Explosion Radius:         10.0
$EMP Intensity:                   375.0
$EMP Time:                        20.0

#End

$Player Weapon Precedence: (
     "Subach HL-7"
     "EMP Adv."   )