Minecraft affiche OutOfMemoryError ou se ferme par manque de RAM
Une erreur mémoire peut venir d’un nombre trop élevé de chunks, d’un modpack trop lourd ou d’un plugin qui conserve des objets.
Une erreur mémoire peut venir d’un nombre trop élevé de chunks, d’un modpack trop lourd ou d’un plugin qui conserve des objets. Augmenter la RAM sans mesurer ne corrige pas toujours la cause.
Procédure étape par étape
-
Lire la fin du log
Cherchez OutOfMemoryError, Java heap space, Cannot reserve bytes of direct buffer memory, GC overhead ou un arrêt code 137.
-
Réduire la distance d’affichage
Diminuez view-distance et simulation-distance dans server.properties, puis redémarrez une seule fois.
-
Isoler les plugins et les mods
Mettez à jour les plugins et les mods, puis désactivez temporairement le dernier ajouté si la hausse de la mémoire a commencé après son installation.
-
Ajuster les ressources
Si l’usage normal atteint régulièrement la limite, choisissez une offre avec plus de RAM en gardant une marge de 15 à 20 %.
Réglage prudent
view-distance=8
simulation-distance=6
Plafonner la mémoire directe (Netty) dans la commande de démarrage
-Xmx3G -XX:MaxDirectMemorySize=512M
Diagnostiquer la mémoire avec spark
spark health
spark heapsummary
Comprendre la limite de mémoire
Le serveur tourne dans un conteneur dont la RAM est plafonnée par votre offre. Java y réserve le tas (heap), où vivent les chunks, les entités et les données des plugins ; le reste sert à Java lui-même et aux threads.
Deux symptômes en découlent. Java heap space signifie que le tas est plein. Un arrêt avec code 137, sans message Java, signifie que le conteneur entier a dépassé sa limite et que le système a tué le processus.
La « Commande de démarrage », dans « Démarrage », montre comment la taille du tas est fixée : -Xmx ou -XX:MaxRAMPercentage. Si vous la modifiez, ne donnez jamais à -Xmx toute la RAM de l’offre : gardez une marge d’environ 10 à 15 % pour Java lui-même.
Mémoire directe : « Cannot reserve bytes of direct buffer memory »
Le message java.lang.OutOfMemoryError: Cannot reserve 16384 bytes of direct buffer memory (allocated: …, limit: …) ne concerne pas le tas mais la mémoire directe, hors tas, que Netty utilise pour les paquets réseau. Sa limite (-XX:MaxDirectMemorySize) vaut par défaut celle de -Xmx ; quand -Xmx prend presque toute la RAM de l’offre, il ne reste rien pour ces tampons et l’erreur apparaît dès qu’un pic réseau survient : connexion de plusieurs joueurs, chargement de chunks à distance d’affichage élevée, plugin qui envoie beaucoup de paquets.
Deux réglages suffisent le plus souvent : baisser -Xmx pour laisser 10 à 15 % de la RAM de l’offre hors tas, et fixer -XX:MaxDirectMemorySize à une valeur explicite (256M à 1G selon le nombre de joueurs). Si l’erreur persiste, réduisez view-distance, mettez à jour Java et le serveur, puis cherchez le plugin qui envoie le plus de paquets avec spark profiler.
Mesurer avant de changer d’offre
La ligne « Mémoire » de la console mesure tout le conteneur. Java garde la mémoire réservée même après un nettoyage : une valeur haute mais stable est normale. Notez plutôt quand l’erreur survient : à la connexion de plusieurs joueurs, pendant une exploration, ou après un temps de fonctionnement de plus en plus court.
- spark health affiche l’usage du tas et la durée des pauses du ramasse-miettes. spark est intégré aux versions récentes de Paper, ou s’installe comme plugin.
- spark heapsummary liste les objets qui occupent le plus de mémoire et aide à désigner le plugin ou le mod en cause.
Questions fréquentes
Que signifie Cannot reserve bytes of direct buffer memory ?
La mémoire directe de Java, utilisée par Netty pour le réseau, est pleine ; elle est distincte du tas. Fixez -XX:MaxDirectMemorySize (par exemple 512M) dans la commande de démarrage et laissez à -Xmx 10 à 15 % de marge sous la RAM de l’offre. Réduisez ensuite view-distance si beaucoup de joueurs explorent en même temps.
Que signifie l’arrêt avec code 137 ?
Le système a tué le processus parce que le conteneur a atteint sa limite de RAM ; Java n’a pas eu le temps d’écrire d’erreur. Réduisez la charge, vérifiez dans « Démarrage » que -Xmx n’est pas trop proche de la RAM de l’offre, puis changez d’offre si l’usage normal reste au maximum.
Que signifie GC overhead limit exceeded ?
Java passe presque tout son temps à libérer de la mémoire sans en récupérer assez. La cause est la même que pour Java heap space : trop de données chargées ou une fuite.
Pourquoi l’erreur unable to create native thread apparaît-elle ?
Elle concerne les threads, pas le tas : le serveur a atteint la limite de processus ou de mémoire du conteneur, et le panel ouvre la fenêtre « Limite de ressources possiblement atteinte ». Un plugin qui crée des threads en boucle en est souvent la cause : retirez le dernier ajouté, puis contactez le support avec l’erreur affichée si elle persiste.
Ajouter de la RAM suffit-il à régler le problème ?
Seulement si l’usage normal dépasse vraiment la limite, par exemple avec un modpack lourd. Face à une fuite, plus de RAM retarde le plantage de quelques heures sans le supprimer. Mesurez, corrigez la cause, puis passez par « Changer d’offre » si la marge reste insuffisante.