Un plugin Minecraft se présente sous forme de fichier JAR (une archive Java) dans le dossier plugins/ et il est toujours conçu pour certaines versions de Minecraft, une version précise de Java et, le plus souvent, un logiciel de serveur précis comme Paper ou Spigot. Si l'un de ces éléments ne correspond pas, le plugin ne se charge pas du tout, se désactive de lui-même ou certaines fonctions ne marchent plus. Chaque section ci-dessous traite d'un message concret : à quoi il ressemble, ce qui se cache derrière et comment le corriger.

Tu trouveras le message complet dans la Console ou sous Fichiers dans logs/latest.log. Lis aussi les lignes qui précèdent : le plugin concerné y figure souvent. Chez nous, la version de Java est définie automatiquement en fonction de la version de Minecraft. Les versions prises en charge par un plugin sont indiquées sur sa page de téléchargement. Avant de changer de version ou de modifier des fichiers de configuration et de monde, crée une sauvegarde sous Sauvegardes.

Un plugin ou le serveur nécessite une version de Java plus récente (UnsupportedClassVersionError)

Voici à quoi ressemble le message :

[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

Ce qui se cache derrière : les programmes Java sont compilés pour une version précise de Java. Le fichier mentionné dans le message exige une version de Java plus récente que celle que ton serveur utilise actuellement. Les chiffres t'indiquent laquelle : le nombre moins 44 donne la version de Java, donc 69 correspond à Java 25 et 65 à Java 21. Si le message mentionne un plugin, ce plugin ne démarre pas. S'il concerne le JAR du serveur lui-même, tout le serveur ne démarre pas.

Voici comment le résoudre :

  1. Lis le nom du fichier après Could not load plugin. C'est le fichier qui ne convient pas.
  2. Sur la page du plugin, télécharge la version conçue pour ta version de Minecraft.
  3. Remplace l'ancien fichier dans Fichiers, dans le dossier plugins/, puis redémarre le serveur.
  4. Si tu as absolument besoin de cette version du plugin, passe le serveur dans Version sur la version de Minecraft qu'elle exige. La version de Java adaptée est définie automatiquement chez nous pour chaque version de Minecraft. Crée une sauvegarde au préalable.

Bon à savoir : le dossier plugins/.paper-remapped est une copie de travail de Paper. Remplace toujours le fichier directement dans plugins/.

En détail : Quelle version de Java ton serveur Minecraft nécessite-t-il ?

Le plugin est conçu pour une version de Minecraft plus récente (Unsupported API version)

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : chaque plugin contient un petit fichier de présentation, le plugin.yml. Il indique sous api-version pour quelle version du serveur le plugin a été écrit. Si cette version est plus récente que ton serveur, Paper ne charge pas du tout le plugin, par exemple avec Unsupported API version 26.1 sur un serveur en 1.21.11. Le serveur démarre, mais tout ce que le plugin devait apporter est absent : commandes, règles de protection, menus.

Voici comment le résoudre :

  1. Compare le nombre après Unsupported API version avec la version de Minecraft de ton serveur dans Version.
  2. Sur Modrinth ou SpigotMC, filtre les téléchargements du plugin selon ta version de Minecraft et télécharge la version adaptée.
  3. Remplace l'ancien fichier dans Fichiers, dans le dossier plugins/, puis redémarre.
  4. S'il n'existe pas de version adaptée, passe le serveur dans Version sur la version que le plugin exige. Crée une sauvegarde au préalable, car le monde est converti vers la nouvelle version.

Bon à savoir : ne modifie pas toi-même l'api-version dans le fichier du plugin. Le plugin se chargerait alors, mais utiliserait des fonctions que ton serveur n'a pas, et finirait par planter avec d'autres erreurs.

Plus d'infos : Changer de version de Minecraft et de chargeur de mods en toute sécurité

Un ancien serveur Paper ne peut pas convertir un nouveau plugin (Fatal error trying to convert)

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : Paper en version 1.19.4 ou antérieure convertit les plugins au chargement avec un convertisseur intégré. Ce convertisseur ne sait pas lire les classes compilées pour Java 21 ou plus récent (major version 65 correspond à Java 21, 69 à Java 25). Le plugin n'est donc pas chargé. Cela touche souvent Geyser : dans ce cas, aucun joueur Bedrock ne peut rejoindre. Le serveur lui-même démarre et les joueurs Java peuvent toujours se connecter.

Voici comment le résoudre :

  1. Lis le nom après trying to convert. C'est le plugin concerné.
  2. Si tu veux rester sur ta version de Minecraft, télécharge une version plus ancienne du plugin, conçue précisément pour cette version, et remplace-la dans Fichiers, dans le dossier plugins/.
  3. Sinon, passe le serveur dans Version sur Minecraft 1.20.5 ou plus récent. Les builds Paper plus récents savent lire les classes Java 21. Crée une sauvegarde au préalable.
  4. Redémarre et vérifie dans la Console que le plugin se charge sans erreur.

Bon à savoir : le message apparaît souvent plusieurs fois de suite, une fois par classe. Un seul plugin est malgré tout concerné.

En détail : Quelle version de Java ton serveur Minecraft nécessite-t-il ?

Le plugin indique : cette version du serveur n'est pas prise en charge

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : au démarrage, le plugin vérifie sur quelle version de Minecraft et quel logiciel serveur il tourne. Si aucun des deux ne figure sur sa liste, il affiche un avertissement ou se désactive en totalité ou en partie. La cause peut être une version trop récente ou trop ancienne, ou un logiciel serveur inadapté. Le serveur lui-même continue de tourner.

Voici comment le résoudre :

  1. Saisis plugins dans la Console. Les plugins affichés en vert sont actifs, ceux en rouge sont désactivés.
  2. Consulte la page du plugin pour savoir quelles versions de Minecraft et quels logiciels serveur sont pris en charge.
  3. Télécharge la version adaptée et remplace l'ancien fichier dans Fichiers, dans le dossier plugins/.
  4. S'il n'y en a pas, choisis dans Version une version de Minecraft prise en charge par le plugin. S'il exige un autre logiciel serveur, utilise Changer de logiciel / chargeur. Crée une sauvegarde au préalable.

Bon à savoir : si le plugin reste vert malgré l'avertissement, les fonctions de base fonctionnent généralement. Teste les commandes dont tu as besoin et installe la mise à jour dès qu'elle sort.

Paper ne peut pas adapter un ancien plugin à la version du serveur (PluginRemapper)

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : les versions récentes de Paper réécrivent automatiquement au démarrage les anciens plugins selon la structure interne de la version actuelle de Minecraft. Cette réécriture s'appelle le remapping, et Paper place les copies terminées dans plugins/.paper-remapped. Pour au moins un plugin, cela a échoué. Le serveur démarre quand même, mais le plugin ne fonctionne peut-être pas du tout ou seulement en partie, souvent sans autre message d'erreur.

Voici comment le résoudre :

  1. Lis le nom du fichier après Failed to remap plugin jar.
  2. Si le nom contient quelque chose comme (1), le fichier est probablement présent en double dans le dossier. Supprime la copie en trop dans Fichiers.
  3. Télécharge une version du plugin explicitement conçue pour ta version de Minecraft. Paper n'a alors rien à réécrire. Remplace l'ancien fichier dans plugins/ par celle-ci.
  4. Redémarre et vérifie que le message a disparu.

Bon à savoir : s'il n'existe pas de version adaptée, le plugin n'est pas encore prêt pour la version de ton serveur. Supprime-le ou attends une mise à jour.

Fichiers en double : Fichier de plugin endommagé, en double ou absent

Nom de bloc ou d'objet inconnu dans la configuration d'un plugin (Unsupported key)

Voici à quoi ressemble le message :

Unsupported key: minecraft:bed

Ce qui se cache derrière : Minecraft référence chaque bloc et chaque objet sous un nom fixe de la forme minecraft:<nom>, appelé clé de registre. Un plugin ou sa configuration mentionne un nom que ta version de Minecraft ne connaît pas. Exemple typique : minecraft:bed. Depuis la 1.13, les lits portent le nom de leur couleur, par exemple red_bed. L'entrée est ignorée, le serveur et le reste du plugin continuent de fonctionner.

Voici comment le résoudre :

  1. Regarde dans la Console ou dans logs/latest.log les lignes précédant le message. Elles indiquent quel plugin est en cours de chargement.
  2. Dans Fichiers, ouvre la configuration de ce plugin dans le dossier plugins/<Plugin>/ et cherche le nom mentionné.
  3. Remplace-le par la désignation actuelle, que tu trouveras dans le wiki Minecraft. Les configurations au format YAML (.yml) sont sensibles : ne modifie ni l'indentation ni les guillemets.
  4. Redémarre le serveur. Si le nom ne figure pas dans ta configuration mais dans le plugin lui-même, seule une mise à jour du plugin peut aider.

En cas d'erreurs dans le fichier : La configuration d'un plugin est défectueuse

Le plugin nécessite une bibliothèque de texte (Adventure) plus récente que celle de ton serveur

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : Adventure est la bibliothèque avec laquelle Paper génère les textes de chat colorés, les titres et les textes au survol. Elle est intégrée de façon fixe au serveur, sa version dépend donc de ta version de Minecraft. Le plugin a été compilé avec une version d'Adventure plus récente, et la classe mentionnée est absente de ton serveur. Certaines parties du plugin ne démarrent donc pas. Le serveur continue de fonctionner.

Voici comment le corriger :

  1. Détermine quel plugin est concerné. Dans la stacktrace, c'est-à-dire la liste des lignes at … sous le message, on trouve souvent le nom du fichier JAR. Sinon, les lignes qui précèdent peuvent t'aider.
  2. Télécharge une version plus ancienne du plugin, compilée pour la version de ton serveur, et remplace le fichier dans Fichiers, dans le dossier plugins/.
  3. Ou passe ton serveur à une version de Minecraft plus récente dans Version. Crée une sauvegarde au préalable.

Bon à savoir : Ajouter un fichier Adventure supplémentaire dans le dossier plugins/ n'aide pas, car Paper utilise sa version intégrée.

ProtocolLib n'est pas compatible avec la version du serveur

Voici à quoi ressemble le message :

[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 …

Ce qui se cache derrière : ProtocolLib est une bibliothèque d'aide par laquelle d'autres plugins lisent et modifient des paquets réseau. Pour cela, elle accède en profondeur aux composants internes du serveur, et ceux-ci changent avec presque chaque version de Minecraft. Si ProtocolLib ne trouve pas les champs de paquets attendus, il ne se charge pas. Tous les plugins qui ont besoin de ProtocolLib ne fonctionnent alors pas non plus.

Voici comment le corriger :

  1. Télécharge la toute dernière build de ProtocolLib pour ta version actuelle de Minecraft. Pour les versions très récentes, les builds adaptées sont souvent d'abord disponibles en préversion sur la page du projet.
  2. Remplace l'ancien fichier dans Fichiers, dans le dossier plugins/. Ne garde qu'un seul fichier ProtocolLib.
  3. Redémarre complètement le serveur, c'est-à-dire arrête-le puis relance-le, et non avec /reload.
  4. Saisis plugins dans la Console et vérifie que ProtocolLib et les plugins dépendants sont en vert.

Bon à savoir : La demande d'ouvrir un ticket chez ProtocolLib vient du plugin lui-même. Le plus souvent, il manque simplement la build adaptée.

Plugins dépendants : Le plugin a besoin d'un autre plugin qui est absent

Citizens se désactive : la build ne correspond pas à la version de Minecraft

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : Citizens est un plugin pour les PNJ, c'est-à-dire des personnages contrôlés par l'ordinateur, comme des marchands ou des donneurs de quêtes. Chaque build de Citizens ne prend en charge que certaines versions de Minecraft et certaines builds de serveur. Si elle ne correspond pas à ton serveur, Citizens se désactive au démarrage. Tes PNJ n'apparaissent alors pas, et les plugins qui s'appuient sur Citizens perdent cette fonctionnalité. Le serveur lui-même continue de fonctionner.

Voici comment le corriger :

  1. Vérifie dans Version quelle version de Minecraft ton serveur utilise.
  2. Télécharge la build de Citizens pour exactement cette version. De nombreuses builds de Citizens ont SNAPSHOT dans leur nom ; ce qui compte, c'est la version de Minecraft indiquée sur la page de téléchargement.
  3. Remplace l'ancien fichier dans Fichiers, dans le dossier plugins/, puis redémarre.
  4. S'il n'existe pas de build adaptée, ajuste la version du serveur dans Version. Crée une sauvegarde au préalable.

Bon à savoir : try upgrading or downgrading signifie que Citizens peut être trop ancien ou trop récent. Le fichier le plus récent n'est donc pas forcément le bon.

Le plugin indique : non compatible avec ta version de Minecraft

Voici à quoi ressemble le message :

[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

Ce qui se cache derrière : Le plugin est conçu pour une autre version de Minecraft ou un autre logiciel de serveur, et il le signale lui-même. Des formulations similaires sont This plugin only supports Spigot-API … ou Unable to load Adventure, chat components will not work. Selon le plugin, il se désactive entièrement, ou certaines fonctions cessent de marcher, par exemple les textes de chat colorés. Le serveur continue de fonctionner.

Voici comment le corriger :

  1. Lis le nom du plugin entre crochets au début de la ligne. S'il est absent, il se trouve dans les lignes qui précèdent.
  2. Consulte la page du plugin pour savoir quelles versions de Minecraft et quel logiciel de serveur il prend en charge.
  3. Télécharge la version adaptée et remplace l'ancien fichier dans Fichiers, dans le dossier plugins/.
  4. S'il n'y en a pas, passe le serveur à la version que le plugin exige dans Version. Crée une sauvegarde au préalable.
  5. Après le redémarrage, saisis plugins dans la Console et vérifie que le plugin est en vert.

Bon à savoir : Passer à une version plus récente de Minecraft convertit le monde. Pour revenir en arrière de façon fiable, il faut passer par la sauvegarde.

Le plugin nécessite une build de Paper plus récente pour ta version de Minecraft

Voici à quoi ressemble le message :

[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: …

Ce qui se cache derrière : Paper continue d'évoluer, même au sein d'une même version de Minecraft ; chaque publication s'appelle une build. Le plugin accède à un champ de l'API de Paper, dans la partie qui télécharge au démarrage les bibliothèques supplémentaires pour les plugins. Ce champ (MAVEN_CENTRAL_DEFAULT_MIRROR) n'existe que dans les builds plus récentes. Il est absent de ta build, c'est pourquoi le plugin ne se charge pas. Le serveur lui-même continue de fonctionner.

Voici comment le corriger :

  1. Ouvre Version dans le panel et mets à jour vers la toute dernière build de Paper pour ta version de Minecraft.
  2. Redémarre et vérifie dans la Console que le plugin se charge maintenant sans erreur.
  3. Si tu ne veux pas changer de build, utilise une version plus ancienne du plugin et remplace le fichier dans Fichiers, dans le dossier plugins/.

Bon à savoir : Une build plus récente de la même version de Minecraft est une petite étape. Le monde reste sur la même version de Minecraft. Une sauvegarde au préalable ne fait pas de mal pour autant.

Le plugin ne trouve pas des éléments internes du serveur (Failed to init reflection)

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : Certains plugins n'utilisent pas uniquement l'interface officielle du serveur, mais lisent directement des classes internes par leur nom. C'est ce qu'on appelle la réflexion (reflection). Ces éléments internes changent avec presque chaque version de Minecraft. Si le plugin ne trouve pas ce qu'il attend, c'est qu'il a été compilé pour une autre version du serveur, et les fonctions qui en dépendent cessent de marcher. Le serveur continue de fonctionner.

Voici comment le corriger :

  1. Le message lui-même ne cite aucun plugin. Regarde dans la Console ou dans logs/latest.log les lignes juste avant. Elles indiquent quel plugin était en cours de chargement.
  2. Mets à jour ce plugin vers une version pour ta version de serveur et remplace le fichier dans Fichiers, dans le dossier plugins/.
  3. Redémarre et vérifie que le message a disparu.

Bon à savoir : S'il n'existe pas de version plus récente, le plugin n'est probablement plus maintenu. Dans ce cas, il vaut la peine de chercher un plugin de remplacement à jour offrant la même fonction.

Les effets lumineux d'un plugin sont désactivés (GlowingEntities)

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : GlowingEntities n'est pas un plugin à part entière, mais une brique que d'autres plugins embarquent pour faire briller des joueurs, des mobs ou des objets. Cette brique ne trouve pas un champ interne de ta build de serveur. C'est pourquoi les effets lumineux du plugin concerné sont désactivés. Le serveur continue de tourner, et le plugin lui-même continue généralement de fonctionner sans ces effets.

Voici comment corriger le problème :

  1. Trouve le plugin qui embarque GlowingEntities. Dans les lignes at … sous le message, tu trouveras une entrée de la forme <Plugin>.jar//….
  2. Télécharge ce plugin dans une version prévue pour ta build Paper.
  3. Remplace l'ancien fichier dans Fichiers, dans le dossier plugins/, puis redémarre.

Bon à savoir : tu ne peux pas mettre à jour GlowingEntities séparément. C'est le développeur du plugin qui embarque cette brique qui s'en charge. Si tu n'as pas besoin des effets lumineux, tu peux ignorer le message jusqu'à la prochaine mise à jour.

Simple_RTP : les têtes dans le menu ne s'affichent pas

Voici à quoi ressemble le message :

[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

Ce qui se cache derrière : Simple_RTP est un plugin de téléportation aléatoire. Pour les têtes de son menu, il définit un profil de joueur dans l'ancien format (GameProfile). Or ta version de Minecraft attend ici un format plus récent (ResolvableProfile). Les deux ne sont pas compatibles, c'est pourquoi les têtes du menu ne fonctionnent pas. Le serveur continue de tourner.

Voici comment corriger le problème :

  1. Vérifie dans Version quelle version de Minecraft utilise ton serveur.
  2. Télécharge Simple_RTP dans la version prévue pour cette version de Minecraft.
  3. Remplace l'ancien fichier dans Fichiers, dans le dossier plugins/, puis redémarre.
  4. Ouvre le menu en jeu et vérifie si les têtes s'affichent maintenant.

Bon à savoir : le message peut se répéter à chaque ouverture du menu. Il ne cause pas d'autres dégâts, il indique seulement que la version du plugin est obsolète.

ZNPCs : les PNJ enregistrés ne correspondent pas à la version du plugin

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : ZNPCs enregistre tes PNJ avec leur type et leurs actions dans un fichier. Ce fichier contient un type ou une action que ta version installée de ZNPCs ne connaît pas, par exemple ActionType.PLAYER. Cela arrive généralement quand les PNJ ont été créés avec une autre version de ZNPCs. La commande exécutée est interrompue, le serveur continue de tourner.

Voici comment corriger le problème :

  1. Crée une sauvegarde dans Sauvegardes.
  2. Installe la version de ZNPCs avec laquelle les PNJ ont été créés, puis redémarre.
  3. Si ce n'est pas possible, arrête le serveur, ouvre le fichier plugins/ZNPCs/data.json dans Fichiers et supprime l'entrée du PNJ concerné. Le JSON est un format texte avec des accolades et des virgules : une virgule manquante rend tout le fichier illisible.
  4. Démarre le serveur et teste à nouveau la commande.

Bon à savoir : ne modifie le fichier que lorsque le serveur est arrêté. S'il tourne, ZNPCs peut écraser ta modification à l'arrêt.

Le plugin nécessite Paper ou une version plus récente (failed to register events)

Voici à quoi ressemble le message :

Plugin <Plugin> v<Version> has failed to register events for class <Class> because io/papermc/paper/event/<Event> does not exist.

Ce qui se cache derrière : les plugins réagissent à des événements du jeu, par exemple quand un joueur casse un bloc. Ce plugin veut écouter un événement que ton logiciel de serveur ne connaît pas. Le plus souvent, le plugin est écrit pour Paper alors que le serveur tourne avec Spigot. Ou alors l'événement n'existe que dans une version plus récente de Minecraft. La partie concernée du plugin ne fonctionne pas, le serveur continue de tourner.

Voici comment corriger le problème :

  1. Lis le nom après because. S'il commence par io/papermc/paper ou com/destroystokyo/paper, le plugin nécessite Paper.
  2. Si ton serveur tourne avec Spigot, passe-le à Paper via Changer de logiciel / chargeur. Les plugins pour Spigot fonctionnent en règle générale aussi sur Paper. Crée d'abord une sauvegarde.
  3. S'il tourne déjà avec Paper, l'événement est plus récent que ta version. Utilise une version du plugin adaptée à ta version de Minecraft ou change la version du serveur dans Version.
  4. Redémarre et vérifie si le message a disparu.

Plus d'infos : Changer le logiciel et la version du serveur dans le panel

Le fichier est compilé pour une version de Java plus récente (Unsupported class file major version)

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : les plugins, mods et bibliothèques sont compilés pour une version de Java précise. Le nombre après major version indique laquelle : ce nombre moins 44 donne la version de Java, donc 65 correspond à Java 21 et 69 à Java 25. Les outils de ton serveur, qui lisent ou réécrivent les plugins et mods lors du chargement, ne comprennent pas cette version plus récente. La partie concernée n'est pas chargée.

Voici comment corriger le problème :

  1. Dans les lignes précédentes, repère quel plugin ou quel mod était en cours de chargement.
  2. Télécharge une version compilée pour ta version de Minecraft et remplace l'ancien fichier dans Fichiers, dans le dossier plugins/ ou mods/.
  3. Sinon, mets à jour le serveur dans Version vers une version de Minecraft plus récente qui fonctionne avec Java 21 ou plus. La version de Java adaptée est définie automatiquement chez nous. Crée d'abord une sauvegarde.

Bon à savoir : si Fatal error trying to convert apparaît juste avant, la section sur les anciens serveurs Paper plus haut s'applique.

En détail : Quelle version de Java faut-il pour ton serveur Minecraft ?

Un ancien plugin cherche une fonction de chunk supprimée (IDs Legacy)

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : jusqu'à Minecraft 1.12, les blocs avaient des IDs numériques, la pierre étant par exemple le 1. Certains anciens plugins calculent encore en interne avec ces IDs Legacy et accèdent pour cela directement à des fonctions internes du jeu, les classes sous net.minecraft. La fonction de chunk recherchée n'existe plus dans ta version. La fonction d'IDs Legacy du plugin ne démarre donc pas. Selon le plugin, quelques fonctions ou beaucoup de fonctions sont alors indisponibles.

Voici comment corriger le problème :

  1. Regarde la stacktrace sous le message, c'est-à-dire les lignes at …. Tu y trouveras le nom du plugin ou de son fichier JAR.
  2. Mets ce plugin à jour vers une version pour ta version de Minecraft et remplace le fichier dans Fichiers, dans le dossier plugins/.
  3. S'il n'en existe pas, le plugin n'est plus maintenu pour les versions modernes. Cherche un plugin de remplacement actuel.

Bon à savoir : le nom court k est un nom interne obfusqué. Ces noms changent à chaque version de Minecraft. Les plugins qui les utilisent directement cessent donc de fonctionner à presque chaque mise à jour.

Le plugin utilise une fonction de profil Mojang obsolète (têtes de joueurs)

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : authlib est la bibliothèque de Mojang qui permet au serveur de gérer les profils des joueurs avec leur nom et leur skin. Le plugin lit ces profils via une méthode (GameProfile.getProperties) qui n'existe plus dans ta version de Minecraft. La fonction concernée ne marche plus, ce sont généralement les têtes de joueurs dans les menus. Le serveur continue de tourner.

Comment corriger le problème :

  1. Trouve le plugin : son nom ou celui de son fichier JAR figure dans les lignes at … sous le message ou dans les lignes qui le précèdent.
  2. Télécharge une version de ce plugin compatible avec ta version de Minecraft.
  3. Remplace l'ancien fichier dans Fichiers, dans le dossier plugins/, puis redémarre.
  4. Ouvre le menu concerné en jeu et vérifie que les têtes s'affichent à nouveau.

Bon à savoir : ce changement touche en même temps de nombreux plugins de menus et de têtes. Si plusieurs plugins n'affichent plus de têtes, la cause est généralement la même, et chacun a besoin de sa propre mise à jour.

Le plugin cherche des blocs, particules ou attributs qui n'existent pas dans ta version

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : chaque version de Minecraft apporte de nouveaux blocs, particules et attributs, et en renomme certains. Le plugin est conçu pour une autre version et accède à quelque chose qui n'existe pas ici ou qui porte un autre nom. Selon le plugin, l'erreur apparaît à chaque action, ou certaines fonctions cessent de marcher. Could not initialize Brigadier mappings en fait aussi partie. Brigadier est le système de commandes de Minecraft, qui fournit entre autres l'autocomplétion avec la touche Tab.

Comment corriger le problème :

  1. Repère le nom du plugin dans les lignes qui précèdent ou dans les lignes at … en dessous.
  2. Télécharge la version du plugin qui correspond à ta version de Minecraft et remplace le fichier dans Fichiers, dans le dossier plugins/.
  3. Ou bien, passe le serveur dans Version à la version de Minecraft requise par le plugin. Crée d'abord une sauvegarde.
  4. Si le nom inconnu se trouve dans un fichier de configuration du plugin, par exemple pour les boutons de menu, tu peux le remplacer là par la désignation actuelle.

Le plugin Marriage n'est pas compatible avec la version de Minecraft

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : Marriage permet aux joueurs de se marier en jeu et propose pour cela des fonctions comme le baiser. Le plugin ne prend pas en charge ta version de Minecraft. Il désactive donc au moins la fonction de baiser, et d'autres parties peuvent aussi être touchées. Le serveur continue de tourner normalement.

Comment corriger le problème :

  1. Regarde sur la page du plugin s'il existe une version de Marriage pour ta version de Minecraft. Tu vois ta version dans Version.
  2. S'il en existe une, remplace l'ancien fichier dans Fichiers, dans le dossier plugins/, puis redémarre.
  3. S'il n'en existe pas, remplace le plugin par un plugin récent aux fonctions similaires. Attends-toi à ce qu'un autre plugin ne reprenne pas les données enregistrées par Marriage, et crée d'abord une sauvegarde.

Bon à savoir : si seule l'absence de la fonction de baiser te gêne et que le reste fonctionne, tu peux ignorer le message jusqu'à la sortie d'une mise à jour.

Le plugin anticheat ou de paquets ne connaît pas encore entièrement ta version de Minecraft

Voici à quoi ressemble le message :

java.lang.IllegalStateException: Unknown entity metadata type id: <Number> version V_<Version>

Ce qui se cache derrière : certains plugins lisent les paquets réseau échangés entre le jeu et le serveur, par exemple l'anticheat GrimAC via la bibliothèque PacketEvents. Avec les nouvelles versions de Minecraft arrivent de nouveaux types de données pour les créatures et les objets, les métadonnées d'entités. Le plugin n'en connaît pas encore un, généralement parce qu'il est plus ancien que la version de ton serveur. Les paquets concernés sont mal traités. Cela peut provoquer de fausses alertes de l'anticheat ou des problèmes de connexion.

Comment corriger le problème :

  1. Mets à jour le plugin et, s'il est installé comme fichier séparé, PacketEvents également, vers une version qui prend explicitement en charge ta version de Minecraft.
  2. Redémarre complètement le serveur.
  3. S'il n'existe pas encore de version adaptée, désactive temporairement le plugin : renomme son fichier dans Fichiers, par exemple en <Plugin>.jar.off. Le serveur ne charge que les fichiers avec l'extension .jar.
  4. Sinon, utilise dans Version une version de Minecraft prise en charge par le plugin. Crée d'abord une sauvegarde.

Un plugin complémentaire de WorldEdit utilise une interface supprimée

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : WorldEdit a supprimé une ancienne interface, l'EditSessionFactory. Elle permettait aux plugins complémentaires de s'intégrer à chaque modification de WorldEdit. Un plugin complémentaire, par exemple pour les journaux de blocs ou la protection de zones, essaie encore de l'utiliser. WorldEdit lui-même fonctionne normalement. Mais la fonction de journalisation ou de protection du plugin complémentaire n'agit pas sur les modifications de WorldEdit : ce que tu construis ou supprimes avec WorldEdit n'est ni enregistré ni bloqué par lui.

Comment corriger le problème :

  1. Trouve quel plugin envoie la requête. Le nom figure généralement dans le message lui-même ou dans les lignes qui le précèdent.
  2. Mets à jour ce plugin complémentaire vers une version compatible avec ton WorldEdit ou FastAsyncWorldEdit (FAWE, une variante plus rapide de WorldEdit).
  3. S'il n'en existe pas, désactive l'intégration de WorldEdit dans la configuration du plugin complémentaire, si un paramètre existe pour cela.
  4. Redémarre et vérifie que le message a disparu.

Bon à savoir : tant que le problème n'est pas résolu, tu ne peux pas compter sur l'enregistrement des modifications de WorldEdit dans les journaux ni sur la possibilité de les annuler par ce biais.

Braslety : la recette n'est pas enregistrée

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : Braslety accède par Reflection à des classes internes de CraftBukkit. Reflection signifie que le plugin lit directement des parties du serveur au lieu d'utiliser l'interface officielle. Dans la version de ton serveur, ces parties ne sont pas accessibles et Java refuse l'accès. La recette concernée n'est donc pas enregistrée, et l'objet correspondant ne peut pas être fabriqué. Le serveur continue de tourner.

Comment corriger le problème :

  1. Vérifie s'il existe une version de Braslety pour ta build Paper actuelle. Tu vois ta version actuelle dans Version.
  2. S'il en existe une, remplace l'ancien fichier dans Fichiers, dans le dossier plugins/, puis redémarre.
  3. S'il n'en existe pas, remplace le plugin par un plugin maintenu aux fonctions similaires.
  4. Vérifie en jeu que la recette fonctionne.

Bon à savoir : le nom de paquet com.example indique un plugin créé par un particulier ou peu répandu. Dans ce cas, seul son créateur peut fournir une mise à jour.

ViaVersion ne parvient pas à charger un module de traduction

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : ViaVersion assure la traduction entre les versions du jeu, afin que les joueurs avec des clients plus récents ou plus anciens puissent aussi se connecter. Des extensions comme ViaBackwards complètent cela pour les clients plus anciens. Chaque traduction se trouve dans un module distinct dont le nom commence par Protocol. L'un d'eux n'a pas pu être chargé, le plus souvent parce que ViaVersion et ses extensions ne sont pas compatibles entre eux ou avec la version du serveur. Les joueurs avec les versions de client concernées ne peuvent alors pas se connecter. Ceux qui jouent exactement dans la version du serveur ne sont pas concernés.

Voici comment résoudre le problème :

  1. Télécharge les dernières versions de ViaVersion et de toutes les extensions Via que tu utilises.
  2. Remplace-les toutes ensemble dans Fichiers, dans le dossier plugins/. Ne mélange pas d'anciens et de nouveaux fichiers Via.
  3. Redémarre complètement le serveur.
  4. Teste la connexion avec la version du client qui ne fonctionnait pas auparavant.

Pour plus de détails : Configurer ViaVersion : connecter des clients plus anciens et plus récents

LibreLogin ne fonctionne pas sur Spigot

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : LibreLogin est un plugin de connexion : les joueurs s'identifient avec un mot de passe. C'est surtout important sur les serveurs en mode hors ligne. LibreLogin nécessite Paper ou un fork compatible, c'est-à-dire une variante de Paper comme Purpur, et se désactive sur Spigot. Si ton serveur est en mode hors ligne, la protection par mot de passe est donc absente : des joueurs peuvent se connecter sous le nom de quelqu'un d'autre.

Voici comment résoudre le problème :

  1. Crée une sauvegarde dans Sauvegardes.
  2. Passe le serveur à Paper ou Purpur dans Changer de logiciel / chargeur. Les plugins pour Spigot y fonctionnent en général sans problème.
  3. Redémarre et vérifie dans la Console que LibreLogin se charge sans ce message.
  4. Si tu veux rester sur Spigot, utilise un plugin de connexion qui prend explicitement en charge Spigot.

Bon à savoir : si ton serveur est en mode hors ligne, résous ce problème avant que des joueurs ne se connectent.

Plus d'informations : Changer le logiciel et la version du serveur dans le panel

Nova : un paramètre de démarrage Java (-javaagent) est manquant

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : Nova est un plugin très complet qui permet d'ajouter des blocs et des objets personnalisés sur les serveurs Paper. Pour une partie de ses fonctions, Java doit charger un agent Java au démarrage. Il s'agit d'un composant qui devient actif avant même le serveur proprement dit et qui est intégré via un paramètre de démarrage. Ton serveur démarre sans ce paramètre. Nova ne fonctionne donc pas entièrement, mais le serveur lui-même tourne.

Voici comment résoudre le problème :

  1. Relève dans le message le paramètre exact, y compris le nom de fichier du JAR de Nova.
  2. Tu ne peux pas modifier toi-même la commande de démarrage de ton serveur Minecraft dans le panel. Ouvre donc un ticket, copie-y le paramètre du message et indique l'heure à laquelle le message est apparu.
  3. Si tu n'as pas absolument besoin de Nova, supprime le plugin dans Plugins et redémarre le serveur. Le message disparaîtra alors.

Bon à savoir : à chaque nouvelle version de Nova, le nom de fichier dans le paramètre change généralement aussi. Après une mise à jour de Nova, le message revient donc souvent.

Ton message n'est pas dans la liste ?

Lis le message en entier dans la Console ou dans logs/latest.log, y compris les lignes qui précèdent. Tu reconnais le plugin concerné grâce au nom entre crochets en début de ligne ou dans la stacktrace, la liste des lignes at … : on y trouve des noms de JAR provenant de plugins/ ou mods/ et des noms de paquets qui contiennent souvent le nom du plugin. Compare ensuite, sur la page du plugin, les versions prises en charge avec celle de ton serveur. Crée une sauvegarde avant chaque changement de version. Si tu es bloqué, ouvre un ticket et indique l'heure du message.