---
title: Logs y depuración
summary: Registros X4, marcadores de diagnóstico útiles y la diferencia entre fallos de importación, evento, ejecución y resultado.
section: start
kind: guide
status: reference
updated: 2026-10-27
tags: ["X4","modding","debugging"]
sources: ["https://wiki.egosoft.com/X%20Rebirth%20Wiki/Modding%20support/Mission%20Director%20Guide/","https://chemodun.github.io/x4/modding-support/running-x4-for-modding/"]
---
## Habilitar el registro


Utilice los argumentos de lanzamiento que aparecen a continuación para el diagnóstico de scripts. Encuentre el registro en el perfil de usuario que realmente utiliza el proceso del juego, especialmente con múltiples perfiles de prueba. `debug_text` Lua UI puede utilizar el juego `DebugError` cuando esté disponible; el ejemplo comprueba su prerrequisito API de eventos.




```text
-debug scripts -logfile debuglog.txt
```




```xml
<debug_text text="'WIKI: entered Read handler'" />
```




```lua
if type(RegisterEvent) ~= "function" then
    DebugError("[WIKI] UI event API unavailable")
    return
end
```

## Cuatro fallas diferentes


| Etapa | Comprobar |
| --- | --- |
| Importar | Validez XML, esquema, nombre de archivo, productos |
| Evento | nombre de pantalla/control y hora de registro de la llamada |
| Ejecución | Tipos de argumentos, existencia del objeto y permisos |
| Resultado | Valor real, objeto, cuenta o cola en juego |


No registre el éxito genérico inmediatamente después de enviar un evento. Use marcadores precisos como `sent`, `received`, `validated`, `applied` y `readback_ok`.



## Recopilar una instantánea completa


Lea todos los hechos requeridos antes de reportar diferencias. Parar en el primer desajuste pierde evidencia sobre otros objetos y puede forzar una repetición innecesariamente costosa. El ambiente de la UI inspeccionada carecía del estándar Lua `debug` biblioteca; verificar la disponibilidad antes de depender de ella. Entrada/marcos de agüero cortos ayudaron a investigar callbacks de mapas.



## Lanzar argumentos sin trampas comunes


La investigación de Chem O’Dun X4 9.00 distingue `-logfile`, que abre un archivo, desde `-debug`, Repita los filtros como argumentos separados:



```text
-debug scripts -debug fileio -logfile logs/wiki-session.log
```



**Resultado esperado:** `logs/wiki-session.log` en el perfil personal activo, con diagnósticos de script y archivo. `-debug scripts,fileio` no es equivalente a dos filtros. Copiar un registro útil antes de que el siguiente lanzamiento lo sobrescriba.



`debug_to_file` necesita el `-scriptlogfiles` tag; los atributos de la acción proporcionan su nombre de archivo y directorio, no una palabra después de la bandera. `-godlog` informa sobre la generación de estaciones, no sobre un inventario universal del mundo actual. La fuente describe sus medidas y límites.



## Un perfil de experimento separado


Argumentos adicionales, no un comando de lanzamiento automático:



```text
-personalfolderid wiki_lab -dontsaveconfig -skipintro
```



El primero selecciona un perfil personal separado. `-dontsaveconfig` bloques `config.xml` escribe para la sesión; no protege a todos los `userdata.xml`. No es un modo universal sin guardar. Mantenga una lista de mods separada y deliberada. Pase argumentos a X4 en sí mismo; un atajo de lanzador de terceros no puede reenviarlos.



Estos modos no se ejecutaron para este artículo. Grabe argumentos exactos y versión del juego. Para objetos NPC, lea [trabajos y Dios](wiki:jobs-and-god).