Project Zomboid-servrar kan krascha eller misslyckas med att starta av flera välkända anledningar. Den här guiden täcker de vanligaste orsakerna som setts i supportärenden hos Legion Hosting — från en minnesbugg i Build 42 som kräver extra RAM vid uppstart, till ett säkerhetskopieringsöverflöde som fyller /tmp, till skadade konfigurationsfiler. Arbeta igenom avsnitten nedan i ordning.

Innan du börjar — hitta dina kraschloggar

Nästan varje Project Zomboid-krasch lämnar spår på ett av två ställen. Kontrollera båda innan du försöker med någon åtgärd, så att du vet vilket avsnitt i den här guiden som gäller för dig.

Konsolutdata i GPanel

1. Logga in på GPanel.
2. Välj din Project Zomboid-server från serverlistan.
3. Klicka på fliken Console.
4. Scrolla till botten av utdatan. Leta efter rader markerade med ERROR, FATAL, OutOfMemoryError eller Exception. De sista 20–30 raderna innan servern stoppade är oftast de mest relevanta.
5. Om konsolen är tom avslutades serverprocessen innan den hann skriva något — detta är i sig en ledtråd (se avsnittet om B42-minne nedan).

Serverns debug.log-fil

Project Zomboid skriver en detaljerad logg till debug.log i serverns datakatalog. Denna fil innehåller ofta en fullständig Java-stackspårning som pekar direkt på kraschorsaken.

1. I GPanel, gå till fliken File Manager.
2. Navigera till /.cache/Logs/. Du kommer att se filer med namn som debug.log, DebugLog-server.txt eller daterade loggfiler.
3. Öppna den senaste loggfilen. Använd Ctrl+End eller scrolla längst ner och läs uppåt därifrån.
4. Leta efter nyckelorden OutOfMemoryError, IOException, NullPointerException eller SandboxVars. Kopiera de relevanta raderna — du behöver dem om du öppnar ett supportärende.

Åtgärd 1 — Hög minnesanvändning vid uppstart i Build 42 (känd spelbugg)

Om din server avslutas omedelbart vid uppstart utan något fel i konsolen, eller om konsolen visar OutOfMemoryError eller ett Java heap space-fel, får servern slut på minne innan världen är färdigladdad.

Symptom

• Servern startar, konsolen scrollar i några sekunder och stoppar sedan utan något fel som spelare ser.
• Konsolen visar java.lang.OutOfMemoryError: Java heap space eller GC overhead limit exceeded.
• Servern fungerar vid vissa omstarter men inte andra (tillgängligt minne varierar).
• Servern fungerade bra på B41 men kraschar konsekvent efter uppgradering till B42.

Steg

1. I GPanel, klicka på din server och gå till fliken Console. Notera serverns nuvarande RAM-allokering som visas i resursfältet eller serverinfopanelen.
2. Om ditt abonnemang innehåller mindre än 10 GB RAM kan servern krascha under uppstart eftersom B42 kräver ungefär 9 GB för att initieras. Du behöver uppgradera ditt abonnemang eller vänta på att The Indie Stone släpper en fix.
3. Om ditt abonnemang redan har 10 GB eller mer och servern fortfarande kraschar vid uppstart, gå till fliken Startup i GPanel.
4. Leta efter ett fält märkt Java Memory, Max RAM eller Xmx. Bekräfta att det är satt till högst 80–85 % av ditt totala tillgängliga RAM. Till exempel, på ett abonnemang med 12 GB, ställ in detta på 10240 (10 GB i megabyte). Ställ det inte lika med eller över ditt totala RAM — operativsystemet och andra processer behöver också minne.
5. Klicka på Save på Startup-fliken och starta sedan om servern.
6. Bevaka konsolen under uppstart. Om servern når raden SERVER STARTED eller om LuaManager: Loading lua files... slutförs utan att krascha, är minnesallokeringen nu tillräcklig.

Åtgärd 2 — BackupsOnStart fyller /tmp (kraschar vid uppstart)

Project Zomboid kan konfigureras att skapa en fullständig säkerhetskopia av världen varje gång servern startar. När denna säkerhetskopia skrivs till /tmp — som är begränsad i storlek på de flesta Linux-värdar — kraschar servern mitt i uppstarten med ett diskskrivningsfel när /tmp fylls upp.

Symptom

• Servern kraschar tillförlitligt vid varje omstart, men fungerade tidigare.
• Konsolen eller debug.log innehåller fel som IOException: No space left on device eller nämner skrivning till /tmp/.
• Kraschar tenderar att förvärras med tiden allteftersom världssparningen växer sig större.
• Servern startar ibland om du försöker strax efter en ren omstart av värdnoden (innan /tmp fylls igen).

Steg — Inaktivera BackupsOnStart

1. I GPanel, gå till fliken File Manager.
2. Navigera till /.cache/server/. Leta efter din serverkonfigurationsfil — den heter vanligtvis servertest.ini eller vad ditt servernamn nu är följt av .ini (t.ex. MyServer.ini).
3. Öppna .ini-filen för redigering.
4. Använd webbläsarens sökfunktion (Ctrl+F) för att söka efter BackupsOnStart.
5. Ändra värdet från true till false:

   BackupsOnStart=false

6. Medan du är i filen, kontrollera även inställningen BackupsOnVersionChange och sätt den till false om diskutrymme är ett problem:

   BackupsOnVersionChange=false

7. Spara filen och starta om servern. Bevaka konsolen för att bekräfta att servern når raden SERVER STARTED.

Åtgärd 3 — Skadad SandboxVars.lua eller serverkonfiguration

Project Zomboid lagrar världsinställningar i en Lua-fil som heter SandboxVars.lua. Om denna fil redigeras manuellt och sparas med ett syntaxfel, eller om en filöverföring avbröts, kraschar servern omedelbart vid uppstart när den försöker tolka filen.

Symptom

• Konsolen visar ERROR: SandboxVars, LuaManager error eller ett Lua-tolkningsfel med ett radnummer.
• Kraschen började inträffa direkt efter att du redigerade inställningar i .ini-filen eller SandboxVars.lua direkt.
• Servern kan visa Bad argument #1 to eller liknande Lua-körningsfel.

Steg — Kontrollera och reparera SandboxVars.lua

1. I GPanel, gå till File Manager och navigera till /.cache/saves/multiplayer/<YourServerName>/.
2. Öppna SandboxVars.lua för redigering.
3. Kontrollera att filen börjar med VERSION = 1, (eller liknande) inuti ett SandboxVars = {-block och slutar med en avslutande }. Ett saknat kommatecken, en oavslutad klammerparentes eller ett vilset tecken orsakar ett tolkningsfel.
4. Om du inte kan identifiera felet är den säkraste åtgärden att radera SandboxVars.lua helt. Servern återskapar den med standardvärden vid nästa uppstart. Obs: detta återställer dina sandlådeinställningar (loot, antal zombier osv.) till standard — dina kartdata och spelardata påverkas inte.
5. Kontrollera även .ini-filen i /.cache/server/ för liknande problem om du nyligen redigerade den för hand. Se till att varje rad följer formatet Key=Value utan tomma rader inuti ett värde.
6. Spara ändringarna och starta om servern.

Åtgärd 4 — Tomt admin-lösenord orsakar krasch

Project Zomboid kräver ett icke-tomt admin-lösenord för att starta en flerspelarserver. Om lösenordsfältet är tomt avslutas serverprocessen omedelbart efter att den försökt initiera admin-kontot.

Symptom

• En helt ny server eller en nyligen återställd server misslyckas vid varje startförsök.
• Konsolutdatan är mycket kort — servern skriver ut några initialiseringsrader och stoppar sedan.
• debug.log kan innehålla en referens till admin-kontot eller lösenordsvalidering.

Steg

1. I GPanel, klicka på din server och gå till fliken Startup.
2. Leta efter ett fält märkt Admin Password eller RCON Password. Bekräfta att det innehåller ett värde — det får inte vara tomt.
3. Om fältet är tomt, ange ett lösenord. Använd minst 8 tecken. Undvik specialtecken som !, #, $ eller @ i admin-lösenordet, eftersom vissa PZ-versioner misslyckas med att tolka dem korrekt i uppstartsargumenten.
4. Klicka på Save och starta om servern.
5. Som en sekundär kontroll, öppna .ini-filen i /.cache/server/ och bekräfta att raden AdminPassword= har ett värde efter likhetstecknet.

Åtgärd 5 — Återställ världen (sista utväg vid ihållande krascher)

Om en världssparning blir skadad — till exempel efter en hård serverkrasch, en misslyckad uppdatering eller filsystemfel — kan själva sparningsdatan vara omöjlig att återställa. I detta fall är att radera världen och börja om på nytt det enda alternativet.

Steg

1. Stoppa din server i GPanel innan du gör några ändringar i sparfilerna. Att redigera filer på en server som körs kan orsaka ytterligare skada.
2. I GPanel, gå till fliken File Manager.
3. Navigera till /.cache/saves/multiplayer/.
4. Du kommer att se en eller flera mappar med ditt servernamn (t.ex. servertest). Innan du raderar kan du valfritt ladda ner mappen som en säkerhetskopia genom att markera den och använda nedladdningsalternativet — även en skadad sparning kan delvis gå att återställa senare.
5. Radera mappen som matchar ditt servernamn inuti Multiplayer/. Radera inte själva Multiplayer-mappen.
6. Navigera även till /.cache/db/ och radera filen <YourServerName>.db. Denna databas innehåller spelarstatistik och kan referera till den gamla världen — att återskapa den undviker felmatchningar.
7. Starta din server. Den genererar en ny värld med inställningarna i din .ini-fil.

Snabb diagnosreferens

Kraschar fortfarande efter alla steg?