¿Tu servidor de Minecraft crashea? Cómo leer el crash report

Si tu servidor de Minecraft crashea, la causa casi siempre queda registrada, bien clara, en la carpeta crash-reports o en logs/latest.log. Leer un crash report de Minecraft se hace en tres pasos: mira la línea Description:, las primeras líneas del stack trace y el último Caused by:. Ahí suele aparecer el plugin o mod culpable. ¿No hay crash report? Entonces mira en latest.log y en la consola; muchas veces es la memoria.

¿Dónde están el crash report y los logs?

Todo está en la carpeta principal de tu servidor, que abres en el gestor de archivos del panel de juego o por SFTP.

• crash-reports/: un archivo por crash, con la hora en el nombre, como crash-2026-09-30_14.02.11-server.txt. Este informe solo se genera cuando el propio Minecraft detecta que algo va mal.
• logs/latest.log: el log de la sesión actual. En cada arranque (y cada día nuevo) el anterior se comprime, por ejemplo como logs/2026-09-30-1.log.gz. Así que, tras un reinicio, el crash está en el .log.gz más reciente.
• hs_err_pid<número>.log: el que se cayó fue Java, no Minecraft. Es poco frecuente.

¿No encuentras nada? Mira entonces la consola del panel. Cuando hay un crash, aparece Detected server process in a crashed state!, con Exit code y Out of memory debajo. Si pone Out of memory: true, el servidor se detuvo porque superó su límite de memoria, y Minecraft ya no tuvo ocasión de escribir un informe.

Cómo leer un crash report de Minecraft

Un ejemplo recortado de un servidor con mods:

---- Minecraft Crash Report ----
// Who set us up the TNT?

Time: 2026-09-30 14:02:11
Description: Ticking entity

java.lang.NullPointerException: ...
	at com.example.mobmod.ZombieAi.tick(ZombieAi.java:88)
	at net.minecraft.world.level.Level...

A detailed walkthrough of the error, its code path and all known details is as follows:
-- Head --
Thread: Server thread
-- Entity being ticked --
Details:
	Entity Type: minecraft:zombie (...)
	Entity's Block location: World: (120,64,-340), ...
-- System Details --
...

1. Description es el resumen. Ticking entity, Ticking block entity, Exception in server tick loop o Watching Server ya te marcan una dirección.
2. La línea de debajo es el error en sí, como java.lang.OutOfMemoryError: Java heap space.
3. Las líneas at son el stack trace; la de arriba del todo es donde falló. net.minecraft es el propio Minecraft; io.papermc, org.bukkit, org.spigotmc, com.destroystokyo y ca.spottedleaf son Paper. Cualquier otro nombre de paquete suele ser un plugin o mod.
4. Caused by: es la causa de fondo; si hay varias, la última es la más profunda. Las líneas como ... 12 more son repeticiones.
5. Los bloques de debajo dan contexto: en una ticking entity, el tipo y las coordenadas; abajo del todo, en System Details, la versión de Java, la memoria y los flags de la JVM.

Desde la 26.1, Minecraft Java ya no está ofuscado, así que también las líneas de Minecraft de tu stack trace tienen nombres de clase legibles.

Las cinco causas más habituales

1. Falta de memoria

Si pone java.lang.OutOfMemoryError: Java heap space, el heap de Java está lleno. No tiene por qué ser una fuga; a menudo el heap es simplemente demasiado pequeño. Ayudan una view-distance más baja y menos mundos cargados. Si sigue yendo justo, elige un paquete de Minecraft más grande.

Más complicado es un crash sin informe, con un log que se corta de golpe y Out of memory: true en la consola. Además del heap, Java usa memoria para, entre otras cosas, las clases cargadas y los hilos. Si el heap puede llenar todo el paquete, el proceso puede pasarse del límite y se detiene a la fuerza. En MC-Node lo controlas con la variable de Startup Geheugenlimiet (%) («límite de memoria») en el panel: la parte de la memoria de tu paquete que Java puede usar como heap, entre 50 y 95. Vacío significa 100 %. Un valor en torno a 85 deja margen; los modpacks pesados pueden necesitar uno más bajo. Reinicia después. Consulta también cuánta RAM necesita tu servidor.

2. Un plugin o mod que no encaja con la 26.3

En Paper sueles ver entonces Error occurred while enabling ... (Is it up to date?). Paper desactiva ese plugin y sigue funcionando. Los errores de plugins posteriores, Paper suele registrarlos como Could not pass event ... to <plugin>, sin crashear; un plugin que deja colgado el servidor lo encuentras mediante el watchdog (causa 4). Comprueba en la página del plugin si es compatible con la 26.3. Ojo: en el momento de escribir esto, Paper solo tiene builds alpha y beta para la 26.3; la 26.2 tiene builds estables. Qué más rompe la 26.3 lo puedes leer en Minecraft 26.3 y tu servidor.

3. La versión de Java equivocada

Minecraft 26.x pide Java 25. Un servidor vanilla con Java 21 da UnsupportedClassVersionError con class file version 69.0 (Java 25) y only recognizes class file versions up to 65.0 (Java 21). En ese caso Paper muestra Minecraft 26.1 and newer requires running the server with Java 25 or above. El mismo error en un solo plugin significa que ese plugin espera una Java más nueva. Se cambia con la imagen de Docker en el panel: cambiar la versión de Java.

4. El watchdog: un tick que se queda colgado

Vanilla y NeoForge avisan con A single server tick took ... seconds (should be max ...) y Considering it to be crashed, server will forcibly shutdown. El límite es max-tick-time en server.properties, 60000 milisegundos por defecto. Paper desactiva ese watchdog y usa en su lugar timeout-time en spigot.yml (60 segundos por defecto), con el mensaje The server has stopped responding! y un thread dump en latest.log, sin crash report. Busca ahí nombres de plugins: el propio Paper señala los plugins que hacen peticiones HTTP o MySQL y las ediciones de mundo demasiado grandes. Según Paper, subir el límite solo cambia el crash por fuertes picos de lag.

5. Ticking entities y chunks corruptos

Con Ticking entity o Ticking block entity, un solo mob, tolva o máquina (a menudo de un mod) lanza un error en cada tick. En vanilla y NeoForge el servidor vuelve a crashear en cuanto se carga esa parte del mundo. El informe indica el tipo y las coordenadas. Restaura una copia de seguridad, o borra ese chunk offline con la herramienta de la comunidad MCA Selector (compatible con la 26.3 desde la versión 2.9); eso sí, borra todo lo que hay en ese chunk. Paper aquí no crashea: registra Entity threw exception at o BlockEntity threw exception at con la ubicación, y elimina esa entity o block entity.

Un archivo de región dañado (r.x.z.mca, 32 por 32 chunks), por ejemplo tras una parada brusca durante el guardado, normalmente no hace crashear el servidor. Vanilla registra Failed to load chunk, Paper ... chunk data will be lost, y ese chunk se vuelve a generar. Lo que había se pierde; en ese caso, restaura una copia de seguridad.

Encontrar al culpable paso a paso

1. Haz primero una copia de seguridad, aunque el servidor no esté funcionando.
2. Lee el crash report más reciente y el final de latest.log (o del .log.gz más reciente). Busca ERROR y WARN justo antes del crash.
3. Deshaz tu último cambio. Una actualización, un plugin nuevo u otra imagen de Java es el sospechoso número uno.
4. Divide a la mitad. ¿No hay un nombre claro? Mueve la mitad de tus plugins (o mods) a una carpeta como plugins-desactivados y arranca. Si el crash desaparece, el culpable está en la mitad que quitaste; si no, en el resto. Repite hasta que quede un solo candidato. Los mods sin su mod base no arrancan; ese es otro error.
5. Comparte tu log con mclo.gs en lugar de pegarlo en Discord: obtienes un enlace corto y las direcciones IP se eliminan automáticamente. Revisa tú mismo que no haya contraseñas ni tokens.

Cuando no es un crash

• Can't keep up! Is the server overloaded? es lag: el servidor va con retraso, pero sigue funcionando. Consulta qué significan TPS y MSPT.
• Jugadores que se desconectan mientras la consola sigue funcionando: normalmente es cosa del cliente o de la conexión.

¿Cuándo abrir un ticket?

Si ves Out of memory: true aunque el límite de memoria esté bien configurado, si el servidor crashea antes de que aparezca nada en latest.log, o si dividir a la mitad no da resultado, abre un ticket. Indica qué servidor es, a qué hora fue el crash, los enlaces de mclo.gs del crash report y de latest.log, y qué cambiaste justo antes.

Preguntas frecuentes

¿Dónde encuentro el crash report de mi servidor de Minecraft?

En la carpeta crash-reports, dentro de la carpeta principal de tu servidor, con la fecha y la hora en el nombre, como crash-2026-09-30_14.02.11-server.txt. El log está en logs/latest.log; si el servidor ya se ha reiniciado, mira en el archivo .log.gz más reciente.

¿Por qué no hay crash report si mi servidor sí crashea?

Entonces el proceso se detuvo antes de que Minecraft pudiera escribir un informe, a menudo porque superó el límite de memoria del paquete; la consola muestra entonces Out of memory: true. En ese caso, baja Geheugenlimiet (%) («límite de memoria») en el panel o elige un paquete más grande.

¿Qué versión de Java necesito para Minecraft 26.3?

Java 25: así figura en los datos de versión de Mojang para la 26.3, y Paper la exige desde la 26.1. Con una Java más antigua verás UnsupportedClassVersionError con class file version 69.0, o en Paper un mensaje de que se necesita Java 25.

¿Puedo poner max-tick-time en -1 contra los crashes del watchdog?

En vanilla y NeoForge se puede, pero no soluciona nada: un servidor bloqueado simplemente se queda colgado. Paper desactiva ese watchdog de vanilla; allí se aplica timeout-time en spigot.yml. Mejor averigua qué está bloqueando el tick.

Sigue leyendo

• ¿Qué Java necesita tu servidor de Minecraft? (Java 25 para 26.x)
• Cómo subir tu mundo de un jugador a un servidor de Minecraft