Easy Announcements

插件

· 作者 sketch494

Easy Announcements 是一款现代、轻量级的插件,可让你发送专业外观的公告。

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

最新 2.0.0 · 26.2 · Bukkit / Paper

一键开服(送7天)

easy_announcements_title



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 进行自定义插件公告

支持

  • 问题反馈:
  • Discord:
  • 支持开发者:

插件作者:Sketch494。Eciipse Studios。



wepwawet

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源