[](https://jenkins.jpenilla.xyz/job/AnnouncerPlus/)
## 概述
- **自定义加入和离开消息**，按权限分配：
- 自定义加入 MotD 消息
- 玩家加入/离开时的自定义广播
- 玩家加入/离开时的自定义命令
- 玩家加入/离开时的声音
- 玩家加入时自定义标题/副标题和动作/Boss 条
- 玩家加入时自定义 Toast/成就
- **自动消息/广播**，按定时器分配，按权限分配：
- 随机化消息顺序
- 播放声音
- 显示标题
- 显示 Boss 条
- 显示动作条
- 显示自定义 Toast/成就
- **使用命令发送/广播消息、标题、动作条、Boss 条和 Toast** 到世界或玩家。
- **动画支持**，适用于标题、副标题、Boss 条和动作条。 更多信息请参见 [wiki 页面](https://github.com/jpenilla/AnnouncerPlus/wiki/Text-Animations)。
- **MiniMessage 解析**，适用于所有消息。
- 内置渐变、十六进制颜色、阴影颜色等
- [MiniMessage 文档](https://docs.advntr.dev/minimessage/format)
- [MiniMessage 观察器](https://webui.advntr.dev/)
[PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) 是 *强烈推荐*，但可选的依赖项。 您可以使用任何 PlaceholderAPI 占位符在消息中。 [Vault](https://dev.bukkit.org/projects/vault) 是必需的依赖项。
## 功能概览
### 自定义加入和离开消息
- 配置存储在 `plugins/AnnouncerPlus/joinquit/`
- 可选的首次加入配置(为玩家的首次加入提供不同的消息、标题、命令等)
- 创建多个加入/离开消息配置并按权限分配
- 分配加入/离开消息组，并在加入/离开时随机选择一个
- 支持标题、副标题、动作条、Boss 条、声音、命令和 Toast/成就
### 自定义广播消息
- 配置存储在 `plugins/AnnouncerPlus/messages/`
- 创建多个广播配置并按权限分配
- 支持标题、副标题、动作条、Boss 条、声音、命令和 Toast/成就
### 聊天颜色支持
- 全面的 vanilla 和十六进制颜色代码
```xml
彩色文本！
红色文本 黄色文本 红色和粗体文本
||||||||||||||||||||||||
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
```
### 悬停文本和点击选项
- [悬停动作](https://ci.md-5.net/job/BungeeCord/ws/chat/target/apidocs/net/md_5/bungee/api/chat/HoverEvent.Action.html)
- [点击动作](https://ci.md-5.net/job/BungeeCord/ws/chat/target/apidocs/net/md_5/bungee/api/chat/ClickEvent.Action.html)
示例：
```xml
点击运行！ /spawn
```
### 文本动画
文本动画文档：[这里](https://github.com/jpenilla/AnnouncerPlus/wiki/Text-Animations)
### PlaceholderAPI 支持
- 加入/离开消息和所有广播解析了 [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) 占位符
- [可用占位符](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders)
示例：
```xml
你好，%essentials_nickname%！ 你有 $%vault_eco_balance_commas%
```
### 语法/格式
- 参见 [消息语法文档](https://github.com/jpenilla/AnnouncerPlus/wiki/Message-Syntax)
- 包括：
- 居中文本
- 完整的语法文档
### 杂项功能
- 命令补全支持
- 消失支持 (SuperVanish, ProtocolVanish, EssentialsX Vanish 等)
- 消失玩家没有加入/离开广播
## 权限
### 加入/离开消息
- 使用 `announcerplus.join.configname` 和 `announcerplus.quit.configname` 权限将加入/离开消息分配给玩家/组
- 例如，要将默认包含的加入/离开消息分配给所有人，请将默认组提供 `announcerplus.join.default` 和 `announcerplus.quit.default` 权限。
- 对于随机加入/离开配置选择，可以在 `main.conf` 中创建加入/离开配置组，然后使用 `announcerplus.raindomjoin.groupname` 和 `announcerplus.raindomquit.groupname` 权限分配。 更多详细信息请参见 `main.conf`
- 一个常见的错误是 OP 玩家有重复的加入/离开消息。 为了解决这个问题，请使用你的权限插件否定他们不应拥有的权限。
### 自动广播
- 使用 `announcerplus.messages.configname` 权限将玩家/组设置为接收消息配置中的广播
- 例如，要让所有人接收 demo 消息，请将默认组提供 `announcerplus.messages.demo` 权限
- 使用 `announcerplus.messages.configname.afk` 权限阻止玩家在 AFK 时接收广播
- 例如，要阻止任何人在 AFK 时接收 demo 消息，请将默认组提供 `announcerplus.messages.demo.afk` 权限
## 命令
| 命令 | 权限 | 描述 |
|:---|:---|:---|
| `/announcerplus reload` | `announcerplus.reload` | 重新加载所有配置文件 |
| `/announcerplus broadcast` | `announcerplus.broadcast` | 手动广播一条消息 |
| `/announcerplus send` | `announcerplus.send` | 手动向玩家发送一条消息 |
| `/announcerplus parse` | `announcerplus.parse` | 测试消息解析 |
| `/announcerplus parseanimation` | `announcerplus.parseanimation` | 测试带有动画的文本解析 |
| `/announcerplus list` | `announcerplus.list` | 列出消息配置的消息 |
| `/announcerplus help` | *不需要权限* | 显示命令帮助 |
> **注意:** 类似广播/发送命令存在于 Toast、标题等，具有权限如 `announcerplus.broadcasttoast`、`announcerplus.sendtoast` 等。
## 其他信息
- 查阅 [AnnouncerPlus Wiki](https://github.com/jpenilla/AnnouncerPlus/wiki) 以了解更多信息
- 使用 [LuckPerms contexts](https://luckperms.net/wiki/Context) 按世界分配加入/离开消息
- Toast/成就消息仅在 Minecraft 1.12+ 中有效
- 当使用旧服务器（如 1.8.8）并启用 ViaVersion 时，1.16+ 客户端仍然会收到 RGB 文本！