I server Project Zomboid possono crashare o non avviarsi per diverse ragioni ben note. Questa guida copre le cause più comuni riscontrate nei ticket di supporto di Legion Hosting — da un bug di memoria della Build 42 che richiede RAM aggiuntiva all'avvio, a un overflow dei backup che riempie /tmp, fino a file di configurazione corrotti. Segui le sezioni seguenti in ordine.

Prima di Iniziare — Individua i Log di Crash

Quasi ogni crash di Project Zomboid lascia tracce in uno di due posti. Controlla entrambi prima di tentare qualsiasi soluzione, così saprai quale sezione di questa guida si applica al tuo caso.

Output della Console GPanel

1. Accedi a GPanel.
2. Seleziona il tuo server Project Zomboid dalla lista dei server.
3. Clicca sulla scheda Console.
4. Scorri fino alla fine dell'output. Cerca le righe contrassegnate con ERROR, FATAL, OutOfMemoryError, o Exception. Le ultime 20–30 righe prima dell'arresto del server sono solitamente le più rilevanti.
5. Se la console è vuota, il processo del server si è terminato prima di poter scrivere qualcosa — questo è di per sé un indizio (vedi la sezione sulla memoria B42 qui sotto).

Il File debug.log del Server

Project Zomboid scrive un log dettagliato nel file debug.log nella directory dati del server. Questo file spesso contiene una traccia completa dello stack Java che punta direttamente alla causa del crash.

1. In GPanel, vai alla scheda File Manager.
2. Naviga in /.cache/Logs/. Vedrai file denominati come debug.log, DebugLog-server.txt, o file di log con data.
3. Apri il file di log più recente. Usa Ctrl+End o scorri fino in fondo e leggi verso l'alto da lì.
4. Cerca le parole chiave OutOfMemoryError, IOException, NullPointerException, o SandboxVars. Copia le righe rilevanti — ti serviranno se apri un ticket di supporto.

Soluzione 1 — Utilizzo Elevato di Memoria all'Avvio della Build 42 (Bug Noto del Gioco)

Se il tuo server si chiude immediatamente all'avvio senza errori nella console, o la console mostra OutOfMemoryError o un errore di spazio heap Java, il server sta esaurendo la memoria prima che il mondo finisca di caricarsi.

Sintomi

• Il server si avvia, la console scorre per qualche secondo, poi si ferma senza alcun errore visibile ai giocatori.
• La console mostra java.lang.OutOfMemoryError: Java heap space o GC overhead limit exceeded.
• Il server funziona ad alcuni riavvii ma non ad altri (la disponibilità di memoria varia).
• Il server funzionava bene sulla B41 ma crasha costantemente dopo l'aggiornamento alla B42.

Passaggi

1. In GPanel, clicca sul tuo server e vai alla scheda Console. Prendi nota dell'allocazione RAM attuale del tuo server mostrata nella barra delle risorse o nel pannello informazioni del server.
2. Se il tuo piano include meno di 10 GB di RAM, il server potrebbe crashare durante l'avvio perché la B42 richiede circa 9 GB per l'inizializzazione. Dovrai aggiornare il tuo piano o attendere che Indie Stone rilasci una correzione.
3. Se il tuo piano ha già 10 GB o più e il server crasha comunque all'avvio, vai alla scheda Startup in GPanel.
4. Cerca un campo etichettato Java Memory, Max RAM, o Xmx. Conferma che sia impostato a non più dell'80–85% della tua RAM totale disponibile. Ad esempio, con un piano da 12 GB, impostalo a 10240 (10 GB in megabyte). Non impostarlo uguale o superiore alla tua RAM totale — il sistema operativo e altri processi necessitano anch'essi di memoria.
5. Clicca Save nella scheda Startup, poi riavvia il tuo server.
6. Osserva la console durante l'avvio. Se il server raggiunge la riga SERVER STARTED o LuaManager: Loading lua files... senza crashare, l'allocazione di memoria è ora sufficiente.

Soluzione 2 — BackupsOnStart che Riempie /tmp (Crash all'Avvio)

Project Zomboid può essere configurato per creare un backup completo del mondo ogni volta che il server si avvia. Quando questo backup viene scritto in /tmp — che ha dimensioni limitate sulla maggior parte degli host Linux — il server crasha durante l'avvio con un errore di scrittura su disco una volta che /tmp si riempie.

Sintomi

• Il server crasha in modo affidabile ad ogni riavvio, ma funzionava in precedenza.
• La console o debug.log contiene errori come IOException: No space left on device o menziona la scrittura in /tmp/.
• I crash tendono a peggiorare nel tempo man mano che il salvataggio del mondo diventa più grande.
• Il server a volte si avvia se provi subito dopo un riavvio pulito del nodo host (prima che /tmp si riempia di nuovo).

Passaggi — Disabilitare BackupsOnStart

1. In GPanel, vai alla scheda File Manager.
2. Naviga in /.cache/server/. Cerca il file di configurazione del tuo server — è tipicamente denominato servertest.ini o qualunque sia il nome del tuo server seguito da .ini (es. MyServer.ini).
3. Apri il file .ini per la modifica.
4. Usa la funzione di ricerca del tuo browser (Ctrl+F) per cercare BackupsOnStart.
5. Cambia il valore da true a false:

   BackupsOnStart=false

6. Mentre sei nel file, controlla anche l'impostazione BackupsOnVersionChange e impostala su false se lo spazio su disco è una preoccupazione:

   BackupsOnVersionChange=false

7. Salva il file e riavvia il tuo server. Monitora la console per confermare che il server raggiunga la riga SERVER STARTED.

Soluzione 3 — SandboxVars.lua o Configurazione del Server Corrotta

Project Zomboid memorizza le impostazioni del mondo in un file Lua chiamato SandboxVars.lua. Se questo file viene modificato manualmente e salvato con un errore di sintassi, o se un trasferimento file è stato interrotto, il server crasherà immediatamente all'avvio quando tenta di analizzare il file.

Sintomi

• La console mostra ERROR: SandboxVars, LuaManager error, o un errore di parsing Lua con un numero di riga.
• Il crash ha iniziato a verificarsi subito dopo aver modificato le impostazioni nel file .ini o direttamente in SandboxVars.lua.
• Il server potrebbe mostrare Bad argument #1 to o errori runtime Lua simili.

Passaggi — Controllare e Riparare SandboxVars.lua

1. In GPanel, vai al File Manager e naviga in /.cache/saves/multiplayer/<YourServerName>/.
2. Apri SandboxVars.lua per la modifica.
3. Verifica che il file inizi con VERSION = 1, (o simile) all'interno di un blocco SandboxVars = {, e termini con una parentesi graffa di chiusura }. Qualsiasi virgola mancante, parentesi non chiusa o carattere estraneo causerà un errore di parsing.
4. Se non riesci a identificare l'errore, la soluzione più sicura è eliminare completamente SandboxVars.lua. Il server lo rigenererà con valori predefiniti al prossimo avvio. Nota: questo reimposta le impostazioni sandbox (bottino, numero di zombie, ecc.) ai valori predefiniti — i dati della mappa e dei giocatori non vengono influenzati.
5. Controlla anche il file .ini in /.cache/server/ per problemi simili se lo hai modificato manualmente di recente. Assicurati che ogni riga segua il formato Key=Value senza righe vuote all'interno di un valore.
6. Salva le modifiche e riavvia il server.

Soluzione 4 — Password Admin Vuota che Causa il Crash

Project Zomboid richiede una password admin non vuota per avviare un server multiplayer. Se il campo password è vuoto, il processo del server si chiude immediatamente dopo aver tentato di inizializzare l'account admin.

Sintomi

• Server nuovo o recentemente reimpostato che fallisce ad ogni tentativo di avvio.
• L'output della console è molto breve — il server stampa alcune righe di inizializzazione e poi si ferma.
• debug.log potrebbe contenere un riferimento all'account admin o alla validazione della password.

Passaggi

1. In GPanel, clicca sul tuo server e vai alla scheda Startup.
2. Cerca un campo etichettato Admin Password o RCON Password. Conferma che contenga un valore — non deve essere vuoto.
3. Se il campo è vuoto, inserisci una password. Usa almeno 8 caratteri. Evita caratteri speciali come !, #, $, o @ nella password admin, poiché alcune versioni di PZ non riescono ad analizzarli correttamente negli argomenti di avvio.
4. Clicca Save e riavvia il server.
5. Come controllo secondario, apri il file .ini in /.cache/server/ e conferma che la riga AdminPassword= abbia un valore dopo il segno di uguale.

Soluzione 5 — Reset del Mondo (Ultima Risorsa per Crash Persistenti)

Se un salvataggio del mondo diventa corrotto — ad esempio dopo un crash improvviso del server, un aggiornamento fallito o errori del file system — i dati del salvataggio potrebbero essere irrecuperabili. In questo caso, eliminare il mondo e ricominciare da zero è l'unica opzione.

Passaggi

1. Ferma il tuo server in GPanel prima di apportare qualsiasi modifica ai file di salvataggio. Modificare i file su un server in esecuzione può causare ulteriore corruzione.
2. In GPanel, vai alla scheda File Manager.
3. Naviga in /.cache/saves/multiplayer/.
4. Vedrai una o più cartelle con il nome del tuo server (es. servertest). Prima di eliminare, scarica opzionalmente la cartella come backup selezionandola e usando l'opzione di download — anche un salvataggio corrotto potrebbe essere parzialmente recuperabile in seguito.
5. Elimina la cartella corrispondente al nome del tuo server all'interno di Multiplayer/. Non eliminare la cartella Multiplayer stessa.
6. Naviga anche in /.cache/db/ ed elimina il file <YourServerName>.db. Questo database contiene le statistiche dei giocatori e potrebbe fare riferimento al vecchio mondo — rigenerarlo evita discrepanze.
7. Avvia il tuo server. Verrà generato un mondo nuovo utilizzando le impostazioni nel tuo file .ini.

Riferimento Diagnostico Rapido

Il Server Crasha Ancora Dopo Tutti i Passaggi?