转载 聊天 工具 播报器 0.2.0

[MD]
# 播报器（Announcer）

一款适用于 Bukkit 系服务端的简洁灵活公告插件。支持通过 MiniMessage 将公告发送至聊天栏、动作栏、标题和 Boss 栏，并提供模板、定时任务、按类型划分的权限、PlaceholderAPI 集成及基于配置的目标筛选功能。

## 支持的平台

- Paper
- Spigot
- Bukkit
- Purpur

## 功能

- 支持多种公告类型：聊天栏、动作栏、标题、Boss 栏。
- 支持 MiniMessage 格式及自定义 ``<centered>`` 标签。
- 可为每种公告类型配置独立模板。
- 使用 ``/announce`` 命令手动广播自定义消息。
- 使用 ``/announcer reload`` 重新加载配置并重新安排定时任务。
- 通过 ``config.yml`` 配置定时公告，每项公告可设置独立的重复间隔。
- 可按 ``worlds`` 和 ``permission`` 分组筛选公告接收者。
- 提供按公告类型划分的细粒度权限节点。
- 可选集成 PlaceholderAPI，并为每名玩家单独解析变量。
- 为 `1.8` 提供旧版兼容回退；当服务端缺少相应 API 时，公告将降级发送至聊天栏。

## 兼容性

插件基于现代 Bukkit API 开发，例如运行于 Paper `1.21.x` 和 Java 21 的环境。

较旧版本的服务端也可使用，并会在缺少相关功能时自动采用兼容方案。若需要严格兼容 `1.8`，建议使用专门的旧版构建。

## 安装

1. 将 ``Announcer-<version>.jar`` 放入服务端的 ``plugins`` 文件夹。
2. 重启服务器。
3. 如需使用 ``%placeholders%`` 变量支持，请额外安装 PlaceholderAPI。

## 命令

- ``/announce <chat|actionbar|title|bossbar> <message...>``
- ``/announce <message>`` 使用 ``settings.default_type``，默认值为 ``chat``。
- ``/announcer reload``：重新加载 ``config.yml`` 并重新安排所有定时任务。

## 权限

| 权限节点 | 说明 |
| --- | --- |
| ``announcer.command`` | 使用 ``/announce``，默认仅 OP 可用。 |
| ``announcer.reload`` | 使用 ``/announcer reload``，默认仅 OP 可用。 |
| ``announcer.chat`` | 发送聊天栏公告。 |
| ``announcer.actionbar`` | 发送动作栏公告。 |
| ``announcer.title`` | 发送标题公告。 |
| ``announcer.bossbar`` | 发送 Boss 栏公告。 |

## 配置说明

- ``templates.chat``：聊天栏公告使用的 MiniMessage 模板。
- ``templates.actionbar``：动作栏公告模板。
- ``templates.title``：``title``、``subtitle``、``fade_in``、``stay``、``fade_out``。
- ``templates.bossbar``：``message``、``color``、``overlay``。
- ``settings.default_type``：``/announce <message>`` 使用的默认公告类型。
- ``targets.<name>``：按 ``worlds`` 和 ``permission`` 筛选目标玩家，例如 ``all``、``staff``。
- ``schedule[]``：定时公告条目，包含以下字段：
- ``type``：``chat|actionbar|title|bossbar``
- ``message``：MiniMessage 格式的消息文本。
- ``interval_seconds``：重复发送间隔。
- ``target``：目标分组名称。
- ``bossbar_duration_seconds``：Boss 栏的可选显示时长。

### 定时公告示例

```yaml
schedule:
- type: chat
message: "<gold>Remember to join our Discord!</gold>"
interval_seconds: 300
target: "all"
- type: bossbar
message: "<red>Server restarting soon</red>"
interval_seconds: 600
target: "all"
bossbar_duration_seconds: 10
```

## MiniMessage 支持

- 完整支持 MiniMessage 格式，例如 ``<gold>``、``<bold>`` 和 ``<gradient:red:gold>``。
- 自定义标签 ``<centered:Your text>`` 可将文本以居中形式插入输出内容中。
[/MD]