Traduzione della pagina originale in inglese di OmsiLaunch 0.1.0-beta3. La pagina inglese è normativa: in caso di differenze prevalgono la pagina inglese e il codice.
Questa pagina è il riferimento completo e normativo della riga di comando di OmsiLaunch 0.1.0-beta3: i tre eseguibili, la grammatica degli argomenti, l'ordine di dispatch, ogni parola di comando, ogni route gerarchica, ogni flag, gli envelope di output e il comportamento in caso di errore di ciascun comando. È generata da tools\OmsiLaunch.Cli\Program.cs (CliProgram.RunAsync, OwnerSession.RunAsync, CliInput.Parse, CliInput.KnownFlags, CliInput.AcceptedNoEffectFlags, CliInput.CommandWordsAccepted, CliInput.HierarchicalRoutes, CliInput.BuildSpecAsync, CliEventWatch), da tools\OmsiLaunch.Cli\LaunchSpecJson.cs e dai due shim nativi sotto tools\OmsiLaunch.Bootstrapper. I risultati del processo sono elencati in codici di uscita; i codici di errore in errori; invocazioni commentate in esempi CLI.
Bootstrapper nativo (OmsiLaunch.Bootstrapper.cpp): risolve la propria directory, suddivide la riga di comando in token con CommandLineToArgvW, individua hostfxr tramite nethost.dll ed esegue OmsiLaunch.Controller.dll con gli stessi argomenti.
L'output viene scritto sulla console; il codice di uscita del processo è quello del controller gestito, oppure un codice dello shim 100..106 se non è stato possibile avviare l'host .NET.
OmsiLaunchW.exe
Windows (GUI)
Lo stesso shim (OmsiLaunch.WindowsHost.cpp) compilato per il sottosistema Windows. Imposta la variabile d'ambiente OMSILAUNCH_WINDOWS_HOST=1 prima di avviare il controller.
Nessuna console: l'output su console viene soppresso a meno che non sia indicato --json (WindowsHost.SuppressConsole), gli errori vengono mostrati in finestre di messaggio (WindowsHost.ShowFailure: messaggio, Code: OL_E_... e l'indicazione See .omsilaunch\diagnostics for details.), e un errore dello shim 100..106 viene mostrato come OmsiLaunch could not start the .NET host (code N). Comportamento completo: riferimento di OmsiLaunchW.exe.
OmsiLaunch.Controller.dll
Gestito (x64, net6.0-windows, Windows Forms)
Il controller vero e proprio. Non viene mai invocato direttamente dagli utenti; entrambi gli shim passano il percorso del controller come primo argomento dell'host, in modo che non compaia mai nell'elenco pubblico degli argomenti.
Richiede il runtime .NET 6 x64 con Microsoft.WindowsDesktop.App; vedere installazione.
nethost.dll deve trovarsi accanto agli shim. Gli shim non leggono alcun argomento; ogni argomento raggiunge CliInput.Parse invariato, quindi OmsiLaunch.exe e OmsiLaunchW.exe accettano esattamente la stessa sintassi.
Un flag. La chiave non distingue tra maiuscole e minuscole; il valore è tutto ciò che segue il primo :. Le chiavi sconosciute falliscono con OL_E_INVALID_ARGUMENT (Unknown argument: ...), uscita 2.
--key=value
Un argomento runtime per l'operazione runtime selezionata (per esempio --handle=rv-000001). Qualsiasi token -- contenente = è un argomento runtime, mai un flag.
--json, /json
Output strutturato (vedere Formati di output). --json è l'unico token -- senza = che abbia significato; viene interpretato come il flag /json.
parola semplice
Se non è ancora stata incontrata alcuna parola di comando e la parola è una delle parole di comando, diventa il comando. Una volta presente una parola di comando, ogni parola semplice successiva è una parola di comando (la route). Altrimenti la prima parola semplice è la radice dell'installazione e ogni parola semplice successiva viene aggiunta alla route.
Conseguenze: una route gerarchica (time get) non può essere combinata con un argomento di installazione posto dopo di essa (time get D:\OMSI è la route sconosciuta time get d:\omsi, uscita 2). D:\OMSI time get viene accettato ma è in modalità owner (viene avviata una nuova sessione e l'operazione viene eseguita una volta al suo interno). Gli errori di parsing (ArgumentException, FormatException, InvalidDataException, OverflowException) e gli errori del profilo di sessione (SessionProfileException) vengono segnalati prima che venga eseguito qualsiasi cosa, sempre con uscita 2.
Un argomento di installazione esplicito come parola semplice prevale su RootPath in un file /spec (CliInput.BuildSpecAsync).
. indica la directory che contiene l'eseguibile (AppContext.BaseDirectory), mai la directory di lavoro del chiamante (CliInput.ResolveInstallationRoot). Un pacchetto portabile si basa su questo comportamento.
Quando l'argomento è omesso, anche le operazioni in modalità owner (/new, /saved, /spec, /list, /recovery-status, /recover) usano la directory dell'eseguibile. Il percorso viene normalizzato con Path.GetFullPath.
I comandi in modalità client non accettano mai un argomento di installazione: si rivolgono all'endpoint di controllo locale dell'installazione in cui si trova l'eseguibile (AppContext.BaseDirectory). Vedere controllo locale.
Owner: il processo che pianifica, avvia, supervisiona e ripristina una sessione (OwnerSession.RunAsync). Detiene il lease dell'installazione (blocco esclusivo, Local\OmsiLaunch.Installation.<sha256(root)>) e la transazione di configurazione, espone l'endpoint di controllo locale finché la sessione è attiva e mostra l'icona nell'area di notifica. Esattamente un owner per installazione: se un owner risponde già a session.status sull'endpoint di controllo, un secondo avvio fallisce con OL_E_SESSION_ALREADY_ACTIVE (uscita 7).
Client: qualsiasi invocazione senza argomento di installazione che invia session status, session stop, events read, events watch o un'operazione runtime. Viene inoltrata tramite la pipe di controllo locale; senza un owner fallisce con OL_E_NO_ACTIVE_SESSION (uscita 4).
/silent (se non già in esecuzione sotto OmsiLaunchW.exe): avvia OmsiLaunchW.exe dalla directory dell'eseguibile tramite ShellExecute (senza ereditarietà degli handle) con gli stessi argomenti esclusi /silent/--silent, scrive l'envelope silent (delegated, host_process_id) e restituisce 0. Il processo della console non attende la sessione; vedere OmsiLaunchW.exe. OL_E_WINDOWS_HOST_MISSING / OL_E_WINDOWS_HOST_START_FAILED restituiscono 7.
/version: envelope version con product, version (versione informativa dell'assembly, impostata da OmsiLaunch.Version.props, 0.1.0-beta3), protocol_version (0.1), supported_family (OMSI_2_3_004_COMMON); uscita 0.
capabilities: envelope con ogni descrittore PublicStableBeta o PublicExperimental di PublicCapabilityRegistry; uscita 0.
help [family]: envelope help con usage, product_version, protocol_version, family e i commands pubblici (CliRoute, Description, Classification, RuntimeValidation), facoltativamente filtrati per famiglia; uscita 0.
profiles: envelope con family e le varianti di eseguibile supported (ALTERNATE_LAA692EBFBF..., runtime_validated=true; l'hash Steam LAA 7DAB063D... con validation_status=pending_beta_field_validation); uscita 0.
Operazione runtime client (nessun argomento di installazione e una route o /runtime:): gli argomenti vengono validati tramite PublicCapabilityRegistry.ValidateRuntimeArguments (OL_E_RUNTIME_OPERATION_UNKNOWN, OL_E_RUNTIME_ARGUMENT_REQUIRED, uscita 2), quindi runtime.execute viene inoltrato con un timeout di 8 s (30 s per road-vehicles.spawn).
Client session status (750 ms), session stop (vincolato all'id della sessione attiva, 750 ms), events read (750 ms), events watch (interroga ogni 250 ms fino a Ctrl+C).
detect, oppure nessun argomento (nessuna installazione, nessun comando, nessun /?, nessun /spec, nessun flag di avvio, nessun flag di recupero, nessun /list): enumera i processi Omsi e sonda l'endpoint di controllo (250 ms); envelope detect; uscita 0.
/? o /help: stampa il testo di utilizzo, uscita 0. Qualsiasi altra invocazione che abbia una parola di comando ma nessuna route eseguibile (per esempio d3d da solo o session status D:\OMSI) stampa il testo di utilizzo ed esce con 2.
Modalità owner. Precondizioni: plugins\OmsiLaunch.Plugin.opl e plugins\OmsiLaunch.Native.x86.dll devono esistere accanto all'eseguibile (OL_E_RUNTIME_INSTALLATION_INCOMPLETE, uscita 7). release-manifest.json accanto all'eseguibile, se presente, fornisce gli hash attesi dei plugin.
/recovery-status / /recover: RecoverPendingAsync; envelope recover con pending, recovered, diagnostics; uscita 8 solo quando è stato richiesto un ripristino che non è stato completato, altrimenti 0.
Costruisce il LaunchSpec (BuildSpecAsync), lo pianifica (PlanSessionAsync) e stampa il piano. /plan o /validate: uscita 0 se IsRunnable, altrimenti 1. Un piano non eseguibile non avvia mai OMSI (uscita 1); sotto OmsiLaunchW.exe un avvio con un piano non eseguibile mostra la sua ultima diagnostica OL_E_ in una finestra di messaggio (audit della documentazione BUG-06). La pianificazione verifica inoltre la chiusura del plugin permanente installato rispetto a release-manifest.json, quindi un plugin mancante o alterato rende il piano non eseguibile (OL_E_PERMANENT_PLUGIN_*).
Sonda la presenza di un owner esistente (OL_E_SESSION_ALREADY_ACTIVE, uscita 7), quindi OwnerSession.RunAsync.
StartSessionAsync(plan). Da questo punto ogni percorso di uscita raggiunge CloseAsync in un blocco finally: eccezioni, Ctrl+C (Console.CancelKeyPress), chiusura della console / disconnessione (AppDomain.ProcessExit con un budget di 4 s per arresto + ripristino; quanto rimane viene recuperato tramite il journal all'avvio successivo), "End session" dall'area di notifica, session.stop tramite pipe e /observe-seconds.
L'icona nell'area di notifica viene creata a meno che nello spec non sia impostato Presentation.SuppressTrayIcon.
Attende Running per StartupTimeoutSeconds + 5 secondi. Lo stato viene stampato. Se lo stato non è Running, uscita 1 (OmsiLaunchW.exe mostra The OMSI session did not reach gameplay. con l'ultima diagnostica OL_E_ o OL_E_SESSION_START_FAILED).
I batch di validazione (/runtime-batch, /runtime-write-batch, /d3d-batch) vengono eseguiti e scrivono i propri artefatti.
Si avvia l'endpoint di controllo locale.
/runtime:<operation> viene eseguito una volta (5 s, 15 s per road-vehicles.spawn); il risultato viene scritto in <root>\.omsilaunch\diagnostics\<sessionId>-runtime-operation.json e stampato. Un comando runtime non riuscito non termina mai la sessione (viene invece stampato runtime_error).
Attesa: con /observe-seconds:n la sessione viene arrestata dopo n secondi oppure prima, in seguito a un arresto dall'area di notifica o tramite pipe, oppure quando OMSI termina; senza questo flag l'owner attende finché OMSI termina o viene richiesto un arresto.
Viene stampato lo stato finale; uscita 0 se Completed, altrimenti 1.
session.stop, "End session" dall'area di notifica, Ctrl+C e CloseAsync richiedono tutti l'arresto canonico: OMSI viene terminato con TerminateProcess (la routine di chiusura propria di OMSI non viene eseguita e options.cfg non viene riscritto da OMSI), quindi ogni file di proprietà della sessione viene ripristinato. Vedere ciclo di vita della sessione e transazioni e recupero.
Ogni parola accettata in prima posizione (CliInput.CommandWordsAccepted):
Parola
Scopo
Modalità
Note
capabilities
Elenca le capability pubbliche
Locale, senza sessione
Envelope capabilities.
profiles
Elenca le varianti di Omsi.exe supportate
Locale, senza sessione
Envelope profiles.
detect
Segnala i processi Omsi.exe e un eventuale owner attivo
Locale, senza sessione
È anche il comportamento predefinito quando non viene fornito alcun argomento. Stati: NO_OMSI_FOUND, OMSI_FOUND_UNMANAGED, UNKNOWN_BINARY_FOUND per singolo processo quando il binario non può essere ispezionato; active_omsilaunch_instance, managed_session.
help
Utilizzo e catalogo pubblico dei comandi
Locale, senza sessione
help <family> filtra per famiglia di capability (session, time, weather, map, camera, vehicles, player, humans, timetable, scripts, constants, curves, hof, drivers, tickets, d3d, events).
session
session status, session stop
Client
Esattamente una parola successiva; qualsiasi altra cosa stampa l'utilizzo, uscita 2. session plan/session start sono nomi di route dell'API, non parole della CLI: usare /plan e /new.
events
events read, events watch
Client
read restituisce una volta l'elenco limitato degli eventi; watch stampa ogni nuovo evento (in base a Sequence) come envelope events.watch ogni 250 ms fino a Ctrl+C (uscita 0), 4 quando nessun owner risponde, 7 in caso di errore di controllo.
time
time get, time set
Route client
weather
weather get, weather set, weather actual get
Route client
map
map get
Route client
camera
camera get, camera set, camera lock, camera unlock
d3dnon ha alcuna route gerarchica: d3d texture ... è una route sconosciuta (uscita 2) e d3d da solo stampa l'utilizzo (uscita 2). Le operazioni D3D si raggiungono con /runtime:d3d.status, /runtime:d3d.texture.create e così via (vedere Operazioni senza route).
CliInput.HierarchicalRoutes associa una route in minuscolo a un id di operazione runtime. Tutte le route richiedono una sessione Running e vengono eseguite tramite la mailbox runtime (ExecuteRuntimeAsync). Le scritture runtime modificano solo lo stato in memoria di OMSI: non toccano mai i file, non fanno parte della transazione di configurazione e non vengono annullate all'arresto (OMSI viene terminato). La stabilità segue PublicCapabilityRegistry e la matrice di validazione; dettagli e campi dei risultati sono in controllo runtime.
Route
Operazione runtime
Tipo
Richiede Running
Modifica OMSI
Partecipazione al ripristino
Stabilità
Note
time get
time.read
Read
Sì
No
Nessuna
STABLE_BETA
Campi di orologio e calendario.
time set
time.set
Write
Sì
Sì (orologio in memoria)
Nessuna, non annullata
EXPERIMENTAL
Per esempio --minute=<0..59>; scrittura, rilettura e ripristino validati il 2026-09-20.
weather get
weather.read
Read
Sì
No
Nessuna
STABLE_BETA
weather set
weather.set
Write
Sì
No (sempre rifiutata)
Nessuna
UNAVAILABLE
Restituisce OL_E_RUNTIME_SETTING_NOT_PERSISTENT; OMSI sovrascrive il valore al successivo aggiornamento meteo.
weather actual get
weather.actual.read
Read
Sì
No
Nessuna
EXPERIMENTAL
Stato del controller meteo attuale/ICAO.
map get
map.read
Read
Sì
No
Nessuna
STABLE_BETA
Nome della mappa, file, descrizione, numero di tile, intervallo di anni e lato di circolazione; validato nuovamente a runtime sullo slot della mappa corretto.
camera get
camera.read
Read
Sì
No
Nessuna
STABLE_BETA
camera set
camera.set
Write
Sì
Sì (valori scalari della telecamera, ad es. --field_of_view=)
Nessuna, non annullata
EXPERIMENTAL
Scrittura/rilettura del FOV validate.
camera lock
camera.lock
Action
Sì
Sì (policy con ambito di sessione)
Nessuna
EXPERIMENTAL
Richiede --family=<0..3> (conducente=0, passeggero=1, esterna=2, mappa=3), --preset=<n> facoltativo (famiglia 0 o 1). Richiede un veicolo del giocatore (per esempio una situazione salvata). Validato a runtime nella chiusura runtime (CAM01); la stringa RuntimeValidation del registro indica ancora STATICALLY_VALIDATED (vedere capability).
camera unlock
camera.unlock
Action
Sì
Sì
Nessuna
EXPERIMENTAL
Rilascia la policy impostata da camera lock (CAM01).
vehicles list
road-vehicles.list
Read
Sì
No
Nessuna
STABLE_BETA
Restituisce handle rv-NNNNNN con ambito di sessione.
Questi id di operazione pubblici (PublicCapabilityRegistry.PublicRuntimeOperationIds) non hanno una route gerarchica e vengono invocati con /runtime:<operation> più --key=value o /runtime-arg:key=value: timetable.rv-files.list, timetable.track-entries.list, timetable.tour-entries.list, d3d.status, d3d.texture.create (width, height, format obbligatori; levels facoltativo), d3d.texture.describe (handle; level facoltativo), d3d.texture.update (handle, width, height, pixels_base64 obbligatori; level, x, y facoltativi), d3d.texture.release (handle). Le operazioni D3D sono EXPERIMENTAL; il ciclo di vita delle texture e l'invalidazione al reset del dispositivo sono validati a runtime (chiusura runtime H02, D01; vedere capability). timetable.track-entries.list e timetable.tour-entries.list sono elenchi limitati: un risultato che non rientra nello slot runtime viene accorciato (truncated=true). internal.road-vehicles.make-basic è INTERNAL e viene rifiutato con OL_E_RUNTIME_OPERATION_UNKNOWN sia dalla CLI sia dall'API.
Ogni flag di CliInput.KnownFlags. La colonna «Fase» indica avvio (determina il LaunchSpec/piano di una nuova sessione), runtime (agisce su una sessione in esecuzione) o controllo (modifica il comportamento della CLI stessa). I flag interpretati solo per compatibilità (CliInput.AcceptedNoEffectFlags) sono indicati nella rispettiva riga.
Uguale a /?. (La parola semplice help restituisce invece il catalogo strutturato.)
/version
/version
disattivato
controllo
STABLE_BETA
Envelope version, uscita 0. Valutato prima di ogni altro comando tranne /silent.
/json
/json o --json
disattivato
controllo
STABLE_BETA
Emette envelope JSON; forza inoltre l'output su console anche sotto OmsiLaunchW.exe.
/quiet
/quiet
disattivato
controllo
ACCEPTED_FOR_COMPATIBILITY / CURRENTLY_NO_EFFECT
Imposta CliInput.Quiet; nessun componente lo legge.
/silent
/silent (anche --silent)
disattivato
controllo
EXPERIMENTAL
Delega l'intera riga di comando a OmsiLaunchW.exe e restituisce 0 non appena il processo host è stato avviato. L'esito della sessione viene segnalato da OmsiLaunchW.exe (finestre di messaggio, icona nell'area di notifica), da .omsilaunch\diagnostics e dall'endpoint di controllo locale. La delega e le finestre di dialogo di errore sono validate a runtime (chiusura runtime T04); vedere OmsiLaunchW.exe.
/serve
/serve
disattivato
controllo
ACCEPTED_FOR_COMPATIBILITY / CURRENTLY_NO_EFFECT
Imposta CliInput.Serve; nessun componente lo legge. L'endpoint di controllo viene sempre avviato da un owner.
/verbose
/verbose
disattivato
avvio
PARTIAL
DiagnosticsSpec.Verbose. I valori vengono trasportati nello spec; il loro effetto è limitato alla traccia dell'host sotto .omsilaunch\diagnostics.
/log
/log
attivato (DiagnosticsSpec.Log è true per impostazione predefinita)
avvio
PARTIAL
DiagnosticsSpec.Log. Di fatto sempre attivo.
/logall
/logall
disattivato
avvio
PARTIAL
Imposta insieme Verbose, ProcessTrace, PluginTrace e NativeTrace.
Costruisce e stampa il SessionPlan, senza avviare OMSI. Uscita 0 quando IsRunnable, altrimenti 1. Richiede una selezione di avvio (/new, /saved, /spec o un argomento di installazione); /plan da solo, senza nient'altro, esegue detect.
/validate
/validate
disattivato
avvio
STABLE_BETA
Identico a /plan in questo build.
/runtime-batch
/runtime-batch
disattivato
runtime (owner)
INTERNAL
Harness di validazione: dopo Running, esegue l'insieme delle operazioni di lettura e scrive <sessionId>-runtime-read-batch.json.
/runtime-write-batch
/runtime-write-batch
disattivato
runtime (owner)
INTERNAL
Harness di validazione: letture più time.set, camera.set e vehicle.variable.set con ripristino; scrive <sessionId>-runtime-write-batch.json.
/d3d-batch
/d3d-batch
disattivato
runtime (owner)
INTERNAL
Harness di validazione per il ciclo di vita delle texture D3D; scrive <sessionId>-d3d-wave-d-batch.json.
/runtime
/runtime:<operation>
nessuno
runtime
STABLE_BETA (dispatch)
Seleziona un'operazione runtime pubblica tramite id. Modalità client (nessun argomento di installazione): inoltrata all'owner. Modalità owner: eseguita una volta dopo Running. Id sconosciuti: OL_E_RUNTIME_OPERATION_UNKNOWN, uscita 2.
WorldMode.NewMap è la modalità predefinita, ma un avvio viene richiesto solo quando è presente uno tra /new, /saved, /last, /spec
avvio
STABLE_BETA
NEW_MAP. Richiede /map e /entrypoint-index (un piano senza un indice di punto di ingresso presentato segnala OL_E_ENTRYPOINT_REQUIRED; senza /map non viene risolta alcuna mappa). /new non seleziona mai una mappa in modo implicito.
/saved
/saved:<file.osn>
nessuno
avvio
STABLE_BETA
SAVED_SITUATION. Mappa e posizione provengono dal file .osn; /map, /entrypoint, /entrypoint-index vengono rifiutati insieme a /saved (uscita 2). Situazione mancante: OL_E_SITUATION_NOT_FOUND; mappa della situazione mancante: OL_E_SITUATION_MAP_NOT_FOUND.
/last
/last
nessuno
avvio
UNAVAILABLE
LAST_MAP_STATE. Produce sempre OL_E_CAPABILITY_UNAVAILABLE (non eseguibile, uscita 1) su questo profilo; non viene eseguito alcun ripiego su un file .osn basato sulla data.
/map
/map:<identity> (per esempio maps\Grundorf\global.cfg)
nessuno
avvio
STABLE_BETA
Identità della mappa per /new, oppure l'ambito per /list:Entrypoints. Sconosciuta: OL_E_MAP_NOT_FOUND.
/entrypoint
/entrypoint:<identity>
nessuno
avvio
UNAVAILABLE
Punto di ingresso per etichetta. Soggetto a gate: il piano registra world.entrypoint-identity come RUNTIME_PARTIAL e diventa non eseguibile (OL_E_CAPABILITY_UNAVAILABLE). Mutuamente esclusivo con /entrypoint-index (l'identità prevale e azzera l'indice).
/entrypoint-index
/entrypoint-index:<n>, 0..2147483647
nessuno
avvio
STABLE_BETA
Indice del punto di ingresso nell'elenco presentato (a partire da 1, come lo presenta OMSI). Obbligatorio per un piano NEW_MAP eseguibile.
Tutti e quattro vengono accettati e trasportati nel LaunchSpec, ma il percorso di avvio nativo non li applica: il pianificatore li registra come STATICALLY_PARTIALe aggiunge OL_E_CAPABILITY_UNAVAILABLE, quindi il piano è NOT RUNNABLE (uscita 1). Un file /spec o un profilo di sessione che li imposta ha lo stesso effetto.
Flag
Sintassi e valori
Predefinito
Fase
Stabilità
Comportamento
/date
/date:<yyyy-mm-dd> o /date:system
non impostato
avvio
UNAVAILABLE
DateSpec esplicito/di sistema. Valore non interpretabile: OL_E_INVALID_ARGUMENT, uscita 2.
/time
/time:<hh:mm[:ss]> o /time:system
non impostato
avvio
UNAVAILABLE
TimeSpec esplicito/di sistema.
/year
/year:<n> o /year:system
non impostato
avvio
UNAVAILABLE
YearSpec.
/weather
/weather:<preset>
non impostato
avvio
UNAVAILABLE
WeatherMode.Preset.
/weather-icao
/weather-icao:<code>
non impostato
avvio
UNAVAILABLE
WeatherMode.Icao.
/weather-real
/weather-real
non impostato
avvio
UNAVAILABLE
WeatherMode.RealCurrent. Prevale l'ultimo tra /weather, /weather-icao, /weather-real.
Accettati e risolti rispetto all'installazione, ma non applicati dal runtime: ogni campo impostato è STATICALLY_PARTIAL e aggiunge OL_E_CAPABILITY_UNAVAILABLE (piano NOT RUNNABLE, uscita 1).
Flag
Sintassi e valori
Predefinito
Fase
Stabilità
Comportamento
/vehicle
/vehicle:<identity> (Vehicles\...\*.bus)
non impostato
avvio
UNAVAILABLE
Risolto per primo (OL_E_VEHICLE_NOT_FOUND se sconosciuto).
/repaint
/repaint:<id>
non impostato
avvio
UNAVAILABLE
Risolto solo insieme a /vehicle (OL_E_REPAINT_NOT_FOUND).
/hof
/hof:<id>
non impostato
avvio
UNAVAILABLE
OL_E_HOF_NOT_FOUND se sconosciuto.
/fleet
/fleet:<n>
non impostato
avvio
UNAVAILABLE
Numero di flotta.
/registration
/registration:<text>
non impostato
avvio
UNAVAILABLE
Targa.
/no-vehicle
/no-vehicle
disattivato
avvio
STABLE_BETA
Rimuove qualsiasi veicolo del giocatore dalla base di partenza (/spec o profilo). Innocuo.
/set:<key>=<value> (ripetibile; chiavi senza distinzione tra maiuscole e minuscole)
nessuno
avvio
STABLE_BETA
Overlay semantico di options.cfg da ConfigurationCatalog (per esempio graphics.maxFPS=60, traffic.randomVehicles=150). Chiave sconosciuta: OL_E_UNKNOWN_SETTING (uscita 2); chiave di sola lettura (advanced.multithreadingCalculate, advanced.multithreadingTextureLoad, graphics.texture, graphics.textureFilter): OL_E_SETTING_NOT_WRITABLE (uscita 2); valore fuori intervallo o malformato: OL_E_INVALID_SETTING_VALUE al momento della costruzione dell'overlay. L'overlay è una modifica di sessione: ne viene acquisito uno snapshot, viene applicato prima dell'avvio di OMSI e ripristinato byte per byte all'arresto (RV-005 RUNTIME_PASS). Conflitti con una chiave di proprietà del preset di un profilo selezionato: OL_E_SESSION_PROFILE_OVERRIDE_CONFLICT.
/splash:Managed, /splash:Native, /splash:Unset (senza distinzione tra maiuscole e minuscole)
Managed
avvio
STABLE_BETA
Managed: le BMP a 24 bit 640x480 incluse nel pacchetto vengono copiate una volta in <root>\.omsilaunch\assets\splash e GUI\NewSplashscreen_ENG.bmp più GUI\NewSplashscreen_<lang>.bmp vengono sovrapposti in modo transazionale e ripristinati esattamente (RV-006 RUNTIME_PASS). Native/Unset (alias): i file di OMSI non vengono toccati. Valore mancante: /splash requires Unset, Native, or Managed, uscita 2.
/splash-language
/splash-language:PTB|ENG|DEU|FRA (anche pt-BR, de, fr, en; qualsiasi altro valore ricade su ENG)
[language] da options.cfg, altrimenti ENG
avvio
STABLE_BETA
Seleziona il file di destinazione localizzato.
/splash-assets
/splash-assets:<directory> (i percorsi relativi vengono risolti sotto la radice dell'installazione)
<root>\.omsilaunch\assets\splash, altrimenti l'insieme incluso nel pacchetto
avvio
STABLE_BETA
Directory di asset personalizzata; deve contenere ENG.bmp e, per una lingua diversa dall'inglese, <lang>.bmp. Errori: OL_E_SPLASH_ASSET_DIRECTORY_MISSING, OL_E_SPLASH_ASSET_MISSING, OL_E_SPLASH_FORMAT_UNSUPPORTED (riportati come OL_E_SESSION_PRESENTATION_INVALID nel piano; non eseguibile).
Native: non toccato. Disabled: il downloader profilato interno al processo viene soppresso. Override: il profilo .itx indicato viene sovrapposto come Texture\standard.itx; ogni destinazione HTTP(S) elencata in esso più Texture\standard.ipr diventano eliminazioni di sessione (rimosse per la durata della sessione, ripristinate all'arresto). Valore mancante: uscita 2.
/internet-textures-profile
/internet-textures-profile:<file.itx>
nessuno
avvio
EXPERIMENTAL
Obbligatorio con Override (OL_E_ITX_PROFILE_REQUIRED, uscita 2). OL_E_ITX_PROFILE_MISSING, OL_E_ITX_PROFILE_INVALID (devono essere coppie di righe URL/destinazione con URL http/https), OL_E_ITX_TARGET_OUTSIDE_TEXTURE_PATH (le destinazioni devono risolversi sotto Texture\ senza percorsi assoluti, .. o reparse point).
Carica <root>\.omsilaunch\session-profiles\<id>\profile.yaml (vedere profili di sessione). Richiede /predefined-profile-index (OL_E_SESSION_PROFILE_PRESET_NOT_FOUND, uscita 2). Il blocco new: si applica solo con /new; compatibility.maps viene imposto per /new e /saved (OL_E_SESSION_PROFILE_MAP_MISMATCH). I flag espliciti che entrano in conflitto con un campo di proprietà del profilo vengono rifiutati con OL_E_SESSION_PROFILE_OVERRIDE_CONFLICT (CliInput.RejectProfileConflicts): mappa/punto di ingresso/data/ora/anno/meteo quando ne è proprietario il blocco new:, chiavi /set di proprietà del preset, flag dello splash quando il preset contiene presentation, flag delle internet texture quando contiene internet-textures, timeout quando contiene behavior.
/predefined-profile-index
/predefined-profile-index:<1..5>
nessuno
avvio
STABLE_BETA
Seleziona il preset tramite index. Fuori intervallo: uscita 2.
STABLE_BETA (loader testato offline; semantica di sessione identica a quella dei flag)
Carica un file JSON LaunchSpec come base di partenza (vedere LaunchSpec) e contrassegna un avvio come richiesto. Regole (LaunchSpecJson): il file deve esistere (OL_E_SPEC_NOT_FOUND, uscita 6); al massimo 1 MiB (OL_E_SPEC_TOO_LARGE, uscita 2); la radice deve essere un oggetto (OL_E_SPEC_INVALID); nomi delle proprietà senza distinzione tra maiuscole e minuscole; commenti // e virgole finali consentiti; profondità al massimo 32; ogni proprietà sconosciuta viene rifiutata con il relativo percorso JSON (OL_E_SPEC_UNKNOWN_PROPERTY: $.Presentation.Foo, uscita 2).
Precedenza (CliInput.BuildSpecAsync): valori predefiniti → file /spec → /predefined-profile (sostituisce Installation e World, quindi applica il profilo) → flag espliciti. Un argomento di installazione esplicito prevale su RootPath nello spec. /no-vehicle rimuove il veicolo del giocatore dello spec; /vehicle e i flag affini vi si fondono campo per campo. Le chiavi /set si fondono in Environment.General. /splash, /splash-language, /splash-assets, /internet-textures, /internet-textures-profile sovrascrivono solo se indicati. /startup-timeout e /shutdown-timeout sovrascrivono solo se indicati; Presentation.SuppressTrayIcon proviene solo dallo spec (nessun flag). I flag di diagnostica vengono combinati in OR con Diagnostics dello spec.
/list:<category>; le categorie sono i valori di ContentQueryKindMaps, Situations, Vehicles, Repaints, Hofs, FleetNumbers, Registrations, Addons, Entrypoints (senza distinzione tra maiuscole e minuscole)
nessuno
locale, senza sessione
STABLE_BETA
DiscoverAsync sull'installazione; envelope content.list con voci Identity, Kind, DisplayName; uscita 0. Categoria sconosciuta: Unknown discovery category, uscita 2. I reparse point (junction/collegamenti simbolici) vengono ignorati, i file di OMSI vengono letti come Windows-1252.
/vehicle-scope
/vehicle-scope:<vehicle identity>
nessuno
locale
STABLE_BETA
Ambito inoltrato per ogni categoria tranne Entrypoints, che usa /map come ambito.
Behavior.StartupTimeoutSeconds. L'owner attende Running per questo valore più 5 s; OL_E_STARTUP_TIMEOUT termina la sessione con uscita 1.
/shutdown-timeout
/shutdown-timeout:<1..600> secondi
valore dello spec/profilo, altrimenti 30
avvio
ACCEPTED_FOR_COMPATIBILITY / CURRENTLY_NO_EFFECT
Trasportato in Behavior.ShutdownTimeoutSeconds; il supervisore non lo utilizza in questo build (OMSI viene terminato, non gli viene chiesto di chiudersi).
/observe-seconds
/observe-seconds:<0..2147483647>
nessuno (esecuzione finché OMSI termina o viene richiesto un arresto)
runtime (owner)
STABLE_BETA
Limite superiore della fase di esecuzione: dopo n secondi di Running viene richiesto l'arresto canonico. Un arresto dall'area di notifica o tramite pipe, oppure la chiusura di OMSI, la termina prima. 0 arresta immediatamente dopo Running.
Segnala se <root>\.omsilaunch\journal.json è in sospeso (pending), senza mai ripristinare; uscita 0. Acquisisce il lease dell'installazione: OL_E_INSTALLATION_BUSY (uscita 7) finché un owner lo detiene.
/recover
/recover
disattivato
locale
STABLE_BETA
Ripristina un journal in sospeso (i backup vengono prima verificati rispetto allo SHA-256 dello snapshot; OL_E_RECOVERY_BACKUP_CORRUPT, OL_E_RECOVERY_ABSENT_OWNERSHIP_MISMATCH, OL_W_RESTORE_FOREIGN_FILE_RETAINED riportati in diagnostics). Uscita 0 quando non c'era nulla in sospeso o il ripristino è stato completato; 8 quando un journal era in sospeso e rimane tale. Rifiutato con OL_E_INSTALLATION_BUSY finché il processo OMSI registrato nel journal (PID, ora di creazione, percorso dell'eseguibile) oppure, per un journal oltre HandoffCreated senza PID, qualsiasi Omsi.exe di quella radice è attivo. Ogni avvio di sessione esegue automaticamente lo stesso recupero prima di leggere l'installazione.
Envelope di successo (CliInput.WriteEnvelope, con --json): {"ok": true, "command": "<name>", "protocol_version": "0.1", "result": <object>}, indentato. Le risposte inoltrate di session status ed events read aggiungono un membro metadata quando eventi più vecchi sono stati esclusi per rientrare nel frame di controllo (events_dropped_count, vedere controllo locale). Senza --json viene stampato solo <object> come JSON indentato, seguito da Note: <n> older events were omitted to fit the control frame. quando alcuni eventi sono stati scartati.
Envelope di errore (CliInput.WriteError, con --json): {"ok": false, "command": "<name>", "protocol_version": "0.1", "error": {"code": "OL_E_...", "category": "<category>", "message": "..."}}. Senza --json: OL_E_<CODE>: message su una riga. Categorie: invalid_argument, unsupported_profile, session, runtime, not_found, transaction, internal. Sotto OmsiLaunchW.exe lo stesso codice e lo stesso messaggio vengono mostrati in una finestra di messaggio.
Piano e stato (CliInput.Write): i record SessionPlan, SessionStatus e RuntimeCommandResult vengono stampati come JSON indentato senza envelope. Senza --json un piano viene riassunto come Plan: READY profile=Omsi23004_692EBFBF o Plan: NOT RUNNABLE profile=...; gli altri record vengono comunque stampati come JSON. I valori enum vengono serializzati come interi (SessionState.Running è 14, Completed è 18, Failed è 19).
Nomi di comando usati negli envelope: silent, version, capabilities, help, profiles, detect, recover, content.list, session, session.status, session.stop, events.read, events.watch, events watch, installation, cli, session profile e l'id dell'operazione runtime per i comandi runtime inoltrati.
Sotto OmsiLaunchW.exe (OMSILAUNCH_WINDOWS_HOST=1) non viene scritto nulla sulla console a meno che non sia indicato --json.
OL_E_PLAN_NOT_RUNNABLE (nuova pianificazione all'avvio, 1); OL_E_PERMANENT_PLUGIN_MISSING, OL_E_PERMANENT_PLUGIN_HASH_MISMATCH, OL_E_PERMANENT_PLUGIN_MANIFEST_INCOMPLETE, OL_E_RELEASE_MANIFEST_INVALID (normalmente segnalati dalla pianificazione come diagnostica del piano, uscita 1; 7 solo se i file del plugin cambiano tra la pianificazione e l'avvio), 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 (sessione Failed, 1)
