Difference between revisions of "FS2 Data Structure"
From FreeSpace Wiki
(→Introduction) |
|||
| Line 8: | Line 8: | ||
Like all your applications you'll have Freespace 2 installed in one folder in your hard drive. We will call this folder '''/freespace2''', although it can have any other name (''/fs2'', ''/fspace2'', or whatever). Inside this folder, Freespace 2 stores all its game data in three places: | Like all your applications you'll have Freespace 2 installed in one folder in your hard drive. We will call this folder '''/freespace2''', although it can have any other name (''/fs2'', ''/fspace2'', or whatever). Inside this folder, Freespace 2 stores all its game data in three places: | ||
*Unpacked, ie. individual files, inside '''data''' folder within Freespace 2 installation folder, ie. in '''/freespace2/data'''. ('''data''' name is compulsory).<br>Inside '''data''' folder, the game contents are classified and stored in several subfolders. [[FS2_Data_Structure#data_subfolders|Below]], you have the full list of data subfolders with their description and contents, (remember that all their names are compulsory). The most commonly used are: | *Unpacked, ie. individual files, inside '''data''' folder within Freespace 2 installation folder, ie. in '''/freespace2/data'''. ('''data''' name is compulsory).<br>Inside '''data''' folder, the game contents are classified and stored in several subfolders. [[FS2_Data_Structure#data_subfolders|Below]], you have the full list of data subfolders with their description and contents, (remember that all their names are compulsory). The most commonly used are: | ||
| − | **[[FS2_Data_Structure#effects|effects]] | + | **[[FS2_Data_Structure#effects|effects]] contains all the textures and animations used in all explosions, weapon glows, smoke, particles and so on. |
| − | **[[FS2_Data_Structure#maps|maps]] | + | **[[FS2_Data_Structure#maps|maps]] contains all the textures, (and animated textures), used over ship models. |
| − | **[[FS2_Data_Structure#missions|missions]] | + | **[[FS2_Data_Structure#missions|missions]] contains all the mission ([[%2A.FS2]]) and campaign ([[%2A.FC2]]) definition files. |
| − | **[[FS2_Data_Structure#models|models]] | + | **[[FS2_Data_Structure#models|models]] contains all 3D models ([[%2A.POF]]). |
| − | **[[FS2_Data_Structure#music|music]] | + | **[[FS2_Data_Structure#music|music]] contains all the music files. |
| − | **[[FS2_Data_Structure#sounds|sounds]] | + | **[[FS2_Data_Structure#sounds|sounds]] contains all ingame sound effect files. |
| − | **[[FS2_Data_Structure#tables|tables]] | + | **[[FS2_Data_Structure#tables|tables]] contains all table files. Table files define all the behaviour the game components have. They are the most important thing for modders to know. See [[Tables]] section for deeper info. |
| − | **[[FS2_Data_Structure#voice|voice]] | + | **[[FS2_Data_Structure#voice|voice]] contains all the ingame voices. |
| − | *Packed in vp archives data holders. This kind of archives just contain individual files in a similar way as "normal" archives like rar or zip do. They are placed in '''/freespace2''' folder. Special software, like vpmage, is needed to build them.<br>vp archives also follow the data structure, so, even while packed in a vp archive, your missions will be in /data/missions and your ship 3D models in /data/models. | + | *Packed in vp archives data holders. This kind of archives just contain individual files in a similar way as "normal" archives like rar or zip do. They are placed in '''/freespace2''' folder. Special software, like vpmage, is needed to build them.<br>vp archives also follow the data structure, so, even while packed in a vp archive, your missions will be in /data/missions and your ship 3D models in /data/models. All retail data come packed in several vps. The next, and only the next, are the original game contents (when patched to v1.2): |
| + | **root_fs2.vp | ||
| + | **smarty_fs2.vp | ||
| + | **sparky_fs2.vp | ||
| + | **sparky_hi_fs2.vp | ||
| + | **stu_fs2.vp | ||
| + | **tango1_fs2.vp | ||
| + | **tango2_fs2.vp | ||
| + | **tango3_fs2.vp | ||
| + | **warble_fs2.vp | ||
*<font color=red>'''SCP fs2_open addition:''' Auxiliary data folders loaded through [[Command-Line_Reference#-mod|-MOD launcher flag]]. Retail version only use both former places. But fs2_open, (and FRED2_open), can use any other auxiliary folder to contain game data. This feature allows using several different mods without having undesired cross-effects. More important info about this feature and about loading priority can be found in [[Command-Line_Reference#-mod|-MOD launcher flag help]].</font> | *<font color=red>'''SCP fs2_open addition:''' Auxiliary data folders loaded through [[Command-Line_Reference#-mod|-MOD launcher flag]]. Retail version only use both former places. But fs2_open, (and FRED2_open), can use any other auxiliary folder to contain game data. This feature allows using several different mods without having undesired cross-effects. More important info about this feature and about loading priority can be found in [[Command-Line_Reference#-mod|-MOD launcher flag help]].</font> | ||
| − | |||
==data subfolders== | ==data subfolders== | ||
Revision as of 15:59, 27 May 2007
WARNING: THIS PAGE IS FULLY UNDER DEVELOPMENT !!
Contents
Introduction
Apart from the game engine (the game executable), or mission editor (FRED), the game needs data to run; it needs missions, sounds, 3D models, textures... Freespace2 is highly moddable because nearly none of this data is embedded inside the game executable. In this way the user can always change nearly all game data.
Like all your applications you'll have Freespace 2 installed in one folder in your hard drive. We will call this folder /freespace2, although it can have any other name (/fs2, /fspace2, or whatever). Inside this folder, Freespace 2 stores all its game data in three places:
- Unpacked, ie. individual files, inside data folder within Freespace 2 installation folder, ie. in /freespace2/data. (data name is compulsory).
Inside data folder, the game contents are classified and stored in several subfolders. Below, you have the full list of data subfolders with their description and contents, (remember that all their names are compulsory). The most commonly used are:- effects contains all the textures and animations used in all explosions, weapon glows, smoke, particles and so on.
- maps contains all the textures, (and animated textures), used over ship models.
- missions contains all the mission (*.FS2) and campaign (*.FC2) definition files.
- models contains all 3D models (*.POF).
- music contains all the music files.
- sounds contains all ingame sound effect files.
- tables contains all table files. Table files define all the behaviour the game components have. They are the most important thing for modders to know. See Tables section for deeper info.
- voice contains all the ingame voices.
- Packed in vp archives data holders. This kind of archives just contain individual files in a similar way as "normal" archives like rar or zip do. They are placed in /freespace2 folder. Special software, like vpmage, is needed to build them.
vp archives also follow the data structure, so, even while packed in a vp archive, your missions will be in /data/missions and your ship 3D models in /data/models. All retail data come packed in several vps. The next, and only the next, are the original game contents (when patched to v1.2):- root_fs2.vp
- smarty_fs2.vp
- sparky_fs2.vp
- sparky_hi_fs2.vp
- stu_fs2.vp
- tango1_fs2.vp
- tango2_fs2.vp
- tango3_fs2.vp
- warble_fs2.vp
- SCP fs2_open addition: Auxiliary data folders loaded through -MOD launcher flag. Retail version only use both former places. But fs2_open, (and FRED2_open), can use any other auxiliary folder to contain game data. This feature allows using several different mods without having undesired cross-effects. More important info about this feature and about loading priority can be found in -MOD launcher flag help.
