Announcer Plus [Hex RGB, PlaceholderAPI, JSON, Toast] - Announcer Plus - 自定义消息与公告插件

AnnouncerPlus 是一款功能强大的公告插件，它允许你为服务器定制丰富的玩家加入/退出消息、定时广播以及各类视觉与听觉效果，并支持通过权限进行精细化管理。

💡核心功能

自定义加入与退出消息

• 配置文件位于 plugins/AnnouncerPlus/joinquit/ 文件夹。
• 支持为首次加入的玩家设置独立的消息、标题、命令等。
• 可创建多个加入/退出消息配置，并通过权限分配给玩家或组。
• 支持将多个配置编组，在玩家加入/退出时随机选择一个。
• 每条消息可同时包含多种效果：
• 标题与副标题
• 动作栏消息
• Boss 血条消息
• 音效
• 执行命令
• 成就/提示框（Toast）

自动广播消息

• 配置文件位于 plugins/AnnouncerPlus/messages/ 文件夹。
• 可创建多个广播配置，并通过权限控制接收者。
• 每条广播同样支持上述所有效果（标题、动作栏、音效、命令等）。
• 支持定时发送和随机播放顺序。

丰富的消息格式

• 使用 MiniMessage 解析文本，支持所有原版聊天颜色、十六进制颜色代码和渐变效果。
• 支持在文本中添加悬停提示和点击动作。
• 为标题、副标题、动作栏和 Boss 血条中的文本提供动画效果（详见 Wiki）。

扩展支持

• PlaceholderAPI（强烈推荐但可选）：可在消息中使用任何 PlaceholderAPI 变量。
• Vault（必需）：经济等功能的依赖。
• Vanish 兼容：支持 SuperVanish、ProtocolVanish、EssentialsX Vanish 等，隐身玩家不会触发加入/退出广播。
• 多世界支持：可通过 LuckPerms 上下文（contexts）为不同世界分配不同的加入/退出消息和公告。

---

🎮权限配置

加入/退出消息权限

• 为玩家或组分配特定的加入消息配置：announcerplus.join.<配置名>
• 为玩家或组分配特定的退出消息配置：announcerplus.quit.<配置名>
• 示例：给默认组分配内置的默认消息权限：announcerplus.join.default 和 announcerplus.quit.default
• 如需随机选择，可在 main.conf 中创建配置组，并使用权限 announcerplus.randomjoin.<组名> 和 announcerplus.randomquit.<组名> 分配。
• 注意：OP 玩家可能会收到重复消息，请使用权限插件取消你不想让他们拥有的权限。

自动广播权限

• 使玩家或组接收特定广播配置：announcerplus.messages.<配置名>
• 示例：让所有人接收演示广播：announcerplus.messages.demo
• 阻止 AFK 玩家接收特定广播：announcerplus.messages.<配置名>.afk
• 示例：阻止所有人在 AFK 时接收演示广播：announcerplus.messages.demo.afk

---

🔧命令列表

所有命令均以 /announcerplus 或简称 /ap 开头。

• /announcerplus reload
• 所需权限：announcerplus.reload
• 重新加载所有配置文件。

• /announcerplus broadcast
• 所需权限：announcerplus.broadcast
• 手动广播一条消息，其解析方式（变量、格式等）与配置文件相同。
• 类似命令还有 /announcerplus broadcasttoast、/announcerplus broadcasttitle 等，权限格式类似，如 announcerplus.broadcasttoast。

• /announcerplus send
• 所需权限：announcerplus.send
• 手动向指定玩家发送一条消息。
• 类似命令还有 /announcerplus sendtoast、/announcerplus sendtitle 等，权限格式类似，如 announcerplus.sendtoast。

• /announcerplus parse
• 所需权限：announcerplus.parse
• 测试一条消息的解析效果，命令会返回解析后的消息。

• /announcerplus parseanimation
• 所需权限：announcerplus.parseanimation
• 测试带动画的文本，动画将以标题形式展示。

• /announcerplus list
• 所需权限：announcerplus.list
• 列出指定广播配置中的所有消息。

• /announcerplus help
• 查看 AnnouncerPlus 命令帮助。只会显示用户拥有权限的命令。

---

❓其他信息与注意事项

• 版本兼容性：
• 成就/提示框（Toast）类消息仅适用于 Minecraft 1.12 及以上版本。
• 在旧版本服务器（如 1.8.8）上运行并使用 ViaVersion 时，1.16+ 的客户端仍可接收 RGB 彩色文本。
• 技术信息：
• 插件使用 Kotlin 编写，Kotlin 标准库已包含在 JAR 文件中，无需其他插件。
• 支持与反馈：
• 支持可通过我的 Discord 或 GitHub Discussions 页面获取。
• 欢迎提交功能请求，但无法保证一定会添加。
• 如果你喜欢这个插件，请给它评分！（请注意，评分区不是用来寻求技术支持的）

更多详细信息，请查阅 AnnouncerPlus Wiki。