Мод Minecraft не работает на Forge, Fabric или NeoForge

Файл в папке mods еще не означает, что мод заработал. Он должен подходить одновременно к версии Minecraft, загрузчику и стороне установки. Некоторым модам также нужны библиотеки или другие моды.

Что должно совпадать#

Перед установкой проверьте четыре пункта:

1. Версия Minecraft. Мод для 1.20.1 обычно не работает на 1.21.11.
2. Загрузчик. Forge, NeoForge и Fabric не взаимозаменяемы.
3. Версия загрузчика. Автор может требовать определенную сборку Forge, NeoForge или Fabric Loader.
4. Сторона установки. Серверный мод ставится на сервер, клиентский только в игру, а некоторые нужны с обеих сторон.

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

Правильная установка#

1. Остановите сервер.
2. Откройте папку mods.
3. Загрузите jar-файл без распаковки.
4. Установите перечисленные автором зависимости.
5. Запустите сервер и проверьте консоль.

При установке через каталог панели файл попадает в нужную папку автоматически. Каталог уменьшает вероятность ошибки, но не может гарантировать исправность самого мода или его поддержку новой версии Minecraft.

Как проверить, загрузился ли мод#

Во время запуска Forge, NeoForge или Fabric выводит список найденных модификаций. Ищите название или идентификатор мода в logs/latest.log.

Если мод упоминается только в сообщении проверки обновлений, это еще не доказывает, что вся его логика выполнилась без ошибок. Просмотрите следующие строки. Сообщения Failed to load, Exception или ошибки функций и конфигурации означают, что мод найден, но работает неправильно.

Мод предназначен для другого загрузчика#

Частые сообщения:

Mod file is not a valid mod file

Invalid mod file

Fabric mod cannot be loaded

Missing mods.toml

Удалите неподходящий файл и скачайте вариант именно для текущего загрузчика. Простое переименование jar-файла ничего не изменит.

Не хватает зависимости#

В консоли обычно указано название отсутствующего компонента:

Missing mandatory dependencies

Mod ... requires ...

Could not find required mod

Откройте страницу мода и раздел зависимостей. Установите нужную библиотеку в версии, подходящей к вашему Minecraft и загрузчику. Примеры распространенных зависимостей: Fabric API, Architectury API, Cloth Config и GeckoLib.

Не скачивайте первую найденную версию библиотеки. У нее действуют те же требования совместимости.

Версии клиента и сервера не совпадают#

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

Mismatched mod channel list

Incompatible mod set

Failed to synchronize registry data

Сравните не только названия, но и версии jar-файлов. Удобнее передавать игрокам готовый список или одну сборку, а не просить собирать моды самостоятельно.

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

Мод найден, но его функция не работает#

Так бывает, когда Minecraft изменил команды, формат данных или внутренний API, а файл мода еще не обновлен. В логе может быть видно название мода и отдельная ошибка после него.

Например, в Minecraft 1.21.11 игровые правила получили новые имена. Старое:

gamerule keepInventory true

Новое:

gamerule keep_inventory true

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

Сервер перестал запускаться после установки#

1. Остановите сервер.
2. Уберите последний добавленный jar-файл из mods.
3. Запустите сервер повторно.
4. Если запуск восстановился, проверьте версию и зависимости этого файла.
5. Если установлено сразу несколько модов, возвращайте их по одному.

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

Где искать точную причину#

Основной файл находится в logs/latest.log. Если сервер аварийно завершился, дополнительно проверьте папку crash-reports.

В отчете найдите:

• Caused by;
• Mod File;
• Failure message;
• Suspected Mods;
• название последнего установленного мода.

Техническая поддержка BazaHost проверяет работу панели, файловой системы и запуска сервера. Подбор, настройка и исправление сторонних модификаций выполняются по документации их разработчиков. Если после проверки остается ошибка панели или окружения сервера, приложите лог и напишите нам.