RealisticNode Docs
Solución de problemas

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 carpetaQué contiene
logs/latest.logTodo lo que el servidor mostró desde su último inicio. Es el primer archivo que debes revisar.
logs/*.log.gzLogs 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.logSolo en Forge y NeoForge. Mucho más detallado que latest.log, útil cuando un mod no se carga.
hs_err_pid*.logEn 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 .log normal 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:

logs/latest.log
[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 entity o Exception 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.

En esta página