Learn · guides

Как установить мод Fabric

Три шага для установки любого мода Fabric: Fabric Loader, Fabric API, затем JAR-файл мода. Полное руководство с устранением неполадок.

TRtrolPublished 3 min read

Установка Fabric mod — это простой трехступенчатый процесс: убедитесь, что для вашей версии Minecraft установлен Fabric Loader, добавьте Fabric API в папку с модами, а затем поместите JAR-файл мода рядом с ней. Большинство проблем с установкой возникают из-за несовпадения версий, поэтому убедитесь, что все компоненты предназначены для одной и той же версии Minecraft.

Необходимые условия

Перед установкой мода:

  • Установлен Fabric Loader для вашей версии Minecraft (см. Как установить Fabric Loader)
  • Вы запустили профиль Fabric хотя бы один раз, чтобы папка с модами существовала
  • Скачан JAR-файл мода.

Трехступенчатый процесс

  1. Установлен загрузчик Fabric

    Убедитесь, что вы установили и запустили Fabric Loader для вашей версии Minecraft. Если вы этого не сделали, сначала следуйте руководству по установке Fabric Loader.

  2. Загрузите и добавьте Fabric API

    Скачайте JAR-файл Fabric API, соответствующий вашей версии Minecraft. Поместите его в папку с модами. Большинство модов зависят от него.

  3. Добавьте мод 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, он не загрузится. Проверьте страницу загрузки мода, чтобы узнать точную версию, которую он поддерживает.

Запуск нескольких модов

Как только один мод заработал, добавление новых — это просто:

  1. Скачайте каждый мод в формате JAR
  2. Поместите их все в папку mods
  3. Запустите Fabric
  4. Все моды загружаются вместе (при отсутствии конфликтов)

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

Часто задаваемые вопросы