Debug mode auf einem Project Zomboid-Server aktivieren
Öffne deinen Server im Control Panel, geh auf den Tab Start (Startup) und schalte Debug mode ein. Die Einstellung wird sofort beim Klicken gespeichert und wird beim nächsten Neustart des Servers wirksam.
Was Debug mode auf dem Server bewirkt
Debug mode startet den Project Zomboid-Serverprozess mit dem -debug-Flag des Spiels. Auf einem Server heißt das vor allem eines: Entwickler-Logging. Bei jedem Start gibt Project Zomboid eine Logs configuration:-Tabelle aus, in der alle Log-Kategorien und die jeweils eingestellte Stufe stehen. Bei einem normalen Start stehen fast alle auf Warning, der Server schreibt also nur dann etwas mit, wenn es ein Problem gibt.
Mit eingeschaltetem Debug mode fallen alle 51 Kategorien auf General, die ausführliche Stufe. Der Server protokolliert dann auch den normalen Betrieb und nicht nur Warnungen und Fehler, sodass du ein viel genaueres Bild davon bekommst, was im Vorfeld eines Problems passiert ist. Das ist der Effekt, den du sehen und nutzen kannst, und genau deshalb greift man zu dem Schalter, wenn man etwas sucht, an das man sonst nicht herankommt.
Manche Mods verlangen ebenfalls Debug mode, das ist der zweite häufige Grund, es einzuschalten. Lies vorher die Anleitung des Mods, denn "debug mode" kann den Server meinen oder deine eigene Kopie des Spiels, und das sind zwei verschiedene Einstellungen. Weiter unten gibt es einen Abschnitt dazu, wie du sie auseinanderhältst.
Sonst ändert sich am Server nichts. Er startet normal, Spieler verbinden sich wie gewohnt, und deine Welt, deine Config und deine installierten Mods bleiben unberührt.
Debug mode einschalten
- Öffne deinen Server im Panel und wähle links in der Bereichsliste Start aus.
- Debug mode ist die erste Karte auf dem Tab.
- Klick auf den Schalter. Er speichert sofort, und die Zeile darunter sagt "Wird beim nächsten Neustart wirksam".
- Starte den Server über den Tab Konsole neu.
Sobald er an ist, wird der Schalter blau und bleibt es, bis du ihn wieder ausschaltest.
Auf dem Handy oder in einem schmalen Browserfenster klappt die Bereichsliste zu einer Bereich-Auswahl über dem Inhalt zusammen. Tippe darauf und wähle Start, um zur selben Karte zu kommen.
Es gibt hier keinen Startbefehl, den du selbst bearbeiten müsstest, und das ist Absicht. Der Launcher von Project Zomboid nimmt das Flag nur an, wenn es nach einem ---Trenner übergeben wird: gibst du ihm ein blankes -debug, verweigert er den Start mit unknown option "-debug". Der Schalter baut den Befehl korrekt zusammen, lass den Befehl also in Ruhe und nutze den Schalter.
Prüfen, ob es funktioniert hat
Starte den Server neu und beobachte dabei den Tab Konsole. Scroll zum Logs configuration:-Block am Anfang des Logs. Bei ausgeschaltetem Debug mode enden diese Zeilen auf Warning. Bei eingeschaltetem Debug mode enden sie auf General. Dieser Block ist die klarste Bestätigung, die du bekommen kannst, denn hier meldet der Server selbst, mit welcher Log-Stufe er gestartet ist.
Steht dort weiterhin Warning, wurde der Server seit dem Umlegen des Schalters nicht neu gestartet. Das Speichern der Einstellung schreibt nur den Startbefehl neu, und der Startbefehl wird beim Start gelesen.
Das Debug-Menü im Spiel ist eine Einstellung auf dem Client
Das ist der Teil, der die meiste Verwirrung stiftet, deshalb hier ganz genau: Project Zomboid hat zwei verschiedene Dinge, die debug heißen, und das eine einzuschalten schaltet das andere nicht ein.
Das Debug-Menü im Spiel, also das Käfer-Symbol, das die Entwicklermenüs zum Spawnen von Gegenständen, Teleportieren und anderen Cheats öffnet, gibt es nur auf dem Client. Jeder Spieler schaltet es für seine eigene Kopie des Spiels ein: Rechtsklick auf Project Zomboid in deiner Steam-Bibliothek, Properties wählen und -debug zu den launch options hinzufügen. Das gilt nur für das Spiel dieses einen Spielers auf dessen Rechner, sonst ist niemand davon betroffen.
Es gibt aber einen Haken, den du kennen solltest, bevor du den Tipp weitergibst. Auf einem Dedicated Server wird ein Spieler, der sich mit -debug in den launch options verbindet, gleich wieder getrennt, sofern er kein Admin ist, und das Spiel meldet das als Debug connection is not allowed for non-admin. Behandle die launch option auf dem Client also als etwas für dich und deine Admins, nicht als etwas, das der ganze Server einschalten soll.
Der Schalter in deinem Control Panel macht das alles nicht. Er versetzt den Serverprozess in Debug mode, und deshalb zeigt sich der sichtbare Effekt im Log des Servers und nicht im Spiel von irgendjemandem. Ihn einzuschalten zaubert deinen Spielern kein Käfer-Symbol auf den Bildschirm, und ein Spieler, der -debug in Steam setzt, versetzt deinen Server nicht in Debug mode. Die beiden Einstellungen sind unabhängig voneinander, und du kannst die eine ohne die andere fahren.
Wenn du also eigentlich Gegenstände spawnen oder dich auf deinem eigenen Server teleportieren willst, ist Debug mode auf dem Server nicht die Einstellung, die du suchst. Du brauchst einen Admin-Account, und die launch option auf dem Client, falls du zusätzlich das Entwicklermenü haben willst.
Wann du Debug mode ausgeschaltet lassen solltest
Debug mode ist ein Werkzeug für einen bestimmten Zweck und keine Einstellung, die dauerhaft an bleiben sollte. Die Entwickler raten davon ab, debug im Multiplayer laufen zu lassen, weil es Leistung kostet, und die Logmenge ist die sichtbare Seite derselben Sache: jede Kategorie fällt von Warning auf General, der Server schreibt also deutlich mehr auf die Platte als sonst, und zwar so lange er läuft. Auf einem gut besuchten Server mit mehreren Spielern wachsen diese Dateien stetig und fressen den Speicherplatz, den deine Welt und deine Backups brauchen.
Dazu kommt ein praktischer Preis. Ein ausführliches Log ist schwerer zu lesen als ein ruhiges, und der Fehler, den du eigentlich suchst, verschwindet unter Tausenden von Routinezeilen, die es nur gibt, weil Debug mode an ist.
Schalte es also ein, wenn du es brauchst, erledige das, wofür du es gebraucht hast, und schalte es wieder aus und starte neu. Wenn es schon länger an war, öffne den Tab Dateien, geh in den Ordner .cache und räum die alten Logdateien weg, die du nicht mehr brauchst.
Häufige Probleme
Ich habe es eingeschaltet, aber nichts hat sich geändert. Der Schalter schreibt nur den Startbefehl neu. Starte den Server über den Tab Konsole neu und prüfe dann den Logs configuration:-Block wie oben beschrieben.
Ein Mod sagt, es braucht Debug mode, und es geht trotzdem nicht. Kläre, welche Seite der Mod meint. Braucht er den Server im Debug mode, ist dieser Schalter richtig. Braucht er dein Spiel im Debug mode, gehört die launch option an deine eigene Kopie von Project Zomboid in Steam. Ein gründlicher Blick in die Workshop-Beschreibung des Mods klärt das meistens. Es lohnt sich außerdem zu prüfen, ob der Mod überhaupt installiert ist und geladen wird: siehe Mods auf einem Project Zomboid-Server installieren (Build 42).
Ich will Gegenstände spawnen oder mich teleportieren, und Debug mode gibt mir das nicht. Das sind Admin-Rechte, nicht Debug mode. Melde dich im Spiel mit deinem Admin-Account an und nutze das Admin-Panel: siehe So wirst du Admin auf einem Project Zomboid-Server.
Ein Spieler fliegt sofort beim Verbinden wieder raus. Prüfe, ob er -debug in seinen eigenen launch options in Steam stehen hat. Ein Dedicated Server weist eine Debug-Verbindung von jedem ab, der kein Admin ist, die Lösung ist also, diese launch option auf seiner Seite zu entfernen. Mit dem Schalter auf dem Server hat das nichts zu tun, und genau deshalb passiert es auch auf Servern, die nie Debug mode an hatten.
Mein Speicherplatzverbrauch ist danach gestiegen. Das ist die erwartete Nebenwirkung des ausführlichen Loggings. Schalte Debug mode aus, starte neu und lösche die Logdateien, die du nicht mehr brauchst, über den Tab Dateien.
Kann ich es nicht einfach anlassen? Der Server läuft damit, es geht also nichts kaputt. Trotzdem lohnt es sich, es nach getaner Arbeit auszuschalten: die Entwickler raten von debug im Multiplayer ab, und die Logs wachsen die ganze Zeit weiter, solange es an ist.
Debug mode gibt es auf jedem Project Zomboid-Server, den wir hosten, aus demselben Control Panel heraus, in dem du auch alles andere verwaltest. Fehlt der Schalter, oder startet der Server nach einem Neustart nicht mehr, mach ein Ticket auf, dann gehen wir das Boot-Log gemeinsam mit dir durch.
