Difference between revisions of "Asteroid.tbl"

From FreeSpace Wiki
Jump to: navigation, search
m (updated version info)
m
(8 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Revision information.. <!-- Please update this information when page is updated -->
+
{{TableVersion|5264}}
::'''3.6.x branch:''' 2.35.2.11
 
::'''3.7 branch:''' 2.46
 
  
 +
The '''asteroid.tbl''' is used to define all of the asteroids and debris field pieces in-game.
 +
 +
 +
[[Tables|List of Tables]]
  
 
==General Format==
 
==General Format==
*Asteroid.tbl is used to define all asteroids and debris pieces in-game.
 
 
*'''#Asteroid Types'''
 
*'''#Asteroid Types'''
 
*Asteroid and debris data
 
*Asteroid and debris data
Line 34: Line 35:
  
 
===$POF file2:===
 
===$POF file2:===
 +
*'''''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
 
*Syntax: '''String.pof''' or '''none''', filename
 
*Syntax: '''String.pof''' or '''none''', filename
Line 39: Line 41:
  
 
===$POF file3:===
 
===$POF file3:===
 +
*'''''Note: This does not work for debris chunks. The game will always only use POF file1.'''''
 
*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
Line 56: Line 59:
  
 
===$Damage Type:===
 
===$Damage Type:===
{{Table36|
+
{{Table3610|
 
*Defines the damage type of the asteroid explosion. '''REQUIRES ADDITIONAL TABLE FILE'''.
 
*Defines the damage type of the asteroid explosion. '''REQUIRES ADDITIONAL TABLE FILE'''.
 
*Syntax: '''String''', name of the damage type as referenced in [[armor.tbl]]}}
 
*Syntax: '''String''', name of the damage type as referenced in [[armor.tbl]]}}
  
{{Table37|
+
 
*3.7 branch lacks '''$Damage Type:''' option}}
+
===$Explosion Animations:===
 +
{{Table3615|
 +
*Defines the explosion animations used for the asteroid.
 +
*Syntax: '''''Integer list''''', indices to fireballs defined in fireball.tbl}}
 +
 
 +
 
 +
===$Explosion Radius Mult:===
 +
{{Table3615|
 +
*Defines the radius multiplier for the explosion fireballs, with a value of 1.0 causing the radius of the fireball to be equal to the radius of the asteroid. Defaults to 1.5 for large asteroids and 1.0 for others.
 +
*Syntax: '''''Float'''''}}
  
  
Line 87: Line 99:
 
*Defines the hitpoints of the asteroid or debris piece. Hitpoints are modified downward by skill level.
 
*Defines the hitpoints of the asteroid or debris piece. Hitpoints are modified downward by skill level.
 
*Syntax: '''Float''', hitpoints
 
*Syntax: '''Float''', hitpoints
 +
 +
 +
===$Split:===
 +
{{Table3615|
 +
*Defines what kind of asteroids this type of asteroid should split into when destroyed. You may define any number of $Split rules.
 +
*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'''}}
 +
  
  

Revision as of 03:57, 19 July 2012

Revision information.....

FSO Revision: 5264
Note: Please update the version when the page is updated. If your edit had nothing to do with new code entries then please do not edit the version


The asteroid.tbl is used to define all of the asteroids and debris field pieces in-game.


List of Tables

General Format

  • #Asteroid Types
  • Asteroid and debris data
  • #End
  • $Impact Explosion:
    • Defines the effect used when weapon strikes at asteroid
    • Syntax: Filename
  • $Impact Explosion Radius:
    • Defines the radius of the effect
    • Syntax: Value, (meters)


Asteroid and Debris Data

  • Used to define asteroid types and their physical characteristics
  • First three entries are different sized asteroids, small medium and large respectively
  • Next three are debris pieces for the 1st species in the species_defs.tbl
  • And so on in series of three


$Name:

  • Defines the name of asteroid or debris object


$POF file1:

  • Defines the name of the model file (.pof) used for asteroid or debris model
  • Syntax: String.pof, filename


$POF file2:

  • 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
  • Syntax: String.pof or none, filename


$POF file3:

  • Note: This does not work for debris chunks. The game will always only use POF file1.
  • 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
  • Syntax: String.pof or none, filename


$Detail distance:

  • Definies the distance where the change between different Levels-Of-Details (LODs) occurs
  • Syntax: ( Integer list ), comma separated integers, one for each LOD
    • Example: (0, 30, 80, 150)


$Max Speed:

  • Defines the maximum velocity of the asteroid
  • Syntax: Float, meters per second


$Damage Type:

FS2 Open 3.6.10:
  • Defines the damage type of the asteroid explosion. REQUIRES ADDITIONAL TABLE FILE.
  • Syntax: String, name of the damage type as referenced in armor.tbl


$Explosion Animations:

FS2 Open, 3.6.16:
  • Defines the explosion animations used for the asteroid.
  • Syntax: Integer list, indices to fireballs defined in fireball.tbl


$Explosion Radius Mult:

FS2 Open, 3.6.16:
  • Defines the radius multiplier for the explosion fireballs, with a value of 1.0 causing the radius of the fireball to be equal to the radius of the asteroid. Defaults to 1.5 for large asteroids and 1.0 for others.
  • Syntax: Float


$Expl inner rad:

  • Radius at which the full explosion damage is done
  • Syntax: Float, meters


$Expl outer rad:

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


$Expl damage:

  • Amount of damage done inside the inner radius
  • Syntax: Float, damage


$Expl blast:

  • The intensity of the blast effect when you're within the outer radius
  • Syntax: Float, blast effect


$Hitpoints:

  • Defines the hitpoints of the asteroid or debris piece. Hitpoints are modified downward by skill level.
  • Syntax: Float, hitpoints


$Split:

FS2 Open, 3.6.16:
  • Defines what kind of asteroids this type of asteroid should split into when destroyed. You may define any number of $Split rules.
  • 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


Sample

  • Single asteroid entry fos retail FS2 table
#Asteroid Types

$Name:               Small Asteroid
$POF file1:          ast03.pof
$POF file2:          asta03.pof
$POF file3:          astb03.pof
$Detail distance:    (0, 30, 80, 150)
$Max Speed:          60.0
$Expl inner rad:     0.0
$Expl outer rad:     0.0
$Expl damage:        0.0
$Expl blast:         0.0
$Hitpoints:          23

#End

$Impact Explosion:            ExpMissilehit1
$Impact Explosion Radius:     20.0