ACLClouds
ACLClouds

Un plugin Minecraft est incompatible ou empêche le démarrage

Identifier la version de Java, l’API du serveur et la dépendance qui manque au plugin en erreur. Un plugin Bukkit nécessite Paper, Purpur ou Spigot.

Un plugin Paper ou Spigot n’est pas automatiquement compatible avec toutes les versions de Minecraft. Les logs indiquent souvent l’API, Java ou la dépendance manquante.

Procédure étape par étape

  1. Repérer le premier ERROR

    Remontez jusqu’à la première erreur liée au nom du plugin, pas seulement à la dernière exception en cascade.

  2. Vérifier le logiciel serveur

    Un plugin Bukkit nécessite Paper, Purpur ou Spigot ; il ne se charge pas sur Vanilla, Forge ou Fabric.

  3. Comparer les versions

    Vérifiez la version de Minecraft, la version de Java requise et la page officielle du plugin.

  4. Installer les dépendances

    Ajoutez Vault, ProtocolLib ou l’API demandée seulement depuis leur source officielle, puis redémarrez.

Contrôler les plugins chargés

plugins
version Vault

Avant de commencer

Notez trois informations : le type et la version du serveur, affichés en haut de la page « Version » (par exemple Paper 1.21.4), la version de Java indiquée dans la carte « Version Java » des « Paramètres », et le nom exact du fichier .jar en erreur. Comparez-les avec la page officielle du plugin sur Modrinth, Hangar ou SpigotMC.

Gardez aussi la liste des plugins ajoutés ou mis à jour depuis le dernier démarrage réussi : le coupable en fait presque toujours partie.

Isoler le plugin fautif

Si le log ne désigne pas clairement le coupable, procédez par élimination. Arrêtez le serveur, ouvrez /plugins dans « Fichiers » et renommez le .jar suspect en .jar.off : seuls les fichiers qui finissent par .jar sont chargés. Redémarrez. Si l’erreur disparaît, vous tenez la cause ; sinon, remettez le nom d’origine et passez au suivant.

Avec beaucoup de plugins, désactivez-en la moitié d’un coup, puis la moitié de ce qui reste : quelques redémarrages suffisent. Ne supprimez pas le dossier de configuration du plugin, il garde vos réglages et vos données.

Vérifier que tout fonctionne

Après correction, tapez plugins dans la console : tous les noms doivent apparaître en vert, un nom en rouge signale un plugin désactivé. Dans le log, la ligne Enabling suivie du nom du plugin confirme son activation.

Questions fréquentes

Que signifie Could not load suivi du nom du plugin ?

Le serveur n’a pas pu lire le plugin. La raison figure juste en dessous, sur la ligne qui commence par Caused by : version d’API trop récente, Java trop ancien ou dépendance absente. Lisez cette ligne plutôt que la fin de la pile d’erreurs.

Que veut dire Unsupported API version ?

Le plugin.yml déclare une api-version plus récente que votre serveur, par exemple un plugin prévu pour 1.21 sur un serveur 1.20.4. Installez une version du plugin publiée pour votre version de Minecraft, ou mettez le serveur à jour depuis la page « Version » après une sauvegarde.

Pourquoi Error occurred while enabling apparaît alors que le plugin est installé ?

Le plugin a été lu mais a planté en s’activant : dépendance dans une mauvaise version, erreur de syntaxe dans sa configuration YAML, ou plugin trop ancien ou trop récent pour le serveur. Lisez l’exception juste en dessous : NoClassDefFoundError ou NoSuchMethodError indique presque toujours un écart de version.

Un plugin prévu pour Java 21 peut-il tourner sur Java 17 ?

Non. Le log affiche UnsupportedClassVersionError avec class file version 65.0, alors que Java 17 ne lit que jusqu’à 61.0. Choisissez Java 21 dans la carte « Version Java » si votre version de Minecraft le permet, ou installez une version plus ancienne du plugin.