Un serveur qui plante toutes les quelques heures est plus frustrant qu'un serveur qui ne démarre pas du tout. La cause se trouve presque toujours dans le crashlog, mais celui-ci est difficile à lire quand on ne sait pas où regarder. Voici les sept causes les plus fréquentes, comment les reconnaître et que faire.
Trouver les crashlogs
Minecraft écrit les crashlogs à deux endroits :
crash-reports/: rapports détaillés avec horodatage, message d'erreur et aperçu des plugins et mods chargés.logs/latest.log: le journal du serveur. Lors d'un crash, l'erreur se trouve en bas, juste avant la ligne "Stopping server".
Uploadez le rapport de crash sur mclo.gs pour obtenir une version lisible avec une analyse automatique.
1. Mémoire insuffisante (OutOfMemoryError)
Le crash le plus fréquent. Dans le log vous trouvez : java.lang.OutOfMemoryError: Java heap space. Le serveur a besoin de plus de mémoire que ce qui lui est alloué.
Solution : augmentez la mémoire via le panel de jeu ou passez à un forfait supérieur. Ne donnez jamais à Minecraft plus de 75 % de la mémoire système disponible si vous êtes sur un VPS.
2. Incompatibilité de plugin
Un plugin incompatible avec votre version de Minecraft fait planter le serveur au chargement ou lors d'une action spécifique. Dans le log, vous voyez le nom du plugin suivi d'un NoSuchMethodError ou ClassNotFoundException.
Solution : supprimez le plugin et vérifiez sur SpigotMC ou Hangar s'il existe une mise à jour pour votre version.
3. Mauvaise version de Java
Minecraft 26.x requiert Java 25. Si vous utilisez Java 21, le serveur ne démarre pas ou plante sur certaines fonctions. Le message d'erreur est : UnsupportedClassVersionError ou class file version 69.
Solution : définissez la bonne version de Java via l'onglet Startup. Voir quelle version de Java votre serveur nécessite.
4. Chunks corrompus
Un chunk endommagé (suite à un arrêt inattendu ou un bug) fait planter le serveur à chaque fois qu'il est chargé. L'erreur contient ChunkLoadException ou référence des coordonnées spécifiques.
Solution : supprimez le fichier de région endommagé dans world/region/. Le fichier s'appelle r.X.Z.mca où X et Z sont les coordonnées de région. Le serveur régénère la zone. Faites toujours une sauvegarde au préalable.
5. Boucle infinie dans un plugin ou un datapack
Un plugin qui provoque une boucle infinie bloque le serveur jusqu'à ce que le watchdog l'arrête. Le message est : The server has not responded for 60 seconds suivi d'un thread dump.
Solution : le thread dump montre quel plugin bloque le thread. Supprimez ou mettez à jour ce plugin.
6. Espace disque plein
Quand le disque est plein, le serveur ne peut plus sauvegarder le monde et plante. Le message d'erreur contient IOException ou No space left on device.
Solution : supprimez les anciennes sauvegardes, les logs inutiles ou les mondes non utilisés. L'onglet Files du panel de jeu affiche votre utilisation disque.
7. Timeout réseau ou hôte
Ce n'est pas un vrai crash, mais le serveur semble hors ligne. Le panel de jeu affiche "offline" alors que le conteneur tourne encore. Cela se produit lors de générations de chunks lourdes ou d'une attaque DDoS.
Solution : consultez la console. Si le serveur répond encore mais lentement, attendez que l'opération se termine. En cas de DDoS, vous voyez des milliers de tentatives de connexion ; contactez le support.
Mon serveur plante sans message d'erreur
S'il n'y a pas de rapport de crash et que latest.log s'arrête brusquement, il s'agit probablement d'un OOM-kill par le système d'exploitation. Le kernel arrête le processus sans que Java ait le temps d'écrire un rapport. Réduisez -Xmx ou augmentez la mémoire.
Puis-je faire analyser les crashlogs automatiquement ?
Uploadez-les sur mclo.gs. Ce site reconnaît les erreurs courantes et fournit une analyse lisible. Pour les problèmes complexes, vous pouvez partager le lien dans un ticket de support.
La réinstallation du serveur aide-t-elle ?
Rarement. La plupart des crashes proviennent de la configuration, des plugins ou du monde, pas des fichiers du serveur eux-mêmes. Une réinstallation sans résoudre le problème signifie que le crash reviendra dès que vous restaurerez les mêmes plugins et le même monde.
Chez HostValues, le panel de jeu surveille automatiquement votre serveur et le redémarre en cas de crash. Pour de l'aide avec les crashlogs, vous pouvez toujours ouvrir un ticket.
