Broadcast++

The modern broadcast plugin for Minecraft servers. One YAML file for every announcement across chat, titles, action bars, boss bars, and multi-channel scenes — on Paper, Spigot, Velocity, and Folia.

What is Broadcast++

A single, unified primitive — scenes — runs every automated or triggered broadcast on your server. A scene has one trigger (join, interval, daily, or manual) and one or more steps. Each step can fire multiple channels at the same instant or chain them on a timeline. Drop the jar in, edit one line, /bc reload, done.

Why server owners pick it

• One primitive for everything. Stop juggling welcome.yml, rotation.yml, schedule.yml. Every broadcast is a scene with the same shape.
• Auto-brand your broadcasts. Set server-name: once; every chat broadcast gets a gradient prefix. Change server-color: to restyle — no MiniMessage knowledge required.
• Animated boss bars. Drain or fill the bar over a duration as a visual countdown. No custom scheduler code.
• Proxy-aware. On Velocity, filter scenes by backend with servers: [lobby] to target broadcasts per-server.
• Reload-safe. /bc validate dry-runs your config before applying. If the new config has errors, the old one stays live.
• Plug-and-play. Ships with five working presets and three working scenes. Useful on boot with zero edits.

Scenes — one primitive for everything

scenes:
  welcome-sequence:
    description: "On-join cinematic"
    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 }

Triggers — pick one per scene

Filters — gate delivery per-audience

vip-event:
  every: 10m
  min-players: 5
  max-players: 80
  worlds: [survival, minigames]   # Paper/Spigot only
  servers: [lobby]                 # Velocity only (backend filter)
  permission: broadcastplusplus.vip
  steps:
    - { at: 0s, chat: vip-tip }

All filters are optional. Set at scene level (applies to every step) or at preset level (applies just to that preset). When both are set, the stricter value wins.

Timeline vs. cycle

• Timeline (default) — every step fires at its at: offset from scene start.
• cycle: true — one step fires per trigger tick, round-robin. Use with every: for classic tip rotations.
• cycle: true + random: true — shuffled rotation instead of round-robin.

Branding in two lines

server-name: "YourServer"
server-color: ["#00C8FF", "#5C78FF"]   # gradient — two colors
# server-color: "#FFAA00"              # solid — one color
# server-color: "red"                  # named color — works too

That's it. The chat prefix is auto-synthesized from your server name and color. Every chat broadcast is stamped with it, and <server> resolves to the same value anywhere in presets.

Need a custom prefix layout? Set chat.prefix: explicitly and it overrides the auto-brand.

Animated boss bars

bossbars:
  presets:
    countdown:
      text: "<red><bold>Event starts in 10 seconds</bold></red>"
      color: RED
      overlay: PROGRESS
      progress: { from: 1.0, to: 0.0 }
      duration: 10s

Drain the bar to zero over 10 seconds. Or progress: { from: 0.0, to: 1.0 } for a fill. Static bars — just a number.

Commands

Ad-hoc broadcasts — a single unquoted word looks up a preset; multi-word or "quoted" arguments render as MiniMessage text. /bc chat "<red>Server restart in 5m</red>" works without touching the config.

Permissions

Three nodes. All default to op.

Placeholders

Usable in any preset text, per-recipient at render time:

Formatting uses MiniMessage. Gradients, hex colors, bold / italic, clickable URLs, hover tooltips — all supported. Preview live at webui.advntr.dev.

Studio GUI

/bc studio opens a 54-slot inventory UI on Paper and Spigot:

• Six tabs: Chat · Titles · Action bars · Boss bars · Scenes · Status
• Left-click a preset → preview it to yourself
• Shift-click → broadcast it to everyone
• Status tab shows the scene-trigger breakdown at a glance
• Admins get a reload button in the corner

Velocity doesn't support inventory GUIs — use commands there.

Platform support

Install

1. Download the jar that matches your platform from the Versions page.
2. Drop it into your server's plugins/ folder (or the proxy's plugins/ for Velocity).
3. Start the server.
4. Open plugins/BroadcastPlusPlus/config.yml and change server-name: at the top.
5. /bc reload.

The shipping config comes with five chat presets, one title, two action bars, one boss bar, and three scenes already wired up — join a fresh server and the welcome sequence fires on first connect so you can see the plugin working immediately.

Migrating from older configs

The deprecated rotation: and join: top-level sections still parse on load. The plugin detects them, synthesizes equivalent scenes in-memory, and logs one deprecation warning pointing at the new format. Nothing breaks — move your config to the scenes: shape at your own pace.

Links

• Discord — discord.gg/aJqqs2hYQJ
• MiniMessage docs — docs.advntr.dev/minimessage/format.html
• Hex color picker — htmlcolorcodes.com/color-picker