Прежде чем искать
- Вспомните, что менялось последним: добавили мод, обновили моды, обновилась игра. В половине случаев виноват последний добавленный мод — отключите его первым.
- Проверьте, запускается ли игра вообще без модов. Если нет — дело не в модах: проверьте целостность файлов игры.
- Убедитесь, что установлены все зависимости. Мод без нужной библиотеки — самая частая причина ошибок при запуске.
Способ 1. Читаем лог
| Игра и загрузчик | Файл | Где лежит |
|---|---|---|
| Игры на BepInEx | LogOutput.log | Папка BepInEx. В менеджере модов — внутри папки профиля (r2modman: Settings → Browse profile folder) |
| Игры на MelonLoader | Latest.log | Папка MelonLoader в папке игры или профиля |
| Minecraft | latest.log | Папка logs в папке игры или сборки |
| Minecraft, при вылете | crash-дата-client.txt | Папка crash-reports там же |
| Любая игра на Unity | Player.log | %USERPROFILE%\AppData\LocalLow\<разработчик>\<игра> |
Лог перезаписывается при каждом запуске, поэтому открывайте его сразу после вылета, не запуская игру повторно. Это обычный текст — подойдёт Блокнот.
- Откройте файл и нажмите Ctrl+F.
- Ищите слова
Error,Exception,Fatal. В BepInEx строки начинаются с пометки уровня и названия мода в квадратных скобках — например,[Error : ИмяМода]. - Смотрите не на последнюю ошибку, а на первую: следующие часто лишь её следствие.
- Обратите внимание на строки о зависимостях: загрузчик прямо пишет, что такому-то моду не хватает такой-то библиотеки или нужна её другая версия.
- В отчёте о вылете Minecraft найдите в начале строку с описанием ошибки, а ниже — список модов; в стеке вызовов ищите знакомые названия модов. Свежие версии Fabric и NeoForge часто сами указывают подозреваемые моды.
- Отключите названный мод и проверьте запуск.
Одинокие предупреждения (Warning) и даже отдельные ошибки в логе — нормальное явление: многие моды пишут их при штатной работе. Искать нужно ошибку, после которой загрузка обрывается, или ту, что повторяется сотни раз.
Способ 2. Метод половин
Работает всегда, не требует ничего понимать в логах. Идея — как в игре «угадай число»: каждым шагом отсекается половина подозреваемых.
- Отключите половину модов. Библиотеки и загрузчик не трогайте: без них не запустятся и рабочие моды.
- Запустите игру и повторите действие, которое приводило к вылету.
- Если проблема исчезла — виновник в отключённой половине. Если осталась — во включённой.
- Верните «невиновную» половину в исходное состояние, а «подозрительную» снова разделите пополам.
- Повторяйте, пока не останется один мод. Для 30 модов хватит пяти запусков, для 100 — семи.
- Проверьте вывод: включите всё, кроме найденного мода. Если игра работает — виновник найден.
Как отключать: в r2modman и Gale — переключателями в списке установленных модов (мод остаётся в профиле); в играх с Мастерской — отметками в меню модов; в Minecraft — галочками в списке модов лаунчера или временно перенеся файлы из mods в соседнюю папку.
Если виноваты два мода сразу
Иногда каждый мод по отдельности работает, а вместе они конфликтуют. Признак: метод половин приводит к моду, без которого проблема исчезает, но и с ним одним всё работает. Тогда оставьте найденный мод включённым и повторите метод половин среди остальных — найдёте второго участника конфликта. Дальше выбирайте, какой из двух вам нужнее, или ищите в описаниях пометки о совместимости.
Что делать с найденным модом
- Обновить: возможно, ошибка уже исправлена.
- Откатить на предыдущую версию, если проблема появилась после обновления.
- Проверить версию игры, под которую сделан мод, и дату его обновления.
- Прочитать комментарии и раздел проблем на странице мода — скорее всего, вы не первый.
- Сообщить автору: приложите лог и список модов. Без лога автор помочь не сможет.
- Если мод заброшен — поискать его замену или ответвление.
Когда дело не в конкретном моде
- Не хватает памяти. В Minecraft это ошибка
OutOfMemoryError— см. сколько памяти выделить. - Игра обновилась. Сломалось всё разом сразу после патча — см. как обновить моды после патча.
- Испорчены настройки мода. Удалите файл конфигурации мода — он создастся заново со значениями по умолчанию.
- Испорчено сохранение. Проверьте на новом сохранении: если там всё работает, проблема в данных, а не в наборе модов.
Частые ошибки
В отключённую половину попала библиотека, нужная оставшимся модам. Включите библиотеки обратно и делите только обычные моды.
Загрузчик не запустился: игра стартует без модов. Проверьте установку загрузчика и способ запуска.
Метод половин всё равно работает, но каждый шаг дольше. Ищите в логе ошибку, которая повторяется много раз перед вылетом.
Найдите самую первую. Часто один сломанный мод-библиотека тянет за собой всех, кто от него зависит.
Проблемных модов может быть несколько. Повторите поиск с начала.

