? 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 ?
? Ancient-Broadcast
Ancient-Broadcast is a modern, lightweight, and highly configurable broadcast plugin for Paper / Spigot 1.20+, built with Java 21.
✨ Designed to be lag-free, scalable, and easy to manage for both small and large servers.
Ancient-Broadcast allows server owners to send professional-looking broadcasts to all online players, either automatically on a schedule ⏱️ or manually via commands ??. Everything can be configured in-game or via the configuration file.
? What Ancient-Broadcast does
Ancient-Broadcast periodically sends messages (broadcasts) to all online players ?.
Every broadcast is always sent in the same clean format ?:
- ➖ one empty spacer line
- ? the broadcast message block (single-line or multi-line group)
- ➖ one empty spacer line
? Optionally, a sound is played for all players when the broadcast is sent.
This keeps chat readable and prevents spam ?.
✨ Features (complete and explained)
⏱️ Scheduled broadcasts
Each broadcast has its own scheduler and runs independently from others.
Supported interval units:
- ⏲️ SECONDS
- ⏰ MINUTES
- ? HOURS
This allows you to run multiple broadcasts at different intervals at the same time.
? Rotation system
If a broadcast contains multiple messages or multiple groups, rotation can be enabled.
Rotation modes:
- ? SEQUENTIAL – messages or groups are sent in order
- ? RANDOM – a random message or group is selected each time
Rotation is controlled globally and can be enabled, disabled, and switched between modes.
⭐ Grouped broadcasts (multi-line as ONE broadcast)
Grouped broadcasts allow multiple lines to be linked together and sent as one complete broadcast block.
? Rotation happens per group, not per line.
Grouped broadcasts are ideal for:
- ? tips with multiple lines
- ? announcements
- ?️ server information blocks
- ? messages containing clickable links
When sent, a grouped broadcast appears between one spacer line above and one spacer line below.
? Colors & formatting
Ancient-Broadcast supports both modern and classic formatting systems.
? MiniMessage is fully supported, including colors, gradients, formatting, and click events.
? Minecraft & color codes are also supported:
- &0 – &9
- &a – &f
- &l bold
- &o italic
- &n underline
- &m strikethrough
- &k magic
- &r reset
- ? HEX colors using &#RRGGBB
MiniMessage and & color codes can be mixed in the same message.
? Clickable links & websites
Clickable links are supported using MiniMessage click events ?️.
This allows linking:
- ? websites
- ? Discord invites
- ? web shops
- ? any external URL
? Sounds
Each broadcast can optionally play a sound ?.
Sound features:
- ? enable or disable sounds per broadcast
- ? choose a custom sound per broadcast
- ? custom volume
- ?️ custom pitch
- ?️ a global default sound
The default sound is also used by the broadcast-now command.
? On first startup, the plugin automatically generates a sounds.yml file in the plugin folder.
This file contains all valid sound names you can use in the configuration or commands.
? PlaceholderAPI support
If PlaceholderAPI is installed, placeholders work automatically ?.
Examples:
%player_name%
%vault_eco_balance%
Placeholders are resolved per player, meaning each player sees their own data ?.
PlaceholderAPI is optional — the plugin works perfectly without it.
⚡ Performance & optimization
Ancient-Broadcast is optimized to be fast and lag-free ?:
- ⚙️ uses the Paper scheduler
- ? no blocking operations
- ? cached message parsing
- ? PlaceholderAPI only used if installed and needed
- ?️ safe sound resolution (Paper 1.21+ compatible)
? Requirements
- ☕ Java 21
- ? Paper / Spigot 1.20+ (Paper recommended)
- ? Optional: PlaceholderAPI
? Installation
1️⃣ Download the Ancient-Broadcast jar file
2️⃣ Place it into the server plugins folder
3️⃣ Start the server once (generates config.yml and sounds.yml)
4️⃣ Edit plugins/Ancient-Broadcast/config.yml
5️⃣ Apply changes using /ab reload
6️⃣ Enable broadcasting globally using /ab toggle
⚠️ The plugin is disabled by default.
? Permissions
All commands require OP or the following permission ?:
ancientbroadcast.admin
Default: OP
?? Commands (complete list with explanation)
? General
/ab help – ? shows all available commands
/ab reload – ? reloads the configuration file
/ab toggle – ? global enable or disable switch
/ab list – ? lists all broadcasts and their status
? Broadcast management
/ab add <id> – ➕ create a new broadcast
/ab remove <id> – ❌ delete a broadcast
/ab enable <id> – ✅ enable a broadcast
/ab disable <id> – ? disable a broadcast
✏️ Message editing
/ab setmessage <id> <message> – ✍️ set a single message (overwrites groups and messages)
/ab addline <id> <message> – ➕ add a rotating single-line message
/ab clearlines <id> – ? clear rotating messages
⭐ Grouped broadcast management
/ab addgroup <id> – ? add a new empty group
/ab addgroupline <id> <groupIndex> <message> – ? add a line to a group (groupIndex starts at 0)
/ab listgroups <id> – ? list all groups and line counts
⏲️ Interval & scheduler
/ab setinterval <id> <value> <SECONDS|MINUTES|HOURS>
? Sounds
/ab setsound <id> <on|off> [sound] [volume] [pitch]
/ab defaultsound <on|off> [sound] [volume] [pitch]
? Rotation
/ab rotation <on|off>
/ab setmode <SEQUENTIAL|RANDOM>
? Testing & instant broadcasts
/ab test <id> – ⚡ instantly sends the next broadcast
/ab broadcastnow <message> – ? sends a one-time broadcast
⚙️ Configuration overview
The configuration file contains the following sections ?:
- ? Global enabled toggle
- ? Rotation settings (enabled and mode)
- ? Default sound settings (enabled, sound, volume, pitch)
- ? Broadcast definitions
Each broadcast contains:
- ✅ enabled toggle
- ⏱️ interval value and unit
- ? sound settings
- ? message, messages, or groups
Message types:
- ?
message – single-line broadcast
- ?
messages – rotating single-line broadcasts
- ⭐
groups – rotating multi-line broadcasts sent as one block
If groups are defined, message and messages are ignored.
❤️ Support
Need help, found a bug, or have a feature request? ?️
- ? Open an issue on Modrinth
- ? Or contact the author directly
Enjoy using Ancient-Broadcast ?
评论 0
登录后参与评分
还没有评论,来抢沙发吧