Los logs del servidor están en la pestaña Registros y en el archivo /logs/latest.log. Los crash reports se guardan en la carpeta /crash-reports/. La regla para diagnosticar es una sola: busca el primer error en orden cronológico y la línea Caused by:; esa línea indica la causa real, no el último mensaje de la pantalla.
#Qué necesitas
- Acceso al panel manage.mchost.gg.
- La pestaña Registros (vista y descarga) o la pestaña Archivos (carpetas
logsycrash-reports).
#Dónde están los logs
| Archivo | Contenido |
|---|---|
/logs/latest.log |
Registro de la ejecución actual o de la última |
/logs/YYYY-MM-DD-N.log.gz |
Archivos de sesiones anteriores, comprimidos |
/crash-reports/crash-*.txt |
Informe de un crash grave de la JVM |
En la pestaña Registros tienes el campo Filtrar registros…, el botón Actualizar y Descargar para guardar el archivo completo.
#Niveles de los mensajes
| Nivel | Significado |
|---|---|
INFO |
Funcionamiento normal del servidor |
WARN |
Advertencia: el servidor sigue funcionando, pero algo no va bien |
ERROR |
Error: normalmente no se ha cargado un complemento o la operación no se ha completado |
FATAL |
Error crítico: el servidor se detiene |
No empieces a leer por el final del archivo. Las últimas líneas suelen ser la consecuencia, no la causa: ahí el servidor escribe la información del cierre. Busca el primer ERROR empezando por arriba.
#Cómo leer un stack trace
[12:03:41] [Server thread/ERROR]: Could not load 'plugins/PluginAntiguo.jar' in folder 'plugins'
org.bukkit.plugin.InvalidPluginException: java.lang.UnsupportedClassVersionError:
pl/example/Main has been compiled by a more recent version of the Java Runtime
at org.bukkit.plugin.java.JavaPluginLoader.loadPlugin(JavaPluginLoader.java:147)
...
Caused by: java.lang.UnsupportedClassVersionError: pl/example/MainLéelo en este orden:
- Primera línea con
ERROR: indica lo que no se ha completado (Could not load 'plugins/PluginAntiguo.jar' in folder 'plugins'). - Nombre del archivo entre comillas o corchetes: el culpable.
Caused by:: la causa real. Si hay varias líneas así, cuenta la última.- Las líneas
at ...muestran la ruta de llamadas: son útiles para el autor del complemento, no para ti.
#Mensajes habituales y qué significan
| Mensaje | Causa |
|---|---|
UnsupportedClassVersionError |
El complemento requiere una versión más reciente de Java |
NoClassDefFoundError |
Falta una dependencia: el plugin necesita otro plugin |
Could not load 'plugins/X.jar' |
Plugin incompatible con la versión o con el motor |
Failed to bind to port |
El proceso anterior del servidor sigue en marcha |
java.lang.OutOfMemoryError |
Memoria agotada |
Failed to load level.dat |
Mundo dañado o incompleto |
Incompatible mod set |
Diferencia de mods entre el cliente y el servidor |
Can't keep up! Is the server overloaded? |
El servidor no da abasto con los ticks; consulta Lag y optimización |
#Crash reports
El archivo de la carpeta /crash-reports/ empieza con la sección ---- Minecraft Crash Report ----. Te interesan tres fragmentos:
Description:: una frase que describe qué ha fallado.Caused by:: la excepción real.-- Head --/Stacktrace:: las primeras líneas señalan el paquete del mod, p. ej.at com.example.mod.EntityHandler.
El nombre del paquete en el stack trace es la forma más rápida de localizar el mod responsable del crash.
El crash report solo se genera cuando la JVM se detiene de forma brusca. Un servidor que se cierra «con elegancia» tras un error deja rastro únicamente en latest.log.
#Filtrar el log
El campo Filtrar registros… de la pestaña Registros reduce la vista a las líneas que coinciden. Frases útiles: ERROR, Caused by, WARN, el nombre del plugin.
Con el archivo descargado, en la terminal:
grep -n "ERROR" latest.log | head -20
grep -n -A5 "Caused by" latest.log | head -40#Cómo informar de un problema
Al informar a soporte, adjunta el archivo completo latest.log (botón Descargar), no una captura de pantalla con un fragmento. Una línea de antes del error que no aparezca en la captura puede ser justo la única importante.
#Problemas frecuentes
#El log tiene muchísimos errores: por dónde empezar
Por el primero en orden cronológico. Los siguientes suelen derivar de que el primer componente no se cargó.
#El log termina a mitad de una frase
El servidor se detuvo de forma brusca: comprueba si se usó Forzar detención y si apareció un OutOfMemoryError.
#No existe la carpeta crash-reports
No se ha producido un crash grave. Diagnostica con latest.log.
#El archivo latest.log es enorme
El log crece cuando un plugin llena el registro de advertencias. Descarga el archivo y filtra por ERROR; en esta fase, las WARN repetidas en bucle se pueden ignorar.
#He encontrado el nombre del mod, pero no sé qué hacer ahora
Elimina su archivo .jar de /mods o /plugins, arranca el servidor y comprueba si el error desaparece. Así confirmas el diagnóstico.