Curios API Continuation

Curios API Continuation - это продолжение популярного Curios API для NeoForge (сейчас) и Forge (в планах). По сути, это набор инструментов, который даёт разработчикам возможность добавлять в игру дополнительные слоты для аксессуаров - колец, амулетов, поясов и прочего. Игроки же получают удобный интерфейс для управления всем этим добром.

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

В ванильном Minecraft нет нормальной системы аксессуаров. Моды вроде Baubles или Trinkets пытались это исправить, но именно Curios стал стандартом де-факто благодаря своей гибкости и совместимости. Curios API Continuation поддерживает актуальную версию игры на NeoForge и позволяет моддерам не изобретать велосипед - просто подключаешь API и добавляешь новые типы слотов.

Что даёт Curios API

• Гибкие слоты. Новые слоты создаются через реестр идентификаторов. Если у двух модов одинаковый тип слота (например, "ring"), они объединяются - никакой путаницы. А если нужно что-то уникальное - делаешь свой идентификатор.
• Слоты по запросу. По умолчанию слотов нет - они появляются только тогда, когда в них есть необходимость. Это значит, что в инвентаре не болтаются пустые ячейки.
• Полная кастомизация. Слоту можно задать фон, размер, скрыть или отключить его. Разработчик может программно включать/выключать слоты для конкретного игрока или добавлять/удалять их количество.
• Привязка предметов через теги. Используется ванильная система тэгов. Чтобы указать, что предмет подходит для слота, достаточно создать json-файл в папке data/curios/tags. Можно даже переопределять настройки полностью.
• Совместимость с зачарованиями. Починка и проклятия работают с предметами в слотах Curios. Разработчикам доступны хуки для интеграции своих механик.
• Единый GUI. Все слоты отображаются в одном окне, которое вызывается клавишей G. Разработчики могут сделать свой интерфейс для специфических слотов, но базовый уже готов.

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

Если ты хочешь добавить поддержку Curios в свой мод, подключи зависимость в build.gradle:

repositories {
    maven {
        name = "OctoStudios"
        url = uri("https://maven.octo-studios.com/releases")
    }
}

dependencies {
    implementation 'top.theillusivec4.curios:curios-neoforge:${version}'
}

${version} замени на актуальную версию Curios. Документация и примеры использования будут обновлены позже, а пока всё работает стабильно.

Вердикт

Curios API Continuation - это must-have для любого моддера, кто работает с аксессуарами на NeoForge. Он лёгкий, гибкий и совместимый. Если собираешь модпак на Майнкрафт 1.21 - без этого API никуда. Скачай Curios и дай своим предметам новые слоты!