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 або мапінгів Fabric Yarn замість стандартних мапінгів Mojang або хочете додати генератори даних, ви можете вибрати відповідні параметри в розділі Advanced Options.

INFO

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

Коли ви заповните необхідні поля, натисніть кнопку 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/ example-mod

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

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

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

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

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

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

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

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