Directory Structures

The 'custom content' directory structures in SP3 are different from those in previous versions of Trainz. This is in order to facilitate a ' clean' changeover from pre- SP3 content to post- SP3 content. By keeping the directory structures isolated we intend to be able to maintain the content in their distinct areas and allow a future version of Trainz to remove the pre- SP3 directory structures, thereby completing the upgrade process.

In order for this process to work correctly it is therefore very important that no pre-SP3 content is manually moved into the new SP3 directory structures.

We do however realize that content creators need to test their own masterpieces in SP3 before packaging with Content Dispatcher takes place. Only in this instance should there be any manual transfer.

The default location for all SP3 custom content is:

C:\Program Files\Auran\Trainz\World\custom\
	Bogeys
	Displacements
	Environment	Sky
		Water
	Ground
	Interior
	Maps
	Pants
	Scenery
		w/ Night Lights
		w/ Animation
		w/ Sound
		Level Crossing
		Turntable
	Scenarios
	Splines
	Track	Bridges
		Rails
		Tunnels
	Trackside
		Junction
		Signals
		Speedboard
	Trains

Naming Conventions:

Typical directory structure for custom Trains should be:

	World\
		custom\
			trains\
				Custom_traincar\
				Config.TXT
					Custom_traincar_art\ (Texture for Graphical User Interface)
						traincar_art_512.TGA (512x512 32-bit.TGA)		Primary=traincar_art_512.TGA Tile=st Hint=Dynamic Alpha=traincar_art_512.TGA
						traincar_art_512.texture.TXT	<--------
						traincar_icon_art.TGA (128x32 32-bit.TGA)
						traincar_icon_art.texture.TXT
					Custom_traincar_body\
						Custom_traincar.PM (Trainz Mesh file exported from 3DS Max or GMax)
						x.TGA (16-bit)
						y.BMP (8-bit grayscale opacity map - if required)
						env_metal.BMP (16-bit color environment/reflection map)
						*.texture.TXT  (Exporter Generated)
						digit_1.TGA (to digit_6.TGA) (24-bit)
					Custom_traincar_shadow\
						Custom_traincar_shadow.PM
						black.TGA (Default Texture for Shadow)
						black.texture.TXT (Exporter Generated)
					Custom_traincar_alpha_numbers\ (Automatically replacing Digit Textures)
						alphanumber_0.TGA (to alphanumber_9.TGA) (32-Bit)
					Refer: Locomotive Numbering

config.TXT File

Each item of content that you create is required to have a config.TXT file. This file is a simple text file that is used to describe the item of content to Trainz. The contents of a typical confg.TXT file may look like this: