¿Por qué no inicia mi servidor de Minecraft? Leer el error y solucionarlo

Cuando un servidor falla al iniciar, el panel lo muestra como Crashed o Ran out of memory en lugar de dejarlo atascado en "Starting". El motivo siempre está escrito en el log del servidor; lo difícil es saber dónde buscar y qué significa el mensaje. Esta guía cubre ambos puntos. Casi todos los fallos de inicio se deben a una de unas pocas causas, y casi todas se solucionan eliminando o reemplazando un archivo.

Dónde encontrar el error

• La pestaña Console muestra el log del servidor mientras arranca, por lo que un error durante el inicio es visible allí.
• `logs/latest.log` en la pestaña Files es el mismo log guardado como archivo. Permanece allí tras detener el servidor, permitiéndote leerlo a tu ritmo. Las ejecuciones anteriores se guardan en la misma carpeta como archivos .log.gz con fecha.
• La carpeta `crash-reports` en la pestaña Files. Cuando Minecraft falla por sí mismo, escribe un informe completo aquí, con una descripción en lenguaje sencillo cerca del inicio.

Cómo leer un error de Java

Los fallos de Minecraft vienen con largos "stack traces" (rastros de pila) — docenas de líneas que empiezan con at …. Puedes ignorar casi todo. Lo que buscas es:

1. La primera línea que contenga ERROR, Exception o FATAL durante el inicio. Los errores más abajo suelen ser consecuencias del primero.
2. Cualquier línea que empiece por `Caused by:`; la última en un bloque suele ser la causa raíz real.
3. Cualquier nombre de mod o plugin en esas líneas. El ID de un mod (por ejemplo create o jei) o el nombre de un archivo .jar te dirá a quién culpar.

Luego, compara lo que encontraste con las causas de abajo.

Ran out of memory (Sin memoria)

Mensajes: java.lang.OutOfMemoryError: Java heap space, o el estado del panel Ran out of memory.

El servidor necesitaba más que los 3 GB que tiene un servidor gratuito. Esto es común con modpacks grandes y no se puede solucionar ajustando configuraciones — un paquete de 300 mods simplemente necesita más memoria. Elimina los mods que no uses, elige un pack más ligero o pásate a un servidor de pago con más memoria. ¿Cuánta RAM necesita un servidor de Minecraft? muestra lo que es compatible.

Un mod solo para clientes en el servidor

Mensaje: Attempted to load class … for invalid dist DEDICATED_SERVER, a menudo mencionando una clase de un mod de renderizado, shaders, minimapa o menú.

Algunos mods solo tienen sentido en la computadora del jugador — cambian gráficos, sonidos o menús — y colapsan un servidor que intenta cargarlos. Busca el mod mencionado cerca del error y borra su archivo .jar de la carpeta mods. Cuando instalas un modpack de CurseForge, Cobbly ya elimina los mods conocidos solo para clientes y reintenta automáticamente cuando detecta este error, por lo que normalmente solo ocurre con mods que añadiste manualmente.

Una dependencia faltante

Mensajes: Missing or unsupported mandatory dependencies, requires … which is missing, o Unknown dependency.

Muchos mods y plugins necesitan otro — una librería — para funcionar. El error nombra a ambos: el que falló y el que necesita. Instala el que falta, asegurándote de que coincida con tu versión de Minecraft. El caso más común es un mod de Fabric sin Fabric API. En Paper, suele ser Vault o ProtocolLib.

Un mod o plugin para una versión diferente

Mensajes: Incompatible mod set, requires minecraft …, Mod … is incompatible with loaded version, Unsupported class file major version, o has been compiled by a more recent version of the Java Runtime.

Los mods se construyen para una versión exacta de Minecraft y un cargador específico. Un mod de 1.20.1 no cargará en 1.21, y un mod de Fabric no cargará en Forge. Comprueba el archivo que instalaste comparándolo con la versión del servidor en la pestaña Software y descarga la versión correspondiente. Los mensajes de Java significan lo mismo pero disfrazados: Cobbly ejecuta la versión de Java que tu versión de Minecraft necesita, por lo que un mod que pide una versión de Java distinta fue hecho para una versión de Minecraft distinta.

Dos mods en conflicto

Mensajes: Mixin apply failed, MixinApplyError, o InvalidInjectionException, usualmente mencionando dos mods.

Los mods parchean el código de Minecraft y, a veces, dos intentan parchear lo mismo de formas incompatibles. Si el error menciona dos mods, elimina el que añadiste más recientemente y vuelve a empezar. Si acabas de añadir varios a la vez, elimina la mitad, prueba y ve descartando desde ahí. Una actualización de cualquiera de los dos mods suele solucionarlo.

Mods duplicados

Mensaje: Found duplicate mods o Duplicate mod ID.

Dos archivos .jar del mismo mod, a menudo dos versiones diferentes tras una actualización. Abre la carpeta mods y elimina el más antiguo.

Un mundo o archivo de configuración dañado

Mensajes: errores que mencionan level.dat, Failed to load level, o un error de análisis (parse error) que nombra un archivo bajo config/.

Un archivo de configuración con un error tipográfico, o un mundo que no se guardó correctamente, puede detener el inicio. Un error de configuración nombra su archivo — deshace tu último cambio en él, o bórralo para que el mod genere uno nuevo por defecto. Para errores de mundo, restaura la última copia válida desde la pestaña Backups (consulta Cómo funcionan las copias de seguridad).

El servidor falla más tarde, no en el inicio

Mensaje: A single server tick took 60.00 seconds (should be max 0.05).

Este es el sistema watchdog de Minecraft apagando el servidor porque se congeló durante un minuto completo. Algo estaba consumiendo demasiados recursos — una granja gigante o máquina de redstone, miles de objetos tirados en el suelo, o un mod atrapado en un bucle. El informe de error indica en qué estaba ocupado el servidor. ¿Por qué mi servidor de Minecraft tiene lag? cubre los culpables habituales.

La solución: eliminar un archivo

Para cada causa anterior, la solución es la misma serie de pasos:

1. Asegúrate de que el servidor esté detenido.
2. Abre la pestaña Files y ve a mods (o plugins en Paper y Purpur).
3. Elimina, o reemplaza por la versión correcta, el archivo .jar que mencionó el error.
4. Presiona Start y observa la pestaña Console hasta que veas la línea que comienza con Done (.

Si el error no menciona nada que reconozcas, la página de soporte indica las formas de contactarnos. Incluye las primeras ERROR y las últimas Caused by: líneas; eso suele ser suficiente para indicarnos la respuesta.