---
title: Protokollierung und Fehlersuche
summary: X4 Protokolle, nützliche Diagnosemarker und der Unterschied zwischen Import, Ereignis, Ausführung und Ergebnisausfällen.
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/"]
---
## Protokoll aktivieren


Verwenden Sie die folgenden Startargumente für die Skriptdiagnose. Finden Sie das Protokoll im Benutzerprofil, das tatsächlich vom Spielprozess verwendet wird, insbesondere mit mehreren Testprofilen. Fügen Sie eine Unterscheidungskraft hinzu `debug_text` Marker in MD. Lua UI kann das Spiel verwenden `DebugError` falls vorhanden; das Beispiel überprüft die Event-API-Voraussetzung.




```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
```

## Vier verschiedene Fehler


| Stufe | Kontrolle |
| --- | --- |
| Importieren | XML Gültigkeit, schema, Dateiname, Abhängigkeiten |
| Ereignis | Bildschirm/Kontrollnamen und Rückruf-Registrierungszeit |
| Ausführung | Type, Objekt-Existenz und Berechtigungen |
| Ergebnis | Tatsächlicher Wert, Objekt, Konto oder Warteschlange im Spiel |


Loggen Sie den Generikaerfolg nicht sofort nach dem Senden eines Ereignisses. Verwenden Sie präzise Marker wie `sent`, `received`, `validated`, `applied` und `readback_ok`.



## Einen vollständigen Snapshot sammeln


Lesen Sie alle erforderlichen Fakten vor der Meldung differences.Stopping bei der ersten Fehlanpassung verliert Beweise über andere Objekte und kann eine unnötige teure Wiederholung zwingen. Lua `debug` Bibliothek; überprüfen Sie die Verfügbarkeit vor, je nachdem. Kurze begrenzt Eintrag / Argument Marker halfen, die Karte Callbacks zu untersuchen.



## Argumente ohne gemeinsame Fallen starten


Chem O, Duns X4 9.00 Untersuchung unterscheidet `-logfile`, die eine Datei öffnet, von `-debug`, die allein keine erzeugt. Filter als separate Argumente wiederholen:



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



**Erwartet:** `logs/wiki-session.log` im aktiven persönlichen Profil, mit Skript und Dateidiagnose. `-debug scripts,fileio` ist nicht gleich zwei Filtern. Kopieren Sie ein nützliches Protokoll, bevor der nächste Start es überschreibt.



`debug_to_file` n der `-scriptlogfiles` flag; die Attribute der Aktion geben den Dateinamen und das Verzeichnis an, nicht ein Wort nach dem Flag. `-godlog` berichtet Stationsgenerierung, nicht ein universelles Inventar der aktuellen Welt. Die Quelle beschreibt ihre Messungen und Grenzen.



## Ein separates Experimentprofil


Zusätzliche Argumente, kein automatischer Startbefehl:



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



Die erste wählt ein separates persönliches Profil aus. `-dontsaveconfig` Blöcke `config.xml` schreibt für die Sitzung; es schützt nicht jedes Speichern oder `userdata.xml`. Es ist kein universeller No-Save-Modus. Halten Sie eine separate Liste mit Speichern und absichtlichen Mods. Übergeben Sie Argumente an X4 selbst; ein Drittanbieter-Launcher-Verknüpfungsbefehl kann sie nicht weiterleiten.



Diese Modi wurden nicht für diesen Artikel ausgeführt. Führen Sie genaue Argumente und Spielversion. Für NPC-Objekte, lesen [Jobs und Gott](wiki:jobs-and-god).