Logs / Foutengids / Minecraft
Minecraft: “java.lang.OutOfMemoryError: Java heap space”
Wat de melding betekent
Java heeft het geheugen opgebruikt dat het voor de Minecraft-server mocht reserveren. De server kan geen nieuwe objecten meer aanmaken – hij blijft meestal even hangen en crasht dan, vaak tijdens het opslaan of genereren van chunks.
Zo ziet het eruit in de 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
Fragment uit een voorbeeldlog, gemarkeerd zoals de analyse dat doet.
Veelvoorkomende oorzaken
- De waarde -Xmx in het startcommando is te klein voor de wereld, het aantal spelers en de mods.
- Een modpack of veel plugins hebben meer RAM nodig dan de server heeft. Grote modpacks komen snel op 8 tot 12 GB.
- Hoge zichtafstand (view-distance) of simulatieafstand: elke speler houdt dan veel chunks in het geheugen.
- Snel verkennen of pregeneratie maakt in één keer veel nieuwe chunks aan.
- Een mod of plugin met een memory leak: het verbruik stijgt uur na uur tot de server crasht.
Zo los je het op
- Controleer de waarde -Xmx in het startcommando (bijvoorbeeld -Xmx6G). Die moet ongeveer 1 tot 1,5 GB onder het RAM van je pakket liggen, zodat Java zelf ook nog ruimte heeft.
- Verlaag view-distance in server.properties naar 8 tot 10 en simulation-distance naar 6 tot 8. Op Paper kun je de zichtafstand voor spelers ook apart instellen.
- Als het verbruik langzaam stijgt tot de crash, zoek dan de leak: verwijder plugins of mods één voor één en kijk of het RAM stabiel blijft. Op Paper helpt het commando /spark heapsummary.
- Pregenereer grote werelden met een plugin als Chunky – rustig, als niemand speelt.
- Als het RAM voor je modpack helemaal niet volstaat, neem dan een pakket met meer geheugen.
Als in de log “Exit code 137” staat in plaats van de Java-melding, was het niet Java maar het systeem dat de server stopte, omdat al het geheugen van de container vol was. In dat geval is -Xmx eerder te hoog dan te laag ingesteld.