Leer los logs y los crash reports
Encuentra y lee los logs y los crash reports de tu servidor de Minecraft en RealisticNode, entiende los stack traces, comparte logs y encuentra el plugin o mod que falla.
Cuando algo sale mal, tu servidor casi siempre escribe por qué. Esta guía te muestra dónde encontrar esa información y cómo leerla, aunque nunca hayas visto un error de Java.
Dónde encontrar los logs
Abre Files en el panel. Estos son los archivos y carpetas que importan:
| Archivo o carpeta | Qué contiene |
|---|---|
logs/latest.log | Todo lo que el servidor mostró desde su último inicio. Es el primer archivo que debes revisar. |
logs/*.log.gz | Logs más antiguos, uno por día o por inicio (por ejemplo 2026-10-24-1.log.gz). Están comprimidos. |
crash-reports/ | Un archivo .txt por cada crash, con la fecha y la hora en el nombre. Abre el más reciente. |
logs/debug.log | Solo en Forge y NeoForge. Mucho más detallado que latest.log, útil cuando un mod no se carga. |
hs_err_pid*.log | En la carpeta principal. Se escribe cuando el propio Java crashea (es raro). |
latest.log se reemplaza en cada inicio. Si el problema pasó antes de un reinicio, busca en el archivo .log.gz más reciente.
Abrir un log más antiguo
Los logs antiguos terminan en .gz, así que no puedes abrirlos directamente en el navegador. Puedes:
- Hacer clic derecho en el archivo y elegir Unarchive (descomprimir): el archivo
.lognormal aparece en la misma carpeta. Haz clic en él para leerlo. - O elegir Download y abrirlo en tu computadora con 7-Zip (Windows) o la Utilidad de Archivo (Mac).
Los archivos de más de 4 MB no se pueden abrir en el editor del navegador: descárgalos o usa SFTP.
Usar la consola
La Console muestra en tiempo real lo mismo que latest.log.
- Haz clic en Error o Warning encima de la salida para ocultar todo lo demás. Es la forma más rápida de detectar problemas en un inicio largo.
- Presiona Ctrl + F dentro de la salida para buscar una palabra, como el nombre de un plugin.
- Haz clic en el ícono Share Logs para subir las últimas 500 líneas a mclo.gs. El enlace se copia por ti, listo para enviarlo a nuestro equipo. mclo.gs también resalta los errores y da pistas.
Los logs compartidos son públicos
Cualquiera con el enlace puede leer el log. Revisa que no muestre contraseñas, datos de bases de datos, tokens de API ni direcciones IP que quieras mantener en privado.
Cómo leer un error
Los errores de Java dan miedo, pero solo necesitas unas pocas líneas. Este es un ejemplo típico:
[12:04:31 ERROR]: Error occurred while enabling ShopPlus v2.3 (Is it up to date?)
java.lang.IllegalStateException: Could not load the shop list
at com.example.shopplus.config.ShopConfig.load(ShopConfig.java:42)
at com.example.shopplus.ShopPlus.onEnable(ShopPlus.java:18)
at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:288)
...
Caused by: java.io.FileNotFoundException: plugins/ShopPlus/shops.yml (No such file or directory)
at java.io.FileInputStream.open0(Native Method)
...Lee la primera línea
Muchas veces dice directamente qué falló: aquí, el plugin ShopPlus no pudo iniciar.
Busca las líneas "Caused by"
Un error largo puede tener varias líneas Caused by:. La última suele ser la verdadera causa. Aquí, falta un archivo.
Mira los nombres de los paquetes
Las líneas at ... muestran dónde ocurrió el error. Sáltate las que empiezan con java., net.minecraft., org.bukkit., io.papermc. o net.minecraftforge. (son el juego y el software del servidor). El primer nombre diferente, como com.example.shopplus, apunta al plugin o mod responsable.
Busca el error
Copia la línea del error (sin la hora) y búscala junto con el nombre del plugin o mod. Muchas veces alguien ya tuvo el mismo problema. Revisa también la página del plugin o del mod por si hay una versión más nueva.
Leer un crash report
Los crash reports de crash-reports/ siguen la misma idea. Fíjate en:
- Description: un resumen corto como
Ticking entityoException in server tick loop. - El error y sus líneas Caused by justo debajo.
- Secciones como
-- Entity being ticked --o-- Block entity being ticked --: muestran el tipo y la ubicación de lo que crasheó. - En Forge y NeoForge, algunos reportes muestran Suspected Mods (mods sospechosos). Es una buena pista, pero no siempre acierta.
La página Errores comunes explica los mensajes que verás con más frecuencia.
Encontrar un plugin o mod que falla dividiendo a la mitad
Si los logs no nombran a un culpable, prueba la mitad de tus plugins o mods cada vez. Con 40 mods, encuentras el que falla en unos 6 reinicios.
Primero haz un backup
Crea un backup antes de quitar nada. Algunos mods borran sus bloques e ítems del mundo cuando faltan.
Saca la mitad
Detén el servidor. En Files, crea una carpeta llamada disabled en la carpeta principal y usa Move para mover ahí la mitad de los archivos .jar de plugins (o mods).
Prueba
Inicia el servidor. Si el problema desapareció, el culpable está en la carpeta disabled. Si sigue ahí, está en la mitad que se quedó.
Repite
Sigue dividiendo a la mitad el grupo sospechoso hasta que quede un solo archivo. Después actualízalo, busca una alternativa o informa del error a su autor, y vuelve a poner los demás archivos en su lugar.
Deja las librerías junto con los mods que las necesitan (por ejemplo, Fabric API, Architectury o Cloth Config). Si no, aparecerán errores de "missing dependency" que esconden el problema real.
¿Necesitas ayuda?
Haz clic en Share Logs en la consola, o sube el crash report a mclo.gs, y envía el enlace a nuestro equipo en Discord con tu Server ID y lo que cambió antes de que empezara el problema.
Lag y rendimiento
Encuentra y soluciona el lag de tu servidor de Minecraft. Mide los TPS con spark, optimiza Paper, pregenera el mundo con Chunky y reduce la distancia de visión en RealisticNode.
Errores comunes del servidor de Minecraft
Qué significan los errores más comunes de un servidor de Minecraft y cómo arreglarlos en RealisticNode, desde "Can't keep up" y ticking entity hasta errores de puerto y login.