Tables

Tables are the major data files in FreeSpace and FreeSpace 2. Compared with many other games, they are highly intuitive and easy to edit, requiring no special tools other than notepad. For more detail on specific tables, see the links below.

Full list of tables can be found in Category:Tables page.
In-depth modular tables info can be found in Modular Tables page.

Table files

Tables files and related code files
Ai.tbl	/ai/aicode.cpp
Ai_profiles.tbl	/ai/ai_profiles.cpp
Armor.tbl	/ship/ship.cpp
Asteroid.tbl	/asteroid/asteroid.cpp
Autopilot.tbl	/autopilot/autopilot.cpp
Credits.tbl	/menuui/credits.cpp
Cutscenes.tbl	/cutscene/cutscenes.cpp
Fireball.tbl	/fireball/fireballs.cpp
Help.tbl	/gamehelp/contexthelp.cpp
Hud.tbl
Hud_gauges.tbl	/hud/hudparse.cpp
Icons.tbl	/missions/missionbriefcommon.cpp
Iff_defs.tbl	/iff_defs/iff_defs.cpp
Lightning.tbl	/nebula/neblightning.cpp
Mainhall.tbl	/menuui/mainhallmenu.cpp
Medals.tbl	/stats/medals.cpp
Menu.tbl	/menuui/snazzyui.cpp
Messages.tbl	/mission/missionmessage.cpp
Mflash.tbl	/weapon/muzzleflash.cpp
Music.tbl	/gamesnd/eventmusic.cpp
Nebula.tbl	/nebula/neb.cpp
Objecttypes.tbl	/ship/ship.cpp
Rank.tbl	/stats/scoring.cpp
Scripting.tbl	/parse/scripting.cpp
Ships.tbl	/ship/ship.cpp
Sounds.tbl	/gamesnd/gamesnd.cpp
Species_defs.tbl	/species_defs/species_defs.cpp
Species.tbl	/menuui/techmenu.cpp
Ssm.tbl	/hud/hudartillery.cpp
Stars.tbl	/starfield/starfield.cpp
Strings.tbl	/localization/localize.cpp
Tips.tbl	/menuui/playermenu.cpp
Traitor.tbl	/missionui/missiondebrief.cpp
Tstrings.tbl	/localization/localize.cpp
Weapon_expl.tbl	/weapon/weapons.cpp
Weapons.tbl	/weapon/weapons.cpp

In general tables files are simple unformatted text files

.tbl files

These files are the basic FreeSpace table used for defining various aspects of the game. Game reads only single .tbl choosing the one it encounters first while parsing the game directories.

.tbm files

These files are Modular Tables files. They can be used for adding content to the 'base' tables or to modify the data from those files.

For usage info and important notes, see Modular Tables.

Notes of certain table files

Hardcoded table files

Some of the table files are not actually required as the basic version has been written directly to the code. However these can be overridden by table files present in game directories.

These files are not present in standard FreeSpace 2 .vp files

Species_defs.tbl
Objecttypes.tbl
iff_defs.tbl

Optional table files

Certain tables are not found from the code nor do they belong to the basic table set. These tables are parsed if game detects them

These files are not present in standard FreeSpace 2 .vp files

Armor.tbl Scripting.tbl

Important notes

Table entries must be ordered

• As a general rule, all the table entries must be ordered.
• Keep the order shown in the following help sections for each table in both normal tables (tbl files) and Modular Tables (tbm files). If you don't do it, you can get parser errors on FS2 or FRED2 loading when they are reading them.

Brief descriptions of table files

• Asterisks (*) denote a table added for Freespace 2. These are not required by FS1.
• Plus signs (⁺) denote a table added by the Source Code Project. These are not required by retail FS2
• In all the tables help pages, SCP added entries are usually marked with red font, (unless the whole table is an addition).
• For full list and links see Category:Tables

ai.tbl - Defines a small subset of the AI behavior.
ai_profiles.tbl⁺ - Defines extended options for AI behavior. AI profiles can be specified on a per-mission basis.
armor.tbl⁺ - Defines the behaviour of ship armor.
iff_defs.tbl⁺ - Defines IFF. New IFFs can be specified, with different behaviors for each.
ships.tbl - Defines the statistics of ships in-game.
species_defs.tbl⁺ - Defines characteristics of ships belonging to each species.
weapons.tbl - Defines the statistics of weapons in-game.