Architectury API: Огляд посередницької бібліотеки для крос-платформних модів у Minecraft

Створення модифікацій для кількох завантажувачів у Minecraft зазвичай змушує розробників писати та підтримувати окремі кодові бази для Fabric, Forge та NeoForge. Бібліотека Architectury API вирішує цю проблему, пропонуючи проміжний шар абстракції між кодом моду та специфічними API ігрових завантажувачів. Вона дозволяє розробникам створювати крос-платформні моди, де основна частина коду є спільною, а компіляція під різні середовища відбувається автоматично. Гравцям ця бібліотека необхідна як обов'язкова залежність для запуску десятків популярних доповнень.

Концепція та технічні переваги Architectury API

Головне завдання Architectury API полягає у мінімізації повторюваного коду під час розробки модів. Замість вивчення та використання окремих подій або систем реєстрації Fabric та Forge, автори використовують єдині класи-посередники.

Основні механізми, які пропонує бібліотека розробникам:

• Уніфікований реєстр: дозволяє реєструвати нові блоки, предмети, біоми чи сутності через один спільний інтерфейс, який бібліотека потім самостійно адаптує під вимоги конкретного завантажувача.

• Мережева взаємодія: спрощує надсилання користувацьких пакетів даних між клієнтом та сервером, об'єднуючи специфічні мережеві протоколи Forge та Fabric.

• Обробка подій: пропонує спільний список ігрових подій (наприклад, взаємодія з блоком, смерть моба, відкриття меню), позбавляючи розробника потреби прописувати слухачі подій під кожну систему окремо.

• Автоматизація збирання: спеціальне розширення для середовища розробки Gradle автоматично генерує фінальні .jar файли для кожного завантажувача на основі спільного коду.

Вплив на сумісність та популярні залежні моди

Використання Architectury API суттєво спрощує підтримку та оновлення модів під нові версії Minecraft, оскільки розробникам достатньо оновити лише саму бібліотеку, не переписуючи логіку власних доповнень. Це робить Architectury API основою для багатьох масштабних проектів.

Приклади відомих модифікацій, які потребують наявності цієї бібліотеки:

• Cloth Config API: популярна бібліотека для створення екранів конфігурації, яка використовує інструменти Architectury для малювання меню налаштувань.

• Rough Enough Items (REI): популярний інтерфейс перегляду рецептів крафту, що спирається на крос-платформні мережеві пакети та реєстри.

• Lighty: мод для візуалізації рівня освітлення, який потребує Architectury для відстеження подій рендерингу на Fabric та Forge.

• Better Archeology: додаток, який впроваджує нові археологічні структури, предмети та блоки на різних завантажувачах за допомогою спільних інструментів реєстрації.

Якщо гравець намагається запустити будь-який із цих модів без попереднього встановлення Architectury API відповідної версії, ігровий клієнт негайно перерве завантаження та виведе повідомлення про помилку із вимогою додати бібліотеку.

Особливості сумісності та вимоги до встановлення

Команда розробників випускає Architectury API як суто технічний плагін. Гравець має завантажити файл бібліотеки, який точно відповідає його версії гри та вибраному завантажувачу (Fabric, Forge або NeoForge).

Встановлення відбувається за стандартною схемою — перенесенням файлу .jar у папку mods. Бібліотека не створює власних файлів конфігурації у папці config, оскільки її налаштування інтегруються безпосередньо у залежні модифікації. Вона працює у фоновому режимі та не потребує ручного втручання в параметри, що виключає ризик збоїв через неправильні налаштування.

Висновок

У порівнянні зі створенням та підтримкою кількох окремих проектів під різні завантажувачі, Architectury API дозволяє розробникам вести розробку в одному спільному проекті. Головним обмеженням бібліотеки є додатковий час, необхідний авторам для вивчення її внутрішнього інструментарію. Ця модифікація є обов'язковою для встановлення гравцям, які хочуть використовувати сучасні технологічні модифікації у своїх збірках.