Muchos plugins y mods se basan en otros: un plugin de tienda necesita Vault y un plugin de economía, un plugin de menús necesita PlaceholderAPI, un mod de Fabric necesita Fabric API. Si falta esa base, es demasiado antigua o ella misma no arranca, el plugin dependiente se desactiva total o parcialmente. En la mayoría de los casos el servidor sigue funcionando, solo faltan las funciones del plugin afectado.

Cada sección de abajo trata un mensaje. Encontrarás el mensaje completo en la Consola o en Archivos, dentro de logs/latest.log. Lee también las líneas anteriores, ya que a menudo indican qué plugin falló primero. Antes de cambiar plugins o modificar archivos de configuración, crea una copia en Copias de seguridad. Después de cada cambio, reinicia el servidor por completo en lugar de usar /reload, para que todos los plugins se carguen en el orden correcto.

Falta una clase: NoClassDefFoundError y ClassNotFoundException

Así se ve el mensaje:

java.lang.NoClassDefFoundError: org/cloudburstmc/math/GenericMath
	at <Plugin>.jar//org.cloudburstmc.math.vector.Vector3i.from(Vector3i.java:403)
Caused by: java.lang.ClassNotFoundException: <Paquete>.<Clase>

Qué hay detrás: Los plugins y mods para servidores Java se componen de muchas clases, que son los bloques individuales del programa. El mensaje dice: un plugin o mod quiere usar un bloque que no existe en el servidor. Normalmente falta otro mod u otro plugin, o está instalado en una versión que no contiene ese bloque o que ya no lo contiene. El resto del servidor suele seguir funcionando, solo falla la función afectada.

Así lo solucionas:

  1. Averigua quién lanza el error. Lo revela el nombre del plugin después de to en la línea "Could not pass event … to …" o el nombre del archivo antes de .jar// en el stacktrace, es decir, en las líneas at … debajo del mensaje.
  2. Lee la ruta de la clase que falta. Su comienzo suele indicar el proyecto al que pertenece, por ejemplo org/geysermc para Geyser.
  3. En la página del plugin o mod afectado, compara las dependencias y versiones requeridas con tus Plugins o Mods instalados.
  4. Instala las dependencias que falten o pon todos los componentes implicados en versiones compatibles entre sí. Después reinicia el servidor.

Conviene saber: Si se sustituyó un archivo de plugin con el servidor en marcha, a menudo el plugin ya no encuentra sus propias clases. En ese caso basta con un reinicio completo.

Un comando no funciona porque su plugin está desactivado

Así se ve el mensaje:

Unexpected exception while parsing console command "<Comando>"
org.bukkit.command.CommandException: Cannot execute command '<Comando>' in plugin <Plugin> v<Versión> - plugin is disabled.

Qué hay detrás: El comando en sí no es incorrecto. Pertenece a un plugin que no se pudo activar al iniciar el servidor, y por eso el servidor responde con este error cada vez que lo ejecutas. El motivo real lo escribe el servidor más arriba en el log durante el inicio, a menudo "unsupported server version": la versión del plugin no es compatible con la versión de tu servidor. Si el plugin reemplaza comandos básicos como list, como hace EssentialsX, estos también dejan de funcionar.

Así lo solucionas:

  1. En Archivos, abre el archivo logs/latest.log y busca el nombre del plugin del mensaje. Lo importante son las líneas de la fase de inicio, por ejemplo "Error occurred while enabling …".
  2. Escribe plugins en la Consola. Los plugins desactivados aparecen en rojo.
  3. Soluciona el error de inicio. Normalmente se trata de instalar en Plugins una versión que sea compatible con la versión de tu servidor. La versión de tu servidor la ves en Versión. Más información: El plugin no es compatible con la versión del servidor.
  4. Reinicia el servidor y comprueba con plugins si el plugin aparece ahora en verde.

Conviene saber: El mensaje del comando es solo una consecuencia. Desaparece en cuanto el plugin vuelve a iniciarse.

Falta Vault o un plugin de economía

Así se ve el mensaje:

[<Plugin>] Vault economy not found! Disabling plugin...
[<Plugin>] - Disabled due to no Vault dependency found!

Qué hay detrás: Los plugins con dinero, precios o recompensas no gestionan el saldo por sí mismos. Acceden a un plugin de economía a través de Vault. Vault es solo la interfaz; las cuentas las gestiona el plugin de economía. Si falta uno de los dos o se cargó después del plugin que depende de él, este se desactiva. El servidor sigue funcionando, pero el plugin afectado falta por completo.

Así lo solucionas:

  1. Comprueba en Plugins si Vault está instalado.
  2. Comprueba si hay instalado un plugin de economía compatible con Vault, por ejemplo EssentialsX con EssentialsX Economy, CMI o XConomy.
  3. Instala lo que falte, siempre en una versión para la versión de tu servidor.
  4. Reinicia el servidor por completo. Un /reload o recargar plugins individuales altera fácilmente el orden de carga.
  5. Escribe vault-info en la Consola. Junto a "Economy" debería aparecer ahora tu plugin de economía.

Conviene saber: El mensaje también aparece cuando Vault está presente, pero el propio plugin de economía falla al iniciarse. En ese caso, busca su nombre en logs/latest.log.

Un plugin no puede registrar partes porque falta otro plugin

Así se ve el mensaje:

[<Plugin>] Failed to register events for class <Clase> because me/clip/placeholderapi/<Clase> does not exist.
[QuickShop-FindItemAddOn] Uh oh! Looks like either this plugin has crashed or you don't have QuickShop-Hikari installed.

Qué hay detrás: Un plugin registra sus listeners al iniciarse, es decir, las partes que reaccionan a eventos como entrar, romper o comprar. Algunas de ellas requieren otro plugin. Si falta, justo esas partes no se registran y el resto del plugin funciona. Qué plugin falta lo revela la ruta después de because:

  • me/clip/placeholderapi pertenece a PlaceholderAPI
  • net/milkbowl/vault pertenece a Vault
  • com/ghostchu/quickshop pertenece a QuickShop-Hikari
  • net/ess3 pertenece a EssentialsX

Así lo solucionas:

  1. Asocia la ruta del mensaje a un plugin con la lista de arriba. En otras rutas ayuda el nombre del proyecto que aparece en la ruta, por ejemplo com/projectkorra para ProjectKorra.
  2. Instala el plugin que falta en Plugins, en una versión para la versión de tu servidor.
  3. Reinicia el servidor y comprueba que el mensaje ya no aparece al iniciar.

Conviene saber: Si la ruta empieza por io/papermc o org/bukkit, no falta ningún plugin. Entonces el software de tu servidor es demasiado antiguo para el plugin o estás usando el software equivocado, por ejemplo Spigot en lugar de Paper. Ayuda al respecto: El plugin no es compatible con la versión del servidor.

Un plugin no puede conectarse con otro plugin

Así se ve el mensaje:

[<Plugin>] Could not hook into PlaceholderAPI!
<Plugin> will now disable!

Qué hay detrás: "Hook" significa aquí conexión. El plugin que informa quería conectarse al iniciarse con otro plugin que necesita para funcionar. Pero ese faltaba o todavía no estaba cargado en ese momento. Muchos plugins se desactivan solos por ello. El servidor sigue funcionando con normalidad, pero las funciones del plugin que informa faltan por completo; en un plugin de menús, por ejemplo, todos los menús.

Así lo solucionas:

  1. Lee ambos nombres en el mensaje: entre corchetes el plugin que informa y después de "hook into" el que echa en falta.
  2. Si el plugin que falta no está en Plugins, instálalo en una versión para la versión de tu servidor. Muy a menudo es PlaceholderAPI.
  3. Si ya está instalado, busca su nombre en logs/latest.log. Si lanza un error al iniciarse, esa es la causa real. Soluciona primero ese error.
  4. Reinicia el servidor por completo.

Conviene saber: No tienes que reinstalar el plugin que informa. Vuelve a funcionar en cuanto la dependencia esté disponible al iniciar.

ViaBackwards se desactiva porque ViaVersion es demasiado antiguo

Así se ve el mensaje:

[ViaBackwards] YOUR VIAVERSION IS OUTDATED
[ViaBackwards] VIABACKWARDS WILL NOW DISABLE

Qué hay detrás: ViaVersion permite que jugadores con versiones más nuevas de Minecraft entren en tu servidor; ViaBackwards lo amplía a versiones más antiguas. ViaBackwards es una extensión de ViaVersion y requiere una build de ViaVersion compatible y suficientemente reciente. Si ViaVersion es más antiguo, ViaBackwards se desactiva. El servidor sigue funcionando, pero los jugadores con clientes más antiguos ya no pueden entrar.

Así lo solucionas:

  1. Mira en Plugins qué versiones de ViaVersion y ViaBackwards están instaladas.
  2. Actualiza ambos a la vez a builds actuales que sean compatibles entre sí. El propio mensaje indica la página de descarga oficial. Si además usas ViaRewind, actualízalo en el mismo paso.
  3. Reinicia el servidor y comprueba con plugins en la Consola si ViaBackwards aparece en verde.

Conviene saber: Actualiza siempre los plugins Via juntos. Quien solo renueva ViaBackwards acaba justo con este mensaje.

Más detalles: Configurar ViaVersion: conectar clientes más antiguos y más nuevos

UltimateDonutSmp se desactiva sin PlaceholderAPI

Así se ve el mensaje:

[UltimateDonutSmp] UltimateDonutSmp requires PlaceholderAPI
[UltimateDonutSmp] UltimateDonutSmp is disabling itself to prevent broken sidebar output.

Qué hay detrás: UltimateDonutSmp muestra valores en la sidebar, el panel en el lado derecho de la pantalla. Esos valores llegan mediante marcadores de posición, pequeñas variables como %player_name%, que PlaceholderAPI rellena con valores reales. Si falta PlaceholderAPI o está desactivado, UltimateDonutSmp se desactiva a propósito para que los jugadores no vean marcadores rotos. El servidor en sí sigue funcionando con normalidad.

Cómo solucionarlo:

  1. Instala PlaceholderAPI en Plugins en una versión compatible con la versión de tu servidor.
  2. Si ya está instalado, comprueba en logs/latest.log si da algún error al iniciar y soluciona ese error primero.
  3. Detén el servidor y vuelve a iniciarlo después. Recargar con un comando no es suficiente aquí.

Conviene saber: Si después la sidebar muestra texto como %vault_eco_balance% en lugar de números, falta una extensión de PlaceholderAPI. La descargas en la Consola con papi ecloud download <Extensión> y la aplicas con papi reload.

Un plugin necesario no está instalado

Así se ve el mensaje:

[<Plugin>] <Dependencia> is required but was not found
[<Plugin>] <Dependencia> plugin not found! Disabling
[<Plugin>] Download <Dependencia> from https://<Dirección>

Qué hay detrás: El plugin se basa en otro plugin y no lo encuentra al iniciar. El propio mensaje indica el nombre de esa base, a veces incluso con la dirección de descarga. Según el plugin, se desactiva por completo o una parte de él no funciona. El mensaje también aparece cuando la base está como archivo en la carpeta plugins, pero ella misma no arranca.

Cómo solucionarlo:

  1. Anota el nombre de la base que falta según el mensaje.
  2. Comprueba en Plugins si está instalada. Si no, instálala en una versión que encaje con la versión de tu servidor. Cómo hacerlo: Instalar y gestionar plugins.
  3. Si está instalada, busca su nombre en logs/latest.log. Un error al iniciar es entonces la verdadera causa.
  4. Reinicia el servidor.

Conviene saber: Si ya no necesitas el plugin que muestra el mensaje, puedes eliminarlo en su lugar. Entonces el mensaje desaparece también.

Un plugin no encuentra un sistema de economía

Así se ve el mensaje:

[<Plugin>] Vault economy provider not found!
[<Plugin>] Vault is not found or no economy plugin found

Qué hay detrás: Para dinero, precios y recompensas, el plugin necesita dos socios: Vault o VaultUnlocked como interfaz y un plugin de economía como EssentialsX, que lleva los saldos. Si no encuentra ambos, se desactiva o no concede recompensas de dinero. Consecuencias típicas: un plugin de tiendas como QuickShop no arranca bien, un plugin de misiones avisa de que no puede pagar una recompensa.

Cómo solucionarlo:

  1. Comprueba en Plugins si Vault o VaultUnlocked está instalado.
  2. Comprueba si hay un plugin de economía en funcionamiento, por ejemplo EssentialsX. Sin un plugin así, Vault no tiene nada que transmitir.
  3. Instala lo que falte, en versiones para la versión de tu servidor, y reinicia el servidor.
  4. Con Vault, comprueba con vault-info en la Consola si detrás de «Economy» aparece un plugin de economía.

Conviene saber: Cómo configurar EssentialsX está en Configurar EssentialsX.

El plugin de recompensas Bountys no encuentra Vault

Así se ve el mensaje:

[Bountys] Vault Plugin wasn't detected!

Qué hay detrás: Bountys paga las recompensas a través de Vault y, para ello, normalmente necesita además un plugin de economía que lleve los saldos. Al iniciar no se encontró Vault. Por eso las funciones de dinero de Bountys no funcionan y las recompensas no se pueden pagar. El servidor en sí y otros plugins no se ven afectados.

Cómo solucionarlo:

  1. Decide si necesitas Bountys. Si no, elimínalo en Plugins y el mensaje desaparecerá.
  2. Si quieres conservarlo, coloca Vault y un plugin de economía compatible como EssentialsX en la carpeta de plugins, lo más sencillo a través de Plugins.
  3. Si Vault ya está ahí, comprueba en logs/latest.log si Vault mismo informa de un error al iniciar.
  4. Reinicia el servidor y comprueba con vault-info en la Consola si Vault ha encontrado un plugin de economía.

Conviene saber: Si otros plugins avisan de que falta Vault o una economía, solucionas todos los mensajes con el mismo paso.

AuthMe no encuentra un plugin de permisos a través de Vault

Así se ve el mensaje:

[AuthMe] Error while hooking into Vault [PermissionHandlerException]: Could not load permissions provider service

Qué hay detrás: AuthMe es un plugin de inicio de sesión en el que los jugadores se identifican con una contraseña. Para sus funciones de grupos y permisos consulta a través de Vault un servicio de permisos, es decir, un plugin de permisos. Vault está instalado, pero no ofrece a AuthMe ningún servicio de ese tipo. Por eso fallan las funciones de grupos y permisos de AuthMe. El mensaje solo afecta a estas funciones adicionales.

Cómo solucionarlo:

  1. Instala en Plugins LuckPerms u otro plugin de permisos con conexión a Vault.
  2. Actualiza Vault y AuthMe a versiones para la versión de tu servidor.
  3. Reinicia el servidor.
  4. Escribe vault-info en la Consola. Detrás de «Permission» debería aparecer ahora tu plugin de permisos.

Conviene saber: Cómo crear grupos y permisos lo muestra Configurar LuckPerms.

StackSpawners necesita DecentHolograms

Así se ve el mensaje:

[StackSpawners] DecentHolograms was not found. The plugin will not work

Qué hay detrás: StackSpawners agrupa spawners y usa el plugin DecentHolograms para sus indicadores flotantes, llamados hologramas. No incluye esa función por sí mismo. Si StackSpawners no encuentra DecentHolograms al iniciar, no puede funcionar. El servidor sigue funcionando, pero faltan las funciones de StackSpawners.

Cómo solucionarlo:

  1. Instala DecentHolograms en Plugins en una versión que encaje con la versión de tu servidor y con StackSpawners. La página del plugin StackSpawners indica las versiones compatibles.
  2. Si DecentHolograms ya está ahí, busca en logs/latest.log un error de inicio de DecentHolograms y soluciónalo primero.
  3. Detén el servidor por completo y vuelve a iniciarlo. Así ambos plugins se cargan en el orden correcto.

Conviene saber: Si ya no usas StackSpawners, elimínalo. Entonces también desaparece la dependencia.

LightAntiCheat-Plus no encuentra PacketEvents

Así se ve el mensaje:

(LightAntiCheat-Plus) Failed to start listener-mode … com/github/retrooper/packetevents/event/PacketListenerCommon

Qué hay detrás: LightAntiCheat-Plus es un plugin anticheat. Lee el tráfico de datos de los jugadores a través de PacketEvents, un plugin independiente que prepara los paquetes de red para otros plugins. Si falta PacketEvents o está instalado en una versión que LightAntiCheat-Plus no espera, su supervisión no arranca. El servidor sigue funcionando, pero la protección contra cheats queda desactivada total o parcialmente.

Así lo solucionas:

  1. Consulta en la página de LightAntiCheat-Plus qué versión de PacketEvents necesita.
  2. Instala o actualiza PacketEvents en Plugins a esa versión, acorde a la versión de tu servidor.
  3. Si hace falta, actualiza también LightAntiCheat-Plus para que ambos sean compatibles.
  4. Detén el servidor por completo y vuelve a iniciarlo.

Conviene saber: Otros plugins también suelen usar PacketEvents. Tras el cambio, comprueba en logs/latest.log que sigan arrancando sin errores.

Un plugin se ha desactivado solo tras un error

Así se ve el mensaje:

[<Plugin>] An unexpected error occurred, disabling the plugin
[<Plugin>] Cannot enable plugin: <Motivo>

Qué hay detrás: El plugin ha encontrado un error al iniciarse o durante el funcionamiento y por eso se ha desactivado solo. Hasta el siguiente reinicio faltan todas sus funciones y sus comandos solo responden con un mensaje de error. El plugin afectado aparece entre corchetes. La causa suele estar en las líneas anteriores, a veces en otro idioma según el origen del plugin.

Así lo solucionas:

  1. Abre logs/latest.log y lee las líneas justo antes del mensaje. Normalmente se aprecia si falta un plugin, si la versión no es adecuada o si hay un error en la configuración.
  2. Actualiza el plugin y comprueba en su página si es compatible con la versión de tu servidor.
  3. Si el error persiste, quita el plugin como prueba y reinicia. Si todo funciona sin él, informa del error al autor del plugin y adjunta las líneas del log.

Conviene saber: Los errores durante el funcionamiento los clasificas con El plugin genera errores durante el funcionamiento.

AuthMeBia no es compatible con tu versión de AuthMe

Así se ve el mensaje:

[AuthMeBia] AuthMe DataSource reflection unavailable; premium skip and session autologin both disabled

Qué hay detrás: AuthMeBia es una extensión para el plugin de inicio de sesión AuthMe. Accede a una función interna de AuthMe que no existe así en tu versión de AuthMe. Por eso AuthMeBia desactiva dos funciones: el Premium-Skip, con el que los jugadores con una cuenta de Minecraft comprada entran sin contraseña, y el Session-Autologin, el inicio de sesión automático cuando alguien vuelve a entrar poco después de salir. AuthMe en sí sigue funcionando y los jugadores inician sesión con contraseña como de costumbre.

Así lo solucionas:

  1. Mira en Plugins qué versiones de AuthMe y AuthMeBia están instaladas.
  2. Comprueba en la página de AuthMeBia para qué versión de AuthMe está compilada.
  3. Actualiza ambos a versiones compatibles entre sí y reinicia el servidor.
  4. Prueba con una cuenta comprada si la entrada sin contraseña vuelve a funcionar.

Una extensión de ProjectKorra no es compatible con la versión principal

Así se ve el mensaje:

java.lang.NoSuchMethodError: 'void com.projectkorra.projectkorra.<Clase>.<Método>()'
com.jedk1.jedcore.ability.<Habilidad>@<Identificador>[…]

Qué hay detrás: ProjectKorra añade habilidades de bending al servidor y extensiones como JedCore incorporan más. Cada extensión está compilada para una versión concreta de ProjectKorra. Si llama a un método, es decir, una función que no existe en tu versión de ProjectKorra, se interrumpe con «NoSuchMethodError». A veces, además, escribe el estado de una habilidad como una línea larga en el log. Las habilidades afectadas no funcionan, el resto del servidor sigue en marcha.

Así lo solucionas:

  1. Anota en Plugins la versión de ProjectKorra y las versiones de todas las extensiones.
  2. Abre la página de descarga de cada extensión. Allí figura qué versión de ProjectKorra necesita.
  3. Instala ProjectKorra y todas las extensiones en versiones compatibles entre sí y con la versión de tu servidor.
  4. Reinicia el servidor y prueba una habilidad de la extensión.

Conviene saber: Si no existe una extensión para tu versión de ProjectKorra, es mejor quitarla que mezclar versiones antiguas y nuevas.

AppleSkin no arranca porque falta Fabric API

Así se ve el mensaje:

Mod 'AppleSkin' (appleskin) <Versión> requires any version of fabric-api, which is missing!

Qué hay detrás: La mayoría de los mods de Fabric necesitan la biblioteca Fabric API, una colección de componentes comunes que no está incluida en el propio Fabric Loader. AppleSkin está instalado, pero Fabric API no. El Fabric Loader lo comprueba al arrancar y cancela el inicio. Tu servidor no volverá a arrancar hasta que añadas Fabric API o desactives AppleSkin.

Así lo solucionas:

  1. Instala en Mods la Fabric API en la versión para tu versión de Minecraft.
  2. Si no necesitas AppleSkin, usa en su lugar el botón de reparación junto al mensaje en Salud del servidor. Desactiva AppleSkin (el archivo se conserva) y reinicia el servidor.
  3. Comprueba en la Consola que el servidor arranca por completo.

Conviene saber: Fabric API debe ser compatible con tu versión de Minecraft. El mensaje dice «any version», así que AppleSkin en sí no exige ninguna versión concreta.

Más detalles: Fabric Loader y Fabric API: resolver errores de versión de forma precisa

¿Tu mensaje no aparece aquí?

Lee el mensaje completo en logs/latest.log, incluidas las líneas anteriores. Normalmente el servidor menciona primero el plugin que falló y solo después los errores derivados de otros plugins. En el stacktrace, los nombres de archivo antes de .jar y los nombres de carpeta en la ruta de clases, por ejemplo me/clip/placeholderapi, te indican qué plugin o mod está implicado. Después compara las dependencias de la página del proyecto con tus plugins instalados. Crea una copia de seguridad antes de cada cambio importante. Si no avanzas, abre un ticket e indica la hora del mensaje.