Инструкция относится к Minecraft Java Edition, а не Bedrock.
Loader, API и Installer: кто за что отвечает
Fabric Loader — загрузчик. При запуске игры он обнаруживает Fabric-моды, проверяет их требования и загружает. Сам по себе Loader не добавляет биомы, мини-карту или новые предметы: для этого нужны выбранные модификации.
Fabric API — библиотека общих функций для модов. Разработчики используют её возможности, чтобы не писать часть вспомогательного кода заново. Для игрока это обычный файл .jar, который лежит в mods. Видимого нового контента от одной установки API ждать не нужно.
Есть ещё Fabric Installer. Вот это уже установщик: он помогает установить Loader и создать профиль запуска. Его не надо закидывать в mods. Файлы легко перепутать.
| Компонент | Задача | Как устанавливать |
|---|---|---|
| Fabric Loader | Загружает Fabric-моды | Через Installer или настройки сборки в лаунчере |
| Fabric API | Даёт модам общие функции | Поместить подходящий .jar в mods |
| Fabric Installer | Устанавливает Loader | Запустить отдельно от игры |
ИЗОБРАЖЕНИЕ-1
Обязательно ли ставить оба?
Loader нужен для запуска Fabric-модов. API требуется тогда, когда его использует хотя бы один мод из сборки. Некоторые модификации обходятся без него, поэтому правило «без API Fabric вообще не работает» неверно.
Открой раздел зависимостей выбранного мода. Если там указан Fabric API, добавь его. Также могут потребоваться другие библиотеки — API не заменяет их все разом. В готовом модпаке компоненты часто уже установлены.
На официальной странице Fabric отдельно сказано, что большинству модов нужен API в папке mods. Сам Loader и библиотека при этом остаются разными компонентами.
Как подобрать версии и не запутаться
Сначала выбери версию Minecraft, под которую собираешь моды. Затем проверь, что конкретные выпуски модификаций и API её поддерживают. Ориентируйся на сведения о файле, а не на количество скачиваний или крупную кнопку «Последняя версия».
У Minecraft, Loader и API своя нумерация. Не нужно искать три одинаковых числа. Например, 1.21.1 в названии профиля относится к игре; номер Loader указан отдельно. Список поддерживаемых версий указывает автор мода.
Тип загрузчика тоже важен. Для этой сборки скачивай Fabric-варианты модов. Forge и NeoForge не становятся совместимыми с Fabric от установки API. Если нужны разные сборки, удобнее держать их в отдельных игровых каталогах.
Шаг 1. Установи Fabric Loader
Следующие действия рассчитаны на официальный Minecraft Launcher. В лаунчерах с управлением экземплярами Fabric часто добавляется прямо в настройках сборки.
- Установи нужную версию Minecraft и один раз запусти её без модов. Затем закрой игру и лаунчер.
- Скачай Fabric Installer с официального сайта. Для Windows доступен вариант .exe; универсальный .jar запускается через подходящую Java.
- Открой установщик и выбери вкладку Client. Укажи версию Minecraft и версию Loader, удовлетворяющую требованиям модов.
- Проверь каталог установки и оставь включённым Create Profile. Нажми Install.
- После завершения открой лаунчер и найди созданный профиль Fabric.
Не меняй версию игры только потому, что вышел новый Loader. Это разные настройки. Названия полей и порядок установки можно сверить с инструкцией Fabric для Windows.
Шаг 2. Добавь Fabric API и моды
Перейди к Fabric API по ссылке с официального сайта Fabric. На странице файлов выбери выпуск для своей версии Minecraft, скачай .jar и открой игровой каталог профиля. В официальном лаунчере это можно сделать из раздела «Установки» через значок папки.
Найди mods. Если её нет, создай папку с таким названием. Перенеси туда API и Fabric-моды с обязательными зависимостями. Распаковывать .jar или запускать API двойным щелчком не требуется.
Для стандартного каталога Windows путь выглядит так:
%appdata%\.minecraft\mods
Но если у профиля отдельный каталог, используй именно его. Иначе получится знакомая история: файлы лежат, а игра их не видит. Перед заменой версии библиотеки убери предыдущий файл из mods; резервную копию можно сохранить отдельно. Подробности есть в руководстве по установке модов.
Шаг 3. Запусти нужный профиль
В лаунчере выбери Fabric-профиль для своей версии Minecraft и нажми «Играть». Запуск обычного профиля без Loader не проверяет установку Fabric — даже если моды уже лежат в папке.
Кнопка «Моды» не обязана появиться. Для привычного списка модификаций у Fabric часто используют отдельный мод Mod Menu. Сам API не добавляет такое меню, поэтому его отсутствие не повод переустанавливать сборку. Проверь работу установленного мода; при необходимости посмотри журнал logs/latest.log.
Если игра просит Fabric, хотя он установлен
Прочитай точное название в сообщении. Требование fabric-api относится к библиотеке в mods, а fabricloader — к загрузчику. Причиной бывает не только отсутствие компонента, но и неподходящая версия. Добавлять ещё одну копию того же файла бессмысленно.
При Incompatible mods found! проверь указанную зависимость, поддерживаемую версию игры и папку запускаемого профиля. Если сообщение требует Java, проверь Java, выбранную в настройках этого профиля. Все файлы должны соответствовать требованиям одной сборки — универсального «скачай самый новый Fabric и забудь» здесь нет.
Давайте общаться
Помогите нам сделать сайт лучше
Мы очень стараемся сделать сайт удобнее и полезнее, поэтому нам важно ваше мнение. Поделитесь впечатлениями, идеей или советом – каждый комментарий помогает нам стать лучше.