Caelus API

Caelus API - техническая библиотека для Minecraft, а не мод с отдельным контентом для игрока. Она выносит полёт на элитрах в изменяемый атрибут сущности, чтобы другие моды могли разрешать или ограничивать эту механику. Например, модификация может дать возможность летать в экипировке, которая сама по себе не является элитрами, если её разработчик использует API Caelus.

Как работает Caelus API

В ванильном Minecraft возможность летать обычно связана с надетыми элитрами. Caelus заменяет эту жёсткую проверку атрибутом полёта: его значение по умолчанию равно 0, поэтому полёт запрещён. Значение 1 или выше включает возможность летать.

Разработчики получают атрибут через CaelusApi.getInstance().getFallFlyingAttribute() и могут применять к нему модификаторы. Ванильные элитры тоже используют этот атрибут, поэтому при обычной игре их поведение не меняется. Для игрока Caelus сам по себе не добавляет предметов или новых способов передвижения - изменения появляются только вместе с модами, которые подключают эту библиотеку.

Совместимость и назначение

Caelus API рассчитан прежде всего на авторов модов, которым нужно встроить полёт на элитрах в собственные предметы или механики без повторения ванильной логики. Это помогает нескольким модам взаимодействовать с одной системой атрибутов. В ранних обновлениях также появилась поддержка трёх состояний полёта вместо двух, чтобы улучшить совместимость между модификациями.

Проект выпускается для Minecraft Java Edition; в контексте проекта указана совместимость с версиями 1.13.2-1.21.5 и загрузчиками Fabric, Forge и NeoForge. Конкретную версию Caelus нужно подбирать под версию игры и загрузчик: наличие проекта для нескольких платформ не означает, что один файл подойдёт всем. Для Minecraft 1.21.5 указана версия 8.0.1 для NeoForge.

Для разработчиков

В коде мода атрибут запрашивается так:

CaelusApi.getInstance().getFallFlyingAttribute()

Полученный атрибут используют при настройке модификаторов полёта. Конкретные значения и способ применения зависят от механики самого мода. Это библиотечный API: обычному игроку не нужно настраивать его вручную, но он может понадобиться как зависимость для другого мода.

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