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.

"Error occurred while enabling …": el plugin no se inicia

Así se ve el mensaje:

Error occurred while enabling EssentialsSpawn v<Version> (Is it up to date?)
Error occurred while enabling WorldEditDisplay v<Version> (Is it up to date?)
Error occurred while disabling FurnitureLib v<Version>

Qué hay detrás: El servidor cargó el plugin, pero al activarlo se bloqueó y fue desactivado. El servidor sigue funcionando, aunque las funciones de ese plugin faltan por completo. Si se trata de un plugin de protección, permisos o inicio de sesión, también falta esa protección. Normalmente el plugin no es compatible con otra versión del servidor o de un plugin distinto al instalado.

Así lo solucionas:

  1. La línea de error indica el plugin y la versión. Comprueba en la página del plugin qué edición admite la versión de tu servidor y actualízalo con el servidor detenido.
  2. Si debajo aparece NoSuchMethodError (falta un método) o NoClassDefFoundError (falta un componente del programa), revisa las dependencias mencionadas. Por ejemplo, EssentialsSpawn y EssentialsX deben ser compatibles entre sí; una referencia a Bukkit puede afectar a la interfaz del servidor.
  3. En caso de un error de base de datos como Communications link failure, comprueba los datos de acceso en la configuración del plugin y en Bases de datos.
  4. Reinicia y comprueba en la Consola si el plugin se activa correctamente.

Conviene saber: "Error occurred while disabling" se refiere a la desactivación. Si aparece después de un error de activación, revisa primero ese error anterior. Más información: 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.

„Error initializing plugin …“: el plugin falla al iniciarse

Así se ve el mensaje:

[<Plugin>] Error initializing plugin '<Plugin>-<Version>.jar' in folder '<Carpeta>' (Is it up to date?)
java.lang.ExceptionInInitializerError
java.lang.ArrayIndexOutOfBoundsException: Index <Índice> out of bounds for length <Longitud>

Qué hay detrás: El plugin se ha bloqueado mientras el servidor lo preparaba, es decir, antes de que llegara a activarse. Se queda desactivado, sus comandos y funciones no están disponibles y el servidor sigue funcionando sin él. Normalmente la versión del plugin no encaja con la versión del servidor. La línea de error que aparece 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. Lee primero las líneas siguientes en logs/latest.log en Archivos, sobre todo Caused by. Indican la causa real.
  2. Instala la versión del plugin para la versión de tu servidor o actualiza el plugin. La página del plugin indica las versiones compatibles.
  3. Si todavía no hay una versión adecuada para la versión de tu servidor, espera a que el plugin se actualice o mantente por ahora en una versión compatible en Versión.
  4. Si eso no ayuda, quita el plugin como prueba y comunica el error al autor del plugin, con el mensaje completo.
  5. Reinicia el servidor.

Bueno saber: Si Geyser muestra «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 encaja 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.

"Ambiguous plugin name …": el plugin está instalado por duplicado

Así se ve el mensaje:

[ModernPluginLoadingStrategy] Ambiguous plugin name 'ViaVersion' for files 'plugins/ViaVersion.jar' and 'plugins/ViaVersion-<Version>.jar' in 'plugins'
[ModernPluginLoadingStrategy] Ambiguous plugin name 'LPC' for files 'plugins/.paper-remapped/LPC-<Version>.jar' and 'plugins/.paper-remapped/LPC-<OtraVersion>.jar' in 'plugins/.paper-remapped'
[ModernPluginLoadingStrategy] Ambiguous plugin name 'Slimefun' for files 'plugins/.paper-remapped/<Archivo>.jar' and 'plugins/.paper-remapped/<OtroArchivo>.jar' in 'plugins/.paper-remapped'

Qué hay detrás: Dos archivos JAR informan del mismo nombre interno de plugin, aunque sus nombres de archivo sean distintos. Lo típico es una versión antigua y una nueva, o dos variantes del mismo plugin. El servidor solo carga una de ellas y quizá se ejecute con la versión no deseada.

Así lo solucionas:

  1. Detén el servidor y abre la carpeta plugins en Archivos.
  2. Relaciona los dos archivos mencionados con sus JAR originales. plugins/.paper-remapped contiene copias adaptadas por Paper; elimina el JAR original no deseado en plugins, no solo su copia.
  3. Conserva exactamente una edición que sea compatible con la versión de tu servidor. No borres las carpetas de datos de los plugins.
  4. Reinicia. Comprueba el mensaje en la Consola; el comando plugins muestra los plugins cargados.

Conviene saber: Actualiza los plugins con el servidor detenido y elimina el JAR antiguo antes de subir el nuevo.

„does not contain a paper-plugin.yml or plugin.yml“: el archivo no es un plugin

Así se ve el mensaje:

Directory 'plugins/<Mod>-fabric-<Version>.jar' does not contain a paper-plugin.yml or plugin.yml!
Directory 'plugins/<Mod>-neoforge-<Version>.jar' does not contain a paper-plugin.yml or plugin.yml!

Qué hay detrás: En la carpeta plugins hay un JAR sin plugin.yml y sin paper-plugin.yml, es decir, sin ninguno de los archivos de descripción de los plugins. Normalmente se trata de un mod para Fabric, Forge o NeoForge; a veces es una biblioteca de Java, como un controlador de base de datos. Paper y sus variantes no pueden cargar este archivo como plugin y lo omiten. El servidor sigue funcionando, pero falta la función que esperabas.

Cómo solucionarlo:

  1. Detén el servidor y elimina el archivo indicado de plugins/ en Archivos.
  2. Busca en la página del proyecto una versión para Paper o Spigot que corresponda a tu versión de Minecraft.
  3. Si solo existe un mod, comprueba primero si realmente debe estar en el servidor. Algunos mods solo funcionan en el cliente del juego.
  4. Si quieres cambiar a un servidor de mods, crea antes una copia de seguridad en Copias de seguridad. En Cambiar software / cargador elige exactamente el cargador que exige el mod. Tus plugins de Paper dejarán de funcionar allí.
  5. Reinicia y revisa la Consola.

El cambio de software se describe en Cambiar el software y la versión del servidor en el panel.

«zip file closed»: archivo del plugin reemplazado con el servidor en marcha

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.
io.netty.handler.codec.EncoderException: java.lang.BootstrapMethodError: java.lang.IllegalStateException: zip file closed

Qué hay detrás: Un JAR de plugin, es decir, el archivo de programa de un plugin, se sobrescribió o se eliminó mientras el servidor estaba en marcha, o alguien usó /reload. Después, el plugin intenta cargar partes del programa desde su archivo, que ya está cerrado, y lanza errores. Las funciones del plugin pueden fallar hasta que el servidor se reinicie. El mensaje también puede aparecer al detener el servidor.

Cómo solucionarlo:

  1. Reinicia el servidor por completo. Si falta el JAR del plugin afectado, restáuralo antes en Archivos con el servidor detenido.
  2. En el futuro, cambia los archivos de plugins solo con el servidor detenido: detén el servidor, reemplaza el JAR en Archivos e inícialo.
  3. Evita /reload. El comando recarga los plugins con el servidor en marcha, y muchos plugins no lo soportan bien.
  4. Si el mensaje aparece sin haber cambiado archivos antes, lee las líneas anteriores en la Consola. Te ayudarán a encontrar el plugin afectado.

Bueno saber: Los cambios que el plugin aún no haya guardado durante el error pueden perderse.

«duplicate plugin identifier»: dos archivos de plugin reclaman el mismo nombre

Así se ve el mensaje:

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins'
[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins/.paper-remapped'
java.lang.IllegalStateException: … attempted to add duplicate plugin identifier <Plugin> …

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 una junto a la otra en la carpeta plugins. O bien dos plugins reclaman el mismo nombre: FastAsyncWorldEdit (abreviado FAWE) ya incluye WorldEdit, así que un JAR adicional de WorldEdit entra en conflicto 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, elimina el JAR más antiguo o sobrante. En el caso de FAWE, se trata del JAR independiente worldedit-bukkit.
  3. Si el mensaje menciona plugins/.paper-remapped, comprueba primero si hay versiones duplicadas entre los archivos JAR originales de la carpeta plugins.
  4. Inicia el servidor y comprueba en la Consola que la advertencia ha desaparecido y que el plugin deseado se carga.

Bueno saber: Los comandos habituales de WorldEdit siguen funcionando con FAWE. Cómo construir con ellos y deshacer errores te lo explica 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.

«Error loading plugin»: archivo de plugin o nombre de plugin no válido

Así se ve el mensaje:

[DirectoryProviderSource] Error preparing plugin context: Directory 'plugins/<File>.jar' failed to update!
[DirectoryProviderSource] Error loading plugin: Directory 'plugins/<File>.jar' failed to load!
[DirectoryProviderSource] Error loading plugin: Restricted name, cannot use 0x20 (space character) in a plugin name.

Qué hay detrás: Un archivo de la carpeta plugins no se puede cargar; el plugin no se inicia. Con frecuencia se trata de código fuente (-sources.jar), documentación (-javadoc.jar), una descarga incompleta o una versión para otra plataforma. «Invalid plugin.yml» y «only DEFLATED entries can have EXT descriptor» también indican un archivo inadecuado. «Restricted name» con «0x20» significa que el nombre del plugin indicado en plugin.yml contiene un espacio.

Así lo solucionas:

  1. Detén el servidor y elimina de plugins el JAR indicado en Archivos.
  2. Descarga el JAR real del plugin desde la página oficial, compatible con Paper o Spigot. Los mods de Fabric o Forge no van en la carpeta plugins.
  3. Si la descarga viene como ZIP, descomprímela en tu propio ordenador y sube el JAR correspondiente.
  4. En el caso de «Restricted name», utiliza una versión corregida por el desarrollador. Hay que corregir el nombre de plugin indicado; cambiar el nombre del archivo no soluciona este error.
  5. Reinicia y revisa la Consola.

Bueno saber: Conserva los datos y las configuraciones existentes del plugin al sustituir el JAR.

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.

PlaceholderAPI: el archivo de la expansión no contiene una clase de expansión cargable

Así se ve el mensaje:

[PlaceholderAPI] Failed to load expansion <Archivo>.jar, as it does not have a class which extends PlaceholderExpansion

Qué hay detrás: Una expansión de PlaceholderAPI aporta marcadores de texto adicionales. Se examina el archivo JAR, pero no se encuentra o no se puede cargar la clase de expansión necesaria. Esta expansión permanece desactivada. El servidor sigue funcionando; sus marcadores no devuelven los valores previstos.

Así lo solucionas:

  1. En la Consola, lee los mensajes anteriores a este error. Otros errores de carga pueden indicar una dependencia que falta.
  2. En Archivos, comprueba si el archivo indicado es realmente la expansión de PlaceholderAPI que quieres. Haz una copia de seguridad antes de reemplazarlo.
  3. Vuelve a descargar de su fuente oficial la expansión que coincida con la versión instalada de PlaceholderAPI. Reemplaza el archivo afectado y elimina las copias duplicadas de la misma expansión.
  4. Reinicia el servidor por completo. Después, revisa el mensaje de inicio y un marcador proporcionado por la expansión.

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