Revision as of 10:14, 24 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 path for the train that had been set by the IT SetPath Command

<kuid2:61392:8114:54> IT CancelEnhancedPath

DLS Command by pguy

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:

IT SetPath - sets an active path

Trainz Wiki Links:

Interlocking Tower Enhanced Manager Rule

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

DLS Command by pguy

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:

IT CancelEnhancedPath - cancels an active EIT path

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

DLS Command by pguy

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:

IT CancelEnhancedPath - cancels an active EIT path
IT SetPath - sets an active IT or EIT path
IT SetPathAndWaitActive - sets an active IT or EIT path and waits until it is active
IT SetPathAndWaitNotRed - sets an active IT or EIT path and waits until the signal ahead is not red

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

DLS Command by pguy

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:

IT CancelEnhancedPath - cancels an active EIT path
IT SetPath - sets an active IT or EIT path
IT SetPathAndWaitActive - sets an active IT or EIT path and waits until it is active

Trainz Wiki Links:

Back to Top

Load and Unload Commands

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.

<kuid:-3:10076> Load

Base Command

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.

<kuid:-3:10077> Unload

Base Command

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

Movement Commands

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

DLS Command by erendir

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

Base Command

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

DLS Command by nikkia

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) - set the maximum speed in km/h

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)

DLS Command by nikkia

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:

Set Max Speed To - set the maximum speed in mph

WaitFor

Instructs the AI driver to wait for a set time period before executing the next instruction in the command list.

<kuid:-3:10090> WaitFor

Base Command

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

Navigation Commands

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.

<kuid:-3:11058> Drive To

Base Command

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:

Navigate To - will seek alternative paths if blocked

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

Base Command

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:

Navigate To Trackmark - will seek alternative paths if blocked

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

Base Command

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 Via Trackmark - will seek alternative paths if blocked

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

Base Command

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

Base Command

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:

Drive To Trackmark - does not seek alternative paths if blocked

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

Base Command

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:

Drive Via Trackmark - does not seek alternative paths if blocked

Back to Top

Session Management

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

Signals

Set Signal Ahead

Sets the state of the next signal ahead.

<kuid2:368725:60003:6> Set Signal Ahead

DLS Command by elstoko

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

Train Operations

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.

<kuid:-3:10081> Couple

Base Command

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.

<kuid:-3:10082> Decouple

Base Command

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 Number #, Decouple DLX, Uncouplez or UncouplezFrom

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.

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

DLS Command by trev999

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

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:

InputTable Rule

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

Base Command

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

@@ Line 123: / Line 123: @@
 [[file:PageLink.PNG]] '''<u>Related Commands:</u>'''
 *'''[[#IT CancelEnhancedPath|IT CancelEnhancedPath]]''' - cancels an active EIT path
+*'''[[#IT SetPath|IT SetPath]]''' - sets an active IT or EIT path
+*'''[[#IT SetPathAndWaitActive|IT SetPathAndWaitActive]]''' - sets an active IT or EIT path and waits until it is active
+*'''[[#IT SetPathAndWaitNotRed|IT SetPathAndWaitNotRed]]''' - sets an active IT or EIT path and waits until the signal ahead is not red
 [[file:WikiLink.PNG]] '''<u>Trainz Wiki Links:</u>'''

Driver Commands List

Revision as of 10:14, 24 November 2018

Contents

Interlocking Tower Commands

IT CancelEnhancedPath

IT SetPath

IT SetPathAndWaitActive

IT SetPathAndWaitNotRed

Load and Unload Commands

Instant Load Command

InstantLoadLocos

InstantUnLoad

Load

Load At

Unload

Movement Commands

AI Wait Until Green Signal

Change Train Direction

Halt Train

Set Max Speed To

Set Max Speed To (km/h)

WaitFor

WaitForTrigger

Navigation Commands

Drive To

Drive To Trackmark

Drive Via Trackmark

Navigate To

Navigate To Trackmark

Navigate Via Trackmark

Session Management

Delete Train

Signals

Set Signal Ahead

Train Operations

Bellz

Couple

Decouple

Decouple Number #

Decouple DLX

Hornz

MoveTurntable

Priorityz

Run Around

Uncouplez

UncouplezFrom

Views

Personal tools

Navigation

Search

Toolbox