Створення проєкту

Fabric надає простий спосіб створити новий проєкт мода за допомогою генератора шаблона мода Fabric — якщо ви хочете, ви можете вручну створити новий проєкт, використовуючи приклад сховища модів, вам слід звернутися до створення проєкту вручну розділ.

Генерація проєкту

Ви можете використати генератор шаблона мода Fabric, щоб створити новий проєкт для свого мода — вам слід заповнити обов’язкові поля, як-от назва мода, назва пакета, і версію Minecraft, для якої ви хочете розробляти.

Назва пакета повинно бути малим реєстром, розділеним крапками та унікальним, щоб уникнути конфліктів з пакетами інших програмістів. Зазвичай він форматується як зворотний інтернет-домен, наприклад com.example.example-mod.

ВАЖЛИВО

Обов’язково запам’ятайте ID свого мода! Щоразу, коли ви знайдете example-mod у цих документах, особливо в шляхах до файлів, вам доведеться замінити його на свій власний.

Наприклад, якщо ID вашого мода був my-cool-mod, замість resources/assets/example-mod використовуйте resources/assets/my-cool-mod.

Якщо ви хочете використовувати Kotlin, скрипти збірки Kotlin або хочете додати генератори даних, ви можете вибрати відповідні параметри в розділі Advanced Options.

INFO

У прикладах коду, наведених на цьому сайті, використовуються імена, наявні в деобфускованій грі. Якщо у вас є наявний мод, який використовує мапінги, відмінні від тих, які надає Mojang, будь ласка, перегляньте портування до 26.1, для подробиць.

Коли ви заповните необхідні поля, натисніть кнопку Generate, і генератор створить для вас новий проєкт у формі zip-файлу.

Вам слід розпакувати цей zip-файл у вибране вами місце, а потім відкрити розпаковану теку в середовищі IDE.

TIP

Вибираючи шлях до свого проєкту, слід дотримуватися таких правил:

• Уникайте каталогів хмарних сховищ (наприклад, Microsoft Onedrive)
• Уникайте не ASCII символів (наприклад, емодзі, літери з акцентами)
• Уникайте пробілів

Прикладом «хорошого» шляху може бути: C:\Projects\YourProjectName

Створення проєкту власноруч

ПЕРЕДУМОВИ

Вам знадобиться встановити Git, щоб клонувати приклад сховища модів.

Якщо ви не можете використовувати генератор шаблонів Fabric Mod Generator, ви можете створити новий проєкт вручну, виконавши ці дії.

По-перше, клонуйте приклад репозиторію модів за допомогою Git:

git clone https://github.com/FabricMC/fabric-example-mod.git example-mod

Це призведе до клонування репозиторію в нову теку під назвою example-mod.

Потім вам слід видалити теку .git із клонованого репозиторію, а потім відкрити проєкт. Якщо тека .git не показується, вам слід увімкнути показ прихованих файлів у вашому файловому менеджері.

Налаштування вашої IDE

Коли ви відкриєте проєкт в IDE, він має автоматично завантажити налаштування Gradle проєкту та виконати необхідні завдання налаштування.

Якщо ви отримали сповіщення про сценарій збирання Gradle, вам слід натиснути кнопку Import Gradle Project.

Для подробиць див. сторінку налаштування вашої IDE.

Змінення шаблону

Після того як проєкт буде імпортовано, ви повинні змінити деталі проєкту, щоб вони відповідали деталям вашого мода:

• Змініть файл gradle.properties проєкту, щоб змінити властивості maven_group і archive_base_name відповідно до деталей вашого мода.
• Змініть файл fabric.mod.json, щоб змінити властивості id, name і description відповідно до деталей вашого мода.
• Переконайтеся, що ви оновили версії Minecraft, мапінгів, Завантажувача і Loom — усе це можна отримати на сайті розробки — щоб відповідати версіям, які ви хочете націлити.

Ви можете змінити назву пакета та основний клас мода, щоб відповідати деталям вашого мода.