> For the complete documentation index, see [llms.txt](https://modeltrainscript.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://modeltrainscript.gitbook.io/docs/de/manual/automation/scripts/action/vehicle-control.md).
# Fahrzeuge
In diesem Kapitel werden die Aktionen zur Steuerung Ihrer Züge beschrieben.
## Fahrzeug auswählen
Alle Fahrzeugsteuerungsaktionen erfordern, dass zuvor ein **Fahrzeug ausgewählt** wurde. Die Auswahlaktion legt das aktive Fahrzeug für alle nachfolgenden Aktionen im Skript fest.
Sie können ein Fahrzeug auf zwei Arten auswählen:
* **Aus Katalog** — Wählen Sie ein zuvor in der [Fahrzeugliste](/docs/de/manual/vehicles.md) konfiguriertes Fahrzeug. Die Adresse, Fahrstufen und [Funktionsschalter](/docs/de/manual/automation/flags.md) werden automatisch aus dem Katalogeintrag übernommen.
* **Manuell** — Geben Sie die DCC-Adresse, Fahrstufen und den Namen direkt ein. Dies ist nützlich für Fahrzeuge, die nicht in Ihrem Katalog sind.
{% hint style="info" %}
Wenn Sie ein neues Fahrzeug auswählen, wird das zuvor ausgewählte Fahrzeug freigegeben. Innerhalb eines Skripts kann immer nur ein Fahrzeug gleichzeitig aktiv sein.
{% endhint %}
## Auswahl durch Rückmelder
Die Aktion **Auswahl durch Rückmelder** liest die Fahrzeugadresse über einen Rückmeldesensor aus Ihrem [Stellwerk](/docs/de/manual/layout.md) aus. Dies erfordert RailCom-fähige Hardware.
| Einstellung | Beschreibung |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Rückmeldesensor** | Der Rückmeldesensor, von dem die Fahrzeugadresse gelesen wird. Wählen Sie aus Ihrem Stellwerk. |
| **Auf Belegung warten** | Bei Aktivierung wartet die Aktion, bis ein Fahrzeug auf dem Sensor erkannt wird. Bei Deaktivierung wird der aktuelle Zustand sofort gelesen. |
| **Funktionsschalter aus Katalog** | Bei Aktivierung werden die [Funktionsschalter](/docs/de/manual/automation/flags.md) des erkannten Fahrzeugs aus dem Katalog angewendet, sofern die Adresse übereinstimmt. |
Diese Aktion ist besonders nützlich für ereignisgesteuerte Skripte, bei denen Sie nicht wissen, welches Fahrzeug an einem Sensor ankommt.
## Geschwindigkeit setzen
Setzt die Geschwindigkeit des ausgewählten Fahrzeugs als **Prozentsatz** (0–100), wobei 0 Stillstand und 100 volle Geschwindigkeit bedeutet. Der Prozentsatz wird basierend auf den konfigurierten Fahrstufen (14, 28 oder 128) in den tatsächlichen Geschwindigkeitswert umgerechnet.
Die aktuelle Fahrtrichtung bleibt erhalten.
## Fahrzeug anhalten
Setzt die Geschwindigkeit des ausgewählten Fahrzeugs sofort auf 0. Keine Konfiguration erforderlich — die aktuelle Fahrtrichtung bleibt erhalten.
## Richtung setzen
Legt die Fahrtrichtung des ausgewählten Fahrzeugs explizit auf **vorwärts** oder **rückwärts** fest. Die aktuelle Geschwindigkeit bleibt erhalten.
## Richtung umschalten
Kehrt die aktuelle Fahrtrichtung um. Keine Konfiguration erforderlich — die aktuelle Geschwindigkeit bleibt erhalten.
## Funktion setzen
Löst eine bestimmte Funktion des ausgewählten Fahrzeugs aus. Sie können eine Funktion **ein-** oder **ausschalten**, wobei die Funktion auf zwei Arten identifiziert werden kann:
* **Nach Symbol** — Model Train Script sucht die erste Funktion am aktiven Fahrzeug, die dem konfigurierten Symbol entspricht (z.B. Pfeife, Horn, Licht). So können Sie **fahrzeugunabhängige** Skripte erstellen — dasselbe Skript funktioniert mit verschiedenen Fahrzeugen, solange diese Funktionen mit passenden Symbolen haben.
* **Nach Funktion** — Sie wählen die genaue Funktion aus einem Katalogfahrzeug aus. Dies gibt Ihnen präzise Kontrolle über die ausgelöste Funktion, einschließlich ihres Typs (Umschalten, Impuls oder Zeitgesteuert).
{% hint style="info" %}
Wenn eine Funktion am Fahrzeug als **Impuls**-Typ konfiguriert ist, sendet die Aktion unabhängig von der Ein-/Ausschalteinstellung automatisch einen kurzen Impuls.
{% endhint %}
## Profil festlegen
Wendet ein vordefiniertes [Fahrzeugprofil](/docs/de/manual/vehicles.md) auf das ausgewählte Fahrzeug an. Ein Profil ist eine Schnelleinstellung, die Geschwindigkeit, Richtung und Funktionen in einer einzigen Aktion setzt.
Verfügbare Profiltypen:
| Profil | Beschreibung |
| ------------- | ------------------------------------------- |
| **Leerlauf** | Angehaltener Bereitschaftszustand |
| **Rangieren** | Niedrige Geschwindigkeit für Rangierbetrieb |
| **Langsam** | Langsame Reisegeschwindigkeit |
| **Mittel** | Mittlere Reisegeschwindigkeit |
| **Schnell** | Hohe Geschwindigkeit |
Die genauen Werte für Geschwindigkeit, Richtung und Funktionen jedes Profils werden pro Fahrzeug in der [Fahrzeugkonfiguration](/docs/de/manual/vehicles.md) festgelegt.
## Zustand speichern
Speichert den vollständigen Zustand des ausgewählten Fahrzeugs — Geschwindigkeit, Richtung und alle Funktionszustände — zur späteren Wiederherstellung. Keine Konfiguration erforderlich.
Der gespeicherte Zustand bleibt innerhalb des aktuellen Skriptdurchlaufs erhalten und kann an jedem späteren Punkt im Skript wiederhergestellt werden.
## Zustand wiederherstellen
Stellt den zuvor durch **Zustand speichern** gesicherten Fahrzeugzustand wieder her. Alle Funktionszustände werden einzeln wiederhergestellt, gefolgt von Geschwindigkeit und Richtung.
{% hint style="info" %}
Ein typischer Anwendungsfall ist ein Langsamfahrabschnitt: Vor dem Einfahren speichern Sie den Zustand und setzen eine niedrigere Geschwindigkeit. Nach dem Verlassen stellen Sie den Zustand wieder her, um mit der ursprünglichen Geschwindigkeit und allen Funktionen fortzufahren.
{% endhint %}