Плагин PrismTituls | Копия новой системы титулов с сервера HolyWorld [RELEASE-1.0]

---

PrismTituls - это плагин на систему титулов игроков.
Игрок собирает коллекцию титулов, выбирает активный через удобное меню и может передавать титулы физическими бирками (NAME_TAG).

Плагин отлично подходит для серверов с кейсами, донатом, кастомными наградами и отображением титула в чате / табе через PlaceholderAPI.

---

Скриншоты

---

Возможности

• Меню титулов /tituls в стиле BMenu / DeluxeMenus
• Просмотр чужих титулов: /tituls <ник>
• Активный титул через плейсхолдер %PrismTituls_titul%
• Физическая бирка NAME_TAG — можно передать другому игроку
• Активация бирки ПКМ → титул появляется в /tituls
• В меню: ЛКМ — установить титул, ПКМ — превратить обратно в бирку
• Снять активный титул одной кнопкой
• Сортировка: сначала новые / старые / кастомные
• Постраничная навигация
• Настраиваемые категории редкости в rarity.yml (готовые градиенты HEX)
• Авто-градиент по буквам: text + gradient
• Полностью настраиваемое меню в menu.yml
• Поддержка SQLite и MySQL для синхронизации в сети
• Админ-команды выдачи / изъятия / просмотра титулов

---

Как это работает

• Админ выдаёт титул командой или игрок активирует физическую бирку
• Титул сохраняется в коллекцию игрока (с датой и редкостью)
• В /tituls игрок выбирает активный титул
• Активный титул отдаётся в PlaceholderAPI: %PrismTituls_titul%
• ПКМ по титулу в меню превращает его в бирку — можно продать или подарить
• ПКМ по бирке в руке снова добавляет титул в коллекцию

---

Команды


Алиас админ-команды: /ptituls.

---

Права


prismtituls.use - открыть своё меню /tituls (по умолчанию true).

prismtituls.view - смотреть чужие титулы /tituls <ник> (по умолчанию true).

prismtituls.admin - админ-команды /prismtituls (по умолчанию op).

---

PlaceholderAPI

PlaceholderAPI является необязательной зависимостью (softdepend).


Возвращает активный титул игрока (с цветами). Если титул не выбран — пустая строка (настраивается в config.yml).

Подходит для чата, таба, голограмм, scoreboard и других плагинов.

---

Категории редкости

Все редкости настраиваются в rarity.yml.

Можно задать готовый HEX-дизайн:


Или собрать градиент автоматически:


custom: true — титул участвует в сортировке «Сначала кастомные».

---

Физическая бирка

• Материал: NAME_TAG (настраивается)
• Кастомные PDC-теги плагина (не обычная бирка)
• Хранит текст титула, редкость, дату и флаг custom
• Можно свободно передавать между игроками
• ПКМ — активация в коллекцию /tituls
• Если такой титул уже есть — бирка не тратится, игрок получает сообщение

---

Конфиги

• config.yml - бирка, дата, storage (SQLite/MySQL)
• messages.yml - сообщения активации и админки
• menu.yml - дизайн меню, слоты, кнопки, сортировка
• rarity.yml - категории редкости и градиенты

---

Хранилище

Плагин поддерживает два типа хранения:

• SQLite - для одного сервера, используется по умолчанию
• MySQL - для Bungee/Velocity сетей и синхронизации между серверами

Настройки находятся в config.yml → storage.

Данные игрока подгружаются при входе и при открытии меню — удобно для нескольких серверов с общей MySQL.

---

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

• Minecraft: 1.16.5 - 1.21.11
• Java: 8+ (на серверах 1.21+ — Java 21 у самого сервера)
• Сервер: Spigot / Paper
• Опционально: PlaceholderAPI
• Один universal jar на весь диапазон версий

---

Установка

1. Поместите PrismTituls.jar в папку plugins.
2. (Опционально) Установите PlaceholderAPI для плейсхолдера титула.
3. Перезапустите сервер.
4. Настройте config.yml, menu.yml, rarity.yml и messages.yml.
5. Выдайте права prismtituls.use / prismtituls.view (по умолчанию уже true).
6. Используйте /prismtituls reload после изменения конфигов.

---

Пример выдачи


Последний аргумент give — редкость из rarity.yml, всё между ником и редкостью — текст титула (можно с &#RRGGBB).

---

Автор

PrismDeveloper

Telegram: PrismDeveloper | Канал

---