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

Зачем это нужно

В ванильном Майнкрафте полёт на элитрах жёстко привязан к самому предмету "Элитры". Если ты хочешь сделать свой мод, где игрок летает на чём-то другом (например, на реактивном ранце или магических крыльях), приходится копировать всю логику из ванильного кода. Caelus решает эту проблему: он выносит механику полёта в отдельный атрибут, который можно привязать к любому предмету, эффекту или даже к самому игроку.

Как это работает

Всё строится вокруг атрибута fallFlying. По умолчанию его значение равно 0 - это значит, что полёт на элитрах отключён. Если значение становится 1 или больше - механика активируется. Разработчику достаточно вызвать CaelusApi.getInstance().getFallFlyingAttribute() и применить модификатор к этому атрибуту. Всё остальное Caelus делает сам.

Кстати, сами ванильные элитры тоже переписаны через этот атрибут, так что их поведение не изменилось - всё работает как раньше.

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

Если ты пишешь мод и хочешь добавить полёт на элитрах, подключить Caelus просто. Добавь в build.gradle репозиторий:

repositories {
    maven {
        name = 'C4's Maven'
        url = "https://maven.theillusivec4.top/"
    }
}

Для Forge

dependencies {
    runtimeOnly "com.illusivesoulworks.caelus:caelus-forge:${version}"
    compileOnly "com.illusivesoulworks.caelus:caelus-forge:${version}:api"
}

Для NeoForge

dependencies {
    runtimeOnly "com.illusivesoulworks.caelus:caelus-neoforge:${version}"
    compileOnly "com.illusivesoulworks.caelus:caelus-neoforge:${version}:api"
}

Вместо ${version} подставь нужную версию Caelus.

Важно знать

• Атрибут можно менять через команды, эффекты или другие моды - это открывает кучу возможностей для кастомных механик.
• Если ты собираешь модпак с упором на полёты или технологии - Caelus почти наверняка понадобится как зависимость.
• Лицензия LGPL-3.0 - можно использовать в коммерческих проектах, но с оговорками.

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