Project Zomboid-Server können aus mehreren bekannten Gründen abstürzen oder nicht starten. Diese Anleitung behandelt die häufigsten Ursachen aus Legion Hosting Support-Tickets — von einem Build 42-Speicherfehler, der beim Start zusätzlichen RAM erfordert, über einen Backup-Überlauf, der /tmp füllt, bis hin zu beschädigten Konfigurationsdateien. Arbeiten Sie die folgenden Abschnitte der Reihe nach durch.

Bevor Sie beginnen — Ihre Crash-Logs finden

Fast jeder Project Zomboid-Absturz hinterlässt Spuren an einer von zwei Stellen. Überprüfen Sie beide, bevor Sie eine Lösung versuchen, damit Sie wissen, welcher Abschnitt dieser Anleitung auf Sie zutrifft.

GPanel-Konsolenausgabe

1. Melden Sie sich bei GPanel an.
2. Wählen Sie Ihren Project Zomboid-Server aus der Serverliste.
3. Klicken Sie auf den Reiter Console.
4. Scrollen Sie zum Ende der Ausgabe. Suchen Sie nach Zeilen mit ERROR, FATAL, OutOfMemoryError oder Exception. Die letzten 20–30 Zeilen vor dem Serverstopp sind meist am relevantesten.
5. Wenn die Konsole leer ist, wurde der Serverprozess beendet, bevor er etwas schreiben konnte — das ist selbst ein Hinweis (siehe den B42-Speicherabschnitt unten).

Die Server-Datei debug.log

Project Zomboid schreibt ein detailliertes Log in debug.log im Datenverzeichnis des Servers. Diese Datei enthält oft einen vollständigen Java-Stack-Trace, der direkt auf die Absturzursache hinweist.

1. Gehen Sie in GPanel zum Reiter File Manager.
2. Navigieren Sie zu /.cache/Logs/. Sie sehen Dateien wie debug.log, DebugLog-server.txt oder datierte Logdateien.
3. Öffnen Sie die neueste Logdatei. Verwenden Sie Ctrl+End oder scrollen Sie ganz nach unten und lesen Sie von dort aufwärts.
4. Suchen Sie nach den Schlüsselwörtern OutOfMemoryError, IOException, NullPointerException oder SandboxVars. Kopieren Sie die relevanten Zeilen — Sie werden sie benötigen, falls Sie ein Support-Ticket eröffnen.

Lösung 1 — Build 42 hoher Speicherverbrauch beim Start (bekannter Spielfehler)

Wenn Ihr Server beim Start sofort beendet wird ohne Fehler in der Konsole, oder die Konsole OutOfMemoryError oder einen Java-Heap-Space-Fehler zeigt, geht dem Server der Speicher aus, bevor die Welt fertig geladen ist.

Symptome

• Server startet, die Konsole scrollt einige Sekunden, dann stoppt er ohne spielerseitige Fehlermeldung.
• Konsole zeigt java.lang.OutOfMemoryError: Java heap space oder GC overhead limit exceeded.
• Server funktioniert bei manchen Neustarts, aber nicht bei anderen (Speicherverfügbarkeit variiert).
• Server lief unter B41 einwandfrei, stürzt aber nach dem Upgrade auf B42 konsistent ab.

Schritte

1. Klicken Sie in GPanel auf Ihren Server und gehen Sie zum Reiter Console. Notieren Sie sich die aktuelle RAM-Zuweisung Ihres Servers, die in der Ressourcenleiste oder im Server-Infopanel angezeigt wird.
2. Wenn Ihr Plan weniger als 10 GB RAM umfasst, kann der Server beim Start abstürzen, da B42 ungefähr 9 GB zur Initialisierung benötigt. Sie müssen Ihren Plan upgraden oder warten, bis The Indie Stone einen Fix veröffentlicht.
3. Wenn Ihr Plan bereits 10 GB oder mehr hat und der Server trotzdem beim Start abstürzt, gehen Sie zum Reiter Startup in GPanel.
4. Suchen Sie nach einem Feld mit der Bezeichnung Java Memory, Max RAM oder Xmx. Bestätigen Sie, dass es auf nicht mehr als 80–85% Ihres gesamten verfügbaren RAMs eingestellt ist. Zum Beispiel setzen Sie es bei einem 12-GB-Plan auf 10240 (10 GB in Megabyte). Setzen Sie es nicht auf den gleichen Wert oder höher als Ihren gesamten RAM — das Betriebssystem und andere Prozesse benötigen ebenfalls Speicher.
5. Klicken Sie auf Save im Startup-Reiter und starten Sie dann Ihren Server neu.
6. Beobachten Sie die Konsole während des Starts. Wenn der Server die Zeile SERVER STARTED erreicht oder LuaManager: Loading lua files... ohne Absturz abschließt, ist die Speicherzuweisung nun ausreichend.

Lösung 2 — BackupsOnStart überflutet /tmp (Startabsturz)

Project Zomboid kann so konfiguriert werden, dass bei jedem Serverstart ein vollständiges Welt-Backup erstellt wird. Wenn dieses Backup in /tmp geschrieben wird — das auf den meisten Linux-Hosts größenbeschränkt ist — stürzt der Server beim Start mit einem Schreibfehler ab, sobald /tmp voll ist.

Symptome

• Server stürzt bei jedem Neustart zuverlässig ab, funktionierte aber zuvor.
• Konsole oder debug.log enthält Fehler wie IOException: No space left on device oder erwähnt das Schreiben nach /tmp/.
• Abstürze werden im Laufe der Zeit schlimmer, da der Weltspeicherstand größer wird.
• Server startet manchmal, wenn Sie es kurz nach einem sauberen Neustart des Host-Knotens versuchen (bevor /tmp wieder voll wird).

Schritte — BackupsOnStart deaktivieren

1. Gehen Sie in GPanel zum Reiter File Manager.
2. Navigieren Sie zu /.cache/server/. Suchen Sie Ihre Serverkonfigurationsdatei — sie heißt typischerweise servertest.ini oder Ihr Servername gefolgt von .ini (z.B. MyServer.ini).
3. Öffnen Sie die .ini-Datei zur Bearbeitung.
4. Verwenden Sie die Suchfunktion Ihres Browsers (Ctrl+F), um nach BackupsOnStart zu suchen.
5. Ändern Sie den Wert von true auf false:

   BackupsOnStart=false

6. Überprüfen Sie in der Datei auch die Einstellung BackupsOnVersionChange und setzen Sie sie auf false, wenn Speicherplatz ein Problem ist:

   BackupsOnVersionChange=false

7. Speichern Sie die Datei und starten Sie Ihren Server neu. Überwachen Sie die Konsole, um zu bestätigen, dass der Server die Zeile SERVER STARTED erreicht.

Lösung 3 — Beschädigte SandboxVars.lua oder Serverkonfiguration

Project Zomboid speichert Welteinstellungen in einer Lua-Datei namens SandboxVars.lua. Wenn diese Datei manuell bearbeitet und mit einem Syntaxfehler gespeichert wird, oder wenn eine Dateiübertragung unterbrochen wurde, stürzt der Server beim Start sofort ab, wenn er versucht, die Datei zu parsen.

Symptome

• Konsole zeigt ERROR: SandboxVars, LuaManager error oder einen Lua-Parse-Fehler mit einer Zeilennummer.
• Der Absturz begann direkt nachdem Sie Einstellungen in der .ini-Datei oder SandboxVars.lua direkt bearbeitet haben.
• Der Server zeigt möglicherweise Bad argument #1 to oder ähnliche Lua-Laufzeitfehler.

Schritte — SandboxVars.lua überprüfen und reparieren

1. Gehen Sie in GPanel zum File Manager und navigieren Sie zu /.cache/saves/multiplayer/<YourServerName>/.
2. Öffnen Sie SandboxVars.lua zur Bearbeitung.
3. Überprüfen Sie, dass die Datei mit VERSION = 1, (oder ähnlich) innerhalb eines SandboxVars = {-Blocks beginnt und mit einer schließenden } endet. Jedes fehlende Komma, jede nicht geschlossene Klammer oder jedes fehlerhafte Zeichen verursacht einen Parse-Fehler.
4. Wenn Sie den Fehler nicht identifizieren können, ist die sicherste Lösung, SandboxVars.lua vollständig zu löschen. Der Server wird sie beim nächsten Start mit Standardwerten neu generieren. Hinweis: Dies setzt Ihre Sandbox-Einstellungen (Loot, Zombieanzahl usw.) auf Standardwerte zurück — Ihre Kartendaten und Spielerdaten sind nicht betroffen.
5. Überprüfen Sie auch die .ini-Datei in /.cache/server/ auf ähnliche Probleme, wenn Sie sie kürzlich manuell bearbeitet haben. Stellen Sie sicher, dass jede Zeile dem Format Key=Value folgt und keine leeren Zeilen innerhalb eines Wertes vorhanden sind.
6. Speichern Sie die Änderungen und starten Sie den Server neu.

Lösung 4 — Leeres Admin-Passwort verursacht Absturz

Project Zomboid erfordert ein nicht-leeres Admin-Passwort, um einen Multiplayer-Server zu starten. Wenn das Passwortfeld leer ist, beendet sich der Serverprozess sofort nach dem Versuch, das Admin-Konto zu initialisieren.

Symptome

• Brandneuer Server oder kürzlich zurückgesetzter Server scheitert bei jedem Startversuch.
• Konsolenausgabe ist sehr kurz — der Server gibt einige Initialisierungszeilen aus und stoppt dann.
• debug.log kann einen Verweis auf das Admin-Konto oder die Passwortvalidierung enthalten.

Schritte

1. Klicken Sie in GPanel auf Ihren Server und gehen Sie zum Reiter Startup.
2. Suchen Sie nach einem Feld mit der Bezeichnung Admin Password oder RCON Password. Bestätigen Sie, dass es einen Wert enthält — es darf nicht leer sein.
3. Wenn das Feld leer ist, geben Sie ein Passwort ein. Verwenden Sie mindestens 8 Zeichen. Vermeiden Sie Sonderzeichen wie !, #, $ oder @ im Admin-Passwort, da einige PZ-Versionen diese in den Startargumenten nicht korrekt verarbeiten.
4. Klicken Sie auf Save und starten Sie den Server neu.
5. Öffnen Sie als zusätzliche Überprüfung die .ini-Datei in /.cache/server/ und bestätigen Sie, dass die Zeile AdminPassword= einen Wert nach dem Gleichheitszeichen hat.

Lösung 5 — Welt zurücksetzen (letzter Ausweg bei dauerhaften Abstürzen)

Wenn ein Weltspeicherstand beschädigt wird — zum Beispiel nach einem harten Serverabsturz, einem fehlgeschlagenen Update oder Dateisystemfehlern — können die Speicherdaten möglicherweise nicht wiederhergestellt werden. In diesem Fall ist das Löschen der Welt und ein Neustart die einzige Option.

Schritte

1. Stoppen Sie Ihren Server in GPanel, bevor Sie Änderungen an den Speicherdateien vornehmen. Das Bearbeiten von Dateien auf einem laufenden Server kann weitere Beschädigungen verursachen.
2. Gehen Sie in GPanel zum Reiter File Manager.
3. Navigieren Sie zu /.cache/saves/multiplayer/.
4. Sie sehen einen oder mehrere Ordner mit Ihrem Servernamen (z.B. servertest). Bevor Sie löschen, laden Sie den Ordner optional als Backup herunter, indem Sie ihn auswählen und die Download-Option verwenden — selbst ein beschädigter Speicherstand kann später teilweise wiederhergestellt werden.
5. Löschen Sie den Ordner mit Ihrem Servernamen innerhalb von Multiplayer/. Löschen Sie nicht den Ordner Multiplayer selbst.
6. Navigieren Sie außerdem zu /.cache/db/ und löschen Sie die Datei <YourServerName>.db. Diese Datenbank enthält Spielerstatistiken und kann auf die alte Welt verweisen — eine Neugenerierung vermeidet Unstimmigkeiten.
7. Starten Sie Ihren Server. Er wird eine neue Welt mit den Einstellungen aus Ihrer .ini-Datei generieren.

Kurzreferenz zur Diagnose

Stürzt nach allen Schritten immer noch ab?