← Blog

Installer Java pour Minecraft : versions requises, configuration et erreurs courantes

Par Benjamin D. · PDG

· Lecture 6 min

Illustration de l'article : Installer Java pour Minecraft : versions requises, configuration et erreurs courantes
Sommaire

Installer Java pour Minecraft demande d'abord de savoir quelle version du JDK correspond à la version du jeu lancée, faute de quoi le launcher ou le fichier serveur refuse de démarrer. Minecraft Java Edition embarque son propre runtime dans le launcher officiel récent, mais un serveur autohébergé ou un launcher tiers réclame une installation manuelle, sur Windows, macOS ou Linux.



Installer Java pour Minecraft : quelle version choisir selon le jeu

Chaque grande mise à jour de Minecraft a relevé la version de Java minimale requise, en cohérence avec les fonctionnalités du moteur. Un serveur qui tourne sur une ancienne version du JDK plante au lancement avec une erreur de classe non supportée. Vérifier la correspondance avant toute installation évite l'essentiel des soucis de démarrage.

Version de MinecraftVersion de Java requise
1.16 et antérieuresJava 8
1.17Java 16
1.18 à 1.20.4Java 17
1.20.5 et suivantesJava 21

Pour vérifier la version installée sur une machine, ouvre un terminal et lance la commande suivante.

java -version

Si le résultat affiche une version inférieure à celle attendue par le jar du serveur, il faut installer le JDK correspondant, sans forcément désinstaller l'ancien : plusieurs versions de Java peuvent cohabiter sur une même machine.

Si tu gères un service dédié avec NexusPanel, la version de Java adaptée est déjà préconfigurée et basculée automatiquement au changement de version du jeu, ce qui évite ce diagnostic manuel. Voir l'offre d'hébergement Minecraft pour disposer d'un environnement Java toujours aligné sur la version choisie.



Installer Java sur Windows : étapes et vérification

Sur Windows, la méthode la plus fiable reste de télécharger le paquet MSI depuis un fournisseur officiel du JDK, comme Eclipse Adoptium, plutôt qu'un exécutable trouvé au hasard. L'installeur propose de coder le chemin dans la variable PATH : cette case doit rester cochée.

Vérifier la variable PATH

Une fois l'installation terminée, ouvre une nouvelle invite de commande (PowerShell ou cmd) et relance java -version. Si Windows répond que la commande est introuvable, la variable PATH n'a pas été mise à jour ou une ancienne session est encore ouverte.

Définir JAVA_HOME manuellement

Pour un serveur qui référence explicitement JAVA_HOME, ajoute la variable via les paramètres système avancés, ou en ligne de commande.

setx JAVA_HOME "C:\Program Files\Eclipse Adoptium\jdk-21"
setx PATH "%PATH%;%JAVA_HOME%\bin"

Un redémarrage du terminal, voire de la session, est nécessaire pour que le changement soit pris en compte partout.



Installer Java sur macOS avec Homebrew ou l'installeur officiel

macOS ne fournit plus Java par défaut depuis longtemps. Deux chemins existent : l'installeur pkg téléchargé directement, ou le gestionnaire de paquets Homebrew, plus pratique pour gérer plusieurs versions en parallèle.

brew install openjdk@21
sudo ln -sfn /opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk \
/Library/Java/JavaVirtualMachines/openjdk-21.jdk

Le lien symbolique permet au système de reconnaître le JDK dans /usr/libexec/java_home, utilisé par de nombreux launchers pour retrouver automatiquement la bonne version installée.

Pour lister les versions disponibles et basculer entre elles, la commande suivante est la plus rapide.

/usr/libexec/java_home -V

Elle affiche chaque JDK détecté avec son chemin complet, utile pour renseigner manuellement l'exécutable Java dans un launcher tiers ou un script de démarrage.



Installer Java sur Linux via apt ou les paquets Adoptium

Sur Debian ou Ubuntu, les dépôts standards contiennent généralement une version récente de Java, suffisante pour la plupart des installations. La commande d'installation cible directement le numéro de version voulu.

sudo apt update
sudo apt install openjdk-21-jre-headless

Le paquet headless suffit sur un système sans interface graphique, ce qui est le cas de la majorité des machines qui font tourner uniquement le processus serveur. Il consomme moins de ressources qu'un JDK complet.

Gérer plusieurs versions avec update-alternatives

Quand plusieurs versions de Java coexistent, l'outil update-alternatives permet de choisir celle utilisée par défaut sans modifier chaque script.

sudo update-alternatives --config java

Un menu numéroté liste les JDK installés ; il suffit de saisir le chiffre correspondant à la version voulue pour la définir comme référence système.



Configurer le chemin d'exécution et la mémoire allouée à Java

Une fois Java installé, le script de démarrage du serveur doit pointer vers le bon exécutable et recevoir des arguments de mémoire cohérents avec la RAM disponible sur la machine. Ces deux réglages évitent la majorité des plantages liés aux ressources.

Pointer vers le bon exécutable

Si plusieurs versions de Java coexistent, le script de lancement doit appeler explicitement le bon chemin plutôt que la commande générique java.

/usr/lib/jvm/java-21-openjdk-amd64/bin/java -Xmx6G -Xms6G -jar server.jar nogui

Régler -Xmx et -Xms

-Xmx fixe la mémoire maximale allouée à la JVM, -Xms la mémoire initiale réservée au démarrage. Les fixer à la même valeur évite les réallocations en cours de partie, source de micro-coupures sur les serveurs modés lourds.

Type de serveurRAM recommandée
Vanilla, petit groupe2 à 4 Go
Vanilla, communauté active4 à 6 Go
Modé (Forge, NeoForge, Fabric)8 Go et plus

Sur un VPS Linux personnel, il vaut mieux laisser au moins 1 à 2 Go de marge au système d'exploitation en dehors de ce qui est alloué à la JVM, sous peine de swap et de latence importante en jeu.



Diagnostiquer les erreurs de lancement Java les plus fréquentes

La grande majorité des erreurs au démarrage viennent d'une incompatibilité de version, d'un chemin mal configuré ou d'arguments JVM incohérents. Le message d'erreur affiché dans la console ou le fichier latest.log donne presque toujours la cause exacte.

UnsupportedClassVersionError

Ce message indique que le jar du serveur a été compilé pour une version de Java plus récente que celle installée. La solution consiste à mettre à jour le JDK, pas à modifier le jar.

Could not reserve enough space for object heap

La valeur passée à -Xmx dépasse la RAM physiquement disponible sur la machine. Réduire cette valeur, ou vérifier qu'aucun autre processus ne monopolise déjà la mémoire, résout le blocage.

Erreur « java » introuvable ou command not found

Le PATH ne référence aucun exécutable Java valide. Sur Windows, cela vient souvent d'une variable PATH non actualisée après installation ; sur Linux, d'un paquet installé sans lien symbolique correct dans /usr/bin.

Le serveur se lance puis se ferme immédiatement

  • Vérifier le fichier eula.txt, qui doit contenir eula=true.
  • Contrôler que le port réseau n'est pas déjà occupé par un autre processus.
  • Relire les dernières lignes du fichier logs/latest.log pour identifier l'exception exacte.


Conclusion

Fais correspondre en priorité la version du JDK à celle attendue par le jar du serveur avant de toucher aux arguments de mémoire : c'est la cause numéro un des échecs de lancement. Une fois Java validé par java -version, règle -Xmx selon la RAM réellement disponible, jamais au-delà.



FAQ

Peut-on avoir plusieurs versions de Java installées en même temps sur une machine ?

Oui, plusieurs JDK peuvent coexister sans conflit, chacun dans son propre dossier. Il suffit de désigner explicitement l'exécutable voulu dans le script de démarrage, ou d'utiliser un outil comme update-alternatives sur Linux pour définir une version par défaut sans casser les autres installations.

Faut-il installer le JRE ou le JDK pour faire tourner un serveur Minecraft ?

Le JRE headless suffit pour exécuter un jar de serveur, car aucune compilation n'est nécessaire. Le JDK complet n'est utile que si on développe un plugin ou un mod, ou qu'on compile des sources Java localement, ce qui alourdit inutilement une machine dédiée au seul jeu.

Pourquoi le serveur consomme-t-il plus de RAM que la valeur fixée dans -Xmx ?

La JVM consomme de la mémoire supplémentaire en dehors du tas Java pour son propre fonctionnement (metaspace, threads, buffers réseau). Il est normal d'observer une consommation totale dépassant légèrement la valeur de -Xmx, raison pour laquelle il faut toujours garder une marge de RAM disponible au niveau du système.

À lire aussi

Location de serveur Minecraft

+10 000 modpacks en 1 clic

à partir de 6,99€/mois

Louer mon serveur Minecraft