Плагін Minecraft TitleManager

🔌 Про TitleManager

TitleManager — це плагін Minecraft, який керує елементами презентації для гравців: анімованими заголовками та підзаголовками по центру екрана, actionbar, анімованими заголовками й підвалами списку tab, а також налаштовуваним sidebar scoreboard. Він працює як шар відображення для серверів, яким потрібні більш охайні повідомлення про приєднання, оголошення та живі таб/scoreboard елементи.

🎯 Призначення

Плагін об’єднує функції відображення (titles, actionbar, tab-list, sidebars) в одному місці, щоб власники серверів могли показувати гравцям послідовну, анімовану інформацію на основі placeholder без власного кодування. Він призначений для адміністраторів серверів, які хочуть керувати повідомленнями join/welcome, черговими оголошеннями та динамічним TAB/scoreboard інтерфейсом.

⚙️ Можливості

• Налаштовувані title та actionbar для join і first join з опціями часу та варіантами.
• Анімовані header і footer tab-list із підтримкою gradient та placeholder для кількості гравців онлайн, часу світу/сервера та інших динамічних значень.
• Налаштовуваний sidebar scoreboard із до 15 анімованими рядками, що працює на системі scoreboard сервера.
• Broadcast та заплановані оголошення, які надсилаються як titles або actionbar.
• Двигун анімацій із файлами анімацій, які можна повторно використовувати, та прев’ю (animation playground доступний в офіційній документації).
• Інтеграції placeholder (вбудовані placeholder TitleManager і підтримка зовнішніх систем placeholder, якщо вони є).
• Транзакційні reload: перезавантаження конфігурації застосовуються безпечно і можуть бути відкатані, якщо новий config недійсний.
• Невеликий API для розробників для необов’язкових інтеграцій і використання плагін-плагін.

🧩 Для кого це

• Сервери Survival і SMP, яким потрібен більш охайний інтерфейс join/announcement.
• Сервери, що використовують placeholder і зовнішні інтеграції (для динамічних значень у відображеннях).
• Адміністратори, яким потрібні анімовані tab і scoreboard без написання власних плагінів.
• Розробники, які хочуть інтегрувати функції презентації в інші плагіни через наданий API.

🏗️ Приклади використання

• Показувати анімований welcome title та actionbar, коли гравці заходять, з іншим повідомленням під час first join.
• Робити список гравців у tab живим, показуючи час сервера, кількість онлайн-гравців і gradient header/footer.
• По черзі показувати анімовані announcement titles або actionbar за розкладом, щоб повідомляти про події чи правила.
• Використовувати sidebar scoreboard для відображення таблиць лідерів, статистики або динамічної інформації сервера.

⌨️ Команди

Примітки: наведені вище команди задокументовані проєктом. Конкретні вузли дозволів не були вказані в джерелах, що використовувалися тут, і їх слід перевірити в документації плагіна для точних вузлів і значень за замовчуванням.

⚙️ Встановлення

📥 Налаштування

• Завантажте JAR плагіна з релізу проєкту або сторінки ресурсу плагіна.
• Помістіть JAR у каталог plugins/ вашого сервера.
• Перезапустіть сервер.
• Відредагуйте створені файли конфігурації в plugins/TitleManager/, щоб налаштувати title, анімації та параметри списку гравців.
• Використовуйте /tm reload, щоб застосувати зміни конфігурації; плагін виконує транзакційні reload, щоб не застосовувати зламані config.

📦 Залежності

• PlaceholderAPI (необов’язкова інтеграція для зовнішніх placeholder).
• Vault (необов’язково, використовується для значень placeholder, якщо доступний).
• BungeeCord (поведінка з урахуванням інтеграції під час використання в proxy-налаштуваннях).

Ці інтеграції необов’язкові та використовуються, коли доступні; плагін працює без них, але може використовувати їхні дані, якщо вони є.

🧠 Технічні примітки

• Офіційні цільові runtime охоплюють Minecraft 1.8 до 1.21.x (у матеріалах проєкту вказано явну підтримку до 1.21.11). Поведінка залежить від версії сервера: новіші версії Minecraft використовують сучасні Bukkit/Paper API, тоді як legacy-версії покладаються на модулі сумісності для кожної версії.
• TitleManager публікує невеликий API для Bukkit для необов’язкових інтеграцій і надає згенеровану документацію API.
• Команди safe reload і diagnostics допомагають із налаштуванням і усуненням проблем у runtime.

🤝 Коли цей плагін корисний

Якщо вам потрібне централізоване, анімоване й орієнтоване на placeholder керування елементами презентації (titles, actionbar, tab-list і sidebars), яке налаштовується з конфігурації, а не через власний код, TitleManager надає задокументований плагін і API для послідовного показу цих UI-елементів у всьому середовищі вашого сервера.