Learn · guides
Как установить мод Fabric
Три шага для установки любого мода Fabric: Fabric Loader, Fabric API, затем JAR-файл мода. Полное руководство с устранением неполадок.
Установка Fabric mod — это простой трехступенчатый процесс: убедитесь, что для вашей версии Minecraft установлен Fabric Loader, добавьте Fabric API в папку с модами, а затем поместите JAR-файл мода рядом с ней. Большинство проблем с установкой возникают из-за несовпадения версий, поэтому убедитесь, что все компоненты предназначены для одной и той же версии Minecraft.
Необходимые условия
Перед установкой мода:
- Установлен Fabric Loader для вашей версии Minecraft (см. Как установить Fabric Loader)
- Вы запустили профиль Fabric хотя бы один раз, чтобы папка с модами существовала
- Скачан JAR-файл мода.
Трехступенчатый процесс
Установлен загрузчик Fabric
Убедитесь, что вы установили и запустили Fabric Loader для вашей версии Minecraft. Если вы этого не сделали, сначала следуйте руководству по установке Fabric Loader.
Загрузите и добавьте Fabric API
Скачайте JAR-файл Fabric API, соответствующий вашей версии Minecraft. Поместите его в папку с модами. Большинство модов зависят от него.
Добавьте мод JAR
Скачайте JAR-файл мода и поместите его в ту же папку с модами, рядом с Fabric API. Не распаковывайте его — он должен оставаться в формате JAR.
Запустите Minecraft, используя профиль Fabric, и моды будут загружаться автоматически при запуске.
Папка с модами
Ваша папка с модами находится по следующему пути:
| ОС | Путь |
|---|---|
| Windows | %appdata%\.minecraft\mods |
| macOS | ~/Library/Application Support/minecraft/mods |
| Linux | ~/.minecraft/mods |
Если папка не существует, запустите профиль Fabric один раз, и она будет создана для вас.
Fabric API: зачем он нужен
Большинство модов для Fabric зависят от Fabric API — общей библиотеки, предоставляющей общие утилиты для моддеров. Установка Fabric API в первую очередь предотвращает сбои из-за отсутствующих библиотек. Даже если конкретный мод утверждает, что ему не нужен API, его добавление не повредит и позволит избежать сюрпризов.
Что делать, если мод не загружается
- Мод не появляется в списке модов: JAR-файл находится не в той папке, или вы запустили ванильную версию вместо Fabric. Проверьте путь и профиль.
- Авария с ошибкой "отсутствует класс": отсутствует или установлена неверная версия Fabric API. Загрузите правильную версию API для вашей версии Minecraft.
- Ошибка несовпадения версий в логах: загрузчик, API или мод нацелены на разные версии Minecraft. Все три должны совпадать точно (например, 1.21, а не 1.21.1, если мод предназначен для 1.21).
- Мод загружается, но вылетает при использовании: возможно, он конфликтует с другим модом или настройкой. Попробуйте запустить игру только с этим модом, чтобы изолировать проблему.
Сопоставление версий
Это самая распространенная проблема. Каждый мод должен быть предназначен для одной и той же версии:
Minecraft version: 1.21
Fabric loader version: 1.21 ✓
Fabric API version: 1.21 ✓
Mod version: 1.21 ✓
All match → no crash
Если у вас Minecraft версии 1.21, а мод предназначен для 1.20.1, он не загрузится. Проверьте страницу загрузки мода, чтобы узнать точную версию, которую он поддерживает.
Запуск нескольких модов
Как только один мод заработал, добавление новых — это просто:
- Скачайте каждый мод в формате JAR
- Поместите их все в папку mods
- Запустите Fabric
- Все моды загружаются вместе (при отсутствии конфликтов)
Некоторые моды конфликтуют друг с другом. Если после добавления нового мода происходят сбои, отключите его, чтобы убедиться, что именно он является причиной, а затем проверьте, документирует ли автор мода этот конфликт.
Часто задаваемые вопросы
Большинство модов для Fabric зависят от него, поэтому устанавливайте его по умолчанию. Несколько редких автономных модов не требуют его, но добавление не вызывает проблем и решает большинство сбоев, связанных с "отсутствующим классом".
Обычно проблема в несовпадении версий. Убедитесь, что Fabric Loader, Fabric API и ваш мод предназначены для абсолютно одной и той же версии Minecraft. Проверьте страницу загрузки мода для информации о версии.
В папке "mods" внутри вашей директории Minecraft (пути указаны выше). Если папка не существует, запустите профиль Fabric один раз, и она будет создана.
Да. Поместите каждый JAR-файл в папку mods и запустите Fabric. Если они предназначены для вашей версии Minecraft и не конфликтуют, загрузчик запустит их все.