Logs / Fehler-Lexikon / Minecraft
Minecraft: „java.lang.OutOfMemoryError: Java heap space“
Was die Meldung bedeutet
Java hat den Speicher aufgebraucht, den es für den Minecraft-Server reservieren durfte. Der Server kann keine neuen Objekte mehr anlegen – meist friert er kurz ein und stürzt dann ab, oft während Chunks gespeichert oder generiert werden.
So sieht es im Log aus
[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
Ausschnitt aus einem Beispiel-Log, so wie die Auswertung ihn markiert.
Häufige Ursachen
- Der Wert -Xmx im Startbefehl ist zu klein für Welt, Spielerzahl und Mods.
- Ein Modpack oder viele Plugins brauchen mehr RAM, als der Server hat. Große Modpacks liegen schnell bei 8 bis 12 GB.
- Hohe Sichtweite (view-distance) oder Simulationsweite: Jeder Spieler hält dann viele Chunks im Speicher.
- Schnelles Erkunden oder Pre-Generierung erzeugt viele neue Chunks auf einmal.
- Ein Mod oder Plugin mit Speicherleck: Der Verbrauch steigt Stunde um Stunde, bis der Server abstürzt.
So behebst du den Fehler
- Prüf im Startbefehl den Wert -Xmx (zum Beispiel -Xmx6G). Er sollte etwa 1 bis 1,5 GB unter dem RAM deines Pakets liegen, damit Java selbst noch Platz hat.
- Senk view-distance in der server.properties auf 8 bis 10 und simulation-distance auf 6 bis 8. Bei Paper kannst du zusätzlich die Sichtweite für Spieler getrennt einstellen.
- Steigt der Verbrauch langsam bis zum Absturz, such das Leck: Plugins oder Mods testweise entfernen und beobachten, ob der RAM stabil bleibt. Bei Paper hilft der Befehl /spark heapsummary.
- Generier große Welten vorab mit einem Plugin wie Chunky – in Ruhe, wenn niemand spielt.
- Reicht der RAM für dein Modpack grundsätzlich nicht, nimm ein Paket mit mehr Arbeitsspeicher.
Steht statt der Java-Meldung „Exit code 137“ im Log, hat nicht Java, sondern das System den Server beendet, weil der gesamte Speicher des Containers voll war. Dann ist -Xmx eher zu hoch als zu niedrig eingestellt.