Платформи
Моди 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/ поруч із модом. |