head-vault (Хед волт)

Мод для Майнкрафт на Fabric, который добавляет серверный магазин декоративных голов для SMP-серверов. Игроки открывают его в интерфейсе сундука и выбирают головы без клиентских модов и ресурс-паков.

Возможности

• Каталог декоративных голов с категориями, страницами и поиском по названию или тегу.
• Поиск головы игрока по его нику.
• Одинаковые головы складываются в стаки до 64 штук.
• Магазин открывается командой, у созданного NPC или у моба с заданным именем. Для торговца можно разрешить только жителей, всех мобов либо настроить белый или чёрный список типов мобов.
• Именного торговца можно обездвижить: его ИИ отключается, пока имя соответствует настройке.
• Цена головы настраивается как бесплатная, предметом, уровнями опыта или очками опыта; для категорий можно задать отдельные цены. Покупка списывает плату только вместе с выдачей головы.
• Каталог сохраняется в кэше и при недоступности источника используются сохранённые данные либо встроенный набор голов.

Как пользоваться

• /heads — открыть магазин.
• /heads search <запрос> — найти голову по названию или тегу.
• /heads player <имя> — получить голову указанного игрока.
• /heads give <игрок> <id-головы> — выдать голову бесплатно.
• /headvault reload — перечитать конфиг.
• /headvault npc spawn <имя> — создать NPC-торговца на текущем месте.
• /headvault npc remove — удалить NPC, на которого направлен взгляд.
• /headvault npc list — показать загруженных NPC-торговцев.

Чтобы сделать торговца из моба, дайте ему имя, указанное в access.villager.name; по умолчанию это Head Trader. Нажатие правой кнопкой по такому мобу открывает магазин.

Настройки

Конфиг находится в config/headvault/config.json; изменения применяются командой /headvault reload.

• catalog.source выбирает источник каталога: v1, v2 или bundled.
• economy.mode задаёт способ оплаты: FREE, ITEM, XP_LEVELS или XP_POINTS.
• economy.categoryOverrides задаёт цену для отдельных категорий.
• access.command, access.npc и access.villager включают нужные способы доступа.
• access.villager.mode, entityWhitelist, entityBlacklist и freeze управляют мобами-торговцами.
• ui.title, showPriceInLore и headsPerPage меняют вид магазина.

Требования и совместимость

Нужны Fabric API и сервер на Java 25 или новее. Мод работает только на сервере: игрокам не требуется устанавливать мод или ресурс-пак. Права совместимы с LuckPerms; без мода прав команды используют уровень оператора.