Compatibilité des versions de plugin et d'API
Pourquoi un plugin ne fonctionne pas sur votre version, ce que signifie api-version, comment lire les prérequis et ce qu'une incompatibilité peut causer.
Mis à jour le 13 août 2026
Un plugin est conçu pour une version précise de l'API du serveur. Une incompatibilité empêche son chargement ou provoque des erreurs en cours d'exécution.
Ce qui détermine la compatibilité
- Version du jeu. Un plugin pour 1.20 ne fonctionnera généralement pas sur 1.21 : les classes internes changent.
- Cœur. Bukkit/Spigot/Paper sont compatibles « du bas vers le haut » : un plugin Bukkit fonctionnera sur Paper, mais pas l'inverse si des API spécifiques à Paper sont utilisées.
- Dépendances. Vault, PlaceholderAPI, ProtocolLib — leurs versions doivent également correspondre.
api-version
Le plugin.yml du plugin indique :
api-version: 1.21
Si la ligne est totalement absente, le serveur considère le plugin comme legacy et active le mode de compatibilité — un avertissement apparaît dans le journal. Ce n'est pas une erreur, mais le signe d'un plugin ancien.
Symptômes typiques
| Dans le journal | Signification |
|---|---|
Unsupported API version | Le plugin a été conçu pour un cœur plus récent |
NoSuchMethodError | La méthode n'existe plus dans votre version — analyse détaillée |
NoClassDefFoundError | Dépendance manquante — analyse détaillée |
Invalid plugin.yml | Le fichier est corrompu ou ce n'est pas un plugin — analyse détaillée |
Vérification avant l'installation
Le catalogue « Plugins et mods » du panneau filtre selon votre cœur et votre version et vous avertit en cas d'incompatibilité avant l'installation — Comment installer. Lors d'un envoi manuel, consultez la page du plugin : elle indique toujours la plage de versions prises en charge.
