Asteroid.tbl - Revision history

Kestrellius at 01:53, 11 November 2026

2026-11-11T01:53:03Z

← Older revision		Revision as of 01:53, 11 November 2026
Line 1:		Line 1:
	{{~~TableVersion~~\|~~5264~~}}		{{TableVersionGit\|2025-08-23\|1207dfc}}
	{{Tables}}		{{Tables}}
	The '''asteroid.tbl''' is used to define all of the asteroids and debris field pieces in-game.		The '''asteroid.tbl''' is used to define all of the asteroids and debris field pieces in-game.
Line 93:		Line 93:
	*Syntax: '''String''', name of the damage type as referenced in [[armor.tbl]]}}		*Syntax: '''String''', name of the damage type as referenced in [[armor.tbl]]}}

			{{Table250\|
			===$Explosion Effect:===
			*Defines the [[Particle Effects\|particle effect]] for this asteroid's explosion.
			*'''If this is specified then $Explosion Animations and $Explosion Radius Mult are not valid!
			*Syntax: '''String''', name of effect
			}}

	===$Explosion Animations:===		===$Explosion Animations:===

Kestrellius: /* General Format */

2026-11-11T01:49:29Z

General Format

← Older revision		Revision as of 01:49, 11 November 2026
Line 11:		Line 11:
	{{Table250\|		{{Table250\|
	*'''$Impact Explosion Effect:'''		*'''$Impact Explosion Effect:'''
	*Specifies the [[Particle Effects\|particle effect]] which will be used for impacts of this ~~weapon~~.		*Specifies the [[Particle Effects\|particle effect]] which will be used for weapon impacts against this asteroid.
	*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!
	}}		}}
	*'''$Impact Explosion:'''		*'''$Impact Explosion:'''
	**Defines the effect used when weapon strikes at asteroid		**Defines the effect used when a weapon strikes this asteroid
	**Syntax: ''Filename''		**Syntax: ''Filename''
	*'''$Impact Explosion Radius:'''		*'''$Impact Explosion Radius:'''
	**Defines the radius of the effect		**Defines the radius of the effect
	**Syntax: ''Value'', (meters)		**Syntax: ''Value'', (meters)


	==Asteroid and Debris Data==		==Asteroid and Debris Data==

Goober5000: /* $Expl blast: */ clarify blast

2026-02-01T17:31:10Z

$Expl blast:: clarify blast

← Older revision		Revision as of 17:31, 1 February 2026
Line 123:		Line 123:

	===$Expl blast:===		===$Expl blast:===
	*The intensity of the blast effect when you're within the outer radius		*The intensity of the blast effect (impulse, aka change in momentum) when you're within the outer radius
	*Syntax: '''Float''', blast effect		*Syntax: '''Float''', blast effect


	===$Hitpoints:===		===$Hitpoints:===

Lafiel: Add particle effects

2025-07-09T08:15:17Z

Add particle effects

← Older revision		Revision as of 08:15, 9 July 2025
Line 9:		Line 9:
	*Asteroid and debris data		*Asteroid and debris data
	*'''#End'''		*'''#End'''
			{{Table250\|
			*'''$Impact Explosion Effect:'''
			*Specifies the [[Particle Effects\|particle effect]] which will be used for impacts of this weapon.
			*Syntax: '''String''', the particle effect name
			*If this option is specified then ''$Impact Explosion'' and ''$Impact Explosion Radius'' are not valid options!
			}}
	*'''$Impact Explosion:'''		*'''$Impact Explosion:'''
	**Defines the effect used when weapon strikes at asteroid		**Defines the effect used when weapon strikes at asteroid

Goober5000: /* $Rotational Velocity Multiplier: */ fix typo

2023-11-19T04:54:44Z

$Rotational Velocity Multiplier:: fix typo

← Older revision		Revision as of 04:54, 19 November 2023
Line 79:		Line 79:

	===$Rotational Velocity Multiplier:===		===$Rotational Velocity Multiplier:===
	{{~~Table224~~\|		{{Table234\|
	Defines the value that randomized rotational velocity is multiplied by. For each spawned asteroid/debris object FSO first calculates a random normalized vector. Then it calculates a rotational value with the formula 'value of $Rotational Velocity Multiplier: (frand()/4.0f + 0.1f)'.		Defines the value that randomized rotational velocity is multiplied by. For each spawned asteroid/debris object FSO first calculates a random normalized vector. Then it calculates a rotational value with the formula 'value of $Rotational Velocity Multiplier: (frand()/4.0f + 0.1f)'.
	*Syntax: '''Float''', multiplier value}}		*Syntax: '''Float''', multiplier value}}


	===$Damage Type:===		===$Damage Type:===

Wookieejedi: add vel multiplier

2023-11-14T18:23:30Z

add vel multiplier

← Older revision		Revision as of 18:23, 14 November 2023
Line 76:		Line 76:
	*Defines the maximum velocity of the asteroid		*Defines the maximum velocity of the asteroid
	*Syntax: '''Float''', meters per second		*Syntax: '''Float''', meters per second


			===$Rotational Velocity Multiplier:===
			{{Table224\|
			Defines the value that randomized rotational velocity is multiplied by. For each spawned asteroid/debris object FSO first calculates a random normalized vector. Then it calculates a rotational value with the formula 'value of $Rotational Velocity Multiplier: (frand()/4.0f + 0.1f)'.
			*Syntax: '''Float''', multiplier value}}

MjnMixael: /* $Split: */ Fix link again

2022-12-12T01:09:54Z

$Split:: Fix link again

← Older revision		Revision as of 01:09, 12 December 2022
Line 125:		Line 125:
	*Defines what kind of asteroids this type of asteroid should split into when destroyed. You may define any number of $Split rules.		*Defines what kind of asteroids this type of asteroid should split into when destroyed. You may define any number of $Split rules.
	{{Table224\|		{{Table224\|
	*Semi-deprecated; still works but prefer [[Asteroid.tbl#$Split_Name\|$Split Name]] instead, especially if using modular tables.}}		*Semi-deprecated; still works but prefer [[Asteroid.tbl#$Split_Name:\|$Split Name]] instead, especially if using modular tables.}}
	*Syntax: '''Integer''', an asteroid index. The first asteroid defined by the table has index 0, the second one has index 1, and so on.		*Syntax: '''Integer''', an asteroid index. The first asteroid defined by the table has index 0, the second one has index 1, and so on.
	*'''+Min:'''		*'''+Min:'''

MjnMixael: /* $Split: */ fix link

2022-12-12T01:09:27Z

$Split:: fix link

← Older revision		Revision as of 01:09, 12 December 2022
Line 125:		Line 125:
	*Defines what kind of asteroids this type of asteroid should split into when destroyed. You may define any number of $Split rules.		*Defines what kind of asteroids this type of asteroid should split into when destroyed. You may define any number of $Split rules.
	{{Table224\|		{{Table224\|
	*Semi-deprecated; still works but prefer [[Asteroid.tbl#$Split Name~~\|$Split_Name~~]] instead, especially if using modular tables.}}		*Semi-deprecated; still works but prefer [[Asteroid.tbl#$Split_Name\|$Split Name]] instead, especially if using modular tables.}}
	*Syntax: '''Integer''', an asteroid index. The first asteroid defined by the table has index 0, the second one has index 1, and so on.		*Syntax: '''Integer''', an asteroid index. The first asteroid defined by the table has index 0, the second one has index 1, and so on.
	*'''+Min:'''		*'''+Min:'''
Line 133:		Line 133:
	**The maximum number of spawned asteroids. Default 0.		**The maximum number of spawned asteroids. Default 0.
	**Syntax: '''Integer'''}}		**Syntax: '''Integer'''}}


	===$Split Name:===		===$Split Name:===

MjnMixael: Document new features

2022-12-12T01:06:28Z

Document new features

← Older revision		Revision as of 01:06, 12 December 2022
Line 2:		Line 2:
	{{Tables}}		{{Tables}}
	The '''asteroid.tbl''' is used to define all of the asteroids and debris field pieces in-game.		The '''asteroid.tbl''' is used to define all of the asteroids and debris field pieces in-game.

			This table is one of the [[Modular Tables]] and can be extended with xxx-ast.tbm

	==General Format==		==General Format==
Line 21:		Line 23:
	{{Table212\|The following is no longer required. As many or as few 'special' asteroids can be defined as desired.}}		{{Table212\|The following is no longer required. As many or as few 'special' asteroids can be defined as desired.}}
	*Then, each species requires 3 asteroids (retail used these for debris-type asteroids)		*Then, each species requires 3 asteroids (retail used these for debris-type asteroids)
			{{Table224\|The following is only true if [[Asteroid.tbl#$Type:\|$Type]] is not defined.}}
	*The first 3 correspond to the 1st species in the [[species_defs.tbl]], the second to the next 3, etc.		*The first 3 correspond to the 1st species in the [[species_defs.tbl]], the second to the next 3, etc.

Line 26:		Line 29:
	===$Name:===		===$Name:===
	*Defines the name of asteroid or debris object. Does NOT need to be unique.		*Defines the name of asteroid or debris object. Does NOT need to be unique.
			{{Table224\|Name should be unique}}
	*This will be used as the name in the targeting box when targeted, unless the name is "[Any species] Debris #", where it will be displayed as "[Species] debris".		*This will be used as the name in the targeting box when targeted, unless the name is "[Any species] Debris #", where it will be displayed as "[Species] debris".


			===$Display Name:===
			{{Table224\|
			*Defines the text that will be used in the targetbox for this asteroid. Only used for debris type asteroids.
			*Syntax: '''String'''}}


			===$Type:===
			{{Table224\|
			*Defines the type of asteroid this is.
			*Syntax: '''Integer''' 1 for small asteroid, 2 for medium asteroid, 3 for large asteroid, -1 for debris}}


Line 37:		Line 53:
	*'''''Note: This does not work for debris chunks. The game will always only use POF file1.'''''		*'''''Note: This does not work for debris chunks. The game will always only use POF file1.'''''
	*Defines the name of the alternate asteroid or debris model of the set size		*Defines the name of the alternate asteroid or debris model of the set size
			{{Table224\|
			*Required for asteroid types, ignored otherwise}}
	*Syntax: '''String.pof''' or '''none''', filename		*Syntax: '''String.pof''' or '''none''', filename

Line 44:		Line 62:
	*Defines the name of the alternate asteroid model		*Defines the name of the alternate asteroid model
	*If the object in question is has '''$POF file2:''' set as ''none'' then this entry is not needed		*If the object in question is has '''$POF file2:''' set as ''none'' then this entry is not needed
			{{Table224\|
			*Required for asteroid types, ignored otherwise}}
	*Syntax: '''String.pof''' or '''none''', filename		*Syntax: '''String.pof''' or '''none''', filename

Line 104:		Line 124:
	{{Table3615\|		{{Table3615\|
	*Defines what kind of asteroids this type of asteroid should split into when destroyed. You may define any number of $Split rules.		*Defines what kind of asteroids this type of asteroid should split into when destroyed. You may define any number of $Split rules.
			{{Table224\|
			*Semi-deprecated; still works but prefer [[Asteroid.tbl#$Split Name\|$Split_Name]] instead, especially if using modular tables.}}
	*Syntax: '''Integer''', an asteroid index. The first asteroid defined by the table has index 0, the second one has index 1, and so on.		*Syntax: '''Integer''', an asteroid index. The first asteroid defined by the table has index 0, the second one has index 1, and so on.
			*'''+Min:'''
			**The minimum number of spawned asteroids. Default 0.
			**Syntax: '''Integer'''
			*'''+Max:'''
			**The maximum number of spawned asteroids. Default 0.
			**Syntax: '''Integer'''}}


			===$Split Name:===
			{{Table224\|
			*Defines what kind of asteroids this type of asteroid should split into when destroyed. You may define any number of $Split rules.
			*Syntax: '''String''', an asteroid name.
	*'''+Min:'''		*'''+Min:'''
	**The minimum number of spawned asteroids. Default 0.		**The minimum number of spawned asteroids. Default 0.
Line 116:		Line 150:
	{{Table212\|		{{Table212\|
	*Defines the relative frequency among other asteroids in the field to be spawned. The total number of asteroids is unchanged, but an asteroid with twice the Spawn weight of another will appear twice as frequently as it.		*Defines the relative frequency among other asteroids in the field to be spawned. The total number of asteroids is unchanged, but an asteroid with twice the Spawn weight of another will appear twice as frequently as it.
	*Only used by '~~special~~' asteroids ~~(not the first 3)~~		*Only used by 'debris' asteroids
	*The default is based on its position in the list:		*The default is based on its position in the list:
	**4, 7, 10 etc have a weight of 1.		**4, 7, 10 etc have a weight of 1.

Asteroth: /* $Spawn Weight: */

2021-06-08T03:39:10Z

$Spawn Weight:

← Older revision		Revision as of 03:39, 8 June 2021
Line 121:		Line 121:
	**5, 8, 11, etc have a weight of 4.		**5, 8, 11, etc have a weight of 4.
	**6, 9, 12, etc have a weight of 8.		**6, 9, 12, etc have a weight of 8.
	**Syntax: '''Float''', positive}}		*Syntax: '''Float''', positive}}

	==Sample==		==Sample==