Curios API Continuation

Мод Curios API Continuation для Minecraft 1.21

Curios API Continuation — это неофициальный порт популярного API от TheIllusiveC4, адаптированный для загрузчика NeoForge. Проект позволяет разработчикам модов создавать собственные слоты для аксессуаров и оборудования, а игрокам — настраивать их внешний вид и поведение через единый интерфейс. Мод работает как библиотека без встроенных предметов, предоставляя только GUI для управления слотами и инструменты для интеграции с другими механиками инвентаря.

Этот мод является неофициальным продолжением оригинального CuriosAPI, созданного TheIllusiveC4. В текущем состоянии он поддерживает только загрузчик NeoForge, хотя поддержка Forge планируется в будущем. Если вы нашли баги в этом порте, пожалуйста, не сообщайте их разработчику оригинала, а используйте отдельную страницу GitHub или приглашение в Discord для этого проекта. Описание и документация находятся в процессе обновления.

Основная цель Curios — предоставить гибкую и расширяемую систему для добавления слотов аксессуаров как пользователям, так и разработчикам. Мод не добавляет в игру какие-либо предметы или слоты по умолчанию; он работает исключительно как библиотека. В инвентаре появляется только графический интерфейс (GUI), где отображаются слоты. Это позволяет другим модам добавлять свои слоты, не перегружая инвентарь игрока лишними ячейками, если соответствующие предметы не установлены.

Ключевая особенность системы — возможность легко создавать и управлять новыми слотами оборудования через реестр идентификаторов. Если два мода используют одинаковый идентификатор, слоты объединяются для избежания дублирования функций и обеспечения совместимости предметов. При этом уникальные идентификаторы позволяют отмечать специальные типы слотов. Все слоты создаются по запросу: если игрок не имеет предмета, подходящего для конкретного типа слота, ячейка не отображается. Это минимизирует количество пустых слотов в инвентаре.

Слоты полностью настраиваемы: можно менять их размер, добавлять фоновые изображения или скрывать их по умолчанию. Доступ к скрытым слотам осуществляется через API, которое позволяет разработчикам включать/выключать слоты или добавлять новые. Система интеграции с предметами использует теги из ванильной системы Minecraft, что упрощает категоризацию предметов. Например, можно создать JSON-файл в папке data/curios/tags, чтобы присвоить предмету статус аксессуара. Также мод поддерживает такие механики, как починка (Mending) и проклятия, которые будут работать с предметами в слотах Curios.

Для доступа к слотам используется единый GUI, вызываемый по умолчанию комбинацией клавиш 'g'. Этот интерфейс показывает все доступные слоты в одном месте, избавляя от необходимости переключаться между разными инвентарями. Однако разработчики могут создать свои собственные GUI для специфических типов слотов. Для интеграции в свои моды необходимо добавить следующий код в build.gradle:

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

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

Важно заменить ${version} на актуальную версию Curios, совместимую с вашей сборкой. Полная документация доступна на официальном ресурсе проекта. Мод работает на клиенте и сервере, требует наличия загрузчика NeoForge и совместим с версиями игры 1.21 и 1.21.1.

Связанные материалы

• Curios API — похожий мод
• Trinkets — похожий мод
• Prickle — похожий мод

Автор: SSKirillSS · Лицензия: GPL-3.0-or-later