Announcer

Announcer — это инструмент для Bukkit-серверов, позволяющий отправлять сообщения игрокам через различные интерфейсы, включая полосу босса и заголовок экрана.

Announcer предоставляет администраторам возможность гибко управлять информационными потоками на сервере. Плагин поддерживает различные способы отображения сообщений: от классического чата до динамических элементов интерфейса, таких как полоса босса или заголовки, используя систему форматирования MiniMessage.

Плагин поддерживает четыре типа объявлений:

• Чат (chat)
• Полоса действий (actionbar)
• Заголовок (title)
• Полоса босса (bossbar)

Для визуального оформления используется стандарт MiniMessage, который поддерживает теги типа <gold>, <bold> и <gradient:red:gold>. Дополнительно реализован кастомный тег <centered:Your text> для центрирования текста в выводе.

/announce <chat|actionbar|title|bossbar> <message...>
/announcer reload

Команда /announce <message> автоматически использует тип по умолчанию, указанный в конфигурации (по умолчанию — чат). Для управления правами доступа используются следующие узлы:

• announcer.command — использование базовой команды /announce (по умолчанию доступно операторам)
• announcer.reload — использование команды /announcer reload
• announcer.chat — право на отправку объявлений в чат
• announcer.actionbar — право на отправку объявлений в action bar
• announcer.title — право на отправку объявлений в заголовок
• announcer.bossbar — право на отправку объявлений в полосу босса

Конфигурация плагина позволяет детально настроить шаблоны для каждого типа вывода, интервалы повторения и условия доставки сообщений.

Основные параметры в config.yml:

• templates.chat — MiniMessage шаблон для чата
• templates.actionbar — шаблон для action bar
• templates.title — параметры title, subtitle, fade_in, stay, fade_out
• templates.bossbar — параметры message, color, overlay
• settings.default_type — тип объявления по умолчанию
• targets. — фильтры по мирам (worlds) и группам прав (permission)

В секции schedule можно задать автоматические объявления с указанием интервала и целевой группы:

schedule:
  - type: chat
    message: "<gold>Remember to join our Discord!</gold>"
    interval_seconds: 300
    target: "all"
  - type: bossbar
    message: "<red>Server restarting soon</red>"
    interval_seconds: 600
    target: "all"
    bossbar_duration_seconds: 10

Announcer поддерживает интеграцию с PlaceholderAPI для динамического отображения данных игроков в сообщениях. Плагин спроектирован для современных версий Bukkit API (например, Paper 1.21.x), но включает механизмы обратной совместимости для старых серверов: на версиях 1.8 функционал может быть ограничен чатом в местах, где современные API недоступны.

Для поддержки переменных %placeholders% необходимо установить PlaceholderAPI.