Architectury API: что это и какую версию устанавливать

Что делает Architectury API

Architectury API — слой общих функций для модов, которые выпускаются сразу под несколько загрузчиков. Разработчик использует одинаковые события, сеть и регистрацию, а библиотека связывает их с Fabric, Forge или другой поддерживаемой платформой. Для игрока это зависимость: сама по себе она редко добавляет видимую механику. Если её удалить, требующий мод может не пройти раннюю проверку загрузки.

Когда нужно устанавливать

Ставьте API только когда она указана в relations, manifest модпака или сообщении об ошибке. Репозиторий уточняет, что не каждый проект, созданный инструментами Architectury, обязан использовать runtime-библиотеку. Поэтому название технологии в исходниках ещё не означает обязательный jar для игрока. Надёжное доказательство — зависимость конкретного релиза и журнал вашего профиля.

Выберите точное сочетание

Сопоставьте Minecraft, загрузчик и версию API с требующим модом. Fabric, Forge, Quilt и NeoForge имеют отдельные файлы. Номер Architectury не равен номеру Minecraft, поэтому не угадывайте по первой цифре. Откройте Files, поставьте фильтры и прочитайте название релиза. Не используйте самый новый файл в старом модпаке без проверки минимальной и максимальной версии зависимости.

Установка

Закройте игру и положите jar в mods выбранного экземпляра. Не распаковывайте его и не запускайте двойным кликом. Для сервера используйте файл того же загрузчика и совместимой версии, если серверный мод требует API. После запуска проверьте latest.log: библиотека должна зарегистрироваться один раз. Дубликаты с разными номерами удалите после создания резервной копии профиля.

Ошибка requires Architectury

Сообщение обычно содержит диапазон версии. Сравните установленный jar, затем обновите или откатите его до совместимого. Если диапазоны двух модов не пересекаются, нельзя исправить сборку одной «средней» версией: обновите один из зависимых модов или выберите их совместимые релизы. Не редактируйте metadata внутри jar ради обхода проверки — код всё равно может ожидать отсутствующие методы.

Fabric API — другая библиотека

Architectury API не заменяет Fabric API. Fabric-версия зависимого мода может требовать обе библиотеки. Установите каждую только в заявленной версии. Аналогично, Forge или NeoForge предоставляют собственные API загрузчика, но это не делает Architectury лишней, если мод вызывает её runtime-функции. Читайте всю цепочку dependencies, а не останавливайтесь на первой найденной странице.

Стороны установки

Официальный проект относится к client & server, но конкретное требование определяется модом. Общий контентный мод обычно должен совпадать на обеих сторонах, чисто интерфейсный — только на клиенте. На dedicated server проверяйте первую ошибку: иногда Architectury загружена правильно, а рядом лежит клиентский мод, который обращается к экранным классам. Удаление API лишь скрывает настоящую причину.

Обновление модпака

Обновляйте библиотеку вместе с группой модов, которые от неё зависят. Перед изменением сохраните manifest или список файлов. Запустите новый чистый мир, затем копию основного сохранения. Если появляется NoSuchMethodError, это сильный признак несовместимых бинарных версий. Верните предыдущий комплект и найдите пересекающийся набор релизов, вместо последовательной установки случайных jar.

Почему API не видно в игре

Библиотека может отображаться только в списке модов и журнале. У неё нет обязанности создавать предмет, меню или команду. Проверка состоит в успешной загрузке зависимого мода. Не ищите «как пользоваться Architectury» в игровом смысле: пользователь работает с функциями конкретного мода, а API остаётся техническим слоем. Отдельные экраны могут добавлять другие библиотеки.

Диагностика

Соберите Minecraft, Java, загрузчик, Architectury API, требующий мод и полный latest.log. Отметьте, клиент это или dedicated server. Повторите с минимальным набором. ClassNotFound часто указывает на отсутствующую зависимость, NoSuchMethod — на несовместимый номер, а duplicate mod — на два jar. В issue прикладывайте текстом первую причину, а не только код выхода лаунчера.

Быстрая проверка перед началом

architectury api minecraft: Сверь версию игры, загрузчик и зависимости. Добавляй моды небольшими группами и сохраняй журнал, чтобы быстро найти причину вылета.

Заверши тест контрольным повтором с самого начала. Один случайный успех может скрыть нестабильную схему; два одинаковых результата уже показывают, что порядок действий понятен и воспроизводится.