Revision as of 16:57, 14 March 2022 (view source) Pware (Talk | contribs) m ← Older edit		Revision as of 22:04, 14 March 2022 (view source) Pware (Talk | contribs) m Newer edit →
Line 1:		Line 1:
−	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.	+	The information in this Wiki Page applies to '''TANE''', '''TRS19''', '''Trainz Plus''' and '''TRS22'''.
	__TOC__		__TOC__
	<table> <!-- BEGIN Nav Buttons Table -->		<table> <!-- BEGIN Nav Buttons Table -->
	<tr valign="top">		<tr valign="top">
−	<td width=729><span id="stepHierarchy"></span>&nbsp;</td>	+	<td width=729><span id="stepWhat"></span>&nbsp;</td>
−	<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>	+	<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
	<td width=75>&nbsp;</td>		<td width=75>&nbsp;</td>
−	<td width=75>[[image:NextDown.png|link=#stepWhatRoute|alt=Next Down|Next Down]]</td>	+	<td width=75>[[file:NextDown.png|link=#stepOrdered|alt=Next Down|Next Down]]</td>
−	<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>	+	<td width=75>[[file:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
−	</tr>	+
−	</table> <!-- END Nav Buttons Table -->	+
−	='''Trainz Worlds'''=	+
−	The virtual worlds that Trainz creates can be classified as:-<br>	+
−	<table>	+
−	<tr valign="top">	+
−	<td>[[image:RouteSessionGamesMap.png|link=|alt= Route-Sessions-Games|480px]]</td>	+
−	<td>	+
−	<table cellpadding=4>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint.JPG|link=]]</td>	+
−	<td><span style="font-weight: 700; font-size: 17px;">Routes</span></td>	+
−	</tr>	+
−	</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>	+
−	<table cellpadding=4>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint.JPG|link=]]</td>	+
−	<td><span style="font-weight: 700; font-size: 17px;">Sessions</span></td>	+
−	</tr>	+
−	</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. You can create different '''Sessions''' for different aspects of your railway - freight, passenger, shunting or a mixture. '''Sessions''' also control some of the environment settings in your virtual world, such as lighting, the weather and time of day. A '''Session''' can have many:-<br><br>	+
−	<table cellpadding=4>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint.JPG|link=]]</td>	+
−	<td><span style="font-weight: 700; font-size: 17px;">Driver Games (or Driver Sessions or Saved Games)</span></td>	+
−	</tr>	+
−	</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>	+
−	</tr>	+
−	</table>	+
−	<table> <!-- BEGIN Nav Buttons Table -->	+
−	<tr valign="top">	+
−	<td width=729><span id="stepWhatRoute"></span>&nbsp;</td>	+
−	<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>	+
−	<td width=75>[[image:NextUp.png|link=#stepHierarchy|alt=Next Up|Next Up]]</td>	+
−	<td width=75>[[image:NextDown.png|link=#stepLoadRoute|alt=Next Down|Next Down]]</td>	+
−	<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>	+
	</tr>		</tr>
	</table> <!-- END Nav Buttons Table -->		</table> <!-- END Nav Buttons Table -->
		+	='''What Are Parent and Child Rules?'''=
−	='''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, TurfFX and Clutter Effects, plus some "environmental" features.<br>
−
−	A '''Route''' consists of two parts:-
−	#'''Route Data''' and
−	#'''Route Layers'''.
−	<br>
	<table cellpadding=4 bgcolor=#c1e7e7>		<table cellpadding=4 bgcolor=#c1e7e7>
−	<tr valign="top">	+	<tr valign="top>
−	<td>[[image:DotPoint.JPG|link=]]</td>	+	<td>[[file:DotPoint.JPG|link=]]</td>
−	<td>'''When you save a Route, all the items in the Route Data and Route Layers will be saved</td>	+	<td>'''Rules that act as ''Parent Rules'' can have one or more sub-rules or ''Child Rules'' under them'''</td>
	</tr>		</tr>
−	</table>	+	<tr valign="top>
−	<br>	+	<td>[[file:DotPoint.JPG|link=]]</td>
−	<span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&nbsp;Route Data:&nbsp;</span>	+	<td>'''Rules''' are edited and managed by the '''Session Editor''' in Surveyor</td>
−	<br>	+
−	<table cellpadding=4 bgcolor=#c1e7e7>	+
−	<tr valign="top">	+
−	<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>	+
	</tr>		</tr>
	</table>		</table>
−
−	This covers all those visual elements that are "painted" in '''Surveyor''' with a brush tool plus a few '''Environmental''' features.
−
−	[[image:Woolshed_Route_Data.png|link=|alt=Route Data]]
−
−	'''Route Data''' consists of:-
−	*Landforms or 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'''
−	*Some '''Environmental Data''' such as '''Latitude''', '''Longitude''', '''Altitude''' (metres), '''Water Color''', '''Water Surface''' (rough, smooth), '''Snow Altitude''' (metres). Also, depending on what assets you have edited before you save, the '''Date''' (which decides the season of the year) can also be saved as 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>		<br>
−	<span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&nbsp;Route Layers:&nbsp;</span>
−	<table cellpadding=4 bgcolor=#c1e7e7>
−	<tr valign="top">
−	<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>
−	</tr>
−	</table>
−	<br>
−
−	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]]
−
−	'''Route Layers''' have those scenery items that you want to always appear.<br>
−
−	'''Route Layers''' can contain:-
−	*Track and Track Objects (such as signals, switches, bridges, tunnels, speed signs, etc)
−	*Most (or all) scenery items and scenery splines (such as buildings, trees, roads, fences, active industries/stations, etc)
−	*Rolling Stock (including locos) - <span style="background-color: yellow; font-weight: 700;">&nbsp;Note:&nbsp;</span> It is '''strongly recommended''' that all rolling stock be placed into a '''Session Layer'''
−	*Lineside and Fixed Cameras
−	*Trackmarks, Triggers, Direction and Priority Marks
−
	<table cellpadding=4 bgcolor="Aquamarine">		<table cellpadding=4 bgcolor="Aquamarine">
	<tr valign="top">		<tr valign="top">
−	<td>[[image:LinkWiki.PNG|link=]]</td>	+	<td>[[file:LinkWiki.PNG|link=]]</td>
	<td>		<td>
−	A detailed description of '''Layers''' can be found on the '''Trainz Wiki Page [[How_to_Use_Layers|How to Use Layers]]'''<br>	+	More information on the '''Session Editor''' can be found on the '''Trainz Wiki Page''' at:-<br>
		+	*'''[[How to Use Session Editor|Using the Session Editor]]'''
	</td>		</td>
	</tr>		</tr>
	</table>		</table>
−	<table> <!-- BEGIN Nav Buttons Table -->	+	<br>
−	<tr valign="top">	+	Most '''Parent Rules''' are used as "decision makers" in '''Trainz Sessions'''. They decide if or when other rules, the '''Child Rules''', will be executed. Some '''Parent Rules''' control how those '''Child Rules''' are executed.<br>
−	<td width=729><span id="stepLoadRoute"></span>&nbsp;</td>	+
−	<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>	+
−	<td width=75>[[image:NextUp.png|link=#stepWhatRoute|alt=Next Up|Next Up]]</td>	+
−	<td width=75>[[image:NextDown.png|link=#stepWhatSession|alt=Next Down|Next Down]]</td>	+
−	<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>	+
−	</tr>	+
−	</table> <!-- END Nav Buttons Table -->	+
−		+
−	='''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>	+
−		+
−	[[image:TRS19MainScreen.png|link=|alt=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.	+
−		+
−	[[image:TRS19SelectRoute.png|link=|alt=TRS19 Main Screen Route Selection]]	+
−		+
−	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 [[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>	+
	<table>		<table>
	<tr valign="top">		<tr valign="top">
−	<td bgcolor=#ffae00 width=50>&nbsp;</td>	+	<td width=325>[[file:Parent_Child.PNG|link=]]</td>
−	<td>'''Payware'''</td>	+	<td>Session rules can be arranged in a hierarchical fashion, in a series of levels as shown in the example on the left. A '''Parent Rule''' can be used to group together a set of rules at a lower level in the hierarchy. The rules that are grouped together under a '''Parent Rule''' are the '''Child Rules'''.<br><br>
−	<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>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td bgcolor=#dbdbdb width=50>&nbsp;</td>	+
−	<td>'''Installed'''</td>	+
−	<td>Downloaded from the Download Station ('''DLS''') or created by you. This includes any cloned '''DLC''' Routes and Sessions (see [[image:PageLink.PNG|link=]] '''[[#Cloning a Route/Session|Cloning a Route/Session]]''' below)</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td bgcolor=#848dff width=50>&nbsp;</td>	+
−	<td>'''Not Installed'''</td>	+
−	<td>Needs to be downloaded and installed</td>	+
−	</tr>	+
−	</table>	+
−	<br>	+
−	=='''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.	+
−	[[image:RouteButtonsCreate.png|link=|alt=Create a New Route]]	+	'''Child Rules''' can also be '''Parent Rules''' that group together other rules at an even lower level. This creates multiple levels in the hierarchy.<br><br>
−	Click <span style="background-color: black; color: white; font-weight: 700; font-size: 15px;">&nbsp;CREATE ROUTE&nbsp;</span>. This will start Trainz '''Surveyor''' and open the '''New Route Dialogue Window'''.	+	The '''Parent Rule''' at the head of each level in the hierarchy acts as a ''switch'' that directs the Trainz session to either ignore (skip over) or obey (execute) the '''Child Rules''' under its control.<br>
−	<table width=1000>	+	<table bgcolor=#000000 cellpadding=2>
	<tr valign="top">		<tr valign="top">
−	<td width=400>[[image:RouteNewWindow.png|link=|alt=New Route dialogue window]]</td>
	<td>		<td>
−	<table width=600 bgcolor=#000000>	+	<table bgcolor=#ffffb0 cellpadding=2>
	<tr valign="top">		<tr valign="top">
−	<td>	+	<td>[[file:NotePad.PNG|link=]]</td>
−	<table cellpadding=4 bgcolor=#ffffb0 width=596>	+	<td><span style="font-size: 17px;">'''Notes:'''</span><br>
−	<tr valign="top">	+	----
−	<td>[[image:PencilTips.PNG|link=]]</td>	+	*Only certain rules can be Parent Rules. See the Trainz Wiki page [[file:WikiLink.PNG|link=]] '''[[Parent Rule List|List of Parent Rules]]''' for details.
−	<td>All these settings plus others can be easily changed at any time after the '''Route''' has been created.	+	*Most Parent Rules will ''either'' wait for a specific event or perform a test or a comparison. They will execute the child rules when the event occurs or the test/comparison is ''true''.
−	<table>	+	*Any rule can be a Child Rule.
−	<tr>	+
−	<td>[[image:RouteEdit.png|link=|alt=Route edit]]</td>	+
−	<td>From the '''Edit''' menu 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><br><br>	+
−	For more details see '''[[file:PageLink.PNG|link=]]&nbsp;[[#Editing a Route|Editing a Route]]''' below.</td>	+
−	</tr>	+
−	</table>	+
	</td>		</td>
	</tr>		</tr>
Line 192:		Line 66:
	</table>		</table>
−	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.	+	<br>
−	<table>	+	<table cellpadding=4 bgcolor=#c1e7e7>
−	<tr valign="top">	+	<tr valign="top>
−	<td width=150><span style="color: white; background-color: black; font-weight: 700;">&nbsp;Route name:&nbsp;</span></td>	+	<td>[[file:DotPoint.JPG|link=]]</td>
−	<td>Enter a name for your new Route (keep it simple)<br></td>	+	<td>'''Rules that act as ''Child Rules'' are indented under a ''Parent Rule''.'''</td>
−	</tr>	+
−	<tr valign="top">	+
−	<td><span style="color: white; background-color: black; font-weight: 700;">&nbsp;Session name:&nbsp;</span></td>	+
−	<td>Enter a name for your Session (again keep it simple) - see '''Notes:''' below<br></td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td><span style="color: white; background-color: black; font-weight: 700;">&nbsp;Geographical region:&nbsp;</span></td>	+
−	<td>Select a region from the drop down list	+
	</tr>		</tr>
	</table>		</table>
−		+	<br>
−	<table width=1000>	+	<table>
	<tr>		<tr>
−	<td width=400>[[image:RouteSARWindowDots.png|link=|alt=Route Details]]</td>	+	<td valign="top">[[file:SessionRuleIndent.JPG|480px]]</td>
−	<td width=600>	+	<td valign="top">
−	<table width=600 bgcolor=#000000>	+
−	<tr valign="top">	+
−	<td>	+
−	<table cellpadding=4 bgcolor=#ffffb0 width=596>	+
−	<tr valign="top">	+
−	<td>[[image:NotePad.PNG|link=]]</td>	+
−	<td><span style="font-size: 17px; font-weight: 700;">Notes:'''</span>	+
−	----	+
−	</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<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>	+
−	</tr>	+
−	<tr valign="top">	+
−	<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>	+
−	</tr>	+
−	<tr valign="top">	+
−	<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>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint3.JPG|link=]]</td>	+
−	<td>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.</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint4.JPG|link=]]</td>	+
−	<td>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).</td>	+
−	</tr>	+
−	</table>	+
−	</tr>	+
−	</table>	+
−	</td>	+
−	</tr>	+
−	</table>	+
−		+
−	=='''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.	+
−		+
−	[[image:RouteSearchButtons.png|link=|alt=Route Search]]	+
−		+
−	<table>	+
−	<tr valign="top">	+
−	<td>'''Type:'''</td>	+
−	<td><span style="background-color: black; color: white; font-weight: 700;">&nbsp;ROUTES&nbsp;</span> is the default selection. No need to change this.</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<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>	+
−	</tr>	+
−	<tr valign="top">	+
−	<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>	+
−	</tr>	+
−	<tr valign="top">	+
−	<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>	+
−	</tr>	+
−	</table>	+
−	This will produce a display of thumbnails at the bottom of the screen.<br>	+
−		+
−	[[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'''.	+
−		+
−	[[image:RouteButtonsEdit.png|link=|alt=Edit Route]]	+
−		+
−	=='''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>	+
−		+
−	<table>	+
−	<tr valign="top">	+
−	<td>[[image:CMOpenRouteSurveyor.png|link=|Load a route from CM]]</td>	+
−	<td>	+
	<table cellpadding=4 bgcolor=#ffffff>		<table cellpadding=4 bgcolor=#ffffff>
	<tr>		<tr>
Line 293:		Line 84:
	</tr>		</tr>
	<tr valign="top">		<tr valign="top">
−	<td>[[image:Steps.PNG|link=]]</td>	+	<td>[[file:Steps.PNG|link=]]</td>
−	<td><span style="font-size: 17px; font-weight: 700;">Steps:</span><br>	+	<td><span style="font-size: 17px;">'''Steps:'''</span><br>
−	#in '''Content Manager''' select the filter '''Routes & Sessions'''	+	To '''indent''' a rule,
−	#select the '''Route''' to be edited	+	#highlight (select) it
−	#use the '''right-mouse-button''' to open the '''Command Menu'''	+	#click the '''Right Arrow ''Indent''''' tool at the bottom of the Session Editor
−	#select '''Open...''', then	+
−	#select '''Edit Asset in Surveyor'''	+
	</td>		</td>
	</tr>		</tr>
Line 307:		Line 96:
	</tr>		</tr>
	</table>		</table>
−	</td>	+	[[file:SessionRuleIndented.JPG|480px]]</td>
	</tr>		</tr>
	</table>		</table>
−		+	==Parent/Child Rule Example==
−	=='''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>	+
−	<table width=1000>	+
−	<tr valign="top">	+
−	<td>[[image:RouteLoadAfterCTD.png|link=|alt=Load after CTD]]</td>	+
−	<td>	+
−	<table bgcolor=#000000 width=520>	+
−	<tr valign="top">	+
−	<td>	+
−	<table cellpadding=4 bgcolor=#ffffb0 width=516>	+
−	<tr valign="top">	+
−	<td>[[image:NotePad.PNG|link=]]</td>	+
−	<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>	+
−		+
−	It is possible that the changes you have made may affect the operation of the '''Driver Session'''.</td>	+
−	</tr>	+
−	</table>	+
−	</td>	+
−	</tr>	+
−	</table>	+
−	</td>	+
−	</tr>	+
−	</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 options you will see are:-<br>	+
	<table>		<table>
−	<tr valign="top">	+	<tr>
−	<td><span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Use changes&nbsp;</span>	+	<td>[[file:Message_Popup.jpg|link=]]</td>
−	<td>&nbsp;</td>	+
−	<td>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</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td><span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Revert changes&nbsp;</span>	+
−	<td>&nbsp;</td>	+
−	<td>Ignore the edited/changed versions and load the previous versions instead</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td><span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Cancel&nbsp;</span>	+
−	<td>&nbsp;</td>	+
−	<td>Cancel the Load and return to the '''Surveyor/Driver''' menu screen</td>	+
	</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.
−	<br>
−	=='''Editing a Route'''==	+	In the screenshot above, the
−	<table cellpadding=4 bgcolor=#c1e7e7>	+	*'''Trigger Check Rule''' is a Parent Rule. It has rules indented below it.
−	<tr valign="top">	+	**'''Simultaneous List Rule''' is indented under the '''Trigger Check Rule''' so it is a Child of that rule. It is also a Parent Rule as it has rules indented below it
−	<td>[[image:DotPoint.JPG|link=]]</td>	+	***'''Message Popup Rule''' is indented under the '''Simultaneous List Rule''' so it is a Child of that rule.
−	<td>'''When a Route is loaded or a new Route is created all the assets you add will be automatically placed into a Route Layer'''</td>	+	***'''Wait Rule''' is indented under the '''Simultaneous List Rule''' so it is a Child of that rule. It is also a Parent Rule as it has rules indented below it
−	</tr>	+	****'''Close Message Popup Rule''' is indented under the '''Wait Rule''' so it is a Child of that rule.
−	</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>	+
−		+
−	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>	+
−		+
−	<table bgcolor=#ff0000 width=900>	+
−	<tr valign="top">	+
−	<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>	+
−		+
−	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>	+
−		+
−	'''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.	+
−	</td>	+
−	</tr>	+
−	</table>	+
−	</td>	+
−	</tr>	+
−	</table>	+
	<br>		<br>
−	<table width=1000>	+	<span style="font-size: 17px;">'''Sequence of Events'''</span>
−	<tr valign="top">	+
−	<td width=350>	+
−	----	+
−	You can edit the '''Route Characteristics''' at any time by selecting the '''Edit Route''' command from the '''Edit''' menu or simply 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;E&nbsp;</span>.<br>	+
−	This will bring up the '''Edit Route''' dialogue window (shown below).</td>	+
−	<td width=170>[[image:RouteEdit.png|link=|alt=Route edit]]</td>	+
−	<td>	+
−	<table bgcolor=#000000 width=480>	+
−	<tr valign="top">	+
−	<td>	+
−	<table cellpadding=4 bgcolor=#ffffb0 width=476>	+
−	<tr valign="top">	+
−	<td>[[image:NotePad.PNG|link=]]</td>	+
−	<td><span style="font-size: 17px; font-weight: 700;">Route Characteristics:-'''</span><br>	+
−	----	+
−	*'''Name''' and '''Description'''	+
−	*assigned '''Geographic Region''', which sets a number of different features	+
−	*'''Thumbnail''' image	+
−	*'''Working Scale''' and '''Working Units'''	+
−	*'''Draw Distance'''	+
−	</td>	+
−	</tr>	+
−	</table>	+
−	</td>	+
−	</tr>	+
−	</table>	+
−	</td>	+
−	</tr>	+
−	</table>	+
−	<table width=1000>	+
−	<tr valign="top">	+
−	<td width=650>[[image:RouteEditDialogue.png|link=|alt=Edit Route dialogue window]]</td>	+
−	<td>	+
−	<table>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint1.JPG|link=]]</td>	+
−	<td>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 '''&lt;kuid&gt;''' value</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint2.JPG|link=]]</td>	+
−	<td>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</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint3.JPG|link=]]</td>	+
−	<td>You can edit the Route '''Description'''</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint4.JPG|link=]]</td>	+
−	<td>You can change the Route '''Thumbnail'''. Clicking the <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Set Thumbnail&nbsp;</span>	+
−	button will take a snapshot using the current camera view which will be used as the new thumbnail</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint5.JPG|link=]]</td>	+
−	<td>You can change the Route '''Working Scale''' which will only affect the measurement shown in the Surveyor Ruler tool</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint6.JPG|link=]]</td>	+
−	<td>You can change the Route '''Working Units''' to <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Metric&nbsp;</span> or <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Imperial&nbsp;</span> 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)</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint7.JPG|link=]]</td>	+
−	<td>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)</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint8.JPG|link=]]</td>	+
−	<td>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</td>	+
−	</tr>	+
−	</table>	+
−	</td>	+
−	</tr>	+
−	</table>	+
−		+
−	<table> <!-- BEGIN Nav Buttons Table -->	+
−	<tr valign="top">	+
−	<td width=729><span id="stepWhatSession"></span>&nbsp;</td>	+
−	<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>	+
−	<td width=75>[[image:NextUp.png|link=#stepLoadRoute|alt=Next Up|Next Up]]</td>	+
−	<td width=75>[[image:NextDown.png|link=#stepLoadSession|alt=Next Down|Next Down]]</td>	+
−	<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>	+
−	</tr>	+
−	</table> <!-- END Nav Buttons Table -->	+
−		+
−	='''What is a Session?'''=	+
−		+
−	<table cellpadding=4 bgcolor=#c1e7e7>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint.JPG|link=]]</td>	+
−	<td>'''A Session is always a part of an existing Route - you cannot have a Session that does not belong to a Route'''</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint.JPG|link=]]</td>	+
−	<td>'''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'''</td>	+
−	</tr>	+
−	</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>	+
−		+
−	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:-	+
−	#'''Session Data''' and	+
−	#'''Session Layers'''.	+
	<br>		<br>
−	<table cellpadding=4 bgcolor=#c1e7e7>	+	*When the consist identified in the '''Trigger Check Rule''', a Parent Rule, reaches the set trigger, the Trigger Event is activated and its Child Rules are executed.
−	<tr valign="top">	+	**The '''Simultaneous List Rule''', a Parent Rule, is then executed. It executes all its Child Rules immediately and simultaneously.
−	<td>[[image:DotPoint.JPG|link=]]</td>	+	***The '''Message Popup Rule''' is executed. At the same time ...
−	<td>'''When you save a Session, all the items in the Session Data and Session Layers will be saved</td>	+	***The '''Wait Rule''' is executed. This is set to force a 20 second wait, after which its Child Rule ...
−	</tr>	+	****The '''Close Message Popup Rule''' is executed. This closes the Message window created by the '''Message Popup Rule'''.
−	</table>	+	*****Since the '''Close Message Popup Rule''' is the last child rule under the '''Wait Rule''', when it has completed its task (closing the message popup) it will terminate that Parent Rule.
−	<br>	+	*****Since it is also the last child rule under the '''Simultaneous List Rule''' it will terminate that Parent Rule.
−		+	*****Finally, since it is the last child rule under the '''Trigger Check Rule''', it also terminates that Parent Rule.
−	<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'''.	+
−		+
−	[[image:Woolshed_Session_Data.png|link=|alt=Session Data]]	+
−		+
−	'''Session Data''' contains:-	+
−	*Drivers (names, AI commands and assigned locos)	+
−	*Driver Commands - those available for AI and manual driving	+
−	*Session Rules	+
−	*Environment Settings (weather, lighting, time of day). Also, depending on what assets you have edited before you save, the '''Date''' (which decides the season of the year) can also be saved as part of the '''Session Data''' - see '''[[image:WikiLink.PNG|link=]]&nbsp;[[How_to_Use_Environment_Tools|How to Use Environment Tools]]''' for more details	+
−	*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 or right) - but the '''default''' switch direction is stored in the '''Route'''	+
−	<br>	+
−	<span style="font-weight: 700; font-size: 17px; color: white; background-color: black;">&nbsp;Session Layers:&nbsp;</span>	+
−		+
−	<table cellpadding=4 bgcolor=#c1e7e7>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint.JPG|link=]]</td>	+
−	<td>'''Session Layers''' are used to hold the scenery assets that you want to only appear in that particular Session and not in all Sessions</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint.JPG|link=]]</td>	+
−	<td>'''Session Layers can be left empty''' and the '''Route Layers''' can contain all the scenery assets</td>	+
−	</tr>	+
−	</table>	+
−		+
−	[[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>	+
−		+
−	<table width=800>	+
−	<tr valign="top">	+
−	<td width=400>	+
−	'''Session Layers''' can contain:-	+
−	*Scenery	+
−	*Rolling Stock (including locos) - <span style="background-color: yellow; font-weight: 700;">&nbsp;Note:&nbsp;</span> It is '''strongly recommended''' that all rolling stock be placed into a '''Session Layer'''	+
−	*Trackmarks, Triggers, Direction and Priority Markers	+
−	</td>	+
−	<td width=400>	+
−	<table bgcolor=#000000 width=400>	+
−	<tr valign="top">	+
−	<td>	+
−		+
−	<table bgcolor=#ffffb0 width=396>	+
−	<tr valign="top">	+
−	<td>[[image:NotePad.PNG|link=]]</td>	+
−	<td><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br>	+
−	----	+
−	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'''.	+
−	</td>	+
−	</tr>	+
−	</table>	+
−	</td>	+
−	</tr>	+
−	</table>	+
−	</td>	+
−	</tr>	+
−	</table>	+
−	<br>	+
−	<table cellpadding=4 bgcolor="Aquamarine">	+
−	<tr valign="top">	+
−	<td>[[image:LinkWiki.PNG|link=]]</td>	+
−	<td>	+
−	A detailed description of '''Layers''' can be found on the '''Trainz Wiki Page [[How_to_Use_Layers|How to Use Layers]]'''<br>	+
−	</td>	+
−	</tr>	+
−	</table>	+
−	<br>	+
−	<table bgcolor=#000000 width=1000>	+
−	<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:'''</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'''.	+
−		+
−	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'''	+
−	</td>	+
−	</tr>	+
−	</table>	+
−	</td>	+
−	</tr>	+
−	</table>	+
	<br>		<br>
	<table> <!-- BEGIN Nav Buttons Table -->		<table> <!-- BEGIN Nav Buttons Table -->
	<tr valign="top">		<tr valign="top">
−	<td width=729><span id="stepLoadSession"></span>&nbsp;</td>	+	<td width=729><span id="stepOrdered"></span>&nbsp;</td>
−	<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>	+	<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
−	<td width=75>[[image:NextUp.png|link=#stepWhatSession|alt=Next Up|Next Up]]</td>	+	<td width=75>[[file:NextUp.png|link=#stepWhat|alt=Next Up|Top]]</td>
−	<td width=75>[[image:NextDown.png|link=#stepSaving|alt=Next Down|Next Down]]</td>	+	<td width=75>[[file:NextDown.png|link=#stepOthers|alt=Next Down|Next Down]]</td>
−	<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>	+	<td width=75>[[file:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
	</tr>		</tr>
	</table> <!-- END Nav Buttons Table -->		</table> <!-- END Nav Buttons Table -->
−	='''Loading (and Creating) a Session'''=	+	='''Ordered Lists vs Simultaneous Lists'''=
−	=='''Creating a New Session'''==	+	The majority of sibling Child Rules, rules that are at the same indent level under a Parent Rule, will be executed in order (an '''Ordered List''') or simultaneously (a '''Simultaneous List''').
		+
		+	==Ordered Lists==
		+	'''Rule details can be found at [[file:WikiLink.PNG|link=]] [[Session_Rule_List_with_Parameters#Ordered_List_Rule|Ordered List Rule]]'''
	<table cellpadding=4 bgcolor=#c1e7e7>		<table cellpadding=4 bgcolor=#c1e7e7>
	<tr valign="top">		<tr valign="top">
−	<td>[[image:DotPoint.JPG|link=]]</td>	+	<td>[[file:DotPoint.JPG|link=]]</td>
−	<td>'''To create a new Session you must first create a new Route or identify an existing Route'''</td>	+	<td>'''Ordered Lists are shown with numbered icons on each Child Rule which indicates the order in which they will be executed.'''</td>
	</tr>		</tr>
	</table>		</table>
−	A new '''Session''' can be created in two ways:-<br>
−
−	<table width=900>
−	<tr valign="top">
−	<td colspan=2 bgcolor=#000000><span style="font-size: 17px; font-weight:700; color: white;">&nbsp;Method&nbsp;[[image:DotPoint1.JPG|link=]]&nbsp;Automatically When a New Route is Created&nbsp;</span></td>
−	</tr>
−	<tr valign="top">
−	<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:-
−	*a '''Route name''' for the new '''Route'''
−	*a '''Session name''' for the new '''Session'''
−	*a '''Geographical region'''
−	*'''Working scale''' and '''Working units'''</td>
−	</tr>
−	</table>
−
−	<table width=900>
−	<tr valign="top">
−	<td bgcolor=#000000><span style="font-size: 17px; font-weight:700; color: white;">&nbsp;Method&nbsp;[[image:DotPoint2.JPG|link=]]&nbsp;Adding a Session to an Existing Route&nbsp;</span></td>
−	</tr>
−	<tr valign="top">
−	<td>
−	<br>
−	<table bgcolor=#000000 width=900>
−	<tr valign="top">
−	<td>
−	<table bgcolor=#ffffb0 width=896>
−	<tr valign="top">
−	<td>[[image:NotePad.PNG|link=]]</td>
−	<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.
−	</td>
−	</tr>
−	</table>
−	</td>
−	</tr>
−	</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.
−
−	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]]
−
−	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]]
−	</td>
−	</tr>
−	<tr valign="top">
−	<td bgcolor=#000000>&nbsp;</td>
−	</tr>
−	</table>
−
−	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'''.<br>
−	<table width=900>
−	<tr valign="top">
−	<td colspan=2 bgcolor=#000000><span style="font-size: 17px; font-weight:700; color: white;">&nbsp;Method&nbsp;[[image:DotPoint1.JPG|link=]]&nbsp;Search For the Session&nbsp;</span></td>
−	</tr>
−	<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.
−
−	[[image:SessionSearchButtons.png|link=|alt=Session Search]]
	<table>		<table>
−	<tr valign="top">
−	<td>'''Type:'''</td>
−	<td><span style="background-color: black; color: white; font-weight: 700;">&nbsp;ROUTES&nbsp;</span> is the default selection. Change this to <span style="background-color: black; color: white; font-weight: 700;">&nbsp;SESSIONS&nbsp;</span>.</td>
−	</tr>
−	<tr valign="top">
−	<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>
−	</tr>
−	<tr valign="top">
−	<td>'''Gameplay:'''</td>
−	<td><span style="background-color: black; color: white; font-weight: 700;">&nbsp;ALL&nbsp;</span> is the default selection. There is no need to change this</td>
−	</tr>
−	<tr valign="top">
−	<td>'''Search:'''</td>
−	<td>If required you can narrow down the list of '''Sessions''' by typing the first few letters of its name.</td>
−	</tr>
−	</table>
−	</td>
−	</tr>
−	</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>
−
−	[[image:SessionSelectExisting.png|link=|alt=Existing Sessions]]
−
−	The same colour coding system used in the '''Route''' thumbnails also applies to '''Session''' thumbnails.<br>
−
−	<table width=900>
−	<tr valign="top">
−	<td bgcolor=#ffae00 width=50>&nbsp;</td>
−	<td>'''Payware'''</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>
−	</tr>
−	<tr valign="top">
−	<td bgcolor=#dbdbdb width=50>&nbsp;</td>
−	<td>'''Installed'''</td>
−	<td>Downloaded from the Download Station ('''DLS''') or created by you. This includes any cloned '''DLC''' Routes and Sessions (see [[image:PageLink.PNG|link=]] '''[[#Cloning a Route/Session|Cloning a Route/Session]]''' below)</td>
−	</tr>
−	<tr valign="top">
−	<td bgcolor=#848dff width=50>&nbsp;</td>
−	<td>'''Not Installed'''</td>
−	<td>Needs to be downloaded and installed</td>
−	</tr>
−	</table>
−	<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'''.
−
−	[[image:SessionButtonsEdit2.png|link=|alt=Edit Session]]
−
−	<table bgcolor=#000000 width=900>
−	<tr valign="top">
−	<td>
−	<table bgcolor=#ffffb0 width=896>
−	<tr valign="top">
−	<td>[[image:NotePad.PNG|link=]]</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.
−	</td>
−	</tr>
−	</table>
−	</td>
−	</tr>
−	</table>
−	<br>
−	<table width=900>
−	<tr valign="top">
−	<td colspan=2 bgcolor=#000000><span style="font-size: 17px; font-weight:700; color: white;">&nbsp;Method&nbsp;[[image:DotPoint2.JPG|link=]]&nbsp;Select the Route First&nbsp;</span></td>
−	</tr>
−	<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.
−
−	[[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.
−
−	[[image:SessionButtonsEdit2.png|link=|alt=Edit Session]]
−
−	Again, both the selected '''Route''' and its '''Session''' will be loaded into '''Surveyor'''.<br>
−
−	<table bgcolor=#000000 width=900>
−	<tr valign="top">
−	<td>
−	<table bgcolor=#ffffb0 width=896>
−	<tr valign="top">
−	<td>[[image:NotePad.PNG|link=]]</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.
−	</td>
−	</tr>
−	</table>
−	</td>
−	</tr>
−	</table>
−	</td>
−	</tr>
−	<tr valign="top">
−	<td bgcolor=#000000>&nbsp;</td>
−	</tr>
−	</table>
−
−	=='''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>
−
−	<table>
−	<tr valign="top">
−	<td>[[image:CMOpenSessionSurveyor.png|link=|Load a session from CM]]</td>
−	<td>
−	<table cellpadding=4 bgcolor=#ffffff>
	<tr>		<tr>
−	<td colspan="2">	+	<td>[[file:OrderedListRule.JPG|link=]]</td>
−	----</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td>[[image:Steps.PNG|link=]]</td>	+
−	<td><span style="font-size: 17px; font-weight: 700;">Steps:</span><br>	+
−	#in '''Content Manager''' select the filter '''Routes & Sessions'''	+
−	#select the '''Session''' to be loaded and edited in '''Surveyor'''	+
−	#use the '''right-mouse-button''' to open the '''Command Menu'''	+
−	#select '''Open...''', then	+
−	#select '''Edit Asset in Surveyor'''	+
−	</td>	+
−	</tr>	+
−	<tr>	+
−	<td colspan="2">	+
−	----</td>	+
−	</tr>	+
−	</table>	+
−	Both the '''Route''' and the '''Session''' will be loaded into '''Surveyor''' for editing.	+
−	</td>	+
−	</tr>	+
−	</table>	+
−		+
−	=='''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>	+
−		+
−	[[image:DriverButtons.png|link=|alt=Driver Game]]<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.	+
−		+
−	=='''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>	+
−		+
−	<table>	+
−	<tr valign="top">	+
−	<td>[[image:CMOpenSessionDriver.png|link=|Load a session from CM]]</td>	+
	<td>		<td>
−	<table cellpadding=4 bgcolor=#ffffff>	+	<table cellpadding=4 bgcolor=#eeeeee>
	<tr>		<tr>
	<td colspan="2">		<td colspan="2">
Line 839:		Line 157:
	</tr>		</tr>
	<tr valign="top">		<tr valign="top">
−	<td>[[image:Steps.PNG|link=]]</td>	+	<td>[[file:Gears.PNG|link=]]</td>
−	<td><span style="font-size: 17px; font-weight: 700;">Steps:</span><br>	+	<td><span style="font-size: 17px;">'''Settings:'''</span><br>
−	#in '''Content Manager''' select the filter '''Routes & Sessions'''	+	An Ordered List can be set to run:-
−	#select the '''Session''' to drive	+	*a set number of times, OR
−	#use the '''right-mouse-button''' to open the '''Command Menu'''	+	*once only</td>
−	#select '''Open...''', then	+
−	#select '''Open Asset in Driver'''	+
−	</td>	+
	</tr>		</tr>
	<tr>		<tr>
Line 852:		Line 167:
	----</td>		----</td>
	</tr>		</tr>
−	</table>	+	</table></td>
−	The '''Session''' and its parent '''Route''' will be loaded into '''Driver''' and the simulation will be started.	+
−	</td>	+
	</tr>		</tr>
	</table>		</table>
−
−	=='''Editing a Session'''==
−	<table cellpadding=4 bgcolor=#c1e7e7>
−	<tr valign="top">
−	<td>[[image:DotPoint.JPG|link=]]</td>
−	<td>'''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'''</td>
−	</tr>
−	</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>
−
−	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>
−
−	There are also other changes that will be added to the '''Session Data'''.
−
−	<table width=1000>
−	<tr valign="top">
−	<td width=350>
−	----
−	You can edit the '''Session Characteristics''' at any time by selecting the '''Edit Session''' command from the '''Edit Menu''' or by simply 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;R&nbsp;</span>.<br>
−	This will bring up the '''Edit Session''' dialogue window which is more commonly called the '''Session Editor''' (shown below).<br>
−	For more details on editing a Session see the '''Trainz Wiki Page''' at '''[[image:WikiLink.PNG|link=]]&nbsp;[[How_to_Use_Session_Editor|The Session Editor]]'''.</td>
−	<td width=170>[[image:SessionEdit.png|link=|alt=Session edit]]</td>
−	<td>
−	<table bgcolor=#000000 width=480>
−	<tr valign="top">
−	<td>
−	<table cellpadding=4 bgcolor=#ffffb0 width=476>
−	<tr valign="top">
−	<td>[[image:NotePad.PNG|link=]]</td>
−	<td><span style="font-size: 17px; font-weight: 700;">Session Characteristics:-'''</span><br>
−	----
−	*'''Name''' and '''Description'''
−	*'''Session Rules''' which control/set:-
−	**drivers and their consists
−	**driver commands
−	**time of day/night
−	**events
−	**and much, much more
−	</td>
−	</tr>
−	</table>
−	</td>
−	</tr>
−	</table>
−	</td>
−	</tr>
−	</table>
−	<table width=1000>
−	<tr valign="top">
−	<td width=650>[[image:EditSessionDialogue.png|link=|alt=Edit Session dialogue window]]</td>
−	<td>
−	<table>
−	<tr valign="top">
−	<td>[[image:DotPoint1.JPG|link=]]</td>
−	<td>
−	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 '''&lt;kuid&gt;''' value</td>
−	</tr>
−	<tr valign="top">
−	<td>[[image:DotPoint2.JPG|link=]]</td>
−	<td>You can edit the Session '''Description'''</td>
−	</tr>
−	<tr valign="top">
−	<td>[[image:DotPoint3.JPG|link=]]</td>
−	<td>You can add, delete and edit the Session '''Rules'''</td>
−	</tr>
−	</table>
−	</td>
−	</tr>
−	</table>
−
−	<table width=1000>
−	<tr valign="top">
−	<td width=350>
−	----
−	You can edit the '''Environment Controls''' of a Session by selecting the '''Edit Environment''' command from the '''Edit Menu'''.<br>
−	This will bring up the '''Edit Environment''' dialogue window, more commonly called the '''Environment Tools'''.<br>
−	For more details on editing the '''Environment''' see the '''Trainz Wiki Page''' at '''[[image:WikiLink.PNG|link=]]&nbsp;[[How_to_Use_Environment_Tools|The Environment Tools]]'''</td>
−	<td width=170>[[image:EnvironmentEditLaunch.png|link=|alt=Environment edit]]</td>
−	<td>
−	<table bgcolor=#000000 width=480>
−	<tr valign="top">
−	<td>
−	<table cellpadding=4 bgcolor=#ffffb0 width=476>
−	<tr valign="top">
−	<td>[[image:NotePad.PNG|link=]]</td>
−	<td><span style="font-size: 17px; font-weight: 700;">Environment Controls:-</span><br>
−	----
−	*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)
−	</td>
−	</tr>
−	</table>
−	</td>
−	</tr>
−	</table>
−	</td>
−	</tr>
−	</table>
−
−	<table> <!-- BEGIN Nav Buttons Table -->
−	<tr valign="top">
−	<td width=729><span id="stepSaving"></span>&nbsp;</td>
−	<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
−	<td width=75>[[image:NextUp.png|link=#stepLoadSession|alt=Next Up|Next Up]]</td>
−	<td width=75>[[image:NextDown.png|link=#stepExit|alt=Next Down|Next Down]]</td>
−	<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
−	</tr>
−	</table> <!-- END Nav Buttons Table -->
−
−	='''Saving a Route and a Session'''=
−
−	'''Routes''' and '''Sessions''' are saved from the '''System Menu''' on the '''Surveyor''' screen.
−
−	<table>
−	<tr valign="top">
−	<td>[[image:RouteSaveMenu.png|link=|alt=Save]]</td>
−	<td>
−	<table>
−	<tr valign="top">
−	<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) and the '''Save''' command.<br><br></td>
−	</tr>
−	<tr valign="top">
−	<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) and the '''Save As''' command.<br><br></td>
−	</tr>
−	</table>
−	</td>
−	</tr>
−	</table>
−	<br>
−	<table cellpadding=4 bgcolor=#ffffb0 width=1000> <!-- BEGIN Notes Table -->
−	<tr valign="top">
−	<td>[[image:NotePad.PNG|link=]]</td>
−	<td><span style="font-size: 17px; font-weight: 700;">Notes on Saving:'''</span><br>
−	----
−	<table  bgcolor=#ffffb0>
−	<tr valign="top">
−	<td>[[image:DotPoint.JPG|link=]]</td>
−	<td>'''Routes''' that have been downloaded and installed from the '''DLS''' (freeware) or '''DLC''' (payware) can be edited and saved as new '''Routes'''. 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. The original '''Route''' will not be altered or replaced by your new version. You are allowed to copy (edit and save) purchased '''DLC Routes''' for your personal use only but they '''cannot be uploaded''' to the '''DLS'''.</td>
−	</tr>
−	<tr valign="top">
−	<td>[[image:DotPoint.JPG|link=]]</td>
−	<td>'''Sessions''' that have been downloaded and installed from the '''DLS''' (freeware) or '''DLC''' (payware) can be edited and saved as new '''Sessions''' and will also become '''Your Content'''. The originals will not be replaced by your new version. You are allowed to copy (edit and save) purchased '''DLC Sessions''' for your personal use only but they '''cannot be uploaded''' to the '''DLS'''.<br>
−	<span style="background-color: yellow; font-weight: 700; font-size: 15px;">&nbsp;Note:&nbsp;</span> If your copied '''Session''' was created using a '''DLS''' or '''DLC Route''' then it will still need the original '''DLS/DLC Route'''. 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 a copied '''DLS/DLC Route'''. The new '''Session''' will be based on the copied '''Route''' and not the original.</td>
−	</tr>
−	<tr valign="top">
−	<td>&nbsp;</td>
−	<td>
−	<table bgcolor=#ff0000>
−	<tr valign="top">
−	<td>
−	<table bgcolor=#fcbcbc>
−	<tr valign="top">
−	<td>[[image:Stop.PNG|link=]]</td>
−	<td>'''Cloned assets are subject to copyright laws and they remain the property of the original creator. You are allowed to clone DLC Routes and Sessions for your personal use only.</td>
−	</tr>
−	<tr valign="top">
−	<td>[[image:Stop.PNG|link=]]</td>
−	<td>'''Under no circumstances are you to upload cloned assets to the DLS or any 3rd party web site without the permission of the original creator
−	</td>
−	</tr>
−	</table>
−	</td>
−	</tr>
−	</table>
−	</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''' - 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>
−	</table>
−	</td>
−	</tr>
−	</table> <!-- END Notes Table -->
−
−	=='''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'''.
−	<table width=900>
−	<tr valign="top">
−	<td>[[image:RouteSARSaveNew.png|link=|alt=First Save]]</td>
−	<td>[[image:RouteSARSaveAsNew.png|link=|alt=First Save As]]</td>
−	</tr>
−	<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'''.</td>
−	</tr>
−	</table>
−
−	=='''Saving an Existing Route'''==
−	<table>
−	<tr valign="top">
−	<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>
−	</tr>
−	</table>
−	<table>
−	<tr valign="top">
−	<td>[[image:RouteSARSaveExistingNoSession.png|link=|alt=Save Route with no Session]]<td>
−	<td>
−	*The '''Overwrite existing route and Do not save session''' options are automatically selected. The '''Route''' will be saved ('''Overwritten''' using its current name) but no '''Session''' will be saved.
−	*You can select the '''Save new route and session''' option and 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 '''Session''' will be saved with the '''Default''' values for all settings.
−	*You can select the '''Overwrite existing route and Create new session''' options and 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 '''Route'''. Because you did not originally load a '''Session''', the new '''Session''' will be saved with '''Default''' values for all settings.</td>
−	</tr>
−	</table>
−
−	<table>
−	<tr valign="top">
−	<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>
−	</tr>
−	</table>
−	<table>
−	<tr valign="top">
−	<td>[[image:RouteSARSaveExistingNewSession.png|link=|alt=Save Route with Session]]<td>
−	<td>
−	*The '''Overwrite existing route and Create new session''' options are automatically selected. Enter a new name for the '''Session''' - it is '''not recommended''' that you leave it as '''Default'''. The '''Route''' with 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'''.
−	*You can select the '''Overwrite existing route and Do not save session''' options. The '''Route''' with be saved ('''Overwritten''' using its current name) but no '''Session''' will be saved. Any changes you have made to the '''Session Data''' or '''Session Layers''' will be lost.
−	*You can select the '''Save new route and session''' option and 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''' named '''Default''' will be saved and added to the new '''Route'''.</td>
−	</tr>
−	</table>
−
−	=='''Saving an Existing Route and Session'''==
−	<table>
−	<tr valign="top">
−	<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>
−	</tr>
−	</table>
−	<table>
−	<tr valign="top">
−	<td>[[image:RouteSessionSARSaveExisting.png|link=|alt=Save Route and Session]]<td>
−	<td>
−	*The '''Overwrite existing route and Overwrite existing session''' options are automatically selected. Both the '''Route''' and '''Session''' will be saved ('''Overwritten''' using their current names).
−	*You can select the '''Save new route and session''' option and 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 same name as the original '''Session''' and it will be added to the new '''Route'''.
−	*You can select the '''Overwrite existing route and Do not save session''' options. The '''Route''' with be saved ('''Overwritten''' using its current name) but no '''Session''' will be saved. Any changes you have made to the '''Session Data''' or '''Session Layers''' will be lost.
−	*You can select the '''Overwrite existing route and Create new session''' options. Enter a new name for the '''Session'''. The '''Route''' with 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'''.
−	<br>
−	</td>
−	</tr>
−	</table>
−	<table>
−	<tr valign="top">
−	<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>
−	</tr>
−	</table>
−	<table>
−	<tr valign="top">
−	<td>[[image:SessionSARSaveExistingNoRoute.png|link=|alt=Save Session]]<td>
−	<td>
−	*The '''Overwrite existing session''' option is automatically selected. The '''Session''' will be saved ('''Overwritten''' using its current name). The '''Route''' will not be changed.
−	*You can select the '''Create new session''' option. 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 entered name and it will be added to the existing '''Route'''. The '''Route''' will not be changed.
−	<br>
−	</td>
−	</tr>
−	</table>
−
−	=='''Saving a Route and Session Using the UDS'''==
−	'''TRS19 Platinium Edition''', '''Trainz Plus''' and '''TRS22''' have an additional feature, the '''UDS''' ('''U'''nified '''D'''river '''S'''urveyor) Interface, that allows you to quickly switch from '''Driver''' to '''Surveyor''' and back to '''Driver''' again without having to restart the '''Session''' from the start. 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>
−
−	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>
	<tr valign="top">		<tr valign="top">
	<td>[[file:DotPoint.JPG|link=]]</td>		<td>[[file:DotPoint.JPG|link=]]</td>
−	<td>Using '''Driver Mode''' involves driving consists (either manually or through the AI) and activating rules. '''These will change the Session Data'''</td>	+	<td>'''Each Child Rule in the sequence must be completed before the next Child Rule can be executed.'''</td>
−	</tr>	+
−	<tr valign="top">	+
−	<td>[[file:DotPoint.JPG|link=]]</td>	+
−	<td>'''Overwriting the Session will save changes to the consist locations and the Session Rules'''</td>	+
	</tr>		</tr>
	</table>		</table>
Line 1,160:		Line 184:
	<tr valign="top">		<tr valign="top">
	<td>[[file:NotePad.PNG|link=]]</td>		<td>[[file:NotePad.PNG|link=]]</td>
−	<td><span style="font-size: 17px; font-weight: 700;">Note:'''</span><br>	+	<td><span style="font-size: 17px;">'''Notes:'''</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 '''Ordered List''' is completed when the '''last''' Child Rule is completed.
−	</td>	+	*Because some rules will wait for an event (such as a mouse click, a set time or a time period, a consist trigger, a load trigger, etc) before they are completed, it is possible for the Ordered List to ''hang'' indefinitely waiting for the event to occur so that a rule can be completed and any following rules can then be executed.
−	</tr>	+	*If possible, place Child Rules that are event dependent at the end of an ordered list.
−	<tr valign="top">	+
−	<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>		</td>
	</tr>		</tr>
Line 1,174:		Line 195:
	</tr>		</tr>
	</table>		</table>
−	<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>	+	==Simultaneous Lists==
−	<table width=900>	+	'''Rule details can be found at [[file:WikiLink.PNG|link=]] [[Session_Rule_List_with_Parameters#Simultaneous_List_Rule|Simultaneous List Rule]]'''
−	<tr valign="top">	+
−	<td colspan=2>[[Image:line740.png|link=]]</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td colspan=2><span style="font-weight: 700; font-size: 17px;">Option&nbsp;</span>[[image:DotPoint1.JPG|link=]]&nbsp;<span style="font-weight: 700; font-size: 17px;">Do not save session</span></td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td width=20>&nbsp;</td>	+
−	<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>	+
−	</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td colspan=2>[[Image:line740.png|link=]]</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td colspan=2><span style="font-weight: 700; font-size: 17px;">Option&nbsp;</span>[[image:DotPoint2.JPG|link=]]&nbsp;<span style="font-weight: 700; font-size: 17px;">Create new session</span></td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td width=20>&nbsp;</td>	+
−	<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>	+
−	</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td colspan=2>[[Image:line740.png|link=]]</td>	+
−	</tr>	+
−	</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>	+
−	[[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.	+
−		+
−	<table> <!-- BEGIN Nav Buttons Table -->	+
−	<tr valign="top">	+
−	<td width=729><span id="stepExit"></span>&nbsp;</td>	+
−	<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>	+
−	<td width=75>[[image:NextUp.png|link=#stepSaving|alt=Next Up|Next Up]]</td>	+
−	<td width=75>[[image:NextDown.png|link=#stepCloning|alt=Next Down|Next Down]]</td>	+
−	<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>	+
−	</tr>	+
−	</table> <!-- END Nav Buttons Table -->	+
−		+
−	='''Exiting Surveyor'''=	+
−	If you exit '''Surveyor''' after editing without saving then you will be prompted to '''Save'''.<br>	+
−	<table>	+
−	<tr valign="top">	+
−	<td align="center"><span style="font-weight: 700;">Unsaved <span style="color: white; background-color: black;">&nbsp;Route&nbsp;</span></span></td>	+
−	<td align="center"><span style="font-weight: 700;">Unsaved <span style="color: white; background-color: black;">&nbsp;Session&nbsp;</span></span></td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td>[[image:RouteSessionExitRouteSave.png|link=|alt=Exit Route Save]]</td>	+
−	<td>[[image:RouteSessionExitSessionSave.png|link=|alt=Exit Session Save]]</td>	+
−	</tr>	+
−	</table>	+
−	<table>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint.JPG|link=]]</td>	+
−	<td>Selecting <span style="font-weight: 700; color: white; background-color: black; font-size: 15px;">&nbsp;Don't Save&nbsp;</span> will exit '''Surveyor''' without saving. Any changes you have made will be lost.</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint.JPG|link=]]</td>	+
−	<td>Selecting <span style="font-weight: 700; color: white; background-color: black; font-size: 15px;">&nbsp;Save&nbsp;</span> will exit '''Surveyor''' after saving. You will be prompted to select what to save as described in the section '''[[file:PageLink.PNG|link=]]&nbsp;[[#Saving a Route and a Session|Saving a Route and a Session]]''' above</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint.JPG|link=]]</td>	+
−	<td>Selecting <span style="font-weight: 700; color: white; background-color: black; font-size: 15px;">&nbsp;Cancel&nbsp;</span> will cancel the save command and return you to '''Surveyor'''.</td>	+
−	</tr>	+
−	</table>	+
−	<table> <!-- BEGIN Nav Buttons Table -->	+
−	<tr valign="top">	+
−	<td width=729><span id="stepCloning"></span>&nbsp;</td>	+
−	<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>	+
−	<td width=75>[[image:NextUp.png|link=#stepExit|alt=Next Up|Next Up]]</td>	+
−	<td width=75>[[image:NextDown.png|link=#stepGames|alt=Next Down|Next Down]]</td>	+
−	<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>	+
−	</tr>	+
−	</table> <!-- END Nav Buttons Table -->	+
−		+
−	='''Cloning a Route/Session'''=	+
	<table cellpadding=4 bgcolor=#c1e7e7>		<table cellpadding=4 bgcolor=#c1e7e7>
	<tr valign="top">		<tr valign="top">
−	<td>[[image:DotPoint.JPG|link=]]</td>	+	<td>[[file:DotPoint.JPG|link=]]</td>
−	<td>A '''Clone''' is an exact or duplicate copy of an asset. '''Routes''' and '''Sessions''' can be cloned</td>	+	<td>'''Simultaneous Lists are shown with equality ("=") icons on each Child Rule which indicates that they will be executed at the same time.'''</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 valign="top">	+
−	<td>[[image:DotPoint.JPG|link=]]</td>	+
−	<td>Cloned '''DLC Routes''' and '''Sessions''' <span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;CANNOT&nbsp;</span> be uploaded to the '''DLS'''</td>	+
	</tr>		</tr>
	</table>		</table>
−	<br>
−	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.<br>
−	<table bgcolor=#ff0000 width=900>	+	<table width=1000>
	<tr valign="top">		<tr valign="top">
−	<td>	+	<td width=640>[[file:SimultaneousListRule.JPG|link=]]</td>
−	<table bgcolor=#fcbcbc>	+	<td with=360>
		+	<table cellpadding=2 bgcolor=#eeeeee>
	<tr valign="top">		<tr valign="top">
−	<td>[[image:Stop.PNG|link=]]</td>	+	<td colspan="2">
−	<td>'''Cloned assets are subject to copyright laws and they remain the property of the original creator. You are allowed to clone DLC Routes and Sessions for your personal use only.</td>	+	----</td>
	</tr>		</tr>
	<tr valign="top">		<tr valign="top">
−	<td>[[image:Stop.PNG|link=]]</td>	+	<td>[[file:Gears.PNG|link=]]</td>
−	<td>'''Under no circumstances are you to upload cloned assets to the DLS or any 3rd party web site without the permission of the original creator	+	<td><span style="font-size: 17px;">'''Settings:'''</span><br>
−	</td>	+	A Simultaneous List can be set to complete when:-
		+	*all the Child Rules are completed, OR
		+	*any one of the Child Rules has been completed</td>
	</tr>		</tr>
−	</table>
−	</td>
−	</tr>
−	</table>
−	<br>
−	<table bgcolor=#000000 width=900> <!-- BEGIN Notes Table -->
	<tr valign="top">		<tr valign="top">
−	<td>	+	<td colspan="2">
−	<table bgcolor=#ffffb0>	+	----</td>
−	<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>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint.JPG|link=]]</td>	+
−	<td>'''Routes''' that have been downloaded and installed from the '''DLS''' (freeware) or '''DLC''' (payware) can be saved (cloned) as new '''Routes'''. When they are cloned 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. The original '''Routes''' will not be altered or replaced by your clones. You are allowed to clone purchased '''DLC Routes''' for your personal use only but they '''cannot be uploaded''' to the '''DLS'''.</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint.JPG|link=]]</td>	+
−	<td>'''Sessions''' that have been downloaded and installed from the '''DLS''' (freeware) or '''DLC''' (payware) can be cloned as new '''Sessions''' and will also become '''Your Content'''. The original '''Sessions''' will not be altered or replaced by your clones. You are allowed to clone purchased '''DLC Sessions''' for your personal use only but they '''cannot be uploaded''' to the '''DLS'''.<br>	+
−	<span style="background-color: yellow; font-weight: 700; font-size: 15px;">&nbsp;Note:&nbsp;</span> If your cloned '''Session''' was created using a '''DLS''' or '''DLC Route''' then it will still need the original '''Route'''. If you delete the original '''Route''' then your cloned '''Session''' will no longer work. This restriction does not apply to any new '''Session''' you create for a cloned '''DLS/DLC Route'''. The new '''Session''' will be based on the cloned '''Route''' and not the original. Both will be classified as '''Your Content'''.	+
−	</td>	+
	</tr>		</tr>
	</table>		</table>
−	</td>	+	<table bgcolor=#000000 width=360>
−	</tr>	+
−	</table>	+
−	</td>	+
−	</tr>	+
−	</table>	+
−		+
−	=='''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>	+
−	<table>	+
−	<tr valign="top">	+
−	<td>[[image:RouteSaveAsMenu.png|link=]]</td>	+
−	<td>[[image:CloneSaveAs.png|link=]]</td>	+
−	</tr>	+
−	</table>	+
−	Enter a new name or edit the original name (as shown above) for your cloned Route or Session.<br>	+
−		+
−	<table bgcolor=#000000 width=900>	+
	<tr valign="top">		<tr valign="top">
	<td>		<td>
−	<table bgcolor=#ffffb0>	+	<table bgcolor=#ffffb0 width=356>
	<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:</span><br>	+	<td><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br>
	----		----
−	<table>	+	While all child rules in a '''Simultaneous List''' will start at the same time, some will take longer to complete than others.
−	<tr valign="top">	+
−	<td>[[image:DotPoint.JPG|link=]]</td>	+
−	<td>If the first option ('''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.	+
−	</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td>[[image:DotPoint.JPG|link=]]</td>	+
−	<td>If the second option ('''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.	+
	</td>		</td>
	</tr>		</tr>
Line 1,356:		Line 244:
	</tr>		</tr>
	</table>		</table>
−
−	=='''Using Content Manager'''==
−	<span style="color: white; background-color: black; font-weight: 700; font-size: 17px;">&nbsp;1. Select the Route or Session to Clone&nbsp;</span>
	<br>		<br>
−	<table>	+	<table> <!-- BEGIN Nav Buttons Table -->
	<tr valign="top">		<tr valign="top">
−	<td>[[image:RouteClone.png|link=|alt=Cloning a route]]</td>	+	<td width=729><span id="stepOthers"></span>&nbsp;</td>
−	<td>	+	<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
−	<table cellpadding=4 bgcolor=#ffffff>	+	<td width=75>[[file:NextUp.png|link=#stepOrdered|alt=Next Up|Top]]</td>
−	<tr>	+	<td width=75>[[file:NextDown.png|link=#stepRelated|alt=Next Down|Next Down]]</td>
−	<td colspan="2">	+	<td width=75>[[file:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
−	----</td>	+
	</tr>		</tr>
−	<tr valign="top">	+	</table> <!-- END Nav Buttons Table -->
−	<td>[[image:Steps.PNG|link=]]</td>	+
−	<td><span style="font-size: 17px; font-weight: 700;">Steps:</span><br>	+
−	#In '''Content Manager''' select the filter '''Routes & Sessions'''	+
−	#select the '''Route''' or '''Session''' to be cloned	+
−	#either	+
−	#*from the '''Content Menu''' select '''Clone''' 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;D&nbsp;</span>	+
−	</td>	+
−	</tr>	+
−	<tr>	+
−	<td colspan="2">	+
−	----</td>	+
−	</tr>	+
−	</table>	+
−	</td>	+
−	</tr>	+
−	</table>	+
−	<br>	+
−	A '''Task Window''' will open to display the result.<br>	+
−	[[image:RouteCloneTask.png|link=|alt=Clone task completed]]<br>	+
−	In the image above the original Route has been cloned and given a new '''<kuid>''' value.<br>	+	='''Other Types of Lists'''=
−	<br>	+
−	The newly cloned Route will be shown in '''Content Manager''' as a '''New Asset''' that is '''Open for Editing'''.<br>	+
−	<table cellpadding=4 bgcolor=#ffffff>	+	==Progressive Lists==
−	<tr>	+	'''Rule details can be found at [[file:WikiLink.PNG|link=]] [[Session_Rule_List_with_Parameters#Progressive_List_Rule|Progressive List Rule]]'''
−	<td colspan="2">	+	<table cellpadding=4 bgcolor=#c1e7e7>
−	----</td>	+
−	</tr>	+
	<tr valign="top">		<tr valign="top">
−	<td>[[image:Steps.PNG|link=]]</td>	+	<td>[[file:DotPoint.JPG|link=]]</td>
−	<td><span style="font-size: 17px; font-weight: 700;">Steps:</span><br>	+	<td>'''On the first run of a Progressive List, only the first Child Rule is executed. On the second run, the second Child Rule is executed, on the third run the third Child Rule is executed, etc.'''</td>
−	#close the '''Task Window'''<br>	+
−	#select the '''Open for Editing''' filter.	+
−	</td>	+
−	</tr>	+
−	<tr>	+
−	<td colspan="2">	+
−	----</td>	+
	</tr>		</tr>
	</table>		</table>
−	[[image:RouteCloneNewAsset.png|link=|alt=New Asset]]	+	<table>
−	<br><br>	+
−	<span style="color: white; background-color: black; font-weight: 700; font-size: 17px;">&nbsp;2. Rename the Clone (an Optional Step)&nbsp;</span>	+
−	<br>	+
−	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.<br>	+
−	<table cellpadding=4 bgcolor=#ffffff>	+
	<tr>		<tr>
−	<td colspan="2">	+	<td>[[file:ProgressiveListRules.JPG|link=]]</td>
−	----</td>	+	<td>
−	</tr>	+	<table cellpadding=4 bgcolor=#eeeeee>
−	<tr valign="top">	+
−	<td>[[image:Steps.PNG|link=]]</td>	+
−	<td><span style="font-size: 17px; font-weight: 700;">Steps:</span><br>	+
−	#right mouse click the '''New Asset'''.	+
−	#select '''Open...'''	+
−	#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.	+
−	#locate the line that starts with '''username'''.	+
−	#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.	+
−	#locate the line that starts with '''description'''.	+
−	#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.	+
−	#save (usually <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>)	+
−	#exit the text editor.	+
−	</td>	+
−	</tr>	+
	<tr>		<tr>
	<td colspan="2">		<td colspan="2">
	----</td>		----</td>
	</tr>		</tr>
−	</table>
−	<br>
−	<span style="color: white; background-color: black; font-weight: 700; font-size: 17px;">&nbsp;3. Submit the Clone (a Necessary Step)&nbsp;</span>
−	<br>
−	<table cellpadding=4 bgcolor=#c1e7e7>
	<tr valign="top">		<tr valign="top">
−	<td>[[image:DotPoint.JPG|link=]]</td>	+	<td>[[file:Gears.PNG|link=]]</td>
−	<td>When submitted a cloned '''DLC''' Route or Session will be described as '''Payware, Modified'''</td>	+	<td><span style="font-size: 17px;">'''Settings:'''</span><br>
		+	A '''Progressive List''' can be set to:-
		+	*repeat the sequence after the last child rule has been executed, OR
		+	*terminate (no further repeats) after the last child rule has been executed</td>
	</tr>		</tr>
−	</table>
−	<table cellpadding=4 bgcolor=#ffffff>
	<tr>		<tr>
	<td colspan="2">		<td colspan="2">
	----</td>		----</td>
	</tr>		</tr>
−	<tr valign="top">	+	</table></td>
−	<td>[[image:Steps.PNG|link=]]</td>	+
−	<td><span style="font-size: 17px; font-weight: 700;">Steps:</span><br>	+
−	#right mouse click the '''New Asset'''.	+
−	#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.	+
−	</td>	+
−	</tr>	+
−	<tr>	+
−	<td colspan="2">	+
−	----</td>	+
	</tr>		</tr>
	</table>		</table>
	<br>		<br>
−	<table bgcolor=#000000 width=900>
−	<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:'''</span><br>
−	----
−	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 <span style="background-color: black; color: white; font-weight: 700;">&nbsp;MY CONTENT&nbsp;</span> '''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.
−	<table>
−	<tr valign="top">
−	<td>[[image:RouteEdit.png|link=|alt=Route edit]]</td>
−	<td>
−	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 '''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'''.
−	</td>
−	</tr>
−	</table>
−	</td>
−	</tr>
−	</table>
−	</td>
−	</tr>
−	</table>
−
−	<table> <!-- BEGIN Nav Buttons Table -->
−	<tr valign="top">
−	<td width=729><span id="stepGames"></span>&nbsp;</td>
−	<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
−	<td width=75>[[image:NextUp.png|link=#stepCloning|alt=Next Up|Next Up]]</td>
−	<td width=75>[[image:NextDown.png|link=#stepDeleting|alt=Next Down|Next Down]]</td>
−	<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
−	</tr>
−	</table> <!-- END Nav Buttons Table -->
−	='''Saving and Loading Driver Games in Driver'''=	+	==Random Lists==
−	=='''Saving Driver Games'''==	+	'''Rule details can be found at [[file:WikiLink.PNG|link=]] [[Session_Rule_List_with_Parameters#Random_List_Rule|Random List Rule]]'''
	<table cellpadding=4 bgcolor=#c1e7e7>		<table cellpadding=4 bgcolor=#c1e7e7>
	<tr valign="top">		<tr valign="top">
−	<td>[[image:DotPoint.JPG|link=]]</td>	+	<td>[[file:DotPoint.JPG|link=]]</td>
−	<td>'''Driver Games (sometimes called "Saved Games" or "Driver Sessions") are "Game States" saved while in Driver Mode'''</td>	+	<td>'''A Random List will run <span style="color: red;">ONLY ONCE</span> and will randomly select a single Child Rule to execute.'''</td>
−	</tr>	+
−	</table>	+
−	<table width=900>	+
−	<tr valign="top">	+
−	<td width=745>	+
−	'''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.<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>	+
−		+
−	The space below the entered name will display any other saved '''Driver Games''' for that '''Session'''.	+
−	</td>	+
−	<td width=155>[[image:DriverSaveMenu.png|link=|alt=Save Menu]]</td>	+
	</tr>		</tr>
	</table>		</table>
	<table>		<table>
−	<tr valign="top">	+	<tr>
−	<td>[[image:DriverSARSave01.png|link=|alt=Save Driver Game]]</td>	+	<td>[[file:RandomListRules.JPG|link=]]</td>
−	<td>[[image:DriverSARSave02.png|link=|alt=Save Driver Game]]</td>	+
	</tr>		</tr>
	</table>		</table>
−	=='''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>
−	'''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>
−	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>	+	==Reset Lists==
−		+	'''Rule details can be found at [[file:WikiLink.PNG|link=]] [[Session_Rule_List_with_Parameters#Reset_List_Rule|Reset List Rule]]'''
−	[[image:DriverLoadDriverSession.png|link=|alt=Load Driver Game]]<br>	+	<table cellpadding=4 bgcolor=#c1e7e7>
−		+
−	<table bgcolor=#000000 width=900>	+
	<tr valign="top">		<tr valign="top">
−	<td>	+	<td>[[file:DotPoint.JPG|link=]]</td>
−	<table bgcolor=#ffffb0>	+	<td>'''A Reset List will execute continuously, it will never terminate. Each time through the list all the Child Rules will be reset and executed again.'''</td>
−	<tr valign="top">	+
−	<td>[[image:NotePad.PNG|link=]]</td>	+
−	<td><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br>	+
−	----	+
−	</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<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>	+
−	</tr>	+
−	<tr valign="top">	+
−	<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>	+
−	</tr>	+
−	</table>	+
−	</td>	+
	</tr>		</tr>
	</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>
−
−	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>
−
−	[[image:DriverButtonsNoEdit.png|link=|alt=Driver Game]]<br>
−
−	This will load  the '''Driver Game''', the '''Session''' and the '''Route''' into '''Driver'''.<br>
−
−	<table bgcolor=#ff0000 width=900>
−	<tr valign="top">
−	<td>
−	<table bgcolor=#fcbcbc>
−	<tr valign="top">
−	<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>
−	</tr>
−	<tr valign="top">
−	<td>&nbsp;</td>
−	<td>
	<table>		<table>
−	<tr valign="top">	+	<tr>
−	<td width=480>[[image:DriverLoadWarning.png|link=|alt=Warning assets have changed|480px]]</td>	+	<td>[[file:ResetListRules.JPG|link=]]</td>
−	<td>You will have the options of:-<br>	+
−	<span style="color: white; background-color: black; font-weight: 700; font-size: 15px;">&nbsp;Cancel&nbsp;</span> - the '''Driver Game''' will NOT be loaded, or<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>	+
−	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>	+
−	*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>	+
−	<br>	+
−	'''Only you can be the judge'''.	+
−	</td>	+
−	</tr>	+
−	</table>	+
−	</td>	+
−	</tr>	+
−	</table>	+
−	</td>	+
	</tr>		</tr>
	</table>		</table>
Line 1,614:		Line 323:
	<table> <!-- BEGIN Nav Buttons Table -->		<table> <!-- BEGIN Nav Buttons Table -->
	<tr valign="top">		<tr valign="top">
−	<td width=729><span id="stepDeleting"></span>&nbsp;</td>	+	<td width=729><span id="stepRelated"></span>&nbsp;</td>
−	<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>	+	<td width=46>[[file:BackToTop.png|link=#top|alt=Top|Top]]</td>
−	<td width=75>[[image:NextUp.png|link=#stepGames|alt=Next Up|Next Up]]</td>	+	<td width=75>[[file:NextUp.png|link=#stepOthers|alt=Next Up|Top]]</td>
		+	<td width=75>&nbsp;</td>
	<td width=75>&nbsp;</td>		<td width=75>&nbsp;</td>
−	<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
	</tr>		</tr>
	</table> <!-- END Nav Buttons Table -->		</table> <!-- END Nav Buttons Table -->
		+	='''Related Links'''=
−	='''Deleting Routes and Sessions'''=	+	<table cellpadding=4 bgcolor=#ffffff>
−		+
−	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 bgcolor=#ff0000>	+
	<tr valign="top">		<tr valign="top">
		+	<td>[[file:LinkWiki.PNG|link=]]</td>
	<td>		<td>
−	<table bgcolor=#fcbcbc>	+	*'''[[How to Use Message Popup Rule|Using Message Popups]]'''
−	<tr valign="top">	+	*'''[[How to Use Navigation Point Rules|Using Navigation Points]]'''
−	<td>&nbsp;</td>	+	*'''[[How to Use Session Editor|Using the Session Editor]]'''
−	<td><span style="font-size: 15px; font-weight: 700;">WARNING:</span></td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<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>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td>[[image:Stop.PNG|link=]]</td>	+
−	<td>'''If you delete a Session you will also delete all Driver Games created using that Session	+
	</td>		</td>
	</tr>		</tr>
	</table>		</table>
−	</td>
−	</tr>
−	</table>
−	<br>
−	<table cellpadding=4 bgcolor=#c1e7e7>
−	<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>
−
−	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>
	<table> <!-- BEGIN Nav Buttons Table -->		<table> <!-- BEGIN Nav Buttons Table -->
	<tr valign="top">		<tr valign="top">
	<td width=729><span id="bottom"></span>&nbsp;</td>		<td width=729><span id="bottom"></span>&nbsp;</td>
−	<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
−	<td width=75>[[image:NextUp.png|link=#stepDeleting|alt=Next Up|Next Up]]</td>
−	<td width=75>&nbsp;</td>
−	<td width=75>&nbsp;</td>
	</tr>		</tr>
	</table> <!-- END Nav Buttons Table -->		</table> <!-- END Nav Buttons Table -->
	----		----
	----		----
		+
	='''Trainz Wiki'''=		='''Trainz Wiki'''=
	<table cellpadding=4 bgcolor=#ffffff>		<table cellpadding=4 bgcolor=#ffffff>
	<tr valign="top">		<tr valign="top">
−	<td>[[image:TrainzWiki.png|link=]]</td>	+	<td>[[file:TrainzWiki.png|link=]]</td>
−	<td>	+
−	<span style="font-size: 17px;">'''Route and Session Building Guides'''</span><br>	+
−	*'''<span class="plainlinks">[http://online.ts2009.com/mediaWiki/index.php/HowTo How to Guides]</span>'''	+
−	*'''[[HowTo/Create_a_Route_in_10_Minutes|Create a Route in 10 Minutes]]'''	+
−	*'''[[How_to_Make_Good_Scenery|How to Make Good Scenery]]'''	+
−	*'''[[How_to_Use_Session_Editor|How to Use the Session Editor]]	+
−	</td>	+
−	</tr>	+
−	<tr valign="top">	+
−	<td>&nbsp;</td>	+
	<td>		<td>
	<span style="font-size: 17px;">'''More Tutorials and Guides to Using Trainz'''</span><br>		<span style="font-size: 17px;">'''More Tutorials and Guides to Using Trainz'''</span><br>
Line 1,699:		Line 365:
	</table>		</table>
	----		----
−	This page was created by Trainz user '''<span class="plainlinks">[http://online.ts2009.com/mediaWiki/index.php/User:Pware pware]</span>''' in September 2021 and was last updated as shown below.	+	This page was created by Trainz user '''<span class="plainlinks">[http://online.ts2009.com/mediaWiki/index.php/User:Pware pware]</span>''' in May 2018 and was last updated as shown below.
	----		----
−	[[Category:How-to guides]]	+	[[Category:How-to guides]][[Category:Rules]]

---

Revision as of 22:04, 14 March 2022

The information in this Wiki Page applies to TANE, TRS19, Trainz Plus and TRS22.

Contents 1 What Are Parent and Child Rules? 1.1 Parent/Child Rule Example 2 Ordered Lists vs Simultaneous Lists 2.1 Ordered Lists 2.2 Simultaneous Lists 3 Other Types of Lists 3.1 Progressive Lists 3.2 Random Lists 3.3 Reset Lists 4 Related Links 5 Trainz Wiki

What Are Parent and Child Rules?

	Rules that act as Parent Rules can have one or more sub-rules or Child Rules under them
	Rules are edited and managed by the Session Editor in Surveyor

More information on the Session Editor can be found on the Trainz Wiki Page at:- Using the Session Editor

Most Parent Rules are used as "decision makers" in Trainz Sessions. They decide if or when other rules, the Child Rules, will be executed. Some Parent Rules control how those Child Rules are executed.

Session rules can be arranged in a hierarchical fashion, in a series of levels as shown in the example on the left. A Parent Rule can be used to group together a set of rules at a lower level in the hierarchy. The rules that are grouped together under a Parent Rule are the Child Rules. Child Rules can also be Parent Rules that group together other rules at an even lower level. This creates multiple levels in the hierarchy. The Parent Rule at the head of each level in the hierarchy acts as a switch that directs the Trainz session to either ignore (skip over) or obey (execute) the Child Rules under its control. Notes: Only certain rules can be Parent Rules. See the Trainz Wiki page List of Parent Rules for details. Most Parent Rules will either wait for a specific event or perform a test or a comparison. They will execute the child rules when the event occurs or the test/comparison is true. Any rule can be a Child Rule.

Rules that act as Child Rules are indented under a Parent Rule.

Steps: To indent a rule, highlight (select) it click the Right Arrow Indent tool at the bottom of the Session Editor

Parent/Child Rule Example

In the screenshot above, the

• Trigger Check Rule is a Parent Rule. It has rules indented below it.
  • Simultaneous List Rule is indented under the Trigger Check Rule so it is a Child of that rule. It is also a Parent Rule as it has rules indented below it
    • Message Popup Rule is indented under the Simultaneous List Rule so it is a Child of that rule.
    • Wait Rule is indented under the Simultaneous List Rule so it is a Child of that rule. It is also a Parent Rule as it has rules indented below it
      • Close Message Popup Rule is indented under the Wait Rule so it is a Child of that rule.

Sequence of Events

• When the consist identified in the Trigger Check Rule, a Parent Rule, reaches the set trigger, the Trigger Event is activated and its Child Rules are executed.
  • The Simultaneous List Rule, a Parent Rule, is then executed. It executes all its Child Rules immediately and simultaneously.
    • The Message Popup Rule is executed. At the same time ...
    • The Wait Rule is executed. This is set to force a 20 second wait, after which its Child Rule ...
      • The Close Message Popup Rule is executed. This closes the Message window created by the Message Popup Rule.
        • Since the Close Message Popup Rule is the last child rule under the Wait Rule, when it has completed its task (closing the message popup) it will terminate that Parent Rule.
        • Since it is also the last child rule under the Simultaneous List Rule it will terminate that Parent Rule.
        • Finally, since it is the last child rule under the Trigger Check Rule, it also terminates that Parent Rule.

Ordered Lists vs Simultaneous Lists

The majority of sibling Child Rules, rules that are at the same indent level under a Parent Rule, will be executed in order (an Ordered List) or simultaneously (a Simultaneous List).

Ordered Lists

Rule details can be found at Ordered List Rule

Ordered Lists are shown with numbered icons on each Child Rule which indicates the order in which they will be executed.

Settings: An Ordered List can be set to run:- a set number of times, OR once only

Each Child Rule in the sequence must be completed before the next Child Rule can be executed.

Notes: An Ordered List is completed when the last Child Rule is completed. Because some rules will wait for an event (such as a mouse click, a set time or a time period, a consist trigger, a load trigger, etc) before they are completed, it is possible for the Ordered List to hang indefinitely waiting for the event to occur so that a rule can be completed and any following rules can then be executed. If possible, place Child Rules that are event dependent at the end of an ordered list.

Simultaneous Lists

Rule details can be found at Simultaneous List Rule

Simultaneous Lists are shown with equality ("=") icons on each Child Rule which indicates that they will be executed at the same time.

Settings: A Simultaneous List can be set to complete when:- all the Child Rules are completed, OR any one of the Child Rules has been completed Notes: While all child rules in a Simultaneous List will start at the same time, some will take longer to complete than others.

Other Types of Lists

Progressive Lists

Rule details can be found at Progressive List Rule

On the first run of a Progressive List, only the first Child Rule is executed. On the second run, the second Child Rule is executed, on the third run the third Child Rule is executed, etc.

Settings: A Progressive List can be set to:- repeat the sequence after the last child rule has been executed, OR terminate (no further repeats) after the last child rule has been executed

Random Lists

Rule details can be found at Random List Rule

A Random List will run ONLY ONCE and will randomly select a single Child Rule to execute.

Reset Lists

Rule details can be found at Reset List Rule

A Reset List will execute continuously, it will never terminate. Each time through the list all the Child Rules will be reset and executed again.

Related Links

Using Message Popups Using Navigation Points Using the Session Editor

---

---

Trainz Wiki

More Tutorials and Guides to Using Trainz How to Guides Driver Commands List Session Rules List (Alphabetical) with Parameters Session Rules List (Categories) With Parameters

---

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

---