Els servidors de Project Zomboid poden fallar o no iniciar-se per diverses raons ben conegudes. Aquesta guia cobreix les causes més comunes vistes als tiquets de suport de Legion Hosting — des d'un error de memòria del Build 42 que requereix RAM addicional a l'inici, fins a un desbordament de còpies de seguretat que omple /tmp, passant per fitxers de configuració corruptes. Seguiu les seccions següents en ordre.

Abans de començar — Localitzeu els registres d'errors

Gairebé tots els errors de Project Zomboid deixen evidència en un de dos llocs. Comproveu-los tots dos abans d'intentar qualsevol solució, per saber quina secció d'aquesta guia s'aplica al vostre cas.

Sortida de la consola de GPanel

1. Inicieu sessió a GPanel.
2. Seleccioneu el vostre servidor de Project Zomboid de la llista de servidors.
3. Feu clic a la pestanya Console.
4. Desplaceu-vos fins al final de la sortida. Busqueu línies marcades amb ERROR, FATAL, OutOfMemoryError o Exception. Les últimes 20–30 línies abans que el servidor s'aturés solen ser les més rellevants.
5. Si la consola està buida, el procés del servidor va finalitzar abans de poder escriure res — això en si mateix és una pista (consulteu la secció de memòria del B42 a continuació).

El fitxer debug.log del servidor

Project Zomboid escriu un registre detallat a debug.log al directori de dades del servidor. Aquest fitxer sovint conté una traça completa de Java que apunta directament a la causa de l'error.

1. A GPanel, aneu a la pestanya File Manager.
2. Navegueu a /.cache/Logs/. Veureu fitxers amb noms com debug.log, DebugLog-server.txt o fitxers de registre amb data.
3. Obriu el fitxer de registre més recent. Utilitzeu Ctrl+End o desplaceu-vos fins al final i llegiu cap amunt des d'allà.
4. Busqueu les paraules clau OutOfMemoryError, IOException, NullPointerException o SandboxVars. Copieu les línies rellevants — les necessitareu si obriu un tiquet de suport.

Solució 1 — Ús elevat de memòria del Build 42 a l'inici (error conegut del joc)

Si el vostre servidor surt immediatament a l'inici sense cap error a la consola, o la consola mostra OutOfMemoryError o un error d'espai de heap de Java, el servidor s'està quedant sense memòria abans que el món acabi de carregar-se.

Símptomes

• El servidor s'inicia, la consola es desplaça durant uns segons i després s'atura sense cap error visible per al jugador.
• La consola mostra java.lang.OutOfMemoryError: Java heap space o GC overhead limit exceeded.
• El servidor funciona en alguns reinicis però no en altres (la disponibilitat de memòria varia).
• El servidor funcionava bé al B41 però falla consistentment després d'actualitzar al B42.

Passos

1. A GPanel, feu clic al vostre servidor i aneu a la pestanya Console. Anoteu l'assignació de RAM actual del vostre servidor mostrada a la barra de recursos o al panell d'informació del servidor.
2. Si el vostre pla inclou menys de 10 GB de RAM, el servidor pot fallar durant l'inici perquè el B42 requereix aproximadament 9 GB per inicialitzar-se. Haureu d'actualitzar el vostre pla o esperar que Indie Stone publiqui una correcció.
3. Si el vostre pla ja té 10 GB o més i el servidor encara falla a l'inici, aneu a la pestanya Startup a GPanel.
4. Busqueu un camp etiquetat com Java Memory, Max RAM o Xmx. Confirmeu que està establert a no més del 80–85% de la vostra RAM total disponible. Per exemple, en un pla de 12 GB, establiu-lo a 10240 (10 GB en megabytes). No l'establiu igual o per sobre de la vostra RAM total — el sistema operatiu i altres processos també necessiten memòria.
5. Feu clic a Save a la pestanya Startup i després reinicieu el vostre servidor.
6. Observeu la consola durant l'inici. Si el servidor arriba a la línia SERVER STARTED o LuaManager: Loading lua files... es completa sense fallar, l'assignació de memòria és ara suficient.

Solució 2 — BackupsOnStart desbordant /tmp (error a l'inici)

Project Zomboid es pot configurar per crear una còpia de seguretat completa del món cada vegada que el servidor s'inicia. Quan aquesta còpia de seguretat s'escriu a /tmp — que té una mida limitada a la majoria d'amfitrions Linux — el servidor falla a meitat de l'inici amb un error d'escriptura al disc quan /tmp s'omple.

Símptomes

• El servidor falla de manera fiable a cada reinici, però funcionava anteriorment.
• La consola o debug.log conté errors com IOException: No space left on device o menciona escriptura a /tmp/.
• Els errors tendeixen a empitjorar amb el temps a mesura que la partida guardada del món creix.
• El servidor de vegades s'inicia si ho proveu poc després d'un reinici net del node amfitrió (abans que /tmp s'ompli de nou).

Passos — Desactivar BackupsOnStart

1. A GPanel, aneu a la pestanya File Manager.
2. Navegueu a /.cache/server/. Busqueu el fitxer de configuració del vostre servidor — normalment es diu servertest.ini o el nom del vostre servidor seguit de .ini (p. ex., MyServer.ini).
3. Obriu el fitxer .ini per editar-lo.
4. Utilitzeu la funció de cerca del vostre navegador (Ctrl+F) per buscar BackupsOnStart.
5. Canvieu el valor de true a false:

   BackupsOnStart=false

6. Mentre sou al fitxer, comproveu també la configuració de BackupsOnVersionChange i establiu-la a false si l'espai en disc és una preocupació:

   BackupsOnVersionChange=false

7. Deseu el fitxer i reinicieu el vostre servidor. Superviseu la consola per confirmar que el servidor arriba a la línia SERVER STARTED.

Solució 3 — SandboxVars.lua o configuració del servidor corruptes

Project Zomboid emmagatzema la configuració del món en un fitxer Lua anomenat SandboxVars.lua. Si aquest fitxer s'edita manualment i es desa amb un error de sintaxi, o si una transferència de fitxers es va interrompre, el servidor fallarà immediatament a l'inici quan intenti analitzar el fitxer.

Símptomes

• La consola mostra ERROR: SandboxVars, LuaManager error o un error d'anàlisi de Lua amb un número de línia.
• L'error va començar a produir-se just després d'editar la configuració al fitxer .ini o SandboxVars.lua directament.
• El servidor pot mostrar Bad argument #1 to o errors similars d'execució de Lua.

Passos — Comprovar i reparar SandboxVars.lua

1. A GPanel, aneu a File Manager i navegueu a /.cache/saves/multiplayer/<YourServerName>/.
2. Obriu SandboxVars.lua per editar-lo.
3. Comproveu que el fitxer comença amb VERSION = 1, (o similar) dins d'un bloc SandboxVars = {, i acaba amb una clau de tancament }. Qualsevol coma que falti, clau sense tancar o caràcter estrany causarà un error d'anàlisi.
4. Si no podeu identificar l'error, la solució més segura és eliminar SandboxVars.lua completament. El servidor el regenerarà amb valors per defecte al proper inici. Nota: això restableix la configuració del sandbox (botí, nombre de zombis, etc.) als valors per defecte — les dades del mapa i dels jugadors no es veuen afectades.
5. Comproveu també el fitxer .ini a /.cache/server/ per problemes similars si l'heu editat recentment a mà. Assegureu-vos que cada línia segueix el format Key=Value sense línies en blanc dins d'un valor.
6. Deseu els canvis i reinicieu el servidor.

Solució 4 — Contrasenya d'administrador buida causant error

Project Zomboid requereix una contrasenya d'administrador no buida per iniciar un servidor multijugador. Si el camp de contrasenya està en blanc, el procés del servidor surt immediatament després d'intentar inicialitzar el compte d'administrador.

Símptomes

• Servidor nou o servidor recentment restablert falla a cada intent d'inici.
• La sortida de la consola és molt curta — el servidor imprimeix unes poques línies d'inicialització i després s'atura.
• debug.log pot contenir una referència al compte d'administrador o a la validació de la contrasenya.

Passos

1. A GPanel, feu clic al vostre servidor i aneu a la pestanya Startup.
2. Busqueu un camp etiquetat com Admin Password o RCON Password. Confirmeu que conté un valor — no ha d'estar en blanc.
3. Si el camp està buit, introduïu una contrasenya. Utilitzeu com a mínim 8 caràcters. Eviteu caràcters especials com !, #, $ o @ a la contrasenya d'administrador, ja que algunes versions de PZ no els analitzen correctament als arguments d'inici.
4. Feu clic a Save i reinicieu el servidor.
5. Com a comprovació secundària, obriu el fitxer .ini a /.cache/server/ i confirmeu que la línia AdminPassword= té un valor després del signe d'igual.

Solució 5 — Restablir el món (últim recurs per a errors persistents)

Si una partida guardada del món es corromp — per exemple després d'un error greu del servidor, una actualització fallida o errors del sistema de fitxers — les dades guardades poden ser irrecuperables. En aquest cas, eliminar el món i començar de nou és l'única opció.

Passos

1. Atureu el vostre servidor a GPanel abans de fer qualsevol canvi als fitxers de la partida guardada. Editar fitxers en un servidor en funcionament pot causar més corrupció.
2. A GPanel, aneu a la pestanya File Manager.
3. Navegueu a /.cache/saves/multiplayer/.
4. Veureu una o més carpetes amb el nom del vostre servidor (p. ex., servertest). Abans d'eliminar-les, opcionalment descarregueu la carpeta com a còpia de seguretat seleccionant-la i utilitzant l'opció de descàrrega — fins i tot una partida guardada corrupta pot ser parcialment recuperable més endavant.
5. Elimineu la carpeta que coincideix amb el nom del vostre servidor dins de Multiplayer/. No elimineu la carpeta Multiplayer en si mateixa.
6. Navegueu també a /.cache/db/ i elimineu el fitxer <YourServerName>.db. Aquesta base de dades conté les estadístiques dels jugadors i pot fer referència al món antic — regenerar-la evita desajustos.
7. Inicieu el vostre servidor. Generarà un món nou utilitzant la configuració del vostre fitxer .ini.

Referència ràpida de diagnòstic

Encara falla després de tots els passos?