Un plugin Minecraft nécessite un autre plugin : résoudre les dépendances

De nombreux plugins et mods reposent sur d'autres : un plugin de boutique a besoin de Vault et d'un plugin d'économie, un plugin de menu a besoin de PlaceholderAPI, un mod Fabric a besoin de Fabric API. Si cette base est absente, trop ancienne ou ne démarre pas elle-même, le plugin dépendant se désactive entièrement ou en partie. Dans la plupart des cas, le serveur continue de fonctionner, seules les fonctions du plugin concerné sont manquantes.

Chaque section ci-dessous traite un message. Tu trouveras le message complet dans la Console ou sous Fichiers dans logs/latest.log. Lis aussi les lignes qui précèdent : elles indiquent souvent quel plugin a échoué en premier. Avant de remplacer des plugins ou de modifier des fichiers de configuration, crée une sauvegarde sous Sauvegardes. Après chaque modification, redémarre complètement le serveur au lieu d'utiliser /reload, afin que tous les plugins se chargent dans le bon ordre.

Une classe est manquante : NoClassDefFoundError et ClassNotFoundException

Voici à quoi ressemble le message :

java.lang.NoClassDefFoundError: org/cloudburstmc/math/GenericMath
	at <Plugin>.jar//org.cloudburstmc.math.vector.Vector3i.from(Vector3i.java:403)
Caused by: java.lang.ClassNotFoundException: <Paquet>.<Classe>

Ce qui se cache derrière : les plugins et les mods pour serveurs Java sont composés de nombreuses classes, c'est-à-dire de petits blocs individuels du programme. Le message indique qu'un plugin ou un mod veut utiliser un bloc qui n'existe pas sur le serveur. Le plus souvent, un autre mod ou un autre plugin est manquant, ou il est installé dans une version qui ne contient pas ou plus ce bloc. Le reste du serveur continue en général de fonctionner, seule la fonction concernée plante.

Voici comment le corriger :

1. Détermine qui déclenche l'erreur. Le nom du plugin après to dans la ligne « Could not pass event … to … » ou le nom du fichier avant .jar// dans la stacktrace te l'indique, donc dans les lignes at … sous le message.
2. Lis le chemin de la classe manquante. Son début indique souvent le projet auquel elle appartient, par exemple org/geysermc pour Geyser.
3. Sur la page du plugin ou du mod concerné, compare les dépendances et versions requises avec tes Plugins ou Mods installés.
4. Installe les dépendances manquantes ou mets tous les éléments concernés dans des versions compatibles entre elles. Redémarre ensuite le serveur.

Bon à savoir : si un fichier de plugin a été remplacé pendant que le serveur tournait, le plugin ne retrouve souvent plus ses propres classes. Dans ce cas, un redémarrage complet suffit.

Une commande ne fonctionne pas car son plugin est désactivé

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : la commande elle-même n'est pas fausse. Elle appartient à un plugin qui n'a pas pu être activé au démarrage du serveur, et c'est pourquoi le serveur répond avec cette erreur à chaque appel. La véritable raison est écrite plus haut dans le log au démarrage, souvent « unsupported server version » : la version du plugin ne correspond pas à la version de ton serveur. Si le plugin remplace des commandes de base comme list, comme le fait EssentialsX, celles-ci ne fonctionnent plus non plus.

Voici comment le corriger :

1. Ouvre le fichier logs/latest.log dans Fichiers et cherche le nom du plugin indiqué dans le message. Les lignes de la phase de démarrage sont importantes, par exemple « Error occurred while enabling … ».
2. Saisis plugins dans la Console. Les plugins désactivés y apparaissent en rouge.
3. Corrige l'erreur de démarrage. Le plus souvent, tu installes dans Plugins une version qui correspond à la version de ton serveur. Tu peux voir la version de ton serveur dans Version. Plus d'infos : Le plugin ne correspond pas à la version du serveur.
4. Redémarre le serveur et vérifie avec plugins si le plugin est maintenant en vert.

Bon à savoir : le message de commande n'est qu'une conséquence. Il disparaît dès que le plugin redémarre correctement.

Vault ou un plugin d'économie est manquant

Voici à quoi ressemble le message :

[<Plugin>] Vault economy not found! Disabling plugin...
[<Plugin>] - Disabled due to no Vault dependency found!

Ce qui se cache derrière : les plugins qui gèrent de l'argent, des prix ou des primes ne gèrent pas eux-mêmes les soldes. Ils accèdent à un plugin d'économie via Vault. Vault n'est que l'interface, les comptes sont tenus par le plugin d'économie. Si l'un des deux manque ou a été chargé après le plugin dépendant, ce dernier se désactive. Le serveur continue de tourner, mais le plugin concerné est entièrement absent.

Voici comment le corriger :

1. Vérifie dans Plugins si Vault est installé.
2. Vérifie si un plugin d'économie compatible avec Vault est installé, par exemple EssentialsX avec EssentialsX Economy, CMI ou XConomy.
3. Installe ce qui manque, à chaque fois dans une version adaptée à la version de ton serveur.
4. Redémarre complètement le serveur. Un /reload ou le rechargement de plugins individuels perturbe facilement l'ordre de chargement.
5. Saisis vault-info dans la Console. À côté de « Economy », ton plugin d'économie devrait maintenant apparaître.

Bon à savoir : le message apparaît aussi lorsque Vault est présent, mais que le plugin d'économie lui-même échoue au démarrage. Cherche alors son nom dans logs/latest.log.

Un plugin ne peut pas enregistrer certains éléments car un autre plugin est manquant

Voici à quoi ressemble le message :

[<Plugin>] Failed to register events for class <Classe> because me/clip/placeholderapi/<Classe> does not exist.
[QuickShop-FindItemAddOn] Uh oh! Looks like either this plugin has crashed or you don't have QuickShop-Hikari installed.

Ce qui se cache derrière : un plugin enregistre ses listeners au démarrage, c'est-à-dire les éléments qui réagissent à des événements comme rejoindre le serveur, casser un bloc ou acheter. Certains d'entre eux nécessitent un autre plugin. S'il est absent, exactement ces éléments ne sont pas enregistrés, le reste du plugin fonctionne. Le chemin après because indique quel plugin est manquant :

• me/clip/placeholderapi appartient à PlaceholderAPI
• net/milkbowl/vault appartient à Vault
• com/ghostchu/quickshop appartient à QuickShop-Hikari
• net/ess3 appartient à EssentialsX

Voici comment le corriger :

1. Associe le chemin du message à un plugin grâce à la liste ci-dessus. Pour d'autres chemins, le nom du projet dans le chemin t'aide, par exemple com/projectkorra pour ProjectKorra.
2. Installe le plugin manquant dans Plugins dans une version adaptée à la version de ton serveur.
3. Redémarre le serveur et vérifie que le message n'apparaît plus au démarrage.

Bon à savoir : si le chemin commence par io/papermc ou org/bukkit, aucun plugin n'est manquant. Dans ce cas, le logiciel de ton serveur est trop ancien pour le plugin ou ce n'est pas le bon logiciel qui tourne, par exemple Spigot au lieu de Paper. Aide à ce sujet : Le plugin ne correspond pas à la version du serveur.

Un plugin ne peut pas se connecter à un autre plugin

Voici à quoi ressemble le message :

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

Ce qui se cache derrière : « Hook » désigne ici une liaison. Le plugin qui signale l'erreur voulait se connecter au démarrage à un autre plugin dont il a besoin pour fonctionner. Or celui-ci était absent ou pas encore chargé à ce moment-là. Beaucoup de plugins se désactivent alors d'eux-mêmes. Le serveur continue de tourner normalement, mais les fonctions du plugin concerné sont totalement absentes, donc tous les menus dans le cas d'un plugin de menus.

Voici comment le corriger :

1. Relève les deux noms dans le message : entre crochets le plugin qui signale l'erreur, après « hook into » celui qui manque.
2. Si le plugin manquant n'est pas dans Plugins, installe-le dans une version adaptée à la version de ton serveur. Très souvent, il s'agit de PlaceholderAPI.
3. S'il est déjà installé, cherche son nom dans logs/latest.log. S'il génère lui-même une erreur au démarrage, c'est la vraie cause. Corrige-la d'abord.
4. Redémarre complètement le serveur.

Bon à savoir : tu n'as pas besoin de réinstaller le plugin qui signale l'erreur. Il refonctionne dès que la dépendance est disponible au démarrage.

ViaBackwards se désactive car ViaVersion est trop ancien

Voici à quoi ressemble le message :

[ViaBackwards] YOUR VIAVERSION IS OUTDATED
[ViaBackwards] VIABACKWARDS WILL NOW DISABLE

Ce qui se cache derrière : ViaVersion permet aux joueurs avec des versions de Minecraft plus récentes de rejoindre ton serveur, ViaBackwards complète cela pour les versions plus anciennes. ViaBackwards est une extension de ViaVersion et nécessite un build de ViaVersion compatible et suffisamment récent. Si ViaVersion est plus ancien, ViaBackwards se désactive. Le serveur continue de tourner, mais les joueurs avec des clients plus anciens ne peuvent plus se connecter.

Voici comment le corriger :

1. Regarde dans Plugins quelles versions de ViaVersion et de ViaBackwards sont installées.
2. Mets les deux à jour ensemble vers des builds récents et compatibles entre eux. Le message indique lui-même la page de téléchargement officielle. Si tu utilises aussi ViaRewind, mets-le à jour dans la même étape.
3. Redémarre le serveur et vérifie avec plugins dans la Console que ViaBackwards apparaît en vert.

Bon à savoir : mets toujours à jour les plugins Via ensemble. Si tu ne renouvelles que ViaBackwards, tu retombes exactement sur ce message.

En détail : Configurer ViaVersion : connecter des clients plus anciens et plus récents

UltimateDonutSmp se désactive sans PlaceholderAPI

Voici à quoi ressemble le message :

[UltimateDonutSmp] UltimateDonutSmp requires PlaceholderAPI
[UltimateDonutSmp] UltimateDonutSmp is disabling itself to prevent broken sidebar output.

Ce qui se cache derrière : UltimateDonutSmp affiche des valeurs dans la sidebar, l'affichage sur le côté droit de l'écran. Ces valeurs passent par des placeholders, de petites variables comme %player_name% que PlaceholderAPI remplit avec de vraies valeurs. Si PlaceholderAPI est absent ou désactivé, UltimateDonutSmp se désactive volontairement afin que les joueurs ne voient pas de placeholders cassés. Le serveur lui-même continue de tourner normalement.

Voici comment le résoudre :

1. Installe PlaceholderAPI sous Plugins dans une version adaptée à la version de ton serveur.
2. S'il est déjà installé, vérifie dans logs/latest.log s'il génère une erreur au démarrage et corrige-la en premier.
3. Arrête le serveur, puis redémarre-le. Un rechargement par commande ne suffit pas ici.

Bon à savoir : Si la sidebar affiche ensuite du texte comme %vault_eco_balance% au lieu de chiffres, il manque une extension de PlaceholderAPI. Tu la télécharges dans la Console avec papi ecloud download <Extension> et tu l'appliques avec papi reload.

Un plugin requis n'est pas installé

Voici à quoi ressemble le message :

[<Plugin>] <Dependency> is required but was not found
[<Plugin>] <Dependency> plugin not found! Disabling
[<Plugin>] Download <Dependency> from https://<Address>

Ce qui se cache derrière : Le plugin repose sur un autre plugin et ne le trouve pas au démarrage. Le message indique lui-même le nom de ce plugin de base, parfois même avec une adresse de téléchargement. Selon le plugin, il se désactive entièrement ou une partie seulement ne fonctionne pas. Le message apparaît aussi lorsque le plugin de base se trouve bien comme fichier dans le dossier plugins, mais ne démarre pas lui-même.

Voici comment le résoudre :

1. Note le nom du plugin de base manquant d'après le message.
2. Vérifie sous Plugins s'il est installé. Si ce n'est pas le cas, installe-le dans une version qui correspond à la version de ton serveur. Pour savoir comment faire : Installer et gérer des plugins.
3. S'il est installé, cherche son nom dans logs/latest.log. Une erreur au démarrage en est alors la véritable cause.
4. Redémarre le serveur.

Bon à savoir : Si tu n'as plus besoin du plugin qui affiche le message, tu peux le supprimer à la place. Le message disparaît alors aussi.

Un plugin ne trouve aucun système d'économie

Voici à quoi ressemble le message :

[<Plugin>] Vault economy provider not found!
[<Plugin>] Vault is not found or no economy plugin found

Ce qui se cache derrière : Pour l'argent, les prix et les récompenses, le plugin a besoin de deux partenaires : Vault ou VaultUnlocked comme interface, et un plugin d'économie comme EssentialsX qui gère les soldes. S'il ne trouve pas les deux, il se désactive ou n'attribue pas de récompenses en argent. Conséquences typiques : un plugin de boutique comme QuickShop ne démarre pas correctement, un plugin de quêtes signale qu'il ne peut pas verser une récompense.

Voici comment le résoudre :

1. Vérifie sous Plugins si Vault ou VaultUnlocked est installé.
2. Vérifie si un plugin d'économie est actif, par exemple EssentialsX. Sans un tel plugin, Vault n'a rien à transmettre.
3. Installe ce qui manque, dans des versions adaptées à la version de ton serveur, puis redémarre le serveur.
4. Pour Vault, contrôle avec vault-info dans la Console si un plugin d'économie figure après « Economy ».

Bon à savoir : Tu trouveras comment configurer EssentialsX dans Configurer EssentialsX.

Le plugin de primes Bountys ne trouve pas Vault

Voici à quoi ressemble le message :

[Bountys] Vault Plugin wasn't detected!

Ce qui se cache derrière : Bountys verse les primes via Vault et a en général besoin en plus d'un plugin d'économie qui gère les soldes. Au démarrage, Vault n'a pas été trouvé. Les fonctions d'argent de Bountys ne marchent donc pas et les primes ne peuvent pas être versées. Le serveur lui-même et les autres plugins ne sont pas concernés.

Voici comment le résoudre :

1. Décide si tu as besoin de Bountys. Sinon, supprime-le sous Plugins et le message disparaît.
2. Si tu veux le garder, place Vault et un plugin d'économie compatible comme EssentialsX dans le dossier des plugins, le plus simple étant via Plugins.
3. Si Vault s'y trouve déjà, vérifie dans logs/latest.log si Vault signale lui-même une erreur au démarrage.
4. Redémarre le serveur et vérifie avec vault-info dans la Console si Vault a trouvé un plugin d'économie.

Bon à savoir : Si d'autres plugins signalent que Vault ou une économie manque, la même étape résout tous les messages.

AuthMe ne trouve aucun plugin de permissions via Vault

Voici à quoi ressemble le message :

[AuthMe] Error while hooking into Vault [PermissionHandlerException]: Could not load permissions provider service

Ce qui se cache derrière : AuthMe est un plugin de connexion où les joueurs se connectent avec un mot de passe. Pour ses fonctions de groupes et de permissions, il interroge via Vault un service de permissions, c'est-à-dire un plugin de permissions. Vault est bien installé, mais ne fournit pas un tel service à AuthMe. Les fonctions de groupes et de permissions d'AuthMe tombent donc en panne. Le message ne concerne que ces fonctions supplémentaires.

Voici comment le résoudre :

1. Installe sous Plugins LuckPerms ou un autre plugin de permissions avec liaison Vault.
2. Mets à jour Vault et AuthMe vers des versions adaptées à la version de ton serveur.
3. Redémarre le serveur.
4. Saisis vault-info dans la Console. Après « Permission », ton plugin de permissions devrait maintenant apparaître.

Bon à savoir : Tu verras comment créer des groupes et des permissions dans Configurer LuckPerms.

StackSpawners a besoin de DecentHolograms

Voici à quoi ressemble le message :

[StackSpawners] DecentHolograms was not found. The plugin will not work

Ce qui se cache derrière : StackSpawners regroupe les spawners et utilise le plugin DecentHolograms pour ses affichages flottants, appelés hologrammes. Il n'intègre pas cette fonction lui-même. Si StackSpawners ne trouve pas DecentHolograms au démarrage, il ne peut pas fonctionner. Le serveur continue de tourner, mais les fonctions de StackSpawners sont absentes.

Voici comment le résoudre :

1. Installe DecentHolograms sous Plugins dans une version qui correspond à la version de ton serveur et à StackSpawners. La page du plugin StackSpawners indique les versions prises en charge.
2. Si DecentHolograms est déjà là, cherche dans logs/latest.log une erreur de démarrage de DecentHolograms et corrige-la en premier.
3. Arrête complètement le serveur, puis redémarre-le. Ainsi, les deux plugins se chargent dans le bon ordre.

Bon à savoir : Si tu n'utilises plus StackSpawners, supprime-le. La dépendance disparaît alors aussi.

LightAntiCheat-Plus ne trouve pas PacketEvents

Voici à quoi ressemble le message :

(LightAntiCheat-Plus) Failed to start listener-mode … com/github/retrooper/packetevents/event/PacketListenerCommon

Ce qui se cache derrière : LightAntiCheat-Plus est un plugin anti-cheat. Il surveille le trafic des joueurs via PacketEvents, un plugin à part qui prépare les paquets réseau pour d'autres plugins. Si PacketEvents est absent ou installé dans une version que LightAntiCheat-Plus n'attend pas, sa surveillance ne démarre pas. Le serveur continue de tourner, mais la protection contre la triche est alors totalement ou partiellement désactivée.

Voici comment corriger le problème :

1. Consulte la page de LightAntiCheat-Plus pour savoir quelle version de PacketEvents il nécessite.
2. Installe ou mets à jour PacketEvents dans Plugins vers cette version, adaptée à la version de ton serveur.
3. Si nécessaire, mets aussi à jour LightAntiCheat-Plus afin que les deux soient compatibles.
4. Arrête complètement le serveur, puis redémarre-le.

Bon à savoir : D'autres plugins utilisent souvent eux aussi PacketEvents. Après le changement, vérifie dans logs/latest.log qu'ils démarrent toujours sans erreur.

Un plugin s'est désactivé de lui-même après une erreur

Voici à quoi ressemble le message :

[<Plugin>] An unexpected error occurred, disabling the plugin
[<Plugin>] Cannot enable plugin: <Raison>

Ce qui se cache derrière : Le plugin a rencontré une erreur au démarrage ou en cours de fonctionnement et s'est donc désactivé lui-même. Jusqu'au prochain redémarrage, toutes ses fonctions sont indisponibles et ses commandes ne répondent plus que par un message d'erreur. Le plugin concerné figure entre crochets. La cause se trouve généralement dans les lignes qui précèdent, parfois dans une autre langue selon l'origine du plugin.

Voici comment corriger le problème :

1. Ouvre logs/latest.log et lis les lignes situées juste avant le message. Un plugin manquant, une version inadaptée ou une erreur de configuration s'y repère généralement.
2. Mets à jour le plugin et vérifie sur sa page qu'il est compatible avec la version de ton serveur.
3. Si l'erreur persiste, retire le plugin pour tester et redémarre. Si tout fonctionne sans lui, signale l'erreur à l'auteur du plugin en joignant les lignes du log.

Bon à savoir : Tu peux identifier les erreurs en cours de fonctionnement avec Un plugin génère des erreurs en cours de fonctionnement.

AuthMeBia n'est pas compatible avec ta version d'AuthMe

Voici à quoi ressemble le message :

[AuthMeBia] AuthMe DataSource reflection unavailable; premium skip and session autologin both disabled

Ce qui se cache derrière : AuthMeBia est une extension du plugin de connexion AuthMe. Elle accède à une fonction interne d'AuthMe qui n'existe pas sous cette forme dans ta version d'AuthMe. AuthMeBia désactive donc deux fonctions : le premium skip, qui permet aux joueurs possédant un compte Minecraft acheté de se connecter sans mot de passe, et l'autologin de session, la connexion automatique quand quelqu'un se reconnecte peu après avoir quitté le serveur. AuthMe lui-même continue de fonctionner, et les joueurs se connectent alors comme d'habitude avec leur mot de passe.

Voici comment corriger le problème :

1. Vérifie dans Plugins quelles versions d'AuthMe et d'AuthMeBia sont installées.
2. Consulte la page d'AuthMeBia pour savoir pour quelle version d'AuthMe elle a été conçue.
3. Mets à jour les deux vers des versions compatibles entre elles, puis redémarre le serveur.
4. Teste avec un compte acheté si la connexion sans mot de passe refonctionne.

Une extension de ProjectKorra n'est pas compatible avec la version principale

Voici à quoi ressemble le message :

java.lang.NoSuchMethodError: 'void com.projectkorra.projectkorra.<Classe>.<Méthode>()'
com.jedk1.jedcore.ability.<Capacité>@<Identifiant>[…]

Ce qui se cache derrière : ProjectKorra ajoute des capacités de bending au serveur, et des extensions comme JedCore en ajoutent d'autres. Chaque extension est conçue pour une version précise de ProjectKorra. Si elle appelle une méthode, c'est-à-dire une fonction qui n'existe pas dans ta version de ProjectKorra, elle plante avec « NoSuchMethodError ». Il arrive aussi qu'elle écrive alors l'état d'une capacité sous forme de longue ligne dans le log. Les capacités concernées ne fonctionnent pas, le reste du serveur continue de tourner.

Voici comment corriger le problème :

1. Note dans Plugins la version de ProjectKorra et celles de toutes les extensions.
2. Ouvre la page de téléchargement de chaque extension. Elle indique quelle version de ProjectKorra est requise.
3. Installe ProjectKorra et toutes les extensions dans des versions compatibles entre elles et avec la version de ton serveur.
4. Redémarre le serveur et teste une capacité de l'extension.

Bon à savoir : Si une extension n'existe pas pour ta version de ProjectKorra, retire-la plutôt que de mélanger d'anciennes et de nouvelles versions.

AppleSkin ne démarre pas car Fabric API est absent

Voici à quoi ressemble le message :

Mod 'AppleSkin' (appleskin) <Version> requires any version of fabric-api, which is missing!

Ce qui se cache derrière : La plupart des mods Fabric ont besoin de la bibliothèque Fabric API, un ensemble de composants communs qui ne fait pas partie de Fabric Loader lui-même. AppleSkin est installé, mais pas Fabric API. Fabric Loader vérifie cela au démarrage et l'interrompt. Ton serveur ne redémarrera donc que lorsque tu auras ajouté Fabric API ou désactivé AppleSkin.

Voici comment corriger le problème :

1. Installe dans Mods Fabric API dans la version correspondant à ta version de Minecraft.
2. Si tu n'as pas besoin d'AppleSkin, utilise plutôt le bouton de réparation à côté du message dans Santé du serveur. Il désactive AppleSkin (le fichier est conservé) et redémarre le serveur.
3. Vérifie dans la Console que le serveur démarre complètement.

Bon à savoir : Fabric API doit correspondre à ta version de Minecraft. Le message indique « any version », AppleSkin n'impose donc pas d'exigence particulière.

Pour en savoir plus : Fabric Loader et Fabric API : résoudre précisément les erreurs de version

Ton message n'y figure pas ?

Lis le message en entier dans logs/latest.log, y compris les lignes qui le précèdent. En général, le serveur indique d'abord le plugin qui a échoué, puis seulement les erreurs en cascade des autres plugins. Dans la stacktrace, les noms de fichiers avant .jar et les noms de dossiers dans le chemin de classe, par exemple me/clip/placeholderapi, révèlent quel plugin ou quel mod est concerné. Compare ensuite les dépendances indiquées sur la page du projet avec tes plugins installés. Crée une sauvegarde avant chaque modification. Si tu n'avances pas, ouvre un ticket et indique l'heure du message.