Vous avez mis à jour votre serveur Minecraft: Java Edition en version 26.1 ou plus récente (26.3 est sortie le 15 septembre 2026), et il s'arrête dès le lancement avec une erreur UnsupportedClassVersionError ? Depuis la version 26.1, Mojang indique que le jeu nécessite Java 25. Le launcher officiel fournit sa propre version de Java, mais un serveur que vous lancez vous-même utilise le Java installé sur le PC. Si c'est Java 21 ou plus ancien, le serveur ne peut pas démarrer. Ce guide explique comment le vérifier et le corriger sans perdre votre monde.
Problème
- La fenêtre du serveur se ferme aussitôt, ou la console affiche une erreur au démarrage.
- Le message contient « UnsupportedClassVersionError » et une phrase du type « 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 ».
- Le problème est apparu juste après le passage du serveur à Minecraft Java 26.1 ou à une version plus récente.
- Le jeu lui-même se lance normalement depuis le launcher officiel.
Ce qu'il faut savoir avant d'agir
- Le changement officiel : dans les notes de Minecraft Java Edition 26.1 (24 mars 2026), Mojang écrit : « The game now requires Java 25 ». La version de Java incluse avec le jeu est désormais Microsoft Build of OpenJDK 25.
- Comment lire le message d'erreur : selon la spécification Java d'Oracle, la version de format 65 correspond à Java 21, et Java 25 prend en charge jusqu'à la version 69. Le message « 69.0 … up to 65.0 » signifie donc : le serveur demande Java 25, mais c'est Java 21 qui le lance. Les nombres exacts peuvent varier selon la version de Java installée.
- Le launcher officiel n'est pas concerné : il installe lui-même le bon Java pour jouer. Ce guide vise les serveurs dédiés lancés avec un fichier .jar, et les launchers tiers qui utilisent un Java choisi par vous.
- Sauvegardez le monde : les mêmes notes de 26.1 indiquent que la structure de stockage des mondes et de leurs données a changé. Gardez une copie du monde d'avant la mise à jour : c'est votre seul retour arrière possible.
- Serveurs moddés ou à plugins : les logiciels de serveur tiers (avec mods ou plugins) ont leurs propres exigences. Vérifiez leur documentation officielle en plus de ce guide.
Étape 1 : vérifier la version de Java utilisée
Quand l'utiliser : toujours, en premier.
Solution proposée
- Ouvrez l'Invite de commandes (tapez « cmd » dans la recherche Windows).
- Tapez la commande suivante puis validez :
java -version
- Lisez la première ligne. Elle indique la version de Java appelée par défaut, par exemple « 21.0… » ou « 25.0… ».
- Pour voir tous les Java trouvés par Windows, dans l'ordre où ils sont utilisés, tapez :
where java
Résultat attendu : vous savez quelle version de Java démarre votre serveur.
Quand arrêter : si la commande affiche déjà une version 25 ou plus, et que le serveur échoue quand même, votre script de démarrage appelle peut-être un autre Java : passez directement à l'étape 4. Si Windows indique que « java » n'est pas reconnu, aucun Java n'est accessible : passez à l'étape 3.
Étape 2 : sauvegarder le monde avant tout
Quand l'utiliser : avant de démarrer le serveur pour la première fois en version 26.x.
Solution proposée
- Arrêtez le serveur.
- Dans le dossier du serveur, copiez le dossier du monde (par défaut world, ou le nom indiqué à la ligne level-name du fichier server.properties) vers un autre emplacement, par exemple un disque externe.
- Copiez aussi le fichier server.properties et votre script de démarrage (.bat).
Résultat attendu : vous disposez d'une copie complète du monde dans son état d'avant la mise à jour.
Retour arrière : si la nouvelle version ne vous convient pas, remettez l'ancien fichier .jar du serveur et la copie du monde.
Quand arrêter : si le monde est très volumineux, attendez la fin complète de la copie avant de continuer.
Étape 3 : installer Java 25
Quand l'utiliser : l'étape 1 affiche une version inférieure à 25, ou aucun Java.
Solution proposée
- Ouvrez la page officielle Télécharger Microsoft Build of OpenJDK. C'est la distribution que Mojang inclut avec le jeu.
- Dans la section OpenJDK 25, téléchargez l'installateur Windows x64 (.msi). Au moment de la rédaction (2 novembre 2026), la version proposée est la 25.0.5.0.2 LTS. Prenez la version la plus récente affichée.
- Lancez l'installateur. Selon Microsoft, l'installation met à jour par défaut la variable PATH, ce qui permet à Windows de trouver ce Java. Les intitulés des options peuvent différer.
- Fermez puis rouvrez l'Invite de commandes, et retapez java -version.
Résultat attendu : java -version affiche une version 25.
Retour arrière : désinstallez « Microsoft Build of OpenJDK » depuis Paramètres > Applications > Applications installées. Votre ancien Java n'est pas supprimé par cette installation : gardez-le si d'autres logiciels en ont besoin.
Quand arrêter : sur un PC à processeur ARM, choisissez le paquet aarch64 à la place du x64.
Étape 4 : faire démarrer le serveur avec Java 25
Quand l'utiliser : Java 25 est installé, mais le serveur affiche toujours l'erreur, ou java -version affiche encore une ancienne version.
Solution proposée
- Faites une copie de sauvegarde de votre script de démarrage (.bat).
- Ouvrez l'Explorateur de fichiers dans
C:\Program Files\Microsoftet repérez le dossier de Java 25. Son nom commence par « jdk-25 » et dépend de la version installée.
- Ouvrez le script de démarrage avec le Bloc-notes. Remplacez seulement le mot java au début de la ligne de lancement par le chemin complet vers java.exe, entre guillemets. Gardez les options déjà présentes (mémoire, nogui) et le nom de votre fichier .jar. Exemple, à adapter :
"C:\Program Files\Microsoft\jdk-25.X.X-hotspot\bin\java.exe" -jar server.jar nogui
- Enregistrez, puis lancez le script.
Résultat attendu : la console du serveur charge le monde sans erreur UnsupportedClassVersionError.
Retour arrière : remettez la copie du script faite au point 1.
Quand arrêter : dans l'exemple, remplacez « jdk-25.X.X-hotspot » par le nom réel du dossier (il peut être formé autrement sur votre PC). Copiez le chemin réel affiché dans l'Explorateur. Si une autre erreur apparaît (mods, plugins, port déjà utilisé), notez-la : ce n'est plus le problème de version de Java.
Cas particuliers
| Situation | Ce qu'il faut savoir |
|---|---|
| Launcher tiers | Il utilise souvent le Java choisi dans ses propres réglages. Sélectionnez-y Java 25 pour les versions 26.x. |
| Hébergeur de serveur | Choisissez Java 25 dans le panneau de l'hébergeur s'il le propose, ou contactez son support. |
| Serveur avec mods ou plugins | Le chargeur de mods ou le logiciel de serveur doit lui aussi être compatible avec la version 26.x. Consultez sa documentation officielle. |
| Plusieurs Java installés | Windows utilise le premier trouvé dans le PATH (voir where java). Le chemin complet dans le script (étape 4) évite toute ambiguïté. |
| Le jeu plante au lancement depuis le launcher officiel | C'est un autre problème : consultez le guide Minecraft Java plante au lancement (« Exit Code: 1 », « Le jeu a planté », écran noir) : solutions. Depuis la 26.1, le jeu réserve aussi 4 Go de mémoire par défaut : Mojang renvoie à un article d'aide sur l'allocation de mémoire pour les PC qui ont moins de 4 Go. |
| Le serveur démarre mais les joueurs ne peuvent pas se connecter | Consultez le guide Échec de connexion à un serveur Minecraft Java : causes et solutions. |
Vérification finale
- ☐ Une copie du monde d'avant la mise à jour est rangée à part.
- ☐ java -version affiche une version 25, ou le script appelle directement le java.exe de Java 25.
- ☐ Le serveur démarre et charge le monde sans UnsupportedClassVersionError.
- ☐ Les joueurs utilisent la même version de Minecraft que le serveur.
Sources
- Minecraft : Minecraft Java Edition 26.1 (notes officielles du 24 mars 2026 : Java 25 requis, Microsoft Build of OpenJDK 25 inclus, structure des mondes modifiée, 4 Go de mémoire par défaut)
- Minecraft : Minecraft Java Edition 26.3 (version sortie le 15 septembre 2026)
- Microsoft : télécharger Microsoft Build of OpenJDK (paquets OpenJDK 25 pour Windows x64 et aarch64)
- Microsoft : installer Microsoft Build of OpenJDK (mise à jour du PATH par défaut, options de l'installateur)
- Oracle : spécification de la machine virtuelle Java SE 21, chapitre 4 (tableau des versions de format : Java SE 21 = 65)
- Oracle : spécification de la machine virtuelle Java SE 25, chapitre 4 (Java SE 25 : versions 45 à 69)
Le problème continue ?
Répondez dans ce sujet en indiquant la version de Minecraft du serveur, le résultat de java -version et de where java, la ligne de lancement de votre script (sans mot de passe ni adresse IP publique), le logiciel de serveur utilisé (officiel, avec mods ou plugins) et le message d'erreur complet. Ne publiez jamais votre adresse e-mail, vos identifiants Microsoft ni votre mot de passe.