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 позволяет разработчикам вести разработку в одном общем проекте. Главное ограничение библиотеки — дополнительное время, необходимое авторам для изучения её внутреннего инструментария. Этот мод обязателен к установке игрокам, которые хотят использовать современные технологичные моды в своих сборках.