Un servidor que deja de arrancar justo después de añadir o actualizar un complemento casi siempre se detiene en un archivo .jar concreto. El registro indica su nombre; y si no lo hace, lo encontrarás con el método de bisección en unos pocos reinicios. El orden es siempre el mismo: registro → nombre del archivo → eliminación → comprobación.
#Lo que necesitas
- Las pestañas Registros y Archivos en el panel de manage.mchost.gg.
- Una copia de seguridad antes de eliminar cualquier cosa.
#Mensajes típicos
| Mensaje | Significado | Solución |
|---|---|---|
Could not load 'plugins/X.jar' |
Plugin incompatible con el motor o con la versión | descarga la versión adecuada para tu servidor |
UnsupportedClassVersionError |
El complemento requiere una versión más reciente de Java | cambia la versión de Java o descarga una edición anterior del complemento |
NoClassDefFoundError |
Falta una dependencia | instala el plugin requerido |
Missing dependency / requires |
El mod necesita otro mod | añade el que falta, por ejemplo, Fabric API |
Incompatible mod set! |
Desajuste de mods entre cliente y servidor | iguala las listas de mods |
Duplicate mod |
Dos versiones del mismo mod | elimina el archivo más antiguo |
is not compatible with this server version |
Versión del juego incorrecta | descarga la edición para tu versión |
#Paso 1: Identifica al culpable en el registro
En la pestaña Registros, filtra por ERROR y luego por Caused by. El nombre del archivo suele aparecer entre comillas o corchetes:
[ERROR]: Could not load 'plugins/PluginAntiguo.jar' in folder 'plugins'
Caused by: java.lang.UnsupportedClassVersionError: pl/example/MainEn los mods, fíjate en el paquete de la primera línea at ...: com.example.mod indica el autor y normalmente el nombre del mod.
#Paso 2: Elimina el complemento
- Detén el servidor con el botón Detener.
- En la pestaña Archivos, entra en
/pluginso/mods. - Elimina el
.jarindicado con el botón Eliminar. - Inicia el servidor y comprueba que aparece
Done.
#Paso 3: Cuando el registro no señala al culpable - método de bisección
Si tienes treinta mods y los compruebas uno a uno, son treinta reinicios. Con la bisección, bastan cinco.
- Crea la carpeta
mods-off(oplugins-off) con el botón Crear carpeta. - Mueve a ella la mitad de los complementos (selecciónalos y usa Mover).
- Inicia el servidor.
- Arranca: el culpable está en la mitad que has movido.
- No arranca: el culpable sigue en la carpeta activa.
- Toma la mitad sospechosa y divídela otra vez por la mitad. Repite el proceso.
Con 32 complementos bastan 5 iteraciones.
No elimines los complementos de inmediato: muévelos. La carpeta de configuración (por ejemplo, /plugins/EssentialsX/) se queda en su sitio, así que al devolver el archivo no pierdes los ajustes.
#Paso 4: Dependencias
Algunos complementos no funcionan por sí solos:
| Complemento | Requiere |
|---|---|
| WorldGuard | WorldEdit |
| Mods de Fabric | Fabric API |
| Plugins de economía | Vault |
| Muchos plugins de permisos | LuckPerms |
Las dependencias que faltan aparecen indicadas explícitamente en el registro de inicio: merece la pena revisarlo completo, incluso si el servidor ha arrancado.
#Paso 5: Compatibilidad del motor
Un plugin de Bukkit/Spigot/Paper no funciona en Forge ni en Fabric. Un mod de Forge no funciona en Fabric y viceversa. Colocar un archivo en un motor que no le corresponde impide arrancar el servidor. Comprueba el tipo de motor en la pestaña Motores antes de descargar un complemento.
#Problemas frecuentes
#He eliminado un mod, pero el servidor sigue sin arrancar
En el registro hay otro error: el primero tapaba a los siguientes. Repite el diagnóstico desde el principio.
#El servidor arranca, pero el plugin no funciona
Se ha cargado con una advertencia o le falta una dependencia. Busca su nombre en el registro de inicio y escribe plugins en la consola para ver su estado.
#Tras actualizar un mod ha desaparecido la configuración
La nueva versión ha reconstruido los archivos. Recupera los ajustes desde una copia de seguridad: por eso la copia previa a una actualización no es opcional.
#Duplicate mod aunque solo hay un archivo
Hay una segunda copia en una subcarpeta de /mods o el modpack la incluye dentro de su paquete. Revisa el directorio de forma recursiva.
#El mod funciona en el cliente, pero no en el servidor
Has descargado la edición de cliente. Comprueba en la página del mod si tiene versión para servidor: no todos la tienen.