Guide

Comment corriger les erreurs de plugin Minecraft

Mis à jour le 18 octobre 2026

Quand un plugin ne se charge pas, le serveur dit presque toujours pourquoi : la raison se trouve dans la console pendant le démarrage, quelques lignes au-dessus ou en dessous du nom du plugin. Apprenez à lire cette partie du journal et la plupart des erreurs se corrigent en une minute. Voici les plus courantes et ce qu'elles signifient.

Indiquez la version de votre serveur et ce que le plugin doit faire.

Générer ceci avec Codexe

Étape par étape

1.Ouvrez le journal du démarrage
Lisez la console, ou logs/latest.log dans le dossier du serveur. Sur un panneau d'hébergement, utilisez sa console ou son gestionnaire de fichiers.
2.Cherchez le nom du plugin
Trouvez la première erreur qui le mentionne. Les lignes qui commencent par [ERROR] ou [WARN], avec une stack trace en dessous, sont celles qui comptent.
3.Lisez la première ligne et les lignes « Caused by »
La première ligne dit ce qui a échoué ; la dernière ligne Caused by: dit généralement pourquoi. Les lignes contenant le nom du package du plugin montrent à quel endroit de son code.
4.Comparez avec la liste ci-dessous
La plupart des erreurs de démarrage sont un problème de version, de Java ou de dépendance, et le message dit lequel.
5.Corrigez une chose et redémarrez
Changez une seule chose, redémarrez (pas /reload) et relisez le journal. Les erreurs d'un plugin peuvent en provoquer dans d'autres.

Les erreurs courantes

Ce que vous voyez	Ce que ça signifie	Solution
`Unsupported API version 1.21`	L'`api-version` du plugin est plus récente que votre serveur.	Récupérez la version pour votre serveur, ou mettez le serveur à jour.
`Could not load 'plugins/X.jar'` avec `Invalid plugin.yml` ou `Jar does not contain plugin.yml`	Le descripteur du plugin est absent ou contient une erreur YAML, ou le fichier n'est pas un plugin.	Vérifiez que vous avez téléchargé le plugin et non ses sources, un mod ou un zip. Si vous l'avez compilé vous-même, corrigez `plugin.yml`.
`UnsupportedClassVersionError`, « class file version 65.0 »	Le plugin nécessite une version de Java plus récente que celle du serveur (61 = Java 17, 65 = Java 21, 69 = Java 25).	Faites tourner le serveur avec ce Java, ou recompilez le plugin pour votre Java.
`NoClassDefFoundError` ou `ClassNotFoundException`	Une classe dont le plugin a besoin est absente : un plugin de dépendance manque, une bibliothèque n'a pas été intégrée au .jar, ou l'API n'existe pas dans cette version.	Installez le plugin nommé dans l'erreur (Vault, ProtocolLib), ou utilisez un build pour votre version.
`Unknown/missing dependency plugins`	Un plugin listé dans `depend` n'est pas installé.	Installez-le dans `plugins/`.
`Error occurred while enabling X (Is it up to date?)`	Le plugin s'est chargé mais a planté dans `onEnable`.	Lisez la ligne `Caused by` : c'est souvent une erreur de config ou une dépendance manquante.
`Ambiguous plugin name`	Deux fichiers .jar du même plugin se trouvent dans `plugins/`.	Supprimez l'ancien.

Les erreurs qui ne concernent pas le chargement

Le plugin est en vert mais une commande affiche « Unknown command » : la commande est absente de plugin.yml, ou un autre plugin utilise le même nom.
« I'm sorry, but you do not have permission » : le joueur n'a pas le nœud de permission. Cherchez le nœud sur la page du plugin et donnez-le avec votre plugin de permissions.
Erreurs après avoir modifié config.yml : le YAML exige des espaces, pas des tabulations, et des guillemets autour du texte qui commence par : ou &.
Fonctionne après un redémarrage, casse après /reload : le plugin ne supporte pas /reload. Redémarrez plutôt.

La version de Java dont votre serveur a besoin

Minecraft 1.20.5 et plus récent nécessite Java 21, et la 26.x nécessite Java 25 ; de la 1.18 à la 1.20.4, il faut Java 17. Lancez java -version avec le même Java que celui du serveur (sur un panneau d'hébergement, c'est généralement un paramètre appelé image Docker ou version de Java). Un plugin compilé pour un Java plus ancien tourne sur un plus récent, pas l'inverse.

Corriger les plugins créés avec Codexe

Les plugins créés sur Codexe sont compilés pour la version que vous avez choisie et vérifiés pour s'assurer que leur plugin.yml est valide avant d'être prêts. Sur un serveur de test, l'onglet Logs affiche le journal en direct avec les erreurs mises en évidence, et Export logs l'enregistre dans un fichier. Décrivez ce que vous voyez dans le chat du projet (« le plugin est en rouge dans /plugins et le journal dit ... ») et Codexe modifie le code et recompile. Si une compilation échoue sur des fichiers exactement tels que Codexe les a livrés, Corriger avec l'IA les répare gratuitement.

Questions

Où se trouve le journal du serveur ?

logs/latest.log dans le dossier du serveur, pour l'exécution en cours. Les exécutions précédentes sont dans le même dossier sous forme de fichiers .log.gz.

Un plugin peut-il en casser un autre ?

Oui : une dépendance manquante ou cassée bloque tous les plugins qui en ont besoin. Corrigez la première erreur du journal avant les autres.

Puis-je partager mon journal sans risque ?

En général oui, mais vérifiez-le d'abord : les journaux peuvent contenir des adresses IP et, avec certains plugins, des mots de passe de base de données apparus dans des erreurs.

Recompilez un plugin cassé pour votre serveur

Ce prompt s'ouvre prêt à être envoyé :

“Un plugin Paper 1.21.4 appelé SimpleWarps qui remplace mon ancien plugin qui ne se charge plus : /setwarp, /warp et /delwarp avec un nom, /warps les liste dans une GUI, permission warps.admin pour créer et supprimer, warps conservés après les redémarrages, messages dans config.yml.”