Route and Session Basics

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
m (Saving a Route and a Session)
m
(40 intermediate revisions by one user not shown)
Line 23: Line 23:
 
</tr>
 
</tr>
 
</table>
 
</table>
'''Routes''' are created in '''Surveyor''' and contain most (if not all) of what you will see in your virtual Trainz world. You can have multiple '''Routes''', limited only by your storage space. '''Routes''' can be built to represent different geographical regions (real or imagined) and different periods of time (past, present, future). Each '''Route''' can have one or more:-<br><br>
+
'''Routes''' are created in '''Surveyor''' and contain most (if not all) of what you will see in your virtual Trainz world. You can have multiple routes, limited only by your storage space. Routes can be built to represent different geographical regions (real or imagined) and different periods of time (past, present, future). Each route can have one or more:-<br><br>
 
<table cellpadding=4>
 
<table cellpadding=4>
 
<tr valign="top">
 
<tr valign="top">
Line 30: Line 30:
 
</tr>
 
</tr>
 
</table>
 
</table>
'''Sessions''' are also created in '''Surveyor''' but are designed to be run in '''Driver'''. '''Sessions''' contain the instructions that will control your trains when they are operating in automatic or "AI" mode in your '''Route'''. They also control the goods your trains will carry, load and unload at industries along the way, regardless of whether you are driving them manually or using the AI. You can create different '''Sessions''' for different aspects of your railway - freight, passenger, shunting or a mixture - or for different seasons of the year or times of the day. '''Sessions''' also control some of the environment settings in your virtual world, such as lighting and the weather. A '''Session''' can have many:-<br><br>
+
'''Sessions''' are also created in '''Surveyor''' but are designed to be run in '''Driver'''. Sessions contain the instructions that will control your trains when they are operating in automatic or "AI" mode in your route. They also control the goods your trains will carry, load and unload at industries along the way, regardless of whether you are driving them manually or using the AI. You can create different sessions for different aspects of your railway - freight, passenger, shunting or a mixture - or for different seasons of the year or times of the day. A session can also contain scenery items that are specific to a particular railway operation, season of the year or time of day that will only appear in that specific session. Sessions also control some of the environment settings in your virtual world, such as lighting and the weather. A session can have many:-<br><br>
 
<table cellpadding=4>
 
<table cellpadding=4>
 
<tr valign="top">
 
<tr valign="top">
Line 37: Line 37:
 
</tr>
 
</tr>
 
</table>
 
</table>
'''Driver Games''' (also known as '''Driver Sessions''' and '''Saved Games''') are created in '''Driver''' and save the "state of play" in a running '''Session''' so you can restart it at the same point at a later time. They are optionally stamped with the date and time they were saved and the play duration.</td>
+
'''Driver Games''' (also known as '''Driver Sessions''' and '''Saved Games''') are created in '''Driver''' and save the "state of play" in a running session so you can restart it at the same point at a later time. They are optionally stamped with the date and time they were saved and the play duration.</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 52: Line 52:
  
 
='''What is a Route?'''=
 
='''What is a Route?'''=
A '''Route''' (also known as a "Layout") consists of most of what you will see on the screen when using '''Surveyor''' and '''Driver'''. Things such as the landform or terrain, most (if not all) of the scenery items, the ground textures, the effect layers (TurfFX and Clutter), plus some "environmental" features.<br>
+
A route (also known as a "Layout") consists of most of what you will see on the screen when using '''Surveyor''' and '''Driver'''. Things such as the landform or terrain, most (if not all) of the scenery items, the ground textures, the effect layers (TurfFX and Clutter), plus some "environmental" features.<br>
  
A '''Route''' consists of two parts:-
+
A route consists of two parts:-
 
#'''Route Data''' and
 
#'''Route Data''' and
 
#'''Route Layers'''.
 
#'''Route Layers'''.
Line 71: Line 71:
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>The '''Route Data''' stores all those features that are '''painted''' into a layout using a '''brush tool'''</td>
 
<td>The '''Route Data''' stores all those features that are '''painted''' into a layout using a '''brush tool'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|link=]]</td>
 +
<td>The '''Route Data''' stores all the '''Environmental Data''' including the '''World Origin''' (latitude, longitude, altitude)</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 83: Line 87:
 
*'''Ground Textures''' including the grid pattern which is a texture
 
*'''Ground Textures''' including the grid pattern which is a texture
 
*'''TurfFX and Clutter''' - found in the '''Effects Layers'''
 
*'''TurfFX and Clutter''' - found in the '''Effects Layers'''
*'''Environmental Settings''' - '''World Origin''' (latitude, longitude, altitude), '''Water Surface''' (rough/calm/etc), '''Snow Altitude''', '''Lighting''' (sun, ambient and water colours), '''Sky''' (clouds), '''Road Traffic''' (on/off), '''Date''' (day, month), '''Wind''' strength, '''Fog''' level, '''Weather''' (rain/fine/snow), '''Brightness''' level. You must edit and save the '''Route''' for these settings to become part of the '''Route Data''' - see '''[[image:WikiLink.PNG|link=]]&nbsp;[[How_to_Use_Environment_Tools|How to Use Environment Tools]]''' for more details.<br>
+
*'''Environmental Settings''' - '''World Origin''' (latitude, longitude, altitude), '''Water Surface''' (rough/calm/etc), '''Snow Altitude''', '''Lighting''' (sun, ambient and water colours), '''Sky''' (clouds), '''Road Traffic''' (on/off), '''Date''' (day, month), '''Wind''' strength, '''Fog''' level, '''Weather''' (rain/fine/snow), '''Brightness''' level. You must edit and save the route for these settings to become part of the '''Route Data''' - see the Trainz Wiki page '''[[image:WikiLink.PNG|link=]]&nbsp;[[How_to_Use_Environment_Tools|How to Use the Environment Tools]]''' for more details.<br>
 
<span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&nbsp;Route Layers:&nbsp;</span>
 
<span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&nbsp;Route Layers:&nbsp;</span>
 
<table cellpadding=4 bgcolor=#c1e7e7>
 
<table cellpadding=4 bgcolor=#c1e7e7>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>'''Route Layers''' are used to hold the scenery assets that you want to appear in all '''Sessions''' created for the '''Route'''</td>
+
<td>'''Route Layers''' are used to hold the scenery assets that you want to appear in all sessions created for the route</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
  
All scenery assets are held in layers. '''Route Layers''' give you a way of organising or grouping the assets displayed in your '''Route'''.  
+
All scenery assets are held in layers. '''Route Layers''' give you a way of organising or grouping the assets displayed in your route.  
  
 
[[image:Woolshed_Route_Layers.png|link=|alt=Route Layers]]
 
[[image:Woolshed_Route_Layers.png|link=|alt=Route Layers]]
Line 105: Line 109:
 
*Lineside and Fixed Cameras
 
*Lineside and Fixed Cameras
 
*Trackmarks, Triggers, Direction and Priority Marks
 
*Trackmarks, Triggers, Direction and Priority Marks
 
+
<br>
 +
<table bgcolor=#000000 width=900 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffb0 cellpadding=2>
 +
<tr valign="top">
 +
<td>[[image:NotePad.PNG|link=]]</td>
 +
<td>Scenery objects can also be stored in a session. This can cause confusion if you load a route without loading a session and find that some scenery items are "missing". See [[image:PageLink.PNG|link=]] '''[[#Loading an Existing Route|Loading an Existing Route]]''' below for how to deal with this issue.</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 
<table cellpadding=4 bgcolor="Aquamarine">
 
<table cellpadding=4 bgcolor="Aquamarine">
 
<tr valign="top">
 
<tr valign="top">
Line 126: Line 143:
  
 
='''Loading (and Creating) a Route'''=
 
='''Loading (and Creating) a Route'''=
The Main Menu screen is shown below. The first option (shown highlighted in the image) opens '''Driver/Surveyor''' with all its options including loading and creating a '''Route'''.<br>
+
The Main Menu screen is shown below. The first option (shown highlighted in the image) opens '''Driver/Surveyor''' with all its options including loading and creating a route.<br>
  
 
[[image:TRS19MainScreen.png|link=|alt=TRS19 Main Screen options]]
 
[[image:TRS19MainScreen.png|link=|alt=TRS19 Main Screen options]]
Line 135: Line 152:
  
 
The <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;MAIN MENU&nbsp;</span> button will take you back to the starting or main screen.<br>
 
The <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;MAIN MENU&nbsp;</span> button will take you back to the starting or main screen.<br>
The <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Sort By A-Z&nbsp;</span> will give you a drop down menu of sorting options for the thumbnail list.<br>
+
The <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Sort By A-Z&nbsp;</span> (top right of the image above) will give you a drop down menu of sorting options for the thumbnail list.<br>
 
The [[image:MainScreenDownArrow.png|link=]] button will expand the thumbnail list to fill the screen - click it again to return the thumbnails to the strip at the bottom of the screen.<br>
 
The [[image:MainScreenDownArrow.png|link=]] button will expand the thumbnail list to fill the screen - click it again to return the thumbnails to the strip at the bottom of the screen.<br>
  
 
The thumbnail images are colour coded.<br>
 
The thumbnail images are colour coded.<br>
  
<table>
+
<table width=900>
 
<tr valign="top">
 
<tr valign="top">
 
<td bgcolor=#ffae00 width=50>&nbsp;</td>
 
<td bgcolor=#ffae00 width=50>&nbsp;</td>
<td>'''Payware'''</td>
+
<td width=150>'''Payware on DLC'''</td>
<td>'''DLC''' - must be purchased. '''DLC''' items cannot be deleted. To remove them use the '''Uninstall''' option in the '''Content Store''' from the '''Launcher'''. You can reinstall them later without any additional cost</td>
+
<td>Must be purchased and downloaded, but some may be free. There will be a <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;DOWNLOAD&nbsp;</span> button on the bottom right of the screen. If a price is included in the button then that is the purchase price (in $US)</td>
 +
</tr>
 +
<tr valign="top">
 +
<td bgcolor=#10c810 width=50>&nbsp;</td>
 +
<td>'''Payware installed'''</td>
 +
<td>Already installed from the '''DLC'''. '''DLC''' items cannot be deleted. To remove them use the '''Uninstall''' option in the '''Content Store''' from the '''Launcher'''. You can reinstall them later without any additional cost</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
Line 152: Line 174:
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
<td bgcolor=#848dff width=50>&nbsp;</td>
+
<td bgcolor=#848dff width=50>&nbsp;<br>&nbsp;</td>
<td>'''Not Installed'''</td>
+
<td>'''Multiplayer'''</td>
<td>Needs to be downloaded and installed before you can use this route</td>
+
<td>For simultaneous development by multiple players. Special conditions apply</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
 
=='''Creating a New Route'''==
 
=='''Creating a New Route'''==
On the '''Driver/Surveyor''' screen the '''Route''' options are shown as a set of buttons at the bottom of the screen.
+
On the '''Driver/Surveyor''' screen the route options are shown as a set of buttons at the bottom of the screen.
  
 
[[image:RouteButtonsCreate.png|link=|alt=Create a New Route]]
 
[[image:RouteButtonsCreate.png|link=|alt=Create a New Route]]
Line 175: Line 197:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:PencilTips.PNG|link=]]</td>
 
<td>[[image:PencilTips.PNG|link=]]</td>
<td>All these settings plus others can be easily changed at any time after the '''Route''' has been created.
+
<td>All these settings plus others can be easily changed at any time after the route has been created.
 
<table>
 
<table>
 
<tr>
 
<tr>
Line 225: Line 247:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint1.JPG|link=]]</td>
 
<td>[[image:DotPoint1.JPG|link=]]</td>
<td>You do not have to add the name of a '''Session''' but when you save a new '''Route''' without a named '''Session''' a default '''Session''' will be automatically saved with the name '''Default'''. This can later cause confusion if a multitude of different '''Default Sessions''' appear so it is '''recommended''' that a unique '''Session name''' be entered at this point.</td>
+
<td>You do not have to add the name of a session but when you save a new route without a named session a default session will be automatically saved with the name '''Default'''. This can later cause confusion if a multitude of different '''Default Sessions''' appear so it is '''recommended''' that a unique '''Session name''' be entered at this point.</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
 
<td>&nbsp;</td>
 
<td>&nbsp;</td>
<td>A '''Session''' can always be deleted later if you have no interest in creating one for your '''Route''' - see '''[[file:PageLink.PNG|link=]]&nbsp;[[#Deleting Routes and Sessions|Deleting Routes and Sessions]]''' below. However a '''Route''' with a '''Session''' does have some important advantages - see '''[[file:PageLink.PNG|link=]]&nbsp;[[#What is a Session?|What is a Session?]]''' below.</td>
+
<td>A session can always be deleted later if you have no interest in creating one for your route - see '''[[file:PageLink.PNG|link=]]&nbsp;[[#Deleting Routes and Sessions|Deleting Routes and Sessions]]''' below. However a route with a session does have some important advantages - see '''[[file:PageLink.PNG|link=]]&nbsp;[[#What is a Session?|What is a Session?]]''' below.</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint2.JPG|link=]]</td>
 
<td>[[image:DotPoint2.JPG|link=]]</td>
<td>Setting a '''Geographical region''' sets some basic features of the '''Route''' - such as its latitude (used to determine the season of the year), the altitude (in metres) of the first baseboard, the number and types of moving road vehicles (if any), to name a few. If none of the installed regions are suitable you can download others from the '''DLS''' or create a region of your own - see '''[[image:WikiLink.PNG|link=]]&nbsp;[[How to Create a Region Asset|How to Create a Region Asset]]'''</td>
+
<td>Setting a '''Geographical region''' sets some basic features of the route - such as its latitude (used to determine the season of the year), the altitude (in metres) of the first baseboard, the number and types of moving road vehicles (if any), to name a few. If none of the installed regions are suitable you can download others from the '''DLS''' or create a region of your own - see '''[[image:WikiLink.PNG|link=]]&nbsp;[[How to Create a Region Asset|How to Create a Region Asset]]'''</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
Line 251: Line 273:
  
 
=='''Loading an Existing Route'''==
 
=='''Loading an Existing Route'''==
You must first find and select the '''Route''' to load from those already installed. At the top of the '''Driver/Surveyor''' screen the '''Route''' search options are shown as a set of buttons.
+
You must first find and select the route to load from those already installed. At the top of the '''Driver/Surveyor''' screen the route search options are shown as a set of buttons.
  
 
[[image:RouteSearchButtons.png|link=|alt=Route Search]]
 
[[image:RouteSearchButtons.png|link=|alt=Route Search]]
Line 262: Line 284:
 
<tr valign="top">
 
<tr valign="top">
 
<td>'''Source:'''</td>
 
<td>'''Source:'''</td>
<td><span style="background-color: black; color: white; font-weight: 700;">&nbsp;PURCHASED&nbsp;</span> is the default selection, Click and change to <span style="background-color: black; color: white; font-weight: 700;">&nbsp;MY CONTENT&nbsp;</span> for a '''Route''' you have created (or already modified) or to <span style="background-color: black; color: white; font-weight: 700;">&nbsp;INSTALLED&nbsp;</span> for one you have downloaded from the '''DLS'''.</td>
+
<td><span style="background-color: black; color: white; font-weight: 700;">&nbsp;PURCHASED&nbsp;</span> is the default selection, Click and change to <span style="background-color: black; color: white; font-weight: 700;">&nbsp;MY CONTENT&nbsp;</span> for a route you have created (or already modified) or to <span style="background-color: black; color: white; font-weight: 700;">&nbsp;INSTALLED&nbsp;</span> for one you have downloaded from the '''DLS'''.</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
 
<td>'''Region:'''</td>
 
<td>'''Region:'''</td>
<td><span style="background-color: black; color: white; font-weight: 700;">&nbsp;ALL&nbsp;</span> is the default selection. You can select a particular geographic region if required and '''IF''' the '''Route''' had a geographic region set when it was created.</td>
+
<td><span style="background-color: black; color: white; font-weight: 700;">&nbsp;ALL&nbsp;</span> is the default selection. You can select a particular geographic region if required and '''IF''' the route had a geographic region set when it was created.</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
 
<td>'''Search:'''</td>
 
<td>'''Search:'''</td>
<td>You can narrow down the list of '''Routes''' by typing the first few letters of its name (e.g. '''SA''') as shown in the image above.</td>
+
<td>You can narrow down the list of routes by typing the first few letters of its name (e.g. '''SA''') as shown in the image above.</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 277: Line 299:
 
[[image:RouteSelectExisting.png|link=|alt=Existing Routes]]
 
[[image:RouteSelectExisting.png|link=|alt=Existing Routes]]
  
Click on the thumbnail for the '''Route''' you want to load, then click on the <span style="background-color: black; color: white; font-weight: 700; font-size: 15px;">&nbsp;EDIT ROUTE&nbsp;</span> button to load the '''Route''' into '''Surveyor'''.
+
Click on the thumbnail for the route you want to load, then click on the <span style="background-color: black; color: white; font-weight: 700; font-size: 15px;">&nbsp;EDIT ROUTE&nbsp;</span> button to load the route into '''Surveyor'''.
  
 
[[image:RouteButtonsEdit.png|link=|alt=Edit Route]]
 
[[image:RouteButtonsEdit.png|link=|alt=Edit Route]]
 +
<br><br>
 +
<table bgcolor=#000000 cellpadding=2 width=900>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffb0 cellpadding=2>
 +
<tr valign="top">
 +
<td>[[image:NotePad.PNG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">Notes: Routes and Sessions - An Endless Source of Confusion</span>
 +
----
 +
Scenery objects that have been placed in a session will '''NOT APPEAR''' if the route has been loaded into '''Surveyor''' without also loading the session.<br>
 +
 +
If scenery objects have mysteriously vanished when you reload a route into '''Surveyor''' it is highly likely that those objects have been saved in a session. You must load the session into '''Surveyor''' to make them visible again.<br>
 +
 +
You can easily move most scenery objects from a session into a route if needed - see the Trainz Wiki Page '''[[image:WikiLink.PNG|link=]]&nbsp;[[How_to_Use_Bulk_Asset_Update/Replace_Tool|How to Use the Bulk Asset Update/Replace Tool]]''' for more details.
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
  
 
=='''Loading a Route Into Surveyor From Content Manager'''==
 
=='''Loading a Route Into Surveyor From Content Manager'''==
'''Trainz''' provides a shortcut that allows you to load an existing '''Route''' directly into '''Surveyor''' for editing from '''Content Manager'''.<br>
+
'''Trainz''' provides a shortcut that allows you to load an existing route directly into '''Surveyor''' for editing from '''Content Manager'''.<br>
  
 
<table>
 
<table>
Line 297: Line 339:
 
<td><span style="font-size: 17px; font-weight: 700;">Steps:</span><br>
 
<td><span style="font-size: 17px; font-weight: 700;">Steps:</span><br>
 
#in '''Content Manager''' select the filter '''Routes & Sessions'''
 
#in '''Content Manager''' select the filter '''Routes & Sessions'''
#select the '''Route''' to be edited
+
#select the route to be edited
 
#use the '''right-mouse-button''' to open the '''Command Menu'''
 
#use the '''right-mouse-button''' to open the '''Command Menu'''
 
#select '''Open...''', then
 
#select '''Open...''', then
Line 313: Line 355:
  
 
=='''Loading After an Unexpected Shutdown'''==
 
=='''Loading After an Unexpected Shutdown'''==
If you select a '''Route''' for loading after an unexpected shutdown of '''Trainz''' then any '''Route''' (or '''Route''' and '''Session''') that was open and running in '''Trainz Surveyor''' or '''Driver''' will be left marked as '''Open for Edit'''. When you attempt to load this '''Route''' into '''Surveyor''' or '''Driver''' you will see a message listing the '''Route''' and '''Session''' (if any) that were affected.<br>
+
If you select a route for loading after an unexpected shutdown of '''Trainz''' then any route (or route and session) that was open and running in '''Trainz Surveyor''' or '''Driver''' will be left marked as '''Open for Edit'''. When you attempt to load this route into '''Surveyor''' or '''Driver''' you will see a message listing the route and session (if any) that were affected.<br>
 
<table width=1000>
 
<table width=1000>
 
<tr valign="top">
 
<tr valign="top">
Line 326: Line 368:
 
<td><span style="font-size: 17px; font-weight: 700;">Note:'''</span>
 
<td><span style="font-size: 17px; font-weight: 700;">Note:'''</span>
 
----
 
----
A similar message will appear when you load a '''Driver Game''' (see '''[[file:PageLink.PNG|link=]]&nbsp;[[#Saving and Loading Sessions in Driver|Saving and Loading Sessions in Driver]]''' below) after editing the original '''Route''' or '''Session''' that was used to create the '''Driver Session'''.<br>
+
A similar message will appear when you load a '''Driver Game''' (see '''[[file:PageLink.PNG|link=]]&nbsp;[[#Saving and Loading Sessions in Driver|Saving and Loading Sessions in Driver]]''' below) after editing the original route or session that was used to create the '''Driver Session'''.<br>
  
 
It is possible that the changes you have made may affect the operation of the '''Driver Session'''.</td>
 
It is possible that the changes you have made may affect the operation of the '''Driver Session'''.</td>
Line 338: Line 380:
 
</table>
 
</table>
  
The message is saying that the assets in the list '''may have been''' changed since the last time you loaded them and exited '''Trainz''' normally. For example if you had been editing the '''Route''' and/or '''Session''' and had experienced a crash to the desktop or had used Windows '''Task Manager''' to terminate the program.<br>
+
The message is saying that the assets in the list '''may have been''' changed since the last time you loaded them and exited '''Trainz''' normally. For example if you had been editing the route and/or session and had experienced a crash to the desktop or had used Windows '''Task Manager''' to terminate the program.<br>
  
 
The options you will see are:-<br>
 
The options you will see are:-<br>
Line 358: Line 400:
 
</tr>
 
</tr>
 
</table>
 
</table>
You could also use the '''Content Manager''' program (select <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Manage Content&nbsp;</span> from the '''Trainz Launcher''') to Submit the open '''Route''' or '''Route''' and '''Session''' assets. This has the risk of replacing the last good copy of that asset or assets with a possibly faulty copy.
+
You could also use the '''Content Manager''' program (select <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Manage Content&nbsp;</span> from the '''Trainz Launcher''') to Submit the open route or route and session assets. This has the risk of replacing the last good copy of that asset or assets with a possibly faulty copy.
 
<br>
 
<br>
  
Line 369: Line 411:
 
</table>
 
</table>
  
When you create a new '''Route''' (with or without a named '''Session'''), or load an existing '''Route''' without a '''Session''', and start adding scenery assets they will automatically be placed into a '''Route Layer'''. See '''[[image:WikiLink.PNG|link=]]&nbsp;[[How_to_Use_Layers|How to Use Layers]]''' for more details.<br>
+
When you create a new route (with or without a named session), or load an existing route without a session, and start adding scenery assets they will automatically be placed into a '''Route Layer'''. See '''[[image:WikiLink.PNG|link=]]&nbsp;[[How_to_Use_Layers|How to Use Layers]]''' for more details.<br>
  
 
Any ground textures, water, effect layers (turfFX and clutter) you add, or terrain changes (including new baseboards) you make, will be added to the '''Route Data'''.<br>
 
Any ground textures, water, effect layers (turfFX and clutter) you add, or terrain changes (including new baseboards) you make, will be added to the '''Route Data'''.<br>
Line 380: Line 422:
 
<td>[[file:Stop.PNG|link=]]</td>
 
<td>[[file:Stop.PNG|link=]]</td>
 
<td>
 
<td>
<span style="font-size: 15px; font-weight: 700;">WARNING:</span><br>
+
<span style="font-weight: 700; font-size: 15px;">WARNING: Do not edit track in a Route that is occupied by consists in any of the Sessions based on the Route</span><br>
  
Moving or deleting a section of track that is occupied by a train will cause problems particularly if the train is in a '''Session''' and you have only loaded the '''Route''' for editing. The train will most likely become a "missing asset".<br><br>
+
'''Moving or deleting a section of track in a Route that is occupied by a consist in a Session can cause the consist to become a "missing asset"'''. This can happen if you load the Route only and not the Session. If a consist becomes a "missing asset" then the only immediate solution is to use the '''Delete missing assets''' command from the '''Tools''' menu in '''Surveyor'''.<br>
  
'''Move or delete any affected trains first before editing the track''' by loading and editing the '''Session''', not just the '''Route'''. See '''[[image:PageLink.PNG|link=]]&nbsp;[[#Loading an Existing Session|Loading an Existing Session]]''' and '''[[image:PageLink.PNG|link=]]&nbsp;[[#Editing a Session|Editing a Session]]''' below.
+
<span style="font-size: 15px; font-weight: 700;">Prevention:</span><br>
 +
 
 +
if you have the consists placed in a Session then always '''load the Session''', not just the Route, and move or delete any consists '''BEFORE''' editing the track they are occupying.
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 461: Line 505:
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
=='''Merging Routes'''==
 +
<table cellpadding=4 bgcolor=#c1e7e7>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|link=]]</td>
 +
<td>'''Two (or more) separate routes can be joined together (merged) to create a new route'''</td>
 +
</tr>
 +
</table>
 +
 +
There are some important restrictions on the merging of two routes:-
 +
*'''Payware (DLC)''' routes cannot be merged with '''Freeware (DLS)''' or other '''Payware''' routes
 +
*The '''Session Data''' and '''Session Layers''' in the first route can be saved in the merger, if required, but those in the other route are not
 +
*There may be a significant height difference between the two routes and this may not be easy to overcome
 +
*The orientation of the two routes (East-West or North-South) cannot be changed
 +
<br>
 +
<table cellpadding=4 bgcolor="Aquamarine">
 +
<tr valign="top">
 +
<td>[[image:LinkWiki.PNG|link=]]</td>
 +
<td>
 +
A detailed description of the process of '''Merging Routes''' can be found on the '''Trainz Wiki Page [[How_to_Merge_Routes|How to Merge Routes]]'''<br>
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 487: Line 554:
 
</tr>
 
</tr>
 
</table>
 
</table>
In general, while a '''Route''' provides the physical structures (or "hardware"), a '''Session''' provides the services (or "software"). While you can easily have a '''Route''' without a '''Session''', it could be a very limited (or even a boring) experience.<br>
+
In general, while a route provides the physical structures (or "hardware"), a session provides the services (or "software"). While you can easily have a route without a session, it could be a very limited (or even a boring) experience.<br>
  
A single '''Route''' can have multiple '''Sessions''', or none, but a '''Session''' must always belong to a '''Route'''. To put it into '''Trainz''' terminology, a '''Session''' has a '''Route''' as a '''''dependency'''''.<br>
+
A single route can have multiple sessions, or none, but a session must always belong to a route. To put it into '''Trainz''' terminology, a session has a route as a '''''dependency'''''.<br>
  
A '''Session''' consists of two parts:-
+
A session consists of two parts:-
 
#'''Session Data''' and
 
#'''Session Data''' and
 
#'''Session Layers'''.
 
#'''Session Layers'''.
Line 505: Line 572:
 
<span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&nbsp;Session Data:&nbsp;</span>
 
<span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&nbsp;Session Data:&nbsp;</span>
  
'''Session Data''' are often the "invisibles" that control the operation of a '''Session'''. Session rules, driver orders and loco assignments, commodities (loaded, unloaded and carried) and most of the '''Environmental Settings''' are examples of '''Session Data'''.
+
'''Session Data''' are often the "invisibles" that control the operation of a session. Session rules, driver orders and loco assignments, commodities (loaded, unloaded and carried) and most of the '''Environmental Settings''' are examples of '''Session Data'''.
  
 
[[image:Woolshed_Session_Data.png|link=|alt=Session Data]]
 
[[image:Woolshed_Session_Data.png|link=|alt=Session Data]]
Line 515: Line 582:
 
*'''Industry Settings''' (commodities consumed and produced)
 
*'''Industry Settings''' (commodities consumed and produced)
 
*'''Consist Settings''' (commodities carried)
 
*'''Consist Settings''' (commodities carried)
*'''Consist Locations''' - this is stored in the '''Session''' even if the consists are placed in the '''Route'''
+
*'''Consist Locations''' - this is stored in the session even if the consists are placed in the route
*'''Switch Settings''' (left/right) - but the '''default''' switch direction is stored in the '''Route'''
+
*'''Switch Settings''' (left/right) - but the '''default''' switch direction is stored in the route
*'''Environmental Settings''' - '''Water Surface''' (rough/calm/etc), '''Snow Altitude''', '''Lighting''' (sun, ambient and water colours), '''Sky''' (clouds), '''Road Traffic''' (on/off), '''Date''' (day, month), '''Wind''' strength, '''Fog''' level, '''Weather''' (rain/fine/snow), '''Brightness''' level. You must edit and save the '''Session''' for these settings to become part of the '''Session Data''' - see '''[[image:WikiLink.PNG|link=]]&nbsp;[[How_to_Use_Environment_Tools|How to Use Environment Tools]]''' for more details. If both a '''Route''' and a '''Session''' have saved '''Environmental Settings''', which do not have to be the same, then those in the '''Session''' will be used. If the '''Session''' does not have any saved '''Environmental Settings''' then those in the '''Route''' will be used
+
*'''Environmental Settings''' - '''Water Surface''' (rough/calm/etc), '''Snow Altitude''', '''Lighting''' (sun, ambient and water colours), '''Sky''' (clouds), '''Road Traffic''' (on/off), '''Date''' (day, month), '''Wind''' strength, '''Fog''' level, '''Weather''' (rain/fine/snow), '''Brightness''' level. You must edit and save the session for these settings to become part of the '''Session Data''' - see '''[[image:WikiLink.PNG|link=]]&nbsp;[[How_to_Use_Environment_Tools|How to Use Environment Tools]]''' for more details. If both a route and a session have saved '''Environmental Settings''', which do not have to be the same, then those in the session will be used. If the session does not have any saved '''Environmental Settings''' then those in the route will be used
 
<br>
 
<br>
 
<span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&nbsp;Session Layers:&nbsp;</span>
 
<span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&nbsp;Session Layers:&nbsp;</span>
Line 534: Line 601:
 
[[image:Woolshed_Session_Layers.png|link=|alt=Session layers]]
 
[[image:Woolshed_Session_Layers.png|link=|alt=Session layers]]
  
'''Session Layers''' give you a way of organising or grouping the assets displayed in your '''Session'''.<br>
+
'''Session Layers''' give you a way of organising or grouping the assets displayed in your session.<br>
  
 
<table width=800>
 
<table width=800>
Line 582: Line 649:
 
<td><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br>
 
<td><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br>
 
----
 
----
'''Scenery''', '''Rolling Stock''', '''Triggers''' and '''Markers''' (Track, Direction, Priority) can be used in both '''Route Layers''' and '''Session Layers'''. Assets placed in a '''Route Layer''' will appear in all '''Sessions''' that are based on the '''Route'''. The vast majority of (if not all) scenery items will be placed in '''Route Layers'''. Assets placed in a '''Session Layer''' will only appear in the currently loaded '''Session'''.  
+
'''Scenery''', '''Rolling Stock''', '''Triggers''' and '''Markers''' (Track, Direction, Priority) can be used in both '''Route Layers''' and '''Session Layers'''. Assets placed in a '''Route Layer''' will appear in all sessions that are based on the route. The vast majority of (if not all) scenery items will be placed in '''Route Layers'''. Assets placed in a '''Session Layer''' will only appear in the currently loaded session.  
  
 
Examples of assets that would be placed in a '''Session Layer''' instead of a '''Route Layer''' would include:-
 
Examples of assets that would be placed in a '''Session Layer''' instead of a '''Route Layer''' would include:-
  
*products waiting at a factory for pickup in an industrial '''Session''' that would not be present in a weekend or holiday passenger '''Session'''
+
*products waiting at a factory for pickup in an industrial session that would not be present in a weekend or holiday passenger session
*signallers holding lanterns in a night '''Session''' only or standing alongside manual track switch levers in a daylight shunting '''Session'''
+
*signallers holding lanterns in a night session only or standing alongside manual track switch levers in a daylight shunting session
*trackmarks and triggers that are only required in one '''Session''' but not in all '''Sessions'''
+
*trackmarks and triggers that are only required in one session but not in all sessions
*crowds of onlookers alongside the track in a '''Session''' recreating an historic steam train run, together with
+
*crowds of onlookers alongside the track in a session recreating an historic steam train run, together with
*historic rolling stock in a special vintage train '''Session''' running on a modern '''Route'''
+
*historic rolling stock in a special vintage train session running on a modern route
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 617: Line 684:
 
</tr>
 
</tr>
 
</table>
 
</table>
A new '''Session''' can be created in two ways:-<br>
+
A new session can be created in two ways:-<br>
  
 
<table width=900>
 
<table width=900>
Line 626: Line 693:
 
<td width=450>[[image:RouteSARWindow.png|link=|alt=Route Details]]</td>
 
<td width=450>[[image:RouteSARWindow.png|link=|alt=Route Details]]</td>
 
<td>Follow the steps shown in the section '''[[file:PageLink.PNG|link=]]&nbsp;[[#Creating a New Route|Creating a New Route]]''' above by entering:-
 
<td>Follow the steps shown in the section '''[[file:PageLink.PNG|link=]]&nbsp;[[#Creating a New Route|Creating a New Route]]''' above by entering:-
*a '''Route name''' for the new '''Route'''
+
*a '''Route name''' for the new route
*a '''Session name''' for the new '''Session'''
+
*a '''Session name''' for the new session
 
*a '''Geographical region'''
 
*a '''Geographical region'''
 
*'''Working scale''' and '''Working units'''</td>
 
*'''Working scale''' and '''Working units'''</td>
Line 648: Line 715:
 
<td><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br>
 
<td><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br>
 
----
 
----
A '''Route''' can have many individual '''Sessions''' so a new '''Session''' can be added to an existing '''Route''' that already has '''Sessions''' installed.
+
A route can have many individual sessions so a new session can be added to an existing route that already has sessions installed.
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 656: Line 723:
 
</table>
 
</table>
  
The first step is to locate (but not load) the '''Route''' as described in the section '''[[file:PageLink.PNG|link=]]&nbsp;[[#Loading an Existing Route|Loading an Existing Route]]''' above.
+
The first step is to locate (but not load) the route as described in the section '''[[file:PageLink.PNG|link=]]&nbsp;[[#Loading an Existing Route|Loading an Existing Route]]''' above.
  
Once you have selected the '''Route''' from its thumbnail, click the <span style="background-color: black; color: white; font-weight: 700; font-size: 15px;">&nbsp;VIEW SESSIONS&nbsp;</span> button.
+
Once you have selected the route from its thumbnail, click the <span style="background-color: black; color: white; font-weight: 700; font-size: 15px;">&nbsp;VIEW SESSIONS&nbsp;</span> button.
  
 
[[image:RouteButtonsView.png|link=|alt=View Sessions]]
 
[[image:RouteButtonsView.png|link=|alt=View Sessions]]
  
Then click the <span style="background-color: black; color: white; font-weight: 700; font-size: 15px;">&nbsp;CREATE SESSION&nbsp;</span> button. If no other '''Session''' exists for this '''Route''' then this will be the only choice available to you.
+
Then click the <span style="background-color: black; color: white; font-weight: 700; font-size: 15px;">&nbsp;CREATE SESSION&nbsp;</span> button. If no other session exists for this route then this will be the only choice available to you.
  
 
[[image:SessionButtonsCreate.png|link=|alt=Create Session]]
 
[[image:SessionButtonsCreate.png|link=|alt=Create Session]]
Line 672: Line 739:
 
</table>
 
</table>
  
Both methods will load the '''Route''' into '''Surveyor''' and create a new '''Session''' with all its values/parameters set at '''default''' levels.
+
Both methods will load the route into '''Surveyor''' and create a new session with all its values/parameters set at '''default''' levels.
  
 
=='''Loading an Existing Session'''==
 
=='''Loading an Existing Session'''==
There are two different ways to load existing '''Sessions''' into '''Surveyor'''.<br>
+
There are two different ways to load existing sessions into '''Surveyor'''.<br>
 
<table width=900>
 
<table width=900>
 
<tr valign="top">
 
<tr valign="top">
Line 681: Line 748:
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
<td>The easiest way to load an existing '''Session''' is to use the search tools at the top of the '''Driver/Surveyor''' screen.
+
<td>The easiest way to load an existing session is to use the search tools at the top of the '''Driver/Surveyor''' screen.
  
 
[[image:SessionSearchButtons.png|link=|alt=Session Search]]
 
[[image:SessionSearchButtons.png|link=|alt=Session Search]]
Line 692: Line 759:
 
<tr valign="top">
 
<tr valign="top">
 
<td>'''Source:'''</td>
 
<td>'''Source:'''</td>
<td><span style="background-color: black; color: white; font-weight: 700;">&nbsp;PURCHASED&nbsp;</span> is the default selection, Click and change to <span style="background-color: black; color: white; font-weight: 700;">&nbsp;MY CONTENT&nbsp;</span> for a '''Session''' you have created (or already modified) or to <span style="background-color: black; color: white; font-weight: 700;">&nbsp;INSTALLED&nbsp;</span> for one you have downloaded from the '''DLS'''.</td>
+
<td><span style="background-color: black; color: white; font-weight: 700;">&nbsp;PURCHASED&nbsp;</span> is the default selection, Click and change to <span style="background-color: black; color: white; font-weight: 700;">&nbsp;MY CONTENT&nbsp;</span> for a session you have created (or already modified) or to <span style="background-color: black; color: white; font-weight: 700;">&nbsp;INSTALLED&nbsp;</span> for one you have downloaded from the '''DLS'''.</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
Line 700: Line 767:
 
<tr valign="top">
 
<tr valign="top">
 
<td>'''Search:'''</td>
 
<td>'''Search:'''</td>
<td>If required you can narrow down the list of '''Sessions''' by typing the first few letters of its name.</td>
+
<td>If required you can narrow down the list of sessions by typing the first few letters of its name.</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 707: Line 774:
 
</table>
 
</table>
  
This will produce a list of '''Session''' thumbnails at the bottom of the screen. As with the '''Route''' thumbnails, the list can be scrolled horizontally.<br>
+
This will produce a list of session thumbnails at the bottom of the screen. As with the route thumbnails, the list can be scrolled horizontally.<br>
  
 
[[image:SessionSelectExisting.png|link=|alt=Existing Sessions]]
 
[[image:SessionSelectExisting.png|link=|alt=Existing Sessions]]
  
The same colour coding system used in the '''Route''' thumbnails also applies to '''Session''' thumbnails.<br>
+
The same colour coding system used in the route thumbnails also applies to session thumbnails.<br>
  
 
<table width=900>
 
<table width=900>
 
<tr valign="top">
 
<tr valign="top">
 
<td bgcolor=#ffae00 width=50>&nbsp;</td>
 
<td bgcolor=#ffae00 width=50>&nbsp;</td>
<td>'''Payware'''</td>
+
<td width=150>'''Payware on DLC'''</td>
<td>'''DLC''' - must be purchased. '''DLC''' items cannot be deleted. To remove them use the '''Uninstall''' option in the '''Trainz Store''' from the '''Launcher'''. You can reinstall them later without any additional cost</td>
+
<td>Must be purchased and downloaded, but some may be free. There will be a <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;DOWNLOAD&nbsp;</span> button on the bottom right of the screen. If a price is included in the button then that is the purchase price (in $US)</td>
 +
</tr>
 +
<tr valign="top">
 +
<td bgcolor=#10c810 width=50>&nbsp;</td>
 +
<td>'''Payware installed'''</td>
 +
<td>Already installed from the '''DLC'''. '''DLC''' items cannot be deleted. To remove them use the '''Uninstall''' option in the '''Content Store''' from the '''Launcher'''. You can reinstall them later without any additional cost</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
Line 725: Line 797:
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
<td bgcolor=#848dff width=50>&nbsp;</td>
+
<td bgcolor=#848dff width=50>&nbsp;<br>&nbsp;</td>
<td>'''Not Installed'''</td>
+
<td>'''Multiplayer'''</td>
<td>Needs to be downloaded and installed before you can use this session</td>
+
<td>For simultaneous development by multiple players. Special conditions apply</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<br>
 
<br>
Click on the thumbnail for the '''Session''' you want to load and then click on the <span style="background-color: black; color: white; font-weight: 700; font-size: 15px;">&nbsp;EDIT SESSION&nbsp;</span> button. This will load '''BOTH''' the '''Route''' and the '''Session''' into '''Surveyor'''.
+
Click on the thumbnail for the session you want to load and then click on the <span style="background-color: black; color: white; font-weight: 700; font-size: 15px;">&nbsp;EDIT SESSION&nbsp;</span> button. This will load '''BOTH''' the route and the session into '''Surveyor'''.
  
 
[[image:SessionButtonsEdit2.png|link=|alt=Edit Session]]
 
[[image:SessionButtonsEdit2.png|link=|alt=Edit Session]]
Line 742: Line 814:
 
<td>[[image:NotePad.PNG|link=]]</td>
 
<td>[[image:NotePad.PNG|link=]]</td>
 
<td>
 
<td>
If the <span style="background-color: black; color: white; font-weight: 700; font-size: 15px;">&nbsp;EDIT SESSION&nbsp;</span> option is not present then the selected '''Session''' is a saved '''Driver Game'''  (a "game" saved when in '''Driver''') and cannot be edited. See the section '''[[file:PageLink.PNG|link=]]&nbsp;[[#Saving and Loading Sessions in Driver|Saving and Loading Sessions in Driver]]''' below.
+
If the <span style="background-color: black; color: white; font-weight: 700; font-size: 15px;">&nbsp;EDIT SESSION&nbsp;</span> option is not present then the selected session is a saved '''Driver Game'''  (a "game" saved when in '''Driver''') and cannot be edited. See the section '''[[file:PageLink.PNG|link=]]&nbsp;[[#Saving and Loading Sessions in Driver|Saving and Loading Sessions in Driver]]''' below.
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 755: Line 827:
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
<td>Select the '''Route''' as described in the section '''[[file:PageLink.PNG|link=]]&nbsp;[[#Loading an Existing Route|Loading an Existing Route]]''' above. Then click the <span style="background-color: black; color: white; font-weight: 700; font-size: 15px;">&nbsp;VIEW SESSIONS&nbsp;</span> button.
+
<td>Select the route as described in the section '''[[file:PageLink.PNG|link=]]&nbsp;[[#Loading an Existing Route|Loading an Existing Route]]''' above. Then click the <span style="background-color: black; color: white; font-weight: 700; font-size: 15px;">&nbsp;VIEW SESSIONS&nbsp;</span> button.
  
 
[[image:RouteButtonsView.png|link=|alt=View Sessions]]
 
[[image:RouteButtonsView.png|link=|alt=View Sessions]]
  
This will display a list of thumbnails for all the '''Sessions''' in that '''Route'''. Select the '''Session''' thumbnail you need and then click the <span style="background-color: black; color: white; font-weight: 700; font-size: 15px;">&nbsp;EDIT SESSION&nbsp;</span> button.
+
This will display a list of thumbnails for all the sessions in that route. Select the session thumbnail you need and then click the <span style="background-color: black; color: white; font-weight: 700; font-size: 15px;">&nbsp;EDIT SESSION&nbsp;</span> button.
  
 
[[image:SessionButtonsEdit2.png|link=|alt=Edit Session]]
 
[[image:SessionButtonsEdit2.png|link=|alt=Edit Session]]
  
Again, both the selected '''Route''' and its '''Session''' will be loaded into '''Surveyor'''.<br>
+
Again, both the selected route and its session will be loaded into '''Surveyor'''.<br>
  
 
<table bgcolor=#000000 width=900>
 
<table bgcolor=#000000 width=900>
Line 772: Line 844:
 
<td>[[image:NotePad.PNG|link=]]</td>
 
<td>[[image:NotePad.PNG|link=]]</td>
 
<td>
 
<td>
If the <span style="background-color: black; color: white; font-weight: 700; font-size: 15px;">&nbsp;EDIT SESSION&nbsp;</span> option is not present then the selected '''Session''' is a saved '''Driver Game'''  (a "game" saved when in '''Driver''') and cannot be edited. See the section '''[[file:PageLink.PNG|link=]]&nbsp;[[#Saving and Loading Sessions in Driver|Saving and Loading Sessions in Driver]]''' below.
+
If the <span style="background-color: black; color: white; font-weight: 700; font-size: 15px;">&nbsp;EDIT SESSION&nbsp;</span> option is not present then the selected session is a saved '''Driver Game'''  (a "game" saved when in '''Driver''') and cannot be edited. See the section '''[[file:PageLink.PNG|link=]]&nbsp;[[#Saving and Loading Sessions in Driver|Saving and Loading Sessions in Driver]]''' below.
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 787: Line 859:
  
 
=='''Loading a Session Into Surveyor From Content Manager'''==
 
=='''Loading a Session Into Surveyor From Content Manager'''==
'''Trainz''' provides a shortcut that allows you to load an existing '''Session''' directly into '''Surveyor''' for editing from '''Content Manager'''.<br>
+
'''Trainz''' provides a shortcut that allows you to load an existing session directly into '''Surveyor''' for editing from '''Content Manager'''.<br>
  
 
<table>
 
<table>
Line 802: Line 874:
 
<td><span style="font-size: 17px; font-weight: 700;">Steps:</span><br>
 
<td><span style="font-size: 17px; font-weight: 700;">Steps:</span><br>
 
#in '''Content Manager''' select the filter '''Routes & Sessions'''
 
#in '''Content Manager''' select the filter '''Routes & Sessions'''
#select the '''Session''' to be loaded and edited in '''Surveyor'''
+
#select the session to be loaded and edited in '''Surveyor'''
 
#use the '''right-mouse-button''' to open the '''Command Menu'''
 
#use the '''right-mouse-button''' to open the '''Command Menu'''
 
#select '''Open...''', then
 
#select '''Open...''', then
Line 813: Line 885:
 
</tr>
 
</tr>
 
</table>
 
</table>
Both the '''Route''' and the '''Session''' will be loaded into '''Surveyor''' for editing.
+
Both the route and the session will be loaded into '''Surveyor''' for editing.
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 819: Line 891:
  
 
=='''Loading a Session into Driver From Surveyor'''==
 
=='''Loading a Session into Driver From Surveyor'''==
To start '''Driver''' simply select a '''Session''' as described above in '''Loading an Existing Session''' and click the <span style="font-weight: 700; background-color: black; color: white; font-size: 15px;">&nbsp;DRIVE SESSION&nbsp;</span> button.<br>
+
To start '''Driver''' simply select a session as described above in '''Loading an Existing Session''' and click the <span style="font-weight: 700; background-color: black; color: white; font-size: 15px;">&nbsp;DRIVE SESSION&nbsp;</span> button.<br>
  
 
[[image:DriverButtons.png|link=|alt=Driver Game]]<br>
 
[[image:DriverButtons.png|link=|alt=Driver Game]]<br>
  
This will load both the '''Session''' and the '''Route''' into '''Driver'''.<br>
+
This will load both the session and the route into '''Driver'''.<br>
  
 
You can save your "game play" in '''Driver''' at anytime. See '''[[file:PageLink.PNG|link=]]&nbsp;[[#Saving and Loading Sessions in Driver|Saving and Loading Sessions in Driver]]''' below.
 
You can save your "game play" in '''Driver''' at anytime. See '''[[file:PageLink.PNG|link=]]&nbsp;[[#Saving and Loading Sessions in Driver|Saving and Loading Sessions in Driver]]''' below.
  
 
=='''Loading a Session into Driver From Content Manager'''==
 
=='''Loading a Session into Driver From Content Manager'''==
'''Trainz''' provides a shortcut that allows you to load an existing '''Session''' directly into '''Driver''' from '''Content Manager'''.<br>
+
'''Trainz''' provides a shortcut that allows you to load an existing session directly into '''Driver''' from '''Content Manager'''.<br>
  
 
<table>
 
<table>
Line 843: Line 915:
 
<td><span style="font-size: 17px; font-weight: 700;">Steps:</span><br>
 
<td><span style="font-size: 17px; font-weight: 700;">Steps:</span><br>
 
#in '''Content Manager''' select the filter '''Routes & Sessions'''
 
#in '''Content Manager''' select the filter '''Routes & Sessions'''
#select the '''Session''' to drive
+
#select the session to drive
 
#use the '''right-mouse-button''' to open the '''Command Menu'''
 
#use the '''right-mouse-button''' to open the '''Command Menu'''
 
#select '''Open...''', then
 
#select '''Open...''', then
Line 854: Line 926:
 
</tr>
 
</tr>
 
</table>
 
</table>
The '''Session''' and its parent '''Route''' will be loaded into '''Driver''' and the simulation will be started.
+
The session and its parent route will be loaded into '''Driver''' and the simulation will be started.
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 867: Line 939:
 
</table>
 
</table>
  
When you create a new '''Session''', or load an existing '''Session''', and start adding scenery assets in '''Surveyor''' they will automatically be placed into a '''Session Layer'''. See the '''Trainz Wiki Page [[image:WikiLink.PNG|link=]]&nbsp;[[How_to_Use_Layers|How to Use Layers]]''' for more details.<br>
+
When you create a new session, or load an existing session, and start adding scenery assets in '''Surveyor''' they will automatically be placed into a '''Session Layer'''. See the '''Trainz Wiki Page [[image:WikiLink.PNG|link=]]&nbsp;[[How_to_Use_Layers|How to Use Layers]]''' for more details.<br>
  
 
Any changes made to the '''Session Rules''' (including drivers and their commands), the '''Environment Tools''', '''Industry''' or '''Rolling Stock''' settings, will be added to the '''Session Data'''.<br>
 
Any changes made to the '''Session Rules''' (including drivers and their commands), the '''Environment Tools''', '''Industry''' or '''Rolling Stock''' settings, will be added to the '''Session Data'''.<br>
Line 985: Line 1,057:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>Selecting <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Save&nbsp;</span> or pressing <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Ctrl&nbsp;</span>&nbsp;<span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;S&nbsp;</span> will save the '''Route''', or the '''Route''' and the '''Session''', with the previously entered name(s) when they were loaded or created. You will be asked to confirm both the names (and can change them if you wish) and the '''Save''' command.<br><br></td>
+
<td>Selecting <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Save&nbsp;</span> or pressing <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Ctrl&nbsp;</span>&nbsp;<span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;S&nbsp;</span> will save the route, or the route and the session, with the previously entered name(s) when they were loaded or created. You will be asked to confirm both the names (and can change them if you wish) and the '''Save''' command.<br><br></td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>Selecting <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Save As...&nbsp;</span>  will save the '''Route''', or the '''Route''' and the '''Session''', with the previously entered name(s) when they were loaded or created. You will be asked to confirm both the names (and can change them if you wish) and the '''Save As''' command.<br><br></td>
+
<td>Selecting <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Save As...&nbsp;</span>  will save the route, or the route and the session, with the previously entered name(s) when they were loaded or created. You will be asked to confirm both the names (and can change them if you wish) and the '''Save As''' command.<br><br></td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 999: Line 1,071:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:NotePad.PNG|link=]]</td>
 
<td>[[image:NotePad.PNG|link=]]</td>
<td><span style="font-size: 17px; font-weight: 700;">Notes on Saving:'''</span><br>
+
<td><span style="font-size: 17px; font-weight: 700;">Notes on Saving Routes and Sessions:</span><br>
 
----
 
----
 
<table  bgcolor=#ffffb0>
 
<table  bgcolor=#ffffb0>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>'''Freeware routes''', that have been downloaded and installed from the '''DLS''', can be edited and saved as new routes.<br>
+
<td>'''DLS routes and sessions''' can be modified and saved as new routes and sessions.
*When they are saved they will be given a new '''<kuid>''' that will include your personal identity code, so they will become '''Your Content''' and can be found using the <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;MY CONTENT&nbsp;</span> search option
+
<span style="font-weight: 700; font-size: 15px;">Modifying and creating:-</span>
*The original route from the '''DLS''' will not be altered or replaced by your new version. You can delete the original '''DLS''' route if you wish and your new modified version will be unaffected
+
*if you have modified a '''DLS''' route then you can delete the original route if you no longer need it and your modified version will not be affected
 +
*if you have modified a '''DLS''' session then you can delete the original session if you no longer need it and your modified version will not be affected. However, if you delete the original '''DLS''' route then your modified session <span style="font-weight: 700; color: white; background-color: red;">&nbsp;will not work&nbsp;</span>
 +
*you can create a new session for a '''DLS''' route but it <span style="font-weight: 700; color: white; background-color: red;">&nbsp;will not work&nbsp;</span> if the original '''DLS''' route is deleted
 +
<span style="font-weight: 700; font-size: 15px;">Saving:-</span>
 +
*when saved, modified '''DLS''' routes and sessions will become '''Your Content''' and can be found using the <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;MY CONTENT&nbsp;</span> search option in '''Surveyor/Driver'''
 +
*the original '''DLS''' routes and sessions will not be altered or replaced by your modified versions
 +
<span style="font-weight: 700; font-size: 15px;">Uploading:-</span>
 +
*you can only upload your modified '''DLS''' route and session to the '''DLS''' if you have the <span style="font-weight: 700; text-decoration: underline;">permission</span> of the original creator
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>'''Payware Routes''', that have been downloaded and installed from the '''DLC''', can also be edited and saved as new Routes '''''if the route creators have allowed it'''''.
+
<td>'''DLC routes and sessions''' can also be modified and saved as new routes and sessions '''''if the creators of the original DLC content have allowed it''''' - see [[image:PageLink.PNG|link=]] '''[[#Cloning a Route/Session|Cloning a Route/Session]]''' below for more details
*Routes that are shown in '''Content Manager''' with a '''Status''' of '''"Packaged, Payware"''' are encrypted and cannot be edited. Those listed as just '''Payware''' can be edited
+
<span style="font-weight: 700; font-size: 15px;">Modifying and creating:-</span>
*When an edited '''DLC''' route is saved it will be given a new '''<kuid>''' that will include your personal identity code, so it will become '''Your Content''' and can be found using the <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;MY CONTENT&nbsp;</span> search option
+
*some '''DLC''' routes and sessions are encrypted and cannot be modified - that is a decision made by the content creator
*The original '''Payware''' route will not be altered or replaced by your new version. However, if you delete or disable the original '''DLC''' route then your edited route will no longer work
+
*your modified '''DLC''' route or session will become an ''alias'' of the original and will need the original route and session to be present on your system to work
*You are allowed to upload your edited version of a '''Payware''' route to the '''DLS''' but it can only be used by other users who also have the same original (unedited) '''DLC Payware''' version installed</td>
+
*if you delete or disable the original '''DLC''' route or session then your modified versions <span style="font-weight: 700; color: white; background-color: red;">&nbsp;will not work&nbsp;</span>
</tr>
+
*you can create a new session for a '''DLC''' route but it <span style="font-weight: 700; color: white; background-color: red;">&nbsp;will not work&nbsp;</span> if the original '''DLC''' route is deleted or disabled
<tr valign="top">
+
<span style="font-weight: 700; font-size: 15px;">Saving:-</span>
<td>[[image:DotPoint.JPG|link=]]</td>
+
*when saved, a modified '''DLC''' route or session will become '''Your Content''' and can be found using the <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;MY CONTENT&nbsp;</span> search option in '''Surveyor/Driver'''
<td>'''Sessions''' that have been downloaded and installed from the '''DLS''' (freeware) or '''DLC''' (payware) follow the same rules as described for '''DLS''' and '''DLC''' routes above. They can be edited and saved as new sessions (if not encrypted in the case of '''DLC Payware''') and will also become '''Your Content'''. The originals will not be replaced by your new versions. You are allowed to upload your edited version of a session to the '''DLS''' with the permission of the creator for '''DLS''' sessions. Uploaded '''DLC''' sessions can only be used by other users who already have the original '''DLC''' route and session installed.<br>
+
*the original '''DLC''' route and session will not be altered or replaced by your modified versions
<span style="background-color: yellow; font-weight: 700; font-size: 15px;">&nbsp;Note:&nbsp;</span> If your copied '''Session''' was created using an original (not edited) route then it will still need the original route to work. If you delete the original route then your session will no longer work. This restriction does not apply for any new session you create for an edited '''DLS''' route. The new session will be based on your edited route and not on the original.</td>
+
<span style="font-weight: 700; font-size: 15px;">Uploading:-</span>
</tr>
+
*you can upload your modified '''DLC''' route or session to the '''DLS''' but it can only be used by those who also have the same original (unmodified) '''DLC''' version installed</td>
<tr valign="top">
+
<td>[[image:DotPoint.JPG|link=]]</td>
+
<td>If you decide to create a new '''Session''' and leave its name as '''Default''' then a new '''Default Session''' will be created to add to any others also named '''Default''' that may already be present in a '''Route''' - this is possible because they will all have different '''<kuid>''' values. This is why it is not a good idea to use '''Default''' as a '''Session''' name.</td>
+
</tr>
+
<tr valign="top">
+
<td>[[image:DotPoint.JPG|link=]]</td>
+
<td>Many scenery assets actually have their properties stored in the '''Session Data''' even when the assets themselves are in '''Route Layers'''. Editing the properties of these assets is considered to be a change to the '''Session''' and will result in a '''Save''' command requesting that the '''Session''' be saved as well as the '''Route'''. You can decide whether or not to save the '''Session'''.<br>
+
These assets include:-
+
*junction switches - the left/right switch direction is stored in the '''Session''' (but the switch '''default''' direction is stored in the '''Route''')
+
*industries - the commodities and quantities loaded/unloaded are stored in the '''Session'''
+
*industry enabled wagons - the commodities and quantities carried are stored in the '''Session'''
+
*consist locations - this is stored in the '''Session''' even if the consists are placed in the '''Route'''. See the '''Trainz Wiki Page [[image:WikiLink.PNG|link=]]&nbsp;[[How_to_Use_the_UDS_Interface|How to Use the UDS Interface]]''' for more details.
+
*named route objects - while the name is stored in the '''Route''', adding or changing the name is treated as a change to the '''Session'''</td>
+
</tr>
+
<tr valign="top">
+
<td>[[image:DotPoint.JPG|link=]]</td>
+
<td>It is possible for '''Trainz''' to request that the '''Route''' and/or '''Session''' be saved when no obvious changes have occurred. This can happen when a '''Route/Session''' with an earlier asset build number has been loaded into '''Surveyor'''. For example - loading a '''Route''' with an asset build number of '''3.7''' (from '''TRS12 SP1''') into '''TRS19 SP3''' which uses asset build number '''4.8''' for all its '''Routes''' and '''Sessions'''.</td>
+
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 1,043: Line 1,105:
 
</tr>
 
</tr>
 
</table> <!-- END Notes Table -->
 
</table> <!-- END Notes Table -->
 
+
<br>
 
=='''Saving a New Route and Session'''==
 
=='''Saving a New Route and Session'''==
If you have created a new '''Route''' and select '''Save''' or '''Save As...''', then you will be presented with the following '''Save Route Dialogue Windows'''.
+
If you have created a new route and select '''Save''' or '''Save As...''', then you will be presented with the following '''Save Route Dialogue Windows'''.
 
<table width=900>
 
<table width=900>
 
<tr valign="top">
 
<tr valign="top">
Line 1,052: Line 1,114:
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
<td colspan=2>In both cases the name of the '''Route''' that was entered when it was created will be shown and you can change the name, even in the '''Save''' option. However, there is no option in either case to change the name of the created '''Session''' because the other options have been '''greyed out''' and cannot be selected.</td>
+
<td colspan=2>In both cases the name of the route that was entered when it was created will be shown and you can change the name, even in the '''Save''' option. However, there is no option in either case to change the name of the created session because the other options have been '''greyed out''' and cannot be selected.</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 1,060: Line 1,122:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>If you have loaded the '''Route''' only and not the '''Session''' and '''<u>HAVE NOT</u>''' edited any '''Session Data''' or '''Session Layers''', then selecting '''Save''' will produce the following '''Save Route Dialogue Window'''.</td>
+
<td>If you have loaded the route only and not the session and '''<u>HAVE NOT</u>''' edited any '''Session Data''' or '''Session Layers''', then selecting '''Save''' will produce the following '''Save Route Dialogue Window'''.</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 1,075: Line 1,137:
 
<td>[[image:Gears.PNG|link=]]</td>
 
<td>[[image:Gears.PNG|link=]]</td>
 
<td><span style="font-size: 17px; font-weight: 700;">Settings:'''</span><br>
 
<td><span style="font-size: 17px; font-weight: 700;">Settings:'''</span><br>
[[image:DotPoint1.JPG|link=]]&nbsp;Overwrite '''Route''' only. The '''default''' selection.<br>
+
'''Option''' [[image:DotPoint1.JPG|link=]]&nbsp;Overwrite route only. This is the '''default''' selection so there is nothing to change.
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Overwrite existing route and:'''
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Overwrite existing route and:'''
 
::[[image:White_Select_Dot.png|link=]]&nbsp;'''Do not save session'''  
 
::[[image:White_Select_Dot.png|link=]]&nbsp;'''Do not save session'''  
::*the '''Route''' will be saved ('''overwritten''' using its current name) but no '''Session''' will be saved.
+
::*the route will be saved ('''overwritten''' using its current name) but no session will be saved.
[[image:DotPoint2.JPG|link=]]&nbsp;Overwrite '''Route''' and create a new '''Session'''..
+
'''Option''' [[image:DotPoint2.JPG|link=]]&nbsp;Overwrite route and create a new session. Tick the box [[image:White_Select_Dot.png|link=]]&nbsp;'''Create new session'''.
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Overwrite existing route and:'''
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Overwrite existing route and:'''
 
::[[image:White_Select_Dot.png|link=]]&nbsp;'''Create new session:'''  
 
::[[image:White_Select_Dot.png|link=]]&nbsp;'''Create new session:'''  
::*enter a name for the '''Session''' (the suggested name '''Default''' is '''NOT''' recommended).
+
::*enter a name for the session (the suggested name '''Default''' is '''NOT''' recommended).
::*the '''Route''' will be saved ('''overwritten''' using its current name).  
+
::*the route will be saved ('''overwritten''' using its current name).  
::*a new  '''Session''' will be created using the name you enter and it will be added to the '''Route'''.  
+
::*a new  session will be created using the name you enter and it will be added to the route.  
::*because you did not originally load a '''Session''', the new '''Session''' will be saved with '''default''' values for all settings.
+
::*because you did not originally load a session, the new session will be saved with '''default''' values for all settings.
[[image:DotPoint3.JPG|link=]]&nbsp;Create new '''Route''' and a '''default Session'''.
+
'''Option''' [[image:DotPoint3.JPG|link=]]&nbsp;Create new route and a '''default Session'''. Tick the box [[image:White_Select_Dot.png|link=]]&nbsp;'''Save new route and session'''.
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Save new route and session:'''
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Save new route and session:'''
::*enter a new name for the '''Route'''. The '''Route''' will be saved with its new name.
+
::*enter a new name for the route. The route will be saved with its new name.
::*the original '''Route''' will not be changed.
+
::*the original route will not be changed.
::*a new '''Session''' will be created using the name '''Default''' and it will be added to the new '''Route'''.  
+
::*a new session will be created using the name '''Default''' and it will be added to the new route.  
::*because you did not originally load a '''Session''', the new '''Session''' will be saved with the '''default''' values for all settings.
+
::*because you did not originally load a session, the new session will be saved with the '''default''' values for all settings.
 
</td>
 
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2 align="right">After you have made your selections, click [[image:Tick.PNG|link=|25px]] to '''Accept''' or [[image:Cross.PNG|link=|25px]] to '''Cancel'''</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
Line 1,106: Line 1,171:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>If you have loaded the '''Route''' only and not the '''Session''' and '''<u>HAVE</u>''' edited '''Session Data''' or '''Session Layers''', then selecting '''Save''' will produce the following '''Save Route Dialogue Window'''.</td>
+
<td>If you have loaded the route only and not the session and '''<u>HAVE</u>''' edited '''Session Data''' or '''Session Layers''', then selecting '''Save''' will produce the following '''Save Route Dialogue Window'''.</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:RouteSARSaveExistingNewSession.png|link=|alt=Save Route with Session]]<td>
+
<td>[[image:RouteSARSaveExistingNewSession.png|link=|alt=Save Route with Session]]</td>
 
<td>
 
<td>
 
<table bgcolor=#eeeeee width=800>
 
<table bgcolor=#eeeeee width=800>
Line 1,121: Line 1,186:
 
<td>[[image:Gears.PNG|link=]]</td>
 
<td>[[image:Gears.PNG|link=]]</td>
 
<td><span style="font-size: 17px; font-weight: 700;">Settings:'''</span><br>
 
<td><span style="font-size: 17px; font-weight: 700;">Settings:'''</span><br>
[[image:DotPoint1.JPG|link=]]&nbsp;Overwrite '''Route''' and create a new '''Session'''. The '''default''' selection.
+
'''Option''' [[image:DotPoint1.JPG|link=]]&nbsp;Overwrite route and create a new session. This is the '''default''' selection so there is nothing to change.
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Overwrite existing route and:'''
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Overwrite existing route and:'''
 
::[[image:White_Select_Dot.png|link=]]&nbsp;'''Create new session:'''  
 
::[[image:White_Select_Dot.png|link=]]&nbsp;'''Create new session:'''  
::*enter a name for the '''Session''' (the suggested name '''Default''' is '''NOT''' recommended).
+
::*enter a name for the session (the suggested name '''Default''' is '''NOT''' recommended).
::*the '''Route''' will be saved ('''overwritten''' using its current name).  
+
::*the route will be saved ('''overwritten''' using its current name).  
::*a new  '''Session''' will be created using the name you enter and it will be added to the '''Route'''. The new '''Session''' will have the settings and changes you have made.
+
::*a new  session will be created using the name you enter and it will be added to the route. The new session will have the settings and changes you have made.
[[image:DotPoint2.JPG|link=]]&nbsp;Overwrite '''Route''' only.<br>
+
'''Option''' [[image:DotPoint2.JPG|link=]]&nbsp;Overwrite route only. Tick the box [[image:White_Select_Dot.png|link=]]&nbsp;'''Do not save session'''.
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Overwrite existing route and:'''
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Overwrite existing route and:'''
 
::[[image:White_Select_Dot.png|link=]]&nbsp;'''Do not save session'''  
 
::[[image:White_Select_Dot.png|link=]]&nbsp;'''Do not save session'''  
::*the '''Route''' will be saved ('''overwritten''' using its current name) but no '''Session''' will be saved.
+
::*the route will be saved ('''overwritten''' using its current name) but no session will be saved.
::*the changes you have made to the '''Session''' will be lost.
+
::*if you have edited the session and later exit the program without saving those edits (you will be prompted to save the session) then any changes you have made to the session will be lost.
[[image:DotPoint3.JPG|link=]]&nbsp;Create new '''Route''' and a '''default Session'''.
+
'''Option''' [[image:DotPoint3.JPG|link=]]&nbsp;Create new route and a '''default Session'''. Tick the box [[image:White_Select_Dot.png|link=]]&nbsp;'''Save new route and session'''.
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Save new route and session:'''
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Save new route and session:'''
::*enter a new name for the '''Route'''. The '''Route''' will be saved with its new name.
+
::*enter a new name for the route. The route will be saved with its new name.
::*the original '''Route''' will not be changed.
+
::*the original route will not be changed.
::*a new '''Session''' will be created using the name '''Default''' and it will be added to the new '''Route'''. The new '''Session''' will have the settings and changes you have made.
+
::*a new session will be created using the name '''Default''' and it will be added to the new route. The new session will have the settings and changes you have made.
 
</td>
 
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2 align="right">After you have made your selections, click [[image:Tick.PNG|link=|25px]] to '''Accept''' or [[image:Cross.PNG|link=|25px]] to '''Cancel'''</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
Line 1,148: Line 1,216:
 
</table>
 
</table>
 
<br>
 
<br>
 
+
<table bgcolor=#000000 width=900 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffb0 width=896 cellpadding=2>
 +
<tr valign="top">
 +
<td>[[image:NotePad.PNG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br>
 +
----
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|link=]]</td>
 +
<td>If you have edited any session '''Data''' or '''Layers''' but have selected the option '''Do not save session''' then later, before you exit the program, you will be prompted to save the edited session by the appearance of the '''Save Session''' dialogue box (see below).</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|link=]]</td>
 +
<td>If you decide to create a new session and leave its name as '''Default''' then a new '''Default Session''' will be created to add to any others also named '''Default''' that may already be present in a route and this '''will''' cause confusion. This is why it is not a good idea to use '''Default''' as a session name.</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 
=='''Saving an Existing Route and Session'''==
 
=='''Saving an Existing Route and Session'''==
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>If you have loaded a '''Route''' and a '''Session''' and have edited the '''Route''' or the '''Route''' and the '''Session''' then selecting '''Save''' will produce the following '''Save Route Dialogue Window'''.</td>
+
<td>If you have loaded a route and a session and have edited the route or the route and the session then selecting '''Save''' will produce the following '''Save Route Dialogue Window'''.</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:RouteSessionSARSaveExisting.png|link=|alt=Save Route and Session]]<td>
+
<td>[[image:RouteSessionSARSaveExisting.png|link=|alt=Save Route and Session]]</td>
 
<td>
 
<td>
 
<table bgcolor=#eeeeee width=800>
 
<table bgcolor=#eeeeee width=800>
Line 1,168: Line 1,256:
 
<td>[[image:Gears.PNG|link=]]</td>
 
<td>[[image:Gears.PNG|link=]]</td>
 
<td><span style="font-size: 17px; font-weight: 700;">Settings:'''</span><br>
 
<td><span style="font-size: 17px; font-weight: 700;">Settings:'''</span><br>
[[image:DotPoint1.JPG|link=]]&nbsp;Overwrite '''Route''' and '''Session'''. The '''default''' selection.
+
'''Option''' [[image:DotPoint1.JPG|link=]]&nbsp;Overwrite route and session. This is the '''default''' selection so there is nothing to change.
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Overwrite existing route and:'''
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Overwrite existing route and:'''
 
::[[image:White_Select_Dot.png|link=]]&nbsp;'''Overwrite existing session:'''  
 
::[[image:White_Select_Dot.png|link=]]&nbsp;'''Overwrite existing session:'''  
::*both the '''Route''' and the '''Session''' will be saved ('''overwritten''' using their current names).  
+
::*both the route and the session will be saved ('''overwritten''' using their current names).  
[[image:DotPoint2.JPG|link=]]&nbsp;Overwrite existing '''Route''' and create a new '''Session'''.
+
'''Option''' [[image:DotPoint2.JPG|link=]]&nbsp;Overwrite existing route and create a new session. Tick the box [[image:White_Select_Dot.png|link=]]&nbsp;'''Create new session'''.
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Overwrite existing route and:'''
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Overwrite existing route and:'''
 
::[[image:White_Select_Dot.png|link=]]&nbsp;'''Create new session:'''  
 
::[[image:White_Select_Dot.png|link=]]&nbsp;'''Create new session:'''  
::*enter a new name for the '''Session'''.
+
::*enter a new name for the session.
::*the '''Route''' will be saved ('''overwritten''' using its current name).
+
::*the route will be saved ('''overwritten''' using its current name).
::*a new '''Session''' will be created using the name you enter and it will be added to the existing '''Route'''.
+
::*a new session will be created using the name you enter and it will be added to the existing route.
::*the original '''Session''' will not be changed.
+
::*the original session will not be changed.
[[image:DotPoint3.JPG|link=]]&nbsp;Overwrite '''Route''' only.<br>
+
'''Option''' [[image:DotPoint3.JPG|link=]]&nbsp;Overwrite route only. Tick the box [[image:White_Select_Dot.png|link=]]&nbsp;'''Do not save session'''.
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Overwrite existing route and:'''
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Overwrite existing route and:'''
 
::[[image:White_Select_Dot.png|link=]]&nbsp;'''Do not save session'''  
 
::[[image:White_Select_Dot.png|link=]]&nbsp;'''Do not save session'''  
::*the '''Route''' will be saved ('''overwritten''' using its current name) but no '''Session''' will be saved.
+
::*the route will be saved ('''overwritten''' using its current name) but no session will be saved.
::*the changes you have made to the '''Session''' will be lost.
+
::*if you have edited the session and later exit the program without saving those edits (you will be prompted to save the session) then any changes you have made to the session will be lost.
[[image:DotPoint4.JPG|link=]]&nbsp;Create a new '''Route''' and a new '''Session'''.
+
'''Option''' [[image:DotPoint4.JPG|link=]]&nbsp;Create a new route and a new session. Tick the box [[image:White_Select_Dot.png|link=]]&nbsp;'''Save new route and session'''.
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Save new route and session:'''
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Save new route and session:'''
::*enter a new name for the '''Route'''.
+
::*enter a new name for the route.
::*the '''Route''' will be saved with its new name.
+
::*the route will be saved with its new name.
::*a new '''Session''' will be created using the same name as the original '''Session''' and it will be added to the new '''Route'''.
+
::*a new session will be created using the same name as the original session and it will be added to the new route.
::*the original '''Session''' and '''Route''' will not be changed.
+
::*the original session and route will not be changed.
 
</td>
 
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2 align="right">After you have made your selections, click [[image:Tick.PNG|link=|25px]] to '''Accept''' or [[image:Cross.PNG|link=|25px]] to '''Cancel'''</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
Line 1,200: Line 1,291:
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
<br>
 +
<table bgcolor=#000000 width=900 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffb0 width=896 cellpadding=2>
 +
<tr valign="top">
 +
<td>[[image:NotePad.PNG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br>
 +
----
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|link=]]</td>
 +
<td>If you have edited any session '''Data''' or '''Layers''' but have selected the option '''Do not save session''' then later, before you exit the program, you will be prompted to save the edited session by the appearance of the '''Save Session''' dialogue box (see below).</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|link=]]</td>
 +
<td>If you decide to create a new session and leave its name as '''Default''' then a new '''Default Session''' will be created to add to any others also named '''Default''' that may already be present in a route and this '''will''' cause confusion. This is why it is not a good idea to use '''Default''' as a session name.</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>If you have loaded a '''Route''' and a '''Session''' and have edited the '''Session''' ('''Data''' or '''Layers''') only and not the '''Route''' then selecting '''Save''' will produce the following '''Save Session Dialogue Window'''.</td>
+
<td>If you have loaded a route and a session and have edited the session ('''Data''' or '''Layers''') only and not the route, or have already saved the route but not the session, then selecting '''Save''' will produce the following '''Save Session Dialogue Window'''.</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 1,218: Line 1,331:
 
<td>[[image:Gears.PNG|link=]]</td>
 
<td>[[image:Gears.PNG|link=]]</td>
 
<td><span style="font-size: 17px; font-weight: 700;">Settings:'''</span><br>
 
<td><span style="font-size: 17px; font-weight: 700;">Settings:'''</span><br>
[[image:DotPoint1.JPG|link=]]&nbsp;Overwrite the '''Session''' only. The '''default''' selection.
+
[[image:DotPoint1.JPG|link=]]&nbsp;Overwrite the session only. This is the '''default''' selection so there is nothing to change.
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Overwrite existing session'''  
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Overwrite existing session'''  
:*the '''Session''' will be saved ('''overwritten''' using its current name).
+
:*the session will be saved ('''overwritten''' using its current name).
:*the original '''Route''' will not be changed.
+
:*the original route will not be changed.
[[image:DotPoint2.JPG|link=]]&nbsp;Create a new '''Session'''.
+
[[image:DotPoint2.JPG|link=]]&nbsp;Create a new session. Tick the box [[image:White_Select_Dot.png|link=]]&nbsp;'''Create new session'''.
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Create new session:'''  
 
:[[image:White_Select_Dot.png|link=]]&nbsp;'''Create new session:'''  
:*you can enter a new name for the '''Session''' or use the suggested name which will include the date, time and '''Session''' runtime.
+
:*you can enter a new name for the session or use the suggested name which will include the date, time and session runtime.
:*a new '''Session''' will be created using the name you enter and it will be added to the existing '''Route'''.
+
:*a new session will be created using the name you enter and it will be added to the existing route.
:*the original '''Route''' and '''Session''' will not be changed.
+
:*the original route and session will not be changed.
 
</td>
 
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2 align="right">After you have made your selections, click [[image:Tick.PNG|link=|25px]] to '''Accept''' or [[image:Cross.PNG|link=|25px]] to '''Cancel'''</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
Line 1,240: Line 1,356:
  
 
=='''Saving a Route and Session Using the UDS'''==
 
=='''Saving a Route and Session Using the UDS'''==
The '''UDS''' ('''U'''nified '''D'''river '''S'''urveyor) Interface allows you to quickly switch from '''Driver''' to '''Surveyor''' and back to '''Driver''' again without having to restart the '''Session''' from the beginning. You can edit a '''Route''' and '''Session''' while in '''Surveyor''' and then switch back to '''Driver''' to continue the '''Session''' where you left it.<br>
+
The '''UDS''' ('''U'''nified '''D'''river '''S'''urveyor) Interface allows you to quickly switch from '''Driver''' to '''Surveyor''' and back to '''Driver''' again without having to restart the session from the beginning. You can edit a route and session while in '''Surveyor''' and then switch back to '''Driver''' to continue the session where you left it.<br>
  
This powerful ability does come with a warning. If you save the edited '''Session''' before switching back into '''Driver''' then all the moving consists will be saved in their new positions. Other changes, such as the status of '''Session Rules''', will also be saved in new states. See the '''Trainz Wiki Page [[image:WikiLink.PNG|link=]]&nbsp;[[How_to_Use_the_UDS_Interface|How to Use the UDS Interface]]''' for more details. <br>
+
<table bgcolor=#ff0000 cellpadding=2 width=900>
 
+
<tr valign="top">
Most of the problems users seem to be experiencing with the '''UDS''', judging from the posts in the Trainz Forums, is when saving their edited '''Session''' before switching back into '''Driver''' mode. <br>
+
<td>
 +
<table bgcolor=#fcbcbc>
 +
<tr valign="top">
 +
<td>[[file:Stop.PNG|link=]]</td>
 +
<td><span style="font-size: 15px; font-weight: 700;">WARNING:</span><br>
 +
This powerful ability does come with a warning. If you save the edited session before switching back into '''Driver''' then all the moving consists will be saved in their new positions. Other changes, such as the status of '''Session Rules''', will also be saved in their new states. See the '''Trainz Wiki Page [[image:WikiLink.PNG|link=]]&nbsp;[[How_to_Use_the_UDS_Interface|How to Use the UDS Interface]]''' for more details.
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
Most of the problems users seem to be experiencing with the '''UDS''', judging from the posts in the Trainz Forums, is when saving their edited session before switching back into '''Driver''' mode. <br>
  
 
<table cellpadding=4 bgcolor=#c1e7e7>
 
<table cellpadding=4 bgcolor=#c1e7e7>
Line 1,265: Line 1,394:
 
<td><span style="font-size: 17px; font-weight: 700;">Note:'''</span><br>
 
<td><span style="font-size: 17px; font-weight: 700;">Note:'''</span><br>
 
----
 
----
An important change that has been introduced by the '''UDS''' is that train vehicle '''placement''' is now saved as part of the '''Session''', even if those vehicles have been placed in '''Route Layers'''.
+
An important change that has been introduced by the '''UDS''' is that train vehicle '''placement''' is now saved as part of the session, even if those vehicles have been placed in '''Route Layers'''.
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 1,273: Line 1,402:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[file:PencilTips.PNG|link=]]</td>
 
<td>[[file:PencilTips.PNG|link=]]</td>
<td>For this reason, it is '''<u>strongly recommended</u>''' that all consists be placed into a '''Session Layer''' and become part of a '''Session''' instead of the '''Route'''
+
<td>For this reason, it is '''<u>strongly recommended</u>''' that all consists be placed into a '''Session Layer''' and become part of a session instead of the route
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 1,284: Line 1,413:
 
</table>
 
</table>
 
<br>
 
<br>
When you are in '''Driver Mode''' at least one of the consists will probably be moving. Some of the '''Session Rules''' may have already been completed while others may still be running or waiting for events (e.g. triggers to be activated). If, after switching to '''Surveyor Mode''', you then choose to save using the '''Overwrite existing session''' option then you will be replacing your original starting '''Session''' with a new one with the consists saved in their new positions and the '''Session Rules''' saved in their new states. So when you later load and restart the '''Session''' things will not be the same as they were in the original or starting '''Session'''.<br>
+
When you are in '''Driver Mode''' at least one of the consists will probably be moving. Some of the '''Session Rules''' may have already been completed while others may still be running or waiting for events (e.g. triggers to be activated). If, after switching to '''Surveyor Mode''', you then choose to save using the '''Overwrite existing session''' option then you will be replacing your original starting session with a new one with the consists saved in their new positions and the '''Session Rules''' saved in their new states. So when you later load and restart the session things will not be the same as they were in the original or starting session.<br>
  
 
<span style="font-size: 17px;"><span style="background-color: yellow; font-weight: 700">&nbsp;Unless you have a particular reason for overwriting the original Session </span>&nbsp;then the '''recommended''' save options are:-</span><br>
 
<span style="font-size: 17px;"><span style="background-color: yellow; font-weight: 700">&nbsp;Unless you have a particular reason for overwriting the original Session </span>&nbsp;then the '''recommended''' save options are:-</span><br>
Line 1,297: Line 1,426:
 
<td width=20>&nbsp;</td>
 
<td width=20>&nbsp;</td>
 
<td>[[image:UDS-DoNotSaveSession.png|link=]]<br>
 
<td>[[image:UDS-DoNotSaveSession.png|link=]]<br>
This will only save the '''Route''' using its existing name. This will save any edits that you have made to the '''Route''' but not to the '''Session'''.<br>
+
This will only save the route using its existing name. This will save any edits that you have made to the route but not to the session.<br>
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 1,309: Line 1,438:
 
<td width=20>&nbsp;</td>
 
<td width=20>&nbsp;</td>
 
<td>[[image:UDS-CreateNewSession.png|link=]]<br>
 
<td>[[image:UDS-CreateNewSession.png|link=]]<br>
This will save the '''Route''' using its existing name. It will also save the '''Session''' using a new name you enter in the text box below the option ('''Stage 3''' in the example shown). The original '''Session''' will not be altered. This is useful when you want to test out changes to consists, industry settings, Rules, driver commands, etc but do not want to destroy the original '''Session'''.<br>
+
This will save the route using its existing name. It will also save the session using a new name you enter in the text box below the option ('''Stage 3''' in the example shown). The original session will not be altered. This is useful when you want to test out changes to consists, industry settings, Rules, driver commands, etc but do not want to destroy the original session.<br>
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 1,316: Line 1,445:
 
</tr>
 
</tr>
 
</table>
 
</table>
If you have have '''NOT''' edited anything while in '''Surveyor''' and select <span style="font-weight: 700; color: white; background-color: black; font-size: 15px;">&nbsp;Save&nbsp;</span> then you will be shown the '''Save Driver Session''' dialogue window to save the '''Session''' in its current state as a '''Driver Game''' (also called a '''Game''' or '''Driver Game'''). This is exactly the same as pressing <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Ctrl&nbsp;</span>&nbsp;<span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;S&nbsp;</span> while in '''Driver'''.<br>
+
If you have have '''NOT''' edited anything while in '''Surveyor''' and select <span style="font-weight: 700; color: white; background-color: black; font-size: 15px;">&nbsp;Save&nbsp;</span> then you will be shown the '''Save Driver Session''' dialogue window to save the session in its current state as a '''Driver Game''' (also called a '''Game''' or '''Driver Game'''). This is exactly the same as pressing <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Ctrl&nbsp;</span>&nbsp;<span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;S&nbsp;</span> while in '''Driver'''.<br>
 
[[image:RouteSARSaveDriverSession.png|link=|alte=Save Driver Session]]<br>
 
[[image:RouteSARSaveDriverSession.png|link=|alte=Save Driver Session]]<br>
The '''Driver Game''' will appear in the '''Select Session''' menu for the '''Route'''. Loading it will resume '''Driver''' at the point where it was saved.
+
The '''Driver Game''' will appear in the '''Select Session''' menu for the route. Loading it will resume '''Driver''' at the point where it was saved.
 
<br>
 
<br>
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<table> <!-- BEGIN Nav Buttons Table -->
Line 1,368: Line 1,497:
  
 
='''Cloning a Route/Session'''=
 
='''Cloning a Route/Session'''=
<table cellpadding=4 bgcolor=#c1e7e7>
+
<table bgcolor=#c1e7e7>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>A '''Clone''' is an exact or duplicate copy of an asset. Most '''Routes''' and '''Sessions''' can be cloned</td>
+
<td>A '''Clone''' is an exact or duplicate copy of an asset</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>Cloned '''Routes''' and '''Sessions''' can be edited and saved as '''Your Content'''</td>
+
<td>Most routes and sessions can be cloned. Some '''Payware''' routes and sessions cannot be cloned</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|link=]]</td>
 +
<td>Cloned routes and sessions can be edited and saved as '''Your Content'''</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 1,395: Line 1,528:
 
</table>
 
</table>
 
<br>
 
<br>
<table bgcolor=#000000 width=900> <!-- BEGIN Notes Table -->
 
<tr valign="top">
 
<td>
 
<table bgcolor=#ffffb0>
 
<tr valign="top">
 
<td>[[image:NotePad.PNG|link=]]</td>
 
<td><span style="font-size: 17px; font-weight: 700;">Notes on Cloning:'''</span><br>
 
----
 
 
<table  bgcolor=#ffffb0>
 
<table  bgcolor=#ffffb0>
 
<tr valign="top">
 
<tr valign="top">
Line 1,413: Line 1,538:
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>'''Payware Routes''', that have been downloaded and installed from the '''DLC''', can also be cloned as new routes '''if the creators of the routes allow it'''.
 
<td>'''Payware Routes''', that have been downloaded and installed from the '''DLC''', can also be cloned as new routes '''if the creators of the routes allow it'''.
*Routes that are listed in '''Content Manager''' as '''"Packaged, Payware"''' are encrypted and cannot be cloned. Those listed as just '''Payware''' can be cloned
+
*Some '''Payware''' routes are encrypted and cannot be cloned.
 
*When an approved '''DLC''' route is saved it will be given a new '''<kuid>''' that will include your personal identity code, so it will become '''Your Content''' and can be found using the <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;MY CONTENT&nbsp;</span> search option
 
*When an approved '''DLC''' route is saved it will be given a new '''<kuid>''' that will include your personal identity code, so it will become '''Your Content''' and can be found using the <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;MY CONTENT&nbsp;</span> search option
*The original '''Payware''' route will not be altered or replaced by your new version. However, if you delete or disable the original '''DLC''' route then your cloned route will no longer work
+
*The original '''Payware''' route will not be altered or replaced by your new version
*You are allowed to upload your edited clone of a '''Payware''' route to the '''DLS''' but it can only be used by other users who also have the same original (unedited) '''DLC Payware''' version installed.</td>
+
*If you delete or disable the original '''DLC''' route then your cloned route <span style="color: white; background-color: red; font-weight: 700;">&nbsp;will NOT work&nbsp;</span>
 +
*You are allowed to upload your edited clone of a '''Payware''' route to the '''DLS''' but it can only be used by other users who also have the same original (unedited) '''DLC Payware''' installed.</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>'''Sessions''' that have been downloaded and installed from the '''DLS''' (freeware) or '''DLC''' (payware) follow the same rules as described for '''DLS''' and '''DLC''' routes above. They can be cloned as new sessions (if not encrypted in the case of '''DLC Payware''') and will also become '''Your Content'''. The originals will not be replaced by your new versions. You are allowed to upload your edited clone of a session to the '''DLS''' with the permission of the creator for '''DLS''' sessions. Uploaded '''DLC''' sessions can only be used by other users who already have the original '''DLC''' route and session installed.<br>
+
<td>'''Sessions''' that have been downloaded and installed from the '''DLS''' (freeware) or '''DLC''' (payware) follow the same rules as described for '''DLS''' and '''DLC''' routes above.
<span style="background-color: yellow; font-weight: 700; font-size: 15px;">&nbsp;Note:&nbsp;</span> If your cloned '''Session''' was created using an original (not edited or cloned) route then it will still need the original route to work. If you delete the original route then your cloned session will no longer work. This restriction does not apply for any new session you create for a cloned '''DLS''' route. The new session will be based on your cloned route and not the original.</td>
+
*Some '''Payware''' sessions are encrypted and cannot be cloned.
 +
*When an approved '''DLC''' session is saved it will be given a new '''<kuid>''' that will include your personal identity code, so it will become '''Your Content''' and can be found using the <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;MY CONTENT&nbsp;</span> search option
 +
*The original '''Payware''' session will not be altered or replaced by your new version
 +
*If you delete or disable the original '''DLC''' session or the original '''DLC''' route then your cloned session <span style="color: white; background-color: red; font-weight: 700;">&nbsp;will NOT work&nbsp;</span>
 +
*You are allowed to upload your edited clone of a '''Payware''' session to the '''DLS''' but it can only be used by other users who also have the same original (unedited) '''DLC Payware''' installed.</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
</td>
+
<br>
</tr>
+
</table>
+
</td>
+
</tr>
+
</table>
+
 
+
 
=='''Using Surveyor'''==
 
=='''Using Surveyor'''==
 
'''Routes''' and '''Sessions''' that have been loaded into '''Surveyor''' can be cloned using the <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Save As...&nbsp;</span> command from the '''Surveyor''' <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;System Menu&nbsp;</span><br>
 
'''Routes''' and '''Sessions''' that have been loaded into '''Surveyor''' can be cloned using the <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Save As...&nbsp;</span> command from the '''Surveyor''' <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;System Menu&nbsp;</span><br>
Line 1,439: Line 1,563:
 
</tr>
 
</tr>
 
</table>
 
</table>
Enter a new name or edit the original name (as shown above) for your cloned '''Route''' or '''Session'''.<br>
+
Enter a new name or edit the original name (as shown above) for your cloned route or session.<br>
  
 
<table bgcolor=#000000 width=900>
 
<table bgcolor=#000000 width=900>
Line 1,452: Line 1,576:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>If the first option ([[image:White_Select_Dot.png|link=]]&nbsp;'''Save new route and session''') is selected then the '''Route will be cloned''' using your new or edited name. The '''Session will be also cloned''' using its original name but it will use the newly cloned Route as a '''dependency''' instead of the original Route. If you do not want to keep the original '''Route''' then it can be safely deleted, which will also delete the original '''Session''' but the new cloned '''Route''' and '''Session''' will remain.
+
<td>If the first option ([[image:White_Select_Dot.png|link=]]&nbsp;'''Save new route and session''') is selected then the '''Route will be cloned''' using your new or edited name. The '''Session will be also cloned''' using its original name but it will use the newly cloned Route as a '''dependency''' instead of the original Route.
 +
*If the original route is '''Freeware''' (e.g. from the '''DLS''') and you do not want to keep it then it can be safely deleted, which will also delete the original session but the new cloned route and session will remain active on your system.
 +
*If the original route is '''Payware''' (e.g. from the '''DLC''') then deleting or disabling it will disable your cloned route and session. When '''Payware''' is cloned it must remain active on your system for the clone to work.  
 
</td>
 
</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>If the second option ([[image:White_Select_Dot.png|link=]]&nbsp;'''Save new session''') is selected then only the '''Session will be cloned''' using your new or edited name (make sure that you change the "Default" to something else) but it will still use the original (uncloned) Route as a '''dependency''' - so it is vital that you '''DO NOT DELETE''' the original '''Route'''. But it is safe to delete the original '''Session''' if you no longer need it.
+
<td>If the second option ([[image:White_Select_Dot.png|link=]]&nbsp;'''Save new session''') is selected then only the '''Session will be cloned''' using your new or edited name (make sure that you change the "Default" to something else) but it will still use the original (uncloned) Route as a '''dependency''' - so it is vital that you '''DO NOT DELETE''' the original route.
 +
*If the original session is '''Freeware''' then it can be safely deleted if you no longer need it.
 +
*If the original session is '''Payware''' then deleting or disabling it will also disable your cloned session.  
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 1,484: Line 1,612:
 
<td><span style="font-size: 17px; font-weight: 700;">Steps:</span><br>
 
<td><span style="font-size: 17px; font-weight: 700;">Steps:</span><br>
 
#In '''Content Manager''' select the filter '''Routes & Sessions'''
 
#In '''Content Manager''' select the filter '''Routes & Sessions'''
#select the '''Route''' or '''Session''' to be cloned
+
#select the route or session to be cloned
 
#either
 
#either
 
#*from the '''Content Menu''' select '''Clone''' OR
 
#*from the '''Content Menu''' select '''Clone''' OR
Line 1,596: Line 1,724:
 
<td>
 
<td>
 
Load the cloned Route or Session into '''Surveyor''', then
 
Load the cloned Route or Session into '''Surveyor''', then
*to rename a '''Route''' open the '''Edit''' menu and select '''Edit Route''', or press <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Ctrl&nbsp;</span>&nbsp;<span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;E&nbsp;</span> - see [[image:PageLink.PNG|link=]]&nbsp;'''[[#Editing a Route|Editing a Route]]''' above
+
*to rename a route open the '''Edit''' menu and select '''Edit Route''', or press <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Ctrl&nbsp;</span>&nbsp;<span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;E&nbsp;</span> - see [[image:PageLink.PNG|link=]]&nbsp;'''[[#Editing a Route|Editing a Route]]''' above
*to rename a '''Session''' open the '''Edit''' menu and select '''Edit Session''', or press <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Ctrl&nbsp;</span>&nbsp;<span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;R&nbsp;</span> - see [[image:PageLink.PNG|link=]]&nbsp;'''[[#Editing a Session|Editing a Session]]''' above
+
*to rename a session open the '''Edit''' menu and select '''Edit Session''', or press <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Ctrl&nbsp;</span>&nbsp;<span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;R&nbsp;</span> - see [[image:PageLink.PNG|link=]]&nbsp;'''[[#Editing a Session|Editing a Session]]''' above
 
Both will also allow you to edit the '''Name''' and '''Description''' of the cloned '''Route/Session'''.
 
Both will also allow you to edit the '''Name''' and '''Description''' of the cloned '''Route/Session'''.
 
</td>
 
</td>
Line 1,634: Line 1,762:
 
When you are in '''Driver''' select <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Save&nbsp;</span> from the '''System Menu''' or press <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Ctrl&nbsp;</span>&nbsp;<span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;S&nbsp;</span>.<br>
 
When you are in '''Driver''' select <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Save&nbsp;</span> from the '''System Menu''' or press <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Ctrl&nbsp;</span>&nbsp;<span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;S&nbsp;</span>.<br>
  
This will display the '''Save Driver Session''' dialogue window showing the name of the current '''Session''' with a date and time stamp (shown left below). If you click the Tick then this will be the name used for the saved game. Alternatively, you could enter your own unique name (shown right below).<br>
+
This will display the '''Save Driver Session''' dialogue window showing the name of the current session with a date and time stamp (shown left below). If you click the Tick then this will be the name used for the saved game. Alternatively, you could enter your own unique name (shown right below).<br>
  
The space below the entered name will display any other saved '''Driver Games''' for that '''Session'''.
+
The space below the entered name will display any other saved driver games for that session.
 
</td>
 
</td>
 
<td width=155>[[image:DriverSaveMenu.png|link=|alt=Save Menu]]</td>
 
<td width=155>[[image:DriverSaveMenu.png|link=|alt=Save Menu]]</td>
Line 1,649: Line 1,777:
 
</table>
 
</table>
 
=='''Loading Driver Games'''==
 
=='''Loading Driver Games'''==
Saved '''Driver Games''' will be shown with their '''Sessions''' for a selected '''Route'''. The section '''[[file:PageLink.PNG|link=]]&nbsp;[[#Loading an Existing Session|Loading an Existing Session]]''' shows two different methods of displaying saved '''Sessions''' and their '''Driver Games'''. <br>
+
Saved driver games will be shown with their sessions for a selected route. The section '''[[file:PageLink.PNG|link=]]&nbsp;[[#Loading an Existing Session|Loading an Existing Session]]''' shows two different methods of displaying saved sessions and their driver games. <br>
'''Method''' [[image:DotPoint1.JPG|link=]] will display '''ALL''' the saved '''Sessions''' and '''Driver Games''' which may be a very long list.<br>
+
'''Method''' [[image:DotPoint1.JPG|link=]] will display '''ALL''' the saved sessions and driver games which may be a very long list.<br>
'''Method''' [[image:DotPoint2.JPG|link=]] will display '''ALL''' the saved '''Sessions''' and '''Driver Games''' for a selected '''Route''', which should be a much shorter list.<br>
+
'''Method''' [[image:DotPoint2.JPG|link=]] will display '''ALL''' the saved sessions and driver games for a selected route, which should be a much shorter list.<br>
  
Using '''Method 2:''' select the '''Route''' first and then click the <span style="background-color: black; color: white; font-weight: 700; font-size: 15px;">&nbsp;VIEW SESSIONS&nbsp;</span> button. This will display a list of thumbnails for all the '''Sessions''' and '''Driver Games''' in that '''Route'''.<br>
+
Using '''Method 2:''' select the route first and then click the <span style="background-color: black; color: white; font-weight: 700; font-size: 15px;">&nbsp;VIEW SESSIONS&nbsp;</span> button. This will display a list of thumbnails for all the sessions and driver games in that route.<br>
  
 
[[image:DriverLoadDriverSession.png|link=|alt=Load Driver Game]]<br>
 
[[image:DriverLoadDriverSession.png|link=|alt=Load Driver Game]]<br>
Line 1,669: Line 1,797:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>Where a '''Route''' has multiple '''Sessions''' and '''Driver Games''' they will all be shown by their thumbnails with no way of telling which '''Driver Games''' belong to which '''Session'''.</td>
+
<td>Where a route has multiple sessions and driver games they will all be shown by their thumbnails with no way of telling which driver games belong to which session.</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>It can also be difficult to tell which thumbnail is a '''Session''' and which is a '''Driver Game''', especially if you have removed the date/time stamp '''Trainz''' automatically adds to the name of a '''Driver Game'''. A simple way to tell is to click on a thumbnail to see if the <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;EDIT SESSION&nbsp;</span> button is still visible. If it is not, because '''Driver Games''' cannot be edited, then the thumbnail is for a '''Driver Game'''.
+
<td>It can also be difficult to tell which thumbnail is a session and which is a '''Driver Game''', especially if you have removed the date/time stamp '''Trainz''' automatically adds to the name of a '''Driver Game'''. A simple way to tell is to click on a thumbnail to see if the <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;EDIT SESSION&nbsp;</span> button is still visible. If it is not, because driver games cannot be edited, then the thumbnail is for a '''Driver Game'''.
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 1,681: Line 1,809:
 
</table>
 
</table>
  
Where there is only one session in a '''Route''', the '''Session''' will be the first thumbnail shown in the list followed by the '''Driver Games'''. Note that the '''Session''' is selected by default.<br>
+
Where there is only one session in a route, the session will be the first thumbnail shown in the list followed by the driver games. Note that the session is selected by default.<br>
  
 
Select (hightlight) the '''Driver Game''' you want to load and click the <span style="font-weight: 700; background-color: black; color: white; font-size: 15px;">&nbsp;DRIVE SESSION&nbsp;</span> button.<br>
 
Select (hightlight) the '''Driver Game''' you want to load and click the <span style="font-weight: 700; background-color: black; color: white; font-size: 15px;">&nbsp;DRIVE SESSION&nbsp;</span> button.<br>
Line 1,687: Line 1,815:
 
[[image:DriverButtonsNoEdit.png|link=|alt=Driver Game]]<br>
 
[[image:DriverButtonsNoEdit.png|link=|alt=Driver Game]]<br>
  
This will load  the '''Driver Game''', the '''Session''' and the '''Route''' into '''Driver'''.<br>
+
This will load  the '''Driver Game''', the session and the route into '''Driver'''.<br>
  
 
<table bgcolor=#ff0000 width=900>
 
<table bgcolor=#ff0000 width=900>
Line 1,695: Line 1,823:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:Stop.PNG|link=]]</td>
 
<td>[[image:Stop.PNG|link=]]</td>
<td>If you load a '''Driver Game''' after you have edited the original '''Route''' or '''Session''' that was used to create it, then you will receive a message warning you that changes have been made to the original assets. The changes could affect the operation of the '''Driver Game'''.
+
<td>If you load a '''Driver Game''' after you have edited the original route or session that was used to create it, then you will receive a message warning you that changes have been made to the original assets. The changes could affect the operation of the '''Driver Game'''.
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 1,708: Line 1,836:
 
<span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Ok&nbsp;</span> - load the '''Driver Game''' wirh the changes<br>
 
<span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Ok&nbsp;</span> - load the '''Driver Game''' wirh the changes<br>
 
<br>
 
<br>
If the changes to the '''Route''' or '''Session''' have been:-
+
If the changes to the route or session have been:-
 
*minor and non-operational, such as scenery assets (trees, buildings, etc) then the '''Driver Game''' can be safely loaded.<br>
 
*minor and non-operational, such as scenery assets (trees, buildings, etc) then the '''Driver Game''' can be safely loaded.<br>
 
*more significant operational changes, such as triggers, trackmarks, active industries, consists, tracks, etc, then it may not be wise to load and run the '''Driver Game'''.<br>
 
*more significant operational changes, such as triggers, trackmarks, active industries, consists, tracks, etc, then it may not be wise to load and run the '''Driver Game'''.<br>
Line 1,735: Line 1,863:
 
='''Deleting Routes and Sessions'''=
 
='''Deleting Routes and Sessions'''=
  
All the '''Surveyor''' and '''Driver''' screens for loading '''Routes''' and '''Sessions''' have a <span style="font-weight: 700; background-color: black; color: white; font-size: 15px;">&nbsp;DELETE ...&nbsp;</span> button as an option. Selecting a thumbnail and clicking <span style="font-weight: 700; background-color: black; color: white; font-size: 15px;">&nbsp;DELETE ...&nbsp;</span> will delete the selected thumbnail and the '''Route/Session''' it represents.<br>
+
<table cellpadding=4 bgcolor=#c1e7e7>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|link=]]</td>
 +
<td>'''Deleting a Session will delete that Session and its Driver Games (if any), not the Route it was created from or any other Sessions'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|link=]]</td>
 +
<td>'''Deleting a Driver Game will only delete that Driver Game, not the Route or Session it was created from or any other Driver Games'''</td>
 +
</tr>
 +
</table>
 +
<br>
 +
All the '''Surveyor''' and '''Driver''' screens for loading routes and sessions have a <span style="font-weight: 700; background-color: black; color: white; font-size: 15px;">&nbsp;DELETE ...&nbsp;</span> button as an option.<br>
  
 
<table bgcolor=#ff0000>
 
<table bgcolor=#ff0000>
Line 1,747: Line 1,886:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[file:Stop.PNG|link=]]</td>
 
<td>[[file:Stop.PNG|link=]]</td>
<td>'''If you delete a Route you will also delete all Sessions (including Driver Games) created using that Route'''
+
<td>'''If you delete a Route you will also delete all the Sessions and Driver Games created using that Route'''
 
</td>
 
</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:Stop.PNG|link=]]</td>
 
<td>[[image:Stop.PNG|link=]]</td>
<td>'''If you delete a Session you will also delete all Driver Games created using that Session
+
<td>'''If you delete a Session you will also delete all the Driver Games created using that Session
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 1,760: Line 1,899:
 
</table>
 
</table>
 
<br>
 
<br>
<table cellpadding=4 bgcolor=#c1e7e7>
+
If you need a more selective way of deleting routes, sessions and driver games, then use '''Content Manager''' from the '''Trainz''' Launch Screen. Select the Filter '''Routes &amp; Sessions'''.<br>
<tr valign="top">
+
<td>[[image:DotPoint.JPG|link=]]</td>
+
<td>'''Deleting a Driver Game will only delete that Driver Game, not the Session or Route it was created from'''</td>
+
</tr>
+
</table>
+
<br>
+
If you need a more selective way of deleting '''Routes''', '''Sessions''' and '''Driver Games''', then use '''Content Manager''' from the '''Trainz''' Launch Screen. Select the Filter '''Routes &amp; Sessions'''.<br>
+
  
 
[[image:RouteSessionCMList.png|link=|alt=CM list of routes and sessions]]<br>
 
[[image:RouteSessionCMList.png|link=|alt=CM list of routes and sessions]]<br>
  
The '''Type''' column will identify each entry as a '''Route''', '''Session''' or '''Misc'''. '''Misc''' in this case means a saved '''Driver Game'''.<br>
+
The '''Type''' column will identify each entry as a route, session or '''Misc'''. '''Misc''' in this case means a saved '''Driver Game'''.<br>
  
You can delete '''Routes''' and/or '''Sessions''' individually but if you delete a '''Route''' by itself then its dependant '''Sessions''' and '''Driver Games''' will be shown as <span style="color: red; font-weight: 700;">faulty</span> with <span style="color: red; font-weight: 700;">Missing dependencies</span>. Likewise, if you delete a '''Session''' by itself then its dependant '''Driver Games''' will be shown as <span style="color: red; font-weight: 700;">faulty</span> with <span style="color: red; font-weight: 700;">Missing dependencies</span>.<br>
+
You can delete routes and/or sessions individually but if you delete a route by itself then its dependant sessions and driver games will be shown as <span style="color: red; font-weight: 700;">faulty</span> with <span style="color: red; font-weight: 700;">Missing dependencies</span>. Likewise, if you delete a session by itself then its dependant driver games will be shown as <span style="color: red; font-weight: 700;">faulty</span> with <span style="color: red; font-weight: 700;">Missing dependencies</span>.<br>
 
<br>
 
<br>
 
<table> <!-- BEGIN Nav Buttons Table -->
 
<table> <!-- BEGIN Nav Buttons Table -->

Revision as of 11:48, 25 July 2022

The information in this Wiki Page applies to TRS19, Trainz Plus and TRS22. This page is intended to provide you with an overview of the properties and features of Routes and Sessions when creating layouts for Trainz. More detailed descriptions of these various features plus instructions on getting you started with creating Routes and Sessions can be found in the Trainz Wiki How To Guides - links are provided at the end of this document.

Contents

  Top   Next Down Bottom

Trainz Worlds

The virtual worlds that Trainz creates can be classified as:-

 Route-Sessions-Games
DotPoint.JPG Routes

Routes are created in Surveyor and contain most (if not all) of what you will see in your virtual Trainz world. You can have multiple routes, limited only by your storage space. Routes can be built to represent different geographical regions (real or imagined) and different periods of time (past, present, future). Each route can have one or more:-

DotPoint.JPG Sessions

Sessions are also created in Surveyor but are designed to be run in Driver. Sessions contain the instructions that will control your trains when they are operating in automatic or "AI" mode in your route. They also control the goods your trains will carry, load and unload at industries along the way, regardless of whether you are driving them manually or using the AI. You can create different sessions for different aspects of your railway - freight, passenger, shunting or a mixture - or for different seasons of the year or times of the day. A session can also contain scenery items that are specific to a particular railway operation, season of the year or time of day that will only appear in that specific session. Sessions also control some of the environment settings in your virtual world, such as lighting and the weather. A session can have many:-

DotPoint.JPG Driver Games (or Driver Sessions or Saved Games)
Driver Games (also known as Driver Sessions and Saved Games) are created in Driver and save the "state of play" in a running session so you can restart it at the same point at a later time. They are optionally stamped with the date and time they were saved and the play duration.


  Top Next Up Next Down Bottom

What is a Route?

A route (also known as a "Layout") consists of most of what you will see on the screen when using Surveyor and Driver. Things such as the landform or terrain, most (if not all) of the scenery items, the ground textures, the effect layers (TurfFX and Clutter), plus some "environmental" features.

A route consists of two parts:-

  1. Route Data and
  2. Route Layers.


DotPoint.JPG When you save a Route, all the items in the Route Data and Route Layers will be saved


 Route Data: 

DotPoint.JPG The Route Data stores all those features that are painted into a layout using a brush tool
DotPoint.JPG The Route Data stores all the Environmental Data including the World Origin (latitude, longitude, altitude)

This covers all those visual elements that are "painted" in Surveyor with a brush tool and all the Environmental features.

Route Data

Route Data consists of:-

  • Landforms (Terrain) - baseboards and ground height
  • Water height and spread
  • Ground Textures including the grid pattern which is a texture
  • TurfFX and Clutter - found in the Effects Layers
  • Environmental Settings - World Origin (latitude, longitude, altitude), Water Surface (rough/calm/etc), Snow Altitude, Lighting (sun, ambient and water colours), Sky (clouds), Road Traffic (on/off), Date (day, month), Wind strength, Fog level, Weather (rain/fine/snow), Brightness level. You must edit and save the route for these settings to become part of the Route Data - see the Trainz Wiki page WikiLink.PNG How to Use the Environment Tools for more details.

 Route Layers: 

DotPoint.JPG Route Layers are used to hold the scenery assets that you want to appear in all sessions created for the route


All scenery assets are held in layers. Route Layers give you a way of organising or grouping the assets displayed in your route.

Route Layers

Route Layers have those scenery items that you want to always appear.

Route Layers can contain:-

  • Track and Track Objects (such as signals, switches, bridges, tunnels, speed signs, etc)
  • Most (or all) scenery items (e.g. buildings, trees, rocks, active industries/stations) and scenery splines (e.g. roads, fences, etc)
  • Rolling Stock (including locos) -  Note:  It is strongly recommended that all rolling stock be placed into a Session Layer
  • Lineside and Fixed Cameras
  • Trackmarks, Triggers, Direction and Priority Marks


NotePad.PNG Scenery objects can also be stored in a session. This can cause confusion if you load a route without loading a session and find that some scenery items are "missing". See PageLink.PNG Loading an Existing Route below for how to deal with this issue.


LinkWiki.PNG

A detailed description of Layers can be found on the Trainz Wiki Page How to Use Layers


  Top Next Up Next Down Bottom

Loading (and Creating) a Route

The Main Menu screen is shown below. The first option (shown highlighted in the image) opens Driver/Surveyor with all its options including loading and creating a route.

TRS19 Main Screen options

In Driver/Surveyor a strip of thumbnails for all the installed Routes will be shown at the base of the screen. The strip will scroll horizontally if there are too many to display. Just move the mouse pointer onto any thumbnail to reveal the scroll bar device.

TRS19 Main Screen Route Selection

The  MAIN MENU  button will take you back to the starting or main screen.
The  Sort By A-Z  (top right of the image above) will give you a drop down menu of sorting options for the thumbnail list.
The MainScreenDownArrow.png button will expand the thumbnail list to fill the screen - click it again to return the thumbnails to the strip at the bottom of the screen.

The thumbnail images are colour coded.

  Payware on DLC Must be purchased and downloaded, but some may be free. There will be a  DOWNLOAD  button on the bottom right of the screen. If a price is included in the button then that is the purchase price (in $US)
  Payware installed Already installed from the DLC. DLC items cannot be deleted. To remove them use the Uninstall option in the Content Store from the Launcher. You can reinstall them later without any additional cost
  Installed Downloaded from the Download Station (DLS) or created by you. This includes any cloned DLC Routes and Sessions (see PageLink.PNG Cloning a Route/Session below)
 
 
Multiplayer For simultaneous development by multiple players. Special conditions apply


Creating a New Route

On the Driver/Surveyor screen the route options are shown as a set of buttons at the bottom of the screen.

Create a New Route

Click  CREATE ROUTE . This will start Trainz Surveyor and open the New Route Dialogue Window.

New Route dialogue window
PencilTips.PNG All these settings plus others can be easily changed at any time after the route has been created.
Route edit From the Edit menu select Edit Route or press  Ctrl   E 

For more details see PageLink.PNG Editing a Route below.

It is strongly advised that you enter some details before clicking the tick icon to create the new route. This will save you time and hassle later.

 Route name:  Enter a name for your new Route (keep it simple)
 Session name:  Enter a name for your Session (again keep it simple) - see Notes: below
 Geographical region:  Select a region from the drop down list
Route Details
NotePad.PNG Notes:
DotPoint1.JPG You do not have to add the name of a session but when you save a new route without a named session a default session will be automatically saved with the name Default. This can later cause confusion if a multitude of different Default Sessions appear so it is recommended that a unique Session name be entered at this point.
  A session can always be deleted later if you have no interest in creating one for your route - see PageLink.PNG Deleting Routes and Sessions below. However a route with a session does have some important advantages - see PageLink.PNG What is a Session? below.
DotPoint2.JPG Setting a Geographical region sets some basic features of the route - such as its latitude (used to determine the season of the year), the altitude (in metres) of the first baseboard, the number and types of moving road vehicles (if any), to name a few. If none of the installed regions are suitable you can download others from the DLS or create a region of your own - see WikiLink.PNG How to Create a Region Asset
DotPoint3.JPG The Working scale provides measurements that are comparable to model railroading dimensions, but the actual (physical) sizes of the layout and its assets are not altered or scaled down. It is only the Surveyor Ruler tool that will be affected. The choices are between Real scale (which is the default), G scale (100m real scale = 4.4m G scale), HO scale (100m real scale = 1.1m HO scale) and many other options.
DotPoint4.JPG The Working units choice between Metric (metres, kilometres) and Imperial (yards, miles) only affects the measurement and display of horizontal distances used for rulers and track distances, and for train speeds (km/h or mph). Note that track speed signs are always locked at either metric (km/h) or imperial (mph) and will not be altered by this selection. Altitudes are always measured and displayed using Metric units (metres).

Loading an Existing Route

You must first find and select the route to load from those already installed. At the top of the Driver/Surveyor screen the route search options are shown as a set of buttons.

Route Search

Type:  ROUTES  is the default selection. No need to change this.
Source:  PURCHASED  is the default selection, Click and change to  MY CONTENT  for a route you have created (or already modified) or to  INSTALLED  for one you have downloaded from the DLS.
Region:  ALL  is the default selection. You can select a particular geographic region if required and IF the route had a geographic region set when it was created.
Search: You can narrow down the list of routes by typing the first few letters of its name (e.g. SA) as shown in the image above.

This will produce a display of thumbnails at the bottom of the screen.

Existing Routes

Click on the thumbnail for the route you want to load, then click on the  EDIT ROUTE  button to load the route into Surveyor.

Edit Route

NotePad.PNG Notes: Routes and Sessions - An Endless Source of Confusion

Scenery objects that have been placed in a session will NOT APPEAR if the route has been loaded into Surveyor without also loading the session.

If scenery objects have mysteriously vanished when you reload a route into Surveyor it is highly likely that those objects have been saved in a session. You must load the session into Surveyor to make them visible again.

You can easily move most scenery objects from a session into a route if needed - see the Trainz Wiki Page WikiLink.PNG How to Use the Bulk Asset Update/Replace Tool for more details.

Loading a Route Into Surveyor From Content Manager

Trainz provides a shortcut that allows you to load an existing route directly into Surveyor for editing from Content Manager.

Load a route from CM

Steps.PNG Steps:
  1. in Content Manager select the filter Routes & Sessions
  2. select the route to be edited
  3. use the right-mouse-button to open the Command Menu
  4. select Open..., then
  5. select Edit Asset in Surveyor

Loading After an Unexpected Shutdown

If you select a route for loading after an unexpected shutdown of Trainz then any route (or route and session) that was open and running in Trainz Surveyor or Driver will be left marked as Open for Edit. When you attempt to load this route into Surveyor or Driver you will see a message listing the route and session (if any) that were affected.

Load after CTD
NotePad.PNG Note:

A similar message will appear when you load a Driver Game (see PageLink.PNG Saving and Loading Sessions in Driver below) after editing the original route or session that was used to create the Driver Session.

It is possible that the changes you have made may affect the operation of the Driver Session.

The message is saying that the assets in the list may have been changed since the last time you loaded them and exited Trainz normally. For example if you had been editing the route and/or session and had experienced a crash to the desktop or had used Windows Task Manager to terminate the program.

The options you will see are:-

 Use changes    Use the edited/changed versions that are in the open database assets - there is a possibility that they may have been damaged during the shutdown and may be corrupted
 Revert changes    Ignore the edited/changed versions and load the previous versions instead
 Cancel    Cancel the Load and return to the Surveyor/Driver menu screen

You could also use the Content Manager program (select  Manage Content  from the Trainz Launcher) to Submit the open route or route and session assets. This has the risk of replacing the last good copy of that asset or assets with a possibly faulty copy.

Editing a Route

DotPoint.JPG When a Route is loaded or a new Route is created all the assets you add will be automatically placed into a Route Layer

When you create a new route (with or without a named session), or load an existing route without a session, and start adding scenery assets they will automatically be placed into a Route Layer. See WikiLink.PNG How to Use Layers for more details.

Any ground textures, water, effect layers (turfFX and clutter) you add, or terrain changes (including new baseboards) you make, will be added to the Route Data.

Stop.PNG

WARNING: Do not edit track in a Route that is occupied by consists in any of the Sessions based on the Route

Moving or deleting a section of track in a Route that is occupied by a consist in a Session can cause the consist to become a "missing asset". This can happen if you load the Route only and not the Session. If a consist becomes a "missing asset" then the only immediate solution is to use the Delete missing assets command from the Tools menu in Surveyor.

Prevention:

if you have the consists placed in a Session then always load the Session, not just the Route, and move or delete any consists BEFORE editing the track they are occupying.



You can edit the Route Characteristics at any time by selecting the Edit Route command from the Edit menu or simply pressing  Ctrl   E .

This will bring up the Edit Route dialogue window (shown below).
Route edit
NotePad.PNG Route Characteristics:-

  • Name and Description
  • assigned Geographic Region, which sets a number of different features
  • Thumbnail image
  • Working Scale and Working Units
  • Draw Distance
Edit Route dialogue window
DotPoint1.JPG You can edit the Name of the Route. This will change the route username in the config.txt file but it will not alter the route <kuid> value
DotPoint2.JPG You can select a new Region. Depending on the region selected this could affect other features such as the moving road traffic, season of the year (through the latitude tag) and altitude
DotPoint3.JPG You can edit the Route Description
DotPoint4.JPG You can change the Route Thumbnail. Clicking the  Set Thumbnail  button will take a snapshot using the current camera view which will be used as the new thumbnail
DotPoint5.JPG You can change the Route Working Scale which will only affect the measurement shown in the Surveyor Ruler tool
DotPoint6.JPG You can change the Route Working Units to  Metric  or  Imperial  which will change the display of measurements using the Surveyor Ruler (to metres or yards) and how train speeds are calculated and displayed in Driver (in km/h or mph)
DotPoint7.JPG You can set or disable the Draw Distance Cap which will affect how far away from the camera that scenery objects will be drawn. This will affect the game performance and the fps (frames per second)
DotPoint8.JPG Clicking the Tick icon will save the entered values and exit back to Surveyor. Clicking the Cross icon will cancel any entered values and exit back to Surveyor


Merging Routes

DotPoint.JPG Two (or more) separate routes can be joined together (merged) to create a new route

There are some important restrictions on the merging of two routes:-

  • Payware (DLC) routes cannot be merged with Freeware (DLS) or other Payware routes
  • The Session Data and Session Layers in the first route can be saved in the merger, if required, but those in the other route are not
  • There may be a significant height difference between the two routes and this may not be easy to overcome
  • The orientation of the two routes (East-West or North-South) cannot be changed


LinkWiki.PNG

A detailed description of the process of Merging Routes can be found on the Trainz Wiki Page How to Merge Routes


  Top Next Up Next Down Bottom

What is a Session?

DotPoint.JPG A Session is always a part of an existing Route - you cannot have a Session that does not belong to a Route
DotPoint.JPG If you create a Route without a Session then ALL the active industries and rolling stock, time, environmental conditions, etc, will revert to their original (default) values. There will be no AI drivers and drivers will have a very limited set of available commands for manual driving

In general, while a route provides the physical structures (or "hardware"), a session provides the services (or "software"). While you can easily have a route without a session, it could be a very limited (or even a boring) experience.

A single route can have multiple sessions, or none, but a session must always belong to a route. To put it into Trainz terminology, a session has a route as a dependency.

A session consists of two parts:-

  1. Session Data and
  2. Session Layers.


DotPoint.JPG When you save a Session, all the items in the Session Data and Session Layers will be saved


 Session Data: 

Session Data are often the "invisibles" that control the operation of a session. Session rules, driver orders and loco assignments, commodities (loaded, unloaded and carried) and most of the Environmental Settings are examples of Session Data.

Session Data

Session Data contains:-

  • Drivers (names, AI commands and assigned locos)
  • Driver Commands - those available for AI and manual driving
  • Session Rules
  • Industry Settings (commodities consumed and produced)
  • Consist Settings (commodities carried)
  • Consist Locations - this is stored in the session even if the consists are placed in the route
  • Switch Settings (left/right) - but the default switch direction is stored in the route
  • Environmental Settings - Water Surface (rough/calm/etc), Snow Altitude, Lighting (sun, ambient and water colours), Sky (clouds), Road Traffic (on/off), Date (day, month), Wind strength, Fog level, Weather (rain/fine/snow), Brightness level. You must edit and save the session for these settings to become part of the Session Data - see WikiLink.PNG How to Use Environment Tools for more details. If both a route and a session have saved Environmental Settings, which do not have to be the same, then those in the session will be used. If the session does not have any saved Environmental Settings then those in the route will be used


 Session Layers: 

DotPoint.JPG Session Layers are used to hold the scenery assets that you want to only appear in that particular Session and not in all Sessions
DotPoint.JPG Session Layers can be left empty and the Route Layers can contain all the scenery assets

Session layers

Session Layers give you a way of organising or grouping the assets displayed in your session.

Session Layers can contain:-

  • Scenery
  • Rolling Stock (including locos) -  Note:  It is strongly recommended that all rolling stock be placed into a Session Layer
  • Trackmarks, Triggers, Direction and Priority Markers
NotePad.PNG Notes:

While it is possible to add track and track objects (bridges, tunnels, turntables, signals, switches, etc) to Session Layers it is not recommended. These fixed assets should be placed into Route Layers.


LinkWiki.PNG

A detailed description of Layers can be found on the Trainz Wiki Page How to Use Layers


NotePad.PNG Notes:

Scenery, Rolling Stock, Triggers and Markers (Track, Direction, Priority) can be used in both Route Layers and Session Layers. Assets placed in a Route Layer will appear in all sessions that are based on the route. The vast majority of (if not all) scenery items will be placed in Route Layers. Assets placed in a Session Layer will only appear in the currently loaded session.

Examples of assets that would be placed in a Session Layer instead of a Route Layer would include:-

  • products waiting at a factory for pickup in an industrial session that would not be present in a weekend or holiday passenger session
  • signallers holding lanterns in a night session only or standing alongside manual track switch levers in a daylight shunting session
  • trackmarks and triggers that are only required in one session but not in all sessions
  • crowds of onlookers alongside the track in a session recreating an historic steam train run, together with
  • historic rolling stock in a special vintage train session running on a modern route


  Top Next Up Next Down Bottom

Loading (and Creating) a Session

Creating a New Session

DotPoint.JPG To create a new Session you must first create a new Route or identify an existing Route

A new session can be created in two ways:-

 Method DotPoint1.JPG Automatically When a New Route is Created 
Route Details Follow the steps shown in the section PageLink.PNG Creating a New Route above by entering:-
  • a Route name for the new route
  • a Session name for the new session
  • a Geographical region
  • Working scale and Working units
 Method DotPoint2.JPG Adding a Session to an Existing Route 


NotePad.PNG Notes:

A route can have many individual sessions so a new session can be added to an existing route that already has sessions installed.

The first step is to locate (but not load) the route as described in the section PageLink.PNG Loading an Existing Route above.

Once you have selected the route from its thumbnail, click the  VIEW SESSIONS  button.

View Sessions

Then click the  CREATE SESSION  button. If no other session exists for this route then this will be the only choice available to you.

Create Session

 

Both methods will load the route into Surveyor and create a new session with all its values/parameters set at default levels.

Loading an Existing Session

There are two different ways to load existing sessions into Surveyor.

 Method DotPoint1.JPG Search For the Session 
The easiest way to load an existing session is to use the search tools at the top of the Driver/Surveyor screen.

Session Search

Type:  ROUTES  is the default selection. Change this to  SESSIONS .
Source:  PURCHASED  is the default selection, Click and change to  MY CONTENT  for a session you have created (or already modified) or to  INSTALLED  for one you have downloaded from the DLS.
Gameplay:  ALL  is the default selection. There is no need to change this
Search: If required you can narrow down the list of sessions by typing the first few letters of its name.

This will produce a list of session thumbnails at the bottom of the screen. As with the route thumbnails, the list can be scrolled horizontally.

Existing Sessions

The same colour coding system used in the route thumbnails also applies to session thumbnails.

  Payware on DLC Must be purchased and downloaded, but some may be free. There will be a  DOWNLOAD  button on the bottom right of the screen. If a price is included in the button then that is the purchase price (in $US)
  Payware installed Already installed from the DLC. DLC items cannot be deleted. To remove them use the Uninstall option in the Content Store from the Launcher. You can reinstall them later without any additional cost
  Installed Downloaded from the Download Station (DLS) or created by you. This includes any cloned DLC Routes and Sessions (see PageLink.PNG Cloning a Route/Session below)
 
 
Multiplayer For simultaneous development by multiple players. Special conditions apply


Click on the thumbnail for the session you want to load and then click on the  EDIT SESSION  button. This will load BOTH the route and the session into Surveyor.

Edit Session

NotePad.PNG

If the  EDIT SESSION  option is not present then the selected session is a saved Driver Game (a "game" saved when in Driver) and cannot be edited. See the section PageLink.PNG Saving and Loading Sessions in Driver below.


 Method DotPoint2.JPG Select the Route First 
Select the route as described in the section PageLink.PNG Loading an Existing Route above. Then click the  VIEW SESSIONS  button.

View Sessions

This will display a list of thumbnails for all the sessions in that route. Select the session thumbnail you need and then click the  EDIT SESSION  button.

Edit Session

Again, both the selected route and its session will be loaded into Surveyor.

NotePad.PNG

If the  EDIT SESSION  option is not present then the selected session is a saved Driver Game (a "game" saved when in Driver) and cannot be edited. See the section PageLink.PNG Saving and Loading Sessions in Driver below.

 

Loading a Session Into Surveyor From Content Manager

Trainz provides a shortcut that allows you to load an existing session directly into Surveyor for editing from Content Manager.

Load a session from CM

Steps.PNG Steps:
  1. in Content Manager select the filter Routes & Sessions
  2. select the session to be loaded and edited in Surveyor
  3. use the right-mouse-button to open the Command Menu
  4. select Open..., then
  5. select Edit Asset in Surveyor

Both the route and the session will be loaded into Surveyor for editing.

Loading a Session into Driver From Surveyor

To start Driver simply select a session as described above in Loading an Existing Session and click the  DRIVE SESSION  button.

Driver Game

This will load both the session and the route into Driver.

You can save your "game play" in Driver at anytime. See PageLink.PNG Saving and Loading Sessions in Driver below.

Loading a Session into Driver From Content Manager

Trainz provides a shortcut that allows you to load an existing session directly into Driver from Content Manager.

Load a session from CM

Steps.PNG Steps:
  1. in Content Manager select the filter Routes & Sessions
  2. select the session to drive
  3. use the right-mouse-button to open the Command Menu
  4. select Open..., then
  5. select Open Asset in Driver

The session and its parent route will be loaded into Driver and the simulation will be started.

Editing a Session

DotPoint.JPG When a Session is loaded into Surveyor or a new Session is created for an existing Route, all the assets you add will be automatically placed into a Session Layer

When you create a new session, or load an existing session, and start adding scenery assets in Surveyor they will automatically be placed into a Session Layer. See the Trainz Wiki Page WikiLink.PNG How to Use Layers for more details.

Any changes made to the Session Rules (including drivers and their commands), the Environment Tools, Industry or Rolling Stock settings, will be added to the Session Data.

There are also other changes that will be added to the Session Data.


You can edit the Session Characteristics at any time by selecting the Edit Session command from the Edit Menu or by simply pressing  Ctrl   R .
This will bring up the Edit Session dialogue window which is more commonly called the Session Editor (shown below).

For more details on editing a Session see the Trainz Wiki Page at WikiLink.PNG The Session Editor.
Session edit
NotePad.PNG Session Characteristics:-

  • Name and Description
  • Session Rules which control/set:-
    • drivers and their consists
    • driver commands
    • time of day/night
    • events
    • and much, much more
Edit Session dialogue window
DotPoint1.JPG You can edit the Name of the Session. This will change the session username in the config.txt file but it will not alter the session <kuid> value
DotPoint2.JPG You can edit the Session Description
DotPoint3.JPG You can add, delete and edit the Session Rules

You can edit the Environment Controls of a Session by selecting the Edit Environment command from the Edit Menu.
This will bring up the Edit Environment dialogue window, more commonly called the Environment Tools.

For more details on editing the Environment see the Trainz Wiki Page at WikiLink.PNG The Environment Tools
Environment edit
NotePad.PNG Environment Controls:-

  • lighting conditions
  • weather and cloud cover
  • water color and water surface
  • wind speed (for SpeedTree assets only)
  • fog and snow
  • season (by the date and latitude)
  • world origin
  • road traffic (on or off only)


  Top Next Up Next Down Bottom

Saving a Route and a Session

Routes and Sessions are saved from the System Menu on the Surveyor screen.

Save
DotPoint.JPG Selecting  Save  or pressing  Ctrl   S  will save the route, or the route and the session, with the previously entered name(s) when they were loaded or created. You will be asked to confirm both the names (and can change them if you wish) and the Save command.

DotPoint.JPG Selecting  Save As...  will save the route, or the route and the session, with the previously entered name(s) when they were loaded or created. You will be asked to confirm both the names (and can change them if you wish) and the Save As command.


NotePad.PNG Notes on Saving Routes and Sessions:

DotPoint.JPG DLS routes and sessions can be modified and saved as new routes and sessions.

Modifying and creating:-

  • if you have modified a DLS route then you can delete the original route if you no longer need it and your modified version will not be affected
  • if you have modified a DLS session then you can delete the original session if you no longer need it and your modified version will not be affected. However, if you delete the original DLS route then your modified session  will not work 
  • you can create a new session for a DLS route but it  will not work  if the original DLS route is deleted

Saving:-

  • when saved, modified DLS routes and sessions will become Your Content and can be found using the  MY CONTENT  search option in Surveyor/Driver
  • the original DLS routes and sessions will not be altered or replaced by your modified versions

Uploading:-

  • you can only upload your modified DLS route and session to the DLS if you have the permission of the original creator
DotPoint.JPG DLC routes and sessions can also be modified and saved as new routes and sessions if the creators of the original DLC content have allowed it - see PageLink.PNG Cloning a Route/Session below for more details

Modifying and creating:-

  • some DLC routes and sessions are encrypted and cannot be modified - that is a decision made by the content creator
  • your modified DLC route or session will become an alias of the original and will need the original route and session to be present on your system to work
  • if you delete or disable the original DLC route or session then your modified versions  will not work 
  • you can create a new session for a DLC route but it  will not work  if the original DLC route is deleted or disabled

Saving:-

  • when saved, a modified DLC route or session will become Your Content and can be found using the  MY CONTENT  search option in Surveyor/Driver
  • the original DLC route and session will not be altered or replaced by your modified versions

Uploading:-

  • you can upload your modified DLC route or session to the DLS but it can only be used by those who also have the same original (unmodified) DLC version installed


Saving a New Route and Session

If you have created a new route and select Save or Save As..., then you will be presented with the following Save Route Dialogue Windows.

First Save First Save As
In both cases the name of the route that was entered when it was created will be shown and you can change the name, even in the Save option. However, there is no option in either case to change the name of the created session because the other options have been greyed out and cannot be selected.


Saving an Existing Route

DotPoint.JPG If you have loaded the route only and not the session and HAVE NOT edited any Session Data or Session Layers, then selecting Save will produce the following Save Route Dialogue Window.
Save Route with no Session

Gears.PNG Settings:

Option DotPoint1.JPG Overwrite route only. This is the default selection so there is nothing to change.

White Select Dot.png Overwrite existing route and:
White Select Dot.png Do not save session
  • the route will be saved (overwritten using its current name) but no session will be saved.

Option DotPoint2.JPG Overwrite route and create a new session. Tick the box White Select Dot.png Create new session.

White Select Dot.png Overwrite existing route and:
White Select Dot.png Create new session:
  • enter a name for the session (the suggested name Default is NOT recommended).
  • the route will be saved (overwritten using its current name).
  • a new session will be created using the name you enter and it will be added to the route.
  • because you did not originally load a session, the new session will be saved with default values for all settings.

Option DotPoint3.JPG Create new route and a default Session. Tick the box White Select Dot.png Save new route and session.

White Select Dot.png Save new route and session:
  • enter a new name for the route. The route will be saved with its new name.
  • the original route will not be changed.
  • a new session will be created using the name Default and it will be added to the new route.
  • because you did not originally load a session, the new session will be saved with the default values for all settings.
After you have made your selections, click Tick.PNG to Accept or Cross.PNG to Cancel


DotPoint.JPG If you have loaded the route only and not the session and HAVE edited Session Data or Session Layers, then selecting Save will produce the following Save Route Dialogue Window.
Save Route with Session

Gears.PNG Settings:

Option DotPoint1.JPG Overwrite route and create a new session. This is the default selection so there is nothing to change.

White Select Dot.png Overwrite existing route and:
White Select Dot.png Create new session:
  • enter a name for the session (the suggested name Default is NOT recommended).
  • the route will be saved (overwritten using its current name).
  • a new session will be created using the name you enter and it will be added to the route. The new session will have the settings and changes you have made.

Option DotPoint2.JPG Overwrite route only. Tick the box White Select Dot.png Do not save session.

White Select Dot.png Overwrite existing route and:
White Select Dot.png Do not save session
  • the route will be saved (overwritten using its current name) but no session will be saved.
  • if you have edited the session and later exit the program without saving those edits (you will be prompted to save the session) then any changes you have made to the session will be lost.

Option DotPoint3.JPG Create new route and a default Session. Tick the box White Select Dot.png Save new route and session.

White Select Dot.png Save new route and session:
  • enter a new name for the route. The route will be saved with its new name.
  • the original route will not be changed.
  • a new session will be created using the name Default and it will be added to the new route. The new session will have the settings and changes you have made.
After you have made your selections, click Tick.PNG to Accept or Cross.PNG to Cancel


NotePad.PNG Notes:

DotPoint.JPG If you have edited any session Data or Layers but have selected the option Do not save session then later, before you exit the program, you will be prompted to save the edited session by the appearance of the Save Session dialogue box (see below).
DotPoint.JPG If you decide to create a new session and leave its name as Default then a new Default Session will be created to add to any others also named Default that may already be present in a route and this will cause confusion. This is why it is not a good idea to use Default as a session name.


Saving an Existing Route and Session

DotPoint.JPG If you have loaded a route and a session and have edited the route or the route and the session then selecting Save will produce the following Save Route Dialogue Window.
Save Route and Session

Gears.PNG Settings:

Option DotPoint1.JPG Overwrite route and session. This is the default selection so there is nothing to change.

White Select Dot.png Overwrite existing route and:
White Select Dot.png Overwrite existing session:
  • both the route and the session will be saved (overwritten using their current names).

Option DotPoint2.JPG Overwrite existing route and create a new session. Tick the box White Select Dot.png Create new session.

White Select Dot.png Overwrite existing route and:
White Select Dot.png Create new session:
  • enter a new name for the session.
  • the route will be saved (overwritten using its current name).
  • a new session will be created using the name you enter and it will be added to the existing route.
  • the original session will not be changed.

Option DotPoint3.JPG Overwrite route only. Tick the box White Select Dot.png Do not save session.

White Select Dot.png Overwrite existing route and:
White Select Dot.png Do not save session
  • the route will be saved (overwritten using its current name) but no session will be saved.
  • if you have edited the session and later exit the program without saving those edits (you will be prompted to save the session) then any changes you have made to the session will be lost.

Option DotPoint4.JPG Create a new route and a new session. Tick the box White Select Dot.png Save new route and session.

White Select Dot.png Save new route and session:
  • enter a new name for the route.
  • the route will be saved with its new name.
  • a new session will be created using the same name as the original session and it will be added to the new route.
  • the original session and route will not be changed.
After you have made your selections, click Tick.PNG to Accept or Cross.PNG to Cancel


NotePad.PNG Notes:

DotPoint.JPG If you have edited any session Data or Layers but have selected the option Do not save session then later, before you exit the program, you will be prompted to save the edited session by the appearance of the Save Session dialogue box (see below).
DotPoint.JPG If you decide to create a new session and leave its name as Default then a new Default Session will be created to add to any others also named Default that may already be present in a route and this will cause confusion. This is why it is not a good idea to use Default as a session name.


DotPoint.JPG If you have loaded a route and a session and have edited the session (Data or Layers) only and not the route, or have already saved the route but not the session, then selecting Save will produce the following Save Session Dialogue Window.
Save Session

Gears.PNG Settings:

DotPoint1.JPG Overwrite the session only. This is the default selection so there is nothing to change.

White Select Dot.png Overwrite existing session
  • the session will be saved (overwritten using its current name).
  • the original route will not be changed.

DotPoint2.JPG Create a new session. Tick the box White Select Dot.png Create new session.

White Select Dot.png Create new session:
  • you can enter a new name for the session or use the suggested name which will include the date, time and session runtime.
  • a new session will be created using the name you enter and it will be added to the existing route.
  • the original route and session will not be changed.
After you have made your selections, click Tick.PNG to Accept or Cross.PNG to Cancel


Saving a Route and Session Using the UDS

The UDS (Unified Driver Surveyor) Interface allows you to quickly switch from Driver to Surveyor and back to Driver again without having to restart the session from the beginning. You can edit a route and session while in Surveyor and then switch back to Driver to continue the session where you left it.

Stop.PNG WARNING:

This powerful ability does come with a warning. If you save the edited session before switching back into Driver then all the moving consists will be saved in their new positions. Other changes, such as the status of Session Rules, will also be saved in their new states. See the Trainz Wiki Page WikiLink.PNG How to Use the UDS Interface for more details.


Most of the problems users seem to be experiencing with the UDS, judging from the posts in the Trainz Forums, is when saving their edited session before switching back into Driver mode.

DotPoint.JPG Using Driver Mode involves driving consists (either manually or through the AI) and activating rules. These will change the Session Data
DotPoint.JPG Overwriting the Session will save changes to the consist locations and the Session Rules


NotePad.PNG Note:

An important change that has been introduced by the UDS is that train vehicle placement is now saved as part of the session, even if those vehicles have been placed in Route Layers.

PencilTips.PNG For this reason, it is strongly recommended that all consists be placed into a Session Layer and become part of a session instead of the route


When you are in Driver Mode at least one of the consists will probably be moving. Some of the Session Rules may have already been completed while others may still be running or waiting for events (e.g. triggers to be activated). If, after switching to Surveyor Mode, you then choose to save using the Overwrite existing session option then you will be replacing your original starting session with a new one with the consists saved in their new positions and the Session Rules saved in their new states. So when you later load and restart the session things will not be the same as they were in the original or starting session.

 Unless you have a particular reason for overwriting the original Session  then the recommended save options are:-

Line740.png
Option DotPoint1.JPG Do not save session
  UDS-DoNotSaveSession.png

This will only save the route using its existing name. This will save any edits that you have made to the route but not to the session.

Line740.png
Option DotPoint2.JPG Create new session
  UDS-CreateNewSession.png

This will save the route using its existing name. It will also save the session using a new name you enter in the text box below the option (Stage 3 in the example shown). The original session will not be altered. This is useful when you want to test out changes to consists, industry settings, Rules, driver commands, etc but do not want to destroy the original session.

Line740.png

If you have have NOT edited anything while in Surveyor and select  Save  then you will be shown the Save Driver Session dialogue window to save the session in its current state as a Driver Game (also called a Game or Driver Game). This is exactly the same as pressing  Ctrl   S  while in Driver.
alte=Save Driver Session
The Driver Game will appear in the Select Session menu for the route. Loading it will resume Driver at the point where it was saved.

  Top Next Up Next Down Bottom

Exiting Surveyor

If you exit Surveyor after editing without saving then you will be prompted to Save.

Unsaved  Route  Unsaved  Session 
Exit Route Save Exit Session Save
DotPoint.JPG Selecting  Don't Save  will exit Surveyor without saving. Any changes you have made will be lost.
DotPoint.JPG Selecting  Save  will exit Surveyor after saving. You will be prompted to select what to save as described in the section PageLink.PNG Saving a Route and a Session above
DotPoint.JPG Selecting  Cancel  will cancel the save command and return you to Surveyor.


  Top Next Up Next Down Bottom

Cloning a Route/Session

DotPoint.JPG A Clone is an exact or duplicate copy of an asset
DotPoint.JPG Most routes and sessions can be cloned. Some Payware routes and sessions cannot be cloned
DotPoint.JPG Cloned routes and sessions can be edited and saved as Your Content


Cloning a Route or a Session allows you to work on a duplicate copy of the original. All changes that you make will be saved in the cloned copy leaving the original copy unchanged.

Stop.PNG Cloned assets are subject to copyright laws and they remain the property of the original creator


DotPoint.JPG Freeware routes, that have been downloaded and installed from the DLS, can be cloned and saved as new routes.
  • They are saved with a new <kuid> that will include your personal identity code, so they will become Your Content and can be found using the  MY CONTENT  search option
  • The original route from the DLS will not be altered or replaced by your new version. You can delete the original DLS route if you wish and your cloned version will be unaffected
DotPoint.JPG Payware Routes, that have been downloaded and installed from the DLC, can also be cloned as new routes if the creators of the routes allow it.
  • Some Payware routes are encrypted and cannot be cloned.
  • When an approved DLC route is saved it will be given a new <kuid> that will include your personal identity code, so it will become Your Content and can be found using the  MY CONTENT  search option
  • The original Payware route will not be altered or replaced by your new version
  • If you delete or disable the original DLC route then your cloned route  will NOT work 
  • You are allowed to upload your edited clone of a Payware route to the DLS but it can only be used by other users who also have the same original (unedited) DLC Payware installed.
DotPoint.JPG Sessions that have been downloaded and installed from the DLS (freeware) or DLC (payware) follow the same rules as described for DLS and DLC routes above.
  • Some Payware sessions are encrypted and cannot be cloned.
  • When an approved DLC session is saved it will be given a new <kuid> that will include your personal identity code, so it will become Your Content and can be found using the  MY CONTENT  search option
  • The original Payware session will not be altered or replaced by your new version
  • If you delete or disable the original DLC session or the original DLC route then your cloned session  will NOT work 
  • You are allowed to upload your edited clone of a Payware session to the DLS but it can only be used by other users who also have the same original (unedited) DLC Payware installed.


Using Surveyor

Routes and Sessions that have been loaded into Surveyor can be cloned using the  Save As...  command from the Surveyor  System Menu 

RouteSaveAsMenu.png CloneSaveAs.png

Enter a new name or edit the original name (as shown above) for your cloned route or session.

NotePad.PNG Notes:

DotPoint.JPG If the first option (White Select Dot.png Save new route and session) is selected then the Route will be cloned using your new or edited name. The Session will be also cloned using its original name but it will use the newly cloned Route as a dependency instead of the original Route.
  • If the original route is Freeware (e.g. from the DLS) and you do not want to keep it then it can be safely deleted, which will also delete the original session but the new cloned route and session will remain active on your system.
  • If the original route is Payware (e.g. from the DLC) then deleting or disabling it will disable your cloned route and session. When Payware is cloned it must remain active on your system for the clone to work.
DotPoint.JPG If the second option (White Select Dot.png Save new session) is selected then only the Session will be cloned using your new or edited name (make sure that you change the "Default" to something else) but it will still use the original (uncloned) Route as a dependency - so it is vital that you DO NOT DELETE the original route.
  • If the original session is Freeware then it can be safely deleted if you no longer need it.
  • If the original session is Payware then deleting or disabling it will also disable your cloned session.

Using Content Manager

 1. Select the Route or Session to Clone 

Cloning a route

Steps.PNG Steps:
  1. In Content Manager select the filter Routes & Sessions
  2. select the route or session to be cloned
  3. either
    • from the Content Menu select Clone OR
    • press  Ctrl   D 


A Task Window will open to display the result.
Clone task completed

In the image above the original Route has been cloned and given a new <kuid> value.

The newly cloned Route will be shown in Content Manager as a New Asset that is Open for Editing.


Steps.PNG Steps:
  1. close the Task Window
  2. select the Open for Editing filter.

New Asset

 2. Rename the Clone (an Optional Step) 
You can give the cloned Route or Session a new name and a new description. Note that these changes will not appear until after the New Asset has been submitted.


Steps.PNG Steps:
  1. right mouse click the New Asset.
  2. select Open...
  3. select Edit Config File Text.

The config.txt file will open in your default text editor. You can then edit both the Title (username) and the Description of the Route or Session.

  1. locate the line that starts with username.
  2. edit the text on that line between the Quote (") marks (but do not delete the quote marks) to change it to the new name of this Route/Session.
  3. locate the line that starts with description.
  4. edit the text on that line between the Quote (") marks (but do not delete the quote marks) to edit the description of this Route/Session.
  5. save (usually  Ctrl   S )
  6. exit the text editor.


 3. Submit the Clone (a Necessary Step) 

DotPoint.JPG When submitted a cloned DLC Route or Session will be described as Payware, Modified

Steps.PNG Steps:
  1. right mouse click the New Asset.
  2. select Submit Edits

The New Asset entry will vanish from the Open for Editing display. Open the Content Manager filter Today to check that it has been correctly submitted. If you have renamed the clone than it should appear using its new name.



NotePad.PNG Notes:

You can rename a cloned Route or a cloned Session in Surveyor but the clone would still have to be submitted in Content Manager first using its original name and then loaded into Surveyor. You would then have two Routes or Sessions with the same name to select from - one would be the original and the other the clone, and telling them apart may not be simple. You can use the Driver/Surveyor main screen  MY CONTENT  source filter to locate and load the correct cloned Route or Session because the clone will have your <kuid> code and not its original code.

Route edit

Load the cloned Route or Session into Surveyor, then

  • to rename a route open the Edit menu and select Edit Route, or press  Ctrl   E  - see PageLink.PNG Editing a Route above
  • to rename a session open the Edit menu and select Edit Session, or press  Ctrl   R  - see PageLink.PNG Editing a Session above

Both will also allow you to edit the Name and Description of the cloned Route/Session.


  Top Next Up Next Down Bottom

Saving and Loading Driver Games in Driver

Saving Driver Games

DotPoint.JPG Driver Games (sometimes called "Saved Games" or "Driver Sessions") are "Game States" saved while in Driver Mode

Driver Games save the "state of play" in Driver - the position of consists, the commodities and levels in rolling stock and industries, the state of the Driver Command queues, Session Rules, clock time, etc. Once saved, the Driver Game can be loaded back into Driver to continue the play at the point where it was saved.

When you are in Driver select  Save  from the System Menu or press  Ctrl   S .

This will display the Save Driver Session dialogue window showing the name of the current session with a date and time stamp (shown left below). If you click the Tick then this will be the name used for the saved game. Alternatively, you could enter your own unique name (shown right below).

The space below the entered name will display any other saved driver games for that session.

Save Menu
Save Driver Game Save Driver Game

Loading Driver Games

Saved driver games will be shown with their sessions for a selected route. The section PageLink.PNG Loading an Existing Session shows two different methods of displaying saved sessions and their driver games.
Method DotPoint1.JPG will display ALL the saved sessions and driver games which may be a very long list.
Method DotPoint2.JPG will display ALL the saved sessions and driver games for a selected route, which should be a much shorter list.

Using Method 2: select the route first and then click the  VIEW SESSIONS  button. This will display a list of thumbnails for all the sessions and driver games in that route.

Load Driver Game

NotePad.PNG Notes:

DotPoint.JPG Where a route has multiple sessions and driver games they will all be shown by their thumbnails with no way of telling which driver games belong to which session.
DotPoint.JPG It can also be difficult to tell which thumbnail is a session and which is a Driver Game, especially if you have removed the date/time stamp Trainz automatically adds to the name of a Driver Game. A simple way to tell is to click on a thumbnail to see if the  EDIT SESSION  button is still visible. If it is not, because driver games cannot be edited, then the thumbnail is for a Driver Game.

Where there is only one session in a route, the session will be the first thumbnail shown in the list followed by the driver games. Note that the session is selected by default.

Select (hightlight) the Driver Game you want to load and click the  DRIVE SESSION  button.

Driver Game

This will load the Driver Game, the session and the route into Driver.

Stop.PNG If you load a Driver Game after you have edited the original route or session that was used to create it, then you will receive a message warning you that changes have been made to the original assets. The changes could affect the operation of the Driver Game.
 
Warning assets have changed You will have the options of:-

 Cancel  - the Driver Game will NOT be loaded, or
 Ok  - load the Driver Game wirh the changes

If the changes to the route or session have been:-

  • minor and non-operational, such as scenery assets (trees, buildings, etc) then the Driver Game can be safely loaded.
  • more significant operational changes, such as triggers, trackmarks, active industries, consists, tracks, etc, then it may not be wise to load and run the Driver Game.


Only you can be the judge.


  Top Next Up   Bottom

Deleting Routes and Sessions

DotPoint.JPG Deleting a Session will delete that Session and its Driver Games (if any), not the Route it was created from or any other Sessions
DotPoint.JPG Deleting a Driver Game will only delete that Driver Game, not the Route or Session it was created from or any other Driver Games


All the Surveyor and Driver screens for loading routes and sessions have a  DELETE ...  button as an option.

  WARNING:
Stop.PNG If you delete a Route you will also delete all the Sessions and Driver Games created using that Route
Stop.PNG If you delete a Session you will also delete all the Driver Games created using that Session


If you need a more selective way of deleting routes, sessions and driver games, then use Content Manager from the Trainz Launch Screen. Select the Filter Routes & Sessions.

CM list of routes and sessions

The Type column will identify each entry as a route, session or Misc. Misc in this case means a saved Driver Game.

You can delete routes and/or sessions individually but if you delete a route by itself then its dependant sessions and driver games will be shown as faulty with Missing dependencies. Likewise, if you delete a session by itself then its dependant driver games will be shown as faulty with Missing dependencies.

  Top Next Up    


Trainz Wiki

TrainzWiki.png

Route and Session Building Guides

 

More Tutorials and Guides to Using Trainz


This page was created by Trainz user pware in September 2021 and was last updated as shown below.


Personal tools