Tutorial For Replacement Into DB-Tracks - Engl - V1.0
Tutorial For Replacement Into DB-Tracks - Engl - V1.0
Created by Rogue
English Version: April 2018
1
Table of Content
A) Introduction.....................................................................................................................................3
B) General DBTracks information.......................................................................................................4
C) Requirements...................................................................................................................................6
D) The first steps..................................................................................................................................7
E) Replacement of the regular tracks.................................................................................................10
F) Special features: Shapes and Tunnelshapes...................................................................................13
G) Transformation of the Dynamic Tracks (DynaTrax).....................................................................14
H) Mixed tracks..................................................................................................................................16
I) Adjustment of track altitude............................................................................................................18
J) The last steps...................................................................................................................................19
2
A) Introduction
In order to replace the slightly plain MSTS-Standardtracks into more realistic shapes and textures,
our already deceased colleague Norbert Rieger started to develop an entire new tracksystem for
the MSTS in 2008.
Norbert Rieger has constructed a great amount of different tracksystems for german routes. Also
the construction of some US-tracksystems for american routes has been started, but alas never
finished.
For a lot of routes the optical appearance has been immensely improved by this tracksystem called
„DBTracks“.
These tracks are OpenRails compatible and therefore are an important part in the continuity of
MSTS-built routes.
Due to the early death of Norbert Rieger the entire compendium of Xtracks elements could not be
completed but the standard track sortiment is fully available so that most of the Payware-Routes
can be transformed into DBTracks.
Unfortunately only a couple of Payware-Routes have been equipped with DBTracks and in most
cases an update has not been provided so far (and probably never will).
So in order to enjoy these wonderful tracks, the user has to do the replacement by himself.
Norbert Rieger has provided a small tutorial on his own website during his lifetime.
His tutorial and all other published information are of course still valid and should not be
questioned in any way with this work.
During the year 2017 I transfered a lot of tracks by myself and as an „advanced rookie“ in this field
I collected all my experiences.
There are so many specialities in existence that are not described anywhere, except in a loose
form over various forums.
This tutorial is primarily aimed at beginners so that everyone can solve the task of a
transformation.
Of course this tutorial can't be 100% complete but it's the result that counts.
− Using this turorial occurs at your own risk. There will be no liability for any damages on
Soft- or Hardware.
− The handling and usage of the supporting programms and utillities are not part of this
tutorial. These information are provided in seperate documentations.
3
B) General DBTracks information
4
Important sets: 'DB3' (without catenary); 'DB3f' (with catenary)
Complete set available.
Additional sets for the Hamburger S-Bahn, Y-Ties and various Tunneltracks are also available.
5
C) Requirements
For a replacement into DBTracks, the following utilities are required or recommended:
− TSUtil
− Java
A little disclaimer:
There might be numerous other ways to perform this replacement.
But in order to keep this tutorial in an acceptable size, I limited the description to the way I had the
best experience with.
Furthermore, it should be suitable for beginners.
6
D) The first steps
Should a route be prepared for a transformation, the following first steps must be taken:
1) Backup-copies!
Before the start of the replacement, some thoughts should already have been invested how
the result should look like:
Which track-sets are necessary (Concrete-, wood- or steelties)?
Is it a route with catenary or without catenary, etc.?
The most common sets are already introduced in chapter „B) General DBTracks
information“.
In order to use the DB-Tracks in a route, some basic files must be copied into specific
folders and directories.
All necessary files are available for download on Norbert Rieger's website.
A basic rule:
The shape-files will always be provided from the central 'Global'-folder, which can be found
in the main TrainSimulator-directory.
The texture-files are always placed in every single Route-folder of each route, prepared for
DB-Tracks.
Shape-Files:
The entire shape-set must be copied into the following path:
„Train Simulator/GLOBAL/SHAPES/DB“
The sub-folder „DB“ must be created, if not present.
Texture-Files:
All necessary texture-files must be copied into the „TEXTURES“-folder of the specific
route-directory.
Within the „TEXTURES“-folder is an existing sub-folder „Snow“ for the snow-textures. All
snow-textures must copied into this one as well.
7
4) Decompression of World-files
Usually all world-files within a route are data compressed. In order to read and alter them
with a texteditor, the files must be decompressed.
The program of choice for that process is „RouteRiter“.
Proceedure in RouteRiter:
1. Select Route
2. Confirm Route-selection
3. Disable write-protection
4. Double-click on world-folder
5. Click on the „W“-button. Now only the *.w-files are shown
6. Mark all *.w-files by pressing the keys „Strg-Shift-End“
7. Activate the button „Same View“. The Source Directory will be copied into the Target
Directory on the right side.
8. Open the program-folder „MSTS File Utils“.
9. Activate the process with a click on the „Uncompress S,T &.W Files“ button.
10. After confirmation of the noticfication, the decompression will be initiated. This process
may take a couple of minutes.
The decompression was successful when all the w-files now have a larger file-size and are
readable when opened in a texteditor.
8
5) General information: Track-entries within the world-files
Basically all track-entries are found within the world-files in the sections named „TrackObj“. The
structure of these sections is build as follows:
TrackObj (
UiD ( 2169 )
SectionIdx ( 3 )
Elevation ( 0 )
CollideFlags ( 551 )
FileName ( A1t250mstrt.s )
StaticFlags ( 00200180 )
Position ( -517.498 167.315 -703.27 )
QDirection ( 0 0.920493 0 0.390759 )
VDbId ( 4294967294 )
StaticDetailLevel ( 0 )
The type of the used track is specified by the entry „FileName“. This entry always refers to
the specific shape-file (file names ending with '*.s')
Caution: „TrackObj“ also defines street-elements as shown below. But these are irrelevant
for the replacement.
TrackObj (
UiD ( 2377 )
SectionIdx ( 133 )
Elevation ( 0 )
CollideFlags ( 551 )
FileName ( Road2L45deg.s )
StaticFlags ( 00200100 )
Position ( -32.9279 163.629 -235.057 )
QDirection ( 0 0.966507 0 0.256639 )
VDbId ( 4294967294 )
StaticDetailLevel ( 7 )
The entry „UiD“ is a unique identification of the track and plays an important role in the manual
replacement of tracks (see chapter „H) Mixed tracks“).
9
E) Replacement of the regular tracks
There are three questions to be answered before the start of any replacement activities:
2) Does the route has shape-files instead of tracks (a common issue with ProTrain-routes)?
Re. 1): If there are tunnels built in a route, things might get a bit complicated.
To verify if there are any tunnels built in your route it is recommended to load all world-files in your
texteditor and start a search for file-elements which contain the fragment „Tun“ (using the „Search“-
function of your editor). All hits must be in the section „TrackObj/FileName“ again:
FileName ( A2t10mstrtTunBw.s )
Re. 2): Especially routes desigend by ProTrain are characterized by the use of „Track-Shapes“
instead of the standard tracks.
Nobody knows the deeper meaning of this „feature“ but it causes an additional step during the
transformation into DBTracks.
TrackObj (
UiD ( 739 )
SectionIdx ( 218 )
Elevation ( 0 )
CollideFlags ( 551 )
FileName ( "..\\..\\routes\\pt-fuw\\shapes\\A1tPnt10dLftMnl.s" )
StaticFlags ( 00200180 )
Position ( -907.861 179.9 -741.988 )
QDirection ( 0 -0.857203 0 0.514979 )
VDbId ( 4294967294 )
StaticDetailLevel ( 0 )
Again these elements could be found in the section „TrackObj/FileName“ and have additional path-
information, depending on the used route (in this case „pt-fuw“ is the ProTrain route 'Fulda-
Würzburg').
If any tunnel and/or shape-elements are present, please refer to chapter „F) Special
Features: Shapes and Tunnelshapes“ first !
Re. 3): Some routes have different track sets within one tile.
For example there are tracks with and without a catenary, normal tracks and LZB-tracks, etc.
A highly recommended tool is the Trackviewer which can be found in the OpenRails -Toolbox.
10
Here you can check the relevant 'mixed tiles' and decide which track-set is the dominant one.
The most common track-set will be transferred with the method introduced in this chapter, the
remaining track(s) later in the chapter „Mixed tracks“.
An example: there is a large station with normal concrete tracks within a tile and a one tracked line
with wooden ties and no caternary branches off into the country.
In this case it is recommended to transfer the entire tile with the normal concrete tracks and to alter
the „country-line“ afterwards.
The actual transformation can start as soon as the above mentioned points are all settled.
Basically the transformation is quite easy but it still can produce some serious faulty results by an
inaccurate handling during the replacement issues.
For the transformation an extended file-description in the line „FileName“ must be generated,
which refers to the DBTracks Shape-files within the global folder.
For example:
TrackObj (
UiD ( 2169 )
SectionIdx ( 3 )
Elevation ( 0 )
CollideFlags ( 551 )
FileName ( A1t250mstrt.s )
StaticFlags ( 00200180 )
Position ( -517.498 167.315 -703.27 )
QDirection ( 0 0.920493 0 0.390759 )
VDbId ( 4294967294 )
StaticDetailLevel ( 0 )
will be converted into the DBTrack-set with old concrete ties and catenary.
'FileName ( DB/DB2f_A1t250mstrt.s )'
The result can be reached fast and quite comfortable with the 'Search-Replace' feature of the
Texteditor.
All world-files can be loaded into the editor in one go and treated with the replace feature.
But whilst working with the 'Search-Replace' feature of the texteditor, a couple of very important
rules must be considered:
− Only distinct entries should be replaced. Sometimes that is quite tricky. But replacing the
tracks with the following text-string (for example the concrete track with catenary...'DB2f')
proved to be successful:
Replacement of
FileName ( A1t
11
into
FileName ( DB/DB2f_A1t
This step must be repeated with all track-elements ('A2t', 'A3t' and 'A4t').
− Careful with spaces. Between the brackets and the text is always a 'space'-charakter. If
this is removed out of carelessness, problems will later arise for sure.
Don't forget to save the files and the first step is done.
Important advice:
While using this method, all the tunnel-elements will be extended with this string either. Since not
all variants are equipped with a complete tunnel track-set, the shapes will be missing during the
game.
If the following variants of the new DBTracks 'DB1', 'DB1f', DB1s', 'DB10', 'DB2', 'DB2f', 'DB20'
DB20f', 'DR2' or 'DR2f', are not affected, the additional extension must be manually removed from
the tunnel-elements again.
The string „Tun“ must be searched and the above mentioned extensions must be manually
removed on every hit again.
So far I have not discovered a proper way of doing this with the 'replacement'-function.
12
F) Special features: Shapes and Tunnelshapes
Especially routes desigend by ProTrain are characterized by the occasional use of shapes instead
of the standard tracks.
But it is quite easy to solve this problem by using the 'Replace'-feature in the text editor again.
This time two steps are necessary:
FileName ( "..\\..\\routes\\pt-fuw\\shapes\\A1tPnt10dLftMnl.s" )
Replacement of
FileName ( "..\\..\\routes\\pt-fuw\\shapes\\A
into
FileName ( A
But there is still the problem that there is a quotation mark following the „.s“.
This will be solved again with an replacement.
Replacement of
.s" )
into
.s )
Caution:
Between the 's' and the bracket is always a space. This must not be deleted.
Here I have not discovered a way of doing this with the 'replacement'-function either.
13
G) Transformation of the Dynamic Tracks (DynaTrax)
2) In the DropDown-menue „Package“ the DBTracks named „NR DB Track Basic“ must be
selected
5) The button „Convert“ starts the transformation. The transformation can take a couple of
minutes.
Note to 3): (the following infos are not necessary while using the route in OpenRails)
The value in the brackets represents the shape-quality of the standard tracks.The highest possible
value is [q200].
DynaTrax-elements larger than 250KB (as shown in the column „Filesize“ on the right), must not
exceed the quality-level of [q75] during transformation. Otherwise some graphical gaps within the
tracks will occur when used in the MSTS.
Personally I transfer all tracks using the value [q75]. In my opinion there is no visible quality loss
during gameplay.
14
The „Restore“-Button re-converts all marked elements into the original DynaTrax format. The
„Rebuild“-Button allows a convertion from an existing DynaTrax into another DynaTrax-profile.
15
H) Mixed tracks
Some tracks may contain different track sets within a single tile...tracks with and without a
catenary, LZB-tracks, standard tracks, etc.
But by using the above mentioned replace-method in chapter E), all tracks will have the same
texture.
Therefore it is necessary to replace the differing tracks 'by hand'.
By looking into the world-files you can not identify the position of the different tracks, so the specific
tile must be opened and checked with a route-editor.
To do this, Goku's route-editor „TSRE5“ is highly recommended (OpenRails only).
This program is available for download from the following webside: „http://koniec.org/tsre5/“.
16
3) Identify tracks
The button „Select“ is activated in the track-editor and the specific track is selected by a
click on it with the left mouse button. The unique identification-number is displayed within
the field „UID“ in the upper left corner. In the field „FileName“ it is visible, if this track is a
regular track or a DynaTrax-element.
A normal track-segment can be changed immediately in the texteditor by searching the UID
in the specific world-file and by changing the entry „FileName“ in the section „TrackObj“ to
the desired DB-Track (as shown on page 11).
In case of a DynaTrax-element the UID should be seprately noted and changed later with
the programm „Dynatrax“ (as described in chapter „Transformation of the DynaTrax).
17
I) Adjustment of track altitude
It may be possible that after the transformation into DBTracks all the new tracks are either floating
or dug deep into the ground.
In this case the altitude of the tracks should be corrected.
Important: this adjustment must only be initiated when all transformation processes up to
chapter H) are executed.
@echo off
C:
cd "F:\"
ECHO ----------------------------------------
PAUSE
= Altitude in centimeters (+/-). After the first transformation the value of „+0.15“ is
recommended.
After these amendments the file must be saved as a Batch-file with a „.bat“ at the end of the file.
Furthermore the programm TSUtil must be installed. It is essential that the existing „classes“-folder
is copied into the Java-directory.
18
- new path-files (to be copied into the path-folder)
- new files (to be copied into the main route folder)
- new Lo_Tiles-files (to be copied into the Lo_Tiles-folder)
After that, the original „tsection.dat“ can again be replaced with a newer version.
1) Correction of point-animation
Sometimes the points/switches within a route are not animated. This can be corrected with
the program RouteRiter using the button „Correct Stuck Points“ in the „MSTS File Utils“
sheet.
3) WS-files can be moved in the world-folder again, in case they have been removed during
step one.
19