NexthostingLogs

Logs / Poradnik błędów / Minecraft

Minecraft: „java.lang.OutOfMemoryError: Java heap space”

Co oznacza ten komunikat

Java zużyła całą pamięć, którą mogła zarezerwować dla serwera Minecraft. Serwer nie może tworzyć nowych obiektów – zwykle na chwilę zawisa, a potem ulega awarii, często podczas zapisywania lub generowania chunków.

Jak to wygląda w logu

[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 przykładowego logu, zaznaczony tak, jak zaznacza go analiza.

Częste przyczyny

  • Wartość -Xmx w poleceniu startowym jest za mała na świat, liczbę graczy i mody.
  • Modpack lub wiele pluginów potrzebuje więcej RAM-u, niż ma serwer. Duże modpacki szybko dochodzą do 8–12 GB.
  • Duży zasięg widzenia (view-distance) lub zasięg symulacji: każdy gracz trzyma wtedy w pamięci wiele chunków.
  • Szybkie eksplorowanie lub pregeneracja tworzy wiele nowych chunków naraz.
  • Mod lub plugin z wyciekiem pamięci: zużycie rośnie z godziny na godzinę, aż serwer ulegnie awarii.

Jak to naprawić

  1. Sprawdź wartość -Xmx w poleceniu startowym (na przykład -Xmx6G). Powinna być o około 1–1,5 GB niższa niż RAM twojego planu, żeby sama Java też miała miejsce.
  2. Zmniejsz view-distance w server.properties do 8–10, a simulation-distance do 6–8. W Paper możesz też osobno ustawić zasięg widzenia dla graczy.
  3. Jeśli zużycie powoli rośnie aż do awarii, poszukaj wycieku: usuwaj pluginy lub mody po jednym i obserwuj, czy RAM zostaje stabilny. W Paper pomaga polecenie /spark heapsummary.
  4. Pregeneruj duże światy pluginem takim jak Chunky – spokojnie, gdy nikt nie gra.
  5. Jeśli RAM w ogóle nie wystarcza dla twojego modpacka, wybierz plan z większą pamięcią.

Jeśli w logu zamiast komunikatu Javy jest „Exit code 137”, to nie Java, tylko system zatrzymał serwer, bo cała pamięć kontenera była pełna. W takim przypadku -Xmx jest raczej ustawione za wysoko niż za nisko.