Depuis 2026, Minecraft Java ne s'appelle plus 1.22 mais 26.1, 26.2, 26.3… et ce changement de numérotation s'accompagne d'un changement plus concret : Java 25 est obligatoire. Mettre à jour son serveur Minecraft vers la 26.x ne se résume donc pas à remplacer un fichier .jar. Ce guide vous donne une checklist de migration complète, de la sauvegarde au plan de retour arrière, pour Vanilla, Paper, Spigot et Purpur.
Ce qui change avec la numérotation 26.x
La dernière version de l'ancienne série est la 1.21.11, sortie en décembre 2025. Depuis, Mojang numérote les versions Java sous la forme AA.D.H : l'année, le numéro de la mise à jour de contenu (le « drop ») dans l'année, puis le correctif éventuel.
- 26.1 (mars 2026), puis les correctifs 26.1.1 et 26.1.2 ;
- 26.2 (juin 2026) ;
- 26.3 (15 septembre 2026), la version stable actuelle à la mi-octobre 2026 ;
- 26.4, en snapshots au moment où nous écrivons.
À retenir : la 26.1 est le successeur direct de la 1.21.11. Un serveur en 1.21.x qui passe en 26.3 saute donc trois mises à jour de contenu d'un coup, avec autant de conversions de monde.
Quelle version de Java pour quelle version de Minecraft ?
C'est la cause numéro un des serveurs qui refusent de démarrer après une mise à jour. Le tableau ci-dessous reprend les versions de Java recommandées par la documentation de Paper, valables aussi pour Vanilla, Spigot et Purpur.
| Version de Minecraft | Java requis |
|---|---|
| 1.12 à 1.16.4 | Java 11 |
| 1.16.5 | Java 16 |
| 1.17 à 1.19 | Java 17 |
| 1.20 à 1.21.11 | Java 21 |
| 26.1 et suivantes | Java 25 |
Bonne nouvelle : Java 25 fait aussi tourner les anciennes versions. Vous pouvez donc installer Java 25 avant la mise à jour, vérifier que votre serveur 1.21 démarre toujours, puis changer de version de Minecraft dans un second temps. L'inverse ne marche pas : un serveur 26.x lancé avec Java 21 s'arrête immédiatement avec une erreur de ce type :
java.lang.UnsupportedClassVersionError: net/minecraft/bundler/Main has been compiled
by a more recent version of the Java Runtime (class file version 69.0),
this version of the Java Runtime only recognizes class file versions up to 65.0La « class file version 69 » correspond à Java 25, la 65 à Java 21. Si vous voyez ce message, ce n'est pas votre monde ni vos plugins : c'est uniquement la version de Java.
Vérifier et changer la version de Java
Sur un serveur Linux que vous administrez vous-même, commencez par vérifier la version utilisée :
java -version
# Si plusieurs versions sont installées (Debian / Ubuntu)
update-alternatives --config javaSi Java 25 n'est pas encore installé, utilisez le paquet de votre distribution ou une distribution OpenJDK reconnue (Eclipse Temurin, par exemple). Le plus sûr reste d'appeler le binaire par son chemin complet dans votre script de démarrage, pour ne pas dépendre de la version par défaut du système :
/usr/lib/jvm/java-25/bin/java -Xms4G -Xmx4G -jar server.jar --noguiLe chemin exact dépend de votre installation. Sur un panel d'hébergement, la version de Java se choisit en général dans les paramètres de démarrage du serveur (image ou « runtime » Java) : sélectionnez Java 25 avant de lancer la nouvelle version.
Où en sont Paper, Spigot et Purpur ?
À la mi-octobre 2026, voici l'état des principaux logiciels serveur :
- Paper propose des builds 26.3 sur le canal stable. Les branches 26.1.x et 26.2 restent téléchargeables, mais seule la dernière version reçoit les correctifs : visez la 26.3.
- Purpur, basé sur Paper, publie aussi des builds 26.3.
- Spigot se compile toujours avec BuildTools. Avec Java 25 installé :
java -jar BuildTools.jar --rev 26.3. - Serveurs moddés : les chargeurs de mods et surtout les modpacks suivent leur propre calendrier. Ne mettez à jour que lorsque le modpack publie officiellement une version serveur pour la 26.x visée.
Un point souvent oublié : si vous utilisez un proxy devant plusieurs serveurs, il doit lui aussi être compatible avec la version des joueurs, et sa propre version peut exiger Java 25. Vérifiez sa documentation avant de toucher aux serveurs derrière.
La checklist complète avant de mettre à jour
La plupart des guides se limitent à « faites une sauvegarde ». Voici la liste que nous recommandons de suivre point par point.
- Notez l'état actuel : version exacte de Minecraft, du logiciel serveur (numéro de build), de Java, et liste des plugins avec leur version. Une simple capture du dossier
pluginset de la commande/versionsuffit. - Vérifiez chaque plugin : pour chacun, cherchez sur sa page de téléchargement une version compatible avec la 26.x visée. Classez-les en trois groupes : compatible, en attente de mise à jour, abandonné. Pour un plugin abandonné, trouvez un remplaçant avant la migration.
- Repérez les plugins critiques : permissions, économie, protection de zones, authentification. Si l'un d'eux n'est pas prêt, reportez la mise à jour : un serveur sans protection ou sans permissions est pire qu'un serveur en retard d'une version.
- Prévenez les joueurs : date, durée estimée de la coupure et version de Minecraft à utiliser ensuite.
- Arrêtez proprement le serveur avec la commande
stop, jamais en coupant le processus, pour que les régions soient bien écrites sur le disque. - Faites une sauvegarde complète : les dossiers des mondes, mais aussi
plugins(avec leurs configurations et bases de données),server.properties, les fichiers de configuration du logiciel serveur, les listes de joueurs et l'ancien .jar. - Testez la restauration : une sauvegarde qui n'a jamais été restaurée n'est qu'une hypothèse. Décompressez-la ailleurs et vérifiez qu'elle est complète.
- Préparez un serveur de test si vous le pouvez : une copie du serveur sur laquelle vous ferez la mise à jour en premier.
Exemple de sauvegarde sous Linux
cd /opt/minecraft
# Le serveur doit être arrêté avant la copie
tar -czf ../backup-avant-26x-$(date +%F).tar.gz .
# Vérifier que l'archive est lisible
tar -tzf ../backup-avant-26x-$(date +%F).tar.gz > /dev/null && echo "Archive OK"Gardez une copie de cette archive en dehors de la machine du serveur. Si le disque lâche pendant la migration, une sauvegarde stockée au même endroit ne vous sauvera pas.
La mise à jour étape par étape
- Mettez à jour les plugins d'abord. Sur Paper et ses dérivés, déposez les nouvelles versions dans le dossier
plugins/update: elles remplaceront les anciennes au prochain démarrage. - Passez à Java 25, comme expliqué plus haut.
- Remplacez le .jar du serveur par la version 26.x de votre logiciel (Vanilla, Paper, Spigot ou Purpur) et adaptez si besoin le nom du fichier dans votre script de démarrage.
- Démarrez et lisez la console jusqu'au bout. Repérez les plugins qui ne se chargent pas et les messages d'erreur au démarrage.
- Testez en jeu avec un compte administrateur : connexion, permissions, commandes principales, protections de zones, économie, et une visite rapide des zones importantes de la carte.
- Rouvrez aux joueurs seulement une fois ces vérifications faites.
Faut-il convertir le monde d'un coup ?
Par défaut, les chunks sont convertis au nouveau format au fur et à mesure qu'ils sont chargés. Le serveur Vanilla (et Paper) accepte aussi l'option --forceUpgrade, qui convertit tout le monde au démarrage. C'est plus long et gourmand en ressources, mais cela évite les ralentissements quand les joueurs explorent d'anciennes zones. Sur une grande carte, lancez-la sur votre serveur de test d'abord pour mesurer la durée.
java -Xms4G -Xmx4G -jar paper-26.3.jar --forceUpgrade --noguiLes erreurs les plus fréquentes après la mise à jour
| Symptôme | Cause probable | Solution |
|---|---|---|
UnsupportedClassVersionError, class file version 69 | Le serveur est lancé avec Java 21 ou plus ancien | Lancer le serveur avec Java 25 |
| Un plugin est désactivé au démarrage | Version du plugin trop ancienne pour la 26.x | Installer une version compatible ou le retirer |
| Les joueurs ne peuvent pas se connecter (version incompatible) | Client ou proxy sur une autre version | Aligner la version des joueurs et mettre à jour le proxy |
| Fortes saccades en explorant d'anciennes zones | Conversion des chunks à la volée | Pré-convertir avec --forceUpgrade ou patienter |
| Le serveur manque de mémoire au démarrage | Conversion du monde et plugins plus gourmands | Vérifier les arguments -Xms / -Xmx et la RAM de l'offre |
Le plan de retour arrière
C'est la partie que presque aucun guide ne détaille, et pourtant la plus importante : un monde converti en 26.x ne peut pas revenir en 1.21. Remettre l'ancien .jar sur un monde déjà converti risque de corrompre des chunks ou de faire disparaître des blocs et objets. Le seul vrai retour arrière, c'est la restauration de la sauvegarde.
- Fixez un critère de décision avant de commencer : par exemple, « si un plugin critique ne fonctionne pas au bout d'une heure, on revient en arrière ».
- Arrêtez le serveur avec
stop. - Mettez de côté l'état en échec (renommez le dossier plutôt que de le supprimer) : il vous servira à comprendre le problème.
- Restaurez la sauvegarde complète : mondes, plugins, configurations et ancien .jar.
- Revenez à Java 21 si vous préférez, même si Java 25 fait aussi tourner la 1.21.
- Prévenez les joueurs que la progression réalisée depuis la mise à jour est perdue.
Ce dernier point montre pourquoi il faut décider vite : plus vous attendez, plus les joueurs perdent de progression en cas de retour arrière. D'où l'intérêt du serveur de test, qui permet de découvrir les problèmes avant qu'ils ne touchent la partie en cours.
Prévoir les ressources de votre serveur
La conversion d'un grand monde et un serveur de test en parallèle demandent de la marge en mémoire et en disque. À titre d'exemple, les offres OuiBox proposées sur MineServ vont de 8 Go de RAM, 4 cœurs et 50 Go de stockage NVMe (9,98 € par mois) à 16 Go de RAM, 6 cœurs et 120 Go NVMe (21,59 € par mois), de quoi garder sauvegardes et copie de test à côté du serveur principal.
FAQ
Pourquoi n'y a-t-il pas de Minecraft 1.22 ?
Mojang a abandonné le préfixe « 1. » en 2026. La version qui aurait pu s'appeler 1.22 est la 26.1, suivie de la 26.2 puis de la 26.3.
Puis-je rester en 1.21.11 ?
Oui, votre serveur continuera de fonctionner, mais les joueurs devront lancer leur jeu en 1.21.11 (ou passer par un plugin de compatibilité de versions), et vous ne recevrez plus les nouveautés ni les correctifs.
Java 25 casse-t-il mes anciens plugins ?
Rarement. La plupart des plugins compilés pour Java 21 fonctionnent sous Java 25. Ce qui casse, c'est surtout le passage à la 26.x de Minecraft, pas la version de Java elle-même.
Combien de temps prend la mise à jour ?
Pour un petit serveur avec quelques plugins, comptez une trentaine de minutes, sauvegarde comprise. Pour une grande carte que vous convertissez entièrement, la conversion seule peut durer bien plus longtemps : mesurez-la sur votre copie de test.