Платформы
Моды Fabric
Моды Fabric в Codexe: что указать в запросе, версии Minecraft и загрузчика, как работает сборка Gradle/Loom (Java 21 для целей 1.20.1), миксины и частые проблемы.
Обновлено
Fabric — лёгкий загрузчик модов, который обычно быстро получает поддержку новых версий Minecraft. Codexe создаёт полноценный проект Gradle с плагином Fabric Loom.
#Что указать в запросе
- Версия Minecraft: «Fabric для 1.20.1», «1.21.1». Если версия не указана, используется 1.20.1.
- Что добавляет мод: блоки, предметы, сущности, команды, привязки клавиш, элементы HUD. Точно описывайте поведение.
- Клиент или сервер: скажите, только ли это клиентский мод (HUD, привязки клавиш), только серверный или и то и другое.
- Зависимости: Fabric API включён. Назовите остальные (Cloth Config, Mod Menu…).
A Fabric mod for 1.21.1: a "Magnet" item that pulls nearby dropped items to the player within 8 blocks while held in the offhand. Toggle with a keybind (default M). Crafting: iron ingots around a redstone block. English lang file and item model.#Что создаёт Codexe
build.gradle,gradle.properties(версии Minecraft, Yarn, загрузчика и Fabric API) иsettings.gradle.fabric.mod.jsonс точками входа, разделёнными по окружению (main,client).- Конфигурацию и классы миксинов, если они нужны для функции.
- Ресурсы: языковые файлы, модели, текстуры-заглушки.
#Как работает сборка
- Codexe фиксирует стабильный релиз Loom (старые версии
-SNAPSHOTисчезают из репозитория Fabric и ломают сборки). - Если запрошенной версии загрузчика, Yarn или Fabric API не существует, Codexe заменяет её реальной для этой версии Minecraft.
- Loom нужна среда выполнения Java 21, чтобы запустить Gradle. Для мода под 1.20.1 (который рассчитан на Java 17) Codexe запускает Gradle на Java 21, но ваш мод всё равно компилируется под Java 17. JAR работает на сервере с Java 17.
Первая сборка мода занимает больше времени (часто несколько минут): Loom скачивает Minecraft и маппинги. Сборка мода останавливается через 10 минут.
#Проверка
Мод компилируется, прежде чем стать готовым, и JAR должен содержать fabric.mod.json (или quilt.mod.json). Компиляция доказывает, что мод собирается, а не что он работает без вылетов, поэтому протестируйте его в клиенте.
#Частые проблемы
| Симптом | Вероятная причина |
|---|---|
| Вылет на выделенном сервере с упоминанием клиентских классов | Клиентский код в точке входа main. Попросите чат перенести его в точку входа client. |
| «Incompatible mods found», неверная версия Minecraft | Мод рассчитан на другую версию Minecraft, чем ваша игра. Укажите точную версию. |
| Fabric API отсутствует во время работы | Установите Fabric API в mods/ рядом с модом. |