Primera sesión

Documentación de la versión v0.1.0-beta.3Ver fuente en GitHub

Traducción de la página original en inglés de OmsiLaunch 0.1.0-beta3. La página en inglés es la referencia normativa: si difieren, prevalecen la página en inglés y el código.

Esta página recorre la primera sesión gestionada de OMSI con OmsiLaunch 0.1.0-beta3: planificar sin iniciar OMSI, iniciar con flags explícitos, iniciar con un perfil de sesión predefinido, controlar y detener la sesión, y localizar los diagnósticos después. Se da por hecho que el paquete está instalado como se describe en instalación. Cada flag se especifica en la referencia de la CLI; hay más invocaciones en ejemplos de la CLI.

Qué hace una sesión#

Una sesión es una transacción en torno a un proceso de OMSI: OmsiLaunch toma un snapshot de los archivos que va a tocar (de forma predeterminada, los dos mapas de bits del splash bajo GUI\, más options.cfg cuando se solicitan overlays con /set), escribe un diario duradero bajo .omsilaunch\, aplica los overlays, inicia Omsi.exe con el plugin permanente, espera hasta que se llega a la fase de juego (Running), mantiene la sesión controlable y, al final, termina OMSI y restaura byte a byte cada archivo tocado. /new nunca selecciona un mapa ni un punto de entrada de forma implícita: ambos deben indicarse o proceder de un archivo /spec o de un perfil de sesión.

1. Planificar (no se inicia nada)#

Ejecuta desde la raíz de OMSI; la instalación toma de forma predeterminada el directorio que contiene OmsiLaunch.exe.

OmsiLaunch.exe /list:Maps
OmsiLaunch.exe /list:Entrypoints /map:maps\Grundorf\global.cfg
OmsiLaunch.exe /new /map:maps\Grundorf\global.cfg /entrypoint-index:1 /plan --json

El plan debe indicar "IsRunnable": true (salida 0). Enumera TouchedFiles y PlannedMutations, de modo que puedes ver exactamente qué va a cubrir la sesión con overlays. Corrige cualquier diagnóstico OL_E_ antes de continuar; todavía no se ha escrito nada.

La especificación de ejemplo incluida en el paquete hace lo mismo con un archivo:

OmsiLaunch.exe /spec:.omsilaunch\examples\release-session.example.json /plan

2. Iniciar con flags explícitos#

OmsiLaunch.exe /new /map:maps\Grundorf\global.cfg /entrypoint-index:1

Lo que ocurre, en orden:

Se imprime el plan (Plan: READY profile=Omsi23004_692EBFBF).
Recuperación de cualquier diario pendiente anterior, adquisición del lease, snapshot, diario, overlays, comprobación de integridad del plugin, inicio de Omsi.exe.
Aparece el icono de la bandeja (OmsiLaunch is running, es decir, OmsiLaunch se está ejecutando); consulta bandeja de Windows.
Cuando se llega a la fase de juego, se imprime el estado Running como JSON ("State": 14). El timeout de arranque predeterminado es de 180 s (se cambia con /startup-timeout:<1..600>).
La consola permanece conectada hasta que termina la sesión. No cierres la ventana de la consola para detenerla: usa uno de los métodos de detención que se indican más abajo.

Añadidos opcionales para la primera ejecución:

/set:graphics.maxFPS=60 (un overlay de options.cfg, restaurado al final);
/splash:Unset para dejar intacta la pantalla de presentación (splash) de OMSI, o /splash-language:DEU para elegir el splash gestionado localizado;
/observe-seconds:30 para detenerla automáticamente 30 s después de Running (útil para una prueba de humo);
--json para obtener una salida estructurada.

Los flags que solicitan una fecha, hora, año, tiempo meteorológico o un vehículo del jugador (/date, /time, /year, /weather*, /vehicle, ...) se aceptan, pero esta build no puede aplicarlos: el plan pasa a ser NOT RUNNABLE con OL_E_CAPABILITY_UNAVAILABLE. No los uses.

3. Iniciar con un perfil de sesión predefinido#

Un perfil de sesión es un archivo YAML bajo <root>\.omsilaunch\session-profiles\<id>\profile.yaml que fija el mapa, el punto de entrada y hasta cinco presets de ajustes (esquema omsilaunch.session-profile/v1; referencia completa en perfiles de sesión). Crea D:\OMSI 2\.omsilaunch\session-profiles\grundorf-quick\profile.yaml:

schema: omsilaunch.session-profile/v1
id: grundorf-quick
name: Grundorf quick start
author: You
version: "1.0"
compatibility:
  maps:
    - maps\Grundorf\global.cfg
new:
  map: maps\Grundorf\global.cfg
  entrypoint-index: 1
presets:
  - index: 1
    id: low
    name: Low detail
    settings:
      graphics.maxFPS: 30
      graphics.tileDistance: 3
  - index: 2
    id: high
    name: High detail
    settings:
      graphics.maxFPS: 60
      graphics.tileDistance: 8

Después:

OmsiLaunch.exe /predefined-profile:grundorf-quick /predefined-profile-index:2 /new /plan
OmsiLaunch.exe /predefined-profile:grundorf-quick /predefined-profile-index:2 /new

Reglas que conviene recordar: el id debe ser igual al nombre del directorio; el índice es 1..5; los flags explícitos que sobrescribirían un campo que pertenece al perfil (/map, /entrypoint-index, una clave de /set que pertenece al preset, los flags del splash cuando el preset tiene presentation) se rechazan con OL_E_SESSION_PROFILE_OVERRIDE_CONFLICT (salida 2); el bloque new: solo se aplica con /new; con /saved:<file.osn>, el mapa de la situación debe figurar en compatibility.maps. El archivo incluido en el paquete .omsilaunch\examples\session-profiles\rmg-leste\profile.yaml ilustra el esquema completo, pero su bloque new: establece date, time y weather, que esta build no puede aplicar, así que cópialo solo después de quitar esas claves.

4. Controlar la sesión en ejecución#

Desde una segunda consola en el mismo directorio (sin argumento de instalación):

OmsiLaunch.exe session status --json
OmsiLaunch.exe events watch
OmsiLaunch.exe time get
OmsiLaunch.exe vehicles list
OmsiLaunch.exe vehicles get --handle=rv-000001

Estos comandos pasan por la canalización de control local de esta instalación (control local); la salida 4 significa que aquí no se está ejecutando ningún propietario.

5. Detener#

Cualquiera de estos métodos finaliza la sesión de la misma manera (se termina OMSI, luego se restaura cada archivo tocado y después se eliminan el diario y la copia de seguridad):

Método	Notas
Icono de la bandeja → `End session` → confirmar	Disponible tanto en sesiones de `OmsiLaunch.exe` como de `OmsiLaunchW.exe`.
`OmsiLaunch.exe session stop`	Desde otra consola; vuelve inmediatamente y el propietario completa la restauración.
Ctrl+C en la consola del propietario	Solicita la detención; el propietario espera a la restauración antes de salir.
`/observe-seconds:<n>`	Detención automática `n` segundos después de `Running`.
OMSI termina por sí mismo	El propietario detecta `ProcessExited` y restaura.

La rutina de cierre propia de OMSI no se ejecuta, por lo que OMSI no reescribe options.cfg al salir; esto es intencionado para que la restauración sea exacta. Cerrar la ventana de la consola del propietario con el botón X solo da 4 s a la restauración; si no terminó, el siguiente inicio (o OmsiLaunch.exe /recover) la completa a partir del diario. El código de salida del propietario es 0 cuando la sesión terminó en Completed.

6. Dónde mirar después#

Ubicación	Contenido
Salida de la consola / `--json`	Plan, estado `Running`, estado final (`"State": 18` = `Completed`).
`<root>\.omsilaunch\diagnostics\<sessionId>-host.log`	La traza del host de la sesión (límites de la transacción, inicio del proceso, handoff del plugin, llegada a la fase de juego, restauración).
`<root>\.omsilaunch\diagnostics\<sessionId>-runtime-operation.json`	Resultado de una operación `/runtime:` ejecutada por el propietario.
`<root>\.omsilaunch\diagnostics\tray-host.log`	Eventos del indicador de la bandeja.
`OmsiLaunch.exe /recovery-status`	`"pending": false` tras un final limpio. `true` significa que ha quedado un diario; ejecuta `OmsiLaunch.exe /recover`.

Si la sesión no llegó a la fase de juego, el estado final incluye el diagnóstico OL_E_ que falló (por ejemplo, OL_E_STARTUP_TIMEOUT, OL_E_PLUGIN_NOT_LOADED, OL_E_PROCESS_EXITED_EARLY), el código de salida es 1 y los archivos se restauraron de todos modos. Consulta códigos de salida, errores y limitaciones conocidas.

Ejecución sin consola#

OmsiLaunch.exe /silent /new /map:maps\Grundorf\global.cfg /entrypoint-index:1

delega en OmsiLaunchW.exe y devuelve 0 inmediatamente. La sesión no tiene consola; los fallos aparecen como cuadros de mensaje y el icono de la bandeja es la única superficie visible. Usa session status, events watch y el directorio de diagnósticos para seguirla. El comportamiento completo del host de Windows está en la referencia de OmsiLaunchW.exe.