How to Use Driver Setup Rule

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
(→‎Adding New Drivers)
m (→‎Trainz Wiki)
 
(167 intermediate revisions by one user not shown)
Line 1: Line 1:
 +
The information in this Wiki Page applies to '''T:ANE''', '''TRS19''', '''Trainz Plus''' and '''TRS22'''.
 +
<table>
 +
<tr valign="top">
 +
<td>
 +
__TOC__
 +
</td>
 +
<td>
 +
<table width=800 bgcolor="lightcyan" cellpadding=2>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>The '''Driver Setup Rule''' assigns drivers to consists and issues them with '''Driver Commands'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>'''Driver Commands''' are lists of instructions or "orders" that drivers are tasked to complete under the control of the Trainz '''AI''' system</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table -->
 +
<tr valign="top">
 +
<td width=629><span id="stepSetup"></span>
 +
='''Driver Setup Rule'''=
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#skipAddDrivers|Skip Down]]</td> <!-- skip Down -->
 +
<td width=50>&#160;</td> <!-- skip Up -->
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>&nbsp;</td>
 +
<td width=75>[[image:NextDown.png|link=#stepCopying|alt=Next Down|Next Down]]</td>
 +
<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
−
'''UNDER CONSTRUCTION'''
+
<table cellpadding=4 bgcolor="Aquamarine">
 +
<tr valign="top">
 +
<td rowspan=2>[[image:LinkWiki.PNG|link=]]</td>
 +
<td>
 +
A list of available '''Driver Commands''' can be found on the '''Trainz Wiki Page''' at:-<br>
 +
* '''[[Driver_Commands_List|Driver Commands List]]'''
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
The [[image:WikiLink.PNG|link=]] '''[[Session Rule List with Parameters#Driver Setup Rule|Driver Setup Rule]]''' is automatically added to the Session Editor of every Session.
 +
<br>
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>[[image:EditSessionWindow.JPG|480px|link=]]</td>
 +
<td>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To open the '''driver Setup Rule''':-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td>Open the [[image:WikiLink.PNG|link=]] '''[[How to Use Session Editor|Session Editor]]''' by selecting '''Edit Session''' from the '''Surveyor Main Menu''' in '''T:ANE''' or the '''Surveyor Edit Menu''' in '''TRS19''' and later versions</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>Select the '''Driver Setup Rule''' shown left (it is usually the rule at the top of the list)</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the '''Edit''' button at the bottom of the '''Session Editor''' window</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table bgcolor=#ff0000>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#fcbcbc>
 +
<tr valign="top">
 +
<td>[[image:Stop.PNG|link=]]</td>
 +
<td>If the '''Driver Setup Rule''' is not shown in the list then...<br><br>
 +
<table bgcolor=#ffffff>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To add the '''Driver Setup Rule:-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Add&#160;</span> button at the bottom of the '''Session Editor''' window</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>Scroll through the list of rules to locate and select the '''Driver Setup Rule'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the [[image:Tick.PNG|link=]] icon on the rule list window</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table cellpadding=4 bgcolor="Aquamarine">
 +
<tr valign="top">
 +
<td rowspan=2>[[image:LinkWiki.PNG|link=]]</td>
 +
<td>
 +
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>
 +
</tr>
 +
</table></td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS -->
 +
<tr valign="top">
 +
<td width=629><span id="skipAddDrivers"></span>
 +
=='''Adding New Drivers'''==
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#skipEditDrivers|Skip Down]]</td> <!-- skip Down -->
 +
<td width=50>[[image:SkipUp.png|link=#stepSetup|Skip Up]]</td> <!-- skip Up -->
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
−
='''Driver Setup Rule'''=
+
<table width=1000>
 +
<tr valign="top">
 +
<td>After opening the '''Driver Setup Rule''' <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the link:- <br>
 +
[[image:DriverSetupAddAnotherDriver.JPG|link=]]<br>
 +
<table bgcolor=#000000>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffb0>
 +
<tr valign="top">
 +
<td>[[image:NotePad.PNG|link=]]</td>
 +
<td>If there is a list of drivers already present then scroll down to the bottom of the list to see the link
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
  
−
----
+
The image on the right shows the properties window if it is opened with no drivers placed in the layout.<br>
 +
 
 +
This will open the '''Add New Driver''' window.<br>
 +
 
 +
Select a driver from the list and <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the '''Tick''' button.
 +
</td>
 +
<td>[[image:DriverSetupAddDriver.JPG|link=|alt=Add Driver]]</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000 bgcolor=#fcbcbc>
 +
<tr valign="top">
 +
<td>[[image:Stop.PNG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 17px;">Timeout Problem in T:ANE</span> This is an issue in '''T:ANE'''. It has been '''FIXED''' in '''TRS19''' and later versions.<br>
 +
<br>
 +
Adding a large number of drivers to the Driver Setup can cause '''Timeout''' errors particularly if certain driver script libraries are being used. Exactly how many is a "large number" will depend on other factors.<br>
 +
 
 +
<table bgcolor=#ffffe0> <!-- BEGIN Tips Table -->
 +
<tr valign="top">
 +
<td>[[image:PencilTips.PNG|link=]]</td>
 +
<td>If '''Driver Setup Timeout''' errors are reported, then split the drivers between two copies of the '''Driver Setup Rule''' and place the second copy as a child of a [[image:WikiLink.PNG|link=]] '''[[Session Rule List with Parameters#Wait Rule|Wait Rule]]''' set for a delay of just a few seconds, as shown on the right.<br>
 +
 
 +
[[image:DriverSetupWait.png|link=]]<br>
 +
 
 +
This gives '''Trainz''' enough time to process all the drivers in the first '''Driver Setup''' rule before starting on the second '''Driver Setup''' rule.<br>
 +
 
 +
Information on how to use Parent and Child rules can be found at [[image:WikiLink.PNG|link=]] '''[[Parent and Child Rules]]'''
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table> <!-- END Tips -->
 +
<br>
 +
===Remove Existing Drivers First===
 +
 
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>After selecting the '''Driver Setup Rule''' <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the '''Edit''' button, the Driver Setup Properties Window will be shown. The image below shows the properties window if it is opened with no drivers placed in the layout.</td>
 +
</tr>
 +
</table>
 +
 
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>[[image:DriverSetupStartWindow.JPG|link=]]</td>
 +
<td><br>
 +
[[image:DriverSetupRemoveExisting.JPG|link=]]
 +
<table cellpadding=4 bgcolor=#eeeeee>
 +
<tr>
 +
<td colspan="2">
 +
----</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:Gears.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''TRS19/Trainz Plus/TRS22 Settings:'''</span>
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:DotPoint.JPG]]</td>
+
<td width=10>[[image:BlackDot10x10.png|link=]]</td>
−
<td>'''The ''Driver Setup Rule'' assigns drivers to consists and issues them with ''Driver Commands''.'''</td>
+
<td>If '''Checked [[image:CheckBox.PNG|link=]]''' All existing drivers will be removed so all trains will become "empty" (no drivers). When used with the '''Generate new Drivers for empty trains''' option, it will produce a new list of randomly selected drivers for all trains</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:DotPoint.JPG]]</td>
+
<td>[[image:BlackDot10x10.png|link=]]</td>
−
<td>'''Driver Commands are lists of instructions or "orders" that drivers are tasked to complete under the control of the Trainz ''AI'' system.'''</td>
+
<td>If '''Unchecked [[image:CheckBoxOff.PNG|link=]]''' All existing drivers will remain with their previously assigned trains</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr>
 +
<td colspan="2">
 +
----</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
−
----
 
−
The '''Driver Setup Rule''' is automatically added to the Session Editor of every route and session.
 
  
−
Open the '''Surveyor Session Editor''' from the main menu.
+
<table cellpadding=4 bgcolor=#ff0000>
 +
<tr valign="top">
 +
<td>
 +
<table cellpading="4" bgcolor=#ffffff>
 +
<tr valign="top">
 +
<td>[[image:Bug.png|link=]]</td>
 +
<td><span style="font-size: 17px;">'''T:ANE Known Issues:'''</span><br>
 +
[[image:DriverSetupRemoveExisting.JPG|link=]] '''This does not appear to have any effect in T:ANE'''</td>
 +
</tr>
 +
</table></td>
 +
</tr>
 +
</table></td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table bgcolor=#ff0000 width=1000>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#fcbcbc>
 +
<tr valign="top">
 +
<td>[[image:Stop.PNG|link=]]</td>
 +
<td>If your session uses a rule that will expect to find a particular driver in charge of a train (e.g. driver '''Charlie''' in the '''Trigger Check Rule''') then manually assign '''Charlie''' as the driver of a train and do not select the option '''Remove all existing Drivers first'''.
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
===Generate New Drivers for Empty Trains===
 +
 
 +
[[image:DriverSetupGenerateNew.JPG|link=]]<br>
 +
 
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>
 +
<table width=500 cellpadding=4 bgcolor=#eeeeee>
 +
<tr>
 +
<td colspan="2">
 +
----</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:Gears.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Settings:'''</span>
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:EditSessionWindow.JPG|480px]]</td>
+
<td width=10>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>If '''Checked [[image:CheckBox.PNG|link=]]''' randomly selected drivers will be assigned to all newly added ''driveable'' trains. Existing drivers will not be affected unless the '''Remove all existing Drivers first''' option has been selected</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>If '''Unchecked [[image:CheckBoxOff.PNG|link=]]''' then you will have to manually assign drivers to trains by a <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the '''<span style="text-decoration: underline;">Add another Driver</span>''' link</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr>
 +
<td colspan="2">
 +
----</td>
 +
</tr>
 +
</table>
 +
</td>
 
<td>
 
<td>
−
*Select the '''Driver Setup Rule''' shown left (it is usually the rule at the top of the list).
+
<table width=500 bgcolor=#000000 cellpadding=2>
−
*Click the '''Edit''' button at the bottom of the Session Editor window.
+
<tr valign="top">
 +
<td>
 +
<table width=496 bgcolor=#ffffb0 cellpadding=2>
 +
<tr valign="top">
 +
<td width=25>[[image:NotePad.PNG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br>
 +
----
 +
When using the '''Driver Setup Rule''' for the first time with no drivers assigned to existing trains, the '''Generate new Drivers for empty trains''' option will immediately assign drivers to each train. Each time a new train is added to the layout, it will be automatically assigned a driver.</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 
<br>
 
<br>
−
If the '''Driver Setup Rule''' is not shown in the list then...
+
===Wait For Schedule Completion===
−
*Click the '''Add''' button at the bottom of the Session Editor window.
+
[[image:DriverSetupWaitSchedule.png|link=]]
−
*Scroll through the list of rules to locate and select the '''Driver Setup Rule'''.
+
<table cellpadding=4 bgcolor=#eeeeee>
−
*Click the '''Tick''' button on the rule list window.
+
<tr>
 +
<td colspan="2">
 +
----</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:Gears.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Settings:'''</span>
 +
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>If '''Checked [[image:CheckBox.PNG|link=]]''' then this '''Driver Setup Rule''' will not complete until all '''Schedule Rules''' (if any) have been completed</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>If '''Unchecked [[image:CheckBoxOff.PNG|link=]]''' then this '''Driver Setup Rule''' will complete as soon as all its drivers have been assigned locos and commands (if any)</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
−
</tr></table>
+
</tr>
 +
<tr>
 +
<td colspan="2">
 +
----</td>
 +
</tr>
 +
</table>
 +
<br>
 +
===Focus Camera on First Driver===
 +
[[image:DriverSetupFocus.png|link=]]
 +
<table cellpadding=4 bgcolor=#eeeeee>
 +
<tr>
 +
<td colspan="2">
 +
----</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:Gears.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Settings:'''</span>
 +
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>If '''Checked [[image:CheckBox.PNG|link=]]''' then the Session will start with the camera focussed on the first driver in the list</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>If '''Unchecked [[image:CheckBoxOff.PNG|link=]]''' then the Session will start with the camera focussed on the scene that last had the camera focus in Surveyor</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr>
 +
<td colspan="2">
 +
----</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS -->
 +
<tr valign="top">
 +
<td width=629><span id="skipEditDrivers"></span>
 +
=='''Editing the Driver List'''==
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#skipAddCommands|Skip Down]]</td> <!-- skip Down -->
 +
<td width=50>[[image:SkipUp.png|link=#skipAddDrivers|Skip Up]]</td> <!-- skip Up -->
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
 +
 
 +
When drivers and trains have been added to the rule, it will appear as shown below.
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>[[image:DriverSetupDriverCommandList.JPG|link=]]</td>
 +
<td>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffb0 cellpadding=2>
 +
<tr valign="top">
 +
<td width=25>[[image:NotePad.PNG|link=]]</td>
 +
<td>If a loco name appears in '''<span style="color: red;">red</span>''' then it has been removed from the layout</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To edit the driver list:-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the driver <span style="font-weight: 700; font-size: 15px;">icon</span> to select a different driver from the Session list</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the <span style="font-weight: 700; font-size: 15px; text-decoration: underline;">loco name</span> to select a different loco from the Session list (an empty loco list means no unassigned locos are available)</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on the <span style="font-weight: 700; font-size: 15px; text-decoration: underline;">driver name</span> to type in a new name for this driver (this will '''not''' change the driver icon)</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint4.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on <span style="font-weight: 700; font-size: 15px; text-decoration: underline;">Autodetect</span> to select a new owner for this driver and loco. There are four "owner" options:-
  
−
==Adding New Drivers==
 
−
After selecting the '''Driver Setup Rule''' and clicking the '''Edit''' button, the Driver Setup Properties Window will be shown. The image below shows the properties window the first time it is opened in a session - no drivers have initially been assigned.
 
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:DriverSetupStartWindow.JPG]]</td>
+
<td colspan=2>Choose one of the following options:-</td>
−
<td><br>
+
</tr>
−
[[file:DriverSetupRemoveExisting.JPG]]
+
<tr valign="top">
 +
<td width=25>[[image:Ablue.png|link=]]</td>
 +
<td>'''AI driver''' - this train will be under AI control even if it has no '''Driver Command Bar''' orders to follow. This can be used to prevent a user from taking control of the train</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:Bblue.png|link=]]</td>
 +
<td>'''Autodetect''' - if the train has '''Driver Command Bar''' orders then it will be under AI control. If it has no '''Driver Command Bar''' orders then it will be under user control</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:Cblue.png|link=]]</td>
 +
<td>'''First Human Player''' - the train will be assigned to the user or a multiplayer, whoever selects it first</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:Dblue.png|link=]]</td>
 +
<td>'''Multiplayer Driver''' - the train will be assigned to a multiplayer</td>
 +
</tr>
 +
</table>
  
−
Possible BUG
+
</td>
−
<br><br>
+
</tr>
−
[[file:DriverSetupGenerateNew.JPG]]
+
<tr valign="top">
 +
<td colspan=2>If you need to remove a driver:-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint5.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> <span style="font-weight: 700; font-size: 15px; text-decoration: underline;">remove</span> to delete this driver from the rule</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS -->
 +
<tr valign="top">
 +
<td width=629><span id="skipAddCommands"></span>
 +
=='''Adding Driver Commands'''==
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#skipDeleteCommands|Skip Down]]</td> <!-- skip Down -->
 +
<td width=50>[[image:SkipUp.png|link=#skipEditDrivers|Skip Up]]</td> <!-- skip Up -->
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
−
When the above option is checked, randomly selected drivers will be assigned to all newly added ''driveable'' trains. Existing drivers will not be affected.
+
<table width=1000>
−
<br><br>
+
<tr valign="top">
 +
<td>The grey area below the driver details (name, loco, owner) is the '''Driver Command Bar'''. This is where the driving instructions (the "train orders") used by the Trainz AI system are given to the driver.</td>
 +
</tr>
 +
</table>
 +
 
 +
<table width=1000>
 +
<tr valign="top">
 +
<td width="500">[[image:DriverSetupAddCommand.JPG|500px|link=]]<br>
 +
Shown below is a '''Driver Command Bar''' after two driver commands have been added. Each command has its own icon. Move the mouse pointer onto a command icon to reveal a '''tooltip''' showing the contents of the command, as shown in the image.<br>
 +
[[image:DriverSetupAddedCommand.JPG|500px|link=]]
 +
</td>
 +
<td>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To add driver commands:-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the small "double chevron" icon shown in the image on the left.<br>
 +
[[image:AddCommandIconTANE.png|link=]] '''T:ANE''' or [[image:AddCommandIcon.png|link=]] '''Trains Plus''' and '''TRS22'''<br>
 +
 
 +
This will open a Command List menu which will show the driver commands that can be added to this drivers '''Command Bar'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on a command to add it to the '''Driver Command Bar'''</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
 
 +
<table>
 +
<tr valign="top">
 +
<td width="162">[[image:DriverSetupCommandMenu.JPG|link=]]</td>
 +
<td>
 +
<table width=338 bgcolor=#000000>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffb0>
 +
<tr valign="top">
 +
<td>[[image:NotePad.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Notes:'''</span><br>
 
----
 
----
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>The commands that will be shown and are available for use are decided by another rule, the [[image:PageLink.PNG|link=]] '''[[#Driver Command Rule|Driver Command Rule]]'''. If a command that you want is not in the list then open and edit the '''Driver Command Rule'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>Many of the items in the menu will open sub-menus. These are indicated by the <span style="font-weight: 700; font-size: 15px;">&gt;</span> character after the command name. For example:-
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:DotPoint.JPG]]</td>
+
<td width=10>[[image:RedDot10x10.png|link=]]</td>
−
<td>When using the '''Driver Setup Rule''' for the first time with no drivers assigned to existing trains, the '''Generate new Drivers for empty trains''' option will immediately assign drivers to each train. Each time a new train is added to the layout, it will be automatically assigned a driver.</td>
+
<td>The <span style="font-weight: 700; font-size: 15px;">Drive To Trackmark &gt;</span> will open a sub-menu listing all the available trackmarks</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:RedDot10x10.png|link=]]</td>
 +
<td>The <span style="font-weight: 700; font-size: 15px;">Navigate To &gt;</span> will open a sub-menu of all the interactive industries</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:RedDot10x10.png|link=]]</td>
 +
<td>The <span style="font-weight: 700; font-size: 15px;">Wait For &gt;</span> will open a sub-menu of different wait times</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
 +
<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>
 
----
 
----
 +
When a driver command has been executed in '''Driver Mode''' by the Trainz AI system, it will be deleted from the '''Driver Command Bar''' and the next command in the sequence will then be executed. This will continue until the last command has been executed and deleted. Then the AI control of the train will terminate.
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS -->
 +
<tr valign="top">
 +
<td width=629><span id="skipDeleteCommands"></span>
 +
=='''Deleting Driver Commands'''==
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#skipRepeatCommand|Skip Down]]</td> <!-- skip Down -->
 +
<td width=50>[[image:SkipUp.png|link=#skipAddCommands|Skip Up]]</td> <!-- skip Up -->
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
 +
To remove a command from the '''Driver Command Bar'''...
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>[[image:DriverSetupDeleteCommand.JPG|link=]]</td>
 +
<td>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To '''remove''' a command from the '''Driver Command Bar''':-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click and Drag</span> the command out of the '''Driver Command Bar''' area</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS -->
 +
<tr valign="top">
 +
<td width=629><span id="skipRepeatCommand"></span>
 +
=='''The "Repeat" Command'''==
 +
</td>
 +
<td width=50>[[image:SkipDown.png|link=#stepCopying|Skip Down]]</td> <!-- skip Down -->
 +
<td width=50>[[image:SkipUp.png|link=#skipDeleteCommands|Skip Up]]</td> <!-- skip Up -->
 +
<td width=46>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>&#160;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
 +
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>The '''Repeat''' command is a special built in '''Driver Command''' that allows ALL the driver commands to be repeated endlessly</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000>
 +
<tr valign="top">
 +
<td><br>
 +
[[image:DriverSetupAddRepeat.JPG|link=]]</td>
 +
<td>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffb0 cellpadding=2>
 +
<tr valign="top">
 +
<td width=25>[[image:NotePad.PNG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br>
 +
----
 +
The '''Repeat''' command is only available when at least one command is present in the '''Driver Command Bar''' and only one '''Repeat''' command can be added</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To add a '''Repeat''' command:-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the '''Add Command''' button (<span style="font-weight: 700; font-size: 15px;">&gt;&gt;</span>) on the '''Driver Command Bar'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>Select the '''Repeat''' option</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
  
−
='''Driver Command Rule'''=
+
<table width=1000>
 +
<tr valign="top">
 +
<td>[[image:DriverSetupRepeatIcon.JPG|link=]]</td>
 +
<td>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffb0 cellpadding=2>
 +
<tr valign="top">
 +
<td width=25>[[image:NotePad.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Notes:'''</span><br>
 +
----
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>The '''Repeat''' icon will '''always''' be placed at the end of the '''Driver Command Bar''' after the '''Add Command''' button (<span style="font-weight: 700; font-size: 15px;">&gt;&gt;</span>)</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>As each command is executed by the Trainz AI system, it will be deleted from the front of the command list and added to the end of the list to create an "endless loop" of commands</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
  
 +
<table width=1000>
 +
<tr valign="top">
 +
<td width=580>[[image:DriverSetupRemoveRepeat.JPG|link=]]</td>
 +
<td>
 +
<table bgcolor=#000000 width=420>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffb0>
 +
<tr valign="top">
 +
<td>[[image:NotePad.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Notes:'''</span><br>
 
----
 
----
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
−
<td>[[file:DotPoint.JPG]]</td>
+
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
−
<td>'''The ''Driver Command Rule'' controls which ''Driver Commands'' will be available to users in a Session.'''</td>
+
<td>If a '''Repeat''' command is already present, then the '''Add Command''' menu list will show '''Don't Repeat''' as its first option</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>Select '''Don't Repeat''' to remove the '''Repeat''' command</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table cellpadding=4 bgcolor=#ff0000 width="640">
 +
<tr valign="top">
 +
<td>
 +
<table cellpading="4" bgcolor=#ffffff>
 +
<tr valign="top">
 +
<td>[[image:Bug.png|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Known Issues:'''</span> This is an issue in '''T:ANE'''. It has been '''FIXED''' in '''TRS19''' and later versions.<br>
 +
If a '''Repeat''' command is present in the '''Driver Command Bar''' and all the other commands are then deleted, the '''Repeat''' command will remain in the '''Driver Command Bar''' and cannot be removed. Because there are no other commands to be repeated this will not cause a problem. However when later adding new commands the presence of the '''Repeat''' command can be easily overlooked.
 +
<table cellpadding=4 bgcolor=#bbffbb width="640">
 +
<tr valign="top">
 +
<td>[[image:Spanner.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Workaround:'''</span><br>
 +
Add a command (any command) to the '''Driver Command Bar'''. The '''Don't Repeat''' option will then become available and the '''Repeat''' command can be removed.</td>
 +
</tr>
 +
</table></td>
 +
</tr>
 +
</table></td>
 +
</tr>
 +
</table>
 +
 +
<table width=1000> <!-- BEGIN Nav Buttons Table -->
 +
<tr valign="top">
 +
<td width=629><span id="stepCopying"></span>
 +
='''Copying the Driver Setup Rule'''=
 +
</td>
 +
<td width=50>&#160;</td> <!-- skip Down -->
 +
<td width=50>[[image:SkipUp.png|link=#skipRepeatCommand|Skip Up]]</td> <!-- skip Up -->
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>[[image:NextUp.png|link=#stepSetup|alt=Next Up|Top]]</td>
 +
<td width=75>[[image:NextDown.png|link=#stepCommand|alt=Next Down|Next Down]]</td>
 +
<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
 +
 +
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>The '''Driver Setup Rule''' (and other rules) can be copied between Sessions</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To copy the '''Driver Setup Rule''' to other sessions:-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td>in the '''Session Editor''' <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Right Click</span> on the '''Driver Setup Rule'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>select '''Copy''' from the popup menu</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td>exit the Session</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint4.JPG|link=]]</td>
 +
<td>load the second Session (where the Rule is to be copied to) into Surveyor and open the '''Session Editor'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint5.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Right Click</span> after the last rule entry and select '''Paste'''</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000 bgcolor=#000000>
 +
<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>
 
----
 
----
 +
There are some conditions that must be met before the copy between session will work:-
 +
<br>
 +
<table cellpadding=4>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1Blue.png|link=]]</td>
 +
<td>'''Drivers, Driver Assignments and Driver Commands ONLY are Copied'''<br>
 +
Copying the '''Driver Setup Rule''' will '''NOT''' copy the actual locomotives and consists that the drivers are assigned to. These must be copied or recreated separately</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2Blue.png|link=]]</td>
 +
<td>'''No Duplicate Locos Allowed''' - this is only an issue if you keep both the original and the copied '''Driver Setup Rule''' in the Session<br>
 +
If the same loco is present in both '''Driver Setup Rules''' then only the first loco (in the top copy of the rule) will be active. The duplicate loco in the second copy of the rule will be ignored</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3Blue.png|link=]]</td>
 +
<td>'''Missing Locos will be Ignored'''<br>
 +
If a loco is listed in the copied '''Driver Setup Rule''' but does not exist in the new Session because it was not copied across then it will be ignored
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table -->
 +
<tr valign="top">
 +
<td width=629><span id="stepCommand"></span>
 +
='''Driver Command Rule'''=
 +
</td>
 +
<td width=50>&#160;</td> <!-- Skip Down -->
 +
<td width=50>&#160;</td> <!-- Skip Up -->
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>[[image:NextUp.png|link=#stepCopying|alt=Next Up|Top]]</td>
 +
<td width=75>&#160;</td>
 +
<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
  
 +
<table width=1000 bgcolor="lightcyan" cellpadding=2>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>The '''[[image:WikiLink.PNG|link=]] [[Session Rule List with Parameters#Driver Command Rule|Driver Command Rule]]''' controls which '''Driver Commands''' will be available to a user. This applies to both:-
 +
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>commands added to the [[image:PageLink.PNG|link=]] '''[[#Driver Setup Rule|Driver Setup Rule]]''' in the [[image:WikiLink.PNG|link=]] '''[[How to Use Session Editor|Session Editor]]''' in '''Surveyor''', and</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlueDot10x10.png|link=]]</td>
 +
<td>commands for the user to manually add to the '''Driver Command Bar''' of user and AI controlled trains running in '''Driver'''</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
The [[image:WikiLink.PNG|link=]] '''[[Session Rule List with Parameters#Driver Command Rule|Driver Command Rule]]''' is automatically added to the Session Editor of every Session.
 +
<br>
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>[[image:EditSessionWindow.JPG|480px|link=]]</td>
 +
<td>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To edit the '''Driver Command Rule''':-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td>Select (<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span>) the '''Driver Command Rule''' shown left (it is usually near the top of the list)</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Edit&#160;</span> button at the bottom of the Session Editor window</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table bgcolor=#ff0000>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#fcbcbc>
 +
<tr valign="top">
 +
<td>[[image:Stop.PNG|link=]]</td>
 +
<td>If the '''Driver Command Rule''' is not shown in the list then...
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To add the '''Driver Command Rule''':-</td>
 +
</tr>
 +
<tr valign="top">
 +
<td width=25>[[image:DotPoint1.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Add&#160;</span> button at the bottom of the '''Session Editor''' window</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint2.JPG|link=]]</td>
 +
<td>Scroll through the list of rules to locate and select the '''Driver Command Rule'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint3.JPG|link=]]</td>
 +
<td><span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> the [[image:Tick.PNG|link=]] icon on the rule list window</td>
 +
</tr>
 +
</table>
 +
This will add the rule to the Session Editor.</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>
 +
The Rule properties window will open to show all the ''Driver Commands'' that have been installed in '''Trainz''' on your system. This list includes the commands that are built in and those that have been downloaded from the DLS.</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000>
 +
<tr valign="top">
 +
<td width=500>[[image:DriverCommandAddCommand.JPG|500px|link=]]</td>
 +
<td>
 +
<table cellpadding=4 bgcolor=#eeeeee>
 +
<tr>
 +
<td colspan="2">
 +
----</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:Gears.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Settings:'''</span>
 +
<table>
 +
<tr valign="top">
 +
<td width=10>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>Commands that are [[image:CheckBox.PNG|link=]] '''Checked ON''' will be available in the '''Driver Setup Rule''' Command List in the Session Editor and for the user in '''Driver'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>Commands that are [[image:CheckBoxOff.PNG|link=]] '''Checked OFF''' will '''NOT''' be available in the '''Driver Setup Rule''' Command List in the Session Editor and for the user in '''Driver'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:BlackDot10x10.png|link=]]</td>
 +
<td>To change the status of a command simply check it '''ON''' or '''OFF'''</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
<tr>
 +
<td colspan="2">
 +
----</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffe0 cellpadding=2>
 +
<tr valign="top">
 +
<td>[[image:PencilTips.PNG|link=]]</td>
 +
<td>Removing '''Driver Commands''' such as '''Navigate''' and '''Drive''' will force players to manually drive trains when in '''Driver''' instead of allowing them to use the AI system to do all the work</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000 bgcolor=#000000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table width=996 bgcolor=#ffffb0 cellpadding=2>
 +
<tr valign="top">
 +
<td width=25>[[image:NotePad.PNG|link=]]</td>
 +
<td><span style="font-size: 17px;">'''Notes:'''</span><br>
 
----
 
----
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>If a command that you want to use does not appear in the list, then check in '''Content Manager''' that it has been installed and is free of errors</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|10px|link=]]</td>
 +
<td>In '''T:ANE''' some Driver Commands that have been checked '''ON''' will not appear in the '''Driver Command Bar''' if there is no target for their action. For example, no set trackmarks or interactive industries for the '''Drive To''' command</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table width=1000> <!-- BEGIN Nav Buttons Table -->
 +
<tr valign="top">
 +
<td width=629><span id="bottom"></span>&nbsp;</td>
 +
<td width=50>&#160;</td> <!-- Skip Down -->
 +
<td width=50>&#160;</td> <!-- Skip Up -->
 +
<td width=46>[[image:BackToTop.png|link=#top|alt=Top|Top]]</td>
 +
<td width=75>[[image:NextUp.png|link=#stepCommand|alt=Next Up|Top]]</td>
 +
<td width=75>&nbsp;</td>
 +
<td width=75>&nbsp;</td>
 +
</tr>
 +
</table> <!-- END Nav Buttons Table -->
 
----
 
----
 +
----
 +
 
='''Trainz Wiki'''=
 
='''Trainz Wiki'''=
 +
<table width=1000>
 +
<tr valign="top">
 +
<td>
 +
<table width=500 cellpadding=2 bgcolor=#ffffff>
 +
<tr valign="top">
 +
<td width=80>[[image:TrainzWiki.png|link=]]</td>
 +
<td>
 +
<span style="font-size: 17px;">'''More Tutorials and Guides to Using Trainz'''</span><br>
 
*'''<span class="plainlinks">[http://online.ts2009.com/mediaWiki/index.php/HowTo How to Guides]</span>'''
 
*'''<span class="plainlinks">[http://online.ts2009.com/mediaWiki/index.php/HowTo How to Guides]</span>'''
 +
*'''[[Driver Commands List]]'''
 
*'''[[Session Rule List with Parameters|Session Rules List (Alphabetical) with Parameters]]'''
 
*'''[[Session Rule List with Parameters|Session Rules List (Alphabetical) with Parameters]]'''
 
*'''[[Session Rules By Categories With Properties|Session Rules List (Categories) With Parameters]]'''
 
*'''[[Session Rules By Categories With Properties|Session Rules List (Categories) With Parameters]]'''
−
<font size="3">'''Route Creation Tutorials:'''</font>
+
</td>
−
<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">
+
</tr>
−
*'''[[How to Use Layers]]'''
+
</table>
−
</div>
+
</td>
−
<font size="3">'''Session Creation Tutorials:'''</font>
+
<td>
−
<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">
+
<table width=500 cellpadding=4 bgcolor="aquamarine">
−
*'''[[How to Create a HTML Asset|How to Create a HTML Asset (Session Introduction Page and In Game Messages)]]'''
+
<tr valign="top">
−
*'''[[How to Control Junctions in Sessions]]'''
+
<td width=50>[[image:LinkWiki.PNG|link=]]</td>
−
*'''[[How to Control Signals in Sessions]]'''
+
<td>
−
*'''[[How to Use Message Popup Rule]]'''
+
<span style="font-size: 17px;">'''Related Links'''</span><br>
−
*'''[[How to Use Message Popup Rule (Applications)]]'''
+
* '''[[How to Use Session Editor|Using the Session Editor]]'''
−
*'''[[How to Use Navigation Point Rules]]'''
+
</td>
−
*'''[[How to Use Navigation Point Rules (Applications)]]'''
+
</tr>
−
*'''[[How to Use Parent and Child Rules]]'''
+
</table>
−
*'''[[How to Use Track Triggers]]'''
+
</td>
−
*'''[[How to Use Variables in Sessions (Examples)]]
+
</tr>
−
*'''[[Parent Rule List|List of Parent Rules]]'''
+
</table>
−
</div>
+
----
 +
This page was created by Trainz user '''<span class="plainlinks">[http://online.ts2009.com/mediaWiki/index.php/User:Pware pware]</span>''' in June 2018 and was last updated as shown below.
 +
----
 +
 
 +
[[Category:How-to guides]][[Category:Rules]]

Latest revision as of 20:34, 22 November 2023

The information in this Wiki Page applies to T:ANE, TRS19, Trainz Plus and TRS22.

Contents
BlueDot10x10.png The Driver Setup Rule assigns drivers to consists and issues them with Driver Commands
BlueDot10x10.png Driver Commands are lists of instructions or "orders" that drivers are tasked to complete under the control of the Trainz AI system


[edit] Driver Setup Rule

 Skip Down   Top   Next Down Bottom
LinkWiki.PNG

A list of available Driver Commands can be found on the Trainz Wiki Page at:-


The WikiLink.PNG Driver Setup Rule is automatically added to the Session Editor of every Session.

EditSessionWindow.JPG
Steps: To open the driver Setup Rule:-
DotPoint1.JPG Open the WikiLink.PNG Session Editor by selecting Edit Session from the Surveyor Main Menu in T:ANE or the Surveyor Edit Menu in TRS19 and later versions
DotPoint2.JPG Select the Driver Setup Rule shown left (it is usually the rule at the top of the list)
DotPoint3.JPG Left Click the Edit button at the bottom of the Session Editor window


Stop.PNG If the Driver Setup Rule is not shown in the list then...

Steps: To add the Driver Setup Rule:-
DotPoint1.JPG Left Click the  Add  button at the bottom of the Session Editor window
DotPoint2.JPG Scroll through the list of rules to locate and select the Driver Setup Rule
DotPoint3.JPG Left Click the Tick.PNG icon on the rule list window


LinkWiki.PNG

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


[edit] Adding New Drivers

 Skip Down Skip Up        
After opening the Driver Setup Rule Left Click the link:-

DriverSetupAddAnotherDriver.JPG

NotePad.PNG If there is a list of drivers already present then scroll down to the bottom of the list to see the link


The image on the right shows the properties window if it is opened with no drivers placed in the layout.

This will open the Add New Driver window.

Select a driver from the list and Left Click the Tick button.

Add Driver


Stop.PNG Timeout Problem in T:ANE This is an issue in T:ANE. It has been FIXED in TRS19 and later versions.


Adding a large number of drivers to the Driver Setup can cause Timeout errors particularly if certain driver script libraries are being used. Exactly how many is a "large number" will depend on other factors.

PencilTips.PNG If Driver Setup Timeout errors are reported, then split the drivers between two copies of the Driver Setup Rule and place the second copy as a child of a WikiLink.PNG Wait Rule set for a delay of just a few seconds, as shown on the right.

DriverSetupWait.png

This gives Trainz enough time to process all the drivers in the first Driver Setup rule before starting on the second Driver Setup rule.

Information on how to use Parent and Child rules can be found at WikiLink.PNG Parent and Child Rules


[edit] Remove Existing Drivers First

After selecting the Driver Setup Rule Left Click the Edit button, the Driver Setup Properties Window will be shown. The image below shows the properties window if it is opened with no drivers placed in the layout.
DriverSetupStartWindow.JPG

DriverSetupRemoveExisting.JPG

Gears.PNG TRS19/Trainz Plus/TRS22 Settings:
BlackDot10x10.png If Checked CheckBox.PNG All existing drivers will be removed so all trains will become "empty" (no drivers). When used with the Generate new Drivers for empty trains option, it will produce a new list of randomly selected drivers for all trains
BlackDot10x10.png If Unchecked CheckBoxOff.PNG All existing drivers will remain with their previously assigned trains
Bug.png T:ANE Known Issues:
DriverSetupRemoveExisting.JPG This does not appear to have any effect in T:ANE


Stop.PNG If your session uses a rule that will expect to find a particular driver in charge of a train (e.g. driver Charlie in the Trigger Check Rule) then manually assign Charlie as the driver of a train and do not select the option Remove all existing Drivers first.


[edit] Generate New Drivers for Empty Trains

DriverSetupGenerateNew.JPG
Gears.PNG Settings:
BlackDot10x10.png If Checked CheckBox.PNG randomly selected drivers will be assigned to all newly added driveable trains. Existing drivers will not be affected unless the Remove all existing Drivers first option has been selected
BlackDot10x10.png If Unchecked CheckBoxOff.PNG then you will have to manually assign drivers to trains by a Left Click on the Add another Driver link
NotePad.PNG Notes:
When using the Driver Setup Rule for the first time with no drivers assigned to existing trains, the Generate new Drivers for empty trains option will immediately assign drivers to each train. Each time a new train is added to the layout, it will be automatically assigned a driver.


[edit] Wait For Schedule Completion

DriverSetupWaitSchedule.png

Gears.PNG Settings:
BlackDot10x10.png If Checked CheckBox.PNG then this Driver Setup Rule will not complete until all Schedule Rules (if any) have been completed
BlackDot10x10.png If Unchecked CheckBoxOff.PNG then this Driver Setup Rule will complete as soon as all its drivers have been assigned locos and commands (if any)


[edit] Focus Camera on First Driver

DriverSetupFocus.png

Gears.PNG Settings:
BlackDot10x10.png If Checked CheckBox.PNG then the Session will start with the camera focussed on the first driver in the list
BlackDot10x10.png If Unchecked CheckBoxOff.PNG then the Session will start with the camera focussed on the scene that last had the camera focus in Surveyor


[edit] Editing the Driver List

 Skip Down Skip Up        

When drivers and trains have been added to the rule, it will appear as shown below.

DriverSetupDriverCommandList.JPG
NotePad.PNG If a loco name appears in red then it has been removed from the layout


Steps: To edit the driver list:-
DotPoint1.JPG Left Click on the driver icon to select a different driver from the Session list
DotPoint2.JPG Left Click on the loco name to select a different loco from the Session list (an empty loco list means no unassigned locos are available)
DotPoint3.JPG Left Click on the driver name to type in a new name for this driver (this will not change the driver icon)
DotPoint4.JPG Left Click on Autodetect to select a new owner for this driver and loco. There are four "owner" options:-
Choose one of the following options:-
Ablue.png AI driver - this train will be under AI control even if it has no Driver Command Bar orders to follow. This can be used to prevent a user from taking control of the train
Bblue.png Autodetect - if the train has Driver Command Bar orders then it will be under AI control. If it has no Driver Command Bar orders then it will be under user control
Cblue.png First Human Player - the train will be assigned to the user or a multiplayer, whoever selects it first
Dblue.png Multiplayer Driver - the train will be assigned to a multiplayer
If you need to remove a driver:-
DotPoint5.JPG Left Click remove to delete this driver from the rule


[edit] Adding Driver Commands

 Skip Down Skip Up        
The grey area below the driver details (name, loco, owner) is the Driver Command Bar. This is where the driving instructions (the "train orders") used by the Trainz AI system are given to the driver.
DriverSetupAddCommand.JPG

Shown below is a Driver Command Bar after two driver commands have been added. Each command has its own icon. Move the mouse pointer onto a command icon to reveal a tooltip showing the contents of the command, as shown in the image.
DriverSetupAddedCommand.JPG

Steps: To add driver commands:-
DotPoint1.JPG Left Click the small "double chevron" icon shown in the image on the left.

AddCommandIconTANE.png T:ANE or AddCommandIcon.png Trains Plus and TRS22

This will open a Command List menu which will show the driver commands that can be added to this drivers Command Bar
DotPoint2.JPG Left Click on a command to add it to the Driver Command Bar
DriverSetupCommandMenu.JPG
NotePad.PNG Notes:
DotPoint.JPG The commands that will be shown and are available for use are decided by another rule, the PageLink.PNG Driver Command Rule. If a command that you want is not in the list then open and edit the Driver Command Rule
DotPoint.JPG Many of the items in the menu will open sub-menus. These are indicated by the > character after the command name. For example:-
RedDot10x10.png The Drive To Trackmark > will open a sub-menu listing all the available trackmarks
RedDot10x10.png The Navigate To > will open a sub-menu of all the interactive industries
RedDot10x10.png The Wait For > will open a sub-menu of different wait times
NotePad.PNG Notes:

When a driver command has been executed in Driver Mode by the Trainz AI system, it will be deleted from the Driver Command Bar and the next command in the sequence will then be executed. This will continue until the last command has been executed and deleted. Then the AI control of the train will terminate.


[edit] Deleting Driver Commands

 Skip Down Skip Up        

To remove a command from the Driver Command Bar...

DriverSetupDeleteCommand.JPG
Steps: To remove a command from the Driver Command Bar:-
DotPoint1.JPG Left Click and Drag the command out of the Driver Command Bar area


[edit] The "Repeat" Command

 Skip Down Skip Up        
BlueDot10x10.png The Repeat command is a special built in Driver Command that allows ALL the driver commands to be repeated endlessly



DriverSetupAddRepeat.JPG
NotePad.PNG Notes:
The Repeat command is only available when at least one command is present in the Driver Command Bar and only one Repeat command can be added


Steps: To add a Repeat command:-
DotPoint1.JPG Left Click the Add Command button (>>) on the Driver Command Bar
DotPoint2.JPG Select the Repeat option
DriverSetupRepeatIcon.JPG
NotePad.PNG Notes:
DotPoint.JPG The Repeat icon will always be placed at the end of the Driver Command Bar after the Add Command button (>>)
DotPoint.JPG As each command is executed by the Trainz AI system, it will be deleted from the front of the command list and added to the end of the list to create an "endless loop" of commands
DriverSetupRemoveRepeat.JPG
NotePad.PNG Notes:
DotPoint.JPG If a Repeat command is already present, then the Add Command menu list will show Don't Repeat as its first option
DotPoint.JPG Select Don't Repeat to remove the Repeat command


Bug.png Known Issues: This is an issue in T:ANE. It has been FIXED in TRS19 and later versions.

If a Repeat command is present in the Driver Command Bar and all the other commands are then deleted, the Repeat command will remain in the Driver Command Bar and cannot be removed. Because there are no other commands to be repeated this will not cause a problem. However when later adding new commands the presence of the Repeat command can be easily overlooked.

Spanner.PNG Workaround:
Add a command (any command) to the Driver Command Bar. The Don't Repeat option will then become available and the Repeat command can be removed.

[edit] Copying the Driver Setup Rule

   Skip Up Top Next Up Next Down Bottom
BlueDot10x10.png The Driver Setup Rule (and other rules) can be copied between Sessions


Steps: To copy the Driver Setup Rule to other sessions:-
DotPoint1.JPG in the Session Editor Right Click on the Driver Setup Rule
DotPoint2.JPG select Copy from the popup menu
DotPoint3.JPG exit the Session
DotPoint4.JPG load the second Session (where the Rule is to be copied to) into Surveyor and open the Session Editor
DotPoint5.JPG Right Click after the last rule entry and select Paste


NotePad.PNG Notes:

There are some conditions that must be met before the copy between session will work:-

DotPoint1Blue.png Drivers, Driver Assignments and Driver Commands ONLY are Copied
Copying the Driver Setup Rule will NOT copy the actual locomotives and consists that the drivers are assigned to. These must be copied or recreated separately
DotPoint2Blue.png No Duplicate Locos Allowed - this is only an issue if you keep both the original and the copied Driver Setup Rule in the Session
If the same loco is present in both Driver Setup Rules then only the first loco (in the top copy of the rule) will be active. The duplicate loco in the second copy of the rule will be ignored
DotPoint3Blue.png Missing Locos will be Ignored

If a loco is listed in the copied Driver Setup Rule but does not exist in the new Session because it was not copied across then it will be ignored


[edit] Driver Command Rule

     Top Next Up   Bottom
BlueDot10x10.png The WikiLink.PNG Driver Command Rule controls which Driver Commands will be available to a user. This applies to both:-
BlueDot10x10.png commands added to the PageLink.PNG Driver Setup Rule in the WikiLink.PNG Session Editor in Surveyor, and
BlueDot10x10.png commands for the user to manually add to the Driver Command Bar of user and AI controlled trains running in Driver


The WikiLink.PNG Driver Command Rule is automatically added to the Session Editor of every Session.

EditSessionWindow.JPG
Steps: To edit the Driver Command Rule:-
DotPoint1.JPG Select (Left Click) the Driver Command Rule shown left (it is usually near the top of the list)
DotPoint2.JPG Left Click the  Edit  button at the bottom of the Session Editor window


Stop.PNG If the Driver Command Rule is not shown in the list then...
Steps: To add the Driver Command Rule:-
DotPoint1.JPG Left Click the  Add  button at the bottom of the Session Editor window
DotPoint2.JPG Scroll through the list of rules to locate and select the Driver Command Rule
DotPoint3.JPG Left Click the Tick.PNG icon on the rule list window
This will add the rule to the Session Editor.


The Rule properties window will open to show all the Driver Commands that have been installed in Trainz on your system. This list includes the commands that are built in and those that have been downloaded from the DLS.


DriverCommandAddCommand.JPG
Gears.PNG Settings:
BlackDot10x10.png Commands that are CheckBox.PNG Checked ON will be available in the Driver Setup Rule Command List in the Session Editor and for the user in Driver
BlackDot10x10.png Commands that are CheckBoxOff.PNG Checked OFF will NOT be available in the Driver Setup Rule Command List in the Session Editor and for the user in Driver
BlackDot10x10.png To change the status of a command simply check it ON or OFF


PencilTips.PNG Removing Driver Commands such as Navigate and Drive will force players to manually drive trains when in Driver instead of allowing them to use the AI system to do all the work


NotePad.PNG Notes:
DotPoint.JPG If a command that you want to use does not appear in the list, then check in Content Manager that it has been installed and is free of errors
DotPoint.JPG In T:ANE some Driver Commands that have been checked ON will not appear in the Driver Command Bar if there is no target for their action. For example, no set trackmarks or interactive industries for the Drive To command


      Top Next Up    

[edit] Trainz Wiki

TrainzWiki.png

More Tutorials and Guides to Using Trainz
LinkWiki.PNG

Related Links

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

Retrieved from "https://game.ts2009.com/mediaWiki/index.php?title=How_to_Use_Driver_Setup_Rule&oldid=39367"
Personal tools