Вступ у Fabric та створення модів
Короткий вступ до Fabric і створення модів у Minecraft: Java Edition.
WARNING
Ця сторінка написана для версії 1.21.10. Документація для старіших версій може бути неповною.
Передумови
Перш ніж почати, ви повинні мати базове уявлення про розробку на Java та розуміння об’єктноорієнтованого програмування (ООП).
Якщо ви не знайомі з цими поняттями, ви можете ознайомитися з деякими підручниками з Java та ООП, перш ніж почати створення модів. Ось деякі з ресурсів, які ви можете використовувати для вивчення Java та ООП:
Термінологія
Перш ніж ми почнемо, розгляньмо деякі терміни, які ви зустрінете під час створення модів за допомогою Fabric:
- Мод: модифікація гри, додавання нових функцій або зміна існуючих.
- завантадувач модів: інструмент, який завантажує моди в гру, наприклад Fabric Loader.
- Mixin: інструмент для модифікації коду гри під час виконання – див. знайомство з міксинами для отримання додаткової інформації.
- Gradle: інструмент автоматизації збірки, який використовується для створення та компіляції модів, використовується Fabric для створення модів.
- Мапування: набір мапування, які мапують обфусцований код у зрозумілий людині код.
- Обфускація: процес створення коду складним для розуміння, який використовується Mojang для захисту коду Minecraft.
- Перемапування: процес мапування заплутаного коду в код, зрозумілий людині.
Що таке Fabric?
Fabric — це легкий набір інструментів модифікації для Minecraft: Java Edition.
Він розроблений як проста та зручна у використанні платформа для створення модів. Fabric — це проєкт, керований спільнотою, і він має відкритий вихідний код, що означає, що кожен може зробити свій внесок у проєкт.
Ви повинні знати про чотири основні компоненти Fabric:
- Fabric Loader: гнучкий незалежний від платформи завантажувач модів, розроблений для Minecraft та інших ігор і програм.
- Fabric Loom: плаґін Gradle, який дозволяє розробникам легко розробляти та налагоджувати моди.
- Fabric API: набір API та інструментів, які розробники модів використовують під час створення модів.
- Yarn: набір відкритого мапування Minecraft, безплатний для всіх за ліцензією Creative Commons Zero.
Чому Fabric необхідний для модифікації Minecraft?
Модифікація — це процес модифікації гри з метою зміни її поведінки або додавання нових функцій — у випадку з Minecraft це може бути що завгодно: від додавання нових предметів, блоків або сутностей до зміни механіки гри або додавання нових режимів гри.
Minecraft: Java Edition обфускований Mojang, що ускладнює модифікацію. Однак за допомогою таких інструментів модифікації, як Fabric, модифікувати стає набагато легше. Існує кілька систем мапування, які можуть допомогти в цьому процесі.
Loom перетворює обфусцований код у формат, зрозумілий людині, використання мапування, полегшує розробникам модів розуміння та змінення коду гри. Yarn є популярним і чудовим вибором мапування для цього, але існують і інші варіанти. Кожен проєкт мапування може мати свої сильні сторони або напрямок.
Loom дозволяє легко розробляти та компілювати моди на основі перемапованого коду, а Fabric Loader дозволяє завантажувати ці моди в гру.
Що надає Fabric API та навіщо він потрібен?
Fabric API — це набір API та інструментів, які розробники модів використовують під час створення модів.
Fabric API надає широкий набір API, які створюються на основі існуючої функціональності Minecraft - наприклад, надають нові хуки та події для використання розробниками модів, або надають нові утиліти та інструменти, щоб полегшити модифікацію - такі як розширювачі транзитивного доступу та можливість отримати доступ до внутрішніх реєстрів, таких як реєстр компостованих предметів.
Попри те, що Fabric API пропонує потужні функції, деякі завдання, як-от базова реєстрація блоків, можна виконати без нього за допомогою ванілльних API.