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

From SCS Modding Wiki
Jump to navigation Jump to search
(Definitions)
(Root game folder)
Line 8: Line 8:
 
<div class="folder_structure">
 
<div class="folder_structure">
  
  ├─ {{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-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-Folder|type=FST-ReadOnly|name=contentbrowser}} - folder used by Map Editor content browser TODO: wait for confirmation.
+
  ├─ {{FileSystemTreeEntry|icon=FST-Folder|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-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-Folder|type=|name=def|link=#Definitions}} - see: [[#Definitions|Definitions]]
+
  ├─ {{FileSystemTreeEntry|icon=FST-Folder|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-Folder|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-Folder|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}} - see: [[#Fonts|Fonts]]
+
  ├─ {{FileSystemTreeEntry|icon=FST-Folder|type=|name=font|link=#Fonts}} - ''See: [[#Fonts|Fonts]].''
  ├─ {{FileSystemTreeEntry|icon=FST-Folder|type=|name=map}} - map data.
+
  ├─ {{FileSystemTreeEntry|icon=FST-Folder|type=|name=map}} - ''Storage for maps and it's additional data.''
  ├─ {{FileSystemTreeEntry|icon=FST-Folder|type=|name=material}} - predefined materials and textures library.
+
  ├─ {{FileSystemTreeEntry|icon=FST-Folder|type=|name=material|link=#Predefined materials}} - ''See: [[#Predefined materials|Predefined materials]].''
    ├─ custom
 
    ├─ decal
 
    ├─ deferred
 
    ├─ editor
 
    ├─ environment
 
    ├─ flags
 
    ├─ logo
 
    ├─ metal
 
    ├─ overlay
 
    ├─ prefab
 
    ├─ road
 
    ├─ rocks
 
    ├─ ropes
 
    ├─ sign
 
    ├─ special
 
    ├─ terrain
 
    ├─ tiled
 
    └─ ui
 
 
  ├─ {{FileSystemTreeEntry|icon=FST-Folder|type=|name=matlib}} - TODO: wait for confirmation.
 
  ├─ {{FileSystemTreeEntry|icon=FST-Folder|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-Folder|type=|name=model}} - storage for 1st generation of static map assets.

Revision as of 14:47, 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 - sounds used by game.
   ├─ ai
   ├─ environment
   ├─ mover
   ├─ music
   ├─ truck
   └─ ui
├─ 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

Root Game Folder 
├─ font - fonts used by game.
   ├─ license_plate
   └─ sign

ICONS TODO

  • SII / SUI
  • TEXT FILE

Probably not needed

  • Model
  • Audio (OGG)
  • Material
  • Textures
    • TOBJ
    • DDS etc etc
  • Video Texture (OGV)
  • Map content
  • .font