Übersetzung der englischen Originalseite 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 aufgeführt, Fehlercodes unter Fehler, ausgearbeitete Aufrufe unter CLI-Beispiele.
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.
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.
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.
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). --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, 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.
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.
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 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.
/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. OL_E_WINDOWS_HOST_MISSING / OL_E_WINDOWS_HOST_START_FAILED geben 7 zurück.
/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.
capabilities: Envelope mit jedem Deskriptor PublicStableBeta oder PublicExperimental aus PublicCapabilityRegistry; Exit 0.
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.
profiles: Envelope mit family und den supported-Varianten der ausführbaren Datei (ALTERNATE_LAA692EBFBF..., runtime_validated=true; der Steam-LAA-Hash 7DAB063D... mit validation_status=pending_beta_field_validation); Exit 0.
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.
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).
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.
/? 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.
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.
/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.
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_*).
Prüfung auf einen bereits vorhandenen Eigentümer (OL_E_SESSION_ALREADY_ACTIVE, Exit 7), danach OwnerSession.RunAsync.
Lebenszyklus des Eigentümers (OwnerSession.RunAsync)#
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.
Das Tray-Symbol wird erstellt, sofern Presentation.SuppressTrayIcon nicht in der Spec gesetzt ist.
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).
Validierungs-Batches (/runtime-batch, /runtime-write-batch, /d3d-batch) laufen und schreiben ihre Artefakte.
Der lokale Steuerungsendpunkt startet.
/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).
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.
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 und Transaktionen und Recovery.
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
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).
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; Details und Ergebnisfelder finden Sie unter Runtime-Steuerung.
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).
camera unlock
camera.unlock
Action
Ja
Ja
Keine
EXPERIMENTAL
Hebt die durch camera lock gesetzte Richtlinie auf (CAM01).
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). 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.
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.
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.
/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.
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.
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.
Alle vier werden akzeptiert und in die LaunchSpec übernommen, aber der native Startpfad wendet sie nicht an: Der Planer erfasst sie als STATICALLY_PARTIALund 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.
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.
/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.
/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).
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).
Lädt <root>\.omsilaunch\session-profiles\<id>\profile.yaml (siehe Sitzungsprofile). 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.
STABLE_BETA (Loader offline getestet; Sitzungssemantik identisch mit Flags)
Lädt eine LaunchSpec-JSON-Datei als Vorlage (siehe LaunchSpec) 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.
/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.
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.
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.
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). 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.
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)
