Minecraft 26.x et Java 25 : mettre à jour le Java de votre serveur pour passer de la 1.21.11 à la 26.1 et au-delà

La 1.21.11, sortie le 9 décembre 2025 sous le nom « Mounts of Mayhem », restera la dernière version de Minecraft Java Edition numérotée en « 1.x ». Depuis, Mojang numérote ses mises à jour par année : la 26.1 est sortie le 24 mars 2026, suivie de la 26.2 et de la 26.3. Pour qui administre un serveur, le changement de numéro est anecdotique. Le vrai changement est ailleurs : la 26.1 est la première version qui exige Java 25. Un serveur qui tournait sans souci en 1.21.11 sur Java 21 refuse tout simplement de démarrer avec un server.jar 26.x tant que la machine n'a pas de Java 25.

Ce tutoriel fait le tour de ce qui change pour un serveur Minecraft Java : la nouvelle numérotation, la correspondance entre versions de Minecraft et versions de Java, l'erreur à reconnaître, la vérification en SSH du Java réellement utilisé, l'installation de Java 25 sur Debian, Ubuntu, Rocky Linux et AlmaLinux puis sous Windows Server, le cas de Pterodactyl, de Docker et du proxy Velocity, et les précautions à prendre avant de convertir un monde 1.21.11.

Sources : Minecraft Wiki, tableau des versions de Java requises, fiches Java Edition 1.21.11 et Java Edition 26.1, documentation de Paper, index de paquets Debian et Ubuntu, documentation d'installation d'Eclipse Adoptium, consultés le 10 novembre 2026.

De la 1.21.11 à la 26.1 : la nouvelle numérotation de Minecraft Java

Mojang a présenté son nouveau système de numérotation le 2 décembre 2025. Une version de Minecraft Java s'écrit désormais AA.D.C : AA pour les deux derniers chiffres de l'année, D pour le numéro de la mise à jour de contenu (le « game drop ») dans l'année, C pour le correctif. La première version d'un drop n'a pas de numéro de correctif : on écrit 26.1, puis 26.1.1 et 26.1.2 pour ses correctifs. Les snapshots ont suivi le mouvement : l'ancien format année, semaine et lettre, du type 24w14a, a laissé place à des noms comme 26.1 Snapshot 1, publié le 16 décembre 2025.

Deux conséquences pratiques pour un administrateur. D'abord, les scripts, les outils de déploiement et les panels qui comparaient des numéros de version en supposant un préfixe « 1. » peuvent mal classer la 26.1 : vérifiez que votre outil la propose bien comme la plus récente. Ensuite, la règle de compatibilité ne change pas : un client et un serveur doivent être sur la même version, la 26.1 utilisant le protocole réseau 775 quand la 1.21.11 utilisait le 774. Quand vous mettez le serveur à jour, vos joueurs mettent à jour leur launcher, et non l'inverse.

Pourquoi un serveur 26.x exige Java 25

Java 25 est la version à support long (LTS) d'OpenJDK publiée le 16 septembre 2025, deux ans après Java 21. Mojang l'a rendue obligatoire dès la 26.1 Snapshot 1 : le code du jeu est compilé pour Java 25, et une machine virtuelle Java plus ancienne ne sait pas le charger. Le tableau ci-dessous reprend les versions minimales de Java documentées par le Minecraft Wiki, avec la « version de fichier de classe » qui apparaît dans les messages d'erreur.

Paper suit exactement la même règle : sa documentation recommande Java 21 pour les versions 1.20 à 1.21.11 et exige au moins Java 25 pour Paper 26.1 et suivants. Fabric, NeoForge et les autres chargeurs de mods exécutent le code vanilla de la même version : ils héritent de la même exigence.

Le symptôme est toujours le même. Au lancement d'un server.jar 26.x avec Java 21, le serveur s'arrête immédiatement sans écrire de log de jeu, avec un message de ce type :

Error: LinkageError occurred while loading main class net.minecraft.bundler.Main
	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.0

Lisez-le avec le tableau : 69.0 correspond à Java 25, 65.0 à Java 21. Le serveur demande donc Java 25 et la machine lui fournit Java 21. Aucune option de démarrage ni aucun réglage de server.properties ne contourne ce message : il faut installer Java 25 et lancer le serveur avec.

Côté joueurs, il n'y a rien à faire. Le launcher officiel embarque son propre environnement Java, la version de Microsoft d'OpenJDK 25 depuis la 26.1. Seul le serveur dédié dépend du Java installé sur la machine, et c'est donc à l'administrateur de le mettre à niveau.

Vérifier en SSH le Java qu'utilise vraiment le serveur

Avant d'installer quoi que ce soit, regardez ce qui tourne déjà. Connectez-vous à la machine en SSH depuis un terminal (ssh utilisateur@adresse-ip-du-serveur), puis lancez en ligne de commande :

java -version
readlink -f "$(command -v java)"
ps -o pid,user,args -C java
free -h

La première commande donne la version du Java par défaut, celui que lance un simple java. La deuxième suit les liens symboliques jusqu'au vrai binaire et montre dans quel répertoire de /usr/lib/jvm/ il se trouve. La troisième liste les processus Java en cours, avec l'utilisateur et la ligne de commande complète : si votre serveur appelle déjà Java par un chemin complet, c'est ici que vous le verrez, et c'est ce chemin qu'il faudra changer. Si la colonne USER affiche root, profitez de la mise à jour pour faire tourner le serveur sous un utilisateur Unix dédié : un plugin compromis exécuté en root a la main sur toute la machine. La dernière commande indique la RAM disponible, utile pour fixer -Xmx plus bas. Si l'accès SSH n'est pas encore sécurisé, notre guide pour configurer une clé SSH sans perdre l'accès passe en revue la méthode.

JVM, JRE, JDK, headless : le vocabulaire Java d'un serveur

Les noms de paquets Java sont plus clairs une fois ces termes posés :

Installer Java 25 sur un VPS ou un serveur dédié Linux

Bonne nouvelle : la plupart des distributions serveur actuelles fournissent OpenJDK 25 dans leurs dépôts officiels. Un serveur Minecraft n'a besoin que de l'environnement d'exécution sans interface graphique, le paquet headless : inutile d'installer le JDK complet.

Sous Debian 13 et Ubuntu LTS. Une installation directe depuis les dépôts de la distribution, qui recevra ensuite les correctifs de sécurité avec le reste du système. Lancez la commande suivante avec un compte qui a les droits sudo :

sudo apt update
sudo apt install -y openjdk-25-jre-headless
java -version

Rocky Linux et AlmaLinux. Le paquet est dans AppStream sur les versions 9 et 10 :

sudo dnf install -y java-25-openjdk-headless
java -version

Sous Debian 12. OpenJDK 25 n'existe ni dans bookworm ni dans bookworm-backports. Deux options. La plus durable est de passer le serveur en Debian 13, en suivant notre guide pour migrer un VPS de Debian 12 vers Debian 13, ou d'installer un serveur neuf sous Debian 13 et d'y copier le dossier du serveur Minecraft. Dans ce second cas, la machine change d'adresse IP : faites pointer l'enregistrement DNS de votre nom de domaine vers la nouvelle adresse (l'enregistrement A, et l'enregistrement SRV _minecraft._tcp si vous en utilisez un), pour que les joueurs n'aient rien à changer dans leur liste de serveurs. La plus rapide est d'utiliser Eclipse Temurin 25, la distribution d'OpenJDK du projet Adoptium, qui publie un dépôt APT pour bookworm. Commandes de la documentation officielle d'Adoptium :

sudo apt install -y wget apt-transport-https gpg
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/adoptium.gpg > /dev/null
echo "deb https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | sudo tee /etc/apt/sources.list.d/adoptium.list
sudo apt update
sudo apt install -y temurin-25-jre
java -version

Dans tous les cas, java -version doit afficher une version qui commence par 25. Si la machine avait déjà Java 21, il est possible que la commande java pointe encore vers l'ancienne version. Sur Debian et Ubuntu, la commande update-alternatives liste les Java installés et permet de choisir celui que lance java :

update-alternatives --list java
sudo update-alternatives --config java
ls /usr/lib/jvm/

Changer le Java par défaut de toute la machine n'est cependant pas toujours souhaitable, surtout si d'autres serveurs tournent encore en 1.21.x. La méthode la plus robuste est de ne pas dépendre du Java par défaut et d'appeler le binaire de Java 25 par son chemin complet, comme on le voit dans la section suivante.

Faire cohabiter un serveur 1.21.11 et un serveur 26.x

Plusieurs JDK cohabitent sans problème sur la même machine : chacun s'installe dans son propre répertoire sous /usr/lib/jvm/. Sur Debian et Ubuntu en x86-64, OpenJDK 21 se trouve dans /usr/lib/jvm/java-21-openjdk-amd64 et OpenJDK 25 dans /usr/lib/jvm/java-25-openjdk-amd64. Pour un serveur resté en 1.21.11, gardez Java 21, la version que Paper recommande pour cette branche : un vieux modpack ou un plugin non maintenu n'a été testé qu'avec elle. Pour le serveur 26.x, appelez Java 25 par son chemin.

Dans une unité systemd, cela donne une ligne ExecStart explicite. Le reste de l'unité ne change pas, et notre guide pour créer un service systemd pour un serveur de jeu détaille la configuration complète :

# /etc/systemd/system/minecraft-survie.service (serveur 26.3)
ExecStart=/usr/lib/jvm/java-25-openjdk-amd64/bin/java -Xms4G -Xmx4G -jar server.jar nogui

# /etc/systemd/system/minecraft-ancien.service (serveur resté en 1.21.11)
ExecStart=/usr/lib/jvm/java-21-openjdk-amd64/bin/java -Xms2G -Xmx2G -jar server.jar nogui

Avec Temurin, le dossier porte un autre nom : vérifiez-le avec ls /usr/lib/jvm/ avant de l'écrire dans l'unité. Après modification, rechargez systemd puis redémarrez le service :

sudo systemctl daemon-reload
sudo systemctl restart minecraft-survie
journalctl -u minecraft-survie -n 50

Si l'unité a été écrite par un script d'installation que vous ne voulez pas modifier, configurez plutôt une surcharge. La commande sudo systemctl edit minecraft-survie ouvre un fichier de surcharge override.conf, rangé dans /etc/systemd/system/minecraft-survie.service.d/, et recharge la configuration de systemd à la fermeture de l'éditeur. Pour remplacer la commande de démarrage, il faut d'abord vider l'ancienne avec une ligne ExecStart= vide, sinon systemd refuse un service qui aurait deux commandes de démarrage :

[Service]
User=minecraft
ExecStart=
ExecStart=/usr/lib/jvm/java-25-openjdk-amd64/bin/java -Xms4G -Xmx4G -jar server.jar nogui

La ligne User= n'est utile que si l'unité d'origine n'en avait pas : elle fait tourner le serveur sous l'utilisateur minecraft plutôt qu'en root. Il ne reste qu'à redémarrer le service avec sudo systemctl restart minecraft-survie.

Le même principe vaut pour un script shell start.sh lancé dans screen ou tmux : remplacez java par le chemin complet du binaire Java 25.

#!/bin/sh
cd /home/minecraft/survie || exit 1
exec /usr/lib/jvm/java-25-openjdk-amd64/bin/java -Xms4G -Xmx4G -jar server.jar nogui

Installer Java 25 sous Windows Server

Un serveur Minecraft tourne aussi très bien sur un VPS Windows, et la règle est la même : un server.jar 26.x exige Java 25. Sous Windows, le plus simple est de prendre la même distribution que le launcher officiel, Microsoft Build of OpenJDK 25. Microsoft la fournit sous forme d'installateur pour Windows et de paquet pour le gestionnaire winget. Si winget est présent sur le serveur, ouvrez PowerShell en administrateur et lancez :

winget install Microsoft.OpenJDK.25
java -version
where.exe java

Sans winget, téléchargez l'installateur Windows x64 de Microsoft Build of OpenJDK 25 depuis la page de téléchargement de Microsoft et gardez l'option par défaut qui ajoute Java au PATH. Si un Java 21 était déjà installé, where.exe java peut lister plusieurs binaires, et c'est le premier de la liste qui répond à la commande java. Comme sous Linux, la solution la plus sûre est d'écrire le chemin complet du java.exe de Java 25 dans le fichier start.bat du serveur :

@echo off
"C:\chemin\affiché\par\where\bin\java.exe" -Xms4G -Xmx4G -jar server.jar nogui
pause

Remplacez le chemin d'exemple par celui qu'a affiché where.exe pour Java 25. L'accès au serveur passe par le Bureau à distance : notre guide pour sécuriser un VPS Windows Server, RDP et pare-feu s'applique avant d'y laisser tourner un serveur de jeu.

Pterodactyl et Docker : changer l'image Java du serveur

Dans un panel Pterodactyl, le Java du serveur n'est pas celui de la machine hôte : chaque serveur de jeu tourne dans un conteneur Docker, et c'est l'image Docker choisie qui fixe la version de Java. Les images officielles du projet, les « yolks », existent en Java 25 sous le nom ghcr.io/pterodactyl/yolks:java_25. Pour passer un serveur en 26.x :

1. Dans l'onglet Startup du serveur, choisissez l'image Java 25 dans la liste Docker Image, puis redémarrez le serveur.
2. Si Java 25 n'apparaît pas dans la liste, c'est que l'egg ne la propose pas encore. Sur votre propre panel, ajoutez-la dans Admin, Nests, sur l'egg concerné, champ Docker Images, avec une ligne Java 25|ghcr.io/pterodactyl/yolks:java_25. Chez un hébergeur, ouvrez un ticket auprès de son support.
3. Changez ensuite la version du jeu (variable de version de l'egg, ou nouveau server.jar), après avoir fait une sauvegarde.

Si vous installez vous-même le panel, notre guide pour installer Pterodactyl part d'une installation neuve.

Avec l'image Docker communautaire itzg/minecraft-server, très utilisée sur VPS, les étiquettes latest, stable et java25 embarquent Java 25, et l'étiquette latest suit par principe la version de Java exigée par la dernière version de Minecraft. Le piège est l'étiquette figée : un fichier Compose resté sur itzg/minecraft-server:java21 produira l'erreur UnsupportedClassVersionError dès que vous passerez VERSION en 26.x. Exemple minimal pour un serveur Paper 26.3 :

services:
  minecraft:
    image: itzg/minecraft-server:java25
    environment:
      EULA: "TRUE"
      TYPE: "PAPER"
      VERSION: "26.3"
      MEMORY: "4G"
    ports:
      - "25565:25565"
    volumes:
      - ./data:/data
    restart: unless-stopped

Pour les bases de Compose sur un serveur, voir notre guide Docker Compose sur un VPS Linux.

Réseau avec proxy Velocity : le proxy passe aussi en Java 25

Sur un réseau de plusieurs serveurs, les joueurs ne se connectent pas directement au serveur Paper mais à un proxy, le plus souvent Velocity, qui les répartit entre les serveurs du réseau. Deux points à vérifier avant la bascule. D'abord, la documentation actuelle de Velocity indique que le proxy exige au moins Java 25 : si le proxy tourne encore sur Java 21, sa mise à jour demande la même installation de Java 25 que les serveurs. Ensuite, le proxy doit connaître le protocole des nouvelles versions : au moment où nous écrivons, la documentation annonce une compatibilité de la 1.7.2 à la 26.3. Mettez donc le proxy à jour en premier, vérifiez qu'il accepte un client 26.x, puis passez les serveurs du réseau un par un.

Avant de passer de la 1.21.11 à la 26.x : monde, plugins et mods

Installer Java 25 est la partie facile. La conversion du monde demande plus de prudence, car la 26.1 a réorganisé l'arborescence du dossier de monde. Au premier démarrage en 26.x, le serveur convertit le monde au nouveau format. La 1.21.11 ne connaît pas cette nouvelle arborescence : sans sauvegarde faite avant la conversion, il n'y a pas de retour en arrière possible. Les principaux déplacements documentés pour la 26.1 :

Ce tableau décrit la structure d'un serveur vanilla ou Fabric, dont le dossier s'appelle world par défaut (clé level-name de server.properties). Paper range historiquement le Nether et l'End dans des dossiers séparés, world_nether et world_the_end : regardez l'arborescence réelle produite sur votre copie de test avant de modifier quoi que ce soit. Tout ce qui lit ces chemins est à revoir après la mise à jour : scripts de sauvegarde qui ne copient que world/region ou world/playerdata, outils de rendu de carte, scripts de réinitialisation du Nether ou de l'End, exports de statistiques des joueurs.

La procédure que nous conseillons, dans l'ordre :

1. Sauvegarder le dossier complet du serveur, serveur arrêté, et en garder une copie hors de la machine, par exemple avec notre méthode pour sauvegarder un VPS avec rsync. Une archive datée suffit pour ce backup de sécurité :

   sudo systemctl stop minecraft-survie
   sudo tar -czf /var/backups/minecraft-1.21.11-$(date +%F).tar.gz -C /home/minecraft survie

   Si des plugins enregistrent leurs données dans une base de données externe (MySQL, MariaDB ou PostgreSQL, pour les permissions, l'économie ou le journal des blocs), sauvegardez aussi cette base, par exemple avec la méthode de notre guide sur les sauvegardes MySQL avec mysqldump.
2. Vérifier les plugins et les mods : chaque plugin Paper et chaque mod Fabric ou NeoForge doit exister pour la version 26.x visée. La 26.1 est aussi la première version de Minecraft Java publiée entièrement sans obfuscation, ce qui a demandé aux chargeurs de mods de s'adapter : attendez que le chargeur et chacun de vos mods annoncent la compatibilité avec la version exacte. Profitez-en pour scanner les plugins Minecraft téléchargés pour l'occasion.
3. Tester sur une copie : lancez le nouveau serveur avec Java 25 sur une copie du monde, sur un autre port, et vérifiez spawn, inventaires, protections de terrain et commandes des plugins. Attention aux plugins reliés à une base MySQL ou MariaDB : la copie reprend leurs fichiers de configuration, donc les identifiants de la base de production. Pointez-les vers une base de test avant le premier démarrage, sinon le serveur de test écrit dans les données réelles.
4. Basculer : arrêtez le serveur de production, remplacez le jar, changez le Java (chemin complet, image Docker ou onglet Startup), redémarrez, puis prévenez les joueurs de mettre à jour leur launcher.
5. Mettre à jour les scripts qui dépendent des anciens chemins du monde.

Pour le détail de la méthode, notre guide pour mettre à jour un serveur de jeu Linux sans perdre sa configuration s'applique tel quel à Minecraft, et celui pour héberger un serveur Minecraft moddé Forge ou Fabric couvre l'installation des chargeurs en 26.x.

Réglages de la JVM sous Java 25

Les options mémoire ne changent pas : -Xms et -Xmx fixent toujours la taille du tas, c'est-à-dire la RAM réservée au serveur par la JVM, à garder sous la mémoire de la machine pour laisser de la place au système, et les options de démarrage d'Aikar, qui reposent sur le ramasse-miettes G1, restent utilisables sous Java 25. Notre guide pour optimiser les performances et le TPS d'un serveur Minecraft les détaille.

Java 25 apporte une option qui intéresse les serveurs gourmands en mémoire : les en-têtes d'objets compacts (JEP 519), passés du statut expérimental au statut de fonctionnalité standard dans JDK 25, mais désactivés par défaut. Ils réduisent la taille de l'en-tête de chaque objet Java, donc la mémoire occupée par le tas. Le launcher officiel les active pour le client depuis la 26.1 avec l'option -XX:+UseCompactObjectHeaders. Côté serveur, rien ne l'impose : ajoutez l'option sur votre serveur de test, comparez la mémoire utilisée et le TPS sur quelques jours, et ne la gardez en production que si la mesure est favorable.

java -Xms6G -Xmx6G -XX:+UseCompactObjectHeaders -jar server.jar nogui

Pour dimensionner la machine elle-même, notre article sur le coût d'un serveur Minecraft compare l'hébergement avec panel, le VPS Linux dès 5,99 € par mois et le serveur dédié.

Conclusion

Le passage de la 1.21.11 à la 26.x tient en une règle : Minecraft 26.1 et suivantes exigent Java 25, et un serveur qui affiche class file version 69.0 tourne simplement sur un Java trop ancien. Sur Debian 13, Ubuntu LTS, Rocky Linux ou AlmaLinux, Java 25 s'installe depuis les dépôts officiels ; sur Debian 12, il passe par Temurin ou par une migration vers Debian 13 ; sous Windows Server, par Microsoft Build of OpenJDK 25 ; sous Pterodactyl ou Docker, il suffit de changer d'image. Sur un réseau, le proxy Velocity passe en premier, lui aussi sous Java 25. Le vrai travail est ailleurs : sauvegarder avant la conversion du monde, adapter les scripts aux nouveaux chemins et attendre que plugins et mods suivent. Si vous préférez ne pas gérer Java du tout, deux pistes : un hébergement Minecraft avec panel, ou pour un serveur vanilla le moteur en Rust présenté dans notre article sur Horizon, un serveur Minecraft 26.3 sans Java. Et pour repartir de zéro sur une machine propre, notre guide pour héberger un serveur Minecraft entre amis reprend l'installation complète.