Майнкрафт не запускается или вылетает с модами: что делать

Как понять, что именно сломалось

Шагов, на которых всё обрывается, три. От того, какой ваш, зависит, какой файл открывать.

• Не запускается лаунчер Майнкрафт. Окно не появляется или мигает и закрывается. Моды тут ни при чём: их читает игра, а до игры дело не дошло. Разбор — в следующем разделе.
• Лаунчер открылся, игра не стартует. Вы нажали «Играть», окно игры не появилось, лаунчер вернулся в исходное состояние. Причина записана в логе последнего запуска.
• Игра открылась и вылетела. Логотип Mojang, экран загрузки или уже главное меню — и вылет. Причина записана в отчёте о падении (crash report).

Лог и отчёты лежат в папке игры:

У Prism Launcher, ATLauncher и Modrinth App папка своя на каждый набор модов — общая .minecraft не используется, и моды в неё класть бесполезно; открывайте папку из меню набора. Пути в таблице — для официального лаунчера. У сторонних лаунчеров вроде TLauncher путь тоже свой, посмотрите его в настройках самого лаунчера.

Файл latest.log открывается обычным блокнотом и перезаписывается при каждом запуске — скопируйте его сразу. Ищите не последнюю строку, а первую, где стоит Error, Caused by или missing: дальше идут последствия, а не причина.

Не запускается лаунчер Майнкрафт — что делать

Окно лаунчера не появилось или мигнуло и закрылось. Моды тут ни при чём: их читает игра, а до игры дело не дошло — папку mods можно не трогать. Проверяйте по порядку, от частого к редкому.

1. Снимите зависшие процессы. В диспетчере задач закройте процессы лаунчера и javaw и откройте лаунчер заново: пока в памяти висит прежняя копия, новая не запустится.
2. Запустите ванильный профиль без модов. Лаунчер открылся, а игра не стартует даже на чистом профиле — причина в самой игре, Java или лаунчере, а не в наборе модов.
3. Переустановите Java. На ней работают и лаунчер, и игра: после её обновления или удаления другой программой не открывается ни то, ни другое.
4. Проверьте, тот ли лаунчер вы чините. У Prism Launcher, ATLauncher, Modrinth App и сторонних сборок вроде TLauncher свои настройки и своя папка игры, и задаются они в самом лаунчере, а не в %APPDATA%\.minecraft. Пока вы правите настройки официального лаунчера, у вашего ничего не меняется.

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

Окно игры не появилось, лаунчер вернулся в меню — Exit Code: 1

В логе это выглядит как «Incompatible mods found!» на Fabric (Фабрик) или «Missing or unsupported mandatory dependencies» на NeoForge и Forge (Фордж). Игра не успела начать загрузку: загрузчик прочитал папку mods, не сошёлся с её содержимым и закрылся. Причина обычно одна из трёх: мод собран под другой загрузчик, под другую версию игры или ему не хватает зависимости. Проверяйте пять пунктов по порядку, от частого к редкому.

1. Мод собран под другой загрузчик. Моды Forge и NeoForge не взаимозаменяемы, хотя NeoForge и вырос из Forge: файл для одного в папке другого роняет запуск. Список загрузчиков у каждого мода свой:

   Мод	Под какими загрузчиками существует
   Fabric API	Fabric
   Mod Menu	Fabric, Quilt
   Sodium	Fabric, NeoForge, Quilt

   Файл под чужой загрузчик просто уберите из mods: на Forge и NeoForge Fabric API не нужен, а список модов там встроен в игру.
2. Моду не хватает зависимости. В логе будет строка вида «requires any version of fabric-api, which is missing!». Fabric API — обязательная библиотека для большинства модов на Fabric: сама она в игру ничего не добавляет, но без неё моды не стартуют, поэтому её ставят первой. Такие же связки есть и дальше: Iris Shaders не работает без Sodium, Mod Menu — без Fabric API. Зависимость ставьте под ту же версию игры, что и сам мод.
3. Мод не для вашей версии игры. Строка в логе: «requires version 1.21.1 of minecraft, but only 1.21.4 is present!». Список поддерживаемых версий у каждого мода свой и не бесконечен: Indium доходит только до 1.21.1 — на 1.21.4 его нет. Сверяйтесь с таблицей версий на карточке мода, а не с номером в имени файла: имя пишет автор, таблицу собирает каталог.
4. Загрузчик не под вашу версию игры. NeoForge — основной загрузчик для 1.20.2 и новее, Forge держит огромный запас модов под 1.12.2–1.20.1, Fabric обновляется под новую версию игры быстрее остальных. Установщики берите на официальных сайтах: Fabric, NeoForge, Forge.
5. Версия Forge не та. Под одну версию игры бывает несколько версий Forge, и мод может требовать конкретную. Точные номера в каталоге не хранятся: на странице загрузки Forge и NeoForge есть отметка recommended — берите её.

Майнкрафт вылетает с модами сразу после логотипа Mojang — «The game crashed whilst initializing game»

Эта строка стоит первой в отчёте из .minecraft/crash-reports. Читается она так: загрузчик мод принял, версия и зависимости сошлись, а упало уже внутри игры. Значит, ищите конфликт: два мода правят один и тот же код и мешают друг другу.

Начните с трёх известных пар:

• Sodium (Содиум) и OptiFine (Оптифайн). Sodium — переписанный движок отрисовки, он ставится вместо OptiFine и вместе с ним не работает. Оставьте один файл.
• Sodium и Not Enough Crashes. В каталоге пара помечена как несовместимая: Not Enough Crashes стоит в конфликтах Sodium. Чем именно они сталкиваются, в карточке не сказано — держите в папке mods один файл из двух.
• Iris Shaders без Sodium. Iris — это то, чем в мире Fabric заменили шейдерную часть OptiFine, и работает он только в связке с Sodium.

Если пара не ваша, виновника подскажет сам отчёт. По умолчанию в трассировке падения — списке вызовов, который игра пишет в момент вылета, — виден только ванильный класс игры, и моды приходится перебирать вслепую. MixinTrace дописывает в отчёт, какие моды вмешивались в упавший код. Сам он ничего не чинит, а только называет подозреваемых; есть он для Fabric и Quilt, самая новая версия в каталоге — 1.21.1.

Нашли мод — уберите его файл из .minecraft/mods и запустите игру. Стартовала — ищите замену или ждите обновления от автора: чужой мод чинится только на его стороне.

Игра запустилась, но вылетает при входе в мир — «java.lang.OutOfMemoryError: Java heap space»

Эта строка в отчёте означает, что игре не хватило оперативной памяти. Главное меню держится на малом, вся нагрузка приходит вместе с миром: генерация, мобы, предметы всех модов сразу. Поэтому симптом выглядит обманчиво — «запускается, но вылетает мир».

Лаунчер по умолчанию выдаёт игре 2 ГБ — столько нужно ванильной. Сколько добавить под моды, точной цифрой не скажет никто: она зависит от набора, а не от их количества. Порядок действий такой: добавьте гигабайт в параметре -Xmx в настройках профиля лаунчера (например, -Xmx3G), зайдите в мир, посмотрите лог. Строка осталась — добавьте ещё гигабайт. Верхняя граница жёсткая: больше половины физической памяти компьютера отдавать нельзя, остальное нужно системе, иначе вылетать начнёт уже она.

Мир не загружается после того, как вы убрали мод

Отдельный случай: игра запускается, меню работает, а конкретный мир падает при загрузке — и OutOfMemoryError в отчёте нет. Так бывает после того, как из набора убрали мод. Мир помнит блоки, предметы и мобов, которых в игре больше нет, и спотыкается о них при загрузке чанка, где они лежали.

Лечится возвратом: положите файл мода обратно в .minecraft/mods, зайдите в мир, разберите его постройки и вывезите вещи из его сундуков — и только потом убирайте мод насовсем. Сохранения лежат в .minecraft/saves, каждый мир отдельной папкой: копируйте папку до того, как менять список модов, а не после. Копия — единственное, что возвращает мир, если убранный мод больше не выходит под вашу версию игры.

Не запускается сервер Майнкрафт

Проверьте, не лежат ли в его папке mods клиентские моды: Sodium и Iris Shaders работают только на стороне игрока, серверу они не подходят. Бывает и обратное: AttributeFix нужен и на клиенте, и на сервере, причём одинаковый с обеих сторон.

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

Остаётся метод половинного деления. Он находит виновника всегда, но требует нескольких запусков.

1. Скопируйте папку .minecraft/mods в другое место целиком.
2. Уберите из неё половину файлов и запустите игру.
3. Запустилась — виновник в убранной половине; не запустилась — в оставшейся. Зависимости держите рядом с их модами, иначе поймаете чужую ошибку вместо своей.
4. Подозрительную половину делите пополам и повторяйте, пока не останется один файл.

Набор из 30 модов разберёте за пять запусков, из сотни — за семь.

Когда пойдёте за помощью на форум или в чат своего набора модов, приложите сразу: версию игры, загрузчик и его версию, название лаунчера, файл latest.log целиком и последний файл из .minecraft/crash-reports. Снимок экрана с окном ошибки лог не заменяет — в нём нет строки, с которой всё началось.

Собираете набор модов заново — начните с чистого профиля: сначала загрузчик, потом моды по десятку с проверкой запуска. Порядок действий разобран в статье Как установить моды, а разница между Fabric, Forge и NeoForge — в статье Какой загрузчик выбрать.

Шпаргалка:

• Не открылось окно лаунчера — снимите javaw в диспетчере задач.
• Не открылось окно игры — latest.log.
• Вылетело после логотипа Mojang — crash-reports.
• Вылетел мир — память, параметр -Xmx.
• Не помогло — режьте mods пополам.
• Идёте за помощью — несите лог, а не снимок экрана.

Кому не подойдёт

Статья не поможет, если игра не стартует и без модов: тогда причина в самой игре, Java или лаунчере, а не в папке mods — что проверять, разобрано в разделе «Не запускается лаунчер Майнкрафт — что делать». Не поможет она и владельцам Bedrock — версии для телефонов, консолей и из Microsoft Store. Загрузчики модов существуют только в Java Edition для ПК; в Bedrock вместо модов аддоны и паки поведения из внутриигрового магазина, и обычные моды туда не ставятся. Разбор идёт по симптомам, а не по названиям модов: если у вас набор на сотню файлов, готовьтесь к нескольким запускам вместо одного точного совета.

Читайте также

Смотрите также

Случайные находки из каталога — моды, шейдеры, текстуры и сборки с нашим разбором.

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

Помогает ли переустановка Майнкрафта?

Нет, если дело в модах. Переустановка ставит заново саму игру, а папку .minecraft она не трогает: mods, saves и конфиги остаются на месте, и ошибка возвращается на первом же запуске. Смысл есть только тогда, когда не запускается и ванильный профиль без единого мода.

Игра перестала запускаться после обновления версии — почему?

Моды не переносятся между версиями сами. Профиль обновился, а файлы в .minecraft/mods остались от прежней версии, и загрузчик их отвергает. Заведите отдельный профиль под каждую версию игры и держите для него свою папку модов; на карточке каждого мода есть таблица версий, по ней и подбирайте файлы.

Файл latest.log пустой или его нет — где тогда искать причину?

Пустой файл означает, что игра до запуска не дошла: писать в лог ещё некому. Проверьте, ту ли папку вы открыли. У Prism Launcher, ATLauncher и Modrinth App папка своя на каждый набор модов, и latest.log лежит в ней, а не в общей .minecraft; у сторонних лаунчеров путь задаётся в их настройках.

Разбор работает на сторонних сборках вроде TLauncher?

Симптомы и файлы те же: mods, logs и crash-reports лежат в папке игры, меняется только путь к ней — его задаёт сам лаунчер в настройках, и это не всегда %APPDATA%\.minecraft. Ставить такой лаунчер мы не советуем и ссылок на него не даём; если он у вас уже стоит, начните с того, что найдите в настройках его папку игры.

Вылетает только на сервере, в одиночной игре всё работает — куда смотреть?

В свой .minecraft/crash-reports: со стороны игрока видна только клиентская половина падения. Сверьте список модов с тем, что требует сервер: моды, которые он проверяет у игрока, должны стоять у вас той же версии, а клиентские — Sodium и Iris Shaders — на сервере не работают и в его папку mods не кладутся.