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

Покрокова інструкція зі створення нового проєкту мода за допомогою генератора шаблонів модів Fabric.

WARNING

Ця сторінка написана для версії 1.21.11. Документація для старіших версій може бути неповною.

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/, щоб відповідати версіям, на які ви хочете націлити.

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