Un cierre con java.lang.OutOfMemoryError, tirones o un uso de memoria que sube con el tiempo no demuestran por sí solos una fuga. El mensaje exacto del error ayuda a separar heap Java, Metaspace y memoria nativa; una fuga es una causa posible, pero también puede haber un heap demasiado pequeño para el modpack o una carga puntual.
1. Identifica qué memoria se agotó
Lee la línea completa del error en latest.log o en el informe de cierre. Java heap space indica que no se pudo reservar un objeto en el heap, pero no prueba una fuga; Metaspace y los mensajes de memoria nativa requieren un diagnóstico distinto. Consulta la guía de Oracle sobre errores de memoria Java y evita cambiar varios argumentos JVM a la vez.
Anota la versión de Minecraft, Java, cargador y mods, además del valor de -Xmx. Cierra otras aplicaciones y comprueba la memoria disponible del sistema. Si el heap llega a su máximo de forma estable, compara el tamaño del modpack y la memoria física libre antes de aumentarlo; asignar más memoria de la que el equipo puede reservar puede empeorar la situación.
2. Reproduce el problema con una instancia aislada
- Copia el perfil y el mundo, y conserva intacta la instancia original.
- Repite una ruta breve con la misma distancia de renderizado y los mismos ajustes. Anota el uso del heap al iniciar, después de cargar el mundo y tras repetir la ruta.
- Si el uso sube, deja que Java recolecte memoria de forma normal y observa si vuelve a bajar. Un pico temporal no basta para diagnosticar una fuga.
- Desactiva mods por grupos pequeños en una copia y revisa cambios en el registro; después reduce al mod sospechoso y sus dependencias para confirmar la relación.
Para consultar el registro, sigue la guía de lectura de latest.log y crash reports. No subas registros o volcados públicos sin revisar si incluyen nombres de usuario, rutas locales o datos de servidores.
3. Usa Spark para resumir o capturar el heap
Spark ofrece dos comandos diferentes: /spark heapsummary crea un resumen del heap para inspección en su visor, mientras que /spark heapdump guarda una instantánea completa .hprof en disco. En una instalación Fabric/Forge de cliente, el comando puede requerir el prefijo /sparkc; consulta la documentación de comandos de Spark para tu entorno y permisos.
Un heap dump puede ocupar mucho espacio y contener datos de la sesión: guárdalo localmente y no lo compartas sin inspeccionarlo. Ábrelo con VisualVM o Eclipse MAT y compara instantáneas tomadas en condiciones equivalentes; el número de objetos por sí solo no identifica al mod responsable. Spark también permite perfilar asignaciones con /spark profiler start --alloc, opción que sirve para observar presión de asignación, no para probar por sí sola una fuga.
4. Verifica mods de corrección antes de instalarlos
No instales automáticamente un mod llamado “Memory Leak Fix”: su propia ficha indica que los problemas que corregía en Minecraft 1.20.5 y posteriores ya fueron solucionados en el juego y que allí queda obsoleto. En versiones antiguas puede haber publicaciones aplicables; revisa siempre la versión exacta y el cargador en la ficha de Memory Leak Fix. Para otros mods, comprueba la documentación y los reportes de errores de la versión que utilizas.
Fuentes y límites de esta guía
Esta guía ofrece un procedimiento de diagnóstico general y no presenta perfiles medidos por nuestro equipo ni atribuye fugas a un mod sin evidencia. Las herramientas y opciones cambian por versión; sigue las instrucciones de Spark, Oracle y los autores de cada mod antes de capturar o compartir datos.