Project Zomboid servers kunnen crashen of niet opstarten door verschillende bekende oorzaken. Deze gids behandelt de meest voorkomende oorzaken die gezien worden in Legion Hosting supporttickets — van een Build 42 geheugenbug die extra RAM vereist bij het opstarten, tot een back-up overflow die /tmp vult, tot beschadigde configuratiebestanden. Werk de onderstaande secties in volgorde door.

Voordat je begint — Vind je crashlogs

Bijna elke Project Zomboid crash laat sporen achter op een van twee plaatsen. Controleer beide voordat je een oplossing probeert, zodat je weet welke sectie van deze gids op jou van toepassing is.

GPanel Console-uitvoer

1. Log in op GPanel.
2. Selecteer je Project Zomboid server uit de serverlijst.
3. Klik op het tabblad Console.
4. Scroll naar de onderkant van de uitvoer. Zoek naar regels gemarkeerd met ERROR, FATAL, OutOfMemoryError of Exception. De laatste 20–30 regels voordat de server stopte zijn meestal het meest relevant.
5. Als de console leeg is, is het serverproces beëindigd voordat het iets kon schrijven — dit is op zichzelf een aanwijzing (zie de B42 geheugensectie hieronder).

Het Server debug.log bestand

Project Zomboid schrijft een gedetailleerd logbestand naar debug.log in de datadirectory van de server. Dit bestand bevat vaak een volledige Java stack trace die direct naar de oorzaak van de crash wijst.

1. Ga in GPanel naar het tabblad File Manager.
2. Navigeer naar /.cache/Logs/. Je ziet bestanden met namen zoals debug.log, DebugLog-server.txt of logbestanden met datums.
3. Open het meest recente logbestand. Gebruik Ctrl+End of scroll helemaal naar beneden en lees vanaf daar omhoog.
4. Zoek naar de trefwoorden OutOfMemoryError, IOException, NullPointerException of SandboxVars. Kopieer de relevante regels — je hebt ze nodig als je een supportticket opent.

Oplossing 1 — Build 42 Hoog geheugenverbruik bij het opstarten (Bekende gamebug)

Als je server onmiddellijk afsluit bij het opstarten zonder foutmelding in de console, of als de console OutOfMemoryError of een Java heap space fout toont, heeft de server onvoldoende geheugen voordat de wereld klaar is met laden.

Symptomen

• Server start op, console scrollt een paar seconden en stopt dan zonder foutmelding voor spelers.
• Console toont java.lang.OutOfMemoryError: Java heap space of GC overhead limit exceeded.
• Server werkt bij sommige herstarts maar niet bij andere (geheugenbeschikbaarheid varieert).
• Server werkte prima op B41 maar crasht consistent na het upgraden naar B42.

Stappen

1. Klik in GPanel op je server en ga naar het tabblad Console. Noteer de huidige RAM-toewijzing van je server die wordt weergegeven in de resourcebalk of het serverinfopaneel.
2. Als je abonnement minder dan 10 GB RAM bevat, kan de server crashen tijdens het opstarten omdat B42 ongeveer 9 GB nodig heeft om te initialiseren. Je moet je abonnement upgraden of wachten tot de Indie Stone een fix uitbrengt.
3. Als je abonnement al 10 GB of meer heeft en de server nog steeds crasht bij het opstarten, ga dan naar het tabblad Startup in GPanel.
4. Zoek naar een veld met het label Java Memory, Max RAM of Xmx. Bevestig dat het is ingesteld op niet meer dan 80–85% van je totale beschikbare RAM. Bijvoorbeeld, bij een 12 GB abonnement, stel dit in op 10240 (10 GB in megabytes). Stel het niet gelijk aan of hoger dan je totale RAM in — het besturingssysteem en andere processen hebben ook geheugen nodig.
5. Klik op Save in het tabblad Startup en herstart je server.
6. Bekijk de console tijdens het opstarten. Als de server de regel SERVER STARTED bereikt of LuaManager: Loading lua files... voltooid wordt zonder crash, is de geheugentoewijzing nu voldoende.

Oplossing 2 — BackupsOnStart overvloeit /tmp (Opstartcrash)

Project Zomboid kan geconfigureerd worden om een volledige wereldback-up te maken elke keer dat de server opstart. Wanneer deze back-up naar /tmp wordt geschreven — dat beperkt is in grootte op de meeste Linux-hosts — crasht de server halverwege het opstarten met een schijfschrijffout zodra /tmp vol raakt.

Symptomen

• Server crasht betrouwbaar bij elke herstart, maar werkte eerder wel.
• Console of debug.log bevat fouten zoals IOException: No space left on device of vermeldingen van schrijven naar /tmp/.
• Crashes worden erger naarmate de tijd verstrijkt omdat de wereldopslag groter wordt.
• Server start soms wel op als je het kort na een schone herstart van het hostknooppunt probeert (voordat /tmp weer vol raakt).

Stappen — BackupsOnStart uitschakelen

1. Ga in GPanel naar het tabblad File Manager.
2. Navigeer naar /.cache/server/. Zoek je serverconfiguratie bestand — dit heet doorgaans servertest.ini of wat je servernaam ook is gevolgd door .ini (bijv. MyServer.ini).
3. Open het .ini bestand om te bewerken.
4. Gebruik de zoekfunctie van je browser (Ctrl+F) om te zoeken naar BackupsOnStart.
5. Wijzig de waarde van true naar false:

   BackupsOnStart=false

6. Controleer terwijl je in het bestand bent ook de instelling BackupsOnVersionChange en zet deze op false als schijfruimte een probleem is:

   BackupsOnVersionChange=false

7. Sla het bestand op en herstart je server. Controleer de console om te bevestigen dat de server de regel SERVER STARTED bereikt.

Oplossing 3 — Beschadigde SandboxVars.lua of serverconfiguratie

Project Zomboid slaat wereldinstellingen op in een Lua-bestand genaamd SandboxVars.lua. Als dit bestand handmatig bewerkt en opgeslagen wordt met een syntaxisfout, of als een bestandsoverdracht werd onderbroken, crasht de server onmiddellijk bij het opstarten wanneer het probeert het bestand te verwerken.

Symptomen

• Console toont ERROR: SandboxVars, LuaManager error of een Lua-parsefout met een regelnummer.
• De crash begon direct nadat je instellingen in het .ini bestand of SandboxVars.lua rechtstreeks hebt bewerkt.
• De server kan Bad argument #1 to of vergelijkbare Lua-runtimefouten tonen.

Stappen — SandboxVars.lua controleren en repareren

1. Ga in GPanel naar File Manager en navigeer naar /.cache/saves/multiplayer/<YourServerName>/.
2. Open SandboxVars.lua om te bewerken.
3. Controleer of het bestand begint met VERSION = 1, (of vergelijkbaar) binnen een SandboxVars = { blok, en eindigt met een afsluitende }. Elke ontbrekende komma, niet-gesloten accolade of verdwaald teken veroorzaakt een parsefout.
4. Als je de fout niet kunt identificeren, is de veiligste oplossing om SandboxVars.lua volledig te verwijderen. De server genereert het opnieuw met standaardwaarden bij de volgende opstart. Let op: dit reset je sandbox-instellingen (loot, zombie-aantal, enz.) naar standaardwaarden — je kaartgegevens en spelergegevens worden niet beïnvloed.
5. Controleer ook het .ini bestand in /.cache/server/ op vergelijkbare problemen als je het recentelijk handmatig hebt bewerkt. Zorg ervoor dat elke regel het formaat Key=Value volgt zonder lege regels binnen een waarde.
6. Sla wijzigingen op en herstart de server.

Oplossing 4 — Leeg admin-wachtwoord veroorzaakt crash

Project Zomboid vereist een niet-leeg admin-wachtwoord om een multiplayerserver te starten. Als het wachtwoordveld leeg is, sluit het serverproces onmiddellijk af na het proberen te initialiseren van het admin-account.

Symptomen

• Gloednieuwe server of recent gereset server mislukt bij elke startpoging.
• Console-uitvoer is erg kort — de server print een paar initialisatieregels en stopt dan.
• debug.log kan een verwijzing naar het admin-account of wachtwoordvalidatie bevatten.

Stappen

1. Klik in GPanel op je server en ga naar het tabblad Startup.
2. Zoek naar een veld met het label Admin Password of RCON Password. Bevestig dat het een waarde bevat — het mag niet leeg zijn.
3. Als het veld leeg is, voer dan een wachtwoord in. Gebruik minimaal 8 tekens. Vermijd speciale tekens zoals !, #, $ of @ in het admin-wachtwoord, aangezien sommige PZ-versies deze niet correct kunnen verwerken in de opstartargumenten.
4. Klik op Save en herstart de server.
5. Open als secundaire controle het .ini bestand in /.cache/server/ en bevestig dat de regel AdminPassword= een waarde heeft na het gelijkteken.

Oplossing 5 — De wereld resetten (Laatste redmiddel bij aanhoudende crashes)

Als een wereldopslag beschadigd raakt — bijvoorbeeld na een harde servercrash, een mislukte update of bestandssysteemfouten — zijn de opslaggegevens mogelijk onherstelbaar. In dat geval is het verwijderen van de wereld en opnieuw beginnen de enige optie.

Stappen

1. Stop je server in GPanel voordat je wijzigingen aanbrengt in de opslagbestanden. Bestanden bewerken op een draaiende server kan verdere beschadiging veroorzaken.
2. Ga in GPanel naar het tabblad File Manager.
3. Navigeer naar /.cache/saves/multiplayer/.
4. Je ziet een of meer mappen met je servernaam (bijv. servertest). Download de map optioneel als back-up voordat je deze verwijdert door deze te selecteren en de downloadoptie te gebruiken — zelfs een beschadigde opslag kan later gedeeltelijk herstelbaar zijn.
5. Verwijder de map met je servernaam in Multiplayer/. Verwijder niet de map Multiplayer zelf.
6. Navigeer ook naar /.cache/db/ en verwijder het bestand <YourServerName>.db. Deze database bevat spelerstatistieken en kan verwijzen naar de oude wereld — het opnieuw genereren voorkomt inconsistenties.
7. Start je server. Er wordt een nieuwe wereld gegenereerd met de instellingen in je .ini bestand.

Snelle diagnostische referentie

Crasht nog steeds na alle stappen?