En Paper y Spigot, un plugin es un único archivo JAR (un archivo Java) en la carpeta plugins. Si este archivo está dañado, vacío, duplicado o en realidad es un mod o una biblioteca, el servidor no carga el plugin o se bloquea al iniciar. Cada sección de abajo trata uno de estos mensajes. Con «Más información» en Salud del servidor llegas directamente a la sección correspondiente.

El texto completo lo encuentras en la Consola o en Archivos dentro de logs/latest.log. Lo más importante suelen ser las líneas justo debajo del mensaje, ya que ahí está el motivo real. Sustituye los archivos de plugin solo con el servidor detenido. Antes, crea una copia en Copias de seguridad, sobre todo si también podrían verse afectados archivos del mundo o de configuración.

El plugin falla al activarse («Error occurred while enabling»)

Así se ve el mensaje:

Error occurred while enabling <Plugin> v<Versión> (Is it up to date?)
java.lang.NoSuchMethodError: '<Método>'
    at <Plugin>-<Versión>.jar//<Paquete>.onEnable(…)

Qué hay detrás: El servidor cargó el plugin, pero al activarlo falló y se desactivó a sí mismo. El servidor sigue funcionando con normalidad, pero la función de este plugin falta por completo: sin comandos, sin menús, sin permisos, y en el juego no aparece ningún otro mensaje de error. Si es un plugin de protección, permisos o inicio de sesión, esa protección no existe hasta que corrijas el error. Normalmente el plugin no es compatible con otra versión del servidor o de otro plugin distinta de la instalada.

Cómo solucionarlo:

  1. La línea de error indica el plugin y la versión. Comprueba en la página del plugin si hay una versión para la versión de tu servidor y actualiza el plugin.
  2. Si debajo aparece NoSuchMethodError o NoClassDefFoundError con el nombre de otro plugin, esas dos versiones de plugin no son compatibles entre sí. Lleva una de ellas a una versión compatible.
  3. Si debajo aparece un error de base de datos como Communications link failure, el plugin no puede acceder a su base de datos. Revisa los datos de acceso en su configuración y en Bases de datos.
  4. Reinicia el servidor y revisa la Consola.

Conviene saber: El mismo mensaje con «disabling» al detener el servidor suele ser solo una consecuencia del error de inicio. Más sobre conflictos de versiones: El plugin no es compatible con la versión del servidor.

Se omite el archivo del plugin («Could not load 'plugins/…jar'»)

Así se ve el mensaje:

[ModernPluginLoadingStrategy] Could not load 'plugins/<Plugin>.jar' in 'plugins'
org.bukkit.plugin.UnknownDependencyException: Unknown/missing dependency plugins: [ProtocolLib]. Please download and install these plugins to run '<Plugin>'.

Qué hay detrás: El servidor no pudo cargar el JAR indicado como plugin y lo omite. Un JAR (archivo Java) es el archivo en el que se encuentra un plugin. El resto del servidor puede seguir funcionando, pero este plugin falta por completo. La causa es un archivo dañado o no válido, o un JAR sin un plugin.yml legible, el archivo de descripción por el que el servidor reconoce un plugin. Con «Failed to run bootstrapper», un plugin de Paper ha fallado en la fase más temprana del inicio.

Cómo solucionarlo:

  1. Lee la línea que aparece debajo del mensaje. Si ahí figura UnknownDependencyException, falta otro plugin: instala el plugin que aparece entre corchetes.
  2. En caso contrario, detén el servidor y elimina el JAR afectado en Archivos, dentro de la carpeta plugins.
  3. Descarga una versión de una fuente de confianza que coincida con tu tipo de servidor (Paper, Spigot) y con tu versión de Minecraft, y súbela.
  4. Reinicia el servidor.

Conviene saber: Si la ruta apunta a plugins/.paper-remapped, es una copia que Paper crea para los plugins de Spigot. Sustituye el JAR original en plugins; Paper volverá a generar la copia en el siguiente inicio. Sobre plugins que faltan: El plugin necesita otro plugin.

El plugin falla ya al inicializarse («Is it up to date?»)

Así se ve el mensaje:

[<Plugin>] Error initializing plugin '<Plugin>-<Versión>.jar' in folder 'plugins' (Is it up to date?)
java.lang.ExceptionInInitializerError

Qué hay detrás: El plugin falló mientras el servidor lo preparaba, es decir, antes incluso de activarse. Permanece desactivado, sus comandos y funciones no están disponibles y el servidor sigue funcionando sin él. Casi siempre la versión del plugin no coincide con la versión del servidor. La línea de error de debajo suele indicar la versión o una clase que falta, es decir, una parte del programa que el plugin espera encontrar en el servidor.

Cómo solucionarlo:

  1. Instala la versión del plugin pensada para tu versión del servidor o actualiza el plugin. La página del plugin indica las versiones compatibles.
  2. Si todavía no hay una versión adecuada para tu versión del servidor, espera a una actualización del plugin o, en Versión, quédate por ahora en una versión compatible.
  3. Si eso no ayuda, quita el plugin como prueba e informa del error al autor del plugin, con el mensaje completo.
  4. Reinicia el servidor.

Conviene saber: Si Geyser indica «English locale not found», el archivo está incompleto. Vuelve a descargar Geyser desde la página oficial del proyecto. Más información: El plugin no es compatible con la versión del servidor.

Paper no carga un plugin («Could not load plugin … in folder»)

Así se ve el mensaje:

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>-<Versión>.jar' in folder 'plugins'
org.bukkit.plugin.InvalidPluginException: java.lang.ExceptionInInitializerError

Qué hay detrás: Paper no pudo cargar el plugin indicado al iniciar. El plugin falta por completo, mientras que el resto del servidor arranca. El motivo lo indica la línea inmediatamente inferior, normalmente un plugin.yml roto, una dependencia que falta o una compilación para otra versión del servidor. Un mensaje sobre «API version string» significa, por ejemplo, que la indicación de versión en el plugin.yml tiene un formato que tu versión del servidor no entiende.

Cómo solucionarlo:

  1. Lee la línea inmediatamente inferior al mensaje.
  2. Vuelve a descargar el plugin compatible con tu versión del servidor.
  3. Detén el servidor, elimina en Archivos el JAR antiguo de plugins y sube el nuevo.
  4. Reinicia el servidor y comprueba en la Consola si el plugin se carga ahora.

Conviene saber: Si la línea inferior menciona un plugin que falta, el problema no está en el archivo en sí. En ese caso te ayuda El plugin necesita otro plugin.

Plugin instalado por duplicado («Ambiguous plugin name»)

Así se ve el mensaje:

[ModernPluginLoadingStrategy] Ambiguous plugin name 'ViaVersion' for files 'plugins/ViaVersion.jar' and 'plugins/ViaVersion-<Versión>.jar' in 'plugins'

Qué hay detrás: Dos archivos JAR de la carpeta plugins tienen el mismo nombre de plugin. El servidor solo carga uno de ellos y no sabes con certeza cuál. Lo típico es que se haya subido una versión nueva sin borrar la antigua. O que dos plugins contengan lo mismo, por ejemplo FastAsyncWorldEdit, que ya incluye WorldEdit. El servidor funciona, aunque quizá con la versión antigua.

Cómo solucionarlo:

  1. El mensaje indica ambos archivos. Detén el servidor y abre la carpeta plugins en Archivos.
  2. Elimina el JAR duplicado o más antiguo. Conserva la versión que coincida con tu versión del servidor.
  3. Con WorldEdit y FastAsyncWorldEdit, conserva solo uno de los dos.
  4. Reinicia el servidor. El comando plugins en la Consola muestra qué plugins están cargados.

Conviene saber: Al actualizar, descarga siempre primero el JAR antiguo o elimínalo antes de subir el nuevo. Los nombres de archivo con número de versión hacen que los plugins duplicados pasen fácilmente desapercibidos.

Mod en lugar de plugin en la carpeta plugins

Así se ve el mensaje:

[DirectoryProviderSource] Error loading plugin: java.lang.IllegalArgumentException: Directory 'plugins/<Mod>-fabric-<Versión>.jar' does not contain a paper-plugin.yml or plugin.yml! Could not determine plugin type, cannot load a plugin from it!

Qué hay detrás: En la carpeta plugins hay un JAR sin plugin.yml, es decir, sin el archivo por el que Paper reconoce un plugin. Normalmente es un mod para Fabric o Forge, y el nombre del archivo suele contener «fabric» o «forge». A veces también es una biblioteca de Java, como un controlador de base de datos. Paper no puede cargar algo así y omite el archivo. El servidor sigue funcionando, pero falta la función que esperabas.

Cómo solucionarlo:

  1. Elimina el archivo indicado de la carpeta plugins en Archivos.
  2. Busca en la página del proyecto una versión en forma de plugin para Paper o Spigot. Muchos proyectos ofrecen ambas.
  3. Si solo existe un mod, necesitas un servidor de mods. En Cambiar software / cargador eliges Fabric, Forge o NeoForge. Tus plugins de Paper dejarán de funcionar allí.
  4. Reinicia el servidor.

Conviene saber: Algunos mods solo funcionan en el cliente del juego y no deben estar en el servidor. El cambio de software se describe en Cambiar el software y la versión del servidor en el panel.

Archivo de plugin reemplazado con el servidor en marcha („zip file closed“)

Así se ve el mensaje:

java.lang.IllegalStateException: zip file closed
java.lang.IllegalStateException: The plugin classloader for <Plugin> has thrown a zip file error.

Qué hay detrás: Se sobrescribió o se borró un JAR de plugin mientras el servidor estaba en marcha, o alguien usó /reload. Después, el plugin intenta cargar partes de su código desde un archivo que el servidor ya ha cerrado, y lanza errores. Esto afecta sobre todo a los plugins que trabajan constantemente en segundo plano, como LuckPerms. Es posible que las funciones del plugin dejen de funcionar hasta que el servidor se reinicie.

Así lo solucionas:

  1. Reinicia el servidor por completo. Con eso, el mensaje suele desaparecer.
  2. En el futuro, cambia los archivos de plugins solo con el servidor detenido: detener, reemplazar el JAR en Archivos, iniciar.
  3. Evita usar /reload. El comando recarga todos los plugins con el servidor en marcha, y muchos plugins no lo soportan bien.
  4. Si el mensaje aparece sin haber cambiado ningún archivo antes, lee las líneas anteriores en la Consola. Muestran qué plugin está afectado.

Bueno saber: Tras un reinicio limpio, el plugin vuelve a estar completo. Este mensaje por sí solo no hace que se pierdan datos, pero los cambios del plugin sin guardar de ese periodo pueden perderse.

Dos archivos de plugin con el mismo nombre („duplicate plugin identifier“)

Así se ve el mensaje:

[ModernPluginLoadingStrategy] Could not load plugin 'worldedit-bukkit-<Versión>.jar' in folder 'plugins'
java.lang.IllegalStateException: Provider SpigotPluginProvider{path=plugins/worldedit-bukkit-<Versión>.jar, …} attempted to add duplicate plugin identifier …

Qué hay detrás: Dos archivos JAR proporcionan el mismo nombre de plugin. Paper solo carga uno de ellos y rechaza el otro. Normalmente, la versión antigua y la nueva de un plugin están juntas en la carpeta plugins. O dos plugins reclaman el mismo nombre: FastAsyncWorldEdit (FAWE, para abreviar) ya incluye WorldEdit, así que un JAR adicional de WorldEdit colisiona con él. El servidor sigue funcionando, pero Paper advierte expresamente de posibles errores derivados.

Así lo solucionas:

  1. Detén el servidor.
  2. En Archivos, dentro de la carpeta plugins, borra el JAR más antiguo o sobrante. En el caso de FAWE, es el JAR independiente worldedit-bukkit.
  3. Inicia el servidor y comprueba con el comando plugins en la Consola que el plugin solo se haya cargado una vez.

Bueno saber: Los comandos habituales de WorldEdit siguen funcionando con FAWE. Cómo construir con ellos y deshacer errores te lo muestra WorldEdit: seleccionar zonas, construir y deshacer.

ProtocolLib avisa de un recargador de plugins

Así se ve el mensaje:

*** ProtocolLib does not support plugin reloaders! ***
*** Please use the built-in reload command!        ***

Qué hay detrás: ProtocolLib interviene a fondo en la conexión de red entre el servidor y los jugadores. Los recargadores de plugins son plugins como PlugMan o PlugManX, que cargan o descargan plugins individuales con el servidor en marcha. ProtocolLib no lo soporta y avisa de un estado inconsistente. Entonces, ProtocolLib y todos los plugins que dependen de él pueden funcionar mal, por ejemplo los de anticheat o los de visualización.

Así lo solucionas:

  1. No recargues ProtocolLib ni los plugins que lo usan con un recargador de plugins.
  2. Después de cambiar plugins, reinicia el servidor entero por completo.
  3. Si no necesitas el recargador, quítalo de la carpeta plugins en Archivos para que no se use por accidente.
  4. Si acabas de usar un recargador, haz ahora un reinicio completo para que todo se cargue de nuevo correctamente.

Bueno saber: El mensaje recomienda el comando de recarga integrado. Ese también recarga todos los plugins con el servidor en marcha. La vía más segura sigue siendo un reinicio completo.

Un archivo de la carpeta plugins no es un plugin ejecutable

Así se ve el mensaje:

[DirectoryProviderSource] Error preparing plugin context: Directory 'plugins/<Plugin>-<Versión>.jar' failed to update!
Failed to open plugin jar …

Qué hay detrás: Un archivo de la carpeta plugins no se puede cargar como plugin, así que el plugin no arranca. A menudo es el código fuente en lugar del plugin (el nombre del archivo termina en -sources.jar), la documentación (-javadoc.jar), una descarga interrumpida, un ZIP renombrado a .jar o un plugin para otra plataforma. También „Invalid plugin.yml“ o „only DEFLATED entries can have EXT descriptor“ pertenecen a este grupo: el archivo no tiene la estructura que debe tener un plugin.

Así lo solucionas:

  1. Detén el servidor y borra de plugins el archivo indicado en Archivos.
  2. Vuelve a descargar el plugin desde la página oficial. Coge el .jar propiamente dicho, no -sources.jar ni -javadoc.jar.
  3. Si el plugin viene como archivo ZIP, descomprímelo en tu propio equipo y sube solo el JAR que contiene.
  4. Asegúrate de que el archivo está pensado para Paper o Spigot y reinicia el servidor.

Bueno saber: Una versión para otra plataforma suele reconocerse por el nombre del archivo o por la página de descarga, que ofrece varias variantes para elegir.

Una biblioteca de Java está como plugin en la carpeta plugins

Así se ve el mensaje:

[DirectoryProviderSource] Error preparing plugin context: Directory 'plugins/asm-util-<Versión>.jar' failed to update!

Qué hay detrás: Una biblioteca de Java como ASM o Nashorn está como archivo propio en la carpeta plugins. Las bibliotecas son componentes que los plugins usan internamente; no son plugins en sí. Paper no puede cargar este JAR como plugin ni actualizarlo, y lo omite. El servidor sigue funcionando. Estos archivos acaban ahí, por ejemplo, cuando se sube completo un archivo comprimido con varios archivos.

Así lo solucionas:

  1. Borra de plugins el JAR de la biblioteca indicado en Archivos.
  2. Instala solo el plugin propiamente dicho. Trae sus bibliotecas consigo o las descarga al arrancar.
  3. Reinicia el servidor y revisa la Consola.
  4. Si después un plugin informa de que le falta algo, lee su guía de instalación en lugar de añadir bibliotecas a mano.

Bueno saber: Si un plugin realmente necesita un segundo plugin, lo indica expresamente. Cómo reconocerlo: Un plugin necesita otro plugin.

El archivo del plugin está vacío („zip file is empty“)

Así se ve el mensaje:

[DirectoryProviderSource] Error loading plugin: zip file is empty

Qué hay detrás: Un archivo de la carpeta plugins pesa 0 bytes o su subida se interrumpió. Paper no puede abrirlo y lo omite. El plugin falta, pero el servidor sigue funcionando. Esto suele pasar cuando la conexión se corta durante la subida o cuando la descarga ya estaba incompleta en tu propio equipo.

Así lo solucionas:

  1. En Archivos, abre la carpeta plugins y busca el archivo de 0 bytes o de un tamaño llamativamente pequeño.
  2. Bórralo.
  3. Vuelve a descargar el plugin desde una fuente de confianza y súbelo con el servidor detenido. Espera a que la subida termine por completo.
  4. Reinicia el servidor y comprueba en la Consola si el plugin se carga.

Bueno saber: Con archivos grandes o numerosos, SFTP suele ser más fiable que la subida desde el navegador, consulta Editar los archivos del servidor en el panel y conectarte por SFTP.

¿Tu mensaje no aparece aquí?

Lee el mensaje completo en la Consola o en logs/latest.log, incluidas las líneas anteriores y posteriores. El nombre del archivo del plugin lo encuentras en el propio mensaje o en el stacktrace, la lista de líneas con sangría que empiezan por at: allí aparece el JAR antes de la doble barra, por ejemplo <Plugin>.jar//. También los nombres de carpeta como plugins/<Plugin>/ indican qué plugin está afectado. Crea una copia de seguridad antes de sustituir archivos. Si no avanzas, abre un ticket e indica la hora del mensaje.