Driver Commands List

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
m (=Navigate To)
m (Load At)
Line 136: Line 136:
 
#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.
 
#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.
 
#With passenger enabled stations the '''Load''' command will first execute an '''Unload''' command to unload some of the passengers.
 +
 +
[[file:PageLink.PNG]] '''<u>Related Commands:</u>'''
 +
*'''[[#Drive To|Drive To]]''' - drives to an industry but does not seek alternative paths if blocked
 +
*'''[[#Load|Load]]''' - loads commodities at an industry (including a station)
  
 
=='''Unload'''==
 
=='''Unload'''==

Revision as of 19:11, 21 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 WikiLink.PNG Driver Command Rule and the WikiLink.PNG Driver Setup Rule.

See the Trainz Wiki Page WikiLink.PNG 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).

Contents

Load and Unload Commands

Instant Load Command

CMD InstantLoad.png 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

Properties.PNG Command Properties:

None

InstantLoadLocos

CMD InstantLoadLocos.png 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

Properties.PNG Command Properties:

None

InstantUnLoad

CMD InstantUnLoad.png 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

Properties.PNG Command Properties:

None

Load

CMD Load.png 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

Properties.PNG Command Properties:

None

Notes.PNG 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

CMD IndustryIcon.png 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

Properties.PNG 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.PNG 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.

PageLink.PNG 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

CMD Unload.png 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

Properties.PNG Command Properties:

None

Notes.PNG 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%
The station size is set in the station properties

Back to Top

Movement Commands

Change Train Direction

CMD ChangeDirection.png Reverses the driving direction of the train.
  • <kuid2:70791:9001:1> Change Train Direction
  • Builtin Command by mgalling

Properties.PNG Command Properties:

None

Halt Train

CMD HaltTrain.png Brings the train to an immediate stop.
  • <kuid:401543:1090> Halt Train
  • Base Command

Properties.PNG Command Properties:

None

Set Max Speed To

CMD MaxSpeed.png 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

Properties.PNG Command Properties:

Select <No maximum speed> or <value> in mph

Notes.PNG Notes:

The maximum speed, once set, will remain in place throughout the session unless cancelled or reset by another Set Max Speed To command.

PageLink.PNG Related Commands:

Set Max Speed To (km/h)

CMD MaxSpeed.png 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

Properties.PNG Command Properties:

Select <No maximum speed> or <value> in km/h

Notes.PNG Notes:

The maximum speed, once set, will remain in place throughout the session unless cancelled or reset by another Set Max Speed To command.

PageLink.PNG Related Commands:

WaitFor

CMD WaitFor.png 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

Properties.PNG Command Properties:

Select <time delay> from list

Notes.PNG 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

CMD WaitForTrigger.png 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

Properties.PNG 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

CMD IndustryIcon.png 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

Properties.PNG 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.PNG 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.

PageLink.PNG Related Commands:

Drive To Trackmark

CMD NavigateTo.png 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

Properties.PNG Command Properties:

Select <name of trackmark> from session list

Notes.PNG 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.

PageLink.PNG Related Commands:

Drive Via Trackmark

CMD NavigateTo.png 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

Properties.PNG Command Properties:

Select <name of trackmark> from session list

Notes.PNG Notes:

  1. 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.
  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 designated trackmark. This can lead to the train stopping and waiting indefinately until the blockage is removed.

PageLink.PNG Related Commands:

Navigate To

CMD IndustryIcon.png 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

Properties.PNG 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.PNG 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.

PageLink.PNG Related Commands:

  • Drive To - does not seek alternative paths if blocked

Navigate To Trackmark

CMD NavigateTo.png 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

Properties.PNG Command Properties:

Select <name of trackmark> from session list

Notes.PNG 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.

PageLink.PNG Related Commands:

Navigate Via Trackmark

CMD NavigateTo.png 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

Properties.PNG Command Properties:

Select <name of trackmark> from session list

Notes.PNG Notes:

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

PageLink.PNG Related Commands:

Back to Top

Session Management

Delete Train

CMD DeleteTrain.png Deletes the train from the session.
  • <kuid2:116387:15:3> Delete Train
  • Built-in Command by maggs

Properties.PNG Command Properties:

None

Back to Top

Train Operations

Bellz

CMD Bellz.png Rings the train bell.
  • <kuid2:66277:80002:1> bellz
  • Built-in Command by smileyman

Properties.PNG Command Properties:

None

Notes.PNG Notes:

the locomotive must be equipped with a working bell.

PageLink.PNG Related Commands:

  • Hornz - gives a blast of the horn (or whistle)

Couple

CMD Couple.png 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

Properties.PNG Command Properties:

  <list of available wagons> - select a wagon to couple to
  

Notes.PNG Notes:

  1. 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.
  2. There must be a clear path to the target wagon.

Decouple

CMD Decouple.png The train is decoupled at the specified wagon.
  • <kuid:-3:10082> Decouple
  • Base Command

Properties.PNG Command Properties:

  <list of available wagons> - select a wagon to decouple from

BugMini.PNG Known Bugs:

  1. This command does not work when added to a driver's command list in the Driver Setup Rule in Surveyor
  2. It does work when added to the driver's command list in Driver

Notes.PNG Notes:

If programming a driver via the Driver Setup Rule, use the alternative commands Decouple Number #, Uncouplez or UncouplezFrom

Decouple Number #

CMD DecoupleNumber.png 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

Properties.PNG Command Properties:

  <number> - select a wagon number (1-40) to decouple from.

Notes.PNG Notes:

The first locomotive is #1, the second locomotive (if any) or the tender (on a steam locomotive) is #2, etc.

Hornz

CMD Hornz.png Gives one blast of the train horn or whistle.
  • <kuid2:66277:80001:2> Hornz
  • Built-in Command by smileyman

Properties.PNG Command Properties:

None

PageLink.PNG Related Commands:

  • Bellz - rings the locomotive bell (if it has one)

MoveTurntable

CMD MoveTurntable.png Moves the specified turntable to the specified track position.
  • <kuid2:609850:100018:1> MoveTurntable
  • Built-in Command by vandragonax

Properties.PNG 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.PNG Notes:

The InputTable Rule must be installed in the session before this command can be used. This rule will identify all the turntables and the number of tracks they have.

WikiLink.PNG Trainz Wiki Links:

Priorityz

CMD Priorityz.png Sets the train priority value.
  • <kuid2:66277:80003:1> priorityz
  • Built-in Command by smileyman

Properties.PNG Command Properties:

<value> - select train priority value 1, 2 or 3

Run Around

CMD RunAround.png 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

Properties.PNG Command Properties:

None

Notes.PNG Notes:

  1. There must be a path for the locomotive to follow from one end of the train to the other.
  2. The locomotive must have sufficient clear space, free of track switches and signals, at both end of the train to perform this movement.

Uncouplez

CMD Uncouplez.png Uncouples the locomotive (plus tender if present) from the train.
  • <kuid2:66277:80000:1> UnCouplez
  • Built-in Command by smileyman

Properties.PNG Command Properties:

None

UncouplezFrom

CMD Uncouplez.png Uncouples the train at the wagon specified.
  • <kuid2:66277:80005:2> UnCouplezFrom
  • Built-in Command by smileyman

Properties.PNG Command Properties:

  <number> - select a wagon number (0-20) to decouple from.

Notes.PNG Notes:

The first wagon after the locomotive (or the locomotive and tender) is #0, the second wagon is #1, etc.

Back to Top


Personal tools