Entender los logs de Minecraft
Los logs de Minecraft son tu mejor fuente de verdad cuando algo falla. Registran lo que hizo el juego o el servidor, en orden, hasta el momento del fallo. Esta guía explica qué archivos de log importan, cómo leer una línea de log y qué buscar.
Los archivos de log que importan
Todo está en la carpeta logs/ (raíz del servidor, o instance/.minecraft en un cliente):
- latest.log
El registro completo de la ejecución actual. Es el archivo que abres primero; el error casi siempre está aquí. - debug.log
Una versión mucho más detallada de la misma ejecución. Úsala cuando latest.log no diga lo suficiente. - Registros archivados
Las ejecuciones más antiguas se comprimen como2026-06-08-1.log.gz. Descomprímelo para leer una sesión pasada. - crash-reports/
Una carpeta aparte con un informe enfocado, escrito solo cuando el juego se bloquea. Consulta Cómo leer un informe de fallos de Minecraft.
Cómo leer una línea de log
Cada línea sigue el mismo formato:
[14:23:51] [Server thread/ERROR]: Encountered an unexpected exception
- [14:23:51]
La marca de tiempo: cuándo ocurrió el evento. - [Server thread/ERROR]
El hilo que lo registró, y el nivel. - El mensaje
Lo que realmente ocurrió, a menudo seguido de un stack trace si es un error.
El nivel del registro indica la gravedad de un vistazo: INFO (normal), WARN (algo va mal pero no es fatal), ERROR (un fallo real), y FATAL (el servidor se está apagando).
Hilos: quién habla
- Server thread / main
El bucle principal del juego. Los errores aquí suelen afectar directamente a la jugabilidad (y pueden bloquear el servidor). - Worker / IO threads
Trabajo en segundo plano como la E/S de chunks. Útil para problemas de disco y de guardado del mundo. - Mod/plugin threads
Nombrado según un mod o plugin: una pista rápida de qué es responsable.
Qué buscar
- Desplázate a la primera línea ERROR/FATAL o Exception; los errores posteriores suelen ser solo consecuencias.
- Lee la sección de inicio en busca de mods/plugins fallidos, la versión de Java incorrecta o un EULA no aceptado.
- Vigila el spam repetido de WARN como «Can't keep up!» (rendimiento, consulta Can't Keep Up) o «moved too quickly».
- Anota las últimas líneas antes de un congelamiento o apagado: muestran qué hacía el servidor cuando falló.
- Coteja cualquier error con la Problemas comunes lista para la solución exacta.
Logs del servidor vs. logs del cliente
Comparten el mismo formato pero están en lugares diferentes. Un registro de servidor anota el guardado del mundo, las conexiones de jugadores y la carga de plugins/mods; un registro de cliente anota el renderizado, los paquetes de recursos y tu propia conexión. Al resolver un problema de conexión, compara ambos: la causa puede estar en un solo lado.
Compartir logs de forma segura
Los registros pueden contener la IP de tu servidor y, en ocasiones, tokens, así que no los pegues públicamente sin echarles un vistazo primero. Usa un servicio de pegado (como mclo.gs) para compartir, o sube el archivo directamente a MCDoctor.ai, que lee el registro y te explica la causa y la solución, sin rebuscar manualmente.
Preguntas frecuentes
En la carpeta logs/ de la raíz de tu servidor o en la carpeta instance/.minecraft. La ejecución actual es latest.log; las anteriores son archivos .log.gz comprimidos.
Cubren la misma ejecución, pero debug.log es mucho más detallado. Empieza con latest.log y pasa a debug.log solo cuando necesites más detalle.
WARN significa que algo va mal pero no es fatal; ERROR es un fallo real; FATAL significa que el servidor se está apagando. Céntrate en la primera línea ERROR/FATAL.
Sí, sube latest.log o un informe de fallos y MCDoctor.ai lo analiza y devuelve la causa probable y la solución recomendada.