Un servidor de Minecraft calcula el mundo en ticks, 20 veces por segundo. Si un tick tarda demasiado o se agota la memoria RAM, el servidor escribe avisos en el log o, en el peor de los casos, se cierra. Cada sección de abajo explica uno de estos mensajes: cómo reconocerlo, qué gravedad tiene y qué puedes hacer. Primero van los mensajes tras los cuales el servidor se bloquea o se detiene, y después los avisos con los que sigue funcionando.

Encontrarás el mensaje completo en la Consola o en Archivos dentro de logs/latest.log, y los informes de fallos en la carpeta crash-reports/. Lee siempre también las líneas anteriores: ahí suele figurar lo que ha frenado el servidor. Antes de hacer cambios en archivos de configuración o del mundo, crea una copia en Copias de seguridad.

„A single server tick took … seconds“: el watchdog cierra el servidor

Así se ve el mensaje:

The server has not responded for <Seconds> seconds! Creating thread dump
A single server tick took 60.00 seconds (should be max 0.05)

Qué hay detrás: El watchdog vigila si el servidor sigue trabajando. Si un tick, es decir, un paso de trabajo de la simulación del juego, tarda demasiado, cierra el servidor congelado; la partida se interrumpe. Antes, Paper escribe mensajes intermedios con un thread dump, una instantánea del trabajo en curso: si el servidor se recupera a tiempo, sigue funcionando. Las causas más habituales son la presión de memoria o un plugin o mod pesado.

Así lo solucionas:

  1. En Archivos, lee en logs/latest.log las líneas anteriores al primer mensaje del watchdog. Revisa los errores anteriores; si aparece Stopping server, investiga también qué impide que se apague.
  2. En el thread dump, mira las primeras líneas bajo Server thread. El nombre de un plugin o mod indica con qué estuvo ocupado el servidor por última vez.
  3. Revisa la memoria RAM. OutOfMemoryError: Java heap space significa que la memoria de Java se ha agotado; en ese caso comprueba también qué la está ocupando.
  4. Detén el servidor antes de modificar archivos. Actualiza el plugin afectado en Plugins o el mod en Mods, o quítalo como prueba, reinicia y vuelve a comprobar.

Más detalles: Cómo solucionar correctamente „Can't keep up“ y el timeout del watchdog

„Java heap space“: la memoria del servidor se ha agotado

Así se ve el mensaje:

An unexpected error while handling a WorldEdit command … java.lang.OutOfMemoryError: Java heap space
[LuckPerms] Thread <Thread> threw an uncaught exception … java.lang.OutOfMemoryError: Java heap space
failed to handle chunk data (write) … java.lang.OutOfMemoryError: Java heap space

Qué hay detrás: Java gestiona la memoria del servidor en un área llamada heap, que se ha llenado por completo con la carga actual. Las acciones grandes de WorldEdit, muchos chunks cargados (es decir, secciones del mundo), modpacks grandes o plugins con muchos datos pueden necesitar mucha memoria. El servidor suele fallar o volverse inestable; también puede fallar el guardado de datos del mundo o de entidades, como criaturas y objetos. El hilo o el plugin que aparece indica dónde faltó memoria, no necesariamente quién consume más memoria.

Cómo solucionarlo:

  1. Reinicia el servidor para terminar el proceso saturado. Si la carga no cambia, el error puede volver a aparecer.
  2. Calcula la memoria que necesitas: Planificar la RAM necesaria para Minecraft. Si tu paquete no es suficiente, elige más RAM en Ajustes y suscripción → Plan.
  3. Divide las acciones grandes de WorldEdit y, si hace falta, reduce view-distance en server.properties, en Archivos.
  4. Tras el reinicio, revisa la Consola y las zonas del mundo afectadas. Si hay mensajes sobre chunk data (write), comprueba especialmente si se guardó el último estado.

Es bueno saber: Una copia de seguridad antes del próximo cambio grande en el mundo te ayuda a recuperar los cambios perdidos.

„This crash report has been saved to …“: el servidor se ha bloqueado

Así se ve el mensaje:

This crash report has been saved to: crash-reports/crash-<Fecha>_<Hora>-server.txt

Qué hay detrás: El servidor se cerró por un error grave y escribió un informe de fallo. El mensaje solo indica dónde se encuentra ese informe. La causa real, por ejemplo un mod, un plugin, el mundo o la falta de memoria RAM, aparece en el archivo.

Cómo solucionarlo:

  1. En Archivos, abre la carpeta crash-reports/ y dentro de ella el archivo indicado. Su nombre contiene la fecha y la hora del fallo.
  2. Lee la primera sección: después de Description: hay una breve descripción, y debajo la línea del error y el stacktrace, es decir, la lista de puntos del programa que llevaron al error.
  3. Comprueba si los mods o plugins mencionados en el error tienen versiones compatibles. Actualiza el afectado en Mods o Plugins, o quítalo como prueba después de hacer una copia de seguridad.
  4. En caso de OutOfMemoryError, lee el complemento del mensaje. Si indica Java heap space, la memoria de Java está llena; si has contratado muy poca RAM, elige más RAM en Ajustes y suscripción → Plan.
  5. Inicia el servidor y observa la Consola hasta que esté completamente en marcha.

Conviene saber: Guarda el informe para la búsqueda de errores y compara la fecha y la hora con el fallo actual. Para servidores con mods: Errores de mods en servidores Forge, NeoForge y Fabric

Error en el bucle principal del juego

Así se ve el mensaje:

Exception in server tick loop
Caused by: java.lang.<ErrorType>: <Details>

Qué hay detrás: El bucle principal calcula el mundo tick a tick. Una excepción, es decir, un error del programa, ha llegado hasta este bucle y lo ha interrumpido. Entonces el servidor suele bloquearse y escribe un informe de fallo. La causa real casi siempre está en la línea Caused by que aparece justo después.

Cómo solucionarlo:

  1. Busca el mensaje en logs/latest.log o en el informe más reciente de crash-reports/.
  2. Lee la línea Caused by que aparece justo debajo. Si hay varias, la última suele llevar a la raíz del problema.
  3. Las líneas con at … que van debajo indican nombres de paquetes y archivos. Con ellas reconoces el plugin o el mod implicado.
  4. Actualízalo o elimínalo en Plugins o Mods y reinicia el servidor.

Conviene saber: Este mensaje no es un problema de lag, sino un error concreto. Más memoria RAM solo ayuda si la línea Caused by menciona un OutOfMemoryError.

Más información: Cómo solucionar correctamente «Can't keep up» y el timeout del Watchdog

Memoria RAM al límite: GC overhead limit exceeded

Así se ve el mensaje:

java.lang.OutOfMemoryError: GC overhead limit exceeded

Qué hay detrás: Java limpia automáticamente la memoria que ya no necesita. Esto se llama Garbage Collection, o GC para abreviar. Este mensaje significa que Java pasa casi todo el tiempo limpiando y apenas recupera memoria. El heap, es decir, la memoria RAM de Java, está prácticamente lleno. El servidor casi no responde o se bloquea.

Cómo solucionarlo:

  1. Reinicia el servidor.
  2. Calcula cuánta memoria RAM necesita tu configuración. Más información: Planificar la RAM necesaria para Minecraft
  3. Si tu paquete no es suficiente, elige más RAM en Ajustes y suscripción → Plan.
  4. Reduce la carga de chunks y entidades: baja la distancia de visión view-distance en el archivo server.properties, reduce las granjas de animales grandes y recoge los ítems que estén tirados por ahí.

Conviene saber: Un reinicio solo da un respiro. Si el consumo sube de forma constante hasta el límite tras cada reinicio aunque la carga se mantenga igual, también puede ser que un plugin o un mod esté reteniendo memoria.

No es posible crear un nuevo hilo: unable to create native thread

Así se ve el mensaje:

java.lang.OutOfMemoryError: unable to create native thread

Qué hay detrás: Un hilo es una línea de trabajo paralela. Java quiso iniciar uno más y no pudo. Aunque lleve OutOfMemoryError en el nombre, no es una prueba de que el heap de Java esté lleno. Normalmente hay demasiados hilos ejecutándose a la vez, se ha alcanzado un límite de procesos o falta memoria fuera del heap. Entonces el servidor ya no puede iniciar nuevas tareas y se vuelve inestable. Esta línea no revela qué plugin o mod genera los hilos.

Cómo solucionarlo:

  1. No contrates más RAM sin más. Más memoria para Java no resuelve este mensaje automáticamente.
  2. Lee en logs/latest.log las líneas anteriores al mensaje: ¿qué se estaba ejecutando en el momento del error y qué plugins aparecían con más frecuencia?
  3. Demuestra quién es el causante en tiempo de ejecución. Con spark profiler start --thread * en la Consola ves todos los hilos en ejecución. Sus nombres suelen revelar el plugin o el mod.
  4. Solo cuando hayas comprobado quién es el causante, actualízalo en Plugins o Mods, revisa sus ajustes o elimínalo.

Si no avanzas, abre un ticket e indica la hora del mensaje. Sobre spark: spark: encontrar y entender el lag

„Can't keep up“: el servidor no logra seguir el ritmo de sus ticks

Así se ve el mensaje:

Can't keep up! Is the server overloaded? Running 2014ms or 40 ticks behind

Qué hay detrás: Minecraft normalmente calcula 20 ticks por segundo, así que cada tick dispone de un presupuesto de 50 milisegundos. Si estos pasos de trabajo tardan demasiado, se acumula un retraso que el mensaje indica en milisegundos y ticks. El servidor sigue funcionando, pero notablemente más lento: los bloques destruidos reaparecen y los mobs se mueven a tirones. La causa suele ser presión de memoria o de CPU; algunos mensajes sueltos pueden aparecer al iniciar o al generar zonas nuevas.

Así lo solucionas:

  1. Comprueba si spark está disponible. Las versiones actuales de Paper lo incluyen; en otros servidores compatibles instalas la versión adecuada como plugin o mod.
  2. Mide durante el lag con spark tps en la Consola. MSPT son los milisegundos por tick: si la duración del tick supera de forma constante el presupuesto, baja la tasa de ticks.
  3. Encuentra al causante con spark profiler start --timeout 120 y abre el enlace que se muestra después.
  4. Con el servidor detenido, reduce la distancia de visión view-distance y la distancia de simulación simulation-distance en server.properties. Alivia las granjas grandes o pregenera el mundo.
  5. Comprueba si la memoria RAM es suficiente y reinicia tras los cambios de configuración.

Más detalles: Cómo solucionar correctamente „Can't keep up“ y el timeout del watchdog

„DO NOT REPORT THIS TO PAPER“: diagnóstico cuando el servidor se queda colgado

Así se ve el mensaje:

--- DO NOT REPORT THIS TO PAPER - THIS IS NOT A BUG OR A CRASH ---
Server thread dump (Look for plugins here before reporting to Paper!):

Qué hay detrás: Si el hilo del servidor se queda colgado durante unos segundos, Paper escribe un diagnóstico con un thread dump, es decir, una instantánea de en qué está trabajando el servidor en ese momento. Mientras tanto, la partida se atasca; después del cuelgue el servidor puede seguir funcionando. Si el bloqueo dura demasiado, el watchdog lo cierra.

Así lo solucionas:

  1. En el dump, lee las primeras líneas bajo Server thread dump. Si aparece el nombre de un plugin o mod, es una pista clara del causante.
  2. Detén el servidor, actualiza el plugin afectado en Plugins o el mod en Mods, o quítalo como prueba, y reinicia.
  3. Si los dumps se repiten, revisa la memoria RAM, tus plugins y la distancia de visión view-distance en server.properties.
  4. Los dumps aislados, por ejemplo al iniciar o al guardar un mundo grande, puedes observarlos en lugar de intervenir de inmediato.

Más detalles: Cómo solucionar correctamente „Can't keep up“ y el timeout del watchdog

«ChunkTaskScheduler»: Paper espera mientras carga o genera un chunk

Así se ve el mensaje:

[ChunkTaskScheduler] Chunk wait task info below:
[ChunkTaskScheduler] Chunk holder: NewChunkHolder{world=<Mundo>, chunkX=<x>, chunkZ=<z>, …, currentGenStatus=minecraft:initialize_light, requestedGenStatus=minecraft:full, …}

Qué hay detrás: Paper ha esperado más de lo previsto a que se cargara o generara un chunk, es decir, una sección del mundo de 16 × 16 bloques, y ha escrito un diagnóstico. En ese momento el servidor se queda atascado. currentGenStatus muestra el estado alcanzado y requestedGenStatus el objetivo. Normalmente la causa es una sobrecarga: generación del mundo, muchos jugadores muy separados entre sí o plugins lentos. Con menos frecuencia, una región está dañada.

Cómo solucionarlo:

  1. En Archivos, reduce la distancia de visión view-distance en server.properties y reinicia el servidor.
  2. Genera el mundo con antelación: Chunky: pregenerar el mundo de Minecraft.
  3. Si spark está disponible, analiza la carga durante el fallo con spark profiler start --timeout 120 en la Consola. El informe muestra qué procesos consumen tiempo.
  4. Si afecta repetidamente al mismo mundo y a las mismas coordenadas de chunk, revisa las líneas de registro circundantes en busca de errores de carga de esa región. Si se confirma el daño, detén el servidor, guarda una copia del estado actual y restaura una copia intacta en Copias de seguridad. Los cambios realizados desde esa copia se perderán.

Conviene saber: Las coordenadas muy grandes indican viajes lejos del centro del mundo. Un límite de mundo adecuado restringe una mayor exploración.

„The server has stopped responding“: el Watchdog de Paper informa de un bloqueo

Así se ve el mensaje:

The server has stopped responding! This is (probably) not a Paper bug.
If you see a world save or edit, then it means you did far more than your server can handle at once
If this is the case, consider increasing timeout-time in spigot.yml but note that this will replace the crash with LARGE lag spikes

Qué hay detrás: Estas líneas forman parte del bloque de aviso del Watchdog de Paper, que detecta un hilo principal bloqueado durante demasiado tiempo, es decir, el hilo de trabajo del desarrollo del juego. Durante el bloqueo, el juego se queda parado; si el bloqueo continúa, el Watchdog cierra el servidor. Las causas típicas son plugins sobrecargados, operaciones grandes en el mundo o accesos HTTP y a bases de datos que bloquean. El thread dump de debajo muestra las llamadas de programa que se estaban ejecutando.

Cómo solucionarlo:

  1. Lee el thread dump en logs/latest.log, en Archivos. Comprueba si hay actualizaciones de los plugins mencionados; ajusta su configuración o quítalos para probar con el servidor detenido.
  2. Si muestra edición del mundo o guardado, divide las acciones grandes, por ejemplo con WorldEdit, en pasos más pequeños.
  3. Si muestra accesos HTTP o MySQL, revisa en el plugin implicado la conexión y la disponibilidad del servicio.
  4. Aumentar timeout-time en spigot.yml alarga el tiempo de espera, pero no soluciona el bloqueo.
  5. Si los bloqueos se repiten, reduce la carga de plugins y revisa la memoria.

Más información: Solucionar correctamente „Can't keep up“ y el timeout del Watchdog

La tarea de chunks de Paper falla con BootstrapMethodError

Así se ve el mensaje:

[ca.spottedleaf.concurrentutil.executor.thread.BalancedPrioritisedThreadPool] Exception thrown from thread <Hilo>
java.lang.BootstrapMethodError: bootstrap method initialization exception

Qué hay detrás: Paper carga y genera chunks en hilos propios, es decir, líneas de trabajo paralelas al juego principal. En uno de ellos, Java no pudo preparar un punto de llamada del programa. Las posibles causas son un error en Paper, una extensión incompatible o una versión de Java no compatible. El mensaje por sí solo no determina ninguna de ellas.

Cómo solucionarlo:

  1. Actualiza Paper en Versión a una compilación estable reciente de tu versión de Minecraft.
  2. Usa una versión de Java compatible con esa compilación: ¿Qué versión de Java necesita tu servidor de Minecraft?
  3. Lee el stacktrace completo en logs/latest.log. Si una línea Caused by menciona un plugin, actualízalo en Plugins.
  4. No reemplaces bibliotecas del servidor a mano. Eso suele causar más errores nuevos.
  5. Si el error se repite tras la actualización, informa del stacktrace completo al proyecto Paper.

Minecraft no puede guardar el informe de fallo

Así se ve el mensaje:

We were unable to save this crash report to disk.

Qué hay detrás: El mensaje se refiere a la escritura del informe de fallo. Tras un error, Minecraft ha intentado guardar el diagnóstico en el disco y no ha podido guardar el archivo del informe. La causa del error original aparece antes en la Consola; la ausencia del informe dificulta la búsqueda posterior del fallo.

Cómo solucionarlo:

  1. Guarda primero el bloque de error completo de la Consola, incluidas las líneas anteriores a este mensaje.
  2. En Archivos, revisa los archivos existentes en crash-reports/ y logs/latest.log. Lee el mensaje concreto del error de escritura y comprueba el espacio disponible.
  3. Soluciona la causa que se indique allí. Si la ruta sigue sin poder escribirse, abre un ticket e indica la hora y el error de escritura.

¿Tu mensaje no aparece aquí?

Lee el mensaje completo en logs/latest.log y, sobre todo, las líneas anteriores: la sobrecarga casi siempre tiene un desencadenante que aparece antes del primer aviso. En el stacktrace o en el volcado de hilos, los nombres de paquete, es decir, los nombres de carpetas separados por puntos como com.<Desarrollador>.<Plugin>, y los nombres de archivo como <Plugin>.jar indican qué plugin o mod está implicado. Antes de modificar archivos de configuración, crea una copia en Copias de seguridad. Si no avanzas, abre un ticket e indica la hora del mensaje.