Curios API

Обзор

Curios — это гибкий и расширяемый API для аксессуаров и экипировки, предназначенный как для игроков, так и для разработчиков. Его цель — предоставить разработчикам функционал для добавления дополнительных слотов под аксессуары и экипировку удобным и совместимым способом, а также дать игрокам возможность настраивать эти слоты по своему усмотрению. По умолчанию Curios не добавляет никакого контента, кроме GUI инвентаря. Здесь нет слотов и всего два предмета, причём последние доступны только через меню Creative и в первую очередь служат примерами для разработчиков при написании собственной интеграции.

Возможности

• Расширяемые слоты экипировки через центральную библиотеку. Новые слоты экипировки можно легко создавать и управлять ими через реестр идентификаторов. Одинаковые идентификаторы будут объединяться, чтобы избежать функциональных избыточностей и обеспечить максимальную совместимость с потенциальными предметами, а уникальные идентификаторы по-прежнему можно использовать для обозначения особых типов, когда это уместно.
• Слоты создаются только по мере необходимости. По умолчанию слоты не включены, все слоты создаются только при необходимости. Это уменьшает случаи, когда присутствует один или несколько лишних слотов без подходящих предметов для них.
• Слоты полностью настраиваемы и управляемы. Слоты могут иметь собственные фоны, разные размеры и даже могут быть отключены или скрыты по умолчанию. Но как игрок вообще получит доступ к отключённым слотам? Через API разработчики могут получить доступ к функциям включения/отключения слотов игрока или добавления/удаления определённого количества слотов заданного типа.
• Гибкие связи предмет->curio с использованием ванильной системы тегов. Потенциальные curio выбираются через ванильную систему тегов, что означает, что категоризировать предметы по типам curio так же просто, как создать файл .json в папке data/curios/tags. Предметы можно отнести к скольким угодно типам curio, если они отмечены тегами в соответствующих файлах, и эти настройки можно даже полностью переопределить. Для получения дополнительной информации см. ванильную систему тегов.
• Полная интеграция с другими механиками инвентаря. Mending и Curses будут работать со всеми подходящими предметами, экипированными в слоты curio. Также есть различные мелкие функции для разработчиков, упрощающие интеграцию их текущих предметов или механик в систему curio.
• Доступ из единого GUI. Curios поставляется с собственным GUI, доступным из инвентаря, который показывает игроку все доступные слоты. Это позволяет игрокам видеть все расширенные слоты экипировки в одном месте без необходимости открывать разные GUI инвентарей. Однако разработчики по-прежнему могут предоставлять собственные GUI для своих мод-специфичных слотов, если захотят. Клавиша по умолчанию для GUI — 'g'.

Документация

• Настройка среды разработки
• Слоты
• Пример датапака
• Конфигурация слотов
• Команды
• Устаревшая документация для 1.19.x и ниже