高级插件 CwBroadcastPro – 全服喊话插件 - 👌简单上手丨✅️支持 BungeeCord / VC端丨支持CE物品丨像网游一样⭐BOSS条大喇叭⭐ 2.5.3

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 供其他插件调用，轻松给予道具或触发喊话。

---

指令与权限​

其他权限：

• 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: false

# 喊话时执行的命令（控制台执行）
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点击输入自定义内容"
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粗体

BossBar 也会正确显示颜色，但受限于 BossBar 本身（只能显示单色背景），文本颜色仍会按解析结果展示。

---

使用指南​

基础用法​

• 持有大喇叭：右键单击打开 GUI 菜单，点击预设消息或“自定义喊话内容”输入消息。
• 直接指令：拥有 cwbc.gb 权限的玩家可使用 /cwbc gb <消息> 快速喊话（不消耗道具，可配置 BossBar 开关）。
• BossBar 控制：GUI 预设消息的 bossbar 字段独立控制；指令喊话由 command-broadcast-bossbar 控制。

自定义占位符与链接​

在消息内容或广播格式中插入 %cwbc_<key>%（如 %cwbc_qunliao%），插件会自动替换为可点击文本，点击打开配置的 URL。您可在 custom-placeholders 中定义任意多个。

跨服设置​

1. 在所有子服务器安装相同版本的插件。
2. 配置 cross-server.enabled: true，并统一 channel 名称。
3. BungeeCord 端无需安装插件，只需开启 plugin_messages: true（默认开启）。
4. 任一子服喊话后，其他子服会收到聊天栏消息，若发送端启用 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 中使用头颅

---

安装与更新​

1. 将 CwBroadcastPro.jar 放入服务器的 plugins 文件夹。
2. 启动服务器，插件会自动生成 config.yml。
3. 根据需求修改配置后，执行 /cwbc reload 重载（部分配置需重启生效）。
4. 若使用跨服，请在所有子服务器重复上述步骤。