Broadcast++
Minecraft 服务器的现代广播插件。 一个 YAML 文件即可管理跨聊天、标题、操作栏、Boss 栏和多频道场景的所有公告——支持 Paper、Spigot、Velocity 和 Folia。
什么是 Broadcast++
一个统一的基元——场景(scenes)——运行服务器上的所有自动或触发式广播。一个场景包含一个触发器(加入、间隔、每日或手动)和一个或多个步骤。每个步骤可以同时向多个频道发送消息,也可以按时间线依次执行。将 jar 包放入插件文件夹,编辑一行配置,执行 /bc reload,完成。
为什么服务器管理员选择它
- 万物皆为一原语。 不再需要同时维护
welcome.yml、rotation.yml、schedule.yml。每个广播都是一个具有相同结构的场景。
- 自动品牌化你的广播。 设置一次
server-name:;所有聊天广播都会获得渐变前缀。更改 server-color: 即可重新设计样式——无需了解 MiniMessage。
- 动画 Boss 栏。 在指定时间内让进度条排空或填充,作为视觉倒计时。无需编写自定义调度器代码。
- 感知代理服务器。 在 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" |
每天 UTC 时间 09:00 触发一次 |
daily-at: "09:00 local" |
每天在服务器系统时区的时间触发一次 |
daily-at: "09:00 America/Los_Angeles" |
每天在任何 IANA 时区的时间触发一次 |
| (无) |
仅手动触发——通过 /bc scene <name> 执行 |
过滤器——按受众控制投递
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: 它将覆盖自动品牌化。
动画 Boss 栏
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 <preset|"text"> |
send |
广播聊天预设或临时 MiniMessage |
/bc title <preset|"text"> |
send |
显示标题 |
/bc actionbar <preset|"text"> (别名 ab) |
send |
显示操作栏 |
/bc bossbar <preset|"text"> (别名 bb) |
send |
显示 Boss 栏 |
/bc scene <preset> |
send |
按需播放场景 |
/bc to <player> <channel> <preset|"text"> |
send |
发送给单个玩家(员工私信、管理通知) |
/bc preview <type> <preset|"text"> |
send |
仅发送给自己——在广播前进行测试 |
/bc list [type] |
send |
列出所有预设,可按频道筛选 |
/bc validate |
admin |
试运行配置而不应用它 |
/bc reload |
admin |
重新加载 config.yml(出错时拒绝并保留旧的在线配置) |
/bc studio (别名 gui) |
studio |
打开游戏内的 Studio GUI |
临时广播 —— 单个未加引号的单词会查找预设;多单词或 "加引号" 的参数会渲染为 MiniMessage 文本。/bc chat "<red>服务器将在 5 分钟后重启</red>" 无需修改配置即可工作。
权限
三个节点。默认均授予 OP。
| 节点 |
授予 |
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。支持渐变、十六进制颜色、粗体/斜体、可点击的 URL、悬停工具提示等。可在 webui.advntr.dev 实时预览。
Studio GUI
/bc studio 在 Paper 和 Spigot 上打开一个包含 54 个槽位的库存界面:
- 六个标签页:聊天 · 标题 · 动作条 · Boss 条 · 场景 · 状态
- 左键点击预设 → 仅对自己进行预览
- Shift+点击 → 向所有人广播
- 状态标签页可一目了然地查看场景触发分解情况
- 管理员可在角落找到重载按钮
Velocity 不支持库存 GUI —— 请在此使用命令。
平台支持
| 平台 |
支持情况 |
备注 |
| Paper 1.20.1+ |
✅ 完整支持 |
原生 Adventure,体积最小的 jar |
| Folia |
✅ 完整支持 |
区域感知调度器,无运行时分支 |
| Spigot 1.20.1 – 26.x |
✅ 完整支持 |
捆绑 Adventure,可直接用于旧版环境 |
| Velocity 3.3+ |
✅ 完整支持 |
代理级广播 + 按后端 servers: 过滤 |
安装
- 从 Versions 页面下载与你的平台匹配的 jar 文件。
- 将其放入服务器的
plugins/ 文件夹中(若为 Velocity,则放入代理的 plugins/ 文件夹)。
- 启动服务器。
- 打开
plugins/BroadcastPlusPlus/config.yml,并将顶部的 server-name: 修改为你的服务器名称。
- 执行
/bc reload。
随附的配置已预置了五个聊天预设、一个标题、两个动作条、一个 Boss 条以及三个场景 —— 加入一个新服务器后,首次连接时即可自动播放欢迎序列,以便你立即看到插件生效。
从旧配置迁移
弃用的顶层部分 rotation: 和 join: 在加载时仍会被解析。插件会检测它们,在内存中合成等效的场景,并记录一条指向新格式的弃用警告。不会导致任何问题 —— 你可按自己的节奏将配置迁移至 scenes: 结构。
链接
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
| Trigger |
Fires |
on-join: true |
Once per player when they connect |
every: 5m |
Every 5 minutes server-wide |
daily-at: "09:00" |
Once a day at 09:00 UTC |
daily-at: "09:00 local" |
Once a day in the server's system timezone |
daily-at: "09:00 America/Los_Angeles" |
Once a day in any IANA timezone |
| (none) |
Manual only — fires via /bc scene <name> |
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
| Command |
Permission |
Purpose |
/bc chat <preset|"text"> |
send |
Broadcast a chat preset or ad-hoc MiniMessage |
/bc title <preset|"text"> |
send |
Show a title |
/bc actionbar <preset|"text"> (alias ab) |
send |
Show an action bar |
/bc bossbar <preset|"text"> (alias bb) |
send |
Show a boss bar |
/bc scene <preset> |
send |
Play a scene on demand |
/bc to <player> <channel> <preset|"text"> |
send |
Send to one player (staff DMs, moderation notices) |
/bc preview <type> <preset|"text"> |
send |
Send only to yourself — test before broadcasting |
/bc list [type] |
send |
List every preset, optionally filtered by channel |
/bc validate |
admin |
Dry-run the config without applying it |
/bc reload |
admin |
Reload config.yml (rejects on errors, keeps old live) |
/bc studio (alias gui) |
studio |
Open the in-game Studio GUI |
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.
| Node |
Grants |
broadcastplusplus.send |
All /bc broadcasts + preview |
broadcastplusplus.studio |
/bc studio GUI access |
broadcastplusplus.admin |
Everything above + /bc reload + /bc validate |
Placeholders
Usable in any preset text, per-recipient at render time:
| Tag |
Value |
<player> |
Recipient's in-game name |
<online> |
Current online player count |
<server> |
Your server-name: value |
<time> |
Server time, HH:mm |
<date> |
Server date, yyyy-MM-dd |
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
| Platform |
Support |
Notes |
| Paper 1.20.1+ |
✅ Full |
Native Adventure, smallest jar |
| Folia |
✅ Full |
Region-aware schedulers, no runtime branching |
| Spigot 1.20.1 – 26.x |
✅ Full |
Bundles Adventure, drop-in on legacy setups |
| Velocity 3.3+ |
✅ Full |
Proxy-wide broadcasts + per-backend servers: filter |
Install
- Download the jar that matches your platform from the Versions page.
- Drop it into your server's
plugins/ folder (or the proxy's plugins/ for Velocity).
- Start the server.
- Open
plugins/BroadcastPlusPlus/config.yml and change server-name: at the top.
/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
评论 0
登录后参与评分
还没有评论,来抢沙发吧