Broadcast++

Broadcast++ - это современный плагин для серверов Minecraft, который объединяет все типы объявлений в единой системе. Вместо того чтобы плодить десятки конфигов для чата, тайтлов, экшн-баров и босс-баров, вы управляете всем через один YAML-файл. Поддерживает Paper, Spigot, Velocity и Folia.

На любом сервере Майнкрафт рано или поздно возникает потребность в автоматических объявлениях: приветствие новых игроков, напоминание о правилах, анонсы событий, предупреждения о рестарте. Broadcast++ решает эту задачу элегантно и гибко.

---

Что такое Broadcast++

Единый примитив - сцены - управляет всеми автоматическими или ручными объявлениями на сервере. У сцены есть один триггер (join, интервал, ежедневно или вручную) и один или несколько шагов. Каждый шаг может отправлять сообщения в разные каналы одновременно или выстраивать их во временную шкалу. Просто кидаете jar в папку, правите одну строку, /bc reload - и готово.

---

Почему выбирают Broadcast++

• Один примитив для всего. Хватит жонглировать welcome.yml, rotation.yml, schedule.yml. Каждое объявление - это сцена с одинаковой структурой.
• Автоматический брендинг. Задайте server-name: один раз - каждое чат-сообщение получит градиентный префикс. Меняете server-color: - меняется стиль, без знания MiniMessage.
• Анимированные босс-бары. Полоса убывает или заполняется за заданное время - визуальный таймер. Никакого кастомного кода.
• Поддержка прокси. На Velocity можно фильтровать сцены по бэкенд-серверам через servers: [lobby].
• Безопасная перезагрузка. /bc validate проверяет конфиг на ошибки до применения. Если новый конфиг битый, старый остаётся работать.
• Работает из коробки. В комплекте пять готовых пресетов и три рабочих сцены. Полезно сразу после установки, без правок.

---

Сцены - один примитив для всего

scenes:
  welcome-sequence:
    description: "Приветственная заставка при входе"
    on-join: true
    steps:
      - { at: 0s, chat: welcome }
      - { at: 1s, actionbar: tip-spawn }
      - { at: 3s, title: welcome-back }

  chat-rotation:
    every: 5m
    cycle: true
    steps:
      - { at: 0s, chat: tip-sethome }
      - { at: 0s, chat: rules }
      - { at: 0s, chat: discord }

  daily-reset:
    daily-at: "00:00"
    steps:
      - { at: 0s, chat: server-restart }

Триггеры - выберите один для сцены

Триггер	Срабатывание
on-join: true	Один раз при входе игрока
every: 5m	Каждые 5 минут на всём сервере
daily-at: "09:00"	Раз в день в 09:00 UTC
daily-at: "09:00 local"	Раз в день по системному времени сервера
daily-at: "09:00 America/Los_Angeles"	Раз в день в любом часовом поясе IANA
(нет)	Только вручную через /bc scene <имя>

Фильтры - ограничьте аудиторию

vip-event:
  every: 10m
  min-players: 5
  max-players: 80
  worlds: [survival, minigames]   # Paper/Spigot только
  servers: [lobby]                 # Velocity только (фильтр бэкенда)
  permission: broadcastplusplus.vip
  steps:
    - { at: 0s, chat: vip-tip }

Все фильтры опциональны. Можно задать на уровне сцены (применяется ко всем шагам) или на уровне пресета (только для этого пресета). Если заданы оба, побеждает более строгий.

Таймлайн vs цикл

• Таймлайн (по умолчанию) - каждый шаг срабатывает в свой момент at: от начала сцены.
• cycle: true - один шаг за тик триггера, по кругу. Используйте с every: для классической ротации подсказок.
• cycle: true + random: true - перемешанный порядок вместо строгой очереди.

---

Брендинг в две строки

server-name: "YourServer"
server-color: ["#00C8FF", "#5C78FF"]   # градиент - два цвета
# server-color: "#FFAA00"              # сплошной - один цвет
# server-color: "red"                  # именованный цвет - тоже работает

Всё. Префикс в чате генерируется автоматически из имени сервера и цвета. Каждое чат-объявление получает этот префикс, а <server> подставляет то же значение в любом пресете.

Нужен кастомный макет префикса? Задайте chat.prefix: явно - он переопределит авто-бренд.

---

Анимированные босс-бары

bossbars:
  presets:
    countdown:
      text: "<red><bold>Событие начнётся через 10 секунд</bold></red>"
      color: RED
      overlay: PROGRESS
      progress: { from: 1.0, to: 0.0 }
      duration: 10s

Полоса убывает до нуля за 10 секунд. Или progress: { from: 0.0, to: 1.0 } для заполнения. Статические бары - просто число.

---

Команды

Команда	Право	Назначение
`/bc chat <пресет	"текст">`	send
`/bc title <пресет	"текст">`	send
`/bc actionbar <пресет	"текст">(сокращениеab`)	send
`/bc bossbar <пресет	"текст">(сокращениеbb`)	send
/bc scene <пресет>	send	Запустить сцену вручную
`/bc to <игрок> <канал> <пресет	"текст">`	send
`/bc preview <тип> <пресет	"текст">`	send
/bc list [тип]	send	Список всех пресетов, опционально фильтр по каналу
/bc validate	admin	Проверить конфиг без применения
/bc reload	admin	Перезагрузить config.yml (отклоняет ошибки, старый остаётся)
/bc studio (сокращение gui)	studio	Открыть внутриигровой GUI редактор

Произвольные объявления - одно слово без кавычек ищет пресет, несколько слов в кавычках рендерятся как MiniMessage. /bc chat "<red>Рестарт сервера через 5 минут</red>" работает без правки конфига.

---

Права доступа

Три узла. По умолчанию все у операторов.

Узел	Даёт
broadcastplusplus.send	Все /bc команды + предпросмотр
broadcastplusplus.studio	Доступ к /bc studio GUI
broadcastplusplus.admin	Всё выше + /bc reload + /bc validate

---

Плейсхолдеры

Работают в любом тексте пресета, подставляются для каждого получателя в момент отображения:

Тег	Значение
<player>	Имя игрока
<online>	Текущее количество игроков на сервере
<server>	Значение вашего server-name:
<time>	Серверное время, HH:mm
<date>	Серверная дата, yyyy-MM-dd

Форматирование - MiniMessage. Градиенты, hex-цвета, жирный/курсив, кликабельные ссылки, всплывающие подсказки - всё поддерживается.

---

Studio GUI

/bc studio открывает интерфейс на 54 слота на Paper и Spigot:

• Шесть вкладок: Чат · Тайтлы · Экшн-бары · Босс-бары · Сцены · Статус
• Левый клик по пресету - предпросмотр для себя
• Shift+клик - рассылка всем
• Вкладка статуса показывает разбивку срабатываний сцен
• У администраторов в углу есть кнопка перезагрузки

Velocity не поддерживает инвентарные GUI - используйте команды.

---

Поддерживаемые платформы

Платформа	Поддержка	Примечания
Paper 1.20.1+	✅ Полная	Нативный Adventure, компактный jar
Folia	✅ Полная	Регион-осознанные планировщики, без ветвлений
Spigot 1.20.1 - 26.x	✅ Полная	Встроенный Adventure, работает на старых версиях
Velocity 3.3+	✅ Полная	Объявления на всё прокси + фильтр по бэкендам

---

Установка

1. Скачайте jar, соответствующий вашей платформе, со страницы Versions.
2. Поместите в папку plugins/ сервера (или в plugins/ прокси для Velocity).
3. Запустите сервер.
4. Откройте plugins/BroadcastPlusPlus/config.yml и измените server-name: в начале.
5. /bc reload.

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

---

Миграция со старых конфигов

Устаревшие разделы rotation: и join: всё ещё читаются при загрузке. Плагин обнаруживает их, создаёт эквивалентные сцены в памяти и выводит одно предупреждение о депрекации с указанием на новый формат. Ничего не ломается - переводите конфиг на структуру scenes: в своём темпе.

---

Если вы хотите упростить администрирование сервера и сделать информационные сообщения красивыми и настраиваемыми - Broadcast++ именно то, что нужно. Скачайте плагин и настройте объявления за минуту.