- 版权类型
- 原创
- 插件中文名称
- 全服喊话 - 全服广播
- 插件英文名称
- CwBroadcastPro
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- 其他核心
- 语言支持
- 中文(简体)
- 前置组件
- 可选:
PlaceholderAPI – 解析占位符(强烈推荐)
Vault – 经济系统
ItemsAdder / CraftEngine – 自定义物品与材质
HeadDatabase – 支持 GUI 中使用头颅
- 适配版本(Java)
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
CwBroadcastPro – 全服喊话插件 (Paper 1.21+)
CwBroadcastPro 是 【全服大喇叭插件】Broadcast 重构全面升级版 支持 MiniMessage 和 Legacy 颜色代码(<yellow> / &e),集成了跨服(BungeeCord / Velocity)、BossBar 通告、PlaceholderAPI 变量、自定义可点击链接、经济系统(Vault)、冷却与道具消耗,并提供直观的 GUI 菜单。插件旨在为服务器提供灵活、美观、可扩展的全局广播体验。
功能概览
智能颜色解析:自动识别 MiniMessage(<red>、<gradient>)和 Legacy(&a、§c)颜色代码,无需配置切换。
多方式喊话:通过指令 /cwbc gb或 GUI 菜单发送全服消息。
可消耗道具:使用“大喇叭”作为喊话消耗品(支持 CraftEngine / ItemsAdder 自定义物品)。
冷却与经济:支持独立冷却时间(毫秒)和 Vault 金币扣除。
BossBar 通知:支持聊天栏与 BossBar 双模式广播,并可独立控制指令/GUI 的 BossBar 开关。
跨服广播:无缝转发至 BungeeCord / Velocity 下所有子服务器,并同步 BossBar 显示。
PlaceholderAPI 集成:支持玩家名称、称号、消息内容中的任意 PAPI 占位符。
自定义可点击占位符:如 %cwbc_qunliao%可渲染为可点击的链接(支持 hover 提示)。
完全配置化 GUI:标题、大小、每个按钮的材质(支持原版 / ItemsAdder / CraftEngine / HeadDatabase)、槽位、Lore 均可自定义。
高性能异步处理:跨服通信、冷却清理等均优化,不影响主线程。
API 开放:提供 BroadcastAPI供其他插件调用,轻松给予道具或触发喊话。
游戏内图片预览
指令与权限
[th]
指令
[/th][th]
权限
[/th][th]
说明
[/th]
[td]
/cwbc help[/td][td]默认所有玩家[/td][td]显示帮助信息[/td][td]/cwbc gb <消息>[/td][td]cwbc.gb[/td][td]直接发送全服喊话(可通过配置开关 BossBar)[/td][td]/cwbc item give [数量] [玩家][/td][td]cwbc.item.self(给自己)cwbc.item.other(给他人)[/td][td]获取或给予喊话大喇叭[/td][td]/cwbc reload[/td][td]cwbc.reload[/td][td]重载配置文件[/td]其他权限:
cwbc.bypass.cooldown– 跳过冷却cwbc.bypass.cost– 跳过经济扣除
配置文件(config.yml)
完整配置示例及说明:yaml
# ==================== 基础设置 ====================
broadcast-item:
material: PAPER # 备用原版材质
itemsadder-material: "wupin_qingbaoshi" # ItemsAdder 物品 ID(可选)
craftengine-material: "cyly_server:wupin_dalaba" # CraftEngine 物品 ID(可选)
name: "§6全服喊话喇叭"
lore:
- "§7右键打开喊话菜单"
- "§7用于全服喊话的消耗品"
- "§e一次性物品,使用后消失"
cooldown-time: 30000 # 冷却时间(毫秒)
economy:
enabled: true
cost: 10.0 # 每次喊话扣除金币(需 Vault)
# 广播格式(支持 MiniMessage / Legacy 颜色自动解析)
broadcast-format: "§6[全服喇叭] %title_current% §e{player}§f: {message}"
bossbar-format: "§6[全服喇叭] %title_current% §e{player}§f: {message}"
bossbar-color: YELLOW
bossbar-style: SOLID
bossbar-display-time: 5 # 显示秒数
# 指令喊话是否启用 BossBar(单独控制)
command-broadcast-bossbar: true
# 喊话时执行的命令(控制台执行)
on-broadcast-commands: []
# - "say 玩家 {player} 使用了全服喇叭: {message}"
# ==================== 跨服设置 ====================
cross-server:
enabled: true
channel: "BroadcastChannel" # 所有子服必须统一
server-name: "生存服" # 本服显示名称
# ==================== 自定义可点击占位符 ====================
custom-placeholders:
qunliao:
display: "§bQQ群:123456"
url: "https://qm.qq.com/xxx"
hover: "§a点击加入QQ群"
wangzhan:
display: "§d官方网站"
url: "https://www.example.com"
hover: "§a点击访问官网"
# ==================== GUI 菜单配置 ====================
gui:
title: "§6全服喊话系统"
size: 27
background:
material: "GRAY_STAINED_GLASS_PANE"
name: " "
lore: []
items:
trading:
slot: 11
material: "GOLD_INGOT" # 支持原版、ia:、ce:、head:
name: "§6交易消息"
lore:
- "§7点击发送交易喊话"
message: "有人要交易吗?我有很多好东西!"
bossbar: false
group:
slot: 12
material: "DIAMOND"
name: "§b组队消息"
lore:
- "§7点击发送组队喊话"
message: "有人一起组队下副本吗?"
bossbar: true
custom:
slot: 13
material: "WRITABLE_BOOK"
name: "§e自定义喊话内容"
lore:
- "§7点击输入自定义内容"
bossbar: true
getitem:
slot: 15
material: "NETHER_STAR"
name: "§b获取喊话喇叭"
lore:
- "§7点击获取一个喇叭"
颜色代码与格式
插件 自动识别 并正确解析以下两种格式(无需配置切换):- MiniMessage(推荐):
<yellow>、<red>、<gradient:red:blue>、<bold>等。支持渐变、装饰、点击事件等高级功能。 - Legacy(传统):
&a或§a(§符号在配置文件中可直接输入,游戏中需使用&)。
/cwbc gb <yellow>黄色文字 <red>红色 <gradient:red:blue>渐变/cwbc gb &a绿色 &c红色 &l粗体
使用指南
基础用法
- 持有大喇叭:右键单击打开 GUI 菜单,点击预设消息或“自定义喊话内容”输入消息。
- 直接指令:拥有
cwbc.gb权限的玩家可使用/cwbc gb <消息>快速喊话(不消耗道具,可配置 BossBar 开关)。 - BossBar 控制:GUI 预设消息的
bossbar字段独立控制;指令喊话由command-broadcast-bossbar控制。
自定义占位符与链接
在消息内容或广播格式中插入%cwbc_<key>%(如 %cwbc_qunliao%),插件会自动替换为可点击文本,点击打开配置的 URL。您可在 custom-placeholders 中定义任意多个。跨服设置
- 在所有子服务器安装相同版本的插件。
- 配置
cross-server.enabled: true,并统一channel名称。 - BungeeCord 端无需安装插件,只需开启
plugin_messages: true(默认开启)。 - 任一子服喊话后,其他子服会收到聊天栏消息,若发送端启用 BossBar,则接收端也会同步 BossBar。
开发者 API
BroadcastAPI 提供静态方法供其他插件调用:java
// 给予玩家喇叭
BroadcastAPI.giveBroadcastItem(Player player, int amount);
// 创建喇叭物品堆
ItemStack item = BroadcastAPI.createBroadcastItem(int amount);
// 检查玩家是否有喇叭
boolean has = BroadcastAPI.hasBroadcastItem(Player player);
// 获取玩家拥有的喇叭数量
int count = BroadcastAPI.getBroadcastItemCount(Player player);
// 消耗玩家一个喇叭(成功返回 true)
boolean consumed = BroadcastAPI.consumeBroadcastItem(Player player);
🛠 插件依赖
- 必须:Paper 1.21+ 服务端(或兼容派生端)
- PlaceholderAPI – 解析占位符(强烈推荐)
- Vault – 经济系统
- ItemsAdder / CraftEngine – 自定义物品与材质
- HeadDatabase – 支持 GUI 中使用头颅
安装与更新
- 将
CwBroadcastPro.jar放入服务器的plugins文件夹。 - 启动服务器,插件会自动生成
config.yml。 - 根据需求修改配置后,执行
/cwbc reload重载(部分配置需重启生效)。 - 若使用跨服,请在所有子服务器重复上述步骤。