Weapons.tbl - Revision history

Kestrellius at 01:10, 11 November 2026

2026-11-11T01:10:26Z

@@ Line 1: / Line 1: @@
-{{TableVersionGit|2024-12-10|228fd17}}
+{{TableVersionGit|2025-07-12|6921f55}}
 {{Tables}}
 The '''weapons.tbl''' defines all of the weapon classes used in FSO.
@@ Line 1,267: / Line 1,267: @@
 *May be defined any number of times.
 *Currently only works for targets that are ships or weapons. Impacts against weapons are not considered to have a hit angle.
 *All conditional impacts whose requirements are met will play.
 *Non-conditional impact effects, the ones defined above, will only play if no conditional impacts' requirements are met.
 *'''+Armor Type:'''
 **Name of armor type the target must have in order for this impact to play. Shields can have their own armor types. (Subsystems can as well, but at present this system will not detect that.)
 **Syntax: ''''''String'''''', name of armor type in [[armor.tbl]]
 *'''+Min Health Threshold:'''
 **Fraction of target health below which impact will not play. Health is calculated separately for individual shield quadrants and hull.
@@ Line 1,280: / Line 1,296: @@
 **Optional; defaults to 1.0.
 **Syntax: ''''''Float'''''', fraction of health from 0.0 to 1.0
 *'''+Min Angle Threshold:'''
 **Hit angle -- that is, the angle measuring how 'straight on' you're hitting the target surface -- below which impact will not play.
@@ Line 1,288: / Line 1,314: @@
 **Optional; defaults to 180.0.
 **Syntax: ''''''Float'''''', degrees
 *'''+Dinky:'''
 **Whether to play if and only if the weapon is not armed. If false, the impact will not play if the weapon is not armed.
 **Optional; defaults to false.
 **Syntax: ''''''Boolean''''''
 *'''+Effect Name:'''
 **Name of [[Particle Effects|particle effect]] that will play when conditions are met.
 **Syntax: ''''''String'''''', name of effect
 }}

Lafiel: /* $Impact Effect: */

2026-05-27T22:16:53Z

$Impact Effect:

← Older revision		Revision as of 22:16, 27 May 2026
Line 1,159:		Line 1,159:
	*Syntax: '''String''', the particle effect name		*Syntax: '''String''', the particle effect name
	*If this option is specified then ''$Impact Explosion'' and ''$Impact Explosion Radius'' are not valid options!		*If this option is specified then ''$Impact Explosion'' and ''$Impact Explosion Radius'' are not valid options!
	*If used for beams, this will create an impact every 170ms or every frame with a 1/4th chance. ~~This option also requires either ''+Beam Flash Effect'' or ''+Beam Piercing Effect'' to spawn. It will be rendered only if either of those [or both] are specified.~~ }}		*If used for beams, this will create an impact every 170ms or every frame with a 1/4th chance.
			}}

	===$Impact Explosion:===		===$Impact Explosion:===

Lafiel: /* $BeamInfo: */

2026-05-27T12:47:03Z

$BeamInfo:

← Older revision		Revision as of 12:47, 27 May 2026
Line 1,667:		Line 1,667:
	{{Table38\|		{{Table38\|
	*'''+Beam Flash Particle Effect:'''		*'''+Beam Flash Particle Effect:'''
	**Specifies the beam flash [[Particle Effects\|particle effect]].		**Specifies the beam flash [[Particle Effects\|particle effect]] (will be applied every frame where the beam is colliding).
	**Syntax: '''''String''''', particle effect name		**Syntax: '''''String''''', particle effect name
	**If this is specified then '''+Beam Flash Effect''' and '''+Beam Flash Radius''' are not valid options!		**If this is specified then '''+Beam Flash Effect''' and '''+Beam Flash Radius''' are not valid options!
Line 1,678:		Line 1,678:
	**Syntax: '''''Float'''''		**Syntax: '''''Float'''''
	*'''+Beam Piercing Effect:'''		*'''+Beam Piercing Effect:'''
	**Defines the beam piercing (bursting flames) effect for the beam.		**Defines the beam piercing (bursting flames) effect for the beam (will be applied every frame with a beam that is strong / large enough to pierce through its target).
	**Syntax: '''''String''''', filename		**Syntax: '''''String''''', filename
	*'''+Beam Piercing Radius:'''		*'''+Beam Piercing Radius:'''

Lafiel: /* $Impact Effect: */

2026-05-27T12:46:06Z

$Impact Effect:

← Older revision		Revision as of 12:46, 27 May 2026
Line 1,159:		Line 1,159:
	*Syntax: '''String''', the particle effect name		*Syntax: '''String''', the particle effect name
	*If this option is specified then ''$Impact Explosion'' and ''$Impact Explosion Radius'' are not valid options!		*If this option is specified then ''$Impact Explosion'' and ''$Impact Explosion Radius'' are not valid options!
	*If used for beams, this option also requires either ''+Beam Flash Effect'' or ''+Beam Piercing Effect'' to spawn. It will be rendered only if either of those [or both] are specified. }}		*If used for beams, this will create an impact every 170ms or every frame with a 1/4th chance. This option also requires either ''+Beam Flash Effect'' or ''+Beam Piercing Effect'' to spawn. It will be rendered only if either of those [or both] are specified. }}

	===$Impact Explosion:===		===$Impact Explosion:===

Nyctaeus: $Impact Effect note

2026-04-17T19:30:35Z

$Impact Effect note

← Older revision		Revision as of 19:30, 17 April 2026
Line 1,159:		Line 1,159:
	*Syntax: '''String''', the particle effect name		*Syntax: '''String''', the particle effect name
	*If this option is specified then ''$Impact Explosion'' and ''$Impact Explosion Radius'' are not valid options!		*If this option is specified then ''$Impact Explosion'' and ''$Impact Explosion Radius'' are not valid options!
	}}		*If used for beams, this option also requires either ''+Beam Flash Effect'' or ''+Beam Piercing Effect'' to spawn. It will be rendered only if either of those [or both] are specified. }}

	===$Impact Explosion:===		===$Impact Explosion:===

Asteroth at 00:48, 30 January 2026

2026-01-30T00:48:49Z

← Older revision		Revision as of 00:48, 30 January 2026
Line 1,003:		Line 1,003:
	{{Table240\|		{{Table240\|
	===$StartFiringSnd:===		===$StartFiringSnd:===
	*The sound that plays when the ~~user presses the trigger down while this~~ weapon ~~is equipped~~.		*The sound that plays when the weapon initially starts firing.
	*Does not work for turrets.		*Does not work for turrets.
	*Syntax: '''''Integer''''' or '''''String''''', 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 1,009:		Line 1,009:
	{{Table240\|		{{Table240\|
	===$LoopFiringSnd:===		===$LoopFiringSnd:===
	*The sound that plays while the ~~user~~ is firing ~~the weapon and is holding the trigger down~~.		*The sound that plays while the weapon is firing.
	*Does not work for turrets.		*Does not work for turrets.
	*Syntax: '''''Integer''''' or '''''String''''', 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]]
			**Note: This must be a 3d sound.}}

	{{Table240\|		{{Table240\|
	===$EndFiringSnd:===		===$EndFiringSnd:===
	*The sound that plays when the ~~user releases the trigger while this~~ weapon ~~is equipped~~.		*The sound that plays when the weapon stops firing.
	*Does not work for turrets.		*Does not work for turrets.
	*Syntax: '''''Integer''''' or '''''String''''', 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]]}}

Asteroth at 16:35, 18 January 2026

2026-01-18T16:35:18Z

← Older revision		Revision as of 16:35, 18 January 2026
Line 1,646:		Line 1,646:
	**Defines the maximum range where the beam still has any effect.		**Defines the maximum range where the beam still has any effect.
	**Syntax: '''''Float''''', meters		**Syntax: '''''Float''''', meters
			***Default: 30000
	*'''+Attenuation:'''		*'''+Attenuation:'''
	**Defines the point where the damage caused by the beam starts to attenuate. At maximum range damage is zero.		**Defines the point where the damage caused by the beam starts to attenuate. At maximum range damage is zero.

-Joshua-: Small typo corrections.

2025-12-30T17:39:28Z

Small typo corrections.

← Older revision		Revision as of 17:39, 30 December 2025
Line 1,786:		Line 1,786:
	***'''END POSITION BEFORE OFFSET''', as above but for the end position.		***'''END POSITION BEFORE OFFSET''', as above but for the end position.
	***'''CENTER''', the beam will be rotated about the center of the target.		***'''CENTER''', the beam will be rotated about the center of the target.
	*'''Per Burst Rotation:'''		*'''+Per Burst Rotation:'''
	**Will rotate the final start and end positions, possibly in addition to the burst rotation pattern, for each burst of the beam, or every shot if not a burst weapon.		**Will rotate the final start and end positions, possibly in addition to the burst rotation pattern, for each burst of the beam, or every shot if not a burst weapon.
	**If this value is '''''negative''''' this will instead be treated as a random amount of rotation.		**If this value is '''''negative''''' this will instead be treated as a random amount of rotation.
Line 1,795:		Line 1,795:
	***'''END POSITION BEFORE OFFSET''', as above but for the end position.		***'''END POSITION BEFORE OFFSET''', as above but for the end position.
	***'''START POSITION AFTER OFFSET''', the beam will be rotated about the final start position after offset and randomness have been applied.		***'''START POSITION AFTER OFFSET''', the beam will be rotated about the final start position after offset and randomness have been applied.
	***'''END POSITION ~~BEFORE~~ OFFSET''', as above but for the end position.		***'''END POSITION AFTER OFFSET''', as above but for the end position.
	***'''CENTER''', the beam will be rotated about the center of the target.		***'''CENTER''', the beam will be rotated about the center of the target.
	}}		}}

Asteroth at 15:14, 8 October 2025

2025-10-08T15:14:02Z

← Older revision		Revision as of 15:14, 8 October 2025
Line 1,817:		Line 1,817:
	**'''burst shares random target''', all shots from this beam weapon in the same burst will target the same random point (or slash direction)		**'''burst shares random target''', all shots from this beam weapon in the same burst will target the same random point (or slash direction)
	**'''track own texture tiling''', the 'U' position of the beam texture, whose speed is set by '''+Translation:''' below, is tracked independently, rather than being shared among all beams like normal.		**'''track own texture tiling''', the 'U' position of the beam texture, whose speed is set by '''+Translation:''' below, is tracked independently, rather than being shared among all beams like normal.
			}}
			{{Table250\|
			**'''direct fire lead target''', if the beam is direct fire (type 0), makes the beam aim for the target's predicted position when the beam initially starts warming up, allowing the target to 'dodge' the beam.
	}}		}}

Lafiel: /* $BeamInfo: */

2025-09-01T23:47:08Z

$BeamInfo:

← Older revision		Revision as of 23:47, 1 September 2025
Line 1,801:		Line 1,801:
	*'''+Firing Length Effect:'''		*'''+Firing Length Effect:'''
	*Specifies the [[Particle Effects\|particle effect]] which will be created along the entire active length of the beam while it is firing and active.		*Specifies the [[Particle Effects\|particle effect]] which will be created along the entire active length of the beam while it is firing and active.
	*Note that the +Number for the effect used will be ''per kilometer of length''.		*Note that the <tt>+Particle Count Per Spawn:</tt> (or <tt>+Number:</tt> for legacy particles) for the effect used will be ''per kilometer of length''.
	*[[Particle Effects#+Parent Velocity Factor:\|Parent Velocity Factor]] also works, inheriting the [[#$Velocity:\|Velocity]] of this weapon.		*[[Particle Effects#+Parent Velocity Factor:\|Parent Velocity Factor]] also works, inheriting the [[#$Velocity:\|Velocity]] of this weapon.
	*Syntax: '''String''', the particle effect name		*Syntax: '''String''', the particle effect name