Changes

All of SCS games are using partially prescribed folder structure. This means {{Tip|Be aware 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 page is giving insight obsolete, due to big changes in game base folder structure, it's crucial resources and their place in folderswith each update! For more information on structure changes check [[Games/ETS2/Modding_guides|modding updates]] pages.}}

 All of SCS games are using partially prescribed folder structure. This means that some resources must have the proper name and be placed into the proper folder otherwise game may malfunction or even crash. That's why this topic is giving insight to game base folder structure, its crucial resources and their place in folders. In general , this topic is showing and describing the structure of the folders and files as you get them by using the [[Documentation/Tools/Game Archive Extractor|Game Archive Extractor]] for two basic files with .scs extension found in game installation directory: "'''base.scs'''" and "'''def.scs'''".

├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=contentbrowser}} ''Folder used by Map Editor content browser TODO: wait for confirmation.'' ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=custom}} ''Legacy folder for storing custom/modded definitions (NOTE: This folder is deprecated obsolete and might be removed in the future).''

├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=map}} ''Storage for maps and it's its additional data.''

├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=city}} ''Defines cities for game. Each city is defined in it's its own SII file.''

├{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|name=env_data.sii}} ''Environment global configuration such as day in the year.'' << TODO: This is not clean enough for me.

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

Each climate is defined in it's its own folder "'''/def/climate/<climate_name>/'''" and usually have 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).

├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=<company_name_1>}} ''Folder defining company data, named same as it's its corresponding company data file.''

Each country has it's its 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 its name tells which car it 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/'''").

Vehicle definitions are responsible for configuration of any type of vehicles and it's its parts in SCS games that are not map assets. Biggest part of this configurations belongs to configuration of possible player vehicles and it's its parts.

├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=truck|link=#Player trucks definitions}} ''See: [[#Player trucks definitions|Players truck Player trucks definitions]].''

├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=truck_dealer}} ''See: [[#Truck dealer definitions|Truck dealer definitions]].''

Trailer definitions defines trailers for usage with players truck or for usage by AI traffic. For defining a trailer, one SII file and folder with "'''chassis.sii'''" and/or additional cargo definitions has to be created. All of the trailers definition files also have to be included in one of the storage files to be used in game. In case trailer should be used by player it has to be included in one of the "'''trailer_storage(.infix).sii'''" files and if trailer should be used by AI trucks it has to be included in one of "'''trailer_storage_semi_trailertraffic_storage_semi_trailer(.infix).sii'''" files or custom type of AI trailers storage file.

{{Note|Difference between AI trailer trailers and players trailer is in player trailers are handled somewhat differently. Player trailers use the type of SiiUnit in trailer definition file, where players trailer SiiUnit name is "'''trailer'''" and AI SiiUnit class with a naming convention of <code>trailer SiiUnit .<name is ></code>, while AI trailers use the "'''traffic.trailertraffic_trailer'''"SiiUnit class and a naming convention of <code>traffic.trailer.<name></code>.}}

==== Player truck trucks definitions ====

Player truck definitions are containing all definitions that configures defines trucks and their accessories that player can use in gameand accessories for them.

Each truck is configured in it's own folder (e.g. "'''<brand.truck>'''" in tree view below) containing:# SII file: '''data.sii''' - ''defining: truck info, cameras, fallback rules for parts of For more information see the truck and required accessories. There is 8 mandatory fallback rulesdedicated page: chassis, cabin, interior, engine, transmission, f_wheel (or f_tire), r_wheel (or r_tire), paint_job and head_light''.# Subfolders: ('''chassis''', '''cabin''', '''interior''', '''engine''', '''transmission''', '''paint_job''', '''head_light''', '''sound''') - ''defining different parts and accessories of the truck. First 7 folders are needed because of mandatory fallback rules and sound folder is needed for truck mandatory sounds [[/Player trucks definitions|Player trucks definitions]].''# Optional folder: '''accessory''' - ''defining all possible accessories for the truck that user can install in game Upgrade Shop. This folder holds another level of sub folders for separating different accessory types that player can install on the truck and will be listed in Upgrade Shop once player selects proper accessory type. Moreover names of subfolders directly correspond to the names of model locators truck 3D model has to have for ability of having that types of accessories enabled in the game.''

Still this configurations are not enough to have truck shown up in === World definitions === Defines all world items that can be placed on the gamemap with Map Editor and their behaviour. For proper inclusion All of truck in the game, truck initial configuration files different item types have to their own definition file where items of the same type are defined. While defining new world items alternative infixed naming of SII file shall be created used e.g. for:# Dealers inside folder: "'''/def/vehicle/truck_dealer/'''" (if truck has RHD variant also in UK dealers folderdefining new static models infixed file example would be: "'''/def/vehicle/truck_dealer_uk/'''")model.# Desktop preview inside folder: "'''/def/vehicle/truck_desktop/'''" (if truck has RHD variant also in UK dealers folder: "'''/def/vehicle/truck_desktop_uk/'''")mymod.# Quick Jobs trucks inside folder (optionally): "'''/def/vehicle/truck_company/'''" (if truck has RHD variant also in UK dealers folder: "'''/def/vehicle/truck_company_uk/sii'''").

├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=vehicleworld|linkmark_current=1}} ├{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|name=#Vehicle definitionsbuilding_model.sii}} ''Defines continuous models that can be used as curve path profile models.'' ├{{FileSystemTreeEntry|icon=FST-IconFolderIconFileSii|type=|name=truckbuilding_scheme.sii}} ''Defines schemas for curve path building items (hedges, fences, electro wirings, tree avenues ...). In Map Editor used as '''Buildings''' item type.'' ├{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|mark_currentname=1detail_vegetation.sii}} ''Defines global detail vegetation data.'' ├{{FileSystemTreeEntry|icon=FST-IconFolderIconFileSii|type=|name=<branddetail_vegetation_def.truck>sii}} ''Truck main configuration folderDefines detail vegetation models to texture assignments.'' ├{{FileSystemTreeEntry|icon=FST-IconFolderIconFileSii|type=|name=accessoryhinge.sii}} ''Folder for defining all accessory types which can Currently unused. It defined object that could be installed placed on this map and be swung by player trucke.g. swing doors.'' ├{{FileSystemTreeEntry|icon=FST-IconFolderIconFileSii|type=|name=beaconmodel.sii}} ''Defines static map models which can be in Map Editor used as '''Models'''Folder for defining accessory of item type "beacon".'' ├{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|name=single_beaconmodel.custom.sii}} ''File defining one beacon modelObsolete. Used only for backward compatibility.'' └ ├{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|name=mover.sii}} ''Defines map models with animations which can be in Map Editor used as '''Movers''' or '''Walkers''' item type.'' ├{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|name=overlay.sii}} ''More beacon models definition filesDefines overlay names for cities and roads.'' └ ├{{FileSystemTreeEntry|icon=FST-IconFolderIconFileSii|type=|name=overlay.custom.sii}} ''Obsolete. Used only for backward compatibility.'' ├{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|name=prefab.sii}} ''Defines prefab map models like companies, gas stations, dealers, crossings. In Map Editor used as '''Prefabs''Folders defining more accessory types and it's model definitionsitem type.'' ├{{FileSystemTreeEntry|icon=FST-IconFolderIconFileSii|type=|name=cabinprefab.custom.sii}} ''Folder with SII files defining cabin mandatory truck part; one cabin per one SII fileObsolete. Used only for backward compatibility.'' ├{{FileSystemTreeEntry|icon=FST-IconFolderIconFileSii|type=|name=chassisrailing.sii}} ''Folder with SII files defining chassis mandatory truck part; one chassis per one SII fileDefines side roads elements like: crash barriers, anti noise barriers etc.'' ├{{FileSystemTreeEntry|icon=FST-IconFolderIconFileSii|type=|name=engineroad.sii}} ''Folder with SII files defining engine mandatory truck part; one engine per one SII fileBasic road data definition like different road lines lengths.'' ├{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|name=road_edge.sii}} ''New template road system edge definitions.'' ├{{FileSystemTreeEntry|icon=FST-IconFolderIconFileSii|type=|name=head_lightroad_look.sii}} ''Old road system definitions. In Map Editor used as ''Folder with SII files defining head light mandatory truck part; one head light 'Road''' item type per one SII file.'' ├{{FileSystemTreeEntry|icon=FST-IconFolderIconFileSii|type=|name=interiorroad_look.template.sii}} ''New template road system definitions. In Map Editor used as '''Road''Folder with SII files defining interior mandatory truck part, it's animations, dashboard colors and glass data; one interior per one SII fileitem type.'' ├{{FileSystemTreeEntry|icon=FST-IconFolderIconFileSii|type=|name=paint_jobroad_material.sii}} ''Folder with SII files defining paint job mandatory truck part; one paint job per one SII fileOld road system materials definitions.'' ├{{FileSystemTreeEntry|icon=FST-IconFolderIconFileSii|type=|name=soundroad_sidewalk.sii}} ''Folder with SII files defining sound mandatory truck partOld road system side walk definitions.'' ├{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|name=semaphore_model. There should sii}} ''Defines semaphore models that can be at least two SII files: one for interior and second for exterior sounds definitionused in semaphore profiles.'' ├{{FileSystemTreeEntry|icon=FST-IconFolderIconFileSii|type=|name=transmissionsemaphore_profile.sii}} ''Folder with SII files defining transmission mandatory truck part; one transmission per one SII fileDefines semaphore profiles which can be assigned to prefabs models. Used in Blender Tools or Maya.'' └ ├{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|name=datasign.sii}} ''Defines road signs. In Map Editor used as '''Sign''Defining truck global data: info, cameras and fallback rulesitem type.'' ├{{FileSystemTreeEntry|icon=FST-IconFolderIconFileSii|type=|name=<2nd_brandsign.truck>custom.sii}} ''Folder defining second truck with the same structure folder structure as Obsolete. Used only for first truck examplebackward compatibility.'' ├{{FileSystemTreeEntry|icon=FST-IconFolderIconFileSii|type=|name=sound_item_data.sii}} ''Defines sound items that can be placed on map and will be triggered once player comes near. In Map Editor used as '''Sound''' item type.'' ├{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|name=stamp.sii}} ''Folders Defines stamp brushes for defining more trucksbrushing in Map Editor. They are used with '''Brush''' tool.'' ├{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|name=common_sound_extterrain_material.suisii}} ''Defines terrain materials paths. Used indirectly on more map items through their properties.'' ├{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|name=common_sound_ext_dataterrain_profile.suisii}} ''Defines terrain profiles that can be used on the sides of the road. Used indirectly on road items through properties.'' ├{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|name=common_sound_inttraffic_lane.suisii}} ''Defines general traffic lanes data like: allowed vehicles types, spawn count limits and frequencies.'' ├{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|name=common_sound_int_datatraffic_rules.suisii}} ''Defines traffic rules that can be used on ''Traffic area'''items in Map Editor. Additionally they can be used while creating prefab model using Blender Tools or Maya.'' ├{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|name=<brand_truck>traffic_rules.compat.sii}} ''Obsolete. Used only for backward compatibility.'' ├{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|name=<2nd_brand_truck>trigger_action.sii}} ''Defines action triggers that can be used to trigger different commands in game. Used in Blender Tools or Maya while creating prefab model.'' ├{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|name=vegetation.sii}} ''Defines vegetation profiles that can be used on road sides. In Map Editor they are used indirectly from properties of '''Road''' item type.'' ├{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|name=vegetation_model.sii}} ''Defines tree and bush vegetation models for usage in '''vegetation.sii''' file.'' └{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|name=vegetation_old...sii}} ''Obsolete. Used only for backward compatibility.''

Folder for storing game fonts. Mostly used in UI and inside vehicle dashboard displays.

├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=font|mark_current=1}} ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=license_plate}} ''Fonts used by licence plates.'' └─ └{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=sign}} ''Fonts used by road signs.''

├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=material|link=#Predefined materials|mark_current=1}} ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=custom}} ''Lorem ipsum..'' ├─ {{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=decal}} ''Lorem ipsum..'' ├─ {{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=deferred}} ''Lorem ipsum..'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=editor}} ''Lorem ipsum.Map Editor background textures.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=environment}} ''Lorem ipsum.Environmental cube maps used for reflections.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=flags...}} ''Lorem ipsum..'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=logo}} ''Logos of the Textures for in game, company logos & SCS Software and libraries used by the gamelogos.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=metal...}} ''Lorem ipsum..'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=overlayroad}} ''Lorem ipsumTextures & materials for roads.Folder supports material aliasing.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=prefab}} ''Lorem ipsum..'' ├─ {{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=road.}} ''Lorem ipsum..'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=rockssign}} ''Lorem ipsum.Texture atlases & frames for new sign system.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=ropesspecial}} ''Lorem ipsum.Special purposes texture atlases.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=signterrain}} ''Lorem ipsumTerrain textures & materials e.g.'' ├─ {{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=special}} ''Lorem ipsumfor grass, sand, water.Folder supports material aliasing.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=terraintiled}} ''Lorem ipsum.Collection of tillable textures.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=tiledui}} ''Lorem ipsum.Textures and materials used by UI such like buttons, windows, icons etc.'' └─ └{{FileSystemTreeEntry|icon=FST-IconFolderIconFileSii|type=|name=uimaterial.db}} ''Textures and Physical materials (substances) database. Names of this substances may be used by UI such like buttons, windows, icons etcon materials attribute called "Substance".''

├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=sound|mark_current=1}} ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=ai}} ''Sounds used by AI Traffic vehicles such like engine sounds, horns and sirens.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=environment}} ''Environment ambient loops.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=mover}} ''Sounds produced by mover objects in game.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=music}} ''Music used in many places for example during cutscenes.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=truck}} ''Truck related sounds such like engine sounds, crash sounds, trailer attach sounds etc.'' └─ └{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=ui}} ''Sound effects used when user is interacting with the UI. For example click on the UI element.''

├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=ui|mark_current=1}} ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=company_manager}} ''Company manager UI layouts.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=dashboard}} ''Truck dashboard UI layouts.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=desc}} ''UI descriptors.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=editor}} ''Editor UI layouts.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=license_plate}} ''Licence plate UI layouts.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=options}} ''Options screens UI layouts.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=template}} ''UI templates (definitions of the controls look).'' └─ └{{FileSystemTreeEntry|icon=FST-IconFileSii|type=|name=...}} ''UI window layouts for all in game windows.''

├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=vehicle|mark_current=1}} ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=ai}} ''AI traffic vehicles models and resources of all types: cars, trucks, buses, trains.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=driver}} ''Driver models for usage in AI traffic vehicles.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=share}} ''Shared texture resources for vehicles.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=trailer*}} ''Models and resources for player and AI traffic trailers. (*)- for ETS2 there will be "'''trailer_eu'''" instead.'' ├─ ├{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=truck}} ''Player trucks vehicles models and resources.'' └─ └{{FileSystemTreeEntry|icon=FST-IconFolder|type=|name=wheel}} ''Models and resources for all vehicle wheels except wheels for player trucks.''