CuriosPaper

CuriosPaper - плагин для сервера Майнкрафт, который добавляет полноценную систему слотов для аксессуаров, прямо как старые добрые Baubles или Curios из Forge-сборок, только для Paper и Spigot. Никаких модов не нужно - всё работает на стороне сервера, и даже игроки с Bedrock Edition могут пользоваться.

Зачем это вообще нужно? В ванильном Майнкрафт ты можешь надеть шлем, нагрудник, штаны, ботинки - и всё. А что насчёт колец, которые дают скорость? Амулета, защищающего от огня? Пояса с дополнительной бронёй? Вот для этого и нужен CuriosPaper. Он решает проблему ограниченного инвентаря и даёт админам возможность создавать кастомные предметы с уникальными эффектами.

Что такое CuriosPaper?

По сути, это надстройка над стандартным инвентарём игрока. Ты открываешь меню (команда /baubles), видишь 9 слотов под разные типы аксессуаров: голова, шея, спина, тело, пояс, руки, браслет, кольцо, амулет. Вставляешь туда предмет - и его способности активируются мгновенно. Снял - эффекты пропадают.

Основные фичи

9 типов слотов

• голова (Head)
• ожерелье (Necklace)
• спина (Back)
• тело (Body)
• пояс (Belt)
• руки (Hands)
• браслет (Bracelet)
• кольцо (Ring)
• амулет (Charm)

Каждый слот может содержать один предмет. Никакой магии - просто логично.

Система способностей

Предметы могут давать зелье эффекты и модификаторы атрибутов игрока. Например, кольцо может добавить +2 к броне, а амулет - дать регенерацию. Причём операции с атрибутами бывают трёх типов: ADD_NUMBER (просто прибавить значение), ADD_SCALAR (процент), MULTIPLY_SCALAR_1 (множитель).

Быстрая экипировка

Зажми Shift + ПКМ по предмету в руке - и он сам наденется в подходящий слот. Удобно, не надо открывать меню.

Горячая клавиша

Настроить можно на одинарное/двойное/зажатие Shift. Нажал - открылось меню аксессуаров. Всё.

Элитра на слот спины

Начиная с Minecraft 1.21.3+, можно носить элитру в слоте спины. Это значит, что нагрудник и элитра больше не конфликтуют.

Поведение при смерти

Настраивается: аксессуары могут выпадать, оставаться в инвентаре или следовать правилу keepInventory. Всё гибко.

Поддержка Bedrock Edition

Если на сервере стоит GeyserMC и Floodgate, CuriosPaper автоматически определяет это и подсовывает Bedrock-клиентам кастомный ресурспак и маппинги. Для анила и стола зачарований создаются отдельные 3-рядные интерфейсы для Bedrock, чтобы не было глюков.

3D-модели

CuriosPaper умеет прикреплять к телу игрока 3D-модели. Это не блоки, а невидимые стойки для брони, которые синхронизируются с движениями игрока: ходьбой, бегом, полётом, плаванием, крадучись. Модель видна всем вокруг.

Тонкости:

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

ГИ-редакторы (всё в игре)

Самый крутой момент - не надо лезть в YAML-файлы. Всё настраивается через интерфейс в игре:

• Редактор предметов - название, материал, описание, тип слота
• Редактор способностей - зелье эффекты и модификаторы атрибутов
• Редактор рецептов - обычные, зачаровывание, плавка, ковка
• Редактор лута - выбираешь сундук из данжа, добавляешь свой предмет с шансом
• Редактор дропа с мобов - какой моб что дропает
• Редактор торговли - жители продают твои аксессуары
• Редактор 3D-моделей - настройка положения модели на теле

Распространение предметов

Есть несколько способов, как игроки могут получить твои аксессуары:

• Рецепты - 7 типов: обычный, бесформенный, печь, коптильня, плавильня, наковальня, кузнечный стол
• Сундуки - шанс появления в данжах, шахтах, храмах и т.д.
• Дроп с мобов - любой моб может дропнуть аксессуар с настроенным шансом
• Торговля - жители могут продавать с разными профессиями и уровнями
• Команды - /curios give <item> [player] [amount]

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

Для тех, кто пишет свои плагины, CuriosPaper предоставляет полноценное API. Всё просто:

CuriosPaperAPI api = CuriosPaper.getInstance().getCuriosPaperAPI();

// Повесить на предмет тег аксессуара
ItemStack ring = api.tagAccessoryItem(myItem, "ring");

// Узнать, что на игроке
List<ItemStack> rings = api.getEquippedItems(player, "ring");

// Зарегистрировать новый слот прямо из кода
api.registerSlot("earring", "Earring", "DIAMOND", 2);

// Добавить свой предмет в лут-таблицы
api.registerItemLootTable("my_ring", new LootTableData("minecraft:chests/simple_dungeon", 0.25));

События (Events):

Событие	Когда срабатывает
AccessoryEquipEvent	Игрок надел/снял/поменял аксессуар
CuriosLootGenerateEvent	Предмет сгенерировался в сундуке
CuriosMobDropEvent	Предмет выпал с моба
CuriosCraftEvent	Предмет создан через крафт/плавку/ковку
PlayerDeathCurioDropEvent	Фильтрация дропа при смерти

Установка и настройка

Ставится элементарно:

1. Качаешь CuriosPaper.jar
2. Кидаешь в папку plugins/ на сервере
3. Запускаешь сервер - плагин сам сгенерирует конфиги
4. Готово. Можно использовать /baubles

Режимы ресурспака

В config.yml можно выбрать, как раздавать ресурспак:

• SELF - плагин запустит встроенный HTTP-сервер (порт 8080) и сам раздаст ресурспак
• LINK - ты указываешь внешнюю ссылку (например, на Modrinth)
• NONE - никакого авторесурспака

Поддержка Bedrock Edition

CuriosPaper сам определяет, стоит ли Geyser на том же сервере, и автоматически копирует файлы ресурспака и маппингов в нужные папки. Если Geyser на прокси - делаешь вручную: берёшь файлы из plugins/CuriosPaper/geyser/, кидаешь в packs/ и custom_mappings/ у Geyser, включаешь enable-custom-content: true в его конфиге.

Совместимость

	Требования
Minecraft	1.14.4 - 1.21+
Сервер	Spigot, Paper, Purpur, Folia*
Java	8+
GeyserMC	Поддерживается
Зависимости	Нет (standalone)

* Folia - экспериментальная поддержка

Версия 2.0.1 - что нового

• Bedrock GUIs для анила и стола зачарований - отдельные 3-рядные интерфейсы для Bedrock-игроков
• Операции модификаторов атрибутов - ADD_NUMBER, ADD_SCALAR, MULTIPLY_SCALAR_1
• Автоскрытие 3D-моделей - при полёте, спектаторе, плавании, атаке трезубцем
• Безопасность GUI - модели временно отключаются при открытии инвентаря, чтобы не накладывались
• Гибкий парсинг версий - работает с нестандартными билдами Paper

Коротко о главном

Если ты админ сервера и хочешь добавить RPG-механику с аксессуарами - CuriosPaper это то, что надо. Не требует модов на клиенте, работает с Bedrock, легко настраивается через GUI, есть API под любые задачи. Игроки смогут носить кольца, амулеты, плащи - и всё это с реальными эффектами, а не просто декорация.

Скачать плагин CuriosPaper и установить его можно в пару кликов. Главное - не забудь настроить ресурспак, чтобы модели отображались корректно. Если у тебя сервер на Paper или Spigot - вообще никаких проблем, ставь и пользуйся.