Le serveur Minecraft ne démarre pas

Un serveur Minecraft qui se ferme une seconde après son lancement ressemble à un mystère, et n'en est presque jamais un. Le serveur affiche la raison avant de quitter, dans la console ou dans logs/latest.log, et dans l'immense majorité des cas cette ligne nomme directement le problème. Ce guide couvre les cinq causes derrière presque tous les échecs de démarrage, comment reconnaître chacune à partir de son message d'erreur, et quoi modifier.

Lisez le journal avant de modifier quoi que ce soit

Ouvrez logs/latest.log dans le dossier du serveur et descendez tout en bas. Les dernières lignes, et la première ligne de la dernière trace d'appel, vous indiquent laquelle des causes ci-dessous vous touche. Deviner est ce qui transforme une réparation de deux minutes en soirée entière, car chaque solution ici est différente et aucune ne règle les autres.

Sur FluxCraft, la console et le fichier journal sont tous deux dans le tableau de bord, si bien que vous pouvez lire le crash sans SSH ni transfert de fichier. Si le serveur redémarre en boucle, le journal de la tentative précédente se trouve dans logs/ sous forme d'archive horodatée.

Cause 1 : l'EULA n'a pas été accepté

Au tout premier démarrage, le serveur génère eula.txt, affiche un avis sur l'acceptation de la licence de Mojang, puis s'arrête immédiatement. C'est de loin la raison la plus fréquente pour laquelle un serveur tout neuf « ne fonctionne pas », et ce n'est pas une erreur du tout : c'est le serveur qui attend votre accord.

Ouvrez eula.txt, remplacez eula=false par eula=true, enregistrez, et redémarrez. Rien d'autre dans le fichier n'a d'importance. Si vous êtes sur un hébergeur géré, l'EULA est en général accepté pour vous au déploiement, c'est pourquoi ce problème touche surtout les personnes qui installent un serveur à la main.

Cause 2 : la version de Java est incorrecte

C'est la panne qui déroute le plus, parce qu'elle ne ressemble pas à un problème de version. Le serveur lève UnsupportedClassVersionError, ou se plaint d'une « Unsupported class file major version », puis s'arrête. Cela signifie que le jar a été compilé pour un Java plus récent que celui avec lequel vous le lancez.

La configuration requise est un minimum, pas une correspondance exacte. Un Minecraft plus ancien tourne parfaitement sur un Java plus récent. L'échec ne se produit que dans l'autre sens, un Minecraft plus récent lancé sur un Java plus ancien. Les serveurs modés héritent de la configuration requise de la version de jeu que visent leur build Forge, NeoForge ou Fabric.

• Vérifiez ce que vous avez réellement avec « java -version ». Sur une machine avec plusieurs JDK installés, celui présent dans votre PATH n'est pas toujours celui que vous pensez.
• Si l'erreur mentionne la version majeure 65 et que vous avez Java 17, il vous faut Java 21. Installez la version LTS correspondante et indiquez explicitement son chemin dans votre script de démarrage plutôt que de compter sur le PATH.
• Sur un hébergement managé, c'est l'image qui s'en charge : choisir la bonne version serveur dans le tableau de bord suffit à corriger le problème.

Cause 3 : la mémoire est mal configurée, et pas simplement insuffisante

Deux erreurs de mémoire différentes font échouer un démarrage, et elles signifient le contraire l'une de l'autre. « Could not reserve enough space for object heap » au lancement signifie que vous avez demandé plus de RAM dans -Xmx que la machine ne peut en fournir, si bien que la JVM ne démarre jamais. Une OutOfMemoryError en cours de démarrage signifie que la valeur est trop basse pour ce que vous chargez, ce qui est très facile à faire sur un gros modpack.

Réglez -Xmx sur une valeur que la machine possède réellement, en laissant de la marge au système d'exploitation et à la surcharge de la JVM plutôt que d'allouer chaque octet. Sur une machine de 4 GB, -Xmx3G est raisonnable et -Xmx4G ne l'est pas. Vanilla demande au moins 2 GB ; un modpack moyen en veut 8 GB et un lourd 16 GB ou plus.

Une erreur fréquente, auto-infligée, consiste à copier un script de démarrage tiré d'un tutoriel écrit pour une autre machine. Si votre script dit -Xmx8G et que votre machine a 4 GB, le serveur ne démarrera jamais, quoi d'autre que vous corrigiez.

Cause 4 : le port est déjà utilisé

« FAILED TO BIND TO PORT » ou « Address already in use » signifie qu'autre chose occupe le port, et dans neuf cas sur dix il s'agit d'une ancienne instance de votre propre serveur qui ne s'est pas arrêtée proprement. Repérez un processus java résiduel, arrêtez-le, puis redémarrez.

L'autre cas est celui de deux serveurs configurés sur le même port. Java Edition utilise par défaut TCP 25565 et Bedrock UDP 19132, donc si vous faites tourner les deux sur une même machine ils n'entrent pas en conflit, mais deux serveurs Java, si. Modifiez server-port dans server.properties pour le second.

Sur un hébergeur géré, chaque déploiement reçoit son propre port, donc cette classe de panne disparaît. C'est un problème d'auto-hébergement.

Cause 5 : un mod ou un plugin empêche le démarrage

Si le journal se termine par une trace d'appel qui nomme un fichier dans plugins/ ou mods/, vous l'avez trouvé. Les causes habituelles sont un plugin conçu pour une autre version de Minecraft, un mod qui manque d'une dépendance, ou deux mods incompatibles entre eux. Le logiciel serveur compte aussi : un plugin Bukkit ne tourne pas sur vanilla, et un mod Forge ne tourne pas sur Fabric.

Quand la trace ne nomme rien d'utile, procédez par dichotomie. Retirez tout du dossier, vérifiez que le serveur démarre proprement, puis remettez la moitié et redémarrez. Quatre ou cinq tours suffisent pour isoler n'importe quel conflit, quelle que soit la taille du pack, et c'est bien plus rapide que de lire des changelogs.

Après une mise à niveau de version de Minecraft, supposez que chaque plugin a besoin d'une mise à jour correspondante. Mettre à niveau le jar serveur en gardant les plugins sur l'ancienne version est la cause la plus courante de l'arrêt d'un serveur qui fonctionnait.

Quand le serveur démarre mais que personne ne peut se connecter

C'est un autre problème, et le journal sera propre. Un serveur qui affiche « Done » au démarrage fonctionne ; si les joueurs n'arrivent pas à s'y connecter, le problème vient de l'adresse, de la redirection de port ou de online-mode. Vérifiez que vous donnez l'adresse complète avec le port, et que le port redirigé correspond à server-port dans server.properties.

Sur FluxCraft, votre serveur a sa propre adresse publique sur un domaine yourserver.app.runonflux.io : aucun routeur n'intervient et il n'y a rien à rediriger.

Une liste de contrôle à suivre

Dans l'ordre, car chaque étape élimine celles qui suivent :

• Ouvrez logs/latest.log et lisez les vingt dernières lignes. Comparez-les au tableau en haut de cette page.
• Vérifiez que eula.txt contient eula=true.
• Lancez « java -version » et comparez le résultat au tableau des versions ci-dessus.
• Vérifiez que -Xmx dans votre script de démarrage est nettement inférieur à la RAM physique de la machine.
• Cherchez un processus java orphelin qui occupe le port, et vérifiez qu'aucun second serveur ne le partage.
• Si une trace nomme un mod ou un plugin, retirez-le. Si rien n'est nommé, divisez le dossier par moitié (méthode dichotomique).
• Après une mise à niveau de version, mettez à jour chaque plugin et mod vers une build correspondante avant de chercher la cause ailleurs.

Un serveur qui démarre à chaque fois

La bonne version de Java, l'EULA accepté, la mémoire réglée et le port ouvert pour vous. Choisissez un palier de RAM et déployez en moins de 30 secondes, avec la console et les journaux à un clic. Première semaine offerte.