Documentation/Engine/Game data

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:

Root game folder
 ├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 map assets.
 ├model2          Storage for 2nd generation of map assets.
 ├prefab          Storage for 1st generation of prefab assets.
 ├prefab2         Storage for 2nd generation of prefab map assets.
 ├road_template   Road template models for new system of road generation.
 ├sound           See: Sounds.
 ├system          Low level engine resources needed for console and fall-back cases of missing resources.
 ├ui              See: UI definitions.
 ├uilab           TODO: wait for confirmation.
 ├unit            Definitions for predefined hookups spawned in game trough locators, for example: light flare, light sources, no weather areas.
 ├vehicle         See: Vehicle model resources.
 ├video           Video based animated textures for UI.
 ├autoexec.cfg    Configuration file which is automatically executed on game start-up.
 └version.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                Directory with definitions for animated models triggered when distance to player is small enough.
  ├camera                        See: Camera definitions.
  ├cargo                         See: Cargo definitions.
  ├city                          Defines cities for game. Each city is defined in it's own SII file.
  ├climate                       See: Climate definitions.
  ├company                       See: Company definitions.
  ├country                       See: Country definitions.
  ├desktop                       Desktop (main menu) scene configurations. By default "/def/desktop/config.sii" is used.
  ├ferry                         See: Ferry definitions.
  ├initial_save
  ├jobs
  ├regional_settings
  ├sign
  ├stamp
  ├vehicle
  ├world
  ├aux_lamp_colors.sii           Defines players vehicle auxiliary light mask colors. 
  ├bank_data.sii                 Bank loans configuration.
  ├car_colors.sii                Defines colors for AI traffic cars.
  ├cargo.sii                     Storage of cargoes for trailer generation. When defining your own cargoes use infixed version of this SII file for example: "cargo.my_mod.sii".
  ├city.sii                      Storage of cities in game. When defining your own cities use infixed version of this SII file for example: "city.my_mod.sii".
  ├climate.sii                   Storage of climate profiles. When defining your own climate use infixed version of this SII file for example: "climate.my_mod.sii".
  ├company.sii                   Storage of companies that can be used in game. When defining your own companies use infixed version of this SII file for example: "company.my_mod.sii".
  ├...
  ├country.sii                   Storage of countries used in game. When defining your own countries use infixed version of this SII file for example: "country.my_mod.sii".
  ├...
  ├economy_data.sii              Game economy definition.
  ├...
  ├env_data.sii                  Environment global configuration such as day in the year. << TODO: This is not clean enough for me.
  ├...
  ├ferry.sii                     Storage of ferry ports. When defining your own cargoes use infixed version of this SII file for example: "ferry.my_mod.sii".
  ├...
  ├game_data.sii                 Various global game definitions.
  ├hdr.sii                       High dynamic range effect definitions.
  ├...
  ├job_trailer_preview.sii       Scene setup for generating preview images of trailers in freight market.
  ├job_truck_preview.sii         Scene setup for generating preview images of trucks in quick jobs.
  ├job_wotr_trailer_preview.sii  Scene setup for generating preview images of trailers in WOTR contracts.
  ├...
  ├mail_data.sii                 Defines players mails.
  ├photo_camera_data.sii         Configuration of Photo Mode camera.
  ├...
  ├police_data.sii               Defines player offences: fine amounts, offence check delay.
  ├...
  ├sound_player.sii              Defines sounds for UI actions and global game sounds.
  ├...
  ├traffic_data.sii              Defines different AI traffic data: total AI max count, yield attributes, safety distances etc.
  ├traffic_light_lamp_colors.sii Defines mask colors for traffic lights.
  ├trailer_preview_scene.sii     Defines scene configuration parameters for Trailer Browser.
  ├...
  ├truck_colors.sii              Defines colors for AI traffic trucks.
  ├truck_config_scene.sii        Defines scene configuration parameters for Upgrade Shop & Truck Browser.
  ├truck_dealer_scene.sii        Defines scene configuration parameters for Truck Dealers.
  ├...
  └vehicle_lamp_colors.sii       Defines players vehicle light mask colors.

Camera definitions

Camera definitions folder ("/def/camera") is using "camera_storage(.infix).sii" files as storage files defining cameras that can be used by player while in game (UI interface is not handled by cameras, as UI is drawn directly on screen 2D plane). Note that this defines only storage for available in game cameras, but which camera is used in the game depends on currently user selected view and current used player vehicle.

Beside storage files camera definitions folder also includes "cutscene.sii" file which defines camera and it's movement in different cut-scenes.

Root game folder 
├def
  ├camera
    ├...                        Folders for cut scenes camera definitions.
    ├ui                         Folder for storing camera movement definitions related to game desktop (main menu).
    ├units                      Folder for storing players camera included in "camera_storage" SII files.
    ├camera_storage.sii         Defining cameras storage that can be used in game by player. When creating your own cameras use infixed storage file name like: "camera_storage.mymod.sii".
    ├camera_storage.oculus.sii  Same as camera_storage.sii with purpose of defined cameras for Oculus Rift head set.
    └cutscene.sii               Defines cut scene data for each type.

Cargo definitions

This folder contains all cargoes definitions that player can transport in the game.

Unique cargo is defined by SII file and folder with one or more SII files defining trailers which can carry this cargo. So for each cargo you have one SII file inside "/def/cargo/" and one or multiple SII files inside folder "/def/cargo/<cargo_name>/". Example definition for cargo: "<cargo_name>" is shown in the tree below.

Root game folder 
├def
  ├cargo
    ├<cargo_name>             Folder defining trailers that can carry cargo defined in "<cargo_name>.sii" file.
      ├trailer.unit.name.sii  Defines trailer that can carry this cargo. SII file is named by trailer SiiUnit name
      └...                    More definitions for different trailers carrying this cargo.
    ├...                      Rest of cargo trailer definition folders.
    ├<cargo_name>.sii         Defining one cargo data.
    └...                      Rest of unique cargo definitions.

Climate definitions

Each climate is defined in it's own folder "/def/climate/<climate_name>/" and usually have at least 2 profile SII files: one for nice weather "nice.sii" and second for bad weather "bad.sii". Climates definitions are used in Map Editor (Editor Settings -> Weather tab).

There should be at least two climates:

Root game folder 
├def
  ├climate
    ├reference    Reference climate.
      ├bad.sii    Climate definition for bad weather.
      ├nice.sii   Climate definition for nice weather.
      └...        There can be additional variants of climate definitions.
    └...          Rest of climates.

Company definitions

Companies are entry and exit places on map for player missions (e.g. trailer delivery). So when defining new company make sure to include it in company storage file "/def/company(.infix).sii" otherwise company won't appear in the game.

Company definition folder with company "<company_name>" would look like:

Root game folder 
├def
  ├company
    ├<company_name>        Folder defining company data, named same as it's corresponding company data file.
      ├editor              Folder containing definitions for cities in which this company exists and which prefab will be used for it.
      ├in                  Folder containing SII files for cargoes this company accepts.
      └out                 Folder containing SII files for cargoes this company is shipping out.
    ├...                   Rest of the folders defining other companies data.
    ├<company_name>.sii    File defining company: name, trailer look and sounds.
    └...                   Rest of companies definitions.

Country definitions

Defines available countries that can be used in the Map Editor and later in game. While defining new country make sure to include it in country storage file "/def/country(.infix).sii".

Each country has it's own folder defining all possible country specific data. Worth mentioning is modification of AI traffic appearing frequencies, which is done by adding SII files inside "/def/country/<country_name>/ai/" folder. Each SII file defines modified frequency for one AI vehicle, where it's name tells which car is it. Possible file names are AI vehicles unit name suffixes used inside AI vehicle definitions (AI vehicles definitions can be found in: "/def/vehicle/ai/").

Root game folder 
├def
  ├country
    ├<country_name>        Folder defining other country specific data: license plates, speed limits, AI cars frequency.
      ├ai                  Folder containing SII files for AI traffic vehicles, that should have modified frequency in that country.
      ├license_plates.sii  Defines license plate data for that country.
      └speed_limits.sii    Defines speed limits for AI traffic for that country.
    ├<country_name_1>        
      ├...
      └...
    ├...                   Folders for the rest of the countries data.
    ├<country_name>.sii    File defining country general data: id, name, country code, position, fuel price etc.
    ├<country_name_1>.sii
    └...                   The rest of the countries definition.

Ferry definitions

Defines names of the ferries and their connections. For proper working in game this ferries has to be used in Map Editor while adding Ferry points. All ferries also have to be included in ferry storage file "/def/ferry(.infix).sii".

Connections on the other hand are defined in "/def/ferry/connection/" folder. Each file in that folder defines one direction connection from one ferry to second ferry. How connection is directed is defined by SiiUnit name, so for example SiiUnit name: "conn.<ferry1>.<ferry2>" is presenting ferry connection from <ferry1> to <ferry2>.

Root game folder 
├def
  ├ferry
    ├connection   Folder with SII files defining connections between ferries. Each file defines one way direction between two ferries.
    └...          SII files defining ferries. Each file defines one unique ferry.

Fonts

Folder for storing game fonts.

Root Game Folder
├─ font
   ├─license_plate             Fonts used by licence plates.
   └─sign                      Fonts used by road signs.

Predefined materials

Library of predefined materials and textures.

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

Sounds

Library of sounds used by game.

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

UI definitions

Library of all UI layouts and control definitions including vehicle dashboards.

Root Game Folder
 ├ui
   ├─ company_manager         Company manager UI layouts.
   ├─ dashboard               Truck dashboard UI layouts.
   ├─ desc                    UI descriptors.
   ├─ editor                  Editor UI layouts.
   ├─ license_plate           Licence plate UI layouts.
   ├─ options                 Options screens UI layouts.
   ├─ template                UI templates (definitions of the controls look).
   └─ ...                     UI window layouts for all in game windows.

Vehicle model resources

Root Game Folder
 ├vehicle
   ├─ ai
   ├─ driver
   ├─ share
   ├─ trailer*
   ├─ truck
   └─ wheel