Plugins Minecraft 26.x : le guide de la version calendaire

Versionnage calendaire : pourquoi il n'y a jamais eu de 1.22

Minecraft a abandonné la numérotation 1.x pour un versionnage calendaire. Le premier nombre est l'année, le second le rang de la sortie dans cette année. La dernière version en date est 26.2, publiée le 16/06/2026 sous le nom Chaos Cubed. Il n'y a donc pas de 1.22 : la suite de la famille 1.21, ce sont les versions 26.x.

Pour toi, la conséquence est surtout pratique. Quand tu cherches un plugin ou quand tu décris celui que tu veux, tu ne peux plus raisonner en « la dernière 1.x ». Tu dois nommer une version calendaire précise, parce que l'écart entre 26.1.2 et 26.2 n'est pas cosmétique : côté Paper, 26.1.2 a un build stable et 26.2 n'en a pas.

• La version en cours est 26.2, sortie le 16/06/2026, nom de code Chaos Cubed
• Le premier nombre est l'année, pas un numéro de génération
• Écris toujours ta version exacte dans la description de ton plugin

Sur quelle version compiler en 2026 : les chiffres du parc

Un relevé bStats portant sur 62 948 serveurs donne la répartition réelle : 1.21.11 rassemble 36,4 % des serveurs, 26.1.2 arrive à 14,9 %, 26.2 à 7,4 % et 1.21.4 à 7,2 %. Autrement dit, la famille 1.21 reste de très loin la plus représentée : sur ce relevé, les versions calendaires n'ont pas pris le dessus.

La lecture est simple. Si ton serveur tourne pour des joueurs, la cible de production raisonnable côté 26.x est 26.1.2, parce que Paper 26.2 n'a pas de build stable. Et si tu publies un plugin pour d'autres, viser uniquement 26.2 te coupe de la majeure partie du parc : garder la compatibilité 1.21 n'est pas de la nostalgie, c'est là que sont les serveurs.

• 1.21.11 : 36,4 % du parc mesuré
• 26.1.2 : 14,9 %, la version calendaire la plus installée
• 26.2 : 7,4 %, récente et sans build Paper stable
• 1.21.4 : 7,2 %, encore bien présente

Java 25 ou Java 21 : quel plancher viser

Java 25 est le plancher des versions calendaires. Si ton serveur tourne en 26.x, c'est le runtime qu'il te faut, sans discussion possible : un JDK plus ancien ne démarrera pas le serveur.

Le niveau de compilation de ton plugin est une autre question. Compiler ton code en Java 21 reste pertinent, parce que c'est ce que fait tourner la majorité du parc, et parce qu'un .jar compilé en 21 se charge sans problème sur un runtime plus récent. L'inverse n'est pas vrai : un plugin compilé en 25 refuse de se charger sur un serveur en Java 21, et tu verras une erreur de version de classe au démarrage.

• Runtime pour un serveur 26.x : Java 25 minimum
• Cible de compilation raisonnable pour un plugin diffusé : Java 21
• Un plugin compilé trop haut ne se charge pas sur un serveur plus ancien

Adventure 5 : pourquoi ton plugin 1.21 ne compile plus

Paper 26.x embarque Adventure 5, et cette version a supprimé des API qui étaient dépréciées. Résultat : du code écrit pour 1.21 peut ne plus compiler du tout contre l'API 26.x. Ce n'est pas un plantage à l'exécution que tu découvres en jeu, c'est un refus de compilation, ce qui est plutôt une bonne nouvelle car tu le vois tout de suite.

C'est le piège classique quand on récupère un tutoriel ou un bout de code trouvé en ligne : il a été écrit pour 1.21, il paraît correct, et il ne passe pas. Adventure gère les messages et le texte affiché aux joueurs, c'est donc ce genre de code qu'il faut relire en premier.

• Adventure 5 a retiré des API dépréciées, pas seulement marqué comme telles
• Un code pour 1.21 peut échouer à la compilation contre 26.x
• Les tutoriels antérieurs à 26.1 sont à relire avant de les copier

Désobfuscation, fin du remapper et bloc libraries:

Depuis 26.1, Minecraft est désobfusqué, et le remapper de Paper a disparu. Toute la gymnastique qui consistait à remapper un plugin pour qu'il retrouve les vrais noms des classes du serveur n'a plus de raison d'être. Un chantier de moins dans la chaîne de build, et une source d'erreurs opaques en moins au démarrage.

Autre changement de méthode : le bloc libraries: de plugin.yml remplace le shading des dépendances. Au lieu d'embarquer une bibliothèque entière dans ton .jar en espérant qu'elle n'entre pas en conflit avec celle d'un autre plugin, tu la déclares et le serveur la récupère. Le .jar est plus petit, et deux plugins qui ont besoin de la même bibliothèque ne l'embarquent plus chacun dans sa version.

• Minecraft est désobfusqué depuis 26.1
• Le remapper de Paper n'existe plus
• Les dépendances se déclarent dans libraries: au lieu d'être shadées
• Les schedulers Folia restent à émettre pour la compatibilité multithread

Comment Minax fabrique un plugin pour 26.x

Tu décris ton plugin en français, avec le comportement voulu, les commandes, les permissions et surtout ta version exacte de serveur. Minax écrit du vrai code Java, le compile, et tu récupères un .jar. Quand la compilation échoue, une boucle d'auto-correction relit les erreurs et corrige le code avant de recompiler, ce qui est exactement le mécanisme utile face aux API retirées par Adventure 5.

Ensuite, tu testes le plugin en ligne avant de toucher à ton serveur. C'est le seul moyen honnête de savoir si les commandes font ce que tu croyais avoir demandé. Les schedulers Folia sont émis pour la compatibilité multithread, donc un plugin destiné à un serveur Folia ne se contente pas de compiler, il respecte le modèle de threads attendu.

• Nomme ta version : 26.2, 26.1.2 ou une 1.21 précise
• Précise ta plateforme : Paper, Spigot, Bukkit ou Folia
• Récupère le .jar compilé et teste-le en ligne
• Ajuste en une phrase, puis installe dans /plugins

Questions fréquentes