
Easy Announcements 是一款完全可配置的 公告插件,适用于 Paper 26.2 (Java 25),专为生存服务器、SMP 网络、小游戏、阵营、角色扮演社区以及介于两者之间的各种场景而构建。
一条命令,全屏展示:
- 标题和副标题
- 格式化聊天消息
- 动作栏文本
- 动画 Boss 进度条
- 自定义音效(原版或资源包)
- 通过 DiscordSRV 发送 Discord 嵌入卡片
所有内容均由 预设 (Presets) 驱动,因此 /ea -p restart Restarting in 5 minutes 与 /ea -p event Drop party at spawn! 的显示效果截然不同,且无需修改配置文件。
2.0 版新增功能
- 更新支持 Minecraft 26.2 / Paper 26.2 / Java 25
- 预设 (Presets):内置
default、alert、restart、tip、event,可按需添加更多
- 定时公告:按顺序循环播放消息列表
- 更新通知:当 Modrinth 上有针对 你的 Minecraft 版本的新发布时,管理员加入服务器时会收到一条可点击的消息
- LuckPerms:支持
@g <group> 目标选择、前缀和组占位符、基于组的冷却时间、限制以及通过元数据设置默认预设
- PlaceholderAPI:每个占位符针对接收者玩家单独解析,并提供完整的
%easyannouncements_*% 扩展
- DiscordSRV:支持多频道、嵌入/文本/Webhook 模式、角色提及、基于预设的颜色设置,以及绑定 关联的 Minecraft 账号 的 Discord 权限
- 开发者 API:包含事件、自定义显示、自定义目标选择器和自定义占位符
/ea toggle(玩家开关)、/ea preview(预览)、/ea history(历史)、/ea last(最后一条)
- 全面支持 MiniMessage(渐变、悬停、点击),同时也兼容经典的
& 代码
messages.yml 文件,允许编辑所有插件消息
- 自动迁移 1.x 配置文件(旧文件会自动备份)
依赖项与兼容性
| 插件 |
是否必需 |
用途 |
链接 |
| Paper 26.2 |
是 |
Purpur 及其他 Paper 分支也可用。不支持 Spigot(无 Adventure API)。 |
|
| LuckPerms |
可选 |
群组目标选择、前缀占位符、基于组的冷却时间、Discord 账号权限 |
|
| PlaceholderAPI |
可选 |
动态占位符(%player_name%、TPS、经济等)及插件自身的扩展 |
|
| DiscordSRV |
可选 |
向 Discord 发送消息并从 Discord 接收公告 |
|
核心功能
预设 (Presets)
预设是一个完整的外观配置:包括标题、聊天布局、动作栏、Boss 进度条、音效和 Discord 嵌入设置。任何未指定的键都会回退到 default 预设,因此一个新的预设可能只有三行长。
- 使用
-p <name> 为每次公告选择一个预设
- 将预设锁定在权限
easyannouncements.preset.<name> 之后
- 通过元数据为 LuckPerms 组分配其专属的默认预设
- 在运行时从其他插件注册预设
多种显示方式
-
带小数点淡入淡出时间的标题和副标题
-
支持任意行数的聊天布局
-
可在屏幕上停留配置时间的动作栏文本
-
动画 Boss 进度条
- FILL(进度动画)
- DRAIN(倒计时动画)
- PULSE(注意力吸引动画)
- STATIC(静态)
-
任何音效键,包括资源包音效
可以为每个预设关闭任何显示,或使用 --only title,chat 和 --no bossbar 为单次公告关闭特定显示。
灵活的目标选择
@a 所有玩家
<player> 单个玩家
@w <world> 单个世界
@g <group> 一个 LuckPerms 组(包括继承的组)
@p <permission> 拥有指定权限的玩家
@s 你自己
- 可选的全局默认全部模式
- 玩家可以使用
/ea toggle 选择退出,但 --force 仍会强制发送给它们
其他插件可以添加自己的选择器(如 @team、@radius 等)。
定时公告
- 支持任意数量的时间表,每个时间表拥有独立的间隔、预设、目标和消息列表
- 支持顺序或随机播放
- 可设置触发时间表运行的最低玩家数量
- 可选的 Discord 发送功能
/ea schedules 显示下一次运行时间,/ea schedules run <id> 立即触发一次
更新通知
- 在启动时和配置的间隔检查 Modrinth
- 仅报告列出了 你的 Minecraft 版本的发布
- 控制台提示,以及任何拥有
easyannouncements.update 权限的玩家加入时收到的游戏内可点击消息
/ea update 按需检查
LuckPerms 集成
-
@g <group> 针对在线的群组成员
-
%sender_prefix%、%sender_suffix%、%sender_group%、%player_prefix%、%player_group% 占位符,无需 PlaceholderAPI
-
每个群组或用户的元数据键(Meta keys):
easyannouncements.cooldown 公告之间的冷却时间(秒)
easyannouncements.max-length 消息长度限制
easyannouncements.preset 未指定时使用的预设
-
针对已链接 Discord 账号的离线权限检查
-
细粒度节点:easyannouncements.announce、.target.<selector>、.preset.<name>、.format、.bypass.cooldown、.discord、.toggle、.admin
-
旧的 esa.* 节点仍然有效
PlaceholderAPI 集成
- 为接收玩家解析文本中的每一个占位符
- 发送者与接收者之间的关系型占位符(
%rel_...%)
- 内置扩展:
%easyannouncements_last_message%、_last_sender%、_last_preset%、_last_time%、_total%、_muted%、_cooldown%、_update_available%、_latest_version%、_schedule_next_<id>% 等
Discord 集成 (DiscordSRV)
- 通过频道 ID 或 DiscordSRV 频道名称,向一个或多个频道发布
- 支持
embed、text 或 webhook 模式
- 消息内容中支持角色、用户、@everyone 和 @here 提及
- HEX 颜色、缩略图、大图、带玩家头像的作者、页脚、自定义字段
- 按预设配置嵌入颜色、标题和频道覆盖
- 斜杠命令
/announce message [target] [preset]
- 前缀命令
!announce target:world:name preset:alert Your message
- 通过角色 ID、用户 ID、Discord 管理员权限,或具有
easyannouncements.discord 权限的已链接 Minecraft 账号进行权限控制(LuckPerms 可处理此逻辑,即使玩家离线也能生效)
- 已链接的用户显示其 Minecraft 名称作为发送者
- 将命令限制在特定频道,可选自动删除命令消息
开发者 API
将 jar 添加为 compileOnly 依赖项,并设置 softdepend: [EasyAnnouncements]。
EasyAnnouncementsAPI api = EasyAnnouncementsProvider.get();
api.broadcast(Announcement.builder("Boss spawns in <yellow>2 minutes</yellow>")
.source(AnnouncementSource.api("MyBossPlugin"))
.preset("event")
.disableDisplay("bossbar")
.build());
AnnouncementDisplay: 添加你自己的分发渠道(全息图、记分板、Bedrock 表单)
TargetResolver: 添加你自己的选择器
PlaceholderProvider: 添加 %your_placeholder% 值
- 事件:
AnnouncementPreSendEvent(可取消、可编辑)、AnnouncementSentEvent、UpdateAvailableEvent
- 辅助方法:
render()、resolveTargets()、history()、setMuted()
- 也可通过 Bukkit 的
ServicesManager 访问
命令
别名:/ea、/announce、/announcement、/esa、/easyannouncements
| Command |
Description |
/ea <message> |
向所有人广播 |
/ea @w <world> <message> |
单个世界 |
/ea @g <group> <message> |
LuckPerms 群组 |
/ea @p <permission> <message> |
拥有某权限的玩家 |
/ea <player> <message> |
单个玩家 |
/ea preview [-p preset] <message> |
仅自己查看预览 |
/ea presets |
列出预设 |
/ea history [count] |
最近的公告 |
/ea last |
重复上一次公告 |
/ea toggle |
隐藏或显示自己的公告 |
/ea schedules [run <id>] |
列出或运行计划任务 |
/ea update |
检查新版本 |
/ea reload |
重新加载所有配置文件 |
选项:-p <preset>、--silent、--no-discord、--force、--only <displays>、--no <displays>
功能对比
| 功能 |
Easy Announcements |
典型公告插件 |
| Minecraft 26.2 / Java 25 |
是 |
通常已过时 |
| 预设配置 |
支持,无限制 |
罕见 |
| 动画 Boss 进度条 |
是(填充、排空、脉冲、静态) |
罕见 |
| 动作栏 |
是 |
有时支持 |
| 定时公告 |
是,支持按预设时间表和目标发送 |
基础 |
| 群组/权限目标 |
是(LuckPerms) |
不支持 |
| 按世界定向 |
是 |
有限 |
| 玩家退出选项 |
是 |
罕见 |
| 针对你当前版本的更新通知 |
是 |
不支持 |
| DiscordSRV 集成 |
嵌入、文本、Webhook、命令 |
通常无 |
| 通过 LuckPerms 设置 Discord 权限 |
是(关联账户) |
不支持 |
| PlaceholderAPI |
解析并自带扩展 |
有时支持 |
| MiniMessage |
是,可与 & 代码混合使用 |
罕见 |
| 开发者 API |
事件、显示、选择器 |
罕见 |
| 配置迁移 |
自动从 1.x 版本迁移 |
手动 |
使用场景
- 带有排空效果 Boss 进度条的服务器重启倒计时
- 具有自定义外观的 SMP 和活动公告
- 按时间轮换的提示与投票提醒
- 仅限员工查看的通知,使用
@g staff
- 由版主发起的 Discord 到 Minecraft 的公告同步
- 阵营突袭警报与小游戏开始通知
- Boss 战、掉落派对及通过 API 进行自定义插件公告
支持
插件作者:Sketch494。Eciipse Studios。


Easy Announcements is a fully configurable announcement plugin for Paper 26.2 (Java 25) built for survival servers, SMP networks, minigames, factions, roleplay communities and anything in between.
One command, every screen:
- Titles and subtitles
- Formatted chat messages
- Action bar text
- Animated boss bars
- Custom sounds (vanilla or resource pack)
- Discord embeds through DiscordSRV
Everything is driven by presets, so /ea -p restart Restarting in 5 minutes looks completely different from /ea -p event Drop party at spawn! without touching the config in between.
What's new in 2.0
- Updated to Minecraft 26.2 / Paper 26.2 / Java 25
- Presets:
default, alert, restart, tip, event included, add as many as you like
- Scheduled announcements that rotate through a message list
- Update notices: ops get a clickable message on join when a newer release for your Minecraft version is on Modrinth
- LuckPerms:
@g <group> targeting, prefix and group placeholders, per-group cooldowns, limits and default presets through meta
- PlaceholderAPI: every placeholder parsed per receiving player, plus a full
%easyannouncements_*% expansion
- DiscordSRV: multiple channels, embed / text / webhook modes, role pings, per-preset colors, and Discord permissions tied to linked Minecraft accounts
- Developer API with events, custom displays, custom target selectors and custom placeholders
/ea toggle for players, /ea preview, /ea history, /ea last
- MiniMessage support everywhere (gradients, hover, click) alongside classic
& codes
messages.yml so every plugin message is editable
- Automatic migration of 1.x configs (your old files are backed up)
Dependencies & Compatibility
| Plugin |
Required |
Purpose |
Link |
| Paper 26.2 |
Yes |
Purpur and other Paper forks work as well. Spigot is not supported (no Adventure API). |
|
| LuckPerms |
Optional |
Group targeting, prefix placeholders, per-group cooldowns, Discord account permissions |
|
| PlaceholderAPI |
Optional |
Dynamic placeholders (%player_name%, TPS, economy, etc.) and the plugin's own expansion |
|
| DiscordSRV |
Optional |
Post to Discord and announce from Discord |
|
Core Features
Presets
A preset is a complete look: title, chat layout, action bar, boss bar, sound and Discord embed settings. Any key you leave out falls back to the default preset, so a new preset can be three lines long.
- Pick one per announcement with
-p <name>
- Lock presets behind
easyannouncements.preset.<name>
- Give a LuckPerms group its own default preset with meta
- Register presets from other plugins at runtime
Multiple Display Methods
-
Title and subtitle with decimal fade timings
-
Chat layouts with any number of lines
-
Action bar text that stays on screen for a configurable time
-
Animated boss bars
- FILL (progress animation)
- DRAIN (countdown animation)
- PULSE (attention animation)
- STATIC
-
Any sound key, including resource pack sounds
Turn any display off per preset, or per announcement with --only title,chat and --no bossbar.
Flexible Targeting
@a all players
<player> one player
@w <world> one world
@g <group> a LuckPerms group (inherited groups count)
@p <permission> players holding a permission
@s yourself
- Optional default-to-all mode
- Players can opt out with
/ea toggle, --force reaches them anyway
Other plugins can add their own selectors (@team, @radius, ...).
Scheduled Announcements
- Any number of schedules, each with its own interval, preset, target and message list
- Sequential or random order
- Minimum player count before a schedule runs
- Optional Discord posting
/ea schedules shows the next run, /ea schedules run <id> fires one now
Update Notifications
- Checks Modrinth on startup and on a configurable interval
- Only reports releases that list your Minecraft version
- Console notice plus a clickable in-game message for anyone with
easyannouncements.update when they join
/ea update to check on demand
LuckPerms Integration
-
@g <group> targets online members of a group
-
%sender_prefix%, %sender_suffix%, %sender_group%, %player_prefix%, %player_group% placeholders without PlaceholderAPI
-
Meta keys per group or user:
easyannouncements.cooldown seconds between announcements
easyannouncements.max-length message length limit
easyannouncements.preset preset used when none is given
-
Offline permission checks for Discord linked accounts
-
Fine grained nodes: easyannouncements.announce, .target.<selector>, .preset.<name>, .format, .bypass.cooldown, .discord, .toggle, .admin
-
Old esa.* nodes still work
PlaceholderAPI Integration
- Every placeholder in every text is parsed for the receiving player
- Relational placeholders (
%rel_...%) between sender and receiver
- Built in expansion:
%easyannouncements_last_message%, _last_sender%, _last_preset%, _last_time%, _total%, _muted%, _cooldown%, _update_available%, _latest_version%, _schedule_next_<id>% and more
Discord Integration (DiscordSRV)
- Post to one or many channels, by channel ID or DiscordSRV channel name
embed, text or webhook mode
- Role, user, @everyone and @here mentions in the message content
- HEX colors, thumbnail, large image, author with player head, footer, custom fields
- Per-preset embed color, title and channel override
- Slash command
/announce message [target] [preset]
- Prefix command
!announce target:world:name preset:alert Your message
- Permissions by role ID, user ID, Discord administrator, or a linked Minecraft account with
easyannouncements.discord (LuckPerms handles it, even when the player is offline)
- Linked users show their Minecraft name as the sender
- Restrict commands to specific channels, optional auto delete of the command message
Developer API
Add the jar as a compileOnly dependency and softdepend: [EasyAnnouncements].
EasyAnnouncementsAPI api = EasyAnnouncementsProvider.get();
api.broadcast(Announcement.builder("Boss spawns in <yellow>2 minutes</yellow>")
.source(AnnouncementSource.api("MyBossPlugin"))
.preset("event")
.disableDisplay("bossbar")
.build());
AnnouncementDisplay: add your own delivery channel (holograms, scoreboards, Bedrock forms)
TargetResolver: add your own selectors
PlaceholderProvider: add %your_placeholder% values
- Events:
AnnouncementPreSendEvent (cancellable, editable), AnnouncementSentEvent, UpdateAvailableEvent
- Helpers:
render(), resolveTargets(), history(), setMuted()
- Also exposed through Bukkit's
ServicesManager
Commands
Aliases: /ea, /announce, /announcement, /esa, /easyannouncements
| Command |
Description |
/ea <message> |
Announce to everyone |
/ea @w <world> <message> |
One world |
/ea @g <group> <message> |
A LuckPerms group |
/ea @p <permission> <message> |
Players with a permission |
/ea <player> <message> |
One player |
/ea preview [-p preset] <message> |
Show it only to yourself |
/ea presets |
List presets |
/ea history [count] |
Recent announcements |
/ea last |
Repeat the last announcement |
/ea toggle |
Hide or show announcements for yourself |
/ea schedules [run <id>] |
List or run schedules |
/ea update |
Check for a newer version |
/ea reload |
Reload all config files |
Options: -p <preset>, --silent, --no-discord, --force, --only <displays>, --no <displays>
Feature Comparison
| Feature |
Easy Announcements |
Typical Announcement Plugins |
| Minecraft 26.2 / Java 25 |
Yes |
Often outdated |
| Presets |
Yes, unlimited |
Rare |
| Animated Boss Bars |
Yes (FILL, DRAIN, PULSE, STATIC) |
Rare |
| Action Bar |
Yes |
Sometimes |
| Scheduled Announcements |
Yes, per schedule preset and target |
Basic |
| Group / Permission Targeting |
Yes (LuckPerms) |
No |
| Per-World Targeting |
Yes |
Limited |
| Player Opt-Out |
Yes |
Rare |
| Update Notices for Your Version |
Yes |
No |
| DiscordSRV Integration |
Embeds, text, webhooks, commands |
Usually none |
| Discord Permissions via LuckPerms |
Yes (linked accounts) |
No |
| PlaceholderAPI |
Parsing plus own expansion |
Sometimes |
| MiniMessage |
Yes, mixed with & codes |
Rare |
| Developer API |
Events, displays, selectors |
Rare |
| Config Migration |
Automatic from 1.x |
Manual |
Use Cases
- Server restart countdowns with a draining boss bar
- SMP and event announcements with their own look
- Rotating tips and vote reminders on a schedule
- Staff-only notices with
@g staff
- Discord-to-Minecraft announcements from your moderators
- Faction raid alerts and minigame start notifications
- Boss fights, drop parties and custom plugins announcing through the API
Support
- Issues:
- Discord:
- Support the developer:
Plugin by Sketch494. Eciipse Studios.

评论 0
登录后参与评分
还没有评论,来抢沙发吧