Driver Commands List

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. 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).

---

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

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:

1. 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.
2. 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. 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:

1. The AI driver will select the shortest available path to the destination.
2. 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.
3. 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.
4. With passenger enabled stations the Load command will first execute an Unload command to unload some of the passengers.

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:

1. 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.
2. 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%

Station size is set in the station properties

Back to Top

Movement Commands

Change Train Direction

Reverses the driving direction of the train.

• <kuid2:70791:9001:1> Change Train Direction

• Base Command

Command Properties:

None

Halt Train

Brings the train to an immediate stop.

• <kuid:401543:1090> Halt Train

• Base Command

Command Properties:

None

Set Maximum 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.

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 loco from <list of loco 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.

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.

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.

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.

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.

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: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 attempt to find an alternative path to the destination. This can lead to the train traveling backwards and down the wrong track.

Back to Top

---