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.

NoClassDefFoundError y ClassNotFoundException: Falta una clase

Así se ve el mensaje:

java.lang.NoClassDefFoundError: org/geysermc/geyser/network/bedrock/nethernet/NetherNetServer
java.lang.NoClassDefFoundError: org/cloudburstmc/protocol/bedrock/data/MovementEffectType
Error loading class: org/jetbrains/annotations/ApiStatus$ScheduledForRemoval (java.lang.ClassNotFoundException: org.jetbrains.annotations.ApiStatus$ScheduledForRemoval)

Qué hay detrás: los plugins y los mods se componen de clases, los bloques individuales del programa. Falta un bloque necesario: normalmente falta una dependencia o su versión no coincide. También puede verse afectada una biblioteca que el propio plugin incluye; los ejemplos lo muestran con Geyser. El resto del servidor normalmente sigue funcionando mientras la función afectada deja de funcionar; si el error aparece durante el inicio, este también puede fallar.

Así lo solucionas:

  1. Busca en las líneas alrededor del mensaje el plugin o mod afectado. El nombre del archivo antes de .jar// en el stacktrace, la lista de llamadas bajo el error, ayuda a identificarlo; en el caso de los mods, también las líneas de carga anteriores.
  2. Compara en la página del proyecto las dependencias y versiones requeridas con tus Plugins o Mods instalados.
  3. Detén el servidor, instala las dependencias que falten o sustituye los archivos afectados por versiones que sean compatibles entre sí.
  4. Reinicia por completo y revisa de nuevo la Consola.

Conviene saber: sustituye los archivos de plugins y mods con el servidor detenido. Si se reemplazaron archivos con el servidor en marcha, vuelve a cargarlos con un reinicio completo.

„Cannot execute command … plugin is disabled“: el comando del plugin está desactivado

Así se ve el mensaje:

Unexpected exception while parsing console command "<Command>"
org.bukkit.command.CommandException: Cannot execute command '<Command>' in plugin <Plugin> v<Version> - plugin is disabled.
[Essentials] Cannot execute command '<Command>' in plugin <Plugin> v<Version> - plugin is disabled.

Qué hay detrás: El comando pertenece a un plugin que no se pudo activar al iniciar el servidor. El motivo real aparece más arriba en el registro de inicio, a menudo „unsupported server version“: la versión del plugin no coincide con la versión del servidor. Lo que cuenta es el nombre que aparece después de „in plugin“, aunque al principio ponga „Essentials“. Si el plugin desactivado sustituye comandos básicos como list, estos también dejan de funcionar. El servidor en sí sigue funcionando.

Así lo solucionas:

  1. Abre logs/latest.log en Archivos y busca el nombre del plugin que aparece después de „in plugin“. Lee los mensajes de inicio, por ejemplo „Error occurred while enabling …“.
  2. Escribe plugins en la Consola. Los plugins desactivados aparecen allí en rojo.
  3. Soluciona el error de inicio. Comprueba la versión del servidor en Versión e instala en Plugins una versión del plugin compatible. Detén el servidor antes de sustituirlo. Más información: El plugin no es compatible con la versión del servidor.
  4. Reinicia y comprueba con plugins si el plugin aparece en verde. Después prueba el comando.

Bueno saber: El mensaje del comando es consecuencia del error de inicio. Desaparece en cuanto el plugin vuelve a arrancar.

«Vault economy not found»: falta la conexión de Vault con 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!
[<Plugin>] java.lang.IllegalStateException: Found Vault but no economy, please check whether your economy plugin supports Vault.

Qué hay detrás: El plugin afectado accede a un plugin de economía a través de Vault para gestionar dinero, precios o recompensas. Vault solo es 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 su función de economía integrada, CMI o XConomy.
  3. Instala lo que falte, en cada caso en una versión adecuada 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. Introduce vault-info en la Consola. Junto a «Economy» debería aparecer ahora tu plugin de economía.

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

«Failed to register events»: falta un plugin necesario o una parte del programa del servidor

Así se ve el mensaje:

[<Plugin>] Failed to register events for class <Class> because com/vexsoftware/votifier/model/VotifierEvent does not exist.
[<Plugin>] Failed to register events for class <Class> because com/projectkorra/projectkorra/event/BendingPlayerCreationEvent does not exist.
[<Plugin>] Failed to register events for class <Class> because io/papermc/paper/event/player/AsyncPlayerSpawnLocationEvent does not exist.

Qué hay detrás: Un plugin no puede registrar listeners, es decir, funciones para eventos del juego, porque falta una clase necesaria. Las clases son partes del programa que aquí suele proporcionar otro plugin. Las funciones afectadas no estarán disponibles; otras funciones del servidor pueden seguir funcionando. La ruta que aparece después de because ayuda a identificarlo:

  • me/clip/placeholderapi: PlaceholderAPI; net/milkbowl/vault: Vault.
  • com/ghostchu/quickshop: QuickShop-Hikari; net/ess3: EssentialsX.
  • com/vexsoftware/votifier: Votifier; com/projectkorra: ProjectKorra.

Cómo solucionarlo:

  1. Asocia la ruta indicada con el plugin necesario y revisa sus requisitos.
  2. Si falta, instálalo en Plugins en una versión que coincida con la versión del servidor. Si ya está instalado, busca en logs/latest.log errores de inicio propios de ese plugin y soluciónalos primero.
  3. Si aparece io/papermc o org/bukkit, comprueba en su lugar qué software de servidor y qué versión admite el plugin que muestra el aviso. Elige una combinación que encaje.
  4. Reinicia y revisa la Consola.

Bueno saberlo: Que falten clases del servidor puede indicar que el software del servidor es otro o que su versión no es la adecuada. El plugin no encaja con la versión del servidor.

«Could not hook into …»: falta un plugin necesario o no está cargado

Así se ve el mensaje:

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

Qué hay detrás: «Hook» significa aquí enlace o conexión. El plugin que muestra el aviso quería conectarse al arrancar con otro plugin que necesita para funcionar. Pero este faltaba o aún 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 avisa faltan por completo; en un plugin de menús, por ejemplo, todos los menús.

Cómo solucionarlo:

  1. Lee los dos nombres del mensaje: entre corchetes, el plugin que avisa; 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 da un error por sí mismo al arrancar, esa es la verdadera causa. Soluciona primero ese error.
  4. Reinicia el servidor por completo.

Bueno saberlo: No necesitas reinstalar el plugin que avisa. Volverá a funcionar en cuanto la dependencia esté disponible al arrancar.

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.

„The plugin is disabling itself“: plugin desactivado tras un error

Así se ve el mensaje:

[<Plugin>] The plugin is disabling itself.
[<Plugin>] [<Plugin>] Disabling plugin...
[<Plugin>] [PacketEvents] Nie udało się uruchomić systemu pakietowego kostiumów po <Count> próbach.

Qué hay detrás: Si un plugin informa de que se desactiva tras un error, sus funciones no estarán disponibles hasta el próximo inicio correcto. El servidor de Minecraft sigue funcionando. La línea polaca de PacketEvents menciona un sistema de disfraces que no pudo iniciarse tras varios intentos; los mensajes de desactivación adicionales muestran si falla el plugin completo. La causa real suele aparecer en las líneas anteriores, a veces en otro idioma.

Cómo solucionarlo:

  1. Abre logs/latest.log en Archivos y lee las líneas anteriores al mensaje. Busca indicios de dependencias que faltan, versiones incompatibles o errores de configuración.
  2. Actualiza el plugin afectado y comprueba en su página si es compatible con la versión de tu servidor y si necesita otros plugins.
  3. Reinicia el servidor y comprueba en la Consola si el plugin y la función afectada se inician.
  4. Si el error persiste, haz una copia de seguridad de la carpeta de plugins, retira el plugin como prueba y reinicia. Informa del error al autor del plugin con líneas de registro anonimizadas.

Bueno saber: Los errores durante el funcionamiento los puedes clasificar con El plugin lanza 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

La consulta del saldo falla porque EssentialsX aún no está listo

Así se ve el mensaje:

[ajLeaderboards] Placeholder <Placeholder> for player <Player> threw an error:
Essentials API is called before Essentials is loaded.

Qué hay detrás: Un marcador de posición es un atajo de texto que se sustituye por un valor, como el saldo de la cuenta. Aquí la consulta falla en EssentialsX, cuya interfaz de economía no está disponible en este momento. Por ello, el valor de la clasificación no se puede actualizar. El servidor sigue funcionando.

Cómo solucionarlo:

  1. Comprueba en la Consola si el mensaje aparece al iniciar, al detener o durante el funcionamiento.
  2. Lee los errores de inicio anteriores de EssentialsX. Soluciona primero esos si el plugin no se cargó correctamente.
  3. Revisa en Plugins EssentialsX, Vault, PlaceholderAPI y ajLeaderboards, así como la extensión de Vault instalada. Usa versiones que sean compatibles entre sí.
  4. Detén el servidor antes de reemplazar archivos y luego reinícialo por completo. Vuelve a comprobar la clasificación cuando el inicio haya terminado.

¿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.