Ancient-Broadcast

插件

· 作者 mysticalcraft-ancientvipers

AncientBroadcast。轻松清理,无卡顿!

0 本站下载 0 关注 更新于 11 个月前

最新 1.0.3 · 1.21.11 · Paper

一键开服(送7天)

? Ancient-Broadcast

Ancient-Broadcast 是一个现代、轻量且高度可配置的广播插件,专为 Paper / Spigot 1.20+ 构建,基于 Java 21。
✨ 旨在实现零延迟、可扩展,并方便小型和大型服务器的管理。

Ancient-Broadcast 允许服务器管理员向所有在线玩家发送专业外观的广播消息,可以按预定计划自动发送 ⏱️,也可以通过命令手动触发 ?‍?。所有内容均可在游戏内或通过配置文件进行设置。


? Ancient-Broadcast 的功能

Ancient-Broadcast 会定期向所有在线玩家 ? 发送消息(广播)。

每条广播始终采用相同的整洁格式 ?:

  • ➖ 一个空行作为间隔
  • ? 广播消息块(单行或多行组合)
  • ➖ 一个空行作为间隔

? 可选地,在发送广播时为所有玩家播放一段音效。
这有助于保持聊天窗口的可读性并防止刷屏 ?。


✨ 功能特性(完整说明)

⏱️ 定时广播

每条广播都有自己独立的调度器,彼此独立运行。
支持的间隔单位:

  • ⏲️ 秒 (SECONDS)
  • ⏰ 分钟 (MINUTES)
  • ? 小时 (HOURS)

这允许你同时以不同的间隔运行多条广播。


? 轮换系统

如果一条广播包含多条消息或多个组合组,可以启用轮换功能。

轮换模式:

  • ? 顺序 (SEQUENTIAL) – 按顺序发送消息或组合组
  • ? 随机 (RANDOM) – 每次随机选择一条消息或一个组合组

轮换由全局控制,可以启用、禁用或在模式之间切换。


⭐ 组合广播(多行作为一条广播)

组合广播允许多行链接在一起,并作为一个完整的广播块发送。

? 轮换是按组合组进行的,而不是按单行进行。

组合广播非常适合用于:

  • ? 多行提示
  • ? 公告
  • ?️ 服务器信息块
  • ? 包含可点击链接的消息

发送时,组合广播上方和下方各有一个空行间隔。


? 颜色与格式化

Ancient-Broadcast 支持现代和经典两种格式化系统。

? 完全支持 MiniMessage,包括颜色、渐变、格式化和点击事件。

? 也支持 Minecraft 及颜色代码:

  • &0 – &9
  • &a – &f
  • &l 粗体
  • &o 斜体
  • &n 下划线
  • &m 删除线
  • &k 随机字符
  • &r 重置
  • ? 使用 &#RRGGBB 格式的 HEX 颜色

MiniMessage 和 & 颜色代码可以在同一条消息中混合使用。


? 可点击链接与网站

支持使用 MiniMessage 点击事件 ?️ 创建可点击链接。

这允许链接到:

  • ? 网站
  • ? Discord 邀请链接
  • ? 网络商店
  • ? 任何外部 URL

? 音效

每条广播都可以选择性地播放音效 ?。

音效功能:

  • ? 为每条广播启用或禁用音效
  • ? 为每条广播选择自定义音效
  • ? 自定义音量
  • ?️ 自定义音调
  • ?️ 全局默认音效

broadcast-now 命令也使用默认音效。

? 首次启动时,插件会自动在插件文件夹中生成 sounds.yml 文件。
该文件包含配置或命令中可以使用的所有有效音效名称。


? PlaceholderAPI 支持

如果安装了 PlaceholderAPI,占位符将自动生效 ?。

示例:

  • %player_name%
  • %vault_eco_balance%

占位符是按玩家解析的,意味着每位玩家看到的数据都是自己的 ?。

PlaceholderAPI 是可选的——即使未安装,插件也能完美运行。


⚡ 性能与优化

Ancient-Broadcast 经过优化,以实现快速且无延迟 ?:

  • ⚙️ 使用 Paper 调度器
  • ? 无阻塞操作
  • ? 缓存消息解析
  • ? 仅在安装且需要时使用 PlaceholderAPI
  • ?️ 安全的音效解析(兼容 Paper 1.21+)

? 依赖要求

  • ☕ Java 21
  • ? Paper / Spigot 1.20+(推荐使用 Paper)
  • ? 可选:PlaceholderAPI

? 安装指南

1️⃣ 下载 Ancient-Broadcast jar 文件
2️⃣ 将其放入服务器的 plugins 文件夹
3️⃣ 启动服务器一次(生成 config.yml 和 sounds.yml)
4️⃣ 编辑 plugins/Ancient-Broadcast/config.yml
5️⃣ 使用 /ab reload 应用更改
6️⃣ 使用 /ab toggle 全局启用广播

⚠️ 插件默认处于禁用状态。


? 权限

所有命令都需要 OP 权限或以下权限 ?:

ancientbroadcast.admin

默认:OP


?‍? 命令列表(完整说明)

? 通用

  • /ab help – ? 显示所有可用命令
  • /ab reload – ? 重新加载配置文件
  • /ab toggle – ? 全局启用或禁用开关
  • /ab list – ? 列出所有广播及其状态

? 广播管理

  • /ab add <id> – ➕ 创建新广播
  • /ab remove <id> – ❌ 删除广播
  • /ab enable <id> – ✅ 启用广播
  • /ab disable <id> – ? 禁用广播

✏️ 消息编辑

  • /ab setmessage <id> <message> – ✍️ 设置单条消息(覆盖组合组和消息)
  • /ab addline <id> <message> – ➕ 添加轮换的单行消息
  • /ab clearlines <id> – ? 清除轮换消息

⭐ 组合广播管理

  • /ab addgroup <id> – ? 添加新的空组合组
  • /ab addgroupline <id> <groupIndex> <message> – ? 向组合组添加一行(groupIndex 从 0 开始)
  • /ab listgroups <id> – ? 列出所有组合组及行数

⏲️ 间隔与调度器

  • /ab setinterval <id> <value> <SECONDS|MINUTES|HOURS>

? 音效

  • /ab setsound <id> <on|off> [sound] [volume] [pitch]
  • /ab defaultsound <on|off> [sound] [volume] [pitch]

? 轮换

  • /ab rotation <on|off>
  • /ab setmode <SEQUENTIAL|RANDOM>

? 测试与即时广播

  • /ab test <id> – ⚡ 立即发送下一条广播
  • /ab broadcastnow <message> – ? 发送一次性广播

⚙️ 配置概览

配置文件包含以下部分 ?:

  • ? 全局启用开关
  • ? 旋转设置(启用状态与模式)
  • ? 默认声音设置(启用、音效、音量、音调)
  • ? 广播定义

每个广播包含:

  • ✅ 启用开关
  • ⏱️ 间隔值及单位
  • ? 声音设置
  • ? 消息、消息列表或分组

消息类型:

  • ? message – 单行广播
  • ? messages – 循环播放的单行广播
  • ⭐ groups – 作为整体发送的循环多行广播

如果定义了分组,则忽略 message 和 messages。


❤️ 支持

需要帮助、发现错误或有任何功能建议??️

  • ? 在 Modrinth 上提交 Issue
  • ? 或直接联系作者

祝您使用愉快 Ancient-Broadcast ?

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源