HeadDB

Современная база голов для серверов на Paper и Folia.

HeadDB - это плагин, который даёт игрокам чистый интерфейс в виде инвентаря для просмотра, поиска, добавления в избранное, редактирования и получения голов Minecraft. Администраторы полностью контролируют права, цены, категории, сообщения, макет GUI и инструменты управления.

Если на сервере часто нужны декоративные головы для построек, магазинов или ивентов - HeadDB решает эту задачу без головной боли. Вместо длинных команд или ручной раздачи через консоль - красивое меню с поиском.

Особенности

• Головы, категории, теги, коллекции, поиск, избранное
• Дополнительные категории (More Categories) и головы (More Heads)
• Головы игроков с отдельным управлением
• Локальный контроль видимости голов
• Современный интерфейс на основе инвентаря
• Продвинутый поиск, фильтрация и сортировка
• Опциональная поддержка экономики через Vault
• Детальная система прав
• Редактирование голов прямо в игре
• Локальное кеширование и работа офлайн
• Настраиваемые макеты GUI и сообщения
• Публичный Java API для интеграции

Поддержка Paper и Folia

Плагин работает как на Paper, так и на Folia. Требования:

• Java 25
• Paper или Folia
• Доступ к сети (для загрузки удалённой базы)

Современный GUI

Игроки открывают HeadDB командой /hdb и листают головы без длинных и сложных команд. В интерфейсе есть:

• Категории
• Поиск
• Избранное
• Головы игроков
• More Heads и More Categories
• Настройки игрока
• Административные инструменты
• Просмотр скрытых голов
• Страницы с результатами, навигация

Все кнопки настраиваются через gui.yml: слоты, материалы, иконки, названия, описание и расположение.

Поиск, фильтрация и сортировка

HeadDB даёт удобный поиск с разбивкой по страницам. Искать можно:

• по тексту
• по категориям
• по тегам
• по коллекциям
• с сортировкой

Команда для поиска:

/hdb search <запрос>

Избранное

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

Головы игроков

Управление головами игроков вынесено отдельно от каталога HeadDB. Администратор независимо настраивает:

• доступ к головам игроков
• выдачу своей головы
• выдачу головы другого игрока
• цены на головы игроков (если включена экономика)

More Heads (свои головы)

More Heads - это локальные кастомные головы, созданные прямо на сервере. Подходят для:

• украшений на сервере
• наград за ивенты
• голов администрации
• донатерского контента
• сезонных предметов
• товаров в магазине
• голов, которых нет в удалённой базе

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

More Categories (свои категории)

More Categories - локальные категории для вашего сервера. В них можно добавлять:

• головы из удалённой базы
• More Heads
• головы игроков

Так собираются тематические подборки: декор спавна, награды, ассортимент магазина, сезонки, любимые постройки билдеров. Добавление головы в такую категорию не меняет её исходную категорию.

Admin Mode (режим администратора)

Режим администратора открывает дополнительные кнопки управления прямо в GUI. С его помощью можно:

• редактировать головы (кнопка выброса предмета, обычно Q)
• настраивать кнопки GUI
• просматривать скрытые головы
• управлять More Heads и More Categories
• смотреть дополнительную информацию о базе

При этом обычные игроки видят только чистый интерфейс.

Переопределение метаданных голов

Администраторы могут локально менять метаданные удалённых голов без правки публичной базы. Поддерживается:

• переименование головы
• изменение описания
• смена категории, тегов, коллекции
• скрытие или показ головы
• сброс локальных изменений

Всё хранится на сервере и полностью под контролем владельца.

Опциональная экономика

HeadDB умеет брать с игроков деньги за получение голов. По умолчанию экономика отключена. Для включения нужны:

• Vault
• плагин-провайдер экономики, совместимый с Vault

Цены настраиваются для:

• любых голов
• голов игроков
• удалённых категорий
• More Categories
• отдельных голов

Если действует несколько цен, используется наиболее конкретная:

1. цена конкретной головы
2. цена More Category
3. цена головы игрока
4. цена удалённой категории
5. глобальная цена по умолчанию

Когда экономика отключена - всё бесплатно. Если включена, но Vault недоступен, плагин пишет предупреждение и не списывает деньги.

Система прав

HeadDB использует как общие, так и детальные разрешения. Это позволяет простым серверам дать один доступ, а сложным - точечно настраивать.

Основные права:

• headdb.basic - для обычных игроков
• headdb.admin - полный доступ
• headdb.open, headdb.browse, headdb.search, headdb.head.take и другие

Можно настроить права на категории: headdb.category.* или для конкретной headdb.category.<id>.

ID голов

HeadDB использует типизированные идентификаторы:

• удалённая голова: 123
• More Head: custom:melon
• голова игрока: player:UUID

Это исключает коллизии и позволяет точно понять, откуда голова.

Команды (основные)

Команда	Описание
/hdb	Открыть главное меню
/hdb help	Справка
/hdb search <запрос>	Поиск голов
/hdb give <id> [игрок] [количество]	Выдать голову
/hdb player <игрок> [цель] [количество]	Выдать голову игрока
/hdb custom create <id> <текстура> <название>	Создать свою голову
/hdb reload	Перезагрузить конфиги

Полный список - /hdb help в игре.

Настройка

Конфигурация разделена по файлам:

• config.yml - загрузка базы, кеш, таймауты
• gui.yml - макет GUI, кнопки, материалы
• economy.yml - цены и экономика
• messages/en-US.yml - сообщения для игроков и админов

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

HeadDB предоставляет публичный Java API через систему сервисов Bukkit. Подключаешься так:

RegisteredServiceProvider<HeadDBService> registration = Bukkit.getServicesManager().getRegistration(HeadDBService.class);
if (registration == null) return;
HeadDBService headDB = registration.getProvider();

Методы API:

• headDB.find("id") - найти голову
• headDB.customHeads().list() - список своих голов
• headDB.favorites().ids(playerUUID) - избранное игрока
• headDB.customCategories().list() - список своих категорий

API и ядро плагина работают на Java 21, но сам плагин требует Java 25 для Paper.

Установка

Скачайте последнюю версию плагина HeadDB, положите в plugins/ и перезапустите сервер. После генерации файлов можно приступать к настройке.