Minecraft : le serveur plante par manque de RAM (OutOfMemoryError)

L’erreur java.lang.OutOfMemoryError: Java heap space dans la console signifie que la JVM a épuisé la mémoire allouée. Le serveur se fige puis redémarre.

Cause / Le problème

Soit la RAM allouée (-Xmx) est insuffisante pour le nombre de joueurs et de mods, soit elle est trop élevée par rapport à la RAM totale du plan (le système kill le processus via OOMKiller).

Solution

1. Augmentez -Xmx dans le panel Pelican → onglet Startup → champ Server Memory Limit. Réglez la valeur en fonction de votre serveur :
   • Vanilla / 10 joueurs : 2-3 Go
   • Paper / 30 joueurs : 4-6 Go
   • Modpack lourd : 6-10 Go
2. Ne dépassez jamais 80 % de la RAM du plan. Gardez 1 à 1,5 Go pour le système et la JVM elle-même. Sur un plan 8 Go, allouez 6 Go maximum.
3. Alignez Xms sur Xmx. Avoir -Xms = -Xmx évite les pauses de redimensionnement du heap. Les flags Aikar recommandent cette égalité.
4. Utilisez les flags Aikar pour optimiser le garbage collector. Récupérez-les sur docs.papermc.io/paper/aikars-flags et collez-les dans le champ JVM Arguments du panel, en adaptant la valeur Xmx et Xms.
5. Réduisez la consommation si vous ne pouvez pas augmenter la RAM :
   • Baissez view-distance (gain immédiat de 1-2 Go).
   • Réduisez le nombre de chunks préchargés.
   • Limitez les mods/plugins gourmands identifiés avec Spark.
6. Détectez une fuite mémoire. Si l’utilisation RAM monte continuellement jusqu’au crash malgré assez de mémoire, un plugin fuit. Profilez avec /spark health pour voir la courbe.

Surveillez la RAM dans le panel : elle doit osciller et redescendre après chaque garbage collection, sans grimper en continu.