# Códigos de error y de diagnóstico

<!-- l10n: source=reference/errors.md -->
> Traducción de la [página original en inglés](https://github.com/lmonteirotech/OmsiLaunch/blob/v0.1.0-beta.3/docs/reference/errors.md) de OmsiLaunch 0.1.0-beta3. La página en inglés es la referencia normativa: si hay diferencias, prevalecen la página en inglés y el código.

Esta página es la referencia normativa de todos los códigos de `PublicErrorCodes` (`src/OmsiLaunch.Api/PublicErrorCodes.cs`): 142 códigos de error `OL_E_` y una advertencia `OL_W_`, agrupados por categoría del catálogo, además de los códigos de diagnóstico informativos que no son errores. Para cada código se indica dónde lo genera el código actual, qué significa, cómo llega a usted (excepción lanzada, campo del resultado, diagnóstico, respuesta del plano de control o envoltorio de la CLI) y qué hacer. Los significados se tomaron de los puntos donde se generan; cuando un código está definido pero no tiene una ruta de generación actual, la página lo indica.

Páginas relacionadas: [API pública](https://omsilaunch.omsimods.com.br/es-latam/docs/reference/public-api/index.md), [códigos de salida](https://omsilaunch.omsimods.com.br/es-latam/docs/reference/exit-codes/index.md), [LaunchSpec](https://omsilaunch.omsimods.com.br/es-latam/docs/reference/launchspec/index.md), [ciclo de vida de la sesión](https://omsilaunch.omsimods.com.br/es-latam/docs/concepts/session-lifecycle/index.md), [transacciones y recuperación](https://omsilaunch.omsimods.com.br/es-latam/docs/concepts/transactions-and-recovery/index.md), [plano de control local](https://omsilaunch.omsimods.com.br/es-latam/docs/reference/local-control/index.md), [control de runtime](https://omsilaunch.omsimods.com.br/es-latam/docs/reference/runtime-control/index.md), [perfiles de sesión](https://omsilaunch.omsimods.com.br/es-latam/docs/reference/session-profiles/index.md), [plugin permanente](https://omsilaunch.omsimods.com.br/es-latam/docs/concepts/permanent-plugin/index.md).

<a id="how-codes-reach-you"></a>
## Cómo llegan los códigos

| Superficie | Significado |
| --- | --- |
| Lanzado | Una excepción cuyo `Message` comienza con el código (`InvalidOperationException`, `IOException`, `TimeoutException`, `InvalidDataException`, `FileNotFoundException`, `ArgumentException`, `SessionProfileException`). La CLI extrae el código del mensaje y lo asigna a un código de salida (`CliProgram.Classify`). |
| Diagnóstico del plan | Un `LaunchDiagnostic` en `SessionPlan.Diagnostics`; cualquier código `OL_E_` hace que `IsRunnable` sea false (CLI: plan `NOT RUNNABLE`, salida 1). |
| Diagnóstico de la sesión | Un `LaunchDiagnostic` en `SessionStatus.Diagnostics`; el estado de la sesión es `Failed` (salida 1 de la CLI). `OL_E_START_SESSION`, `OL_E_PROCESS_SUPERVISION` y `OL_E_RESTORE_FAILED` envuelven un código interno en su mensaje. |
| Resultado de runtime | `RuntimeCommandResult.ErrorCode` con `Succeeded = false`. |
| Detalle de runtime | `RuntimeCommandResult.ErrorCode = OL_E_RUNTIME_OPERATION_FAILED` y el código específico como primer token de `Values["detail"]` (con `Values["exception"]`). Así se expone cada código de `InvalidOperationException`/`ArgumentException` del lado del plugin. |
| Respuesta de control | `ErrorCode` de una respuesta del plano de control local (`LocalControlResponse`). |
| Envoltorio de la CLI | `error.code` en el envoltorio `--json`, o `<code>: <message>` en la consola; se indica el código de salida. |
| Telemetría | Un nombre de evento de runtime que el host asigna a un diagnóstico de la sesión. |

## Cli

| Código | Generado por | Significado / causa típica | Superficie | Qué hacer |
| --- | --- | --- | --- | --- |
| `OL_E_CANCELLED` | `CliProgram.Classify` | Escapó una `OperationCanceledException` (Ctrl+C o una espera del cliente cancelada). | Envoltorio de la CLI, salida 7 | Vuelva a ejecutar el comando. |
| `OL_E_INTERNAL` | `CliProgram.Classify` | Escapó una excepción sin código `OL_E_`: JSON de `/spec` mal formado, un miembro obligatorio de la especificación en null, una falla inesperada. | Envoltorio de la CLI, salida 10 | Lea el mensaje y `<root>\.omsilaunch\diagnostics\<sessionId>-host.log`; corrija la entrada; repórtelo si no tiene explicación. |
| `OL_E_TIMEOUT` | `CliProgram.Classify`; `LocalControlPlane.TryRequestAsync` | Escapó una `TimeoutException` sin código; o el cliente de control local estaba conectado a un propietario que no respondió dentro del timeout (el propietario existe, por lo que esto no se reporta como `OL_E_NO_ACTIVE_SESSION`). (Los timeouts del buzón llevan `OL_E_RUNTIME_REQUEST_TIMEOUT` en su lugar.) | Envoltorio de la CLI, respuesta de control; salida 5 desde `Classify`, salida 7 para una respuesta de control | Reintente; verifique que OMSI y el propietario respondan. |
| `OL_E_WINDOWS_HOST_MISSING` | `CliProgram.RunAsync` (`/silent`) | `OmsiLaunchW.exe` no está junto a `OmsiLaunch.exe`. | Envoltorio de la CLI, salida 7 | Reinstale el paquete. |
| `OL_E_WINDOWS_HOST_START_FAILED` | `CliProgram.RunAsync` (`/silent`) | `Process.Start` de `OmsiLaunchW.exe` no devolvió ningún proceso. | Envoltorio de la CLI, salida 7 | Revise los archivos y permisos del paquete; ejecute sin `/silent` para ver la falla. |

<a id="compatibility"></a>
## Compatibilidad

| Código | Generado por | Significado / causa típica | Superficie | Qué hacer |
| --- | --- | --- | --- | --- |
| `OL_E_BUILD_VALIDATION_FAILED` | `OmsiLaunchService.ApplyTelemetry` en `plugin.build.invalid` | La verificación del build dentro del proceso realizada por el plugin (perfil `Omsi23004_692EBFBF` más la sonda nativa de la VMT) falló aunque el host aceptó el archivo ejecutable; por ejemplo, un build Steam LAA de la lista de permitidos cuyo layout en memoria difiere, o un OMSI parcheado. | Diagnóstico de la sesión (`Failed`) | Use el build validado en runtime; consulte [compatibilidad](https://omsilaunch.omsimods.com.br/es-latam/docs/reference/compatibility/index.md). |
| `OL_E_UNSUPPORTED_BUILD` | `SessionPlanner` (`omsi.profile.OMSI23004` no disponible) | Falta `Omsi.exe`, o su tamaño/SHA-256 no coincide ni con la huella del perfil ni con la lista de permitidos. | Diagnóstico del plan | Instale el build compatible de OMSI 2.3.004. |
| `OL_E_UNSUPPORTED_OPERATING_SYSTEM` | `SessionPlanner` (`runtime.current-windows-x64` no disponible); también lo lanza `CurrentWindowsX64Platform.ValidateCurrent`, que el servicio no llama | No es Windows 10 o posterior, o el sistema operativo o el proceso host no es x64. | Diagnóstico del plan (salida 3 de la CLI cuando se lanza) | Ejecute en Windows 10 o posterior de 64 bits. |
| `OL_E_UNSUPPORTED_OS_ARCHITECTURE` | Solo `CurrentWindowsX64Platform.ValidateCurrent` | La arquitectura del sistema operativo o del host no es x64. El servicio no llama a `ValidateCurrent`; no hay ruta de generación actual. | Lanzado (`PlatformNotSupportedException`) solo por ese método | Consulte el código fuente `src/OmsiLaunch.Process/RuntimePlatform.cs`. |

<a id="content"></a>
## Contenido

| Código | Generado por | Significado / causa típica | Superficie | Qué hacer |
| --- | --- | --- | --- | --- |
| `OL_E_ENTRYPOINT_NOT_FOUND` | `LaunchValidation` | NEW_MAP sin `EntrypointIdentity` y con `PresentedEntrypointIndex` sin definir o negativo. | Diagnóstico del plan | Defina `PresentedEntrypointIndex` (`/entrypoint-index:<n>`); descubra los puntos de entrada con `/list:entrypoints /map:<id>`. |
| `OL_E_ENTRYPOINT_REQUIRED` | `SessionPlanner` (`world.presented-entrypoint` no disponible) | El mapa de NEW_MAP se resolvió, pero no hay índice presentado ni identidad. Siempre acompaña a `OL_E_ENTRYPOINT_NOT_FOUND`. | Diagnóstico del plan | Lo mismo. |
| `OL_E_HOF_NOT_FOUND` | `SessionPlanner` | `PlayerVehicle.Hof` no es un `Vehicles\...\*.hof` instalado. | Diagnóstico del plan | Use una identidad de `/list:hofs`. (De todos modos, los campos del vehículo del jugador no son ejecutables en este build.) |
| `OL_E_MAP_NOT_FOUND` | `LaunchValidation`; `SessionPlanner` | Validación: NEW_MAP con `MapIdentity` sin definir o sin la forma `maps\<dir>\global.cfg`. Planificador: el mapa no está instalado. | Diagnóstico del plan | Use una identidad de `/list:maps`. |
| `OL_E_NOT_FOUND` | `CliProgram.Classify` | Escapó una `FileNotFoundException`/`DirectoryNotFoundException` sin código; por ejemplo, `/list:repaints` con un `/vehicle-scope` desconocido, o `/list:entrypoints` con un `/map` desconocido. | Envoltorio de la CLI, salida 6 | Corrija la identidad. |
| `OL_E_REPAINT_NOT_FOUND` | `SessionPlanner` | `PlayerVehicle.Repaint` no es un elemento `.cti` del modelo (solo se verifica cuando `Model` está definido). | Diagnóstico del plan | Use una identidad de `/list:repaints /vehicle-scope:<bus>`. |
| `OL_E_SITUATION_MAP_NOT_FOUND` | `SessionPlanner` | El mapa referenciado dentro del `.osn` seleccionado no está instalado. | Diagnóstico del plan | Instale el mapa o elija otra situación. |
| `OL_E_SITUATION_NOT_FOUND` | `LaunchValidation`; `SessionPlanner` | SAVED_SITUATION sin `SituationIdentity`, o el `.osn` no está instalado. | Diagnóstico del plan | Use una identidad de `/list:situations`. |
| `OL_E_VEHICLE_NOT_FOUND` | `SessionPlanner` | `PlayerVehicle.Model` no es un `Vehicles\...\*.bus` instalado. | Diagnóstico del plan | Use una identidad de `/list:vehicles`. |

<a id="installation"></a>
## Instalación

| Código | Generado por | Significado / causa típica | Superficie | Qué hacer |
| --- | --- | --- | --- | --- |
| `OL_E_INSTALLATION_BUSY` | `InstallationLease.Acquire`; `OmsiLaunchService.RecoverPendingAsync`; `FileConfigurationTransaction.RestorePendingAsync` | El lease de la instalación (`Local\OmsiLaunch.Installation.<hash>`) lo tiene otro propietario en esta sesión de inicio de sesión de Windows, o un proceso de OMSI registrado en el journal (PID + hora de creación + ruta del archivo ejecutable; o cualquier `Omsi.exe` de la raíz para un journal posterior a `HandoffCreated` sin PID) sigue vivo. | Inicio: diagnóstico de la sesión mediante `OL_E_START_SESSION`. Recuperación: lanzado (`InvalidOperationException` / `IOException`). Salida 7 de la CLI. | Detenga el otro propietario (`session stop`) o espere a que OMSI termine; luego reintente o ejecute `/recover`. |
| `OL_E_INSTALLATION_NOT_FOUND` | `LaunchValidation` | `Installation.RootPath` está vacío. | Diagnóstico del plan | Indique el directorio de instalación. |
| `OL_E_INSTALLATION_NOT_WRITABLE` | `SessionPlanner` (`transaction.exact-restore` no disponible); también `ValidateCurrent` | La raíz no existe, tiene el atributo de solo lectura o no tiene el directorio `plugins\`. | Diagnóstico del plan | Apunte a una instalación de OMSI real y con permisos de escritura. |
| `OL_E_PERMANENT_PLUGIN_HASH_MISMATCH` | `RuntimeArtifactSet.ValidateInstalled` (plan e inicio) | Un archivo `plugins\OmsiLaunch.*` instalado difiere del hash en `release-manifest.json` (o de la closure de referencia si no hay manifiesto). | Diagnóstico del plan (plan no ejecutable, salida 1 de la CLI); diagnóstico de la sesión mediante `OL_E_START_SESSION` solo si los archivos cambian entre la planificación y el inicio | Reinstale el paquete de OmsiLaunch para que `plugins\` y el manifiesto coincidan. |
| `OL_E_PERMANENT_PLUGIN_MANIFEST_INCOMPLETE` | `RuntimeArtifactSet.ValidateInstalled` (plan e inicio) | El manifiesto no tiene una entrada para un archivo obligatorio del plugin. | Diagnóstico del plan; diagnóstico de la sesión mediante `OL_E_START_SESSION` en la misma condición de carrera anterior | Reinstale el paquete. |
| `OL_E_PERMANENT_PLUGIN_MISSING` | `RuntimeArtifactSet.ValidateInstalled` (plan e inicio) | Falta en la instalación de OMSI un archivo obligatorio `plugins\OmsiLaunch.*`, o un archivo de `plugins/` listado en `release-manifest.json` no está instalado. | Diagnóstico del plan; diagnóstico de la sesión mediante `OL_E_START_SESSION` en la misma condición de carrera anterior | Instale la closure del plugin permanente ([instalación](https://omsilaunch.omsimods.com.br/es-latam/docs/getting-started/installation/index.md)). |
| `OL_E_PLATFORM_CAPABILITY_MISSING` | Solo `CurrentWindowsX64Platform.ValidateCurrent` | `CurrentPlatformSupported` es false. El servicio no lo llama; no hay ruta de generación actual. | Lanzado solo por ese método | Consulte el código fuente. |
| `OL_E_RELEASE_MANIFEST_INVALID` | `ReleaseManifest.TryReadPluginHashes` / `ParsePluginHashes` | `release-manifest.json` está vacío, no es JSON, no tiene un arreglo `files`, o tiene una entrada sin `path`/`sha256`, un hash que no tiene 64 dígitos hexadecimales, una ruta absoluta, que contiene `:`, un segmento vacío, `.` o `..`, o una ruta listada dos veces (comparación sin distinguir mayúsculas y minúsculas, con `/` y `\` equivalentes). Se acepta un BOM UTF-8. | Plan: envuelto en `OL_E_RUNTIME_ARTIFACT_MISSING`; inicio: mediante `OL_E_START_SESSION` | Reinstale el paquete. |

## InvalidArgument

| Código | Generado por | Significado / causa típica | Superficie | Qué hacer |
| --- | --- | --- | --- | --- |
| `OL_E_INVALID_ARGUMENT` | `LaunchValidation`; `CliInput.Parse`/`Classify` | Validación: `Date.Value`/`Time.Value` definido mientras el modo no es `Explicit`. CLI: flag desconocido, valor faltante, entero o rango incorrecto, `/saved` combinado con `/map`/`/entrypoint`, ruta de comando desconocida, cualquier `ArgumentException`/`FormatException` sin código. | Diagnóstico del plan; envoltorio de la CLI, salida 2 | Corrija el argumento. |
| `OL_E_INVALID_SETTING_VALUE` | `ConfigurationCatalog.CreatePatch` (inicio) | El valor de un ajuste semántico está fuera de rango, no es booleano, no pertenece al conjunto permitido o está mal formado (`graphics.particles` necesita cuatro campos). Los valores no se validan durante la planificación. | Diagnóstico de la sesión mediante `OL_E_START_SESSION` | Use un valor de la [tabla de ajustes](https://omsilaunch.omsimods.com.br/es-latam/docs/reference/launchspec/index.md#environmentspec). |
| `OL_E_SETTING_NOT_WRITABLE` | `SessionPlanner`; `CliInput.BuildSpecAsync`; `BuildTransactionalOverlays` | La clave existe pero no admite escritura (`advanced.multithreadingCalculate`, `advanced.multithreadingTextureLoad`, `graphics.texture`, `graphics.textureFilter`). | Diagnóstico del plan; salida 2 de la CLI | Quite la clave. |
| `OL_E_UNKNOWN_SETTING` | `SessionPlanner`; `CliInput.BuildSpecAsync`; `BuildTransactionalOverlays` | La clave no está en `ConfigurationCatalog`. | Diagnóstico del plan; salida 2 de la CLI | Use una clave del catálogo. |

## LaunchSpec

| Código | Generado por | Significado / causa típica | Superficie | Qué hacer |
| --- | --- | --- | --- | --- |
| `OL_E_SPEC_INVALID` | `LaunchSpecJson.Parse` | La raíz no es un objeto JSON, o la deserialización no produjo ningún registro. | Lanzado (`InvalidDataException`), salida 2 de la CLI | Corrija el archivo ([LaunchSpec](https://omsilaunch.omsimods.com.br/es-latam/docs/reference/launchspec/index.md)). |
| `OL_E_SPEC_NOT_FOUND` | `LaunchSpecJson.LoadAsync` | El archivo de `/spec` no existe. | Lanzado (`FileNotFoundException`), salida 6 de la CLI | Verifique la ruta. |
| `OL_E_SPEC_TOO_LARGE` | `LaunchSpecJson.LoadAsync` | El archivo supera 1 MiB. | Lanzado (`InvalidDataException`), salida 2 de la CLI | Reduzca el archivo. |
| `OL_E_SPEC_UNKNOWN_PROPERTY` | `LaunchSpecJson.Validate` | Un miembro que no es una propiedad pública del registro en esa posición; mensaje `OL_E_SPEC_UNKNOWN_PROPERTY: $.Path.Name`. | Lanzado (`InvalidDataException`), salida 2 de la CLI | Quite o cambie el nombre del miembro. |

## LocalControl

| Código | Generado por | Significado / causa típica | Superficie | Qué hacer |
| --- | --- | --- | --- | --- |
| `OL_E_CONTROL_COMMAND_UNKNOWN` | Handler del propietario (`OwnerSession`) | El comando no es `session.status`, `session.events`, `session.stop` ni `runtime.execute` con un argumento `operation`. | Respuesta de control; salida 7 de la CLI | Use un comando compatible. |
| `OL_E_CONTROL_FAILED` | Cliente de la CLI (`ReportForwarded`, `CliEventWatch`) | El propietario respondió `Ok = false` sin código de error. | Envoltorio de la CLI, salida 7 | Lea el mensaje; revise la consola y los diagnósticos del propietario. |
| `OL_E_CONTROL_HANDLER_FAILED` | `LocalControlPlane.ServeAsync` | El handler del propietario lanzó una excepción cuyo mensaje no lleva ningún código `OL_E_` (por ejemplo, la sesión ya estaba cerrada), o la respuesta del handler no se pudo serializar. | Respuesta de control | Lea `session status`; reinicie el propietario si ya no existe. |
| `OL_E_CONTROL_MESSAGE_INVALID` | `LocalControlPlane` (ambos extremos) | Prefijo de longitud negativo o superior a 64 KiB (incluida una trama de solicitud demasiado grande), trama vacía, JSON `null`, una solicitud sin `Command`, o JSON que no se pudo decodificar. | Respuesta de control / envoltorio de la CLI | Use el protocolo documentado ([plano de control local](https://omsilaunch.omsimods.com.br/es-latam/docs/reference/local-control/index.md)). |
| `OL_E_CONTROL_MESSAGE_TOO_LARGE` | `LocalControlPlane.TryRequestAsync` (cliente) | La solicitud serializada del propio cliente supera 64 KiB. Se reporta al llamador; no se envía nada. | Respuesta de control / envoltorio de la CLI | Reduzca la solicitud. |
| `OL_E_CONTROL_RESPONSE_TOO_LARGE` | `LocalControlPlane.ServeAsync` (propietario) | La respuesta del propietario no cabe en la trama de 64 KiB. El propietario responde con este error tipado en lugar de descartar la respuesta. `session.status` y `session.events` nunca llegan a él: su historial de eventos se recorta empezando por los más antiguos hasta que cabe. | Respuesta de control / envoltorio de la CLI | Reintente; para los eventos, léalos con más frecuencia. |
| `OL_E_CONTROL_PROTOCOL` | `LocalControlPlane`, `TryRequestBoundAsync` | El `ProtocolVersion` de la solicitud no es `0.1`; la respuesta del propietario no se pudo decodificar o estaba vacía; el propietario cerró la conexión sin responder o la conexión se interrumpió después de establecerse; el propietario no informó ningún `SessionId`. | Respuesta de control / envoltorio de la CLI | Haga coincidir las versiones del cliente y del propietario; lea `session status`. |
| `OL_E_CONTROL_SESSION_MISMATCH` | Handler del propietario | `session.stop` o `runtime.execute` sin un `session_id` igual al de la sesión activa. | Respuesta de control; salida 7 de la CLI | Lea primero `session.status` y vincule la solicitud (la CLI lo hace automáticamente). |

<a id="other"></a>
## Otros

| Código | Generado por | Significado / causa típica | Superficie | Qué hacer |
| --- | --- | --- | --- | --- |
| `OL_E_PLAN_NOT_RUNNABLE` | `OmsiLaunchService.StartSessionAsync` | El plan recibido tiene `IsRunnable = false`, o la nueva planificación al iniciar no es ejecutable (`Omsi.exe` cambió, se quitó contenido, falta la closure del plugin); el mensaje lista los códigos `OL_E_` actuales. | Lanzado (`InvalidOperationException`); salida 1 de la CLI | Vuelva a planificar y corrija los diagnósticos listados. |

<a id="presentation"></a>
## Presentación

Todos los genera `SessionVisualAssets` (`src/OmsiLaunch.Core/SessionVisualAssets.cs`). Durante la planificación se envuelven en `OL_E_SESSION_PRESENTATION_INVALID` (el mensaje lleva el código); al iniciar se exponen mediante `OL_E_START_SESSION`.

| Código | Significado / causa típica | Qué hacer |
| --- | --- | --- |
| `OL_E_ITX_PROFILE_INVALID` | El archivo `.itx` está vacío, tiene un número impar de líneas no vacías, o una línea de URL no es una URL absoluta `http`/`https`. | Use pares de líneas URL/destino. |
| `OL_E_ITX_PROFILE_MISSING` | `OverrideProfilePath` (resuelto respecto del directorio de trabajo del proceso) no existe. Se lanza como `FileNotFoundException`. | Indique una ruta `.itx` existente. |
| `OL_E_ITX_PROFILE_REQUIRED` | `InternetTextures.Mode` es `Override` sin `OverrideProfilePath`. Salida 2 de la CLI cuando se lanza. | Proporcione `/internet-textures-profile:<file.itx>`. |
| `OL_E_ITX_TARGET_OUTSIDE_TEXTURE_PATH` | Una línea de destino es una ruta absoluta, contiene `..`, empieza con `\`, se resuelve fuera de la instalación, no tiene un componente `Texture\` o atraviesa un junction/symlink. | Use destinos relativos `Texture\...`. |
| `OL_E_SPLASH_ASSET_DIRECTORY_MISSING` | `CustomAssetDirectory` no existe. | Corrija el directorio. |
| `OL_E_SPLASH_ASSET_MISSING` | Falta `ENG.bmp` o `<LANG>.bmp` en el directorio de assets, o falta un `assets\splash\<LANG>.bmp` empaquetado al inicializar `.omsilaunch\assets\splash`. | Proporcione los BMP / reinstale el paquete. |
| `OL_E_SPLASH_FORMAT_UNSUPPORTED` | Un BMP de splash no es un mapa de bits `BM` de 640×480 y 24 bits. | Convierta la imagen. |

<a id="process"></a>
## Proceso

| Código | Generado por | Significado / causa típica | Superficie | Qué hacer |
| --- | --- | --- | --- | --- |
| `OL_E_PROCESS_CLEANUP_FAILED` | `OmsiLaunchService` (rutas de falla del inicio y de falla del supervisor) | Terminar OMSI o esperar su salida durante la limpieza tras un error lanzó una excepción; a continuación sigue el mensaje interno. | Diagnóstico de la sesión (agregado a una sesión `Failed`) | Asegúrese de que no quede ningún `Omsi.exe`; luego ejecute `/recover` si hay un journal pendiente. |
| `OL_E_PROCESS_CREATION_TIME_FAILED` | `CurrentWindowsX64Platform.StartAsync` | `GetProcessTimes` falló justo después de `CreateProcessW` (`Win32=<code>`); el proceso se termina. | Diagnóstico de la sesión mediante `OL_E_START_SESSION` | Reintente; revise el antivirus y los permisos. |
| `OL_E_PROCESS_EXITED_EARLY` | `OmsiLaunchService.SuperviseAsync` | OMSI terminó antes de `gameplay.entered` (fallo, se cerró un diálogo de error de OMSI, se cerró la ventana). | Diagnóstico de la sesión (`Failed`); se ejecuta la restauración | Revise los logs propios de OMSI y `logfile.txt`; consulte `RuntimeEvents` para ver el último evento del plugin. |
| `OL_E_PROCESS_START_FAILED` | `CurrentWindowsX64Platform.StartAsync` | `CreateProcessW` falló (`Win32=<code>` en el mensaje). | Diagnóstico de la sesión mediante `OL_E_START_SESSION` | Resuelva el error Win32 (archivo faltante, acceso denegado, directiva). |
| `OL_E_PROCESS_SUPERVISION` | `OmsiLaunchService.SuperviseAsync` | El bucle del supervisor lanzó una excepción (lectura de telemetría, espera/terminación del proceso, escritura del journal); OMSI se termina y se intenta la restauración. | Diagnóstico de la sesión (`Failed`) | Lea el mensaje interno y el log del host. |
| `OL_E_PROCESS_TERMINATE_FAILED` | `CurrentWindowsX64Platform.Terminate` | `TerminateProcess` falló (`Win32=<code>`). | Dentro de los mensajes de `OL_E_PROCESS_SUPERVISION` / `OL_E_PROCESS_CLEANUP_FAILED` | Termine OMSI manualmente; luego ejecute `/recover`. |
| `OL_E_PROCESS_WAIT_FAILED` | `CurrentWindowsX64Platform.WaitForExitAsync` | `WaitForSingleObject` sobre el handle del proceso falló. | Dentro de los mensajes de `OL_E_PROCESS_SUPERVISION` / `OL_E_PROCESS_CLEANUP_FAILED` | Lo mismo. |

## Runtime

"Detalle de runtime" significa `ErrorCode = OL_E_RUNTIME_OPERATION_FAILED` con el código al comienzo de `Values["detail"]`.

| Código | Generado por | Significado / causa típica | Superficie | Qué hacer |
| --- | --- | --- | --- | --- |
| `OL_E_CAMERA_PRESET_FAMILY_UNSUPPORTED` | `OmsiCameraLockWriter` | `camera.lock` con `preset` mientras `family` es 2 (externa) o 3 (mapa); los presets existen solo para conductor (0) y pasajero (1). | Detalle de runtime | Omita `preset` o use la familia 0/1. |
| `OL_E_DATE_TIME_APPLY_FAILED` | `LaunchValidation` | Modo `Explicit` de `Date`/`Time` sin valor o con componentes fuera de rango. El nombre es histórico; es un error de validación durante la planificación. | Diagnóstico del plan | Corrija el valor (y tenga en cuenta que la fecha/hora explícita no es ejecutable en este build). |
| `OL_E_MAKEVEHICLE_BUS_NOT_FOUND` | `CurrentRuntimeControl.MakeBasicRoadVehicle` | `road-vehicles.spawn`: la ruta `.bus` no existe en el directorio de trabajo de OMSI (se verifica antes de la llamada nativa para que OMSI no pueda sustituirla por una alternativa). | Detalle de runtime | Use una identidad de `vehicles list`/`/list:vehicles`. |
| `OL_E_MAKEVEHICLE_DELTA_MULTIPLE` | igual | El MakeVehicle nativo cambió la colección de vehículos de tráfico en más de un objeto. | Detalle de runtime (`native_status`, conteos en el mensaje) | Repórtelo; los objetos creados permanecen hasta que termina la sesión. |
| `OL_E_MAKEVEHICLE_DELTA_ZERO` | igual | La colección no cambió; OMSI rechazó el vehículo en silencio. | Detalle de runtime | Revise el archivo `.bus`; pruebe con otro modelo. |
| `OL_E_MAKEVEHICLE_NATIVE_FAILED` | igual | Cualquier otro estado nativo distinto de cero. | Detalle de runtime | Repórtelo junto con los conteos del mensaje. |
| `OL_E_PLACE_RANDOM_BUS_FAILED` | `CurrentRuntimeControl.PlaceRandomBus` | La llamada perfilada a PlaceRandomBus devolvió un estado de falla. | Detalle de runtime | Reintente cuando el juego esté estable; repórtelo. |
| `OL_E_RUNTIME_ARGUMENT_REQUIRED` | `PublicCapabilityRegistry.ValidateRuntimeArguments`; verificaciones del lado del plugin (`time.set` sin `hour`/`minute`/`second`; `camera.set` sin `family`/`field_of_view`; `camera.lock` sin un `family` interpretable; operaciones de vehículos/curvas) | Falta un argumento obligatorio o está en blanco. | Resultado de runtime (registro; salida 2 de la CLI) o detalle de runtime (plugin) | Proporcione el argumento ([control de runtime](https://omsilaunch.omsimods.com.br/es-latam/docs/reference/runtime-control/index.md)). |
| `OL_E_RUNTIME_ARTIFACT_MISSING` | `OmsiLaunchService.PlanSessionAsync` | No se puede cargar el directorio/archivo de referencia de la closure del plugin o el puente nativo indicados en `OmsiLaunchRuntimePaths` (puede envolver `OL_E_RELEASE_MANIFEST_INVALID`). | Diagnóstico del plan | Ejecute desde un paquete íntegro. |
| `OL_E_RUNTIME_BASELINE_UNAVAILABLE` | `RuntimeBatch` (`/runtime-write-batch`, arnés INTERNAL) | La lectura de referencia `time.read`/`camera.read` falló, por lo que se omitió la prueba de escritura. | Solo en el artefacto del lote | No está dirigido al usuario. |
| `OL_E_RUNTIME_BUS_IDENTITY_INVALID` | `CurrentRuntimeControl.ValidateBasicBusIdentity` | `model` está vacío, tiene más de 240 caracteres, contiene NUL o `..`, no empieza con `Vehicles\` o no termina en `.bus`. | Detalle de runtime | Indique `Vehicles\<dir>\<file>.bus`. |
| `OL_E_RUNTIME_CHANNEL_BUSY` | ninguno (se conserva por compatibilidad) | Ya no se emite. Builds anteriores lo generaban cuando una solicitud cancelada quedaba en el slot; ahora cada ruta final de una solicitud reinicia el slot, y una solicitud o respuesta residual encontrada al comienzo de una nueva solicitud se borra. | — | — |
| `OL_E_RUNTIME_CHANNEL_CLOSED` | `OmsiLaunchService.LiveSession.RequestRuntimeAsync` | El buzón se liberó porque la sesión está finalizando. | Lanzado (`InvalidOperationException`) | Nada; la sesión terminó. |
| `OL_E_RUNTIME_CHANNEL_STATE_INVALID` | `CurrentRuntimeCommandStore.RequestAsync` | El slot del buzón contenía un valor de estado que no es inactivo, solicitado ni respondido (corrupción). El slot se reinicia y se genera el error; la siguiente solicitud funciona con normalidad. | Lanzado (`InvalidDataException`) | Reintente; repórtelo si persiste. |
| `OL_E_RUNTIME_CONSTANTS_UNAVAILABLE` | `OmsiRuntimeReaders` | El puntero al bloque de constantes del vehículo es null. | Detalle de runtime | El vehículo no tiene constantes; no hay nada que hacer. |
| `OL_E_RUNTIME_CONSTANT_NOT_FOUND` | `OmsiRuntimeReaders` | `name` no está en la tabla de constantes del vehículo. | Detalle de runtime | Liste primero las constantes. |
| `OL_E_RUNTIME_CREATED_OBJECT_INVALID` | `OmsiRuntimeReaders.RegisterRoadVehicleHandleAsync` | El objeto creado por la generación (spawn) tiene una VMT fuera del rango de la imagen de OMSI. | Detalle de runtime | Repórtelo. |
| `OL_E_RUNTIME_CREATED_OBJECT_NOT_IN_COLLECTION` | igual | El objeto creado no está en la colección de vehículos de tráfico. | Detalle de runtime | Repórtelo. |
| `OL_E_RUNTIME_CURVE_DEGENERATE` | `OmsiRuntimeReaders.EvaluateRoadVehicleCurveAsync` | Dos puntos consecutivos de la curva comparten la misma X. | Detalle de runtime | Problema de contenido en la curva del vehículo. |
| `OL_E_RUNTIME_CURVE_EMPTY` | igual | La curva no tiene puntos. | Detalle de runtime | Lo mismo. |
| `OL_E_RUNTIME_CURVE_INVALID` | igual | Ningún segmento de la curva contiene `x`. | Detalle de runtime | Evalúe dentro del dominio de la curva. |
| `OL_E_RUNTIME_CURVE_NOT_FOUND` | igual | `name` es desconocido o su puntero de función es null. | Detalle de runtime | Liste primero las curvas. |
| `OL_E_RUNTIME_HOF_UNAVAILABLE` | `OmsiRuntimeReaders.ReadRoadVehicleHofsAsync` | El puntero a la definición del vehículo es null. | Detalle de runtime | El handle se refiere a un vehículo sin datos de definición. |
| `OL_E_RUNTIME_INSTALLATION_INCOMPLETE` | `CliProgram.RunAsync` (modo propietario) | Falta `plugins\OmsiLaunch.Plugin.opl` o `plugins\OmsiLaunch.Native.x86.dll` junto al archivo ejecutable. | Envoltorio de la CLI, salida 7 | Reinstale el paquete. |
| `OL_E_RUNTIME_OBJECT_HANDLE_REQUIRED` | `CurrentRuntimeControl` | `handle` falta o está en blanco para `road-vehicle.read`, `human.read`, `vehicle.variables.list`, `vehicle.string-variables.list`, `vehicle.constants.list`, `vehicle.curves.list` (normalmente el registro los rechaza antes con `OL_E_RUNTIME_ARGUMENT_REQUIRED`). | Detalle de runtime | Proporcione el handle. |
| `OL_E_RUNTIME_OBJECT_HANDLE_STALE` | `OmsiRuntimeReaders` | El handle es desconocido, el objeto salió de la colección, la generación de direcciones avanzó, o la huella del objeto (VMT + identidad de definición/modelo) cambió porque la dirección se reutilizó. Punto ciego residual: la misma clase y el mismo modelo recreados en la misma dirección entre dos lecturas de la lista. | Detalle de runtime | Vuelva a ejecutar `road-vehicles.list`/`humans.list` y use el nuevo handle. |
| `OL_E_RUNTIME_OPERATION_FAILED` | `CurrentRuntimeControl.Execute`; `CurrentRuntimeCommandMailbox.TryDispatch`; alternativa de `D3DRuntimeApi` | Envoltorio genérico de fallas del lado del plugin; `Values["detail"]` contiene el mensaje (a menudo un código más específico) y `Values["exception"]` el tipo de excepción. Una excepción que escapa de una operación dentro del despachador del buzón también se responde con este código (sin valores) en lugar de dejar la solicitud sin respuesta. | Resultado de runtime | Lea `detail`. |
| `OL_E_RUNTIME_OPERATION_UNAVAILABLE` | `CurrentRuntimeControl.Execute` | El plugin no tiene implementación para una operación que el registro permitió (desfase de versiones entre registro y plugin). | Detalle de runtime | Reinstale un paquete coherente. |
| `OL_E_RUNTIME_OPERATION_UNKNOWN` | `PublicCapabilityRegistry.ValidateRuntimeArguments` | La operación no está en `PublicRuntimeOperationIds`, incluida toda operación `internal.*`. Se verifica antes de buscar la sesión. | Resultado de runtime; respuesta de control; salida 2 de la CLI | Use un id de operación pública. |
| `OL_E_RUNTIME_PLAYER_VEHICLE_UNAVAILABLE` | `OmsiCameraLockWriter` | `camera.lock` con `preset` cuando no hay vehículo del jugador (las sesiones headless no tienen ninguno). También se reporta como `code` del evento `camera.lock.degraded` cuando falla la reaplicación. | Detalle de runtime / evento de runtime | Bloquee sin preset, o use una sesión con vehículo del jugador. |
| `OL_E_RUNTIME_PROTOCOL_MISMATCH` | `D3DRuntimeApi` | Un resultado D3D exitoso no tenía valores, o tenía una cadena de estado del dispositivo desconocida. | Lanzado (`OmsiRuntimeException`) | Haga coincidir las versiones del host y del plugin. |
| `OL_E_RUNTIME_REQUEST_ID_REUSED` | `CurrentRuntimeCommandStore.RequestAsync` | El slot contiene una respuesta obsoleta con el mismo id de solicitud que la nueva solicitud. La respuesta obsoleta se borra antes de generar el error. | Lanzado (`InvalidOperationException`) | Use ids de solicitud estrictamente crecientes. |
| `OL_E_RUNTIME_REQUEST_TIMEOUT` | `CurrentRuntimeCommandStore.RequestAsync` | No hubo respuesta dentro de `timeout`; el slot se reinicia y una respuesta tardía se descarta. | Lanzado (`TimeoutException`); salida 5 de la CLI | Reintente con un timeout más largo; verifique que OMSI no esté bloqueado (diálogo modal, carga). |
| `OL_E_RUNTIME_RESPONSE_INVALID` | `CurrentRuntimeCommandStore` | El envoltorio de la respuesta está corrupto, tiene una longitud incorrecta (negativa, cero o mayor que el slot), un id de sesión ajeno o un id de solicitud distinto. El slot se reinicia antes de generar el error, por lo que la siguiente solicitud funciona con normalidad. | Lanzado (`InvalidDataException`) | Reintente; repórtelo si persiste. |
| `OL_E_RUNTIME_RESPONSE_TOO_LARGE` | `CurrentRuntimeCommandMailbox.TryDispatch` | El resultado serializado supera el buzón de 64 KiB. Los resultados de listas acotadas (los que tienen `returned_count` y `truncated`) se acortan para que quepan (auditoría de documentación BUG-05); en la práctica, el código sigue siendo alcanzable para `timetable.logs.read`, que no es acotada. | Resultado de runtime | Use una operación más específica (por ejemplo, `road-vehicles.read` en lugar de `road-vehicles.list` con colecciones enormes). |
| `OL_E_RUNTIME_SCRIPT_OBJECT_UNAVAILABLE` | `OmsiRuntimeReaders` | El puntero a la definición o al estado del script del vehículo es null. | Detalle de runtime | El vehículo no tiene objetos de script. |
| `OL_E_RUNTIME_SESSION_MISMATCH` | `OmsiLaunchService.ExecuteRuntimeAsync`; `CurrentRuntimeCommandStore`; buzón del plugin | `RuntimeCommand.SessionId` difiere del id de sesión del handle (lanzado por el host), o una solicitud llegó a un plugin vinculado a otra sesión (devuelto por el plugin como resultado tipado). | Lanzado (`InvalidOperationException`) / resultado de runtime | Construya el comando con `session.SessionId`. |
| `OL_E_RUNTIME_SETTING_NOT_PERSISTENT` | `CurrentRuntimeControl.SetWeather` | `weather.set` siempre se rechaza: OMSI sobrescribe los campos de clima perfilados en su siguiente ciclo de clima, por lo que una escritura no puede reportarse como un cambio semántico. | Resultado de runtime | Nada; `weather.set` es `UNAVAILABLE`. |
| `OL_E_RUNTIME_SETTING_UNAVAILABLE` | `OmsiWeatherWriter` | Nombre de campo de clima desconocido. Actualmente es inalcanzable porque `weather.set` se rechaza antes. | Detalle de runtime (definido) | Consulte el código fuente `src/OmsiLaunch.Interop/OmsiWeatherWriter.cs`. |
| `OL_E_RUNTIME_STRING_VARIABLE_NOT_FOUND` | `OmsiRuntimeReaders` | `name` no está en la tabla de variables de cadena. | Detalle de runtime | Liste primero las variables de cadena. |
| `OL_E_RUNTIME_VALUE_INVALID` | `OmsiWeatherWriter.ParseBoolean` | Un booleano de clima no es `true`/`false`/`1`/`0`. Actualmente es inalcanzable (véase arriba). | Detalle de runtime (definido) | Consulte el código fuente. |
| `OL_E_RUNTIME_VALUE_OUT_OF_RANGE` | `CurrentRuntimeControl`, `OmsiCameraWriter`, `OmsiCameraLockWriter`, `OmsiRuntimeReaders`, `OmsiWeatherWriter` | `time.set`: `hour` 0..23, `minute` 0..59, `second` 0..59.999; `camera.set`: `family` 0..3, `field_of_view` 10..170; `camera.lock`: `preset` no es un entero, `family` 0..3, `preset` 0..255; `road-vehicles.place-random`: `ai_type` 0..255, `group`/`type`/`tour`/`line` 0..65535 (`type` puede ser -1), `scheduled` 0..1; `vehicle.variable.set`: `value` no es finito; `vehicle.curve.evaluate`: `x` no es finito. | Detalle de runtime | Use un valor dentro del rango. |
| `OL_E_RUNTIME_VARIABLE_NOT_FOUND` | `OmsiRuntimeReaders` | `name` no está en la tabla de variables numéricas. | Detalle de runtime | Liste primero las variables. |
| `OL_E_RUNTIME_VARIABLE_UNAVAILABLE` | `OmsiRuntimeReaders` | El slot de la variable o la dirección del valor es null. | Detalle de runtime | La variable no está materializada para este vehículo. |
| `OL_E_TIME_APPLY_FAILED` | `CurrentRuntimeControl.SetTime` | Los escalares del reloj se escribieron, pero la llamada nativa perfilada a SetTime devolvió una falla. | Detalle de runtime | Reintente; vuelva a leer el valor con `time.read`. |

## RuntimeD3D

Todos los genera `CurrentRuntimeControl` (asignación `ThrowD3D` del estado nativo; `detail` lleva la operación y el HRESULT, `native_status` el estado numérico). Superficie: resultado de runtime con el código en `ErrorCode`; `D3DRuntimeApi` lo vuelve a lanzar como `OmsiRuntimeException`.

| Código | Estado nativo / causa | Qué hacer |
| --- | --- | --- |
| `OL_E_D3D_DEVICE_LOST` | 8: el dispositivo Direct3D se perdió. | Espere a `d3d.restored`; vuelva a crear las texturas (la generación cambió). |
| `OL_E_D3D_INVALID_ARGUMENT` | 14: `width`, `height`, `level`, `x`, `y`, `format` o `handle` faltante o no válido (rangos: width/height 1..4096, niveles 0..16, level 0..15, x/y 0..4095). | Corrija los argumentos. |
| `OL_E_D3D_INVALID_PIXEL_BUFFER` | `pixels_base64` no es Base64 válido o supera 48 KiB. | Envíe rectángulos más pequeños. |
| `OL_E_D3D_INVALID_TEXTURE_FORMAT` | 6, o un nombre de `format` desconocido (válidos: `A8R8G8B8`, `X8R8G8B8`, `R5G6B5`, `X1R5G5B5`, `A1R5G5B5`, `A4R4G4B4`, `A8`, `L8`, `A8L8`). | Use un formato de la lista. |
| `OL_E_D3D_NATIVE_CALL_FAILED` | Cualquier otro estado; el HRESULT está en `detail`. | Repórtelo junto con el HRESULT. |
| `OL_E_D3D_NOT_READY` | 7: el dispositivo no está listo (antes del primer frame o durante la detención). | Reintente después de `d3d.ready`. |
| `OL_E_D3D_RESET_IN_PROGRESS` | 9: hay un reinicio del dispositivo en curso. | Reintente después de `d3d.restored`. |
| `OL_E_D3D_RESOURCE_RELEASED` | 13: el handle de la textura ya se liberó. | No reutilice handles liberados. |
| `OL_E_D3D_STALE_RESOURCE_HANDLE` | 12: el handle pertenece a una generación anterior del dispositivo; o la cadena del handle no es `d3dtex-<session>-<hex>` / es cero. | Vuelva a crear la textura. |

<a id="session"></a>
## Sesión

| Código | Generado por | Significado / causa típica | Superficie | Qué hacer |
| --- | --- | --- | --- | --- |
| `OL_E_CAPABILITY_UNAVAILABLE` | `SessionPlanner`; `ApplyTelemetry` en `plugin.request.unsupported` | Plan: se solicitó `LastMapState`, `EntrypointIdentity`, modo de fecha/hora/año, modo de clima, campos del vehículo del jugador o documentos de entrada (`Requested capability unavailable: <name>`). Telemetría: el plugin rechazó el handoff (no puede ocurrir con un plan ejecutable). | Diagnóstico del plan; diagnóstico de la sesión | Quite la solicitud no compatible ([limitaciones conocidas](https://omsilaunch.omsimods.com.br/es-latam/docs/reference/known-limitations/index.md)). |
| `OL_E_HEADLESS_ARM_FAILED` | `ApplyTelemetry` en `headless.arm.failed` | El plugin no pudo armar en OMSI el hook de inicio headless de un solo uso. | Diagnóstico de la sesión (`Failed`) | Verifique el build; repórtelo. |
| `OL_E_NO_ACTIVE_SESSION` | Cliente de la CLI (`ReportForwarded`, `CliEventWatch`) | Ningún propietario responde en el pipe de control de la instalación (no hay sesión, o el propietario todavía está iniciando/validando). | Envoltorio de la CLI, salida 4 | Inicie una sesión, o espere hasta que esté en `Running`. |
| `OL_E_PLUGIN_NOT_LOADED` | `SuperviseAsync` | Transcurrió `StartupTimeoutSeconds` antes de `plugin.started` (OMSI no cargó `plugins\OmsiLaunch.Plugin.opl`, o está atascado antes de la inicialización del plugin). | Diagnóstico de la sesión (`Failed`) | Revise la closure del plugin, `plugins\OmsiLaunch.Plugin.opl` y el `logfile.txt` de OMSI. |
| `OL_E_PLUGIN_PROTOCOL_MISMATCH` | `ApplyTelemetry` en `plugin.handoff.invalid` o JSON de telemetría no interpretable | El plugin no pudo leer/verificar el handoff de arranque (versión 3/4, SHA-256), o envió telemetría no válida. | Diagnóstico de la sesión (`Failed`) | Haga coincidir las versiones del host y del plugin (reinstale el paquete). |
| `OL_E_SESSION_ALREADY_ACTIVE` | `CliProgram.RunAsync` | Un propietario ya responde a `session.status` para esta instalación. | Envoltorio de la CLI, salida 7 | Use comandos de cliente (`session status`, `session stop`, comandos de runtime). |
| `OL_E_SESSION_NOT_RUNNING` | `OmsiLaunchService.ExecuteRuntimeAsync` | El estado de la sesión no es `Running`. | Lanzado (`InvalidOperationException`) | Use primero `WaitForAsync(session, SessionState.Running, ...)`. |
| `OL_E_SESSION_PRESENTATION_INVALID` | `SessionPlanner` | No se pudo construir el plan de splash/ITX; el mensaje lleva el código de presentación. | Diagnóstico del plan | Consulte [Presentación](#presentation). |
| `OL_E_SESSION_START_FAILED` | `WindowsHost.ShowFailure` (diálogo de OmsiLaunchW) | Código de respaldo que se muestra cuando un plan de inicio no es ejecutable o la sesión no llegó al juego, y no existe ningún diagnóstico `OL_E_`. | Solo cuadro de mensaje | Lea `.omsilaunch\diagnostics`. |
| `OL_E_SITUATION_LOAD_FAILED` | `ApplyTelemetry` en `world.situation.failed` | El inicio nativo de la situación guardada devolvió una falla (`native_status` en el evento). | Diagnóstico de la sesión (`Failed`) | Revise el `.osn` y su mapa. |
| `OL_E_STARTUP_TIMEOUT` | `SuperviseAsync` | El plugin se inició, pero no se alcanzó `Running` dentro de `StartupTimeoutSeconds`. | Diagnóstico de la sesión (`Failed`) | Aumente `/startup-timeout` para mapas grandes; consulte `RuntimeEvents` para ver el último evento del mundo. |
| `OL_E_START_SESSION` | `OmsiLaunchService.StartAsync` | Cualquier excepción en la ruta de inicio; el mensaje es el mensaje interno (normalmente comienza con el código interno). | Diagnóstico de la sesión (`Failed`) | Actúe según el código interno. |
| `OL_E_WORLD_START_FAILED` | `ApplyTelemetry` en `world.failed` | El inicio nativo de NEW_MAP devolvió una falla (`native_status` en el evento). | Diagnóstico de la sesión (`Failed`) | Revise el mapa, el índice del punto de entrada y los logs de OMSI. |

## SessionProfile

Todos los genera `SessionProfileCompiler` (`src/OmsiLaunch.Core/SessionProfiles.cs`) o `CliInput`, lanzados como `SessionProfileException` (una `IOException` con `Code`), salida 2 de la CLI. Consulte [perfiles de sesión](https://omsilaunch.omsimods.com.br/es-latam/docs/reference/session-profiles/index.md).

| Código | Significado / causa típica | Qué hacer |
| --- | --- | --- |
| `OL_E_SESSION_PROFILE_ASSET_MISSING` | El directorio `assets` de splash del preset o el archivo `profile` de Internet Textures no existe dentro del paquete. | Agregue el asset. |
| `OL_E_SESSION_PROFILE_INVALID` | Infracción estructural o de límites: más de 256 KiB, no hay exactamente un mapping raíz, anchors de YAML, clave desconocida, falta una clave obligatoria, un valor no escalar donde se requiere uno escalar, `id` difiere del nombre del directorio, presets fuera de 1..5 o `index` duplicado, timeouts no positivos, modo de clima/splash/Internet Textures no compatible, fecha/hora que no es `explicit`, YAML no válido, errores al interpretar números/fechas. | Corrija el YAML según el mensaje. |
| `OL_E_SESSION_PROFILE_MAP_MISMATCH` | `compatibility.maps` no está vacío y no contiene el mapa seleccionado (NEW_MAP) ni el mapa de la situación seleccionada (SAVED_SITUATION). | Elija un mundo compatible. |
| `OL_E_SESSION_PROFILE_NOT_FOUND` | `<root>\.omsilaunch\session-profiles\<id>\profile.yaml` no existe. | Verifique el id. |
| `OL_E_SESSION_PROFILE_OVERRIDE_CONFLICT` | Un argumento explícito de la CLI apunta a un campo que pertenece al perfil/preset seleccionado. | Quite el flag o elija otro preset. |
| `OL_E_SESSION_PROFILE_PATH_ESCAPE` | El id contiene `\`, `/`, `:` o `..`; o una ruta de asset es absoluta, sale del paquete o atraviesa un junction/symlink. | Mantenga las rutas dentro del paquete. |
| `OL_E_SESSION_PROFILE_PRESET_NOT_FOUND` | `/predefined-profile-index` falta, está fuera de 1..5 o el perfil no lo declara. | Use un índice de preset declarado. |
| `OL_E_SESSION_PROFILE_SCHEMA_UNSUPPORTED` | `schema` no es `omsilaunch.session-profile/v1`. | Use el esquema compatible. |
| `OL_E_SESSION_PROFILE_SETTING_NOT_WRITABLE` | Una clave de ajuste del preset es conocida pero no admite escritura. | Quite la clave. |
| `OL_E_SESSION_PROFILE_SETTING_UNKNOWN` | Una clave de ajuste del preset no está en el catálogo. | Use una clave del catálogo. |

<a id="transaction"></a>
## Transacción

Consulte [transacciones y recuperación](https://omsilaunch.omsimods.com.br/es-latam/docs/concepts/transactions-and-recovery/index.md).

| Código | Generado por | Significado / causa típica | Superficie | Qué hacer |
| --- | --- | --- | --- | --- |
| `OL_E_CLOSECHECK_REMOVE_FAILED` | `OmsiLaunchService.RemoveStaleClosecheck` | Un `closecheck` obsoleto sigue existiendo después de `File.Delete`. | Diagnóstico de la sesión mediante `OL_E_START_SESSION` | Quite `<root>\closecheck` manualmente (permisos). |
| `OL_E_RECOVERY_ABSENT_OWNERSHIP_MISMATCH` | `FileConfigurationTransaction.RestoreAsync` | Una ruta que no existía antes de la sesión ahora tiene contenido distinto del que aplicó la sesión; no se elimina y el journal se conserva. | Lanzado (`IOException`); dentro de `OL_E_RESTORE_FAILED` / `OL_E_START_SESSION`; salida 8 de la CLI | Inspeccione el archivo; elimínelo o muévalo, y luego ejecute `/recover`. |
| `OL_E_RECOVERY_ABSENT_OWNERSHIP_UNVERIFIED` | `RestoreAsync` (journal anterior a las huellas) | El journal no tiene huella del contenido aplicado para una ruta originalmente ausente que no es de eliminación, por lo que no se puede demostrar la propiedad. Al iniciar una sesión, la recuperación se aplaza y se reintenta con los bytes planificados de esa sesión; mediante `RecoverPendingAsync` se lanza. | Lanzado (`IOException`); salida 8 de la CLI | Inicie una sesión con la misma especificación (aporta los bytes), o inspeccione y elimine el archivo; luego ejecute `/recover`. |
| `OL_E_RECOVERY_BACKUP_CORRUPT` | `RestoreAsync` | El SHA-256 de una copia de seguridad no coincide con el snapshot registrado en el journal; no se escribe nada. | Lanzado; dentro de `OL_E_RESTORE_FAILED`; salida 8 de la CLI | Restaure el archivo desde su propia copia de seguridad; luego elimine el journal solo cuando esté seguro. |
| `OL_E_RECOVERY_JOURNAL_MISSING` | `RestoreAsync` | Existen snapshots en memoria, pero `journal.json` ya no está (se eliminó durante la sesión). | Lanzado; dentro de `OL_E_RESTORE_FAILED` | Verifique manualmente los archivos de la sesión. |
| `OL_E_RECOVERY_JOURNAL_REMOVE_FAILED` | `FileConfigurationTransaction.RemoveJournal` | `journal.json` sigue existiendo después de eliminarlo (la restauración en sí tuvo éxito y se verificó). | Lanzado; dentro de `OL_E_RESTORE_FAILED`; salida 8 de la CLI | Elimine `<root>\.omsilaunch\journal.json` (permisos) o vuelva a ejecutar `/recover` (idempotente). |
| `OL_E_RESTORE_DEFERRED` | `OmsiLaunchService` (falla de inicio / supervisor) | No se pudo confirmar la salida de OMSI, por lo que los archivos no se reemplazaron mientras OMSI todavía podría estar usándolos; el journal se conserva. | Diagnóstico de la sesión (`Failed`) | Después de que `Omsi.exe` haya terminado, ejecute `/recover` (o el siguiente inicio recupera automáticamente). |
| `OL_E_RESTORE_FAILED` | `OmsiLaunchService` (falla de inicio / supervisor) | `RestoreAsync` lanzó una excepción; el mensaje lleva el código interno; el journal se conserva. | Diagnóstico de la sesión (`Failed`); salida 8 de la CLI cuando se lanza desde `/recover` | Actúe según el código interno; luego ejecute `/recover`. |

<a id="warning"></a>
## Advertencia

| Código | Generado por | Significado | Superficie | Qué hacer |
| --- | --- | --- | --- | --- |
| `OL_W_RESTORE_FOREIGN_FILE_RETAINED` | `FileConfigurationTransaction.RestoreAsync` | Una ruta de eliminación de la sesión (destino ITX, `Texture\standard.ipr`, `closecheck`) no existía antes de la sesión y existe ahora, pero nunca se inició un proceso de OMSI bajo este journal, por lo que el archivo no puede ser un subproducto de la sesión. Se conserva y se reporta (mensaje = ruta relativa, `Data["sha256"]`); aun así, la transacción se completa. | Diagnóstico de la sesión / `RecoveryStatus.Diagnostics` (el estado no se ve afectado) | Inspeccione el archivo; elimínelo usted mismo si no lo desea. |

<a id="non-error-diagnostic-codes"></a>
## Códigos de diagnóstico que no son errores

| Código | Emitido por | Mensaje / datos | Significado |
| --- | --- | --- | --- |
| `process.started` | `OmsiLaunchService.LiveSession.Attach` | mensaje = PID; `Data["thread_id"]`, `Data["creation_utc"]` (ISO 8601) | Se creó `Omsi.exe` y se registró su identidad. Diagnóstico de la sesión. |
| `closecheck.stale-removed` | `OmsiLaunchService.RemoveStaleClosecheck` | mensaje = SHA-256 del archivo eliminado | Un `closecheck` que existía antes de la sesión se eliminó de forma permanente (`SuppressStaleClosecheckWarning = true`). Diagnóstico de la sesión. |
| `restore.session-artifact-removed` | `FileConfigurationTransaction.RestoreAsync` | mensaje = ruta relativa; `Data["sha256"]` | OMSI volvió a crear una ruta de eliminación de la sesión durante una sesión cuyo proceso se había iniciado; se eliminó para restaurar la ausencia original. Diagnóstico de la sesión / `RecoveryStatus.Diagnostics`. |
| `plugin.integrity.reference` | `OmsiLaunchService.PlanSessionAsync` | mensaje = `manifest` o `self` | Qué referencia usa la validación del plugin permanente. Diagnóstico del plan. |
| `session_profile.selected` | `SessionPlanner` | mensaje = id del perfil; `Data["session_profile.id|name|version|author|preset_id|preset_index|preset_name|path"]` | Procedencia de una sesión compilada a partir de un perfil de sesión. Diagnóstico del plan. |

Los nombres de eventos de runtime (`RuntimeEvent.Type`, no son diagnósticos) se listan en el [ciclo de vida de la sesión](https://omsilaunch.omsimods.com.br/es-latam/docs/concepts/session-lifecycle/index.md#telemetry-events).