Curios API

Что такое Curios API

Curios API - это, по сути, фундамент для любого мода, который добавляет в Майнкрафт всякие кольца, амулеты, пояса и прочую бижутерию. Если вы когда-нибудь играли с модами на магию или RPG-элементы, то точно сталкивались с проблемой: модов много, а слотов под их предметы в инвентаре кот наплакал. Этот API (или Куриос АПИ, как его часто ищут в поиске) решает проблему раз и навсегда, создавая единую, гибкую систему слотов для аксессуаров.

Зачем нужен этот проект

В ванильном Minecraft слотов для экипировки строго ограниченное количество: броня, вторая рука да элитры. Когда вы ставите большую сборку модов, авторы которых наплодили десятки колец на регенерацию, ботинок скорости и плащей, весь этот хлам начинает захламлять обычный инвентарь. Curios API дает разработчикам удобный инструмент для создания новых слотов, а игрокам - единый интерфейс для управления всем этим добром.

Основные возможности

• Расширяемые слоты через центральную библиотеку. Разработчики могут легко создавать и управлять новыми слотами. Используется система идентификаторов. Если два мода используют одинаковый идентификатор слота (например, ring), они сольются вместе, что исключает дублирование и дает максимальную совместимость.
• Слоты создаются только по требованию. По умолчанию пустых слотов нет вообще. Они появляются только тогда, когда в инвентаре появляется предмет, который можно в них вставить. Это избавляет интерфейс от мусора и бесполезных пустых квадратиков.
• Полная кастомизация. Слоты могут иметь свои фоновые текстуры, разные размеры и даже быть скрытыми по умолчанию. Разработчики через API могут включать или выключать слоты для конкретного игрока, добавлять или удалять их количество.
• Работа через ванильную систему тегов. Предметы распределяются по слотам с помощью стандартной системы тегов Minecraft. Это значит, что добавить предмет в категорию можно просто создав . файл в папке data/curios/tags. Один предмет может принадлежать сразу к нескольким типам слотов.
• Интеграция с ванильными механиками. Зачарования вроде Прочности (Mending) и Проклятий (Curses) будут полноценно работать с предметами, надетыми в слоты Curios.
• Единый интерфейс. Все доступные слоты собраны в одном удобном окне. Оно открывается прямо из обычного инвентаря. Кнопка по умолчанию - английская клавиша G.

Нюансы и советы

По факту, сам по себе Curios API почти ничего не добавляет в игру. Вы получите только окно инвентаря и пару тестовых предметов в креативном меню. Чтобы слоты заполнились, вам нужны другие моды, которые используют этот API. Так что если ставите его в сборку - убедитесь, что там есть поддерживаемые аддоны.

Важный нюанс: если вы настраиваете слоты через датапаки или конфиги, помните, что система тегов позволяет переопределять категории. Вы можете сделать так, чтобы обычный ванильный уголь работал как аксессуар, если пропишете его в нужный тег. Главное - не забудьте перезагрузить датапаки командой /reload.

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

Если вы кодите свой мод, интеграция с Curios сэкономит вам кучу времени. Не нужно писать свою систему рендера слотов и интерфейсов. Все делается через API и теги. В документации есть разделы по настройке среды разработки, конфигурации слотов и командам.

Игра на сервере

Мод отлично работает в сетевой игре. Если планируете запускать сервер с модами для игры с друзьями, проще всего арендовать сервер Майнкрафт на BungeeHost. Там моды устанавливаются в пару кликов, а Curios API корректно синхронизирует все слоты и эффекты между сервером и клиентами. Скачайте Curios API, если собираете RPG-сборку - это стандарт де-факто для современной экипировки в Minecraft.