Cardinal Components API

Cardinal Components API - это библиотека для Fabric и Quilt, которая решает одну из главных головных болей мододелов: как удобно и быстро привязать свои данные к ванильным объектам Майнкрафт. Вместо того чтобы изобретать велосипед с NBT-тегами и костылями, ты просто используешь компоненты.

Что это и зачем нужно

В ванильном Minecraft у каждого объекта (игрок, чанк, предмет, блок, сущность) есть свой набор данных. Но если ты хочешь добавить к ним что-то своё - например, новую стамину для игрока или заряд для блока - приходится лезть в дебри сохранения и синхронизации. Cardinal Components API берёт это на себя.

Ключевые фишки

• Привязка к чему угодно - можно навесить данные на игрока, мир, чанк, предмет, блок, сущность. Да хоть на всё сразу.
• Один раз написал - работает везде - реализуешь компонент, а сохранение и загрузка происходят автоматически. Не надо думать о NBT.
• Синхронизация одной строкой - есть специальный интерфейс, который сам отправляет данные на клиент. Без лишнего кода.
• Гибкое копирование при респавне - сам решаешь, что происходит с данными игрока после смерти. Можно сбросить, можно сохранить, можно частично.
• Тики компонентов - можно заставить компонент обновляться каждый тик вместе с его владельцем. Удобно для эффектов, таймеров, регенерации.
• Тонкая настройка - куча опций, чтобы подогнать поведение под свои нужды. Вплоть до того, как именно данные сериализуются.
• Скорость - под капотом ASM-генерация, так что никаких тормозов. Всё летает.

Для кого это

В первую очередь - для разработчиков модов на Fabric или Quilt. Если ты пишешь мод, где нужно хранить какие-то дополнительные данные у игрока, блока или предмета - этот API сэкономит тебе кучу времени. Без него придётся вручную писать сохранение в NBT, синхронизацию через пакеты и обработку респавна. С ним - просто объявил компонент и пользуешься.

Важно знать

• Это не мод для игрока, а библиотека для мододелов. Сам по себе он ничего в игру не добавляет.
• Полная документация - в вики репозитория. Там же примеры и javadoc.
• Работает на Fabric и Quilt. Для Forge есть аналоги, но этот заточен под Fabric-экосистему.

Если ты собираешься делать мод с кастомными данными - Cardinal Components API это практически must-have. Скачать библиотеку можно через стандартные средства Fabric или Quilt, а подключить - одной зависимостью в build.gradle. Дальше останется только реализовать компоненты и радоваться жизни.