Modular Tables

Modular tables are SCP addition to the standard FreeSpace table system. XMTs (or eXtentable Modular Tables) offer capability to add new entries or alter already existing tables without any need of editing the 'parent' table file.

Extendable Tables

• ai_profiles.tbl can be extended with xxx-aip.tbm (XMT)
• armor.tbl can be extended with xxx-amr.tbm (non-XMT)
• hud_gauges.tbl can be extended with xxx-hdg.tbm (non-XMT)
• mflash.tbl can be extended with xxx-mfl.tbm (non-XMT)
• music.tbl can be extended with xxx-mus.tbm (non-XMT)
• objecttypes.tbl can be extended with xxx-obt.tbm (XMT)
• scripting.tbl can be extended with xxx-sct.tbm
• ships.tbl can be extended with xxx-shp.tbm (XMT)
• species_defs.tbl can be extended with xxx-sdf.tbm (XMT)
• stars.tbl can be extended with xxx-str.tbm (non-XMT)
• weapons.tbl can be extended with xxx-wep.tbm (XMT)
• weapon_expl.tbl can be extended with xxx-wxp.tbm (non-XMT)

Other Related Tables

• fireball.tbl can be edited with xxx-fbl.tbm file (special)

Important Notes

• Modular table files should use the 'parent table' files sections.
• Completely new entries and also complete rewrites of entries in parent table file are always possible.
• For xxx-shp.tbm and xxx-wep.tbm
  • Table entries in modular tables do not have to be complete. Partial entries can be used to alter the data found in parent table files when only some changes to the original are desired to be made.
  • Adding +nocreate right after the entry's name prevents possible creation of partially undefined entry. For example if the parent table file lacked the entry that was included to the as a partial entry to the modular table file then the creation of partially undefined entry is possible which could cause problems with the game.
    • Example:

  $Name:              @Subach HL-7
     +nocreate

Sample - Alpha-wep.tbm

• Changes the speed of the Subach HL-7 and also adds a faint grey trail to it.
• To create it make a text file using a text editor and save the file as Alpha-wep.tbm with the following contents to the proper folder (.../data/tables).

  #Primary Weapons
  $Name:              @Subach HL-7
     +nocreate
  $Velocity:         650.0	
  $Trail:
     +Start Width:      0.4
     +End Width:        0.0
     +Start Alpha:      0.35
     +End Alpha:        0.0
     +Max Life:         0.2
     +Bitmap:           Contrail
  #End