Serverele Project Zomboid se pot bloca sau pot eșua la pornire din mai multe motive binecunoscute. Acest ghid acoperă cele mai frecvente cauze întâlnite în tichetele de asistență Legion Hosting — de la un bug de memorie din Build 42 care necesită RAM suplimentar la pornire, la o supraîncărcare a copiilor de rezervă care umple /tmp, până la fișiere de configurare corupte. Parcurgeți secțiunile de mai jos în ordine.

Înainte de a începe — Localizați jurnalele de blocare

Aproape fiecare blocare Project Zomboid lasă dovezi într-unul din două locuri. Verificați-le pe ambele înainte de a încerca orice remediere, astfel încât să știți ce secțiune a acestui ghid se aplică în cazul dvs.

Rezultatul consolei GPanel

1. Autentificați-vă în GPanel.
2. Selectați serverul dvs. Project Zomboid din lista de servere.
3. Faceți clic pe fila Console.
4. Derulați până la sfârșitul rezultatului. Căutați liniile marcate cu ERROR, FATAL, OutOfMemoryError sau Exception. Ultimele 20–30 de linii înainte de oprirea serverului sunt de obicei cele mai relevante.
5. Dacă consola este goală, procesul serverului s-a terminat înainte de a putea scrie ceva — acesta este în sine un indiciu (consultați secțiunea despre memoria B42 de mai jos).

Fișierul debug.log al serverului

Project Zomboid scrie un jurnal detaliat în debug.log în directorul de date al serverului. Acest fișier conține adesea o urmă completă a stivei Java care indică direct cauza blocării.

1. În GPanel, accesați fila File Manager.
2. Navigați la /.cache/Logs/. Veți vedea fișiere denumite precum debug.log, DebugLog-server.txt sau fișiere de jurnal datate.
3. Deschideți cel mai recent fișier de jurnal. Folosiți Ctrl+End sau derulați până la final și citiți de acolo în sus.
4. Căutați cuvintele cheie OutOfMemoryError, IOException, NullPointerException sau SandboxVars. Copiați liniile relevante — veți avea nevoie de ele dacă deschideți un tichet de asistență.

Remedierea 1 — Utilizare ridicată a memoriei la pornire în Build 42 (Bug cunoscut al jocului)

Dacă serverul dvs. se închide imediat la pornire fără nicio eroare în consolă sau dacă consola afișează OutOfMemoryError sau o eroare de spațiu heap Java, serverul rămâne fără memorie înainte ca lumea să termine de încărcat.

Simptome

• Serverul pornește, consola derulează câteva secunde, apoi se oprește fără nicio eroare vizibilă pentru jucător.
• Consola afișează java.lang.OutOfMemoryError: Java heap space sau GC overhead limit exceeded.
• Serverul funcționează la unele reporniri, dar nu la altele (disponibilitatea memoriei variază).
• Serverul funcționa bine pe B41, dar se blochează constant după actualizarea la B42.

Pași

1. În GPanel, faceți clic pe serverul dvs. și accesați fila Console. Notați alocarea curentă de RAM a serverului dvs. afișată în bara de resurse sau în panoul de informații al serverului.
2. Dacă planul dvs. include mai puțin de 10 GB RAM, serverul se poate bloca în timpul pornirii deoarece B42 necesită aproximativ 9 GB pentru a se inițializa. Va trebui să vă actualizați planul sau să așteptați ca Indie Stone să lanseze o remediere.
3. Dacă planul dvs. are deja 10 GB sau mai mult și serverul tot se blochează la pornire, accesați fila Startup din GPanel.
4. Căutați un câmp etichetat Java Memory, Max RAM sau Xmx. Confirmați că este setat la cel mult 80–85% din totalul RAM disponibil. De exemplu, pe un plan de 12 GB, setați-l la 10240 (10 GB în megabytes). Nu îl setați egal cu sau peste totalul de RAM — sistemul de operare și alte procese au nevoie și ele de memorie.
5. Faceți clic pe Save în fila Startup, apoi reporniți serverul.
6. Urmăriți consola în timpul pornirii. Dacă serverul ajunge la linia SERVER STARTED sau LuaManager: Loading lua files... se finalizează fără blocare, alocarea de memorie este acum suficientă.

Remedierea 2 — BackupsOnStart supraîncarcă /tmp (Blocare la pornire)

Project Zomboid poate fi configurat să creeze o copie de rezervă completă a lumii de fiecare dată când serverul pornește. Când această copie de rezervă este scrisă în /tmp — care este limitat ca dimensiune pe majoritatea hosturilor Linux — serverul se blochează în mijlocul pornirii cu o eroare de scriere pe disc odată ce /tmp se umple.

Simptome

• Serverul se blochează în mod sigur la fiecare repornire, dar funcționa anterior.
• Consola sau debug.log conține erori precum IOException: No space left on device sau menționează scrierea în /tmp/.
• Blocările tind să se înrăutățească în timp, pe măsură ce salvarea lumii crește.
• Serverul pornește uneori dacă încercați la scurt timp după o repornire curată a nodului host (înainte ca /tmp să se umple din nou).

Pași — Dezactivați BackupsOnStart

1. În GPanel, accesați fila File Manager.
2. Navigați la /.cache/server/. Căutați fișierul de configurare al serverului — este de obicei denumit servertest.ini sau oricare ar fi numele serverului dvs. urmat de .ini (de ex. MyServer.ini).
3. Deschideți fișierul .ini pentru editare.
4. Folosiți funcția de căutare a browserului (Ctrl+F) pentru a căuta BackupsOnStart.
5. Schimbați valoarea din true în false:

   BackupsOnStart=false

6. Cât timp vă aflați în fișier, verificați și setarea BackupsOnVersionChange și setați-o la false dacă spațiul pe disc este o preocupare:

   BackupsOnVersionChange=false

7. Salvați fișierul și reporniți serverul. Monitorizați consola pentru a confirma că serverul ajunge la linia SERVER STARTED.

Remedierea 3 — SandboxVars.lua sau configurația serverului corupte

Project Zomboid stochează setările lumii într-un fișier Lua numit SandboxVars.lua. Dacă acest fișier este editat manual și salvat cu o eroare de sintaxă, sau dacă un transfer de fișiere a fost întrerupt, serverul se va bloca imediat la pornire când încearcă să analizeze fișierul.

Simptome

• Consola afișează ERROR: SandboxVars, LuaManager error sau o eroare de analiză Lua cu un număr de linie.
• Blocarea a început să apară imediat după ce ați editat setările în fișierul .ini sau direct în SandboxVars.lua.
• Serverul poate afișa Bad argument #1 to sau erori similare de execuție Lua.

Pași — Verificați și reparați SandboxVars.lua

1. În GPanel, accesați File Manager și navigați la /.cache/saves/multiplayer/<YourServerName>/.
2. Deschideți SandboxVars.lua pentru editare.
3. Verificați că fișierul începe cu VERSION = 1, (sau similar) în interiorul unui bloc SandboxVars = { și se termină cu un } de închidere. Orice virgulă lipsă, acoladă neînchisă sau caracter rătăcit va cauza un eșec de analiză.
4. Dacă nu puteți identifica eroarea, cea mai sigură remediere este să ștergeți complet SandboxVars.lua. Serverul îl va regenera cu valori implicite la următoarea pornire. Notă: acest lucru vă resetează setările sandbox (loot, numărul de zombi etc.) la valorile implicite — datele hărții și datele jucătorilor nu sunt afectate.
5. Verificați și fișierul .ini din /.cache/server/ pentru probleme similare dacă l-ați editat recent manual. Asigurați-vă că fiecare linie respectă formatul Key=Value fără linii goale în interiorul unei valori.
6. Salvați modificările și reporniți serverul.

Remedierea 4 — Parolă de administrator goală care cauzează blocarea

Project Zomboid necesită o parolă de administrator care nu este goală pentru a porni un server multiplayer. Dacă câmpul parolei este gol, procesul serverului se închide imediat după ce încearcă să inițializeze contul de administrator.

Simptome

• Un server nou-nouț sau recent resetat eșuează la fiecare încercare de pornire.
• Rezultatul consolei este foarte scurt — serverul afișează câteva linii de inițializare și apoi se oprește.
• debug.log poate conține o referință la contul de administrator sau la validarea parolei.

Pași

1. În GPanel, faceți clic pe serverul dvs. și accesați fila Startup.
2. Căutați un câmp etichetat Admin Password sau RCON Password. Confirmați că conține o valoare — nu trebuie să fie gol.
3. Dacă câmpul este gol, introduceți o parolă. Folosiți cel puțin 8 caractere. Evitați caractere speciale precum !, #, $ sau @ în parola de administrator, deoarece unele versiuni PZ nu reușesc să le analizeze corect în argumentele de pornire.
4. Faceți clic pe Save și reporniți serverul.
5. Ca verificare secundară, deschideți fișierul .ini din /.cache/server/ și confirmați că linia AdminPassword= are o valoare după semnul egal.

Remedierea 5 — Resetați lumea (Ultima soluție pentru blocări persistente)

Dacă o salvare a lumii devine coruptă — de exemplu după o blocare gravă a serverului, o actualizare eșuată sau erori ale sistemului de fișiere — datele de salvare în sine pot fi nerecuperabile. În acest caz, ștergerea lumii și începerea de la zero este singura opțiune.

Pași

1. Opriți serverul în GPanel înainte de a face orice modificare a fișierelor de salvare. Editarea fișierelor pe un server în funcțiune poate cauza coruperi suplimentare.
2. În GPanel, accesați fila File Manager.
3. Navigați la /.cache/saves/multiplayer/.
4. Veți vedea unul sau mai multe foldere cu numele serverului dvs. (de ex. servertest). Înainte de a șterge, descărcați opțional folderul ca o copie de rezervă selectându-l și folosind opțiunea de descărcare — chiar și o salvare coruptă poate fi parțial recuperabilă mai târziu.
5. Ștergeți folderul care corespunde numelui serverului dvs. din interiorul Multiplayer/. Nu ștergeți folderul Multiplayer în sine.
6. Navigați și la /.cache/db/ și ștergeți fișierul <YourServerName>.db. Această bază de date conține statisticile jucătorilor și poate face referire la lumea veche — regenerarea ei evită nepotrivirile.
7. Porniți serverul. Acesta va genera o lume nouă folosind setările din fișierul dvs. .ini.

Referință rapidă de diagnosticare

Tot se blochează după toți pașii?