# Vehicles

The vehicle list allows you to register your locomotives and their functions. These vehicles can be used afterwards while controlling your layout manually via the [throttle](throttle) or while using [automation](automation) for your layout.

For ECoS vehicles have to be imported from the command station but can be edited afterwards.



<figure><img src="https://4224524483-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAjZj7d8De4optEMsLAji%2Fuploads%2F6LQ1eOVJcGaR0qSfA686%2FSimulator%20Screenshot%20-%20iPhone%2016%20Pro%20-%202024-11-24%20at%2022.30.45.png?alt=media&#x26;token=b77625a3-ecf4-4ce6-abe7-2fa36aefbf4f" alt="" width="188"><figcaption><p>Example vehicle</p></figcaption></figure>

## Configuration[​](https://modeltrainscript.app/manual/vehicles.html#configuration) <a href="#configuration" id="configuration"></a>

Every locomotive need to have a **name** and the dcc **address** configured. Optionally you can add an image for easy recognition of your vehicle.

**Tags** will help you keeping an overview of your vehicles.

ModelTrainScript supports 14, 28 and 128 speedsteps.

## Functions[​](https://modeltrainscript.app/manual/vehicles.html#functions) <a href="#functions" id="functions"></a>

A function of a locomotive requires a **name**, function **index**, **icon** and **type**. The type of a function can either be a **toggle** or a **moment**. The difference is that a toggle will permanently set the state (for example for lights) while a moment gives a short pulse (for example for horns).

You can order the functions in any way your prefer, the throttle will display the functions in your preferred order.

## Profiles

Profiles are shortcuts to set a vehicle's state. In a profile, you can assign speed, direction, and vehicles. Use the **set profile** action to apply a profile to the selected locomotive in your [automation scripts](automation) or set the a profile manually via the [throttle](throttle).

## Flags

Flags connected to the vehicle are automatically set when the locomotive is selected in an automation script.

## Notes

Notes is a free text field that can be used to keep track of vehicle specifics like model number or used decoder.







