Explaining MSTS' Route Folder Structure
by Jim "sniper297" Ward
Route Folder Structure
or .... How it's all put together.
\Activities
The info for each activity, contained in the .act files. Contains paths, services, traffic, and the location of each loose consist. Also has all the dope on action events and schedules.
\Envfiles
*.env files, the animation of skies and water, and in \Envfiles\Textures the sky & water textures. "Train World Initilization Failed" means one of these files is missing or corrupt.
\Lo_tiles
Low-resolution terrain textures for distant viewing, rarely used.
\Paths
The actual path each train takes over the route. These .pat files are what gets outdated by alterations to the track in the route editor, causing "broken path" errors since the path no longer matches the track configuration.
\Services
Trains with engines that move on the route. This includes the player train and any AI traffic trains. Each .srv file contains the info on the consist and the path file for that service.
\Shapes
Contains the .s and .sd files for the 3D objects. The object.s file has the shape data and the name of the .ace file it gets textured with. The matching object.sd file is the extended shape data, which contains info on alternative texture for night, snow covered, or seasonal.
\Sound
Do I really need to explain that one?
\TD
The actual "quad tree", geographical location and tile boundaries for the route. "Invisible" ground means a problem in here.
\Terrtex
The terrain texture files. This is the "painting" on the ground, when you apply a tile texture to the little black bordered square on the ground it comes from here. The subfolder \snow needs to have the corresponding ace file for each texture actually used on the route, otherwise there will be missing file errors when driving in winter.
\Textures
The skins for all the 3D objects in the \Shapes folder. Contains subfolders \Autumn, \AUTUMNSNOW, \Night, \Snow, \Spring, \SPRINGSNOW, \Winter, and \WINTERSNOW. Vegetation frequently has 8 different textures, showing up in the base \textures folder, plus all the other folders except night. Some objects have only the base texture, others have snow textures, and if it lights up at night it will also have a night texture. This folder contains all the ace files except environment (\Envfiles, sky and water) and ground textures (\Terrtex).
\Tiles
Either the .t, or y.raw, or both, contain the terrain elevation information, hills and valleys and so forth, plus the information on which \terrtex\ ground texture is applied to each tile. The f.raw files are generated when siding and platform markers are placed. The e.raw and n.raw are "lighting and geometry", and are automatically generated by the sim if they are missing, which is why it takes longer to load a newly installed route, as these are usually deleted to save space in the zip file.
\Traffic
Just what it sounds like, the .trf files contain the services and starting times for AI traffic trains.
\Tutor
Generated in add-on routes from the template folder, the only route that actually has anything in here is the tutorial route. I usually forget to delete this folder.
\world
All the info on location and viewing angles for all the placed objects are in the .w files, and the .ws files have all the placed sound sources. If a .w file is missing, the terrain texture and elevations are still visible, but all objects including the track textures are gone. The train can still be driven on the invisible track, the invisible signals still work, and the invisible switches can still be thrown. The track database is generated from the location references in the .w files, along with the tsection.dat file in the root of the routewhich addresses dynamic track.