Skip to content

Actions

An action is the component that actually changes something on your layout. Actions are always located inside a section.

Execute conditions

Just like scripts and sections, every action can be conditional. You can configure whether all (AND) or only one (OR) condition must be met to execute the action.

Conditions can be based on accessories, feedback sensors, vehicle state, flags, variables, or camera detection. If the conditions are not met, the action is skipped and the script continues with the next action.

Custom label

Every action can have an optional custom label that appears alongside the auto-generated description. This helps you annotate actions to keep your scripts readable — for example, "slow down before curve" on a set speed action.

Action selector

Adding an action starts with tapping the + button inside a section. The action selector appears, allowing you to pick the desired action.

The action selector

Action types

Actions are organised into categories:

  • Vehicle control — Select, drive, and manage your locomotives.
  • Layout control — Control turnouts, signals, and other accessories.
  • Timing — Wait for time or conditions.
  • Structure — Execute scripts, set flags, variables, and notifications.
  • Scenery — Play sounds and effects.

Overview

CategoryActionDescription
VehicleSelect vehicleSet the active vehicle for subsequent actions
VehicleSelect from feedbackSelect vehicle by reading a feedback sensor (RailCom)
VehicleSet speedSet speed as a percentage (0–100)
VehicleStop vehicleSet speed to 0
VehicleSet directionSet direction to forward or reversed
VehicleToggle directionReverse the current direction
VehicleSet functionTurn a vehicle function on or off (by icon or by function)
VehicleSet profileApply a vehicle profile (idle, shunting, slow, medium, fast)
VehicleStore stateSave the vehicle's current state
VehicleRestore stateRestore a previously saved state
LayoutSet accessorySet an accessory to a specific state
LayoutSet routeApply a predefined route
LayoutSet pathAutomatically find and set a path through the layout
TimingWaitPause for a fixed or random duration
TimingWait for conditionPause until a condition becomes true
StructureExecute scriptRun another script inline (specific or random by tag)
StructureSet flagsSet script-level flags
StructureSet variableModify a variable (set, increase, decrease)
StructureShow notificationDisplay an in-app notification
SceneryPlay soundPlay a sound (blocking or in background)