Моды не загружаются Майнкрафт — что делать

Моды в Майнкрафте чаще всего не загружаются из-за неподходящей версии игры или загрузчика, отсутствующих библиотек либо файлов в папке другой сборки. Проверьте выбранный профиль и требования мода, затем откройте logs/latest.log: по сообщению об ошибке можно выбрать нужное исправление. Версии, загрузчики и зависимости для установки Dynamic Surroundings разобраны в отдельной инструкции.

Проверьте профиль, версию и папку mods

Закройте игру. Перед заменой или удалением модов сохраните копию папки своего мира из saves; проверять запуск лучше на отдельном тестовом мире.

1. Выберите профиль с загрузчиком. Обычный профиль Minecraft не загружает моды для Fabric, Forge или NeoForge. В настройках лаунчера, включая MineLauncher, проверьте, какую сборку вы запускаете и какая игровая папка ей назначена.
2. Сверьте версию игры. Для Java Edition 26.3 выбирайте файл, в списке поддерживаемых версий которого есть 26.3. В каталоге модов есть фильтры по версии и загрузчику. Моды для 1.12.2, 1.16.5 и 1.20.1 подбирают к соответствующему выпуску игры; внутри ветки 1.21.x совместимость тоже нужно проверять по полному номеру.
3. Сверьте загрузчик и его версию. Файл для Forge нельзя просто перенести в Fabric. Forge и NeoForge тоже не считайте взаимозаменяемыми: используйте вариант, указанный автором мода. Если ошибка требует более новую версию загрузчика, обновите его в пределах нужной версии Minecraft.
4. Откройте папку именно выбранной сборки. Поместите файл .jar непосредственно в её папку mods, без распаковки и вложенной папки с названием мода. Стандартный путь в Windows — %appdata%\.minecraft\mods, но у отдельной сборки он может быть другим. Если папки нет, создайте её в игровой папке профиля.
5. Установите обязательные зависимости. Это дополнительные библиотеки, перечисленные в требованиях мода. Fabric Loader и Fabric API — разные компоненты: API кладут в mods, если он требуется. Для Forge не нужно искать универсальный отдельный файл «Forge API»; установите сам Forge и конкретные библиотеки из требований мода.
6. Проверьте файлы и перезапустите игру. Уберите старую копию того же мода, оставив подходящий выпуск. Если файл скачался не полностью, загрузите его заново со страницы автора или проекта. Изменения в mods проверяйте после полного перезапуска Minecraft.

Проверьте тип дополнения: датапаки устанавливают в папку datapacks нужного мира, а архив сборки модов импортируют средствами совместимого лаунчера. Перенос любого скачанного архива в mods не заменяет установку.

Как понять причину по логу

Сразу после неудачного запуска откройте logs/latest.log в игровой папке сборки обычным текстовым редактором. Если появился отчёт о сбое, посмотрите свежий файл в crash-reports; для Forge и NeoForge также может пригодиться logs/debug.log. Если Майнкрафт завис на загрузке, воспользуйтесь отдельной инструкцией по диагностике зависания.

Ищите сообщения об остановке загрузки, названия модов и строки Caused by:. Читайте соседние строки: последнее упомянутое имя или отдельное предупреждение ещё не доказывает, какой мод виноват. Если в логе указана ConcurrentModificationException, проверьте её причины по отдельной инструкции.

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

Как найти конфликтующий мод

1. Создайте отдельную тестовую сборку с той же версией игры и загрузчика. Убедитесь, что она запускается без добавленных модов.
2. Добавьте проблемный мод и все его обязательные библиотеки. Если ошибка осталась, проверяйте его требования и лог; конфликт с остальными модами вашей сборки пока исключён.
3. Если мод работает отдельно, возвращайте остальные моды группами. Когда ошибка повторится, уберите половину последней добавленной группы и снова проверьте запуск. Сохраняйте обязательные зависимости для оставшихся модов.
4. Сужайте группу, пока не найдёте сочетание, вызывающее сбой. Проверьте совместимые выпуски этих модов или оставьте один из конфликтующих.

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

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

Если мод есть среди загруженных, отсутствие его построек ещё не означает сбой загрузки. Обычно структуры появляются при создании новых чанков — участков мира; уже созданная местность сама не перестраивается, если мод специально не поддерживает такую возможность.

1. Создайте новый тестовый мир с этим модом. Выберите обычный тип мира и включите генерацию структур. Некоторые моды используют собственные настройки генерации — проверьте их описание.
2. В старом мире ищите новую местность. Нужны чанки, которые раньше не генерировались. Участок мог быть создан заранее сервером, даже если вы туда ещё не ходили.
3. Проверьте биом и измерение. Модовая постройка может появляться только в определённых условиях и быть редкой. Отсутствие рядом с местом появления ничего не доказывает.
4. Проверьте настройки мода. Посмотрите, включена ли нужная структура, не изменена ли её частота и требуются ли дополнительные компоненты. После изменений перезапустите игру и проверяйте новую генерацию.
5. Сравните с минимальной сборкой. Создайте тестовый мир с этим модом и обязательными зависимостями. Если там постройки появляются, проверьте совместимость с другими модами и датапаками генерации мира.

В Java Edition 26.3 для структур, зарегистрированных в стандартной системе игры, используйте поиск /locate structure <идентификатор>. Подставьте настоящий идентификатор из документации мода или подсказок по Tab; нужны разрешённые команды. Не все модовые постройки доступны этому поиску, а сообщение «не найдено» само по себе не доказывает, что мод не загрузился.

В старых Java 1.12.2 и 1.16.5 синтаксис поиска другой: /locate <тип>. Для конкретной модовой постройки сверяйтесь с инструкцией к её выпуску.

Если моды не работают в Bedrock

Моды Java в формате .jar не устанавливаются в Bedrock через Forge или Fabric. Для Bedrock нужны совместимые дополнения, например в формате .mcaddon или .mcpack. После импорта откройте настройки нужного мира и активируйте входящие в дополнение наборы параметров и ресурсов. Экспериментальные функции включайте только тогда, когда этого требует автор дополнения.