Caelus API (Forge/NeoForge)

Общий доступ к механике полёта

Caelus API выносит ванильное поведение элитр в более универсальный атрибут сущности. Благодаря этому разработчики могут давать персонажу совместимый полёт через собственные предметы и системы, не повторяя жёстко заданную логику игры.

Для игрока это техническая зависимость. Библиотека не создаёт отдельную кампанию или набор предметов, но обеспечивает основу, на которой работают функции других модов.

Зачем нужна абстракция

• Атрибут полёта заменяет прямую привязку механики к одному ванильному предмету.
• Единый интерфейс помогает нескольким модам согласованно проверять возможность полёта.
• Переиспользование кода уменьшает число несовместимых реализаций одной функции.
• Forge и NeoForge получают отдельные подходящие сборки библиотеки.
• Клиентские и серверные моды могут опираться на общий результат при корректной установке зависимости.

Caelus API не означает, что любой установленный предмет автоматически даёт полёт. Конкретный контентный мод решает, когда активировать атрибут и какие условия применить.

Что делать игроку

Если загрузчик сообщает об отсутствующем Caelus API, нужно выбрать файл для точной версии Minecraft и своего загрузчика. Установка другого API экипировки не удовлетворяет эту зависимость.

Обновлять библиотеку безопаснее вместе с модами, которые её используют. Несовпадение поколения API может проявиться ошибкой запуска или неработающей механикой полёта.

Пример с Elytra Slot

Elytra Slot показывает практическое применение библиотеки. В Forge-окружении он использует Curios API для отдельного слота экипировки и Caelus API для предоставления тех же возможностей полёта.

Игрок может оставить нагрудную броню на персонаже и разместить элитры в дополнительном слоте. Caelus API при этом отвечает за общую механику, а Elytra Slot добавляет видимую игровую функцию.

Границы проекта

Caelus API является coremod и библиотекой для разработчиков. Его наличие само по себе не меняет инвентарь и не добавляет новый способ добычи элитр.

Современные файлы представлены для Forge и NeoForge. В сборке следует оставлять библиотеку до тех пор, пока хотя бы один мод объявляет её обязательной, и удалять только после проверки зависимостей.