Extensions et modsLes numéros de version des extensions sont un repère approximatif, pas un contrat. Qu'une extension 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 l'extension — y compris s'il faut appliquer une conversion héritée pour les anciens noms de matériaux et de blocs. Une extension sans api-version est traitée comme antérieure à la 1.13, d'où le comportement étrange de très vieilles extensions plutôt qu'un échec net.
Ce qui rend une extension 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 une extension avant de lui faire confiance
- Lisez sa propre note de compatibilité
Une extension 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
Une extension qui renomme des préfixes de chat touche peu. Une extension 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 une extension utilise une vieille API. C'est un avertissement sur l'avenir, pas une erreur du jour — mais cela nomme votre prochaine migration.
Une extension 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.