NexthostingLogs

Logs / Guida agli errori / Minecraft

Minecraft: «java.lang.OutOfMemoryError: Java heap space»

Cosa significa il messaggio

Java ha esaurito la memoria che poteva riservare al server Minecraft. Il server non può creare nuovi oggetti: di solito si blocca per un attimo e poi va in crash, spesso mentre vengono salvati o generati dei chunk.

Come appare nel 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

Estratto da un log di esempio, evidenziato come lo evidenzia l’analisi.

Cause frequenti

  • Il valore -Xmx nel comando di avvio è troppo piccolo per il mondo, il numero di giocatori e le mod.
  • Un modpack o molti plugin richiedono più RAM di quella che ha il server. I modpack grandi raggiungono in fretta da 8 a 12 GB.
  • View distance (view-distance) o simulation distance alta: ogni giocatore tiene in memoria molti chunk.
  • L’esplorazione veloce o la pregenerazione creano molti chunk nuovi in una volta.
  • Una mod o un plugin con un memory leak: l’utilizzo sale ora dopo ora finché il server va in crash.

Come risolvere

  1. Controlla il valore -Xmx nel comando di avvio (ad esempio -Xmx6G). Dovrebbe essere circa 1–1,5 GB sotto la RAM del tuo piano, così a Java resta comunque spazio.
  2. Abbassa view-distance in server.properties a 8–10 e simulation-distance a 6–8. Su Paper puoi impostare la view distance anche separatamente per i giocatori.
  3. Se l’utilizzo sale lentamente fino al crash, cerca il leak: rimuovi plugin o mod uno alla volta e osserva se la RAM resta stabile. Su Paper aiuta il comando /spark heapsummary.
  4. Pregenera i mondi grandi con un plugin come Chunky, con calma, quando nessuno sta giocando.
  5. Se la RAM non basta proprio per il tuo modpack, scegli un piano con più memoria.

Se nel log al posto del messaggio di Java c’è «Exit code 137», non è stato Java ma il sistema a fermare il server, perché tutta la memoria del container era piena. In quel caso è più probabile che -Xmx sia impostato troppo alto che troppo basso.