NexthostingLogs

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

  1. 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.
  2. 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.
  3. 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.
  4. Pregenereer grote werelden met een plugin als Chunky – rustig, als niemand speelt.
  5. 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.