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: 结构。
链接
- Discord — discord.gg/aJqqs2hYQJ
- MiniMessage 文档 — docs.advntr.dev/minimessage/format.html
- 十六进制颜色选择器 — htmlcolorcodes.com/color-picker
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
自定义你的Minecraft头像!
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧