Rolling
Stock File and Folder Tutorial
In
this tutorial you will learn where to place the files and the naming
conventions used for files and folders for a new Trainz Rolling Stock
or Locomotive item.
NOTE
The name tutorial is used for the folder structure. Replace tutorial
with the name of your model.
|
|
1. Custom folder
The
following screen shot shows the directory structure for the custom
folder. Some folders may not be present on your machine. If the trains
directory is not present then you will need to create it.
|

Figure 1 custom
folder contents
|
|
2. Folders and their names
Open
the trains folder. Create a folder for the project and use an appropriate
name There are three subfolders required for a rolling stock item
these are the art, body and shadow folders. Although the model will
work
with only the body folder you will not have any consist images in
surveyor and no shadows this will also be reported in the Trainz log
file. Create and name the three folders as shown in figure 2. I have
used tutorial
for
the
name
of
this project.
Replace
tutorial
with the name of your mesh. Avoid using spaces in the name. Note
also the location of the config.txt file and also the tutorial.gs which
is the script file. The rolling stock will work without the script
file but it will not be TRS2004 industry compatible.
|

Figure 2 Correctly
named folders
|
3. File names
Once
the folders are named correctly then you can move your mesh and
its textures into the tutorial_body folder. Rename the mesh as shown
in Figure 3 but do not rename any of the other files. You will
also notice the inclusion of the Tutorial.lm.txt file this is the
level of detail file that should be included with all TRS items.
|

Figure 3 Renamed
.pm file
|
Once you have done
this you need to create a config.txt file and reference the new folder
in it with the entry asset-filename tutorial With the config
completed you should be able to start Trainz and
the new object
should
show up in driver. If it does not show up then you may have a spelling
mistake in either the folder name or the config.txt entry or in the
level of detail file or you have referenced dependencies that are
not available on your computer.
If
the item shows up correctly then you can then create some screenshots
for use in driver.
|

Figure 4 Art files
correctly named
|
Rename the art files
as shown in figure 4. You will also need to edit the text files. This
tutorial does not go into the actual creation of the art files nor
the required text in the text files.
|

Figure 5 Shadow
file named correctly
|
TRS2004 now requires
the shadows to be included in the package. If you do not include them
then the Log will report that TRS was unable to load the shadow file.
4. Load folders (Optional)
Once
you have all the folders set up and the mesh showing up in TRS then you
can add the files needed for the visualization of the unloading and unloading
of products.
|

Figure 6 Load
folder
|
The naming of these folders is not important as long as the folder
names are referenced in the config.txt file.
|

Figure 7 Load
files
|
| The load.im and the load.kin files need to be referenced correctly in
the config file for the animation to work correctly. |
|
Was this tutorial helpful?
Not enough or too much detail? Points not explained properly? Suggest
any improvements? Please let me know what you think here.
Download this tutorial here as
a PDF document. |