# Códigos de error y de diagnóstico
> 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 difieren, 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, más los códigos de diagnóstico informativos que no son errores. Para cada código indica dónde lo genera el código actual, qué significa, cómo te llega (excepción lanzada, campo de resultado, diagnóstico, respuesta del plano de control o envelope de la CLI) y qué hacer. Los significados se han tomado de los puntos donde se generan; cuando un código está definido pero no tiene ninguna ruta actual que lo genere, la página lo indica.
Páginas relacionadas: [API pública](https://omsilaunch.omsimods.com.br/es/docs/reference/public-api/index.md), [códigos de salida](https://omsilaunch.omsimods.com.br/es/docs/reference/exit-codes/index.md), [LaunchSpec](https://omsilaunch.omsimods.com.br/es/docs/reference/launchspec/index.md), [ciclo de vida de la sesión](https://omsilaunch.omsimods.com.br/es/docs/concepts/session-lifecycle/index.md), [transacciones y recuperación](https://omsilaunch.omsimods.com.br/es/docs/concepts/transactions-and-recovery/index.md), [plano de control local](https://omsilaunch.omsimods.com.br/es/docs/reference/local-control/index.md), [control de runtime](https://omsilaunch.omsimods.com.br/es/docs/reference/runtime-control/index.md), [perfiles de sesión](https://omsilaunch.omsimods.com.br/es/docs/reference/session-profiles/index.md), [plugin permanente](https://omsilaunch.omsimods.com.br/es/docs/concepts/permanent-plugin/index.md).
## Cómo te llegan los códigos
| Superficie | Significado |
| --- | --- |
| Lanzado | Una excepción cuyo `Message` empieza por 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í es como 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`). |
| Envelope de la CLI | `error.code` en el envelope `--json`, o `: ` 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` | Se escapó una `OperationCanceledException` (Ctrl+C o una espera del cliente cancelada). | Envelope de la CLI, salida 7 | Vuelve a ejecutar el comando. |
| `OL_E_INTERNAL` | `CliProgram.Classify` | Se escapó una excepción sin código `OL_E_`: JSON de `/spec` mal formado, un miembro obligatorio de la spec nulo, un fallo inesperado. | Envelope de la CLI, salida 10 | Lee el mensaje y `\.omsilaunch\diagnostics\-host.log`; corrige la entrada; notifícalo si no tiene explicación. |
| `OL_E_TIMEOUT` | `CliProgram.Classify`; `LocalControlPlane.TryRequestAsync` | Se 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 no se notifica como `OL_E_NO_ACTIVE_SESSION`). (Los timeouts del buzón llevan `OL_E_RUNTIME_REQUEST_TIMEOUT` en su lugar). | Envelope de la CLI, respuesta de control; salida 5 desde `Classify`, salida 7 para una respuesta de control | Vuelve a intentarlo; comprueba que OMSI y el propietario responden. |
| `OL_E_WINDOWS_HOST_MISSING` | `CliProgram.RunAsync` (`/silent`) | `OmsiLaunchW.exe` no está junto a `OmsiLaunch.exe`. | Envelope de la CLI, salida 7 | Vuelve a instalar el paquete. |
| `OL_E_WINDOWS_HOST_START_FAILED` | `CliProgram.RunAsync` (`/silent`) | `Process.Start` de `OmsiLaunchW.exe` no devolvió ningún proceso. | Envelope de la CLI, salida 7 | Comprueba los archivos del paquete y los permisos; ejecuta sin `/silent` para ver el fallo. |
## Compatibilidad
| Código | Generado por | Significado / causa típica | Superficie | Qué hacer |
| --- | --- | --- | --- | --- |
| `OL_E_BUILD_VALIDATION_FAILED` | `OmsiLaunchService.ApplyTelemetry` en `plugin.build.invalid` | La comprobación de build dentro del proceso del plugin (perfil `Omsi23004_692EBFBF` más la sonda VMT nativa) falló aunque el host aceptó el ejecutable, por ejemplo un build Steam LAA de la lista de permitidos cuya disposición en memoria difiere, o un OMSI parcheado. | Diagnóstico de la sesión (`Failed`) | Usa el build validado en runtime; consulta [compatibilidad](https://omsilaunch.omsimods.com.br/es/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 | Instala el build compatible OMSI 2.3.004. |
| `OL_E_UNSUPPORTED_OPERATING_SYSTEM` | `SessionPlanner` (`runtime.current-windows-x64` no disponible); también lo lanza `CurrentWindowsX64Platform.ValidateCurrent`, al 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) | Ejecuta 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 ninguna ruta actual que lo genere. | Lanzado (`PlatformNotSupportedException`) solo por ese método | Consulta el código fuente `src/OmsiLaunch.Process/RuntimePlatform.cs`. |
## 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 establecer o negativo. | Diagnóstico del plan | Establece `PresentedEntrypointIndex` (`/entrypoint-index:`); descubre los puntos de entrada con `/list:entrypoints /map:`. |
| `OL_E_ENTRYPOINT_REQUIRED` | `SessionPlanner` (`world.presented-entrypoint` no disponible) | El mapa de NEW_MAP se ha resuelto, 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 | Usa 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 establecer o que no tiene la forma `maps\\global.cfg`. Planificador: el mapa no está instalado. | Diagnóstico del plan | Usa una identidad de `/list:maps`. |
| `OL_E_NOT_FOUND` | `CliProgram.Classify` | Se escapó una `FileNotFoundException`/`DirectoryNotFoundException` sin código, por ejemplo `/list:repaints` con un `/vehicle-scope` desconocido, o `/list:entrypoints` con un `/map` desconocido. | Envelope de la CLI, salida 6 | Corrige la identidad. |
| `OL_E_REPAINT_NOT_FOUND` | `SessionPlanner` | `PlayerVehicle.Repaint` no es un elemento `.cti` del modelo (solo se comprueba cuando `Model` está establecido). | Diagnóstico del plan | Usa una identidad de `/list:repaints /vehicle-scope:`. |
| `OL_E_SITUATION_MAP_NOT_FOUND` | `SessionPlanner` | El mapa referenciado dentro del `.osn` seleccionado no está instalado. | Diagnóstico del plan | Instala el mapa o elige otra situación. |
| `OL_E_SITUATION_NOT_FOUND` | `LaunchValidation`; `SessionPlanner` | SAVED_SITUATION sin `SituationIdentity`, o el `.osn` no está instalado. | Diagnóstico del plan | Usa una identidad de `/list:situations`. |
| `OL_E_VEHICLE_NOT_FOUND` | `SessionPlanner` | `PlayerVehicle.Model` no es un `Vehicles\...\*.bus` instalado. | Diagnóstico del plan | Usa una identidad de `/list:vehicles`. |
## 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.`) lo tiene otro propietario en esta sesión de inicio de sesión de Windows, o sigue vivo un proceso de OMSI registrado en el diario (PID + hora de creación + ruta del ejecutable; o cualquier `Omsi.exe` de la raíz para un diario posterior a `HandoffCreated` sin PID). | Inicio: diagnóstico de la sesión a través de `OL_E_START_SESSION`. Recuperación: lanzado (`InvalidOperationException` / `IOException`). Salida 7 de la CLI. | Detén el otro propietario (`session stop`) o espera a que OMSI termine; después vuelve a intentarlo o usa `/recover`. |
| `OL_E_INSTALLATION_NOT_FOUND` | `LaunchValidation` | `Installation.RootPath` está vacío. | Diagnóstico del plan | Pasa 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 directorio `plugins\`. | Diagnóstico del plan | Indica una instalación de OMSI real y con permiso de escritura. |
| `OL_E_PERMANENT_PLUGIN_HASH_MISMATCH` | `RuntimeArtifactSet.ValidateInstalled` (plan e inicio) | Un archivo `plugins\OmsiLaunch.*` instalado difiere del hash de `release-manifest.json` (o del conjunto de archivos de referencia si no hay manifiesto). | Diagnóstico del plan (plan no ejecutable, salida 1 de la CLI); diagnóstico de la sesión a través de `OL_E_START_SESSION` solo si los archivos cambian entre la planificación y el inicio | Vuelve a instalar 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 entrada para un archivo obligatorio del plugin. | Diagnóstico del plan; diagnóstico de la sesión a través de `OL_E_START_SESSION` en la misma carrera que arriba | Vuelve a instalar el paquete. |
| `OL_E_PERMANENT_PLUGIN_MISSING` | `RuntimeArtifactSet.ValidateInstalled` (plan e inicio) | Falta un archivo obligatorio `plugins\OmsiLaunch.*` en la instalación de OMSI, o un archivo de `plugins/` que figura en `release-manifest.json` no está instalado. | Diagnóstico del plan; diagnóstico de la sesión a través de `OL_E_START_SESSION` en la misma carrera que arriba | Instala el conjunto de archivos del plugin permanente ([instalación](https://omsilaunch.omsimods.com.br/es/docs/getting-started/installation/index.md)). |
| `OL_E_PLATFORM_CAPABILITY_MISSING` | Solo `CurrentWindowsX64Platform.ValidateCurrent` | `CurrentPlatformSupported` es false. El servicio no lo llama; no hay ninguna ruta actual que lo genere. | Lanzado solo por ese método | Consulta el código fuente. |
| `OL_E_RELEASE_MANIFEST_INVALID` | `ReleaseManifest.TryReadPluginHashes` / `ParsePluginHashes` | `release-manifest.json` está vacío, no es JSON, no tiene la matriz `files`, o tiene una entrada sin `path`/`sha256`, un hash que no son 64 dígitos hexadecimales, una ruta absoluta, que contiene `:`, un segmento vacío, `.` o `..`, o una ruta que aparece dos veces (comparando 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: a través de `OL_E_START_SESSION` | Vuelve a instalar 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` establecido mientras el modo no es `Explicit`. CLI: flag desconocido, valor ausente, entero o rango incorrecto, `/saved` combinado con `/map`/`/entrypoint`, ruta de comando desconocida, cualquier `ArgumentException`/`FormatException` sin código. | Diagnóstico del plan; envelope de la CLI, salida 2 | Corrige el argumento. |
| `OL_E_INVALID_SETTING_VALUE` | `ConfigurationCatalog.CreatePatch` (inicio) | Un valor de 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 a través de `OL_E_START_SESSION` | Usa un valor de la [tabla de ajustes](https://omsilaunch.omsimods.com.br/es/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 | Quita 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 | Usa 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 | Corrige el archivo ([LaunchSpec](https://omsilaunch.omsimods.com.br/es/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 | Comprueba la ruta. |
| `OL_E_SPEC_TOO_LARGE` | `LaunchSpecJson.LoadAsync` | El archivo supera 1 MiB. | Lanzado (`InvalidDataException`), salida 2 de la CLI | Reduce 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 | Quita o renombra el miembro. |
## LocalControl
| Código | Generado por | Significado / causa típica | Superficie | Qué hacer |
| --- | --- | --- | --- | --- |
| `OL_E_CONTROL_COMMAND_UNKNOWN` | Manejador 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 | Usa un comando compatible. |
| `OL_E_CONTROL_FAILED` | Cliente de la CLI (`ReportForwarded`, `CliEventWatch`) | El propietario respondió `Ok = false` sin código de error. | Envelope de la CLI, salida 7 | Lee el mensaje; revisa la consola/los diagnósticos del propietario. |
| `OL_E_CONTROL_HANDLER_FAILED` | `LocalControlPlane.ServeAsync` | El manejador 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 manejador no se pudo serializar. | Respuesta de control | Consulta `session status`; reinicia 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 descodificar. | Respuesta de control / envelope de la CLI | Usa el protocolo documentado ([plano de control local](https://omsilaunch.omsimods.com.br/es/docs/reference/local-control/index.md)). |
| `OL_E_CONTROL_MESSAGE_TOO_LARGE` | `LocalControlPlane.TryRequestAsync` (cliente) | La propia solicitud serializada del cliente supera 64 KiB. Se notifica al llamador; no se envía nada. | Respuesta de control / envelope de la CLI | Reduce 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 lo más antiguo para que quepa. | Respuesta de control / envelope de la CLI | Vuelve a intentarlo; para los eventos, léelos 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 descodificar o estaba vacía; el propietario cerró la conexión sin responder o la conexión se rompió después de establecerse; el propietario no notificó ningún `SessionId`. | Respuesta de control / envelope de la CLI | Haz coincidir las versiones del cliente y del propietario; consulta `session status`. |
| `OL_E_CONTROL_SESSION_MISMATCH` | Manejador 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 | Consulta primero `session.status` y vincula la solicitud (la CLI lo hace automáticamente). |
## 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` ha cambiado, se ha eliminado contenido, falta el conjunto de archivos del plugin); el mensaje enumera los códigos `OL_E_` actuales. | Lanzado (`InvalidOperationException`); salida 1 de la CLI | Vuelve a planificar y corrige los diagnósticos enumerados. |
## 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 a través de `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 `http`/`https` absoluta. | Usa pares de líneas URL/destino. |
| `OL_E_ITX_PROFILE_MISSING` | `OverrideProfilePath` (resuelto respecto al directorio de trabajo del proceso) no existe. Se lanza como `FileNotFoundException`. | Pasa una ruta `.itx` existente. |
| `OL_E_ITX_PROFILE_REQUIRED` | `InternetTextures.Mode` es `Override` sin `OverrideProfilePath`. Salida 2 de la CLI cuando se lanza. | Proporciona `/internet-textures-profile:`. |
| `OL_E_ITX_TARGET_OUTSIDE_TEXTURE_PATH` | Una línea de destino es absoluta, contiene `..`, empieza por `\`, se resuelve fuera de la instalación, carece de un componente `Texture\` o atraviesa una unión (junction) o un enlace simbólico. | Usa destinos relativos `Texture\...`. |
| `OL_E_SPLASH_ASSET_DIRECTORY_MISSING` | `CustomAssetDirectory` no existe. | Corrige el directorio. |
| `OL_E_SPLASH_ASSET_MISSING` | Falta `ENG.bmp` o `.bmp` en el directorio de recursos, o falta un `assets\splash\.bmp` del paquete al inicializar `.omsilaunch\assets\splash`. | Proporciona los BMP / vuelve a instalar el paquete. |
| `OL_E_SPLASH_FORMAT_UNSUPPORTED` | Un BMP del splash no es un mapa de bits `BM` de 640×480 y 24 bits. | Convierte la imagen. |
## Proceso
| Código | Generado por | Significado / causa típica | Superficie | Qué hacer |
| --- | --- | --- | --- | --- |
| `OL_E_PROCESS_CLEANUP_FAILED` | `OmsiLaunchService` (rutas de fallo de inicio y de fallo del supervisor) | Terminar OMSI o esperar a que termine durante la limpieza tras un error lanzó una excepción; a continuación sigue el mensaje interno. | Diagnóstico de la sesión (añadido a una sesión `Failed`) | Asegúrate de que no queda ningún `Omsi.exe` y, después, usa `/recover` si hay un diario pendiente. |
| `OL_E_PROCESS_CREATION_TIME_FAILED` | `CurrentWindowsX64Platform.StartAsync` | `GetProcessTimes` falló justo después de `CreateProcessW` (`Win32=`); el proceso se termina. | Diagnóstico de la sesión a través de `OL_E_START_SESSION` | Vuelve a intentarlo; revisa el antivirus/los permisos. |
| `OL_E_PROCESS_EXITED_EARLY` | `OmsiLaunchService.SuperviseAsync` | OMSI terminó antes de `gameplay.entered` (bloqueo, se cerró un cuadro de diálogo de error de OMSI, se cerró la ventana). | Diagnóstico de la sesión (`Failed`); se ejecuta la restauración | Revisa los registros propios de OMSI y `logfile.txt`; consulta `RuntimeEvents` para ver el último evento del plugin. |
| `OL_E_PROCESS_START_FAILED` | `CurrentWindowsX64Platform.StartAsync` | `CreateProcessW` falló (`Win32=` en el mensaje). | Diagnóstico de la sesión a través de `OL_E_START_SESSION` | Resuelve el error Win32 (archivo ausente, 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 diario); OMSI se termina y se intenta la restauración. | Diagnóstico de la sesión (`Failed`) | Lee el mensaje interno y el registro del host. |
| `OL_E_PROCESS_TERMINATE_FAILED` | `CurrentWindowsX64Platform.Terminate` | `TerminateProcess` falló (`Win32=`). | Dentro de los mensajes de `OL_E_PROCESS_SUPERVISION` / `OL_E_PROCESS_CLEANUP_FAILED` | Termina OMSI manualmente y, después, usa `/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 principio 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 solo existen para conductor (0) y pasajero (1). | Detalle de runtime | Omite `preset` o usa 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 | Corrige el valor (y ten 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 del `.bus` no existe bajo el directorio de trabajo de OMSI (se comprueba antes de la llamada nativa para que OMSI no pueda sustituirlo por uno alternativo). | Detalle de runtime | Usa una identidad de `vehicles list`/`/list:vehicles`. |
| `OL_E_MAKEVEHICLE_DELTA_MULTIPLE` | ídem | El MakeVehicle nativo cambió la colección de vehículos de carretera en más de un objeto. | Detalle de runtime (`native_status`, recuentos en el mensaje) | Notifícalo; los objetos creados permanecen hasta que termina la sesión. |
| `OL_E_MAKEVEHICLE_DELTA_ZERO` | ídem | La colección no cambió; OMSI rechazó el vehículo sin avisar. | Detalle de runtime | Revisa el archivo `.bus`; prueba otro modelo. |
| `OL_E_MAKEVEHICLE_NATIVE_FAILED` | ídem | Cualquier otro estado nativo distinto de cero. | Detalle de runtime | Notifícalo con los recuentos del mensaje. |
| `OL_E_PLACE_RANDOM_BUS_FAILED` | `CurrentRuntimeControl.PlaceRandomBus` | La llamada perfilada a PlaceRandomBus devolvió un estado de fallo. | Detalle de runtime | Vuelve a intentarlo cuando la fase de juego sea estable; notifícalo. |
| `OL_E_RUNTIME_ARGUMENT_REQUIRED` | `PublicCapabilityRegistry.ValidateRuntimeArguments`; comprobaciones del lado del plugin (`time.set` sin `hour`/`minute`/`second`; `camera.set` sin `family`/`field_of_view`; `camera.lock` sin un `family` analizable; 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) | Proporciona el argumento ([control de runtime](https://omsilaunch.omsimods.com.br/es/docs/reference/runtime-control/index.md)). |
| `OL_E_RUNTIME_ARTIFACT_MISSING` | `OmsiLaunchService.PlanSessionAsync` | No se puede cargar el directorio/archivo de referencia del conjunto de archivos del plugin o el puente nativo indicado en `OmsiLaunchRuntimePaths` (puede envolver `OL_E_RELEASE_MANIFEST_INVALID`). | Diagnóstico del plan | Ejecuta desde un paquete íntegro. |
| `OL_E_RUNTIME_BASELINE_UNAVAILABLE` | `RuntimeBatch` (`/runtime-write-batch`, arnés INTERNAL) | Falló la lectura de referencia `time.read`/`camera.read`, por lo que se omitió la prueba de escritura. | Solo 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 por `Vehicles\` o no termina en `.bus`. | Detalle de runtime | Pasa `Vehicles\\.bus`. |
| `OL_E_RUNTIME_CHANNEL_BUSY` | ninguno (se conserva por compatibilidad) | Ya no se emite. Los builds anteriores lo generaban cuando una solicitud cancelada permanecía en el slot; ahora todas las rutas finales de una solicitud restablecen el slot, y una solicitud o respuesta residual encontrada al comienzo de una nueva solicitud se elimina. | — | — |
| `OL_E_RUNTIME_CHANNEL_CLOSED` | `OmsiLaunchService.LiveSession.RequestRuntimeAsync` | El buzón se ha desechado porque la sesión está terminando. | Lanzado (`InvalidOperationException`) | Ninguna acción; la sesión ha terminado. |
| `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 restablece y se genera el error; la siguiente solicitud funciona con normalidad. | Lanzado (`InvalidDataException`) | Vuelve a intentarlo; notifícalo si persiste. |
| `OL_E_RUNTIME_CONSTANTS_UNAVAILABLE` | `OmsiRuntimeReaders` | El puntero al bloque de constantes del vehículo es nulo. | 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 | Enumera primero las constantes. |
| `OL_E_RUNTIME_CREATED_OBJECT_INVALID` | `OmsiRuntimeReaders.RegisterRoadVehicleHandleAsync` | El objeto creado por la generación tiene una VMT fuera del rango de la imagen de OMSI. | Detalle de runtime | Notifícalo. |
| `OL_E_RUNTIME_CREATED_OBJECT_NOT_IN_COLLECTION` | ídem | El objeto creado no está en la colección de vehículos de carretera. | Detalle de runtime | Notifícalo. |
| `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` | ídem | La curva no tiene puntos. | Detalle de runtime | Lo mismo. |
| `OL_E_RUNTIME_CURVE_INVALID` | ídem | Ningún segmento de la curva contiene `x`. | Detalle de runtime | Evalúa dentro del dominio de la curva. |
| `OL_E_RUNTIME_CURVE_NOT_FOUND` | ídem | `name` es desconocido o su puntero de función es nulo. | Detalle de runtime | Enumera primero las curvas. |
| `OL_E_RUNTIME_HOF_UNAVAILABLE` | `OmsiRuntimeReaders.ReadRoadVehicleHofsAsync` | El puntero a la definición del vehículo es nulo. | Detalle de runtime | El handle hace referencia 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 ejecutable. | Envelope de la CLI, salida 7 | Vuelve a instalar el paquete. |
| `OL_E_RUNTIME_OBJECT_HANDLE_REQUIRED` | `CurrentRuntimeControl` | Falta `handle` 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 | Proporciona el handle. |
| `OL_E_RUNTIME_OBJECT_HANDLE_STALE` | `OmsiRuntimeReaders` | El handle es desconocido, el objeto ha salido de la colección, la generación de direcciones ha avanzado o la huella del objeto (VMT + identidad de la definición/el modelo) ha cambiado porque la dirección se ha reutilizado. 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 | Vuelve a ejecutar `road-vehicles.list`/`humans.list` y usa el nuevo handle. |
| `OL_E_RUNTIME_OPERATION_FAILED` | `CurrentRuntimeControl.Execute`; `CurrentRuntimeCommandMailbox.TryDispatch`; alternativa de `D3DRuntimeApi` | Envoltorio genérico de fallos 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 se 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 | Lee `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 el registro y el plugin). | Detalle de runtime | Vuelve a instalar un paquete coherente. |
| `OL_E_RUNTIME_OPERATION_UNKNOWN` | `PublicCapabilityRegistry.ValidateRuntimeArguments` | La operación no está en `PublicRuntimeOperationIds`, lo que incluye todas las operaciones `internal.*`. Se comprueba antes de buscar la sesión. | Resultado de runtime; respuesta de control; salida 2 de la CLI | Usa un id de operación público. |
| `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 notifica como `code` del evento `camera.lock.degraded` cuando falla la reaplicación. | Detalle de runtime / evento de runtime | Bloquea sin preset, o usa una sesión con vehículo del jugador. |
| `OL_E_RUNTIME_PROTOCOL_MISMATCH` | `D3DRuntimeApi` | Un resultado D3D correcto no tenía valores, o tenía una cadena de estado del dispositivo desconocida. | Lanzado (`OmsiRuntimeException`) | Haz 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 elimina antes de generar el error. | Lanzado (`InvalidOperationException`) | Usa ids de solicitud estrictamente crecientes. |
| `OL_E_RUNTIME_REQUEST_TIMEOUT` | `CurrentRuntimeCommandStore.RequestAsync` | No hay respuesta dentro de `timeout`; el slot se restablece y una respuesta tardía se descarta. | Lanzado (`TimeoutException`); salida 5 de la CLI | Vuelve a intentarlo con un timeout más largo; comprueba que OMSI no está bloqueado (cuadro de diálogo modal, carga). |
| `OL_E_RUNTIME_RESPONSE_INVALID` | `CurrentRuntimeCommandStore` | El envelope 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 restablece antes de generar el error, de modo que la siguiente solicitud funciona con normalidad. | Lanzado (`InvalidDataException`) | Vuelve a intentarlo; notifícalo 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 está acotado. | Resultado de runtime | Usa 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 nulo. | 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 (lo lanza el host), o una solicitud llegó a un plugin vinculado a otra sesión (el plugin lo devuelve como resultado tipado). | Lanzado (`InvalidOperationException`) / resultado de runtime | Construye el comando con `session.SessionId`. |
| `OL_E_RUNTIME_SETTING_NOT_PERSISTENT` | `CurrentRuntimeControl.SetWeather` | `weather.set` siempre se rechaza: OMSI sobrescribe los campos meteorológicos perfilados en su siguiente ciclo meteorológico, por lo que una escritura no puede notificarse como un cambio semántico. | Resultado de runtime | Ninguna acción; `weather.set` es `UNAVAILABLE`. |
| `OL_E_RUNTIME_SETTING_UNAVAILABLE` | `OmsiWeatherWriter` | Nombre de campo meteorológico desconocido. Actualmente inalcanzable porque `weather.set` se rechaza antes. | Detalle de runtime (definido) | Consulta 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 | Enumera primero las variables de cadena. |
| `OL_E_RUNTIME_VALUE_INVALID` | `OmsiWeatherWriter.ParseBoolean` | Un booleano meteorológico no es `true`/`false`/`1`/`0`. Actualmente inalcanzable (véase arriba). | Detalle de runtime (definido) | Consulta 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 finito; `vehicle.curve.evaluate`: `x` no finito. | Detalle de runtime | Usa 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 | Enumera primero las variables. |
| `OL_E_RUNTIME_VARIABLE_UNAVAILABLE` | `OmsiRuntimeReaders` | El slot de la variable o la dirección del valor es nulo. | 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ó un fallo. | Detalle de runtime | Vuelve a intentarlo; vuelve 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 ha perdido. | Espera a `d3d.restored`; vuelve a crear las texturas (la generación ha cambiado). |
| `OL_E_D3D_INVALID_ARGUMENT` | 14: `width`, `height`, `level`, `x`, `y`, `format` o `handle` ausente o no válido (rangos: width/height 1..4096, levels 0..16, level 0..15, x/y 0..4095). | Corrige los argumentos. |
| `OL_E_D3D_INVALID_PIXEL_BUFFER` | `pixels_base64` no es Base64 válido o supera 48 KiB. | Envía 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`). | Usa un formato de la lista. |
| `OL_E_D3D_NATIVE_CALL_FAILED` | Cualquier otro estado; el HRESULT está en `detail`. | Notifícalo con el HRESULT. |
| `OL_E_D3D_NOT_READY` | 7: el dispositivo no está listo (antes del primer fotograma o durante la detención). | Vuelve a intentarlo después de `d3d.ready`. |
| `OL_E_D3D_RESET_IN_PROGRESS` | 9: hay un reset del dispositivo en curso. | Vuelve a intentarlo después de `d3d.restored`. |
| `OL_E_D3D_RESOURCE_RELEASED` | 13: el handle de la textura ya se había liberado. | No reutilices 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--` / es cero. | Vuelve a crear la textura. |
## 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 ha solicitado `LastMapState`, `EntrypointIdentity`, el modo de fecha/hora/año, el modo meteorológico, campos del vehículo del jugador o documentos de entrada (`Requested capability unavailable: `). Telemetría: el plugin rechazó el handoff (no puede ocurrir con un plan ejecutable). | Diagnóstico del plan; diagnóstico de la sesión | Quita la solicitud no compatible ([limitaciones conocidas](https://omsilaunch.omsimods.com.br/es/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 un solo uso para el inicio headless. | Diagnóstico de la sesión (`Failed`) | Verifica el build; notifícalo. |
| `OL_E_NO_ACTIVE_SESSION` | Cliente de la CLI (`ReportForwarded`, `CliEventWatch`) | Ningún propietario responde en la canalización de control de la instalación (no hay sesión, o el propietario aún se está iniciando/validando). | Envelope de la CLI, salida 4 | Inicia una sesión o espera 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á detenido antes de la inicialización del plugin). | Diagnóstico de la sesión (`Failed`) | Revisa el conjunto de archivos 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 analizable | 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`) | Haz coincidir las versiones del host y del plugin (vuelve a instalar el paquete). |
| `OL_E_SESSION_ALREADY_ACTIVE` | `CliProgram.RunAsync` | Ya hay un propietario que responde a `session.status` para esta instalación. | Envelope de la CLI, salida 7 | Usa 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`) | 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 | Consulta [Presentación](#presentation). |
| `OL_E_SESSION_START_FAILED` | `WindowsHost.ShowFailure` (cuadro de diálogo de OmsiLaunchW) | Código de reserva que se muestra cuando un plan de lanzamiento no es ejecutable o la sesión no llegó a la fase de juego, y no existe ningún diagnóstico `OL_E_`. | Solo cuadro de mensaje | Lee `.omsilaunch\diagnostics`. |
| `OL_E_SITUATION_LOAD_FAILED` | `ApplyTelemetry` en `world.situation.failed` | El inicio nativo de la situación guardada devolvió un fallo (`native_status` en el evento). | Diagnóstico de la sesión (`Failed`) | Revisa 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`) | Aumenta `/startup-timeout` para mapas grandes; consulta `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 empieza por el código interno). | Diagnóstico de la sesión (`Failed`) | Actúa según el código interno. |
| `OL_E_WORLD_START_FAILED` | `ApplyTelemetry` en `world.failed` | El inicio nativo de NEW_MAP devolvió un fallo (`native_status` en el evento). | Diagnóstico de la sesión (`Failed`) | Revisa el mapa, el índice del punto de entrada y los registros 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. Consulta [perfiles de sesión](https://omsilaunch.omsimods.com.br/es/docs/reference/session-profiles/index.md).
| Código | Significado / causa típica | Qué hacer |
| --- | --- | --- |
| `OL_E_SESSION_PROFILE_ASSET_MISSING` | El directorio `assets` del splash del preset o el archivo `profile` de texturas de Internet no existe dentro del paquete. | Añade el recurso. |
| `OL_E_SESSION_PROFILE_INVALID` | Infracción estructural o de límites: más de 256 KiB, no hay exactamente un mapeo raíz, anclas YAML, clave desconocida, falta una clave obligatoria, un valor no escalar donde se exige un escalar, `id` difiere del nombre del directorio, presets fuera de 1..5 o `index` duplicado, timeouts no positivos, modo meteorológico/de splash/de texturas de Internet no compatible, fecha/hora que no es `explicit`, YAML no válido, errores de análisis de números/fechas. | Corrige 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) o el mapa de la situación seleccionada (SAVED_SITUATION). | Elige un mundo compatible. |
| `OL_E_SESSION_PROFILE_NOT_FOUND` | `\.omsilaunch\session-profiles\\profile.yaml` no existe. | Comprueba el id. |
| `OL_E_SESSION_PROFILE_OVERRIDE_CONFLICT` | Un argumento explícito de la CLI se dirige a un campo que pertenece al perfil/preset seleccionado. | Quita el flag o elige otro preset. |
| `OL_E_SESSION_PROFILE_PATH_ESCAPE` | El id contiene `\`, `/`, `:` o `..`; o una ruta de recurso es absoluta, sale del paquete o atraviesa una unión (junction) o un enlace simbólico. | Mantén 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. | Usa un índice de preset declarado. |
| `OL_E_SESSION_PROFILE_SCHEMA_UNSUPPORTED` | `schema` no es `omsilaunch.session-profile/v1`. | Usa el esquema compatible. |
| `OL_E_SESSION_PROFILE_SETTING_NOT_WRITABLE` | Una clave de ajuste del preset es conocida pero no admite escritura. | Quita la clave. |
| `OL_E_SESSION_PROFILE_SETTING_UNKNOWN` | Una clave de ajuste del preset no está en el catálogo. | Usa una clave del catálogo. |
## Transacción
Consulta [transacciones y recuperación](https://omsilaunch.omsimods.com.br/es/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 a través de `OL_E_START_SESSION` | Elimina `\closecheck` manualmente (permisos). |
| `OL_E_RECOVERY_ABSENT_OWNERSHIP_MISMATCH` | `FileConfigurationTransaction.RestoreAsync` | Una ruta que no existía antes de la sesión contiene ahora un contenido distinto del que aplicó la sesión; no se elimina y se conserva el diario. | Lanzado (`IOException`); dentro de `OL_E_RESTORE_FAILED` / `OL_E_START_SESSION`; salida 8 de la CLI | Examina el archivo; elimínalo o muévelo y, después, usa `/recover`. |
| `OL_E_RECOVERY_ABSENT_OWNERSHIP_UNVERIFIED` | `RestoreAsync` (diario anterior a las huellas) | El diario no tiene huella del contenido aplicado para una ruta que originalmente no existía y no es de eliminación, por lo que no se puede demostrar la propiedad. Al iniciar la sesión, la recuperación se aplaza y se reintenta con los bytes planificados de esta sesión; a través de `RecoverPendingAsync` se lanza. | Lanzado (`IOException`); salida 8 de la CLI | Inicia una sesión con la misma spec (aporta los bytes), o examina y elimina el archivo y, después, usa `/recover`. |
| `OL_E_RECOVERY_BACKUP_CORRUPT` | `RestoreAsync` | El SHA-256 de una copia de seguridad no coincide con el snapshot registrado en el diario; no se escribe nada. | Lanzado; dentro de `OL_E_RESTORE_FAILED`; salida 8 de la CLI | Restaura el archivo desde tu propia copia de seguridad; después elimina el diario solo cuando estés seguro. |
| `OL_E_RECOVERY_JOURNAL_MISSING` | `RestoreAsync` | Existen snapshots en memoria, pero `journal.json` ha desaparecido (eliminado durante la sesión). | Lanzado; dentro de `OL_E_RESTORE_FAILED` | Verifica manualmente los archivos de la sesión. |
| `OL_E_RECOVERY_JOURNAL_REMOVE_FAILED` | `FileConfigurationTransaction.RemoveJournal` | `journal.json` sigue existiendo después de eliminarlo (la propia restauración se completó correctamente y se verificó). | Lanzado; dentro de `OL_E_RESTORE_FAILED`; salida 8 de la CLI | Elimina `\.omsilaunch\journal.json` (permisos) o vuelve a ejecutar `/recover` (idempotente). |
| `OL_E_RESTORE_DEFERRED` | `OmsiLaunchService` (fallo de inicio / supervisor) | No se pudo confirmar la salida de OMSI, por lo que los archivos no se reemplazaron mientras OMSI todavía podía estar usándolos; se conserva el diario. | Diagnóstico de la sesión (`Failed`) | Cuando `Omsi.exe` haya terminado, ejecuta `/recover` (o el siguiente inicio recupera automáticamente). |
| `OL_E_RESTORE_FAILED` | `OmsiLaunchService` (fallo de inicio / supervisor) | `RestoreAsync` lanzó una excepción; el mensaje lleva el código interno; se conserva el diario. | Diagnóstico de la sesión (`Failed`); salida 8 de la CLI cuando se lanza desde `/recover` | Actúa según el código interno y, después, usa `/recover`. |
## Advertencia
| Código | Generado por | Significado | Superficie | Qué hacer |
| --- | --- | --- | --- | --- |
| `OL_W_RESTORE_FOREIGN_FILE_RETAINED` | `FileConfigurationTransaction.RestoreAsync` | Una ruta de eliminación de sesión (destino ITX, `Texture\standard.ipr`, `closecheck`) no existía antes de la sesión y existe ahora, pero nunca se inició ningún proceso de OMSI bajo este diario, por lo que el archivo no puede ser un subproducto de la sesión. Se conserva y se notifica (mensaje = ruta relativa, `Data["sha256"]`); la transacción se completa igualmente. | Diagnóstico de la sesión / `RecoveryStatus.Diagnostics` (no afecta al estado) | Examina el archivo; elimínalo tú mismo si no lo quieres. |
## 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 sesión durante una sesión cuyo proceso se había iniciado; se eliminó para restaurar su 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 los eventos de runtime (`RuntimeEvent.Type`, no son diagnósticos) se enumeran en el [ciclo de vida de la sesión](https://omsilaunch.omsimods.com.br/es/docs/concepts/session-lifecycle/index.md#telemetry-events).