Как настроить среду разработки Fabric

Настройка среды разработки Fabric состоит из четырех шагов: установка Java Development Kit, использование официального шаблона мода, настройка Yarn mappings и запуск Gradle. Плагин Fabric build plugin загружает Minecraft и настраивает всё остальное. Сопоставьте версии JDK и Minecraft в самом начале, и система сборки сделает всё остальное.

Что вам понадобится в первую очередь

Перед написанием кода:

• JDK, соответствующий вашей версии Minecraft. Более новые версии Minecraft требуют более новые JDK. Проверьте требования целевой версии перед установкой.
• IDE. IntelliJ IDEA Community (бесплатная) или Eclipse работают хорошо. Большинство разработчиков Fabric используют IntelliJ, поскольку интеграция с Gradle более плавная.
• Git. Вам потребуется клонировать шаблонный репозиторий и управлять своим кодом.

Устанавливать Gradle вам НЕ нужно. Шаблон включает в себя скрипт-обёртку, который загружает правильную версию при первом запуске.

Шаг за шагом

1. Установите JDK

   Загрузите JDK с Adoptium или Oracle, соответствующую вашей целевой версии Minecraft. Для Minecraft 1.21 установите Java 21. Укажите эту JDK в настройках вашей IDE.

2. Получите шаблон мода-примера

   Перейдите в официальный репозиторий примеров модов Fabric на GitHub и клонируйте его или используйте как шаблон. Переименуйте пакет и идентификатор мода на свои собственные.

3. Установите версии в gradle.properties

   Откройте файл gradle.properties и обновите три строки:

   • minecraft_version — целевая версия Minecraft (например, 1.21)
   • loader_version — версия Fabric Loader, соответствующая вашей сборке Minecraft
   • yarn_mappings — версия Yarn для вашей версии Minecraft

   Эти три значения должны совпадать, иначе проект не скомпилируется.

4. Откройте в вашей IDE и синхронизируйте

   Откройте папку проекта в вашей IDE. Дайте Gradle выполнить первоначальную синхронизацию (скачать зависимости, сгенерировать конфигурации запуска).

5. Сгенерировать декомпилированные исходники

   В панели Gradle вашей IDE запустите genSources. Это декомпилирует Minecraft с использованием имен Yarn, чтобы вы могли прочитать код игры.

6. Запустить тестового клиента

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

Вот и всё. Теперь у вас есть рабочая среда разработки Fabric.

Понимание gradle.properties

Этот файл настраивает всю вашу сборку. Три версии должны быть синхронизированы:

minecraft_version=1.21
loader_version=0.15.11
yarn_mappings=1.21+build.32

Если Minecraft — 1.21, а Yarn — 1.20.1, Gradle выдаст непонятное сообщение об ошибке. Всегда получайте соответствующие версии с fabricmc.net/use или из примера шаблона.

Что делает плагин сборки

Плагин Gradle для Fabric настроен в build.gradle и обрабатывает:

• Загрузку Minecraft
• Декомпиляцию с использованием выбранных вами соответствий (mappings)
• Пересопоставление вашего кода обратно в промежуточный формат для совместимости
• Генерацию конфигураций запуска IDE

Вы настраиваете его один раз; он автоматизирует всё остальное. Именно поэтому важен шаблон — он уже настроен правильно.

Объяснение соответствий (mappings)

Minecraft распространяется в обфусцированном виде (имена классов, такие как a, b, c). Соответствия (mappings) переводят их в читаемые имена.

• Yarn: По умолчанию используется Fabric. Включает документацию. Легко читается.
• Соответствия Mojang: Официальные, но менее документированные. Более obscure имена.

Шаблон использует Yarn. Когда вы запускаете genSources, Minecraft декомпилируется с использованием имен Yarn, чтобы вы могли читать фактический код. При компиляции Fabric пересопоставляет его обратно в промежуточный формат (стабильный слой под ним), чтобы мод работал на любой совместимой версии Minecraft.

Распространённые проблемы с настройкой

• ✓Синхронизация Gradle завершается неудачей сразу: проверьте файл gradle.properties. Версии Minecraft, загрузчика и Yarn должны совпадать. Используйте известную комбинацию с сайта Fabric.
• ✓Ошибка компилятора о версии Java: ваша JDK устарела для версии Minecraft. Установите более новую JDK и укажите на неё в вашей IDE.
• ✓Не удается прочитать исходный код Minecraft: запустите genSources в панели Gradle и перезагрузите. Первый запуск происходит медленно, так как он декомпилирует всю игру.
• ✓runClient ничего не делает: он ожидает завершения начальной синхронизации Gradle. Конфигурации запуска генерируются во время синхронизации.
• ✓IDE не импортирует проект: убедитесь, что в настройках IDE выбран JDK, а не JRE.

Следующие шаги после настройки

После того, как ваша среда заработала:

1. Удалите или переименуйте примеры классов модов
2. Создайте свой собственный пакет мода
3. Реализуйте простую функцию (блок, предмет или слушатель событий)
4. Запустите runClient и протестируйте в клиентской среде разработки
5. Повторяйте

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

Заметки для конкретных IDE

IntelliJ IDEA:

• Импортируйте как проект Gradle (а не просто папку)
• Дайте Gradle полностью синхронизироваться перед выполнением любой задачи
• Конфигурации запуска появляются в разделе "Gradle" в выпадающем списке запуска

Eclipse:

• Импортируйте как существующий проект Gradle
• Щелкните правой кнопкой мыши по проекту → Gradle → Обновить проект Gradle после синхронизации
• Задачи Gradle появляются в представлении "Задачи Gradle"

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