Le message d'erreur contient déjà la réponse : s'il indique class file version 65.0, le fichier exige Java 21. Le calcul est toujours le même : le nombre moins 44 donne la version de Java. Mais plus important que le nombre, il faut savoir quel fichier est concerné : dans la plupart des cas, le serveur n'est pas trop ancien, c'est un plugin précis qui est trop récent.

Lire le message

Une ligne typique ressemble à ceci :

java.lang.UnsupportedClassVersionError: com/example/PluginMain has been compiled by a more
recent version of the Java Runtime (class file version 65.0), this version of the Java Runtime
only recognizes class file versions up to 61.0

Elle contient trois informations :

  1. com/example/PluginMain — ce qui provoque l'erreur. Si un nom de plugin ou de mod apparaît ici, cela signifie que ce fichier précis ne convient pas ; le serveur lui-même est correct.
  2. class file version 65.0 — ce qui est requis : 65 − 44 = Java 21.
  3. only recognizes … up to 61.0 — ce qui tourne actuellement : 61 − 44 = Java 17.

En clair : un plugin compilé pour Java 21 se trouve sur un serveur qui tourne avec Java 17.

Tableau de conversion

class file version Version de Java
52.0 Java 8
55.0 Java 11
60.0 Java 16
61.0 Java 17
65.0 Java 21
69.0 Java 25

Ces nombres viennent de la spécification officielle de la JVM. L'écart de 44 y est constant depuis Java 1.0 : tu peux donc calculer toi-même chaque future version sans étendre le tableau.

À retenir : un environnement Java comprend toujours toutes les versions de fichiers de classe plus anciennes, mais jamais une plus récente. C'est pourquoi un plugin Java 8 tourne sans problème sous Java 21, mais jamais l'inverse.

Quelle version de Java faut-il pour quelle version de Minecraft ?

Version de Minecraft Java requis
jusqu'à 1.16.5 Java 8
1.17 – 1.17.1 Java 16 (en pratique Java 17)
1.18 – 1.20.4 Java 17
à partir de 1.20.5 Java 21
à partir de 26.0 Java 25

Chez nous, tu n'as pas besoin de régler ça. Nous déduisons l'environnement d'exécution à partir de la version Minecraft de ton serveur et nous le définissons automatiquement. Si tu commandes une 1.21, tu obtiens Java 21 sans chercher un interrupteur.

Pour les forks de serveur comme Leaf et Leaves, nous maintenons en plus une correspondance exacte par release, au lieu de reprendre la règle générale. La raison : un fork peut s'écarter des exigences Vanilla, et une hypothèse optimiste tomberait justement à côté quand cela compte. Si aucune version de Java adaptée n'existe pour une combinaison, nous interrompons volontairement l'opération au lieu de lancer un environnement trop ancien — un serveur qui ne démarre même pas avec une mauvaise configuration est plus facile à réparer qu'un serveur qui tourne à moitié.

Le cas le plus fréquent : un plugin, pas le serveur

Si ton serveur fonctionnait encore juste avant et que l'erreur est apparue après l'ajout d'un fichier, la situation est claire. Procédure :

  1. Note le nom de classe indiqué dans le message. Il nomme presque toujours le projet.
  2. Cherche chez le fournisseur la bonne variante de build. Beaucoup de plugins proposent des téléchargements séparés pour Java 17 et Java 21, souvent avec le suffixe -java17 ou sous forme de branche de release dédiée. Le fichier le plus récent n'est pas automatiquement le bon.
  3. S'il n'existe aucune variante adaptée, il te faut une version de Minecraft plus récente, car c'est elle qui apporte le nouvel environnement d'exécution. La procédure pour changer de version sans perdre ton monde est expliquée dans changer la version d'un serveur Minecraft.
  4. Retire temporairement le plugin si le serveur doit redémarrer rapidement. Installer des mods et plugins Minecraft montre comment ajouter et retirer proprement des plugins.

L'autre cas : Java est trop récent

Ce cas est rarement expliqué, mais il arrive régulièrement. Les anciens modpacks Forge — le classique est 1.12.2 — sont conçus pour Java 8. Sous Java 21, ils échouent, mais généralement pas avec UnsupportedClassVersionError ; tu verras plutôt des messages sur des classes internes manquantes ou des paramètres de démarrage refusés.

Indice : le pack fonctionnait auparavant, ou il fonctionne chez d'autres, et ton serveur indique une très ancienne version de Minecraft. La solution n'est alors pas un Java plus récent, mais la version de Minecraft correspondant au pack dans le panel — ainsi, nous définissons l'ancien environnement d'exécution adapté.

Note franche : notre correction automatique ne s'applique pas dans ce cas. Elle répare uniquement dans le sens « trop ancien », donc lorsque le serveur a besoin d'un Java plus récent que celui qui tourne. Un Java trop récent n'est volontairement pas considéré comme une dérive — sinon, un client qui a choisi volontairement un ancien environnement le perdrait automatiquement.

Ce que nous prenons automatiquement en charge

  • Environnement adapté dès la commande. La version de Java suit la version de Minecraft, sans réglage.
  • Correction lors d'un changement de version. Si tu passes à une version qui exige un Java plus récent, l'environnement d'exécution est mis à jour avec elle.
  • Le boot log prime sur le calcul. Si ton serveur indique lui-même au démarrage une version de Java requise supérieure à celle qui tourne, nous corrigeons à partir de cette mesure — pas à partir de la déduction faite depuis la version commandée. Une déclaration du serveur sur lui-même est plus fiable que n'importe quel tableau.
  • Les images personnalisées restent intactes. Si ton serveur tourne sur un environnement que tu as choisi toi-même, nous n'intervenons pas.
  • Fail-closed plutôt qu'à moitié correct. S'il n'existe aucun Java adapté pour une combinaison, nous interrompons le démarrage et le signalons au lieu de lancer un mauvais environnement.

Troubleshooting

Symptôme Vérification Solution
class file version 65.0 indiqué, le nom de classe est un plugin Le serveur fonctionnait-il avant l'ajout ? Charger le build du plugin adapté à ta version MC
Erreur directement au démarrage du serveur, aucun plugin indiqué Quelle version de Minecraft tourne ? Aligner la version et l'environnement d'exécution
Ancien modpack 1.12.2 qui ne démarre pas Le log indique-t-il des classes internes manquantes ? Java est trop récent — choisir la version MC adaptée
Erreur après un changement de version Est-elle apparue juste après le changement ? Attendre le redémarrage ; si elle reste, contacter le support avec la ligne complète
Le plugin se charge, mais des fonctions manquent Le log contient-il un avertissement plutôt qu'une erreur ? Autre cause — pas la version de Java

FAQ

Puis-je changer moi-même la version de Java ?

Chez nous, ce n'est pas nécessaire : elle découle de la version Minecraft de ton serveur. Si tu as besoin d'un autre environnement d'exécution, la bonne méthode est de changer la version de Minecraft — ainsi, toute l'environnement reste cohérent.

Un Java plus récent est-il toujours meilleur ?

Non. Pour Minecraft, la version requise est aussi une limite supérieure pratique : le cœur du serveur, les mods et les plugins sont conçus pour elle. Passer à un environnement plus récent « au cas où » n'apporte aucun avantage et casse les anciens mods.

Pourquoi mon plugin fonctionne-t-il en local, mais pas sur le serveur ?

Parce que ton installation Java locale peut être plus récente que celle du serveur. Ce qui compte, c'est l'environnement d'exécution sur le serveur, pas celui de ton ordinateur.

Comment savoir avec quel Java mon serveur tourne actuellement ?

Le message te le dit : only recognizes class file versions up to 61.0 signifie Java 17. Sans message d'erreur, le démarrage du serveur indique la version de Java dans les premières lignes de la console.

Dois-je recréer mon monde après un changement de Java ?

Non. L'environnement d'exécution concerne seulement l'exécution, pas le format du monde. En revanche, un changement de version de Minecraft peut modifier le format du monde — fais donc une sauvegarde avant.

Nächste Schritte

Si le serveur refonctionne, mais reste lent, corriger un watchdog timeout sur un serveur Minecraft qui lag peut t'aider. Si la RAM ne correspond pas à la taille du modpack, le calculateur de RAM Minecraft estime le besoin.

Tu cherches un serveur où la version de Java s'adapte automatiquement à la version du jeu ? Tu trouveras les offres sur louer un serveur Minecraft.

Sources et banc de test

Banc de test : 24 août 2026. Les nouvelles versions de Minecraft peuvent apporter de nouvelles exigences Java ; les sources liées correspondent à l'état actuel.