Minecraft вылетает — частые ошибки и решения

Вылет почти всегда оставляет след: игра или Java записывают, что случилось, в файл. Задача — найти этот файл и прочитать в нём одну-две нужные строки. Ниже — где лежат логи, как их читать и что делать с ошибками, которые встречаются чаще всего.

Где искать логи и отчёты

У Minecraft Java три источника информации о вылете:

• crash-reports/crash-…-client.txt — отчёт, который игра пишет, когда падает «по-человечески». Самый понятный вариант.
• logs/latest.log — журнал последнего запуска. Нужен, если отчёта нет: например, игра упала ещё на загрузке.
• hs_err_pid….log — файл, который пишет сама Java, если упала не игра, а виртуальная машина. Обычно это драйверы или повреждённая Java.

1. 1

   Откройте папку игры

   В официальном лаунчере это .minecraft: на Windows — %APPDATA%\.minecraft, на macOS — ~/Library/Application Support/minecraft, на Linux — ~/.minecraft. В NLauncher у каждой сборки своя папка, а лог открывается кнопкой «Открыть лог» в окне ошибки.

2. 2

   Найдите свежий отчёт

   Если игра успела написать отчёт, он лежит в папке crash-reports — файл с датой и временем вылета. Если отчёта нет, откройте logs/latest.log и смотрите в конец файла.

3. 3

   Прочитайте Description и Caused by

   Строка Description: говорит, чем игра была занята в момент падения. Ниже — стек ошибок: ищите первую строку Caused by: и названия пакетов рядом с ней — по ним видно, какой мод или какая часть игры упала.

4. 4

   Сверьте с таблицей ошибок

   Найдите текст ошибки в разделах ниже и выполните решение. После каждого изменения запускайте игру снова: иногда за одной ошибкой прячется следующая.

Как прочитать краш-репорт

Отчёт начинается со строки ---- Minecraft Crash Report ----, потом идёт шуточная фраза и время. Дальше важное:

• Description: — что делала игра. Например, Initializing game — вылет на запуске, Ticking entity — сломалась какая-то сущность в мире, Rendering overlay — ошибка отрисовки.
• Первая строка с исключением, например java.lang.NullPointerException, и строки Caused by: ниже — сама причина.
• Строки стека вида at com.example.mod.SomeClass… — какой код упал. По имени пакета часто видно название мода.

В самом низу отчёта есть блок с системной информацией: версия Java, выделенная память, видеокарта и список модов. Его полезно проверить, если ошибка связана с Java или памятью.

Частые ошибки и решения

Не та версия Java: UnsupportedClassVersionError

Текст выглядит так: has been compiled by a more recent version of the Java Runtime (class file version 65.0), this version of the Java Runtime only recognizes class file versions up to 61.0. Это значит, что игру или мод собрали под более новую Java, чем та, на которой вы запускаете. Номер class file подсказывает, какая Java нужна:

Решение: запускайте игру на той Java, которую требует версия. Подробная таблица — в гайде «Какая Java нужна». Если Java не запускается вовсе — «Could not create the Java Virtual Machine», «Java not found», «Invalid maximum heap size», — смотрите гайд «Ошибки Java».

Старый Forge на новой Java: ClassCastException … URLClassLoader

Полный текст: class jdk.internal.loader.ClassLoaders$AppClassLoader cannot be cast to class java.net.URLClassLoader. Типичная ошибка Forge для 1.7.10–1.12.2, если запустить его на Java 9 и новее. Эти версии Forge рассчитаны только на Java 8.

Решение: поставьте для этой сборки Java 8. Подробнее о версии — на странице Minecraft 1.12.2.

Не хватает памяти: java.lang.OutOfMemoryError: Java heap space

Игре не хватило выделенной памяти — чаще всего в больших сборках или при загрузке огромного мира. Похожий вариант — GC overhead limit exceeded.

Решение: прибавьте 1–2 ГБ к -Xmx, но не отдавайте игре всю память компьютера. Сколько нужно в вашем случае — в гайде «Сколько памяти выделять».

Не хватает мода-зависимости

Многие моды не работают сами по себе: им нужна библиотека или другой мод. Для Fabric это чаще всего Fabric API. Загрузчики пишут об этом прямо:

• Fabric показывает окно с перечнем проблем, где сказано, что мод requires … fabric-api, which is missing! (вместо fabric-api может быть любая другая зависимость);
• Forge и NeoForge на новых версиях показывают экран Missing or unsupported mandatory dependencies со списком: какой мод чего требует и какой версии.

Решение: скачайте недостающий мод для своей версии игры и своего загрузчика. На Modrinth зависимости перечислены на странице мода в разделе Dependencies. Если в списке указана версия зависимости, возьмите именно её или новее.

Мод для другой версии или другого загрузчика

Мод для 1.20.1 не заработает на 1.21.1, а мод для Fabric — на Forge (кроме модов, которые явно поддерживают несколько загрузчиков в одном файле). Fabric в таком случае пишет, что мод требует другую версию minecraft, Forge и NeoForge — перечисляют мод в списке неподходящих. Иногда мод просто молча не загружается.

Решение: на Modrinth и CurseForge фильтруйте файлы по версии игры и загрузчику. Подробнее — в гайде «Моды и сборки с Modrinth».

Две копии одного мода

Бывает, когда обновили мод, скачав новую версию, но не удалили старую. Forge для 1.12.2 падает с DuplicateModsFoundException, новые загрузчики тоже сообщают, что один и тот же мод найден в нескольких файлах.

Решение: оставьте в папке mods только один файл каждого мода — самый новый для вашей версии.

OptiFine вместе с Sodium, Iris, Embeddium или Oculus

OptiFine переписывает отрисовку игры целиком. Sodium, Iris и их версии для Forge — Embeddium и Oculus — делают то же самое своим способом. Вместе они не уживаются: игра падает на запуске или при загрузке мира.

Решение: выберите что-то одно. На новых версиях с Fabric или NeoForge обычно берут Sodium и Iris, на Forge — OptiFine или Embeddium с Oculus. Про установку OptiFine — в гайде «Forge, Fabric, NeoForge и OptiFine».

Ошибка Mixin: Mixin apply failed

Mixin — механизм, которым моды на Fabric, NeoForge и новых Forge меняют код игры. Если два мода правят одно место несовместимо или мод рассчитан на другую версию игры, появляется Mixin apply failed или MixinTransformerError. Рядом в тексте обычно указан файл вида modid.mixins.json — по нему видно, какой мод виноват.

Решение: обновите этот мод; если не помогло — уберите его или мод, с которым он конфликтует. Совместимость часто описана на странице мода.

Видеокарта и OpenGL: GLFW error 65542, Pixel format not accelerated

GLFW error 65542: WGL: The driver does not appear to support OpenGL на новых версиях и Pixel format not accelerated на старых (1.12.2 и раньше) означают одно: игра не может работать с видеокартой через OpenGL. Чаще всего драйвера нет вовсе и Windows использует свой базовый адаптер без OpenGL. Для 1.17 и новее видеокарта должна поддерживать OpenGL 3.2 — очень старая встроенная графика может не подойти.

Решение: установите драйвер с сайта производителя видеокарты — NVIDIA, AMD или Intel. На ноутбуке с двумя видеокартами назначьте Java или лаунчеру высокопроизводительный графический процессор в «Параметры → Система → Дисплей → Графика» (Windows) или в панели управления NVIDIA. Какой OpenGL нужен каждой версии и что делать со старой видеокартой, удалённым рабочим столом или виртуальной машиной — в гайде «Ошибка OpenGL».

Падает сама Java: EXCEPTION_ACCESS_VIOLATION

Если окно игры исчезает, а рядом появляется файл hs_err_pid….log со строкой A fatal error has been detected by the Java Runtime Environment и EXCEPTION_ACCESS_VIOLATION, упала не игра, а виртуальная машина Java. Посмотрите строку Problematic frame:. Если там библиотека драйвера — nvoglv64.dll (NVIDIA), atio6axx.dll (AMD) или название, начинающееся с ig (Intel), — виноват драйвер видеокарты.

Решение: обновите драйвер видеокарты; отключите программы, которые встраиваются в окна игр (оверлеи записи экрана, «ускорители»); если не помогло — переустановите Java или дайте лаунчеру скачать её заново. Если лаунчер показывает только код выхода, сверьтесь с разделами про -1073741819 и -1073740791.

«Exit code: 1» или «-1» без подробностей

Код выхода только сообщает, что игра завершилась с ошибкой. Сам по себе он причину не называет — она в logs/latest.log. Откройте файл и прокрутите к концу: последние строки с ERROR или Exception и есть подсказка. Что значат коды 1, -1, -1073740791 и другие и что проверять по порядку — в гайде «Exit code в Minecraft».

Игра зависла на загрузке

Большие сборки грузятся несколько минут — это нормально, особенно при первом запуске. Проверьте, растёт ли latest.log: если да, игра работает. Если строки перестали появляться, а окно «не отвечает», частые причины — нехватка памяти, мод, который ждёт ответа из интернета, или повреждённый файл конфигурации мода.

«Разбор вылетов» в NLauncher

В NLauncher не нужно искать файлы вручную. Если игра закрылась с ошибкой, лаунчер сам открывает окно «Игра закрылась с ошибкой»: читает вывод игры, latest.log, краш-репорты и файлы hs_err, называет причину простыми словами и предлагает кнопку, которая её исправляет.

Что он распознаёт:

• не та версия Java, в том числе 32-битная Java;
• выделено больше памяти, чем есть у компьютера, или, наоборот, памяти не хватило;
• игру закрыла система, неверные флаги Java;
• повреждённые файлы игры или модов;
• нет нужной зависимости или она не той версии;
• мод для другой версии игры или другого загрузчика, устаревший загрузчик;
• моды, которые объявлены несовместимыми друг с другом, и дубликаты модов;
• OptiFine вместе с Sodium, Iris, Embeddium или Oculus;
• проблемы драйвера видеокарты NVIDIA, AMD, Intel, Mesa или Apple;
• ошибки Mixin, падение внутри конкретного мода, вылет самой Java, зависание игры.

Если ни одно правило не подошло, окно честно пишет «Не удалось определить причину» и даёт открыть лог.

Кнопки исправления зависят от причины: «Установить Java N», «Выделить N ГБ», «Установить мод(ы)» — недостающие зависимости ставятся с Modrinth, «Отключить…» и «Убрать лишние копии» — мод переименовывается в .disabled, и это можно отменить кнопкой «Вернуть», «Обновить «мод»», «Проверить и перекачать файлы», «Скачать драйвер». Рядом всегда есть «Запустить снова», «Скопировать отчёт», «Открыть лог» и «Написать в поддержку».

Если ничего не помогло

1. Проверьте чистую игру. Создайте новую сборку той же версии без модов. Если она запускается, проблема в модах, если нет — в Java, драйверах или системе.
2. Ищите мод делением пополам. Отключите половину модов (не трогая библиотеки, от которых зависят оставшиеся), запустите. Повторяйте с половиной, где остался вылет.
3. Обновите драйвер видеокарты и загрузчик. Старые версии Forge, NeoForge и Fabric Loader иногда несовместимы со свежими модами.
4. Спросите с логом. На форуме или в поддержке прикладывайте полный отчёт, а не скриншот.

Частые вопросы