Logs / Guide des erreurs / Minecraft
Minecraft : « java.lang.OutOfMemoryError: Java heap space »
Ce que signifie le message
Java a épuisé la mémoire qu’il avait le droit de réserver pour le serveur Minecraft. Le serveur ne peut plus créer de nouveaux objets – il se fige généralement brièvement puis plante, souvent pendant la sauvegarde ou la génération de chunks.
À quoi cela ressemble dans le log
[14:02:11] [Server thread/INFO]: Starting minecraft server version 1.21.1
[14:02:11] [Server thread/INFO]: Loading properties
[14:02:19] [Server thread/INFO]: Preparing level "world"
[14:02:31] [Server thread/INFO]: Done (19.412s)! For help, type "help"
[14:37:52] [Server thread/WARN]: Can't keep up! Is the server overloaded? Running 4120ms or 82 ticks behind
[14:38:40] [Server thread/ERROR]: Encountered an unexpected exception
java.lang.OutOfMemoryError: Java heap space
at java.base/java.util.Arrays.copyOf(Arrays.java:3537)
at net.minecraft.world.level.chunk.storage.RegionFile.write(RegionFile.java:220)
[14:38:41] [Server thread/INFO]: Stopping server
Extrait d’un log d’exemple, marqué comme le fait l’analyse.
Causes fréquentes
- La valeur -Xmx dans la commande de démarrage est trop petite pour le monde, le nombre de joueurs et les mods.
- Un modpack ou de nombreux plugins ont besoin de plus de RAM que le serveur n’en a. Les gros modpacks atteignent vite 8 à 12 Go.
- Distance d’affichage (view-distance) ou distance de simulation élevée : chaque joueur garde alors beaucoup de chunks en mémoire.
- Une exploration rapide ou une prégénération crée beaucoup de nouveaux chunks en même temps.
- Un mod ou un plugin avec une fuite de mémoire : l’utilisation grimpe d’heure en heure jusqu’au plantage du serveur.
Comment le corriger
- Vérifiez la valeur -Xmx dans la commande de démarrage (par exemple -Xmx6G). Elle doit être inférieure d’environ 1 à 1,5 Go à la RAM de votre offre, pour que Java lui-même ait encore de la place.
- Réduisez view-distance dans server.properties à 8–10 et simulation-distance à 6–8. Sous Paper, vous pouvez aussi définir la distance d’affichage des joueurs séparément.
- Si l’utilisation grimpe lentement jusqu’au plantage, cherchez la fuite : retirez les plugins ou mods un par un et observez si la RAM reste stable. Sous Paper, la commande /spark heapsummary aide.
- Prégénérez les grands mondes avec un plugin comme Chunky – tranquillement, quand personne ne joue.
- Si la RAM ne suffit pas du tout pour votre modpack, passez à une offre avec plus de mémoire.
Si le log indique « Exit code 137 » à la place du message Java, ce n’est pas Java mais le système qui a arrêté le serveur, parce que toute la mémoire du conteneur était pleine. Dans ce cas, -Xmx est plutôt réglé trop haut que trop bas.