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
- 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.
- 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.
- 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.
- Pregenera i mondi grandi con un plugin come Chunky, con calma, quando nessuno sta giocando.
- 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.