Curios API (Fabric)

Внимание! Curios API больше не поддерживается для версий 1.17+ на Fabric.

Рекомендуется использовать Trinkets API вместо этого мода. Я участвовал в переработке Trinkets для версии 1.17, и он содержит все необходимые функции из Curios, что делает его полноценной заменой.

Этот проект предназначен для загрузчика модов Fabric. Для версии под Forge посетите соответствующую страницу.

Обзор

Curios представляет собой универсальную и расширяемую систему для работы с аксессуарами и экипировкой, предназначенную как для игроков, так и для разработчиков модов. Основная цель — предоставить разработчикам удобный и совместимый способ добавления дополнительных слотов для предметов, а игрокам — возможность настраивать эти слоты по своему усмотрению.

По умолчанию мод не добавляет никакого контента, кроме интерфейса инвентаря. Изначально слоты отсутствуют, доступны только два предмета, которые можно найти исключительно в творческом режиме и которые служат примерами для разработчиков при создании собственной интеграции.

Требуется Fabric API.

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

Расширяемая система слотов через центральную библиотеку

Новые слоты для экипировки создаются и управляются легко через реестр идентификаторов. Идентичные идентификаторы объединяются, чтобы избежать функционального дублирования и обеспечить максимальную совместимость с потенциальными предметами, при этом уникальные идентификаторы могут использоваться для обозначения специальных типов, когда это необходимо.

Слоты создаются только по требованию

По умолчанию слоты отсутствуют — они создаются только по мере необходимости. Это уменьшает ситуации, когда присутствуют один или несколько лишних слотов без подходящих предметов для их заполнения.

Полная настраиваемость и управляемость слотов

Слоты могут иметь пользовательские фоны, различные размеры, а также могут быть отключены или скрыты по умолчанию. Но как игрок может получить доступ к отключенным слотам? Через API разработчики могут использовать функции для включения/отключения слотов игрока или добавления/удаления определенного количества слотов заданного типа.

Гибкие отношения предмет-аксессуар с использованием ванильной системы тегов

Потенциальные аксессуары выбираются через стандартную систему тегов Minecraft, что означает, что категоризация предметов по типам аксессуаров так же проста, как создание .json файла в папке data/curios/tags. Предметы могут быть отнесены к любым типам аксессуаров, если они помечены в соответствующих файлах, и эти настройки могут быть полностью переопределены.

Полная интеграция с другими механиками инвентаря

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

Доступ через единый интерфейс

Curios поставляется со своим собственным интерфейсом, доступным из инвентаря, который показывает все доступные игроку слоты. Это позволяет игрокам видеть все расширенные слоты экипировки в одном месте без необходимости переключаться между различными интерфейсами инвентаря. Однако разработчики по-прежнему могут предоставлять свои собственные интерфейсы для специфичных для их мода слотов, если захотят. Стандартная клавиша для открытия интерфейса — 'g'.

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

• Как использовать: Для игроков
• Как использовать: Для разработчиков
• Команды
• Часто используемые слоты