Les numéros de version des plugins sont un repère approximatif, pas un contrat. Qu'un plugin fonctionne dépend des parties du serveur qu'elle touche, et une petite extension d'il y a quatre ans est souvent plus fiable qu'une grosse du mois dernier.
Ce que déclare api-version
Toute extension embarque un plugin.yml, avec une ligne indiquant la génération d'API serveur contre laquelle elle a été écrite. Le serveur la lit et décide comment traiter le plugin — y compris s'il faut appliquer une conversion héritée pour les anciens noms de matériaux et de blocs. Un plugin sans api-version est traitée comme antérieure à la 1.13, d'où le comportement étrange de très vieilles plugins plutôt qu'un échec net.
Ce qui rend un plugin fragile entre versions
| Utilise | Survit aux changements de version ? |
|---|---|
| Uniquement l'API serveur standard | Généralement oui, pendant des années. |
| NMS ou classes internes du serveur | Non. Elles sont réécrites entre versions. |
| Manipulation de paquets | Rarement. Les changements de protocole la cassent. |
| Noms de matériaux et de blocs | Le plus souvent, mais des renommages arrivent. |
| Gestion du chat et des composants | Fragile depuis l'arrivée de la signature du chat. |
Juger un plugin avant de lui faire confiance
- Lisez sa propre note de compatibilité
Un plugin bien maintenue indique les versions supportées. Cette déclaration vaut plus que le numéro dans le nom du fichier.
- Regardez ce qu'elle fait
Un plugin qui renomme des préfixes de chat touche peu. Un plugin qui ajoute des entités personnalisées touche tout. Estimez en conséquence.
- Testez-la d'abord sur une copie
« Se charge sans erreur » n'est pas « fonctionne ». Chargez-la, puis utilisez la fonction pour laquelle vous l'avez installée.
- Surveillez les avertissements de dépréciation en console
Le serveur vous prévient quand un plugin utilise une vieille API. C'est un avertissement sur l'avenir, pas une erreur du jour — mais cela nomme votre prochaine migration.
Un plugin peut démarrer proprement puis lever une erreur la première fois qu'une fonction précise s'exécute, ce qui peut arriver une semaine plus tard quand un joueur la déclenche. La console au démarrage est un test faible ; utiliser chaque fonction une fois en est un vrai.
« Supporte 1.20–1.21 » est un projet maintenu. Une page de téléchargement qui dit seulement « Minecraft 1.16 » et n'a pas bougé depuis 2021 est un projet que vous maintiendrez vous-même, que vous l'ayez prévu ou non.
À propos de ce guide : C'est un guide original de l'équipe EnduranceNodes, écrit pour les serveurs que nous hébergeons. Si une étape ne correspond plus à ce que vous voyez, dites-le-nous et nous le mettrons à jour.