|
|
Line 771: |
Line 771: |
| | | |
| [[file:Notes.PNG]] '''<u>Notes:</u>''' | | [[file:Notes.PNG]] '''<u>Notes:</u>''' |
− | :If programming a driver via the '''Driver Setup Rule''', use the alternative commands '''Decouple Number #''', '''Decouple DLX''', '''Uncouplez''' or '''UncouplezFrom''' | + | :If programming a driver via the '''Driver Setup Rule''', use the alternative commands '''Decouple DLX''', '''Decouple Number #''', '''Uncouplez''' or '''UncouplezFrom''' |
− | | + | |
− | =='''Decouple Number #'''==
| + | |
− | | + | |
− | <table>
| + | |
− | <tr valign="top">
| + | |
− | <td>[[file:CMD_DecoupleNumber.png|50px]]</td>
| + | |
− | <td>The specified wagon number (#) and any following wagons will be uncoupled from the locomotive and consist.</td>
| + | |
− | </tr>
| + | |
− | </table>
| + | |
− | | + | |
− | *'''<kuid2:147570:80008:1> Decouple number #'''
| + | |
− | | + | |
− | *'''Built-in Command''' by '''erniesouchak'''
| + | |
− | | + | |
− | [[file:Properties.PNG]] '''<u>Command Properties:</u>'''
| + | |
− | | + | |
− | '''''<number>''''' - select a wagon number (1-40) to decouple from.
| + | |
− | | + | |
− | [[file:Notes.PNG]] '''<u>Notes:</u>'''
| + | |
− | :The first locomotive is #1, the second locomotive (if any) or the tender (on a steam locomotive) is #2, etc.
| + | |
| | | |
| =='''Decouple DLX'''== | | =='''Decouple DLX'''== |
Line 825: |
Line 805: |
| '''''<consist_count>''''' - requires the use of the '''special_instruction''' driver command | | '''''<consist_count>''''' - requires the use of the '''special_instruction''' driver command |
| '''''<a random number>''''' - a random number upto and including the last wagon in the consist | | '''''<a random number>''''' - a random number upto and including the last wagon in the consist |
| + | |
| + | =='''Decouple Number #'''== |
| + | |
| + | <table> |
| + | <tr valign="top"> |
| + | <td>[[file:CMD_DecoupleNumber.png|50px]]</td> |
| + | <td>The specified wagon number (#) and any following wagons will be uncoupled from the locomotive and consist.</td> |
| + | </tr> |
| + | </table> |
| + | |
| + | *'''<kuid2:147570:80008:1> Decouple number #''' |
| + | |
| + | *'''Built-in Command''' by '''erniesouchak''' |
| + | |
| + | [[file:Properties.PNG]] '''<u>Command Properties:</u>''' |
| + | |
| + | '''''<number>''''' - select a wagon number (1-40) to decouple from. |
| + | |
| + | [[file:Notes.PNG]] '''<u>Notes:</u>''' |
| + | :The first locomotive is #1, the second locomotive (if any) or the tender (on a steam locomotive) is #2, etc. |
| | | |
| =='''Hornz'''== | | =='''Hornz'''== |
Revision as of 07:16, 25 November 2018
This document is a work in progress |
TRAINZ A New Era (TANE) SP3. List of Trainz Driver Commands. All commands are the Copyright of N3V Games
This page is always under construction. As new commands appear they will be added to this list.
Only commands supplied with TANE or on the DLS are covered in this document.
This document will be modified (or a separate document created) for TRS19 after it is officially released (the current release is a beta version).
The driver commands listed in this page are all found in Trainz Surveyor from the Edit Session option in the Main Menu and are accessed by the Driver Command Rule and the Driver Setup Rule.
See the Trainz Wiki Page How to Use the Driver Setup Rule for more information on both rules.
Those commands that are identified as a DLS Command must be downloaded and installed from the Trainz DLS first. |
Description Key:
- <kuid number> is for the command version at the time of writing. This number will change if the command is updated.
- DLS Command must be downloaded and installed from the DLS.
- Base Command and Built-in Command are installed with TANE.
- Obsolete Command is no longer required (explanation given).
- Legacy Command has been replaced by another command (new command will be identified).
Interlocking Tower Commands
|
IT CancelEnhancedPath
|
Cancels an active Enhanced Interlocking Tower (EIT) path for the train that had been set by the IT SetPath Command |
- <kuid2:61392:8114:54> IT CancelEnhancedPath
Command Properties:
<Select EIT> - select from list of session EITs
<Select Path> - select the active path from that EIT
Notes:
- The active path must be created using the Interlocking Tower Enhanced Manager Rule (SP2 and later)
- Cancelling a path makes it available for other consists and allows conflicting paths to be made active
- An active path is automatically cancelled after it has been completed by a train
Related Commands:
Trainz Wiki Links:
IT SetPath
|
Selects and sets a path for the train from those available from Interlocking Towers (ITs) and Enhanced Interlocking Towers (EITs). If this path was created by an EIT it can be cancelled prior to its use by the IT CancelEnhancedPath Command |
- <kuid2:61392:8111:54> IT SetPath
Command Properties:
<Select IT or EIT> - select from list of session ITs and/or EITs
<Select Path> - select from available paths for that IT/EIT
Notes:
- The paths must be created using the Interlocking Tower Set Path Rule or the Interlocking Tower Enhanced Manager Rule (SP2 and later)
- An active path is automatically cancelled after it has been completed by a train
Related Commands:
Trainz Wiki Links:
IT SetPathAndWaitActive
|
Selects and sets a path for the train from those available from Interlocking Towers (ITs) and Enhanced Interlocking Towers (EITs) and waits until the path becomes active. If this path was created by an EIT it can be cancelled prior to its use by the IT CancelEnhancedPath Command |
- <kuid2:61392:8113:54> IT SetPathAndWaitActive
Command Properties:
<Select IT or EIT> - select from list of session ITs and/or EITs
<Select Path> - select from available paths for that IT/EIT
Notes:
- The paths must be created using the Interlocking Tower Set Path Rule or the Interlocking Tower Enhanced Manager Rule (SP2 and later)
- An active path is automatically cancelled after it has been completed by a train
Related Commands:
Trainz Wiki Links:
IT SetPathAndWaitNotRed
|
Selects and sets a path for the train from those available from Interlocking Towers (ITs) and Enhanced Interlocking Towers (EITs) and waits until the next signal is not showing red. If this path was created by an EIT it can be cancelled prior to its use by the IT CancelEnhancedPath Command |
- <kuid2:61392:8112:54> IT SetPathAndWaitNotRed
Command Properties:
<Select IT or EIT> - select from list of session ITs and/or EITs
<Select Path> - select from available paths for that IT/EIT
Notes:
- The paths must be created using the Interlocking Tower Set Path Rule or the Interlocking Tower Enhanced Manager Rule (SP2 and later)
- An active path is automatically cancelled after it has been completed by a train
Related Commands:
Trainz Wiki Links:
Back to Top
Instant Load Command
|
Instantly loads all rolling stock (except locos and tenders) in the train with the item(s) in their commodity queues. |
- <kuid2:45324:555017:7> Instant Load Command
- DLS Command by norfolksouthern37
Command Properties:
None
InstantLoadLocos
|
Instantly loads all locos and tenders in the train with the item(s) in their commodity queues (coal, water, diesel fuel). |
- <kuid2:117290:1022:1> InstantLoadLocos
- Builtin Command by nzhorse
Command Properties:
None
InstantUnLoad
|
Instantly unloads the commodities in all rolling stock (except locos and tenders) in the train. |
- <kuid2:67585:1021:2> InstantUnload
- DLS Command by robin_hoods
Command Properties:
None
Load
|
Instructs the AI driver to load the commodity or commodities waiting at an industry enabled asset into the rolling stock assets that have been configured to receive them. This may involve the AI driver moving the train forward a few wagons at a time until the entire length of the train has passed through the loading area. The Load command is also used for loading (and unloading) passengers at passenger enabled stations. |
Command Properties:
None
Notes:
- If the industry where the loading is taking place uses up all the available commodities before all the wagons are fully loaded, then any following wagons will not be loaded until the commodity is available again but the AI driver will not stop to wait.
- With passenger enabled stations the Load command will first execute an Unload command to unload some of the passengers.
Load At
|
Combines the Drive To and Load commands. Instructs the AI driver to drive to an industry (or passenger enabled station) and load the commodity or commodities waiting there into the rolling stock assets that have been configured to receive them. This may involve the AI driver moving the train forward a few wagons at a time until the entire length of the train has passed through the loading area. The Load At command is also used for loading (and unloading) passengers at passenger enabled stations. All signals and speed signs are obeyed during the "Drive To" operation. |
- <kuid2:75377:84:1> Load At
- DLS Command by stagecoach
Command Properties:
Select <name of industry> or industry enabled passenger station from session list
if applicable <name/number of track or platform> for industries and stations that have identified active platforms, tracks or loading bays
Notes:
- The AI driver will select the shortest available path to the destination.
- If the AI driver is blocked (e.g. by another train, a locked signal or switch) it will not attempt to find an alternative path to the destination. This can lead to the train stopping and waiting indefinately until the blockage is removed.
- If the industry where the loading is taking place uses up all the available commodities before all the wagons are fully loaded, then any following wagons will not be loaded until the commodity is available again but the AI driver will not stop to wait.
- With passenger enabled stations the Load command will first execute an Unload command to unload some of the passengers.
Related Commands:
- Drive To - drives to an industry but does not seek alternative paths if blocked
- Load - loads commodities at an industry (including a station)
Unload
|
Instructs the AI driver to unload the commodity or commodities loaded in rolling stock assets to the industry enabled asset if it has been configured and is able to receive them. This may involve the AI driver moving the train forward a few wagons at a time until the entire length of the train has passed through the loading area. The Unload command is also used for unloading passengers at passenger enabled stations. |
Command Properties:
None
Notes:
- If the industry where the unloading is taking place reaches its maximum capacity before all the wagons are fully unloaded, then any following wagons will not be unloaded until capacity is available again but the AI driver will not stop to wait.
- With passenger enabled stations the Unload command will unload a set number of passengers, specifically:-
- Terminal stations = 100% of loaded passengers
- Large stations = 50%
- Standard stations = 25%
- Small stations = 10%
- The station size is set in the station properties
Back to Top
AI Wait Until Green Signal
|
Instructs the AI driver to wait for a green signal ahead before executing the next driver command. The interface for this driver command is in Russian. |
- <kuid2:151055:100101:3> AI Wait until green signal
Command Properties:
Ждать, пока не будет зелёный > - Trans: "Wait until it is green >" - select to wait for the next signal to show green
На любом светофоре - Trans: "At any traffic light" - select for the next signal up to 3000m ahead
Только на станционном зале " Z7 " /Су - Trans: "Only at the station hall " Z7 " / su" - unknown meaning
Change Train Direction
|
Reverses the driving direction of the train. |
- <kuid2:70791:9001:1> Change Train Direction
- Builtin Command by mgalling
Command Properties:
None
Halt Train
|
Brings the train to an immediate stop. |
- <kuid:401543:1090> Halt Train
Command Properties:
None
Set Max Speed To
|
Instructs the AI driver to drive up to the set maximum speed (mph). This speed limit has no effect on other AI trains. Lower speed limit signs are obeyed. |
- <kuid2:450022:90001:2> Set Max Speed To
Command Properties:
Select <No maximum speed> or <value> in mph
Notes:
- The maximum speed, once set, will remain in place throughout the session unless cancelled or reset by another Set Max Speed To command.
Related Commands:
Set Max Speed To (km/h)
|
Instructs the AI driver to drive up to the set maximum speed (km/h). This speed limit has no effect on other AI trains. Lower speed limit signs are obeyed. |
- <kuid:450022:90002> Set Max Speed To (km/h)
Command Properties:
Select <No maximum speed> or <value> in km/h
Notes:
- The maximum speed, once set, will remain in place throughout the session unless cancelled or reset by another Set Max Speed To command.
Related Commands:
WaitFor
|
Instructs the AI driver to wait for a set time period before executing the next instruction in the command list. |
Command Properties:
Select <time delay> from list
Notes:
- There are a limited range of available times from 5 seconds to 1 hour. A time delay that is not in this list (e.g. 3 minutes) can be achieved by using two (or more) WaitFor commands with the combined total of their times equaling the required time delay.
WaitForTrigger
|
Instructs the AI driver to wait for a trigger event before executing the next instruction in the command list. |
- <kuid2:57344:80001:5> WaitFor
- Built-in Command by marinus
Command Properties:
Select <trigger name> from session list
Select <any train> or locomotive from <list of locomotive names>
Back to Top
Autopilot Command
|
Instructs the AI driver to drive but the AI will not set any junction switches so the train will follow whatever path is set ahead of it. All signals and speed signs are obeyed. |
- <kuid2:71155:60001:5> Autopilot Command
Command Properties:
Select one of
<activate> - starts the Autopilot Command. This will only terminate when the Autopilot Command is removed from the driver command line
<stop at track mark> - select a trackmark from the session list. Starts the Autopilot Command and drives until the train reaches the selected trackmark (see Notes below)
Notes:
- It is the users responsibility to set all junction switches ahead of the train
- If the Stop at track mark option is used then:-
- the train will not set a path to the track mark, that is the users responsibility
- the train will run at the full posted line speed upto the track mark and then it will slow to a stop
- if the track mark is never reached because the correct path has not been set, the train will continue as it would for the activate option
Drive To
|
Instructs the AI driver to Drive, via the shortest available path, to the designated Industry (including Passenger Stations). Switches ahead of the train that are not locked against the AI will be set to allow the train to proceed and reset after the train has cleared the switch. The AI driver will NOT attempt to find a way around blockages when calculating the shortest path to the industry. All signals and speed signs are obeyed. |
Command Properties:
Select <name of industry> or industry enabled passenger station from session list
if applicable <name/number of track or platform> for industries and stations that have identified active platforms, tracks or loading bays
Notes:
- If the AI driver is blocked (e.g. by another train, a locked signal or switch) it will not attempt to find an alternative path to the destination. This can lead to the train stopping and waiting indefinately until the blockage is removed.
Related Commands:
Drive To Trackmark
|
Instructs the AI driver to Drive, via the shortest available path, to the designated Trackmark. Switches ahead of the train that are not locked against the AI will be set to allow the train to proceed and reset after the train has cleared the switch. The AI driver will NOT attempt to find a way around blockages when calculating the shortest path to the trackmark. All signals and speed signs are obeyed. |
- <kuid:-3:11149> Drive To Trackmark
Command Properties:
Select <name of trackmark> from session list
Notes:
- If the AI driver is blocked (e.g. by another train, a locked signal or switch) it will not attempt to find an alternative path to the destination. This can lead to the train stopping and waiting indefinately until the blockage is removed.
Related Commands:
Drive Via Trackmark
|
Instructs the AI driver to Drive, via the shortest available path, to and through the designated Trackmark. If there are no further commands then the AI will halt after passing the trackmark. Switches ahead of the train that are not locked against the AI will be set to allow the train to proceed and reset after the train has cleared the switch. The AI driver will NOT attempt to find a way around blockages when calculating the shortest path to the trackmark. All signals and speed signs are obeyed. |
- <kuid:-3:11209> Drive Via Trackmark
Command Properties:
Select <name of trackmark> from session list
Notes:
- This command is used to direct the AI along a set route to a final destination which is not normally the trackmark identified in this command.
- If the AI driver is blocked (e.g. by another train, a locked signal or switch) it will not attempt to find an alternative path to the designated trackmark. This can lead to the train stopping and waiting indefinately until the blockage is removed.
Related Commands:
Navigate To
|
Instructs the AI driver to Navigate, via the shortest available path, to the designated Industry (including Passenger Station). Switches ahead of the train that are not locked against the AI will be set to allow the train to proceed and reset after the train has cleared the switch. The AI driver will attempt to find a way around blockages when calculating the shortest path to the industry. All signals and speed signs are obeyed. |
- <kuid:-3:10058> Navigate To
Command Properties:
Select <name of industry> or industry enabled passenger station from session list
if applicable <name/number of track or platform> for industries and stations that have identified active platforms, tracks or loading bays
Notes:
- If the AI driver is blocked (e.g. by another train, a locked signal or switch) it will attempt to find an alternative path to the destination. This can lead to the train traveling backwards and down the wrong track.
Related Commands:
- Drive To - does not seek alternative paths if blocked
Navigate To Trackmark
|
Instructs the AI driver to Navigate, via the shortest available path, to the designated Trackmark. Switches ahead of the train that are not locked against the AI will be set to allow the train to proceed and reset after the train has cleared the switch. The AI driver will attempt to find a way around blockages when calculating the shortest path to the trackmark. All signals and speed signs are obeyed. |
- <kuid:-3:10149> Navigate To Trackmark
Command Properties:
Select <name of trackmark> from session list
Notes:
- If the AI driver is blocked (e.g. by another train, a locked signal or switch) it will attempt to find an alternative path to the destination. This can lead to the train traveling backwards and down the wrong track.
Related Commands:
Navigate Via Trackmark
|
Instructs the AI driver to Drive, via the shortest available path, to and through the designated Trackmark. If there are no further commands then the AI will halt after passing the trackmark. Switches ahead of the train that are not locked against the AI will be set to allow the train to proceed and reset after the train has cleared the switch. The AI driver will attempt to find a way around blockages when calculating the shortest path to the trackmark. All signals and speed signs are obeyed. |
- <kuid:-3:10209> Navigate Via Trackmark
Command Properties:
Select <name of trackmark> from session list
Notes:
- This command is used to direct the AI along a set route to a final destination which is not normally the trackmark identified in this command.
- If the AI driver is blocked (e.g. by another train, a locked signal or switch) it will attempt to find an alternative path to the designated trackmark. This can lead to the train traveling backwards and down the wrong track.
Related Commands:
Back to Top
Delete Train
|
Deletes the train from the session. |
- <kuid2:116387:15:3> Delete Train
- Built-in Command by maggs
Command Properties:
None
Back to Top
Set Signal Ahead
|
Sets the state of the next signal ahead. |
- <kuid2:368725:60003:6> Set Signal Ahead
Command Properties:
<Set next signal to> - select one from
<Stop>
<Caution Straight>
<Caution Left>
<Caution Right>
<Proceed Straight>
<Proceed Left>
<Proceed Right>
<Advance Caution>
<Call on 1 (State 9)>
<Call on 2 (State 10)>
<Automatic>
Notes:
- This command only works on signals that will respond to the function "SetSignalStateEx", not all signals will respond.
- The signal must support the selected state otherwise there will be no change
- The signal will be reset after the train has cleared the signal
Back to Top
Bellz
|
Rings the train bell. |
- <kuid2:66277:80002:1> bellz
- Built-in Command by smileyman
Command Properties:
None
Notes:
- the locomotive must be equipped with a working bell.
Related Commands:
- Hornz - gives a blast of the horn (or whistle)
Couple
|
The AI driver moves the train (or just the locomotive if it is by itself) to couple with the specified wagon. |
Command Properties:
<list of available wagons> - select a wagon to couple to
Notes:
- The target wagon must be at the end of a consist or by itself. If the target is coupled in between other wagons then no coupling will take place.
- There must be a clear path to the target wagon.
Decouple
|
The train is decoupled at the specified wagon. |
Command Properties:
<list of available wagons> - select a wagon to decouple from
Known Bugs:
- This command does not work when added to a driver's command list in the Driver Setup Rule in Surveyor
- It does work when added to the driver's command list in Driver
Notes:
- If programming a driver via the Driver Setup Rule, use the alternative commands Decouple DLX, Decouple Number #, Uncouplez or UncouplezFrom
Decouple DLX
|
The train is decoupled at the specified wagon identified by name or number (upto 99 wagons), or at a random location. |
- <kuid2:160293:100120:2> Decouple DLX
Command Properties:
When Used in Surveyor using the Driver Setup Rule
<1-33> - select a wagon numbered 1 to 33 where 1 is the wagon (or tender) immediately following the locomotive
<34-66> - select a wagon from 34 to 66
<67-99> - select a wagon from 67 to 99
<at position determined by>
<consist_count> - requires the use of the special_instruction driver command
<a random number> - a random number upto and including the last wagon in the consist
When used in Driver Mode
<1-33> - each wagon is numbered and named. Select a wagon numbered 1 to 33 (or to the last wagon in that range)
where 1 is the wagon (or tender) immediately following the locomotive
If there are more than 33 wagons, then
<34-66> - each wagon is numbered and named. Select a wagon from 34 to 66 (or to the last wagon in that range)
if there are more than 66 wagons, then
<67-99> - each wagon is numbered and named. Select a wagon from 67 to 99 (or to the last wagon in that range)
<at position determined by>
<consist_count> - requires the use of the special_instruction driver command
<a random number> - a random number upto and including the last wagon in the consist
Decouple Number #
|
The specified wagon number (#) and any following wagons will be uncoupled from the locomotive and consist. |
- <kuid2:147570:80008:1> Decouple number #
- Built-in Command by erniesouchak
Command Properties:
<number> - select a wagon number (1-40) to decouple from.
Notes:
- The first locomotive is #1, the second locomotive (if any) or the tender (on a steam locomotive) is #2, etc.
Hornz
|
Gives one blast of the train horn or whistle. |
- <kuid2:66277:80001:2> Hornz
- Built-in Command by smileyman
Command Properties:
None
Related Commands:
- Bellz - rings the locomotive bell (if it has one)
MoveTurntable
|
Moves the specified turntable to the specified track position. |
- <kuid2:609850:100018:1> MoveTurntable
- Built-in Command by vandragonax
Command Properties:
<name of turntable> - select the named turntable (see Notes below).
<track #> or <relative track movement> - select the track number (0 = 1st track) or a relative movement (prev, next)
Notes:
- The InputTable Rule must be installed in the session before this command can be used. This rule must be configured to identify all the turntables and the number of tracks they have.
Trainz Wiki Links:
Priorityz
|
Sets the train priority value. |
- <kuid2:66277:80003:1> priorityz
- Built-in Command by smileyman
Command Properties:
<value> - select train priority value 1, 2 or 3
Notes:
- The Priority value identifies the importance of the train for the Priority Trackmarkers. Usually (a guide only):-
- Priority 1 = Express trains
- Priority 2 = Local Expresses or Fast Freights
- Priority 3 = Slow Local Freights or All Stops Services
Run Around
|
Uncouples the locomotive (plus tender if present) from the train, navigates to the other end of the train and couples to the last wagon. |
- <kuid:-3:10083> Run Around
Command Properties:
None
Notes:
- There must be a path for the locomotive to follow from one end of the train to the other.
- The locomotive must have sufficient clear space, free of track switches and signals, at both ends of the train to perform this movement.
Uncouplez
|
Uncouples the locomotive (plus tender if present) from the train. |
- <kuid2:66277:80000:1> UnCouplez
- Built-in Command by smileyman
Command Properties:
None
UncouplezFrom
|
Uncouples the train at the wagon specified. |
- <kuid2:66277:80005:2> UnCouplezFrom
- Built-in Command by smileyman
Command Properties:
<number> - select a wagon number (0-20) to decouple from.
Notes:
- The first wagon after the locomotive (or the locomotive and tender) is #0, the second wagon is #1, etc.
Back to Top