# CLI-Referenz

<!-- l10n: source=reference/cli.md -->
> Übersetzung der [englischen Originalseite](https://github.com/lmonteirotech/OmsiLaunch/blob/v0.1.0-beta.3/docs/reference/cli.md) für OmsiLaunch 0.1.0-beta3. Maßgeblich ist die englische Seite: Bei Abweichungen gelten die englische Seite und der Code.

Diese Seite ist die vollständige, normative Referenz für die Befehlszeile von OmsiLaunch `0.1.0-beta3`: die drei ausführbaren Dateien, die Argumentgrammatik, die Dispatch-Reihenfolge, jedes Befehlswort, jede hierarchische Route, jedes Flag, die Ausgabe-Envelopes und das Fehlerverhalten jedes Befehls. Sie wird aus `tools\OmsiLaunch.Cli\Program.cs` (`CliProgram.RunAsync`, `OwnerSession.RunAsync`, `CliInput.Parse`, `CliInput.KnownFlags`, `CliInput.AcceptedNoEffectFlags`, `CliInput.CommandWordsAccepted`, `CliInput.HierarchicalRoutes`, `CliInput.BuildSpecAsync`, `CliEventWatch`), `tools\OmsiLaunch.Cli\LaunchSpecJson.cs` und den beiden nativen Shims unter `tools\OmsiLaunch.Bootstrapper` erzeugt. Prozessergebnisse sind unter [Exitcodes](https://omsilaunch.omsimods.com.br/de/docs/reference/exit-codes/index.md) aufgeführt, Fehlercodes unter [Fehler](https://omsilaunch.omsimods.com.br/de/docs/reference/errors/index.md), ausgearbeitete Aufrufe unter [CLI-Beispiele](https://omsilaunch.omsimods.com.br/de/docs/reference/cli-examples/index.md).

<a id="executables"></a>
## Ausführbare Dateien

| Datei | Subsystem | Rolle | Unterschiede |
|---|---|---|---|
| `OmsiLaunch.exe` | Konsole | Nativer Bootstrapper (`OmsiLaunch.Bootstrapper.cpp`): ermittelt sein eigenes Verzeichnis, zerlegt die Befehlszeile mit `CommandLineToArgvW` in Token, sucht `hostfxr` über `nethost.dll` und führt `OmsiLaunch.Controller.dll` mit denselben Argumenten aus. | Es wird Konsolenausgabe geschrieben; der Exitcode des Prozesses ist der Exitcode des verwalteten Controllers oder ein Shim-Code `100`..`106`, wenn der .NET-Host nicht gestartet werden konnte. |
| `OmsiLaunchW.exe` | Windows (GUI) | Derselbe Shim (`OmsiLaunch.WindowsHost.cpp`), für das Windows-Subsystem gebaut. Er setzt die Umgebungsvariable `OMSILAUNCH_WINDOWS_HOST=1`, bevor er den Controller startet. | Keine Konsole: Konsolenausgabe wird unterdrückt, sofern nicht `--json` angegeben ist (`WindowsHost.SuppressConsole`), Fehler werden als Meldungsfenster angezeigt (`WindowsHost.ShowFailure`: Meldung, `Code: OL_E_...` und der Hinweis `See .omsilaunch\diagnostics for details.`), und ein Shim-Fehler `100`..`106` wird als `OmsiLaunch could not start the .NET host (code N).` angezeigt. Vollständiges Verhalten: [Referenz zu OmsiLaunchW.exe](https://omsilaunch.omsimods.com.br/de/docs/reference/omsilaunchw/index.md). |
| `OmsiLaunch.Controller.dll` | Verwaltet (x64, `net6.0-windows`, Windows Forms) | Der Controller selbst. Er wird von Benutzern nie direkt aufgerufen; beide Shims übergeben den Controller-Pfad als erstes Host-Argument, sodass er nie in der öffentlichen Argumentliste erscheint. | Erfordert die x64-.NET-6-Runtime mit `Microsoft.WindowsDesktop.App`; siehe [Installation](https://omsilaunch.omsimods.com.br/de/docs/getting-started/installation/index.md). |

`nethost.dll` muss neben den Shims liegen. Die Shims lesen selbst keine Argumente; jedes Argument erreicht `CliInput.Parse` unverändert, daher akzeptieren `OmsiLaunch.exe` und `OmsiLaunchW.exe` exakt dieselbe Syntax.

<a id="invocation-model"></a>
## Aufrufmodell

<a id="argument-grammar-cliinputparse"></a>
### Argumentgrammatik (`CliInput.Parse`)

| Form | Bedeutung |
|---|---|
| `/key:value`, `/key`, `-key:value`, `-key` | Ein Flag. Beim Schlüssel wird die Groß-/Kleinschreibung nicht beachtet; der Wert ist alles nach dem ersten `:`. Unbekannte Schlüssel schlagen mit `OL_E_INVALID_ARGUMENT` (`Unknown argument: ...`) fehl, Exit `2`. |
| `--key=value` | Ein Runtime-Argument für die ausgewählte Runtime-Operation (zum Beispiel `--handle=rv-000001`). Jedes `--`-Token, das `=` enthält, ist ein Runtime-Argument, niemals ein Flag. |
| `--json`, `/json` | Strukturierte Ausgabe (siehe [Ausgabeformate](#output-formats)). `--json` ist das einzige `--`-Token ohne `=`, das eine Bedeutung hat; es wird als das Flag `/json` geparst. |
| einzelnes Wort | Wurde noch kein Befehlswort erkannt und ist das Wort eines der [Befehlswörter](#command-words), wird es zum Befehl. Sobald ein Befehlswort vorhanden ist, ist jedes spätere einzelne Wort ein Befehlswort (die Route). Andernfalls ist das erste einzelne Wort das Installationsstammverzeichnis, und jedes spätere einzelne Wort wird an die Route angehängt. |

Folgen: Eine hierarchische Route (`time get`) lässt sich nicht mit einem dahinter angegebenen Installationsargument kombinieren (`time get D:\OMSI` ist die unbekannte Route `time get d:\omsi`, Exit `2`). `D:\OMSI time get` wird akzeptiert, ist aber **Eigentümermodus** (eine neue Sitzung wird gestartet und die Operation läuft einmal darin). Parse-Fehler (`ArgumentException`, `FormatException`, `InvalidDataException`, `OverflowException`) und Sitzungsprofil-Fehler (`SessionProfileException`) werden gemeldet, bevor irgendetwas ausgeführt wird, immer mit Exit `2`.

<a id="installation-root"></a>
### Installationsstammverzeichnis

- Ein explizites Installationsargument als einzelnes Wort hat Vorrang vor `RootPath` in einer `/spec`-Datei (`CliInput.BuildSpecAsync`).
- `.` bezeichnet das Verzeichnis, das die ausführbare Datei enthält (`AppContext.BaseDirectory`), niemals das Arbeitsverzeichnis des Aufrufers (`CliInput.ResolveInstallationRoot`). Ein portables Paket verlässt sich darauf.
- Wird das Argument weggelassen, verwenden auch Operationen im Eigentümermodus (`/new`, `/saved`, `/spec`, `/list`, `/recovery-status`, `/recover`) das Verzeichnis der ausführbaren Datei. Der Pfad wird mit `Path.GetFullPath` normalisiert.
- Befehle im Client-Modus nehmen nie ein Installationsargument entgegen: Sie adressieren den lokalen Steuerungsendpunkt der Installation, in der die ausführbare Datei liegt (`AppContext.BaseDirectory`). Siehe [lokale Steuerung](https://omsilaunch.omsimods.com.br/de/docs/reference/local-control/index.md).

<a id="owner-and-client"></a>
### Eigentümer und Client

- **Eigentümer**: der Prozess, der eine Sitzung plant, startet, überwacht und wiederherstellt (`OwnerSession.RunAsync`). Er hält die Installations-Lease (`Local\OmsiLaunch.Installation.<sha256(root)>`) und die Konfigurationstransaktion, stellt den lokalen Steuerungsendpunkt bereit, solange die Sitzung besteht, und zeigt das [Tray-Symbol](https://omsilaunch.omsimods.com.br/de/docs/reference/windows-tray/index.md) an. Genau ein Eigentümer pro Installation: Beantwortet bereits ein Eigentümer `session.status` am Steuerungsendpunkt, schlägt ein zweiter Start mit `OL_E_SESSION_ALREADY_ACTIVE` (Exit `7`) fehl.
- **Client**: jeder Aufruf ohne Installationsargument, der `session status`, `session stop`, `events read`, `events watch` oder eine Runtime-Operation sendet. Er wird über die lokale Steuerungs-Pipe weitergeleitet; ohne Eigentümer schlägt er mit `OL_E_NO_ACTIVE_SESSION` (Exit `4`) fehl.

<a id="dispatch-order-cliprogramrunasync"></a>
### Dispatch-Reihenfolge (`CliProgram.RunAsync`)

1. `/silent` (wenn nicht bereits unter `OmsiLaunchW.exe` ausgeführt): startet `OmsiLaunchW.exe` aus dem Verzeichnis der ausführbaren Datei über `ShellExecute` (ohne Handle-Vererbung) mit denselben Argumenten ohne `/silent`/`--silent`, schreibt das Envelope `silent` (`delegated`, `host_process_id`) und gibt `0` zurück. Der Konsolenprozess wartet nicht auf die Sitzung; siehe [OmsiLaunchW.exe](https://omsilaunch.omsimods.com.br/de/docs/reference/omsilaunchw/index.md#silent-delegation). `OL_E_WINDOWS_HOST_MISSING` / `OL_E_WINDOWS_HOST_START_FAILED` geben `7` zurück.
2. `/version`: Envelope `version` mit `product`, `version` (informative Assembly-Version, aus `OmsiLaunch.Version.props` gestempelt, `0.1.0-beta3`), `protocol_version` (`0.1`), `supported_family` (`OMSI_2_3_004_COMMON`); Exit `0`.
3. `capabilities`: Envelope mit jedem Deskriptor `PublicStableBeta` oder `PublicExperimental` aus `PublicCapabilityRegistry`; Exit `0`.
4. `help [family]`: Envelope `help` mit `usage`, `product_version`, `protocol_version`, `family` und den öffentlichen `commands` (`CliRoute`, `Description`, `Classification`, `RuntimeValidation`), optional nach Familie gefiltert; Exit `0`.
5. `profiles`: Envelope mit `family` und den `supported`-Varianten der ausführbaren Datei (`ALTERNATE_LAA` `692EBFBF...`, `runtime_validated=true`; der Steam-LAA-Hash `7DAB063D...` mit `validation_status=pending_beta_field_validation`); Exit `0`.
6. Client-Runtime-Operation (kein Installationsargument und eine Route oder `/runtime:`): Die Argumente werden gegen `PublicCapabilityRegistry.ValidateRuntimeArguments` geprüft (`OL_E_RUNTIME_OPERATION_UNKNOWN`, `OL_E_RUNTIME_ARGUMENT_REQUIRED`, Exit `2`), dann wird `runtime.execute` mit einem Timeout von 8 s (30 s für `road-vehicles.spawn`) weitergeleitet.
7. Client `session status` (750 ms), `session stop` (an die ID der aktiven Sitzung gebunden, 750 ms), `events read` (750 ms), `events watch` (fragt alle 250 ms ab, bis Ctrl+C).
8. `detect` oder **überhaupt keine Argumente** (keine Installation, kein Befehl, kein `/?`, kein `/spec`, kein Startflag, kein Recovery-Flag, kein `/list`): zählt `Omsi`-Prozesse auf und prüft den Steuerungsendpunkt (250 ms); Envelope `detect`; Exit `0`.
9. `/?` oder `/help`: gibt den Verwendungstext aus, Exit `0`. Jeder andere Aufruf, der ein Befehlswort, aber keine dispatchfähige Route hat (zum Beispiel `d3d` allein oder `session status D:\OMSI`), gibt den Verwendungstext aus und endet mit Exit `2`.
10. Eigentümermodus. Voraussetzungen: `plugins\OmsiLaunch.Plugin.opl` und `plugins\OmsiLaunch.Native.x86.dll` müssen neben der ausführbaren Datei vorhanden sein (`OL_E_RUNTIME_INSTALLATION_INCOMPLETE`, Exit `7`). `release-manifest.json` neben der ausführbaren Datei liefert, sofern vorhanden, die erwarteten Plugin-Hashes.
11. `/recovery-status` / `/recover`: `RecoverPendingAsync`; Envelope `recover` mit `pending`, `recovered`, `diagnostics`; Exit `8` nur dann, wenn eine Wiederherstellung angefordert wurde und nicht abgeschlossen wurde, andernfalls `0`.
12. `/list:<category>`: `DiscoverAsync`; Envelope `content.list`; Exit `0`.
13. Die `LaunchSpec` erstellen (`BuildSpecAsync`), planen (`PlanSessionAsync`) und den Plan ausgeben. `/plan` oder `/validate`: Exit `0`, wenn `IsRunnable`, sonst `1`. Ein nicht ausführbarer Plan startet OMSI nie (Exit `1`); unter `OmsiLaunchW.exe` zeigt ein Start mit nicht ausführbarem Plan dessen letzte `OL_E_`-Diagnose in einem Meldungsfenster an (Dokumentationsaudit BUG-06). Die Planung prüft außerdem die installierte permanente Plugin-Gesamtheit (Closure) gegen `release-manifest.json`, sodass ein fehlendes oder verändertes Plugin den Plan nicht ausführbar macht (`OL_E_PERMANENT_PLUGIN_*`).
14. Prüfung auf einen bereits vorhandenen Eigentümer (`OL_E_SESSION_ALREADY_ACTIVE`, Exit `7`), danach `OwnerSession.RunAsync`.

<a id="owner-lifecycle-ownersessionrunasync"></a>
### Lebenszyklus des Eigentümers (`OwnerSession.RunAsync`)

1. `StartSessionAsync(plan)`. Ab hier erreicht jeder Exit-Pfad `CloseAsync` in einem `finally`-Block: Ausnahmen, Ctrl+C (`Console.CancelKeyPress`), Schließen der Konsole / Abmelden (`AppDomain.ProcessExit` mit einem Budget von 4 s für Stopp + Wiederherstellung; alles Verbleibende wird beim nächsten Start über das Journal per Recovery wiederhergestellt), Tray „End session“, Pipe `session.stop` und `/observe-seconds`.
2. Das Tray-Symbol wird erstellt, sofern `Presentation.SuppressTrayIcon` nicht in der Spec gesetzt ist.
3. Es wird `StartupTimeoutSeconds + 5` Sekunden lang auf `Running` gewartet. Der Status wird ausgegeben. Ist der Zustand nicht `Running`, Exit `1` (`OmsiLaunchW.exe` zeigt `The OMSI session did not reach gameplay.` mit der letzten `OL_E_`-Diagnose oder `OL_E_SESSION_START_FAILED` an).
4. Validierungs-Batches (`/runtime-batch`, `/runtime-write-batch`, `/d3d-batch`) laufen und schreiben ihre Artefakte.
5. Der lokale Steuerungsendpunkt startet.
6. `/runtime:<operation>` läuft einmal (5 s, 15 s für `road-vehicles.spawn`); das Ergebnis wird nach `<root>\.omsilaunch\diagnostics\<sessionId>-runtime-operation.json` geschrieben und ausgegeben. Ein fehlschlagender Runtime-Befehl beendet die Sitzung nie (stattdessen wird `runtime_error` ausgegeben).
7. Warten: Mit `/observe-seconds:n` wird die Sitzung nach `n` Sekunden beendet **oder** früher bei einem Stopp über Tray/Pipe oder wenn OMSI sich beendet; ohne dieses Flag wartet der Eigentümer, bis OMSI sich beendet oder ein Stopp angefordert wird.
8. Der abgeschlossene Status wird ausgegeben; Exit `0` bei `Completed`, sonst `1`.

`session.stop`, Tray „End session“, Ctrl+C und `CloseAsync` fordern alle den kanonischen Stopp an: OMSI wird mit `TerminateProcess` beendet (die eigene Beendigungsroutine von OMSI läuft nicht und `options.cfg` wird von OMSI nicht neu geschrieben), danach wird jede Datei, die der Sitzung gehört, wiederhergestellt. Siehe [Sitzungslebenszyklus](https://omsilaunch.omsimods.com.br/de/docs/concepts/session-lifecycle/index.md) und [Transaktionen und Recovery](https://omsilaunch.omsimods.com.br/de/docs/concepts/transactions-and-recovery/index.md).

<a id="command-words"></a>
## Befehlswörter

Jedes an erster Position akzeptierte Wort (`CliInput.CommandWordsAccepted`):

| Wort | Zweck | Modus | Hinweise |
|---|---|---|---|
| `capabilities` | Öffentliche Capabilities auflisten | Lokal, keine Sitzung | Envelope `capabilities`. |
| `profiles` | Unterstützte `Omsi.exe`-Varianten auflisten | Lokal, keine Sitzung | Envelope `profiles`. |
| `detect` | `Omsi.exe`-Prozesse und einen aktiven Eigentümer melden | Lokal, keine Sitzung | Auch der Standard, wenn keine Argumente angegeben sind. Zustände: `NO_OMSI_FOUND`, `OMSI_FOUND_UNMANAGED`, pro Prozess `UNKNOWN_BINARY_FOUND`, wenn die Binärdatei nicht untersucht werden kann; `active_omsilaunch_instance`, `managed_session`. |
| `help` | Verwendung und öffentlicher Befehlskatalog | Lokal, keine Sitzung | `help <family>` filtert nach Capability-Familie (`session`, `time`, `weather`, `map`, `camera`, `vehicles`, `player`, `humans`, `timetable`, `scripts`, `constants`, `curves`, `hof`, `drivers`, `tickets`, `d3d`, `events`). |
| `session` | `session status`, `session stop` | Client | Genau ein folgendes Wort; alles andere gibt den Verwendungstext aus, Exit `2`. `session plan`/`session start` sind Routennamen der API, keine CLI-Wörter: Verwenden Sie `/plan` und `/new`. |
| `events` | `events read`, `events watch` | Client | `read` gibt die begrenzte Ereignisliste einmal zurück; `watch` gibt jedes neue Ereignis (nach `Sequence`) alle 250 ms als `events.watch`-Envelope aus, bis Ctrl+C (Exit `0`), `4`, wenn kein Eigentümer antwortet, `7` bei einem Steuerungsfehler. |
| `time` | `time get`, `time set` | Client-Route | |
| `weather` | `weather get`, `weather set`, `weather actual get` | Client-Route | |
| `map` | `map get` | Client-Route | |
| `camera` | `camera get`, `camera set`, `camera lock`, `camera unlock` | Client-Route | |
| `vehicles` | `vehicles list`, `vehicles get`, `vehicles summary`, `vehicles spawn`, `vehicles place-random` | Client-Route | |
| `player` | `player get` | Client-Route | |
| `humans` | `humans list`, `humans get`, `humans summary` | Client-Route | |
| `timetable` | `timetable get`, `timetable <table> list`, `timetable logs list` | Client-Route | |
| `scripts` | `scripts variable list|get|set`, `scripts string list|get` | Client-Route | |
| `constants` | `constants list`, `constants get` | Client-Route | |
| `curves` | `curves list`, `curves evaluate` | Client-Route | |
| `hof` | `hof get` | Client-Route | |
| `drivers` | `drivers list` | Client-Route | |
| `tickets` | `tickets get` | Client-Route | |
| `d3d` | Reserviertes Familienwort | Keiner | `d3d` hat **keine hierarchische Route**: `d3d texture ...` ist eine unbekannte Route (Exit `2`), und `d3d` allein gibt den Verwendungstext aus (Exit `2`). D3D-Operationen werden mit `/runtime:d3d.status`, `/runtime:d3d.texture.create` usw. erreicht (siehe [Operationen ohne Route](#operations-without-a-route)). |

<a id="hierarchical-routes"></a>
## Hierarchische Routen

`CliInput.HierarchicalRoutes` ordnet einer kleingeschriebenen Route eine Runtime-Operations-ID zu. Alle Routen erfordern eine Sitzung im Zustand `Running` und werden über die Runtime-Mailbox ausgeführt (`ExecuteRuntimeAsync`). Runtime-Schreibvorgänge ändern nur den Speicherzustand von OMSI: Sie berühren niemals Dateien, sind nicht Teil der Konfigurationstransaktion und werden beim Stopp **nicht** rückgängig gemacht (OMSI wird beendet). Die Stabilität richtet sich nach `PublicCapabilityRegistry` und der [Validierungsmatrix](https://omsilaunch.omsimods.com.br/de/docs/status/runtime-validation-status/index.md); Details und Ergebnisfelder finden Sie unter [Runtime-Steuerung](https://omsilaunch.omsimods.com.br/de/docs/reference/runtime-control/index.md).

| Route | Runtime-Operation | Art | Erfordert Running | Ändert OMSI | Beteiligung an der Wiederherstellung | Stabilität | Hinweise |
|---|---|---|---|---|---|---|---|
| `time get` | `time.read` | Read | Ja | Nein | Keine | STABLE_BETA | Uhr- und Kalenderfelder. |
| `time set` | `time.set` | Write | Ja | Ja (Uhr im Speicher) | Keine, nicht rückgängig gemacht | EXPERIMENTAL | Zum Beispiel `--minute=<0..59>`; Schreiben, Zurücklesen und Wiederherstellen am 2026-09-20 validiert. |
| `weather get` | `weather.read` | Read | Ja | Nein | Keine | STABLE_BETA | |
| `weather set` | `weather.set` | Write | Ja | Nein (immer abgelehnt) | Keine | UNAVAILABLE | Gibt `OL_E_RUNTIME_SETTING_NOT_PERSISTENT` zurück; OMSI überschreibt den Wert bei seinem nächsten Wetter-Tick. |
| `weather actual get` | `weather.actual.read` | Read | Ja | Nein | Keine | EXPERIMENTAL | Zustand des Actual-/ICAO-Controllers. |
| `map get` | `map.read` | Read | Ja | Nein | Keine | STABLE_BETA | Kartenname, Datei, Beschreibung, Kachelanzahl, Jahresbereich und Verkehrsseite; auf dem korrigierten Karten-Slot erneut zur Laufzeit validiert. |
| `camera get` | `camera.read` | Read | Ja | Nein | Keine | STABLE_BETA | |
| `camera set` | `camera.set` | Write | Ja | Ja (Kamera-Skalare, z. B. `--field_of_view=`) | Keine, nicht rückgängig gemacht | EXPERIMENTAL | Schreiben/Zurücklesen des FOV validiert. |
| `camera lock` | `camera.lock` | Action | Ja | Ja (sitzungsbezogene Richtlinie) | Keine | EXPERIMENTAL | Erfordert `--family=<0..3>` (Fahrer=0, Fahrgast=1, extern=2, Karte=3), optional `--preset=<n>` (Familie 0 oder 1). Benötigt ein Spielerfahrzeug (zum Beispiel eine gespeicherte Situation). In der Runtime-Closure zur Laufzeit validiert (`CAM01`); die `RuntimeValidation`-Zeichenfolge der Registry lautet weiterhin `STATICALLY_VALIDATED` (siehe [Capabilities](https://omsilaunch.omsimods.com.br/de/docs/reference/capabilities/index.md)). |
| `camera unlock` | `camera.unlock` | Action | Ja | Ja | Keine | EXPERIMENTAL | Hebt die durch `camera lock` gesetzte Richtlinie auf (`CAM01`). |
| `vehicles list` | `road-vehicles.list` | Read | Ja | Nein | Keine | STABLE_BETA | Gibt sitzungsbezogene `rv-NNNNNN`-Handles zurück. |
| `vehicles get` | `road-vehicle.read` | Read | Ja | Nein | Keine | STABLE_BETA | Erfordert `--handle=`. Veraltetes Handle: `OL_E_RUNTIME_OBJECT_HANDLE_STALE`. |
| `vehicles summary` | `road-vehicles.read` | Read | Ja | Nein | Keine | STABLE_BETA | Anzahlen und Spielerzustand, keine Handles. |
| `vehicles spawn` | `road-vehicles.spawn` | Action | Ja | Ja (fügt ein RoadVehicle hinzu) | Keine, nicht entfernt | EXPERIMENTAL | Erfordert `--model=Vehicles\...\*.bus`. Client-Timeout 30 s, Eigentümer-Timeout 15 s. Weist das Spielerfahrzeug nicht zu. RV-003 `RUNTIME_PASS`. |
| `vehicles place-random` | `road-vehicles.place-random` | Action | Ja | Ja | Keine | EXPERIMENTAL | Profiliertes `PlaceRandomBus`. |
| `player get` | `player-vehicle.read` | Read | Ja | Nein | Keine | STABLE_BETA | Semantisches Null, wenn kein Spielerfahrzeug vorhanden ist. |
| `humans list` | `humans.list` | Read | Ja | Nein | Keine | EXPERIMENTAL | Gibt `hb-NNNNNN`-Handles zurück. |
| `humans get` | `human.read` | Read | Ja | Nein | Keine | EXPERIMENTAL | Erfordert `--handle=`. |
| `humans summary` | `humans.read` | Read | Ja | Nein | Keine | EXPERIMENTAL | Nur Anzahlen. |
| `timetable get` | `timetable.read` | Read | Ja | Nein | Keine | STABLE_BETA | Zustand des Fahrplanmanagers. |
| `timetable tracks list` | `timetable.tracks.list` | Read | Ja | Nein | Keine | STABLE_BETA | Teil der Capability `timetable.read`; Nachweis per Batch-Lesen vom 2026-09-20. |
| `timetable trips list` | `timetable.trips.list` | Read | Ja | Nein | Keine | STABLE_BETA | Wie oben. |
| `timetable lines list` | `timetable.lines.list` | Read | Ja | Nein | Keine | STABLE_BETA | Wie oben. |
| `timetable tours list` | `timetable.tours.list` | Read | Ja | Nein | Keine | STABLE_BETA | Wie oben. |
| `timetable profiles list` | `timetable.profiles.list` | Read | Ja | Nein | Keine | STABLE_BETA | Wie oben. |
| `timetable bus-stops list` | `timetable.bus-stops.list` | Read | Ja | Nein | Keine | STABLE_BETA | Wie oben. |
| `timetable station-links list` | `timetable.station-links.list` | Read | Ja | Nein | Keine | STABLE_BETA | Wie oben. |
| `timetable logs list` | `timetable.logs.read` | Read | Ja | Nein | Keine | STABLE_BETA | Wie oben. |
| `drivers list` | `drivers.read` | Read | Ja | Nein | Keine | EXPERIMENTAL | Fahrerdatensätze. |
| `tickets get` | `tickets.read` | Read | Ja | Nein | Keine | EXPERIMENTAL | Datensätze der Fahrscheinpakete. |
| `hof get` | `vehicle.hofs.read` | Read | Ja | Nein | Keine | STABLE_BETA | Erfordert `--handle=`. |
| `constants list` | `vehicle.constants.list` | Read | Ja | Nein | Keine | STABLE_BETA | Erfordert `--handle=`. |
| `constants get` | `vehicle.constant.get` | Read | Ja | Nein | Keine | STABLE_BETA | Erfordert `--handle=`, `--name=`. |
| `curves list` | `vehicle.curves.list` | Read | Ja | Nein | Keine | STABLE_BETA | Erfordert `--handle=`. |
| `curves evaluate` | `vehicle.curve.evaluate` | Read | Ja | Nein | Keine | STABLE_BETA | Erfordert `--handle=`, `--name=`, `--x=`. |
| `scripts variable list` | `vehicle.variables.list` | Read | Ja | Nein | Keine | EXPERIMENTAL | Erfordert `--handle=`. |
| `scripts variable get` | `vehicle.variable.get` | Read | Ja | Nein | Keine | EXPERIMENTAL | Erfordert `--handle=`, `--name=`. |
| `scripts variable set` | `vehicle.variable.set` | Write | Ja | Ja (Skriptvariable) | Keine, nicht rückgängig gemacht | EXPERIMENTAL | Erfordert `--handle=`, `--name=`, `--value=` (endliche Zahl). |
| `scripts string list` | `vehicle.string-variables.list` | Read | Ja | Nein | Keine | EXPERIMENTAL | Erfordert `--handle=`. |
| `scripts string get` | `vehicle.string-variable.get` | Read | Ja | Nein | Keine | EXPERIMENTAL | Erfordert `--handle=`, `--name=`. |

<a id="operations-without-a-route"></a>
### Operationen ohne Route

Diese öffentlichen Operations-IDs (`PublicCapabilityRegistry.PublicRuntimeOperationIds`) haben keine hierarchische Route und werden mit `/runtime:<operation>` plus `--key=value` oder `/runtime-arg:key=value` aufgerufen: `timetable.rv-files.list`, `timetable.track-entries.list`, `timetable.tour-entries.list`, `d3d.status`, `d3d.texture.create` (`width`, `height`, `format` erforderlich; `levels` optional), `d3d.texture.describe` (`handle`; `level` optional), `d3d.texture.update` (`handle`, `width`, `height`, `pixels_base64` erforderlich; `level`, `x`, `y` optional), `d3d.texture.release` (`handle`). D3D-Operationen sind EXPERIMENTAL; der Textur-Lebenszyklus und die Invalidierung beim Geräte-Reset sind zur Laufzeit validiert (Runtime-Closure `H02`, `D01`; siehe [Capabilities](https://omsilaunch.omsimods.com.br/de/docs/reference/capabilities/index.md)). `timetable.track-entries.list` und `timetable.tour-entries.list` sind begrenzte Listen: Ein Ergebnis, das nicht in den Runtime-Slot passt, wird gekürzt (`truncated=true`). `internal.road-vehicles.make-basic` ist INTERNAL und wird sowohl von der CLI als auch von der API mit `OL_E_RUNTIME_OPERATION_UNKNOWN` abgelehnt.

## Flags

Jedes Flag aus `CliInput.KnownFlags`. „Phase“ ist *Startzeit* (bestimmt die `LaunchSpec`/den Plan einer neuen Sitzung), *Runtime* (wirkt auf eine laufende Sitzung) oder *Steuerung* (ändert das Verhalten der CLI selbst). Flags, die nur aus Kompatibilitätsgründen geparst werden (`CliInput.AcceptedNoEffectFlags`), sind in ihrer Zeile gekennzeichnet.

<a id="control-and-output"></a>
### Steuerung und Ausgabe

| Flag | Syntax und Werte | Standard | Phase | Stabilität | Verhalten |
|---|---|---|---|---|---|
| `/?` | `/?` | aus | Steuerung | STABLE_BETA | Gibt den Verwendungstext aus, Exit `0`. |
| `/help` | `/help` | aus | Steuerung | STABLE_BETA | Wie `/?`. (Das einzelne Wort `help` gibt stattdessen den strukturierten Katalog zurück.) |
| `/version` | `/version` | aus | Steuerung | STABLE_BETA | Envelope `version`, Exit `0`. Wird vor jedem anderen Befehl außer `/silent` ausgewertet. |
| `/json` | `/json` oder `--json` | aus | Steuerung | STABLE_BETA | Gibt JSON-Envelopes aus; erzwingt außerdem Konsolenausgabe auch unter `OmsiLaunchW.exe`. |
| `/quiet` | `/quiet` | aus | Steuerung | ACCEPTED_FOR_COMPATIBILITY / CURRENTLY_NO_EFFECT | Setzt `CliInput.Quiet`; nichts liest es aus. |
| `/silent` | `/silent` (auch `--silent`) | aus | Steuerung | EXPERIMENTAL | Delegiert die gesamte Befehlszeile an `OmsiLaunchW.exe` und gibt `0` zurück, sobald der Host-Prozess gestartet ist. Das Ergebnis der Sitzung wird von `OmsiLaunchW.exe` (Meldungsfenster, Tray-Symbol), `.omsilaunch\diagnostics` und dem lokalen Steuerungsendpunkt gemeldet. Die Delegierung und die Fehlerdialoge sind zur Laufzeit validiert (Runtime-Closure `T04`); siehe [OmsiLaunchW.exe](https://omsilaunch.omsimods.com.br/de/docs/reference/omsilaunchw/index.md). |
| `/serve` | `/serve` | aus | Steuerung | ACCEPTED_FOR_COMPATIBILITY / CURRENTLY_NO_EFFECT | Setzt `CliInput.Serve`; nichts liest es aus. Der Steuerungsendpunkt wird von einem Eigentümer immer gestartet. |
| `/verbose` | `/verbose` | aus | Startzeit | PARTIAL | `DiagnosticsSpec.Verbose`. Die Werte werden in der Spec mitgeführt; ihre Wirkung beschränkt sich auf den Host-Trace unter `.omsilaunch\diagnostics`. |
| `/log` | `/log` | an (`DiagnosticsSpec.Log` ist standardmäßig `true`) | Startzeit | PARTIAL | `DiagnosticsSpec.Log`. Faktisch immer aktiv. |
| `/logall` | `/logall` | aus | Startzeit | PARTIAL | Setzt `Verbose`, `ProcessTrace`, `PluginTrace` und `NativeTrace` gemeinsam. |
| `/omsi-logall` | `/omsi-logall` | aus | Startzeit | PARTIAL | `DiagnosticsSpec.OmsiLogAll`. |
| `/trace` | `/trace` | aus | Startzeit | PARTIAL | Alias von `/trace-process`. |
| `/trace-process` | `/trace-process` | aus | Startzeit | PARTIAL | `DiagnosticsSpec.ProcessTrace`. |
| `/trace-plugin` | `/trace-plugin` | aus | Startzeit | PARTIAL | `DiagnosticsSpec.PluginTrace`. |
| `/trace-native` | `/trace-native` | aus | Startzeit | PARTIAL | `DiagnosticsSpec.NativeTrace`. |

<a id="planning-validation-and-harnesses"></a>
### Planung, Validierung und Harnesses

| Flag | Syntax und Werte | Standard | Phase | Stabilität | Verhalten |
|---|---|---|---|---|---|
| `/plan` | `/plan` | aus | Startzeit | STABLE_BETA | Erstellt den `SessionPlan` und gibt ihn aus, startet OMSI nicht. Exit `0` bei `IsRunnable`, sonst `1`. Erfordert eine Startauswahl (`/new`, `/saved`, `/spec` oder ein Installationsargument); `/plan` allein ohne weitere Angaben führt `detect` aus. |
| `/validate` | `/validate` | aus | Startzeit | STABLE_BETA | In diesem Build identisch mit `/plan`. |
| `/runtime-batch` | `/runtime-batch` | aus | Runtime (Eigentümer) | INTERNAL | Validierungs-Harness: Führt nach `Running` den Satz von Leseoperationen aus und schreibt `<sessionId>-runtime-read-batch.json`. |
| `/runtime-write-batch` | `/runtime-write-batch` | aus | Runtime (Eigentümer) | INTERNAL | Validierungs-Harness: Lesevorgänge plus `time.set`, `camera.set` und `vehicle.variable.set` mit Wiederherstellung; schreibt `<sessionId>-runtime-write-batch.json`. |
| `/d3d-batch` | `/d3d-batch` | aus | Runtime (Eigentümer) | INTERNAL | Validierungs-Harness für den D3D-Textur-Lebenszyklus; schreibt `<sessionId>-d3d-wave-d-batch.json`. |
| `/runtime` | `/runtime:<operation>` | keiner | Runtime | STABLE_BETA (Dispatch) | Wählt eine öffentliche Runtime-Operation per ID aus. Client-Modus (kein Installationsargument): wird an den Eigentümer weitergeleitet. Eigentümermodus: wird nach `Running` einmal ausgeführt. Unbekannte IDs: `OL_E_RUNTIME_OPERATION_UNKNOWN`, Exit `2`. |
| `/runtime-arg` | `/runtime-arg:<key>=<value>` (wiederholbar) | keiner | Runtime | STABLE_BETA (Dispatch) | Runtime-Argument; gleichwertig mit `--key=value`. Fehlendes `=`: `/runtime-arg requires key=value`, Exit `2`. |

<a id="world-selection"></a>
### Weltauswahl

| Flag | Syntax und Werte | Standard | Phase | Stabilität | Verhalten |
|---|---|---|---|---|---|
| `/new` | `/new` | `WorldMode.NewMap` ist der Standardmodus, ein Start wird jedoch nur angefordert, wenn eines von `/new`, `/saved`, `/last`, `/spec` vorhanden ist | Startzeit | STABLE_BETA | NEW_MAP. Erfordert `/map` und `/entrypoint-index` (ein Plan ohne angegebenen Index des Einstiegspunkts meldet `OL_E_ENTRYPOINT_REQUIRED`; ohne `/map` wird keine Karte aufgelöst). `/new` wählt nie stillschweigend eine Karte aus. |
| `/saved` | `/saved:<file.osn>` | keiner | Startzeit | STABLE_BETA | SAVED_SITUATION. Karte und Position stammen aus der `.osn`; `/map`, `/entrypoint`, `/entrypoint-index` werden zusammen mit `/saved` abgelehnt (Exit `2`). Fehlende Situation: `OL_E_SITUATION_NOT_FOUND`; fehlende Karte der Situation: `OL_E_SITUATION_MAP_NOT_FOUND`. |
| `/last` | `/last` | keiner | Startzeit | UNAVAILABLE | LAST_MAP_STATE. Erzeugt auf diesem Profil immer `OL_E_CAPABILITY_UNAVAILABLE` (nicht ausführbar, Exit `1`); ein zeitstempelbasierter Rückgriff auf eine `.osn` findet nicht statt. |
| `/map` | `/map:<identity>` (zum Beispiel `maps\Grundorf\global.cfg`) | keiner | Startzeit | STABLE_BETA | Kartenidentität für `/new` oder der Geltungsbereich für `/list:Entrypoints`. Unbekannt: `OL_E_MAP_NOT_FOUND`. |
| `/entrypoint` | `/entrypoint:<identity>` | keiner | Startzeit | UNAVAILABLE | Einstiegspunkt nach Bezeichnung. Durch ein Gate gesperrt: Der Plan erfasst `world.entrypoint-identity` als `RUNTIME_PARTIAL` und wird nicht ausführbar (`OL_E_CAPABILITY_UNAVAILABLE`). Schließt sich gegenseitig mit `/entrypoint-index` aus (die Identität hat Vorrang und löscht den Index). |
| `/entrypoint-index` | `/entrypoint-index:<n>`, `0..2147483647` | keiner | Startzeit | STABLE_BETA | Index des Einstiegspunkts in der angezeigten Liste (1-basiert, wie OMSI ihn anzeigt). Erforderlich für einen ausführbaren NEW_MAP-Plan. |

<a id="date-time-and-weather"></a>
### Datum, Uhrzeit und Wetter

Alle vier werden akzeptiert und in die `LaunchSpec` übernommen, aber der native Startpfad wendet sie nicht an: Der Planer erfasst sie als `STATICALLY_PARTIAL` **und fügt `OL_E_CAPABILITY_UNAVAILABLE` hinzu, sodass der Plan NICHT AUSFÜHRBAR ist (Exit `1`)**. Eine `/spec`-Datei oder ein Sitzungsprofil, das sie setzt, hat dieselbe Wirkung.

| Flag | Syntax und Werte | Standard | Phase | Stabilität | Verhalten |
|---|---|---|---|---|---|
| `/date` | `/date:<yyyy-mm-dd>` oder `/date:system` | nicht gesetzt | Startzeit | UNAVAILABLE | `DateSpec` explizit/System. Nicht parsbarer Wert: `OL_E_INVALID_ARGUMENT`, Exit `2`. |
| `/time` | `/time:<hh:mm[:ss]>` oder `/time:system` | nicht gesetzt | Startzeit | UNAVAILABLE | `TimeSpec` explizit/System. |
| `/year` | `/year:<n>` oder `/year:system` | nicht gesetzt | Startzeit | UNAVAILABLE | `YearSpec`. |
| `/weather` | `/weather:<preset>` | nicht gesetzt | Startzeit | UNAVAILABLE | `WeatherMode.Preset`. |
| `/weather-icao` | `/weather-icao:<code>` | nicht gesetzt | Startzeit | UNAVAILABLE | `WeatherMode.Icao`. |
| `/weather-real` | `/weather-real` | nicht gesetzt | Startzeit | UNAVAILABLE | `WeatherMode.RealCurrent`. Das letzte von `/weather`, `/weather-icao`, `/weather-real` hat Vorrang. |

<a id="player-vehicle"></a>
### Spielerfahrzeug

Wird akzeptiert und gegen die Installation aufgelöst, aber von der Runtime nicht angewendet: Jedes gesetzte Feld ist `STATICALLY_PARTIAL` und fügt `OL_E_CAPABILITY_UNAVAILABLE` hinzu (Plan NICHT AUSFÜHRBAR, Exit `1`).

| Flag | Syntax und Werte | Standard | Phase | Stabilität | Verhalten |
|---|---|---|---|---|---|
| `/vehicle` | `/vehicle:<identity>` (`Vehicles\...\*.bus`) | nicht gesetzt | Startzeit | UNAVAILABLE | Wird zuerst aufgelöst (`OL_E_VEHICLE_NOT_FOUND`, falls unbekannt). |
| `/repaint` | `/repaint:<id>` | nicht gesetzt | Startzeit | UNAVAILABLE | Wird nur zusammen mit `/vehicle` aufgelöst (`OL_E_REPAINT_NOT_FOUND`). |
| `/hof` | `/hof:<id>` | nicht gesetzt | Startzeit | UNAVAILABLE | `OL_E_HOF_NOT_FOUND`, falls unbekannt. |
| `/fleet` | `/fleet:<n>` | nicht gesetzt | Startzeit | UNAVAILABLE | Fuhrparknummer. |
| `/registration` | `/registration:<text>` | nicht gesetzt | Startzeit | UNAVAILABLE | Kennzeichen. |
| `/no-vehicle` | `/no-vehicle` | aus | Startzeit | STABLE_BETA | Entfernt ein etwaiges Spielerfahrzeug aus der Vorlage (`/spec` oder Profil). Unbedenklich. |

<a id="configuration-overlays"></a>
### Konfigurations-Overlays

| Flag | Syntax und Werte | Standard | Phase | Stabilität | Verhalten |
|---|---|---|---|---|---|
| `/set` | `/set:<key>=<value>` (wiederholbar; Groß-/Kleinschreibung der Schlüssel wird nicht beachtet) | keiner | Startzeit | STABLE_BETA | Semantisches `options.cfg`-Overlay aus `ConfigurationCatalog` (zum Beispiel `graphics.maxFPS=60`, `traffic.randomVehicles=150`). Unbekannter Schlüssel: `OL_E_UNKNOWN_SETTING` (Exit `2`); schreibgeschützter Schlüssel (`advanced.multithreadingCalculate`, `advanced.multithreadingTextureLoad`, `graphics.texture`, `graphics.textureFilter`): `OL_E_SETTING_NOT_WRITABLE` (Exit `2`); Wert außerhalb des Bereichs oder fehlerhaft: `OL_E_INVALID_SETTING_VALUE`, wenn das Overlay erstellt wird. Das Overlay ist eine Sitzungsänderung: als Snapshot gesichert, vor dem Start von OMSI angewendet, beim Stopp Byte für Byte wiederhergestellt (RV-005 `RUNTIME_PASS`). Konflikte mit einem Schlüssel, der einer Voreinstellung eines ausgewählten Profils gehört: `OL_E_SESSION_PROFILE_OVERRIDE_CONFLICT`. |

<a id="splash-presentation"></a>
### Startbild-Darstellung

| Flag | Syntax und Werte | Standard | Phase | Stabilität | Verhalten |
|---|---|---|---|---|---|
| `/splash` | `/splash:Managed`, `/splash:Native`, `/splash:Unset` (Groß-/Kleinschreibung wird nicht beachtet) | `Managed` | Startzeit | STABLE_BETA | `Managed`: Die mitgelieferten 24-Bit-BMPs mit 640x480 werden einmalig nach `<root>\.omsilaunch\assets\splash` kopiert, und `GUI\NewSplashscreen_ENG.bmp` sowie `GUI\NewSplashscreen_<lang>.bmp` werden transaktional überlagert und exakt wiederhergestellt (RV-006 `RUNTIME_PASS`). `Native`/`Unset` (Aliase): OMSI-Dateien bleiben unberührt. Fehlender Wert: `/splash requires Unset, Native, or Managed`, Exit `2`. |
| `/splash-language` | `/splash-language:PTB|ENG|DEU|FRA` (auch `pt-BR`, `de`, `fr`, `en`; alles andere fällt auf `ENG` zurück) | `[language]` aus `options.cfg`, sonst `ENG` | Startzeit | STABLE_BETA | Wählt die lokalisierte Zieldatei aus. |
| `/splash-assets` | `/splash-assets:<directory>` (relative Pfade werden unterhalb des Installationsstammverzeichnisses aufgelöst) | `<root>\.omsilaunch\assets\splash`, sonst der mitgelieferte Satz | Startzeit | STABLE_BETA | Benutzerdefiniertes Asset-Verzeichnis; muss `ENG.bmp` und, für eine nicht englische Sprache, `<lang>.bmp` enthalten. Fehler: `OL_E_SPLASH_ASSET_DIRECTORY_MISSING`, `OL_E_SPLASH_ASSET_MISSING`, `OL_E_SPLASH_FORMAT_UNSUPPORTED` (im Plan als `OL_E_SESSION_PRESENTATION_INVALID` gemeldet; nicht ausführbar). |

<a id="internet-textures"></a>
### Internettexturen

| Flag | Syntax und Werte | Standard | Phase | Stabilität | Verhalten |
|---|---|---|---|---|---|
| `/internet-textures` | `/internet-textures:Native|Disabled|Override` | `Native` | Startzeit | EXPERIMENTAL | `Native`: unberührt. `Disabled`: Der profilierte prozessinterne Downloader wird unterdrückt. `Override`: Das angegebene `.itx`-Profil wird als `Texture\standard.itx` überlagert; jedes darin aufgeführte HTTP(S)-Ziel sowie `Texture\standard.ipr` werden zu Sitzungslöschungen (für die Sitzung entfernt, beim Stopp wiederhergestellt). Fehlender Wert: Exit `2`. |
| `/internet-textures-profile` | `/internet-textures-profile:<file.itx>` | keiner | Startzeit | EXPERIMENTAL | Erforderlich mit `Override` (`OL_E_ITX_PROFILE_REQUIRED`, Exit `2`). `OL_E_ITX_PROFILE_MISSING`, `OL_E_ITX_PROFILE_INVALID` (muss aus Zeilenpaaren aus URL und Ziel mit `http`/`https`-URLs bestehen), `OL_E_ITX_TARGET_OUTSIDE_TEXTURE_PATH` (Ziele müssen unter `Texture\` aufgelöst werden, ohne absolute Pfade, `..` oder Analysepunkte). |

<a id="session-profiles"></a>
### Sitzungsprofile

| Flag | Syntax und Werte | Standard | Phase | Stabilität | Verhalten |
|---|---|---|---|---|---|
| `/predefined-profile` | `/predefined-profile:<id>` | keiner | Startzeit | STABLE_BETA (Kompilierung; offline `OmsiLaunch.ProfileTests`) | Lädt `<root>\.omsilaunch\session-profiles\<id>\profile.yaml` (siehe [Sitzungsprofile](https://omsilaunch.omsimods.com.br/de/docs/reference/session-profiles/index.md)). Erfordert `/predefined-profile-index` (`OL_E_SESSION_PROFILE_PRESET_NOT_FOUND`, Exit `2`). Der Block `new:` gilt nur mit `/new`; `compatibility.maps` wird für `/new` und `/saved` erzwungen (`OL_E_SESSION_PROFILE_MAP_MISMATCH`). Explizite Flags, die mit einem dem Profil gehörenden Feld kollidieren, werden mit `OL_E_SESSION_PROFILE_OVERRIDE_CONFLICT` abgelehnt (`CliInput.RejectProfileConflicts`): Karte/Einstiegspunkt/Datum/Uhrzeit/Jahr/Wetter, wenn der Block `new:` sie besitzt, `/set`-Schlüssel, die der Voreinstellung gehören, Startbild-Flags, wenn die Voreinstellung `presentation` enthält, Internettextur-Flags, wenn sie `internet-textures` enthält, Timeouts, wenn sie `behavior` enthält. |
| `/predefined-profile-index` | `/predefined-profile-index:<1..5>` | keiner | Startzeit | STABLE_BETA | Wählt die Voreinstellung über `index` aus. Außerhalb des Bereichs: Exit `2`. |

<a id="launchspec-file"></a>
### LaunchSpec-Datei

| Flag | Syntax und Werte | Standard | Phase | Stabilität | Verhalten |
|---|---|---|---|---|---|
| `/spec` | `/spec:<path.json>` | keiner | Startzeit | STABLE_BETA (Loader offline getestet; Sitzungssemantik identisch mit Flags) | Lädt eine `LaunchSpec`-JSON-Datei als Vorlage (siehe [LaunchSpec](https://omsilaunch.omsimods.com.br/de/docs/reference/launchspec/index.md)) und kennzeichnet einen Start als angefordert. Regeln (`LaunchSpecJson`): Die Datei muss existieren (`OL_E_SPEC_NOT_FOUND`, Exit `6`); höchstens 1 MiB (`OL_E_SPEC_TOO_LARGE`, Exit `2`); die Wurzel muss ein Objekt sein (`OL_E_SPEC_INVALID`); bei Eigenschaftsnamen wird die Groß-/Kleinschreibung nicht beachtet; `//`-Kommentare und nachgestellte Kommas sind erlaubt; Tiefe höchstens 32; jede unbekannte Eigenschaft wird mit ihrem JSON-Pfad abgelehnt (`OL_E_SPEC_UNKNOWN_PROPERTY: $.Presentation.Foo`, Exit `2`). |

**Vorrang** (`CliInput.BuildSpecAsync`): Standardwerte → `/spec`-Datei → `/predefined-profile` (ersetzt `Installation` und `World`, wendet dann das Profil an) → explizite Flags. Ein explizites Installationsargument hat Vorrang vor `RootPath` in der Spec. `/no-vehicle` entfernt das Spielerfahrzeug der Spec; `/vehicle` und die zugehörigen Flags werden Feld für Feld damit zusammengeführt. `/set`-Schlüssel werden in `Environment.General` zusammengeführt. `/splash`, `/splash-language`, `/splash-assets`, `/internet-textures`, `/internet-textures-profile` überschreiben nur, wenn sie angegeben sind. `/startup-timeout` und `/shutdown-timeout` überschreiben nur, wenn sie angegeben sind; `Presentation.SuppressTrayIcon` stammt ausschließlich aus der Spec (kein Flag). Diagnose-Flags werden mit den `Diagnostics` der Spec per ODER verknüpft.

<a id="content-discovery"></a>
### Inhaltserkennung

| Flag | Syntax und Werte | Standard | Phase | Stabilität | Verhalten |
|---|---|---|---|---|---|
| `/list` | `/list:<category>`; Kategorien sind die `ContentQueryKind`-Werte `Maps`, `Situations`, `Vehicles`, `Repaints`, `Hofs`, `FleetNumbers`, `Registrations`, `Addons`, `Entrypoints` (Groß-/Kleinschreibung wird nicht beachtet) | keiner | lokal, keine Sitzung | STABLE_BETA | `DiscoverAsync` über die Installation; Envelope `content.list` mit Einträgen `Identity`, `Kind`, `DisplayName`; Exit `0`. Unbekannte Kategorie: `Unknown discovery category`, Exit `2`. Analysepunkte (Junctions/symbolische Verknüpfungen) werden übersprungen, OMSI-Dateien werden als Windows-1252 gelesen. |
| `/vehicle-scope` | `/vehicle-scope:<vehicle identity>` | keiner | lokal | STABLE_BETA | Geltungsbereich, der für jede Kategorie außer `Entrypoints` weitergegeben wird; diese verwendet `/map` als Geltungsbereich. |

<a id="timeouts-and-observation"></a>
### Timeouts und Beobachtung

| Flag | Syntax und Werte | Standard | Phase | Stabilität | Verhalten |
|---|---|---|---|---|---|
| `/startup-timeout` | `/startup-timeout:<1..600>` Sekunden | Wert aus Spec/Profil, sonst `180` | Startzeit | STABLE_BETA | `Behavior.StartupTimeoutSeconds`. Der Eigentümer wartet diesen Wert plus 5 s auf `Running`; `OL_E_STARTUP_TIMEOUT` beendet die Sitzung mit Exit `1`. |
| `/shutdown-timeout` | `/shutdown-timeout:<1..600>` Sekunden | Wert aus Spec/Profil, sonst `30` | Startzeit | ACCEPTED_FOR_COMPATIBILITY / CURRENTLY_NO_EFFECT | Wird in `Behavior.ShutdownTimeoutSeconds` übernommen; der Supervisor verwendet ihn in diesem Build nicht (OMSI wird beendet, nicht zum Schließen aufgefordert). |
| `/observe-seconds` | `/observe-seconds:<0..2147483647>` | keiner (läuft, bis OMSI sich beendet oder ein Stopp angefordert wird) | Runtime (Eigentümer) | STABLE_BETA | Obergrenze für die Laufphase: Nach `n` Sekunden im Zustand `Running` wird der kanonische Stopp angefordert. Ein Stopp über Tray oder Pipe oder das Beenden von OMSI beendet sie früher. `0` stoppt unmittelbar nach `Running`. |

### Recovery

| Flag | Syntax und Werte | Standard | Phase | Stabilität | Verhalten |
|---|---|---|---|---|---|
| `/recovery-status` | `/recovery-status` | aus | lokal | STABLE_BETA | Meldet, ob `<root>\.omsilaunch\journal.json` aussteht (`pending`), stellt nie wieder her; Exit `0`. Übernimmt die Installations-Lease: `OL_E_INSTALLATION_BUSY` (Exit `7`), solange ein Eigentümer sie hält. |
| `/recover` | `/recover` | aus | lokal | STABLE_BETA | Stellt ein ausstehendes Journal wieder her (Backups werden zuerst gegen den SHA-256 des Snapshots geprüft; `OL_E_RECOVERY_BACKUP_CORRUPT`, `OL_E_RECOVERY_ABSENT_OWNERSHIP_MISMATCH`, `OL_W_RESTORE_FOREIGN_FILE_RETAINED` werden in `diagnostics` gemeldet). Exit `0`, wenn nichts ausstand oder die Wiederherstellung abgeschlossen wurde; `8`, wenn ein Journal ausstand und bestehen bleibt. Wird mit `OL_E_INSTALLATION_BUSY` verweigert, solange der im Journal erfasste OMSI-Prozess (PID, Erstellungszeit, Pfad der ausführbaren Datei) oder, bei einem Journal nach `HandoffCreated` ohne PID, irgendein `Omsi.exe` aus diesem Stammverzeichnis aktiv ist. Jeder Sitzungsstart führt dieselbe Recovery automatisch aus, bevor die Installation gelesen wird. |

<a id="output-formats"></a>
## Ausgabeformate

- **Erfolgs-Envelope** (`CliInput.WriteEnvelope`, mit `--json`): `{"ok": true, "command": "<name>", "protocol_version": "0.1", "result": <object>}`, eingerückt. Weitergeleitete Antworten auf `session status` und `events read` enthalten zusätzlich ein Element `metadata`, wenn ältere Ereignisse ausgelassen wurden, damit die Antwort in den Steuerungs-Frame passt (`events_dropped_count`, siehe [lokale Steuerung](https://omsilaunch.omsimods.com.br/de/docs/reference/local-control/index.md)). Ohne `--json` wird nur `<object>` als eingerücktes JSON ausgegeben, gefolgt von `Note: <n> older events were omitted to fit the control frame.`, wenn Ereignisse verworfen wurden.
- **Fehler-Envelope** (`CliInput.WriteError`, mit `--json`): `{"ok": false, "command": "<name>", "protocol_version": "0.1", "error": {"code": "OL_E_...", "category": "<category>", "message": "..."}}`. Ohne `--json`: `OL_E_<CODE>: message` in einer Zeile. Kategorien: `invalid_argument`, `unsupported_profile`, `session`, `runtime`, `not_found`, `transaction`, `internal`. Unter `OmsiLaunchW.exe` werden derselbe Code und dieselbe Meldung in einem Meldungsfenster angezeigt.
- **Plan und Status** (`CliInput.Write`): Die Datensätze `SessionPlan`, `SessionStatus` und `RuntimeCommandResult` werden als eingerücktes JSON **ohne** Envelope ausgegeben. Ohne `--json` wird ein Plan als `Plan: READY profile=Omsi23004_692EBFBF` oder `Plan: NOT RUNNABLE profile=...` zusammengefasst; andere Datensätze werden weiterhin als JSON ausgegeben. Enum-Werte werden als Ganzzahlen serialisiert (`SessionState.Running` ist `14`, `Completed` ist `18`, `Failed` ist `19`).
- In Envelopes verwendete Befehlsnamen: `silent`, `version`, `capabilities`, `help`, `profiles`, `detect`, `recover`, `content.list`, `session`, `session.status`, `session.stop`, `events.read`, `events.watch`, `events watch`, `installation`, `cli`, `session profile` sowie die Runtime-Operations-ID bei weitergeleiteten Runtime-Befehlen.
- Unter `OmsiLaunchW.exe` (`OMSILAUNCH_WINDOWS_HOST=1`) wird nichts auf die Konsole geschrieben, sofern nicht `--json` angegeben ist.

<a id="errors-per-command"></a>
## Fehler pro Befehl

| Befehl | Typische Fehlercodes | Exit |
|---|---|---|
| Jeder Parse-Fehler | `OL_E_INVALID_ARGUMENT`, Sitzungsprofil-Codes (`OL_E_SESSION_PROFILE_*`) | `2` |
| `/silent` | `OL_E_WINDOWS_HOST_MISSING`, `OL_E_WINDOWS_HOST_START_FAILED` | `7` |
| Client-Route, `/runtime` (Client) | `OL_E_RUNTIME_OPERATION_UNKNOWN`, `OL_E_RUNTIME_ARGUMENT_REQUIRED` (`2`); `OL_E_NO_ACTIVE_SESSION` (`4`); vom Eigentümer zurückgegebene `OL_E_CONTROL_*`, `OL_E_RUNTIME_*`, z. B. `OL_E_RUNTIME_REQUEST_TIMEOUT`, `OL_E_RUNTIME_OBJECT_HANDLE_STALE`, `OL_E_RUNTIME_SETTING_NOT_PERSISTENT`, `OL_E_RUNTIME_RESPONSE_TOO_LARGE`, `OL_E_SESSION_NOT_RUNNING` (`7`) | `2`, `4`, `7` |
| `session status`, `session stop`, `events read`, `events watch` | `OL_E_NO_ACTIVE_SESSION` (`4`); `OL_E_CONTROL_SESSION_MISMATCH`, `OL_E_CONTROL_PROTOCOL`, `OL_E_CONTROL_FAILED` (`7`) | `4`, `7` |
| Vorabprüfung des Eigentümers | `OL_E_RUNTIME_INSTALLATION_INCOMPLETE`, `OL_E_SESSION_ALREADY_ACTIVE` | `7` |
| `/recovery-status`, `/recover` | `OL_E_INSTALLATION_BUSY` (`7`); `OL_E_RECOVERY_*`, `OL_E_RESTORE_FAILED` (`8`); ausstehend, aber nicht wiederhergestellt (`8`) | `7`, `8` |
| `/list` | unbekannte Kategorie (`2`); `OL_E_INSTALLATION_NOT_FOUND`/fehlende Verzeichnisse (`6`) | `2`, `6` |
| `/spec` | `OL_E_SPEC_NOT_FOUND` (`6`); `OL_E_SPEC_TOO_LARGE`, `OL_E_SPEC_INVALID`, `OL_E_SPEC_UNKNOWN_PROPERTY` (`2`) | `2`, `6` |
| `/set` | `OL_E_UNKNOWN_SETTING`, `OL_E_SETTING_NOT_WRITABLE`, `OL_E_INVALID_SETTING_VALUE` | `2` |
| `/plan`, `/validate`, Start | Plandiagnosen: `OL_E_PERMANENT_PLUGIN_MISSING`, `OL_E_PERMANENT_PLUGIN_HASH_MISMATCH`, `OL_E_PERMANENT_PLUGIN_MANIFEST_INCOMPLETE` (installierte Plugin-Closure), `OL_E_UNSUPPORTED_BUILD`, `OL_E_UNSUPPORTED_OPERATING_SYSTEM`, `OL_E_INSTALLATION_NOT_WRITABLE`, `OL_E_MAP_NOT_FOUND`, `OL_E_ENTRYPOINT_REQUIRED`, `OL_E_SITUATION_NOT_FOUND`, `OL_E_SITUATION_MAP_NOT_FOUND`, `OL_E_VEHICLE_NOT_FOUND`, `OL_E_REPAINT_NOT_FOUND`, `OL_E_HOF_NOT_FOUND`, `OL_E_CAPABILITY_UNAVAILABLE`, `OL_E_SESSION_PRESENTATION_INVALID`, `OL_E_RUNTIME_ARTIFACT_MISSING`, `plugin.integrity.reference` (informativ) | `1` |
| Sitzungsstart | `OL_E_PLAN_NOT_RUNNABLE` (erneute Planung beim Start, `1`); `OL_E_PERMANENT_PLUGIN_MISSING`, `OL_E_PERMANENT_PLUGIN_HASH_MISMATCH`, `OL_E_PERMANENT_PLUGIN_MANIFEST_INCOMPLETE`, `OL_E_RELEASE_MANIFEST_INVALID` (normalerweise von der Planung als Plandiagnose gemeldet, Exit `1`; `7` nur, wenn sich die Plugin-Dateien zwischen Planung und Start ändern), `OL_E_INSTALLATION_BUSY` (`7`); `OL_E_PROCESS_START_FAILED`, `OL_E_PROCESS_EXITED_EARLY`, `OL_E_STARTUP_TIMEOUT`, `OL_E_WORLD_START_FAILED`, `OL_E_SITUATION_LOAD_FAILED`, `OL_E_PLUGIN_NOT_LOADED` (Sitzung `Failed`, `1`) | `1`, `7` |
| Unbehandelte Ausnahme an beliebiger Stelle | klassifiziert durch `CliProgram.Classify` (siehe [Exitcodes](https://omsilaunch.omsimods.com.br/de/docs/reference/exit-codes/index.md)) | `2`..`10` |

<a id="environment"></a>
## Umgebung

| Variable | Gesetzt von | Wirkung |
|---|---|---|
| `OMSILAUNCH_WINDOWS_HOST=1` | `OmsiLaunchW.exe` | `WindowsHost.IsActive`: Konsolenausgabe unterdrückt, Fehler als Meldungsfenster, `/silent` wird nicht erneut delegiert. |

<a id="see-also"></a>
## Siehe auch

[CLI-Beispiele](https://omsilaunch.omsimods.com.br/de/docs/reference/cli-examples/index.md) · [OmsiLaunchW.exe](https://omsilaunch.omsimods.com.br/de/docs/reference/omsilaunchw/index.md) · [Exitcodes](https://omsilaunch.omsimods.com.br/de/docs/reference/exit-codes/index.md) · [Fehler](https://omsilaunch.omsimods.com.br/de/docs/reference/errors/index.md) · [lokale Steuerung](https://omsilaunch.omsimods.com.br/de/docs/reference/local-control/index.md) · [Windows-Tray](https://omsilaunch.omsimods.com.br/de/docs/reference/windows-tray/index.md) · [Runtime-Steuerung](https://omsilaunch.omsimods.com.br/de/docs/reference/runtime-control/index.md) · [Capabilities](https://omsilaunch.omsimods.com.br/de/docs/reference/capabilities/index.md) · [LaunchSpec](https://omsilaunch.omsimods.com.br/de/docs/reference/launchspec/index.md) · [Sitzungsprofile](https://omsilaunch.omsimods.com.br/de/docs/reference/session-profiles/index.md) · [Paketierung](https://omsilaunch.omsimods.com.br/de/docs/reference/packaging/index.md) · [Kompatibilität](https://omsilaunch.omsimods.com.br/de/docs/reference/compatibility/index.md) · [bekannte Einschränkungen](https://omsilaunch.omsimods.com.br/de/docs/reference/known-limitations/index.md) · [öffentliche API](https://omsilaunch.omsimods.com.br/de/docs/reference/public-api/index.md)