Logs / Guía de errores / Minecraft
Minecraft: «java.lang.OutOfMemoryError: Java heap space»
Qué significa el mensaje
Java ha agotado la memoria que podía reservar para el servidor de Minecraft. El servidor no puede crear más objetos: normalmente se congela un momento y después se cierra inesperadamente, a menudo mientras se guardan o generan chunks.
Así se ve en el 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
Fragmento de un log de ejemplo, marcado igual que lo marca el análisis.
Causas habituales
- El valor -Xmx del comando de inicio es demasiado pequeño para el mundo, el número de jugadores y los mods.
- Un modpack o muchos plugins necesitan más RAM de la que tiene el servidor. Los modpacks grandes llegan enseguida a 8 o 12 GB.
- Distancia de renderizado (view-distance) o de simulación alta: cada jugador mantiene entonces muchos chunks en memoria.
- Explorar rápido o pregenerar crea muchos chunks nuevos a la vez.
- Un mod o plugin con una fuga de memoria: el uso sube hora tras hora hasta que el servidor se cierra.
Cómo solucionarlo
- Revisa el valor -Xmx del comando de inicio (por ejemplo, -Xmx6G). Debería quedar entre 1 y 1,5 GB por debajo de la RAM de tu plan para que Java mismo tenga margen.
- Baja view-distance en server.properties a 8 o 10 y simulation-distance a 6 u 8. En Paper también puedes ajustar la distancia de renderizado de los jugadores por separado.
- Si el uso sube despacio hasta el cierre, busca la fuga: quita plugins o mods de uno en uno y observa si la RAM se mantiene estable. En Paper ayuda el comando /spark heapsummary.
- Pregenera los mundos grandes con un plugin como Chunky, con calma y cuando no haya nadie jugando.
- Si la RAM no alcanza en absoluto para tu modpack, elige un plan con más memoria.
Si el log dice «Exit code 137» en lugar del mensaje de Java, no fue Java sino el sistema el que detuvo el servidor, porque toda la memoria del contenedor estaba llena. En ese caso, es más probable que -Xmx esté demasiado alto que demasiado bajo.