Un plugin de Minecraft se encuentra como archivo JAR (un archivo de Java) en la carpeta plugins/ y siempre está compilado para determinadas versiones de Minecraft, una versión concreta de Java y, normalmente, también para un software de servidor concreto como Paper o Spigot. Si alguno de estos elementos no coincide, el plugin no carga, se desactiva por sí solo o algunas funciones dejan de funcionar. Cada apartado de abajo trata un mensaje concreto: qué aspecto tiene, qué hay detrás y cómo lo solucionas.

El mensaje completo lo encuentras en la Consola o en Archivos dentro de logs/latest.log. Lee también las líneas anteriores, ya que a menudo ahí aparece el plugin afectado. La versión de Java se establece automáticamente en nuestro sistema para que coincida con la versión de Minecraft. Las versiones que admite un plugin las indica su página de descarga. Antes de cambiar la versión o de modificar archivos de configuración y de mundo, crea una copia de seguridad en Copias de seguridad.

El plugin o el servidor necesita una versión más reciente de Java (UnsupportedClassVersionError)

Así se ve el mensaje:

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins'
org.bukkit.plugin.InvalidPluginException: java.lang.UnsupportedClassVersionError: <Class> has been compiled by a more recent version of the Java Runtime (class file version 69.0), this version of the Java Runtime only recognizes class file versions up to 65.0

Qué hay detrás: Los programas de Java se compilan para una versión concreta de Java. El archivo del mensaje exige una versión de Java más reciente que la que usa tu servidor ahora mismo. Los números te dicen cuál: el número menos 44 da la versión de Java, así que 69 corresponde a Java 25 y 65 a Java 21. Si el mensaje menciona un plugin, ese plugin no se inicia. Si afecta al JAR del servidor en sí, no se inicia el servidor entero.

Cómo solucionarlo:

  1. Lee el nombre del archivo después de Could not load plugin. Ese es el archivo que no encaja.
  2. En la página del plugin, descarga la versión compilada para tu versión de Minecraft.
  3. Sustituye el archivo antiguo en Archivos, dentro de la carpeta plugins/, y reinicia el servidor.
  4. Si necesitas exactamente esa versión del plugin, cambia el servidor en Versión a la versión de Minecraft que exige. La versión de Java adecuada se establece automáticamente en nuestro sistema para cada versión de Minecraft. Haz antes una copia de seguridad.

Bueno saber: La carpeta plugins/.paper-remapped es una copia de trabajo de Paper. Sustituye siempre el archivo directamente en plugins/.

Con más detalle: ¿Qué versión de Java necesita tu servidor de Minecraft?

El plugin está compilado para una versión más reciente de Minecraft (Unsupported API version)

Así se ve el mensaje:

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins/.paper-remapped'
org.bukkit.plugin.InvalidPluginException: Unsupported API version 26.1

Qué hay detrás: Cada plugin incluye un pequeño archivo de ficha, el plugin.yml. En él, bajo api-version, se indica para qué versión del servidor está escrito. Si esa versión es más reciente que la de tu servidor, Paper no carga el plugin en absoluto, por ejemplo con Unsupported API version 26.1 en un servidor con 1.21.11. El servidor arranca, pero falta por completo todo lo que el plugin debería aportar: comandos, reglas de protección, menús.

Cómo solucionarlo:

  1. Compara el número que aparece tras Unsupported API version con la versión de Minecraft de tu servidor en Versión.
  2. En Modrinth o SpigotMC, filtra las descargas del plugin por tu versión de Minecraft y descarga la que corresponda.
  3. Sustituye el archivo antiguo en Archivos, dentro de la carpeta plugins/, y reinicia.
  4. Si no hay ninguna versión adecuada, cambia el servidor en Versión a la versión que exige el plugin. Haz antes una copia de seguridad, porque el mundo se convertirá a la nueva versión.

Bueno saber: No cambies tú mismo la api-version en el archivo del plugin. El plugin se cargaría, pero usaría funciones que tu servidor no tiene y más tarde fallaría con otros errores.

Más información: Cambiar de forma segura la versión de Minecraft y el cargador de mods

Un servidor Paper antiguo no puede convertir un plugin nuevo (Fatal error trying to convert)

Así se ve el mensaje:

Fatal error trying to convert Geyser-Spigot <Version>:org/geysermc/geyser/platform/spigot/GeyserSpigotPlugin.class
java.lang.IllegalArgumentException: Unsupported class file major version 65

Qué hay detrás: Paper en la versión 1.19.4 o anterior convierte los plugins al cargarlos con un conversor integrado. Este conversor no puede leer clases compiladas para Java 21 o superior (major version 65 corresponde a Java 21 y 69 a Java 25). Por eso el plugin no se carga. Suele afectar a Geyser: entonces los jugadores de Bedrock no pueden entrar. El servidor en sí arranca y los jugadores de Java siguen pudiendo entrar.

Cómo solucionarlo:

  1. Lee el nombre después de trying to convert. Ese es el plugin afectado.
  2. Si quieres mantener tu versión de Minecraft, descarga una versión anterior del plugin compilada exactamente para esa versión y sustitúyela en Archivos, dentro de la carpeta plugins/.
  3. Como alternativa, cambia el servidor en Versión a Minecraft 1.20.5 o superior. Las compilaciones más recientes de Paper leen clases de Java 21. Haz antes una copia de seguridad.
  4. Reinicia y comprueba en la Consola que el plugin se carga sin errores.

Bueno saber: El mensaje suele aparecer varias veces seguidas, una por cada clase. Aun así, solo afecta a ese único plugin.

Con más detalle: ¿Qué versión de Java necesita tu servidor de Minecraft?

El plugin avisa: esta versión del servidor no es compatible

Así se ve el mensaje:

[Essentials] You are running an unsupported server version!
[DecentHolograms] Plugin will now be disabled.
This plugin does not support Paper servers!

Qué hay detrás: Al iniciarse, el plugin comprueba en qué versión de Minecraft y con qué software de servidor se ejecuta. Si ninguna de las dos aparece en su lista, avisa o se desactiva total o parcialmente. El motivo puede ser una versión demasiado nueva o demasiado antigua, o un software de servidor incorrecto. El servidor en sí sigue funcionando.

Cómo solucionarlo:

  1. Escribe plugins en la Consola. Los plugins que aparecen en verde están activos y los que aparecen en rojo están desactivados.
  2. Consulta en la página del plugin qué versiones de Minecraft y qué software de servidor son compatibles.
  3. Descarga la versión adecuada y sustituye el archivo antiguo en Archivos, dentro de la carpeta plugins/.
  4. Si no hay ninguna, elige en Versión una versión de Minecraft compatible con el plugin. Si exige otro software de servidor, puedes hacerlo con Cambiar software / cargador. Haz antes una copia de seguridad.

Bueno saber: Si el plugin sigue en verde a pesar del aviso, normalmente las funciones básicas funcionan. Prueba los comandos que necesitas e instala la actualización en cuanto aparezca.

Paper no puede adaptar un plugin antiguo a la versión del servidor (PluginRemapper)

Así se ve el mensaje:

[PluginRemapper] Encountered exception remapping plugins
java.util.concurrent.CompletionException: java.lang.RuntimeException: Failed to remap plugin jar 'plugins/<Plugin>.jar'

Qué hay detrás: Las versiones más recientes de Paper reescriben automáticamente al iniciarse los plugins antiguos para adaptarlos a la estructura interna de la versión actual de Minecraft. Este proceso se llama remapping y Paper guarda las copias terminadas en plugins/.paper-remapped. Ha fallado con al menos un plugin. El servidor sigue arrancando, pero es posible que el plugin no funcione o solo lo haga en parte, a menudo sin ningún otro mensaje de error.

Cómo solucionarlo:

  1. Lee el nombre del archivo que aparece tras Failed to remap plugin jar.
  2. Si en el nombre aparece algo como (1), es probable que el archivo esté duplicado en la carpeta. Elimina la copia sobrante en Archivos.
  3. Descarga una versión del plugin compilada expresamente para tu versión de Minecraft. Así Paper no tiene que reescribir nada. Con ella, sustituye el archivo antiguo en plugins/.
  4. Reinicia y comprueba si el mensaje ha desaparecido.

Bueno saber: Si no hay ninguna versión adecuada, el plugin aún no está preparado para la versión de tu servidor. Quítalo o espera a una actualización.

Archivos duplicados: Archivo de plugin dañado, duplicado o que no es un plugin

Nombre de bloque o ítem desconocido en la configuración de un plugin (Unsupported key)

Así se ve el mensaje:

Unsupported key: minecraft:bed

Qué hay detrás: Minecraft gestiona cada bloque y cada ítem con un nombre fijo con la forma minecraft:<nombre>, la llamada clave de registro. Un plugin o su configuración usa un nombre que tu versión de Minecraft no conoce. Un ejemplo típico es minecraft:bed: desde la 1.13, las camas se llaman según su color, por ejemplo red_bed. La entrada se omite, y el servidor y el resto del plugin siguen funcionando.

Cómo solucionarlo:

  1. Mira en la Consola o en logs/latest.log las líneas anteriores al mensaje. Ahí se indica qué plugin se está cargando.
  2. En Archivos, abre la configuración de ese plugin en la carpeta plugins/<Plugin>/ y busca el nombre indicado.
  3. Sustitúyelo por la denominación actual, que encontrarás en la wiki de Minecraft. Las configuraciones en formato YAML (.yml) son delicadas: no cambies la sangría ni las comillas.
  4. Reinicia el servidor. Si el nombre no está en tu configuración sino en el propio plugin, solo ayuda una actualización del plugin.

Si hay errores en el archivo: El archivo de configuración de un plugin es defectuoso

El plugin necesita una biblioteca de texto (Adventure) más reciente que la de tu servidor

Así se ve el mensaje:

Caused by: java.lang.ExceptionInInitializerError: Exception java.lang.TypeNotPresentException: Type net.kyori.adventure.text.TranslationArgument not present

Qué hay detrás: Adventure es la biblioteca con la que Paper genera textos de chat en color, títulos y textos emergentes. Viene integrada de forma fija en el servidor, así que su versión depende de tu versión de Minecraft. El plugin se compiló con una versión más reciente de Adventure, y la clase indicada no existe en tu servidor. Por eso, partes del plugin no arrancan. El servidor sigue funcionando.

Cómo solucionarlo:

  1. Averigua qué plugin está afectado. En el stacktrace, es decir, la lista de líneas at … debajo del mensaje, suele aparecer el nombre del archivo JAR. Si no, ayudan las líneas anteriores.
  2. Descarga una versión anterior del plugin compilada para la versión de tu servidor y reemplaza el archivo en Archivos, en la carpeta plugins/.
  3. O cambia el servidor a una versión más reciente de Minecraft en Versión. Antes, crea una copia de seguridad.

Conviene saber: Un archivo adicional de Adventure en la carpeta plugins/ no sirve de nada, porque Paper usa su versión integrada.

ProtocolLib no es compatible con la versión del servidor

Así se ve el mensaje:

[ProtocolLib] INTERNAL ERROR: Cannot load ProtocolLib.
  If this problem hasn't already been reported, please open a ticket
  java.lang.IllegalArgumentException: Unable to find a field that matches …

Qué hay detrás: ProtocolLib es una biblioteca auxiliar con la que otros plugins leen y modifican paquetes de red. Para ello accede a fondo a los componentes internos del servidor, y estos cambian con casi cada versión de Minecraft. Si ProtocolLib no encuentra los campos de paquete esperados, no se carga. Todos los plugins que necesitan ProtocolLib tampoco funcionan entonces.

Cómo solucionarlo:

  1. Descarga la última compilación de ProtocolLib para tu versión actual de Minecraft. Para versiones muy nuevas, las compilaciones adecuadas suelen aparecer primero como versión preliminar en la página del proyecto.
  2. Reemplaza el archivo antiguo en Archivos, en la carpeta plugins/. Conserva solo un archivo de ProtocolLib.
  3. Reinicia el servidor por completo, es decir, deténlo y vuelve a iniciarlo, no con /reload.
  4. Escribe plugins en la Consola y comprueba que ProtocolLib y los plugins dependientes aparecen en verde.

Conviene saber: La petición de abrir un ticket en ProtocolLib viene del propio plugin. Normalmente solo falta la compilación adecuada.

Plugins dependientes: El plugin necesita otro plugin que falta

Citizens se desactiva: la compilación no es compatible con la versión de Minecraft

Así se ve el mensaje:

[Citizens] v<Version> (build <Number>) is not compatible with Minecraft <Version> - try upgrading or downgrading Citizens. Disabling.

Qué hay detrás: Citizens es un plugin para NPC, es decir, personajes controlados por el ordenador, como comerciantes o dadores de misiones. Cada compilación de Citizens solo admite ciertas versiones de Minecraft y compilaciones de servidor. Si no es compatible con tu servidor, Citizens se desactiva al iniciar. Tus NPC no aparecen y los plugins que dependen de Citizens pierden esa función. El servidor en sí sigue funcionando.

Cómo solucionarlo:

  1. Comprueba en Versión qué versión de Minecraft tiene tu servidor.
  2. Descarga la compilación de Citizens para exactamente esa versión. Muchas compilaciones de Citizens llevan SNAPSHOT en el nombre; lo decisivo es la versión de Minecraft que indica la página de descarga.
  3. Reemplaza el archivo antiguo en Archivos, en la carpeta plugins/, y reinicia.
  4. Si no hay una compilación adecuada, ajusta la versión del servidor en Versión. Antes, crea una copia de seguridad.

Conviene saber: try upgrading or downgrading significa que Citizens puede ser demasiado antiguo o demasiado nuevo. Por tanto, el archivo más reciente no es automáticamente el correcto.

El plugin indica: no es compatible con tu versión de Minecraft

Así se ve el mensaje:

[Citizens] v<Version> (build <Number>) is not compatible with your version of Minecraft. Disabling...
[<Plugin>] Plugin will be disabled!
Your MC version isn't supported

Qué hay detrás: El plugin está compilado para otra versión de Minecraft u otro software de servidor y lo indica él mismo. Mensajes similares son This plugin only supports Spigot-API … o Unable to load Adventure, chat components will not work. Según el plugin, se desactiva por completo o fallan funciones concretas, como los textos de chat en color. El servidor sigue funcionando.

Cómo solucionarlo:

  1. Lee el nombre del plugin entre corchetes al principio de la línea. Si falta, aparece en las líneas anteriores.
  2. Consulta en la página del plugin qué versiones de Minecraft y qué software de servidor admite.
  3. Descarga la versión adecuada y reemplaza el archivo antiguo en Archivos, en la carpeta plugins/.
  4. Si no existe ninguna, cambia el servidor en Versión a la versión que requiere el plugin. Antes, crea una copia de seguridad.
  5. Tras reiniciar, escribe plugins en la Consola y comprueba que el plugin aparece en verde.

Conviene saber: Cambiar a una versión más reciente de Minecraft convierte el mundo. Volver atrás de forma fiable solo es posible mediante la copia de seguridad.

El plugin necesita una compilación de Paper más reciente para tu versión de Minecraft

Así se ve el mensaje:

[EntrypointUtil] Class io.papermc.paper.plugin.loader.library.impl.MavenLibraryResolver does not have member field 'java.lang.String MAVEN_CENTRAL_DEFAULT_MIRROR'
java.lang.NoSuchFieldError: …

Qué hay detrás: Paper se sigue desarrollando continuamente incluso dentro de una misma versión de Minecraft, y cada publicación se llama compilación (build). El plugin accede a un campo de la API de Paper, concretamente en la parte que descarga bibliotecas adicionales para plugins al iniciar. Ese campo (MAVEN_CENTRAL_DEFAULT_MIRROR) solo existe en compilaciones más recientes. En tu compilación no está, por eso el plugin no se carga. El servidor en sí sigue funcionando.

Cómo solucionarlo:

  1. Abre Versión en el panel y actualiza a la última compilación de Paper de tu versión de Minecraft.
  2. Reinicia y comprueba en la Consola si el plugin se carga ahora sin errores.
  3. Si no quieres cambiar de compilación, usa una versión anterior del plugin y reemplaza el archivo en Archivos, en la carpeta plugins/.

Conviene saber: Una compilación más reciente de la misma versión de Minecraft es un cambio pequeño. El mundo permanece en la misma versión de Minecraft. Aun así, no está de más crear una copia de seguridad antes.

El plugin no encuentra partes internas del servidor (Failed to init reflection)

Así se ve el mensaje:

Failed to init reflection: Index 3 out of bounds for length 3

Qué hay detrás: Algunos plugins no usan solo la interfaz oficial del servidor, sino que leen clases internas directamente por su nombre. Esto se llama reflection. Estos componentes internos cambian con casi cada versión de Minecraft. Si el plugin no encuentra lo que espera, significa que se compiló para otra versión del servidor, y las funciones que dependen de ello fallan. El servidor sigue funcionando.

Cómo solucionarlo:

  1. El mensaje en sí no indica ningún plugin. Mira en la Consola o en logs/latest.log las líneas inmediatamente anteriores. Ahí aparece qué plugin se estaba cargando.
  2. Actualiza ese plugin a una versión para la versión de tu servidor y reemplaza el archivo en Archivos, en la carpeta plugins/.
  3. Reinicia y comprueba si el mensaje ha desaparecido.

Conviene saber: Si no hay una versión más reciente, es probable que el plugin ya no reciba mantenimiento. Entonces merece la pena buscar un plugin sustituto actual con la misma función.

Los efectos de brillo de un plugin están desactivados (GlowingEntities)

Así se ve el mensaje:

[GlowingEntities] [GlowingEntities] Glowing Entities reflection failed to initialize. The util is disabled. Please ensure your version (<Versión>) is supported.
java.lang.NoSuchFieldException: MARKER

Qué hay detrás: GlowingEntities no es un plugin independiente, sino un componente que incluyen otros plugins para hacer brillar a jugadores, mobs u objetos. El componente no encuentra un campo interno de tu build del servidor. Por eso los efectos de brillo del plugin afectado están desactivados. El servidor sigue funcionando y, normalmente, el plugin también sigue funcionando sin los efectos.

Así lo solucionas:

  1. Busca el plugin que incluye GlowingEntities. En las líneas at … bajo el mensaje aparece una entrada con la forma <Plugin>.jar//….
  2. Descarga ese plugin en una versión para tu build de Paper.
  3. Sustituye el archivo antiguo en Archivos, en la carpeta plugins/, y reinicia.

Bueno saberlo: No puedes actualizar GlowingEntities por separado. Eso lo hace el desarrollador del plugin que incluye el componente. Si no necesitas los efectos de brillo, puedes ignorar el mensaje hasta la próxima actualización.

Simple_RTP: no se muestran las cabezas en el menú

Así se ve el mensaje:

[Simple_RTP] Failed to apply GUI head texture: IllegalArgumentException: Can not set net.minecraft.world.item.component.ResolvableProfile field org.bukkit.craftbukkit.inventory.CraftMetaSkull.profile to com.mojang.authlib.GameProfile

Qué hay detrás: Simple_RTP es un plugin de teletransportes aleatorios. Para las cabezas de su menú establece un perfil de jugador en el formato antiguo (GameProfile). Sin embargo, tu versión de Minecraft espera en este punto un formato más nuevo (ResolvableProfile). No son compatibles, por eso las cabezas del menú no funcionan. El servidor sigue funcionando.

Así lo solucionas:

  1. Comprueba en Versión qué versión de Minecraft tiene tu servidor.
  2. Descarga Simple_RTP en la versión para esa versión de Minecraft.
  3. Sustituye el archivo antiguo en Archivos, en la carpeta plugins/, y reinicia.
  4. Abre el menú en el juego y comprueba si ahora aparecen las cabezas.

Bueno saberlo: El mensaje puede repetirse cada vez que se abre el menú. No causa ningún otro daño, solo indica que la versión del plugin está desactualizada.

ZNPCs: los NPC guardados no coinciden con la versión del plugin

Así se ve el mensaje:

io.github.gonalez.znpcs.commands.CommandExecuteException
No enum constant io.github.gonalez.znpcs.npc.<…>.PLAYER

Qué hay detrás: ZNPCs guarda tus NPC, con su tipo y sus acciones, en un archivo. En él hay un tipo o una acción que tu versión instalada de ZNPCs no conoce, por ejemplo ActionType.PLAYER. Esto suele ocurrir cuando los NPC se crearon con otra versión de ZNPCs. El comando ejecutado se interrumpe, pero el servidor sigue funcionando.

Así lo solucionas:

  1. Crea una copia de seguridad en Copias de seguridad.
  2. Instala la versión de ZNPCs con la que se crearon los NPC y reinicia.
  3. Si no es posible, detén el servidor, abre en Archivos el archivo plugins/ZNPCs/data.json y elimina la entrada del NPC afectado. JSON es un formato de texto con llaves y comas: una sola coma que falte hace que todo el archivo sea ilegible.
  4. Inicia el servidor y prueba el comando de nuevo.

Bueno saberlo: Edita el archivo solo con el servidor detenido. Si está en marcha, ZNPCs puede volver a sobrescribir tu cambio al cerrarse.

El plugin necesita Paper o una versión más reciente (failed to register events)

Así se ve el mensaje:

Plugin <Plugin> v<Versión> has failed to register events for class <Clase> because io/papermc/paper/event/<Evento> does not exist.

Qué hay detrás: Los plugins reaccionan a eventos del juego, por ejemplo cuando un jugador rompe un bloque. Este plugin quiere escuchar un evento que el software de tu servidor no conoce. Lo más habitual es que el plugin esté escrito para Paper, pero el servidor funcione con Spigot. O bien el evento solo existe en una versión más reciente de Minecraft. La parte afectada del plugin no funciona, pero el servidor sigue en marcha.

Así lo solucionas:

  1. Lee el nombre que aparece después de because. Si empieza por io/papermc/paper o com/destroystokyo/paper, el plugin necesita Paper.
  2. Si tu servidor funciona con Spigot, cámbialo a Paper en Cambiar software / cargador. Los plugins para Spigot suelen funcionar también en Paper. Crea antes una copia de seguridad.
  3. Si ya funciona con Paper, el evento es más nuevo que tu versión. Usa una versión del plugin para tu versión de Minecraft o cambia el servidor a otra versión en Versión.
  4. Reinicia y comprueba si el mensaje ha desaparecido.

Más información: Cambiar el software y la versión del servidor en el panel

El archivo está compilado para una versión de Java más reciente (Unsupported class file major version)

Así se ve el mensaje:

java.lang.IllegalArgumentException: Unsupported class file major version 69

Qué hay detrás: Los plugins, mods y bibliotecas se compilan para una versión concreta de Java. El número que aparece tras major version indica cuál: ese número menos 44 da la versión de Java, así que 65 corresponde a Java 21 y 69 a Java 25. Las herramientas de tu servidor que leen o reescriben plugins y mods al cargarlos no entienden esta versión más reciente. La parte afectada no se carga.

Así lo solucionas:

  1. En las líneas anteriores, averigua qué plugin o mod se estaba cargando.
  2. Descarga una versión compilada para tu versión de Minecraft y sustituye el archivo antiguo en Archivos, en la carpeta plugins/ o mods/, según corresponda.
  3. Como alternativa, actualiza el servidor en Versión a una versión más reciente de Minecraft que funcione con Java 21 o superior. La versión de Java adecuada se establece automáticamente en nuestro sistema. Crea antes una copia de seguridad.

Bueno saberlo: Si justo antes aparece Fatal error trying to convert, se aplica la sección sobre servidores Paper antiguos que encontrarás más arriba.

Más detalles: ¿Qué versión de Java necesita tu servidor de Minecraft?

Un plugin antiguo busca una función de chunk eliminada (IDs legacy)

Así se ve el mensaje:

java.lang.NoSuchMethodException: net.minecraft.world.level.chunk.Chunk.k(net.minecraft.core.BlockPosition)

Qué hay detrás: Hasta Minecraft 1.12, los bloques tenían IDs numéricos; la piedra, por ejemplo, era el 1. Algunos plugins antiguos aún trabajan internamente con estos IDs legacy y para ello acceden directamente a funciones internas del juego, las clases bajo net.minecraft. La función de chunk que buscan ya no existe en tu versión. Por eso la función de IDs legacy del plugin no se inicia. Según el plugin, fallan algunas funciones o muchas.

Así lo solucionas:

  1. Mira el stacktrace bajo el mensaje, es decir, las líneas at …. Ahí aparece el nombre del plugin o de su archivo JAR.
  2. Actualiza ese plugin a una versión para tu versión de Minecraft y sustituye el archivo en Archivos, en la carpeta plugins/.
  3. Si no existe ninguna, el plugin ya no recibe mantenimiento para versiones modernas. Busca un plugin sustituto actualizado.

Bueno saberlo: El nombre corto k es un nombre interno ofuscado. Estos nombres cambian con cada versión de Minecraft. Por eso los plugins que los usan directamente fallan con casi cada actualización.

El plugin usa una función de perfil de Mojang obsoleta (cabezas de jugadores)

Así se ve el mensaje:

java.lang.NoSuchMethodException: com.mojang.authlib.GameProfile.getProperties()

Qué hay detrás: authlib es la biblioteca de Mojang con la que el servidor gestiona los perfiles de jugador con nombre y skin. El plugin lee estos perfiles mediante un método (GameProfile.getProperties) que ya no existe en tu versión de Minecraft. La función afectada deja de funcionar, normalmente las cabezas de jugadores en los menús. El servidor sigue funcionando.

Así lo solucionas:

  1. Encuentra el plugin: su nombre o el nombre de su archivo JAR aparece en las líneas at … debajo del mensaje o en las líneas anteriores.
  2. Descarga una versión de este plugin para tu versión de Minecraft.
  3. Sustituye el archivo antiguo en Archivos, en la carpeta plugins/, y reinicia.
  4. Abre el menú afectado en el juego y comprueba si las cabezas vuelven a aparecer.

Conviene saber: Este cambio afecta a muchos plugins de menús y cabezas a la vez. Si varios plugins ya no muestran cabezas, normalmente se debe a la misma causa y cada uno necesita su propia actualización.

El plugin busca bloques, partículas o atributos que no existen en tu versión

Así se ve el mensaje:

java.lang.IllegalArgumentException: No enum constant org.bukkit.Material.<NAME>
Unknown material '<NAME>' for button
java.lang.NoSuchFieldError: Class org.bukkit.<Clase> does not have member field '<Campo>'

Qué hay detrás: Cada versión de Minecraft trae nuevos bloques, partículas y atributos, y renombra algunos. El plugin está creado para otra versión y accede a algo que aquí no existe o que tiene otro nombre. Según el plugin, el error aparece en cada acción o dejan de funcionar algunas funciones concretas. También Could not initialize Brigadier mappings forma parte de esto. Brigadier es el sistema de comandos de Minecraft, que proporciona, entre otras cosas, el autocompletado con tabulador.

Así lo solucionas:

  1. Lee el nombre del plugin en las líneas anteriores o en las líneas at … de debajo.
  2. Descarga la versión del plugin que corresponda a tu versión de Minecraft y sustituye el archivo en Archivos, en la carpeta plugins/.
  3. O cambia el servidor en Versión a la versión de Minecraft que exige el plugin. Haz antes una copia de seguridad.
  4. Si el nombre desconocido aparece en un archivo de configuración del plugin, por ejemplo en botones de menú, puedes sustituirlo ahí por la denominación actual.

El plugin Marriage no es compatible con la versión de Minecraft

Así se ve el mensaje:

[Marriage] Marriage is not compatible with the version of minecraft you are using
Marriage kissing will be disabled!

Qué hay detrás: Marriage permite a los jugadores casarse en el juego e incluye funciones como los besos. El plugin no es compatible con tu versión de Minecraft. Por ello desactiva al menos la función de besos, y otras partes también podrían verse afectadas. El servidor sigue funcionando con normalidad.

Así lo solucionas:

  1. Mira en la página del plugin si hay una versión de Marriage para tu versión de Minecraft. Tu versión la ves en Versión.
  2. Si existe, sustituye el archivo antiguo en Archivos, en la carpeta plugins/, y reinicia.
  3. Si no existe, sustituye el plugin por uno actual con una función similar. Ten en cuenta que otro plugin no importará los datos guardados de Marriage, y haz antes una copia de seguridad.

Conviene saber: Si solo te molesta la falta de la función de besos y el resto funciona, puedes ignorar el mensaje hasta que salga una actualización.

El plugin anticheat o de paquetes aún no conoce del todo tu versión de Minecraft

Así se ve el mensaje:

java.lang.IllegalStateException: Unknown entity metadata type id: <Número> version V_<Versión>

Qué hay detrás: Algunos plugins leen los paquetes de red entre el juego y el servidor, por ejemplo el anticheat GrimAC mediante la biblioteca PacketEvents. Con las nuevas versiones de Minecraft se añaden nuevos tipos de datos para criaturas y objetos, los metadatos de entidad. El plugin aún no conoce uno de ellos, normalmente porque es más antiguo que la versión de tu servidor. Los paquetes afectados se procesan mal. Esto puede provocar falsas alarmas del anticheat o problemas de conexión.

Así lo solucionas:

  1. Actualiza el plugin y, si está instalado como archivo propio, también PacketEvents a una versión que sea compatible expresamente con tu versión de Minecraft.
  2. Reinicia el servidor por completo.
  3. Si aún no hay una versión adecuada, desactiva el plugin temporalmente: cambia el nombre de su archivo en Archivos, por ejemplo a <Plugin>.jar.off. El servidor solo carga archivos con la extensión .jar.
  4. Como alternativa, usa en Versión una versión de Minecraft que el plugin admita. Haz antes una copia de seguridad.

Un plugin complementario de WorldEdit usa una interfaz eliminada

Así se ve el mensaje:

[WorldEdit] Got request to set EditSessionFactory <…> EditSessionFactories have been removed …

Qué hay detrás: WorldEdit ha eliminado una interfaz antigua, la EditSessionFactory. A través de ella, los plugins complementarios podían engancharse a cada cambio de WorldEdit. Un plugin complementario, por ejemplo para registros de bloques o protección de zonas, todavía intenta usarla. WorldEdit en sí funciona con normalidad. Sin embargo, la función de registro o protección del plugin complementario no actúa sobre los cambios de WorldEdit: lo que construyes o borras con WorldEdit ni se registra ni se bloquea.

Así lo solucionas:

  1. Averigua qué plugin hace la solicitud. El nombre suele aparecer en el propio mensaje o en las líneas anteriores.
  2. Actualiza ese plugin complementario a una versión que funcione con tu WorldEdit o FastAsyncWorldEdit (FAWE, una variante más rápida de WorldEdit).
  3. Si no existe, desactiva la conexión con WorldEdit en la configuración del plugin complementario, si hay un ajuste para ello.
  4. Reinicia y comprueba si el mensaje ha desaparecido.

Conviene saber: Hasta que se solucione, no puedes confiar en que los cambios de WorldEdit se registren o se puedan deshacer por esa vía.

Braslety: la receta no se registra

Así se ve el mensaje:

[Braslety] … java.lang.IllegalAccessException: class com.example.braslety.BraceletsPlugin cannot access …

Qué hay detrás: Braslety accede mediante reflection a clases internas de CraftBukkit. Reflection significa que el plugin lee partes del servidor directamente en lugar de usar la interfaz oficial. En la versión de tu servidor estas partes no son accesibles y Java deniega el acceso. Por eso la receta afectada no se registra y el objeto correspondiente no se puede fabricar. El servidor sigue funcionando.

Así lo solucionas:

  1. Comprueba si existe una versión de Braslety para tu build actual de Paper. Tu versión la ves en Versión.
  2. Si existe, sustituye el archivo antiguo en Archivos, en la carpeta plugins/, y reinicia.
  3. Si no existe, sustituye el plugin por uno mantenido con una función similar.
  4. Comprueba en el juego si la receta funciona.

Conviene saber: El nombre de paquete com.example indica un plugin hecho a medida o poco extendido. En ese caso, solo su creador puede ofrecer una actualización.

ViaVersion no puede cargar un módulo de traducción

Así se ve el mensaje:

[ViaVersion] Error during loading of Protocol<Version>To<Version>

Qué hay detrás: ViaVersion traduce entre versiones del juego para que también puedan entrar jugadores con clientes más nuevos o más antiguos. Extensiones como ViaBackwards lo complementan para los clientes más antiguos. Cada traducción está en un módulo propio cuyo nombre empieza por Protocol. Uno de ellos no se pudo cargar, normalmente porque ViaVersion y sus extensiones no son compatibles entre sí o con la versión del servidor. Los jugadores con las versiones de cliente afectadas no pueden entrar. Quien juega exactamente con la versión del servidor no se ve afectado.

Así lo solucionas:

  1. Descarga las versiones más recientes de ViaVersion y de todas las extensiones Via que utilices.
  2. Reemplaza todas juntas en Archivos, en la carpeta plugins/. No mezcles archivos Via antiguos y nuevos.
  3. Reinicia el servidor por completo.
  4. Prueba a entrar con la versión de cliente que antes no funcionaba.

Con más detalle: Configurar ViaVersion: conectar clientes más antiguos y más nuevos

LibreLogin no funciona en Spigot

Así se ve el mensaje:

[LibreLogin] Detected an unsupported server distribution. Please use Paper or its forks. SPIGOT IS NOT SUPPORTED!

Qué hay detrás: LibreLogin es un plugin de inicio de sesión: los jugadores se identifican con una contraseña. Esto es especialmente importante en servidores en modo offline. LibreLogin necesita Paper o un fork compatible, es decir, una variante de Paper como Purpur, y se desactiva en Spigot. Si tu servidor funciona en modo offline, falta la protección por contraseña: los jugadores pueden conectarse con nombres ajenos.

Así lo solucionas:

  1. Crea una copia de seguridad en Copias de seguridad.
  2. Cambia el servidor a Paper o Purpur en Cambiar software / cargador. Los plugins para Spigot suelen seguir funcionando allí.
  3. Reinicia y comprueba en la Consola si LibreLogin se carga sin este mensaje.
  4. Si quieres seguir con Spigot, usa un plugin de inicio de sesión que sea compatible con Spigot de forma explícita.

Conviene saber: Si tu servidor funciona en modo offline, soluciónalo antes de que entren jugadores.

Más información: Cambiar el software y la versión del servidor en el panel

A Nova le falta un parámetro de inicio de Java (-javaagent)

Así se ve el mensaje:

[Nova] Missing required JVM argument: -javaagent:plugins/Nova-<Version>.jar

Qué hay detrás: Nova es un plugin muy completo que permite bloques e ítems propios en servidores Paper. Para una parte de sus funciones, Java debe cargar al iniciarse un llamado agente de Java. Se trata de un complemento que se activa antes del servidor propiamente dicho y se incorpora mediante un parámetro de inicio. Tu servidor arranca sin este parámetro. Por eso Nova no funciona por completo, aunque el servidor en sí sí funciona.

Así lo solucionas:

  1. Lee en el mensaje el parámetro exacto, incluido el nombre de archivo del JAR de Nova.
  2. El comando de inicio de tu servidor de Minecraft no puedes cambiarlo tú mismo en el panel. Por eso, abre un ticket, copia en él el parámetro del mensaje e indica la hora a la que apareció.
  3. Si no necesitas Nova de forma imprescindible, elimina el plugin en Plugins y reinicia el servidor. El mensaje desaparecerá.

Conviene saber: Con cada nueva versión de Nova suele cambiar también el nombre de archivo en el parámetro. Por eso, tras una actualización de Nova, el mensaje suele volver a aparecer.

¿Tu mensaje no aparece aquí?

Lee el mensaje completo en la Consola o en logs/latest.log, incluidas las líneas anteriores. El plugin afectado lo reconoces por el nombre entre corchetes al principio de la línea o en el stacktrace, la lista de líneas at …: ahí aparecen nombres de JAR de plugins/ o mods/ y nombres de paquetes que a menudo contienen el nombre del plugin. Después compara en la página del plugin las versiones compatibles con tu servidor. Crea una copia de seguridad antes de cada cambio de versión. Si no consigues avanzar, abre un ticket e indica la hora del mensaje.