Fabric API — библиотека, от которой зависят многие моды для Minecraft: Java Edition. Она сама по себе не добавляет предметы, биомы или новых мобов. Библиотека предоставляет совместимые программные интерфейсы, события и механизмы регистрации, которые используют другие моды. Fabric API и Fabric Loader — разные компоненты: Loader загружает моды, API предоставляет им общие возможности.
В карточке Fabric API на BlockRadar есть ссылка на официальный источник, статистика и история версий. Ниже — порядок установки и разбор ошибок. Руководство не относится к Minecraft Bedrock Edition и не заменяет инструкции конкретного модпака.
Как выбрать совместимую версию Fabric API
Сначала проверьте точную версию Minecraft Java Edition в лаунчере. На странице версий Fabric API выберите этот же выпуск игры и загрузчик Fabric. У API собственный номер релиза: например, часть после знака «+» в имени файла часто указывает версию Minecraft. У Fabric Loader — отдельный номер версии; сравнивать номера API и Loader между собой не нужно.
Если вы устанавливаете несколько модов, сверяйте требования каждого. Мод может требовать минимальную версию API, а другой — определённый выпуск игры. Для разных версий Minecraft используйте отдельные профили или папки сборок. Не используйте случайный «самый новый» файл API: он может относиться к другому выпуску Minecraft.
Шаг 1. Установите Fabric Loader
- Запустите Minecraft Java Edition хотя бы один раз для нужной версии игры и закройте её.
- Получите установщик с официального сайта FabricMC. Для стандартного Minecraft Launcher выберите клиентскую установку.
- В установщике выберите ту же версию Minecraft, что будет использоваться в модпаке. Обычно подходит рекомендованная версия Loader.
- Нажмите Install и проверьте, что в Minecraft Launcher появился профиль Fabric. Запустите его один раз и закройте игру.
В сторонних лаунчерах Fabric Loader может устанавливаться через меню создания экземпляра. В таком случае отдельный установщик не требуется, но API всё равно может понадобиться как самостоятельный мод.
Шаг 2. Скачайте Fabric API и поместите JAR в mods
На странице Fabric API в каталоге BlockRadar откройте официальную загрузку Modrinth, выберите версию игры и скачайте файл .jar. Не распаковывайте JAR и не переименовывайте его в ZIP. Поместите его в папку mods именно того игрового профиля, который запускается с Fabric Loader.
- Windows:
%appdata%\.minecraft\mods. Вставьте путь в строку «Выполнить» (Win + R) или проводника. - macOS:
~/Library/Application Support/minecraft/mods. В Finder используйте «Переход → Переход к папке». - Linux:
~/.minecraft/mods. Папка.minecraftможет быть скрытой.
Если папка mods отсутствует, создайте её. Если лаунчер использует собственный каталог экземпляра, ищите mods внутри него, а не в стандартной папке Minecraft. После копирования JAR запустите профиль Fabric и проверьте отсутствие ошибок. Сам Fabric API может не показывать отдельного меню: это нормально.
Установка Fabric API на Minecraft-сервер
На выделенном сервере сначала устанавливают серверный Fabric Loader подходящей версии. Затем помещают совместимый JAR Fabric API в папку mods сервера и перезапускают его. Если игровой мод требует Fabric API и на клиенте, и на сервере, проверьте наличие библиотеки с обеих сторон. Требования зависят от конкретного мода: не переносите весь клиентский набор модов на сервер автоматически.
Перед заменой версии игры и модов сохраните резервную копию мира, конфигурации и списка JAR-файлов. Проверьте Java, требуемую вашим выпуском Minecraft, и логи запуска. Для Fabric-сервера используйте официальную инструкцию FabricMC.
Fabric API не работает: частые ошибки
«Requires fabric-api» или «Missing dependency»
Мод сообщает об отсутствующей библиотеке либо о неподходящем её выпуске. Проверьте папку mods активного профиля, установленный Fabric Loader и требования указанного мода. Убедитесь, что скачали JAR Fabric API именно под вашу версию Minecraft.
«Incompatible mod set» после обновления
Сопоставьте версии Minecraft, Loader, API и всех модов. Удалите старый несовместимый JAR API из папки сборки перед установкой нового, чтобы не осталось двух копий. Обновляйте зависимые моды только до версий, которые поддерживают ваш выпуск игры.
Игра запускается без модов
Скорее всего, запущен обычный профиль Minecraft, а не Fabric, либо JAR лежит в папке другого экземпляра. Выберите профиль Fabric в лаунчере и перепроверьте путь к каталогу игры.
Сервер не запускается после добавления API
Посмотрите первые строки ошибки в логах: там может быть точная версия неподходящего мода, Loader или Java. Не заменяйте другие библиотеки наугад. Перед повторной попыткой восстановите резервную копию и проверьте соответствие версий.
Вопросы и ответы
Fabric API — это плагин или мод?
Это библиотечный мод для Minecraft Java в экосистеме Fabric. Он не является плагином для Paper, Spigot или Bukkit. Для большинства сценариев сначала нужен Fabric Loader.
Нужен ли Fabric API для Sodium, Iris и других модов?
Не для всех. Некоторые моды работают без Fabric API, а другие явно требуют его. Проверяйте зависимости именно выбранной версии каждого мода на странице разработчика. См. Sodium, Iris Shaders и Lithium в каталоге BlockRadar.
Можно ли установить Fabric API на Forge или NeoForge?
Обычный Fabric API предназначен для Fabric, а не для загрузчиков Forge и NeoForge. Не пытайтесь запускать JAR для Fabric в профиле другого загрузчика без отдельно подтверждённой совместимости.
Где скачать Fabric API безопасно?
Воспользуйтесь официальной карточкой Modrinth или страницей проекта на CurseForge. BlockRadar не переупаковывает JAR. Сверяйте имя разработчика и версию Minecraft, избегайте сомнительных зеркал и установщиков.
Читайте также: Fabric API — описание, релизы и скачивание, загрузчики модов Minecraft, библиотеки для модов.