Используйте VisualVM, чтобы экспортировать дамп кучи игры и сообщить о проблемах с памятью.

Когда в игре появляется предупреждение о памяти, показанное на рисунке ниже, или после многократного входа в сохранение и выхода из него использование памяти продолжает расти, можно экспортировать дамп кучи согласно этой статье (.hprof), чтобы разработчики могли его проанализировать. Дамп кучи фиксирует объекты в куче Java на момент экспорта и связи между ними.

Высокое потребление памяти или появление предупреждений само по себе не доказывает наличие утечки памяти. При обратной связи укажите, что вы делали перед возникновением проблемы, и по возможности экспортируйте дамп, пока проблема ещё проявляется и игра ещё отвечает; после выхода из игры получить тогдашний дамп кучи уже не удастся.

• Из Официальный сайт VisualVMСкачайте и запустите VisualVM.

• Запустите сборку, которую нужно диагностировать, и постарайтесь воспроизвести проблему, например многократно входя в одно и то же сохранение и выходя из него или выполняя действия, приводящие к постоянному росту использования памяти.

• Выделите достаточно места на диске: дамп кучи может достигать нескольких ГБ, а для создания временных файлов и файлов, сохраняемых через «Сохранить как», требуется место.

• Во время экспорта игра может заметно зависать, дождитесь завершения операции.

1. В левой части VisualVM в разделе Applications → Local найдите запущенный процесс Java.

2. Дважды щёлкните по процессу-кандидату, на вкладке Overview проверьте, что он относится к текущей игре, по главному классу, пути к экземпляру модпака в параметрах JVM и другим данным; имя процесса может меняться в зависимости от лаунчера и способа запуска, поэтому нельзя судить только по наличию слова Prism.

3. Выберите процесс, который фактически запускает Minecraft. Не выбирайте VisualVM, Gradle Daemon, Gradle Wrapper или IntelliJ IDEA. При диагностике отдельного сервера следует выбирать Java-процесс сервера.

На изображении ниже показано только расположение списка процессов; на момент создания скриншота игра не была запущена, а выбранный Gradle Daemon не является игровым процессом.

Переключитесь на Monitor страницу, где можно увидеть график кучи, а также в правом верхнем углу Perform GC и Heap Dump кнопки. На рисунке ниже по-прежнему показано расположение кнопок на примере Gradle Daemon; при выполнении действий убедитесь, что текущая вкладка относится к игровому процессу.

1. После воспроизведения проблемы в игре вернитесь в VisualVM на Monitor страницу и убедитесь, что график Heap обновляется.

2. Если разработчик просит посмотреть состояние после сборки мусора, можно сначала один раз нажать Perform GC, дождаться завершения операции и указать в отзыве, что это действие выполнялось; при обычном сборе можно сразу перейти к следующему шагу, повторно нажимать не нужно.

3. Нажмите Heap Dump, дождитесь создания дампа кучи. В это время игра может зависнуть; длительность зависит от размера кучи и других факторов. После завершения в VisualVM появится узел дампа кучи и откроется соответствующая вкладка.

4. В дереве Applications слева щёлкните правой кнопкой мыши по новому узлу дампа кучи и выберите Save As..., сохраните как .hprof файл.

5. Дождитесь завершения сохранения, убедитесь, что файл создан в каталоге сохранения, и затем выйдите из игры.

После создания дампа кучи также необходимо выполнить Save As. Официальная документация VisualVM поясняет, что дамп кучи до явного сохранения является лишь временным файлом. Подробнее см. Просмотр дампа кучи.

Отправляйте вопросы через раздел обратной связи в правом верхнем углу официального сайта или через раздел Issues в репозитории GitHub, указанном на официальном сайте..hprof Если файл большой, можно сначала сжать его в .zip или .gz；если через раздел обратной связи загрузить невозможно, загрузите с помощью файлообменного сервиса и укажите в обратной связи ссылку для скачивания и необходимый код извлечения.

Пожалуйста, также предоставьте следующую информацию, чтобы разработчики могли воспроизвести проблему:

• Версия модпака, версия Java и максимальный объём памяти, выделяемый игре.

• Шаги воспроизведения: какие действия выполнялись, сколько раз повторялись, через какое время появилось предупреждение или заметное зависание.

• Статус при экспорте: всё ещё в сохранении или уже возвращено в главное меню; выполнялось ли Выполнить сборку мусора.

• .hprof файл или ссылка для скачивания, а также этого запуска logs/latest.log; если есть отчёты о сбоях, также приложите их.

• VisualVM：Просмотр дампа кучи

• VisualVM：Работа с локальными приложениями

• VisualVM：Начало работы с VisualVM

• VisualVM：Возможности

• Oracle Java：Диагностика утечек памяти