Los servidores de Project Zomboid pueden caerse o no iniciar por varias razones bien conocidas. Esta guía cubre las causas más comunes vistas en los tickets de soporte de Legion Hosting — desde un error de memoria en Build 42 que requiere RAM adicional al iniciar, hasta un desbordamiento de copias de seguridad que llena /tmp, hasta archivos de configuración corruptos. Trabaja a través de las secciones a continuación en orden.

Antes de Comenzar — Localiza Tus Registros de Errores

Casi cada caída de Project Zomboid deja evidencia en uno de dos lugares. Revisa ambos antes de intentar cualquier solución, para saber qué sección de esta guía aplica en tu caso.

Salida de la Consola de GPanel

1. Inicia sesión en GPanel.
2. Selecciona tu servidor de Project Zomboid de la lista de servidores.
3. Haz clic en la pestaña Console.
4. Desplázate hasta el final de la salida. Busca líneas marcadas con ERROR, FATAL, OutOfMemoryError o Exception. Las últimas 20-30 líneas antes de que el servidor se detuviera suelen ser las más relevantes.
5. Si la consola está vacía, el proceso del servidor terminó antes de poder escribir algo — esto en sí mismo es una pista (consulta la sección de memoria de B42 a continuación).

El Archivo debug.log del Servidor

Project Zomboid escribe un registro detallado en debug.log en el directorio de datos del servidor. Este archivo a menudo contiene una traza de pila Java completa que apunta directamente a la causa de la caída.

1. En GPanel, ve a la pestaña File Manager.
2. Navega a /.cache/Logs/. Verás archivos con nombres como debug.log, DebugLog-server.txt o archivos de registro con fecha.
3. Abre el archivo de registro más reciente. Usa Ctrl+End o desplázate hasta el final y lee hacia arriba desde allí.
4. Busca las palabras clave OutOfMemoryError, IOException, NullPointerException o SandboxVars. Copia las líneas relevantes — las necesitarás si abres un ticket de soporte.

Solución 1 — Alto Uso de Memoria en el Inicio de Build 42 (Error Conocido del Juego)

Si tu servidor se cierra inmediatamente al iniciar sin ningún error en la consola, o la consola muestra OutOfMemoryError o un error de espacio de heap de Java, el servidor se está quedando sin memoria antes de que el mundo termine de cargar.

Síntomas

• El servidor inicia, la consola se desplaza durante unos segundos, luego se detiene sin ningún error visible para el jugador.
• La consola muestra java.lang.OutOfMemoryError: Java heap space o GC overhead limit exceeded.
• El servidor funciona en algunos reinicios pero no en otros (la disponibilidad de memoria varía).
• El servidor funcionaba bien en B41 pero se cae constantemente después de actualizar a B42.

Pasos

1. En GPanel, haz clic en tu servidor y ve a la pestaña Console. Observa la asignación de RAM actual de tu servidor que se muestra en la barra de recursos o el panel de información del servidor.
2. Si tu plan incluye menos de 10 GB de RAM, el servidor puede caerse durante el inicio porque B42 requiere aproximadamente 9 GB para inicializarse. Necesitarás actualizar tu plan o esperar a que Indie Stone publique una corrección.
3. Si tu plan ya tiene 10 GB o más y el servidor aún se cae al iniciar, ve a la pestaña Startup en GPanel.
4. Busca un campo etiquetado como Java Memory, Max RAM o Xmx. Confirma que esté configurado a no más del 80-85% de tu RAM total disponible. Por ejemplo, en un plan de 12 GB, configúralo a 10240 (10 GB en megabytes). No lo configures igual o por encima de tu RAM total — el sistema operativo y otros procesos también necesitan memoria.
5. Haz clic en Save en la pestaña Startup, luego reinicia tu servidor.
6. Observa la consola durante el inicio. Si el servidor llega a la línea SERVER STARTED o LuaManager: Loading lua files... se completa sin caerse, la asignación de memoria ahora es suficiente.

Solución 2 — BackupsOnStart Desbordando /tmp (Caída al Iniciar)

Project Zomboid puede configurarse para crear una copia de seguridad completa del mundo cada vez que el servidor inicia. Cuando esta copia de seguridad se escribe en /tmp — que tiene un tamaño limitado en la mayoría de los hosts Linux — el servidor se cae a mitad del inicio con un error de escritura en disco una vez que /tmp se llena.

Síntomas

• El servidor se cae de manera confiable en cada reinicio, pero funcionaba anteriormente.
• La consola o debug.log contiene errores como IOException: No space left on device o menciona escritura en /tmp/.
• Las caídas tienden a empeorar con el tiempo a medida que el guardado del mundo crece.
• El servidor a veces inicia si lo intentas poco después de un reinicio limpio del nodo host (antes de que /tmp se llene de nuevo).

Pasos — Desactivar BackupsOnStart

1. En GPanel, ve a la pestaña File Manager.
2. Navega a /.cache/server/. Busca tu archivo de configuración del servidor — normalmente se llama servertest.ini o el nombre de tu servidor seguido de .ini (por ejemplo, MyServer.ini).
3. Abre el archivo .ini para editar.
4. Usa la función de búsqueda de tu navegador (Ctrl+F) para buscar BackupsOnStart.
5. Cambia el valor de true a false:

   BackupsOnStart=false

6. Mientras estés en el archivo, también revisa la configuración BackupsOnVersionChange y establécela en false si el espacio en disco es una preocupación:

   BackupsOnVersionChange=false

7. Guarda el archivo y reinicia tu servidor. Monitorea la consola para confirmar que el servidor llegue a la línea SERVER STARTED.

Solución 3 — SandboxVars.lua o Configuración del Servidor Corrompida

Project Zomboid almacena la configuración del mundo en un archivo Lua llamado SandboxVars.lua. Si este archivo se edita manualmente y se guarda con un error de sintaxis, o si una transferencia de archivos fue interrumpida, el servidor se caerá inmediatamente al iniciar cuando intente analizar el archivo.

Síntomas

• La consola muestra ERROR: SandboxVars, LuaManager error o un error de análisis de Lua con un número de línea.
• La caída comenzó a ocurrir justo después de que editaste la configuración en el archivo .ini o SandboxVars.lua directamente.
• El servidor puede mostrar Bad argument #1 to o errores de ejecución de Lua similares.

Pasos — Verificar y Reparar SandboxVars.lua

1. En GPanel, ve a File Manager y navega a /.cache/saves/multiplayer/<YourServerName>/.
2. Abre SandboxVars.lua para editar.
3. Verifica que el archivo comience con VERSION = 1, (o similar) dentro de un bloque SandboxVars = {, y termine con una llave de cierre }. Cualquier coma faltante, llave sin cerrar o carácter extraño causará un fallo de análisis.
4. Si no puedes identificar el error, la solución más segura es eliminar SandboxVars.lua por completo. El servidor lo regenerará con valores predeterminados en el próximo inicio. Nota: esto restablece tus configuraciones de sandbox (botín, cantidad de zombis, etc.) a los valores predeterminados — los datos de tu mapa y datos de jugadores no se ven afectados.
5. También revisa el archivo .ini en /.cache/server/ por problemas similares si lo editaste manualmente recientemente. Asegúrate de que cada línea siga el formato Key=Value sin líneas en blanco dentro de un valor.
6. Guarda los cambios y reinicia el servidor.

Solución 4 — Contraseña de Administrador Vacía Causando Caída

Project Zomboid requiere una contraseña de administrador no vacía para iniciar un servidor multijugador. Si el campo de contraseña está en blanco, el proceso del servidor se cierra inmediatamente después de intentar inicializar la cuenta de administrador.

Síntomas

• Servidor nuevo o recientemente restablecido falla en cada intento de inicio.
• La salida de la consola es muy corta — el servidor imprime unas pocas líneas de inicialización y luego se detiene.
• debug.log puede contener una referencia a la cuenta de administrador o validación de contraseña.

Pasos

1. En GPanel, haz clic en tu servidor y ve a la pestaña Startup.
2. Busca un campo etiquetado como Admin Password o RCON Password. Confirma que contenga un valor — no debe estar en blanco.
3. Si el campo está vacío, ingresa una contraseña. Usa al menos 8 caracteres. Evita caracteres especiales como !, #, $ o @ en la contraseña de administrador, ya que algunas versiones de PZ no los analizan correctamente en los argumentos de inicio.
4. Haz clic en Save y reinicia el servidor.
5. Como verificación secundaria, abre el archivo .ini en /.cache/server/ y confirma que la línea AdminPassword= tenga un valor después del signo de igual.

Solución 5 — Reiniciar el Mundo (Último Recurso para Caídas Persistentes)

Si un guardado del mundo se corrompe — por ejemplo, después de una caída abrupta del servidor, una actualización fallida o errores del sistema de archivos — los datos del guardado pueden ser irrecuperables. En este caso, eliminar el mundo y comenzar de nuevo es la única opción.

Pasos

1. Detén tu servidor en GPanel antes de hacer cualquier cambio en los archivos de guardado. Editar archivos en un servidor en ejecución puede causar más corrupción.
2. En GPanel, ve a la pestaña File Manager.
3. Navega a /.cache/saves/multiplayer/.
4. Verás una o más carpetas con el nombre de tu servidor (por ejemplo, servertest). Antes de eliminar, opcionalmente descarga la carpeta como copia de seguridad seleccionándola y usando la opción de descarga — incluso un guardado corrupto puede ser parcialmente recuperable más adelante.
5. Elimina la carpeta que coincida con el nombre de tu servidor dentro de Multiplayer/. No elimines la carpeta Multiplayer en sí.
6. También navega a /.cache/db/ y elimina el archivo <YourServerName>.db. Esta base de datos contiene estadísticas de jugadores y puede hacer referencia al mundo anterior — regenerarla evita discrepancias.
7. Inicia tu servidor. Generará un mundo nuevo usando la configuración de tu archivo .ini.

Referencia Rápida de Diagnóstico

¿Sigue Cayéndose Después de Todos los Pasos?