Difference between revisions of "Documentation/Engine/Game data"

From SCS Modding Wiki
Jump to navigation Jump to search
(Root game folder)
(Root game folder)
Line 7: Line 7:
 
Root game folder consists of:
 
Root game folder consists of:
 
<div class="folder_structure">
 
<div class="folder_structure">
 
+
{{FileSystemTreeEntry|icon=FST-IconRoot|type=|name=}}
├─{{FileSystemTreeEntry|icon=FST-Folder|type=FST-ReadOnly|name=automat}} - ''Material storage with generated material files produced during conversion of 3D model assets with conversion tools.''
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=FST-ReadOnly|name=automat}} - ''Material storage with generated material files produced during conversion of 3D model assets with conversion tools.''
├─{{FileSystemTreeEntry|icon=FST-Folder|type=FST-ReadOnly|name=contentbrowser}} - ''Folder used by Map Editor content browser TODO: wait for confirmation.''
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=FST-ReadOnly|name=contentbrowser}} - ''Folder used by Map Editor content browser TODO: wait for confirmation.''
├─{{FileSystemTreeEntry|icon=FST-Folder|type=FST-ReadOnly|name=custom}} - ''Legacy folder for storing custom/modded definitions (NOTE: This folder is deprecated and might be removed in the future).''
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=FST-ReadOnly|name=custom}} - ''Legacy folder for storing custom/modded definitions (NOTE: This folder is deprecated and might be removed in the future).''
├─{{FileSystemTreeEntry|icon=FST-Folder|type=|name=def|link=#Definitions}} - ''See: [[#Definitions|Definitions]].''
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=def|link=#Definitions}} - ''See: [[#Definitions|Definitions]].''
├─{{FileSystemTreeEntry|icon=FST-Folder|type=FST-ReadOnly|name=dlc}} - ''Shared models used by dlc such like "dead end" sign.''
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=FST-ReadOnly|name=dlc}} - ''Shared models used by dlc such like "dead end" sign.''
├─{{FileSystemTreeEntry|icon=FST-Folder|type=FST-ReadOnly|name=effect}} - ''Set of compiled shader effects used by game for rendering of any visual element.''
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=FST-ReadOnly|name=effect}} - ''Set of compiled shader effects used by game for rendering of any visual element.''
├─{{FileSystemTreeEntry|icon=FST-Folder|type=|name=font|link=#Fonts}} - ''See: [[#Fonts|Fonts]].''
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=font|link=#Fonts}} - ''See: [[#Fonts|Fonts]].''
├─{{FileSystemTreeEntry|icon=FST-Folder|type=|name=map}} - ''Storage for maps and it's additional data.''
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=map}} - ''Storage for maps and it's additional data.''
├─{{FileSystemTreeEntry|icon=FST-Folder|type=|name=material|link=#Predefined materials}} - ''See: [[#Predefined materials|Predefined materials]].''
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=material|link=#Predefined materials}} - ''See: [[#Predefined materials|Predefined materials]].''
├─{{FileSystemTreeEntry|icon=FST-Folder|type=|name=matlib}} - TODO: wait for confirmation.
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=matlib}} - TODO: wait for confirmation.
├─{{FileSystemTreeEntry|icon=FST-Folder|type=|name=model}} - storage for 1st generation of static map assets.
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=model}} - storage for 1st generation of static map assets.
├─{{FileSystemTreeEntry|icon=FST-Folder|type=|name=model2}} - storage for 2nd generation of static map assets.
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=model2}} - storage for 2nd generation of static map assets.
├─{{FileSystemTreeEntry|icon=FST-Folder|type=|name=prefab}} - storage for 1st generation of prefab map assets.
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=prefab}} - storage for 1st generation of prefab map assets.
├─{{FileSystemTreeEntry|icon=FST-Folder|type=|name=prefab2}} - storage for 2nd generation of prefab map assets.
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=prefab2}} - storage for 2nd generation of prefab map assets.
├─{{FileSystemTreeEntry|icon=FST-Folder|type=|name=road_template}}road_template - road template models for new system of road generation
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=road_template}}road_template - road template models for new system of road generation
├─{{FileSystemTreeEntry|icon=FST-Folder|type=|name=sound|link=#Sounds}} - ''See: [[#Sounds|Sounds]]''.
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=sound|link=#Sounds}} - ''See: [[#Sounds|Sounds]]''.
├─{{FileSystemTreeEntry|icon=FST-Folder|type=FST-ReadOnly|name=system}} - low level engine resources. Shall remain unchanged.
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=FST-ReadOnly|name=system}} - low level engine resources. Shall remain unchanged.
├─{{FileSystemTreeEntry|icon=FST-Folder|type=|name=ui}} - ui dialogs and windows definitions.
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=ui}} - ui dialogs and windows definitions.
 
     ├─ company_manager
 
     ├─ company_manager
 
     ├─ dashboard
 
     ├─ dashboard
Line 33: Line 33:
 
     ├─ options
 
     ├─ options
 
     └─ template
 
     └─ template
├─{{FileSystemTreeEntry|icon=FST-Folder|type=FST-ReadOnly|name=uilab}} - TODO: wait for confirmation.
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=FST-ReadOnly|name=uilab}} - TODO: wait for confirmation.
├─{{FileSystemTreeEntry|icon=FST-Folder|type=|name=unit}}unit - definitions for game predefined hookups spawned in game trough locators, for example: light flare, light sources, no weather areas.
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=unit}}unit - definitions for game predefined hookups spawned in game trough locators, for example: light flare, light sources, no weather areas.
 
     └─ hookup
 
     └─ hookup
├─{{FileSystemTreeEntry|icon=FST-Folder|type=|name=vehicle}} - vehicle models resource files.
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=vehicle}} - vehicle models resource files.
 
     ├─ ai
 
     ├─ ai
 
     ├─ driver
 
     ├─ driver
Line 43: Line 43:
 
     ├─ truck
 
     ├─ truck
 
     └─ wheel
 
     └─ wheel
├─{{FileSystemTreeEntry|icon=FST-Folder|type=FST-ReadOnly|name=video}} - video based animated textures.
+
  ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=FST-ReadOnly|name=video}} - video based animated textures.
├─{{FileSystemTreeEntry|icon=FST-TxtFile|type=FST-ReadOnly|name=autoexec.cfg}} - configuration file which is automatically exectued on game startup
+
  ├{{FileSystemTreeEntry|icon=FST-IconFileTxt|type=FST-ReadOnly|name=autoexec.cfg}} - configuration file which is automatically exectued on game startup
└─{{FileSystemTreeEntry|icon=FST-TxtFile|type=FST-ReadOnly|name=version.txt}}- TXT file containing game version string
+
  └{{FileSystemTreeEntry|icon=FST-IconFileTxt|type=FST-ReadOnly|name=version.txt}}- TXT file containing game version string
  
 
</div>
 
</div>

Revision as of 15:13, 3 March 2016

All of SCS games are using partially prescribed folder structure. This means that some resources must have proper name and be placed into proper folder otherwise game may malfunction or even crash. That's why this topic is giving insight to game base folder structure, it's crucial resources and their place in folders.

In general topic is showing and describing structure of the folders and files as you get them by using Game Archive Extractor for two basic files with .scs extension found in game installation directory: "base.scs" and "def.scs".

Root game folder

Root game folder consists of:

automat - Material storage with generated material files produced during conversion of 3D model assets with conversion tools.contentbrowser - Folder used by Map Editor content browser TODO: wait for confirmation.custom - Legacy folder for storing custom/modded definitions (NOTE: This folder is deprecated and might be removed in the future).def - See: Definitions.dlc - Shared models used by dlc such like "dead end" sign.effect - Set of compiled shader effects used by game for rendering of any visual element.font - See: Fonts.map - Storage for maps and it's additional data.material - See: Predefined materials.matlib - TODO: wait for confirmation.
 ├model - storage for 1st generation of static map assets.
 ├model2 - storage for 2nd generation of static map assets.
 ├prefab - storage for 1st generation of prefab map assets.
 ├prefab2 - storage for 2nd generation of prefab map assets.
 ├road_templateroad_template - road template models for new system of road generation
 ├sound - See: Sounds.
 ├system - low level engine resources. Shall remain unchanged.
 ├ui - ui dialogs and windows definitions.
   ├─ company_manager
   ├─ dashboard
   ├─ desc
   ├─ editor
   ├─ license_plate
   ├─ options
   └─ template
 ├uilab - TODO: wait for confirmation.
 ├unitunit - definitions for game predefined hookups spawned in game trough locators, for example: light flare, light sources, no weather areas.
   └─ hookup
 ├vehicle - vehicle models resource files.
   ├─ ai
   ├─ driver
   ├─ share
   ├─ trailer*
   ├─ truck
   └─ wheel
 ├video - video based animated textures.
 ├autoexec.cfg - configuration file which is automatically exectued on game startup
 └version.txt- TXT file containing game version string

Definitions

Definitions for most of configurable game content like: vehicles, economy, map assets etc.

Root Game Folder 
├─ def
   ├─ animated_model
   ├─ camera
   ├─ cargo
   ├─ city
   ├─ climate
   ├─ company
   ├─ country
   ├─ desktop
   ├─ ferry
   ├─ initial_save
   ├─ jobs
   ├─ regional_settings
   ├─ sign
   ├─ stamp
   ├─ vehicle
   └─ world

Fonts

Folder for storing game fonts.

Root Game Folder 
├─ font
   ├─ license_plate
   └─ sign

Predefined materials

Library of predefined materials and textures.

Root Game Folder 
├─ material
   ├─ custom
   ├─ decal
   ├─ deferred
   ├─ editor
   ├─ environment
   ├─ flags
   ├─ logo
   ├─ metal
   ├─ overlay
   ├─ prefab
   ├─ road
   ├─ rocks
   ├─ ropes
   ├─ sign
   ├─ special
   ├─ terrain
   ├─ tiled
   └─ ui

Sounds

Library of sounds used by game.

Root Game Folder 
├─ sound
   ├─ ai
   ├─ environment
   ├─ mover
   ├─ music
   ├─ truck
   └─ ui