Curios API

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

Что умеет Curios API

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

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

Если вы собираете сборку модов на приключения или ролеплей - без Curios API не обойтись. Моды вроде Baubles (устарел), Trinkets (Fabric) или собственные аддоны используют похожую механику, но Curios стал стандартом для Forge/NeoForge. Он лёгкий, не добавляет лишнего контента сам по себе (кроме двух тестовых предметов в креативе) и работает как база для десятков популярных модов: от аксессуаров на магию до технологических гаджетов.

Важно знать

• Curios API - это только API. Сам по себе он не добавляет ни одного слота или предмета (кроме двух примеров). Все слоты появляются только после установки модов, которые их используют.
• Мод совместим с Minecraft 1.16.5 и выше (точные версии смотрите на странице загрузки). Работает на Forge и NeoForge.
• Если вы разработчик - в документации описаны все нюансы: как создать свой тип слота, как привязать предметы через теги, как настроить GUI.

Скачайте Curios API и откройте для себя мир аксессуаров в Майнкрафт - без головной боли с совместимостью.