原创 - 开源 - AdvancedAnnouncement——更高级的 Minecraft 自动公告

插件中文名称: 高级自动公告

插件英文名称: AdvancedAnnouncement

支持的核心（代理-服务端）

Bungee
WaterFall
Spigot
PaperSpigot
Purpur
PufferFish

语言支持: 多语言

适配版本（Java）

1.16
1.17
1.18
1.19
1.20

简介
AdvancedAnnouncement 是一个高版本自动公告插件，在 1.16+ 的版本中支持了 hex 颜色(即 rgb)

运行本插件需要你的服务端中安装 PlaceholderAPI

需要注意的是，低于 1.3.0 版本的插件可以运行在 Minecraft 1.12-1.20 的服务器上, 并且需要同时安装 PlaceholderAPI 和 ProtocolLib 插件，在 1.3.0 之后的版本，插件将仅支持 Minecraft 1.16+ 的服务器版本，并且不再需要安装 ProtocolLib

本插件可以运行在 Bukkit 环境和 BungeeCord 代理环境中，安装时仅需将本插件放进 plugins 文件夹内即可. 注意 BC 代理环境中安装本插件时，其代理的服务端无需安装本插件.

公告类型

CHAT	公告会被发送到聊天栏上
ACTION_BAR	公告会被发送到玩家的物品栏上方
BOSS_BAR	公告会以 BOSS 栏的方式显示在玩家屏幕正上方
TITLE	公告会以标题的形式发送到玩家的屏幕中间
MULTIPLE_LINE_BOSS_BAR	该公告会以多行 BOSS 栏的形式发送到玩家屏幕上方. (自 1.0.2 版本起)

指令

指令名称	权限	描述
/aa help	--------------------	显示帮助
/aa start	aa.command.start	开始广播公告
/aa stop	aa.command.stop	停止广播公告
/aa broadcast	aa.command.broadcast	广播一个公告
/aa display	aa.command.display	向你展示一个公告
/aa list	aa.command.list	列出所有加载的公告
/aa parse	aa.command.parse	解析一个字符串
/aa reload	aa.command.reload	重新加载插件

占位符表

占位符名称	描述	哪些公告可以使用
{rainbow}	彩虹渐变文本占位符	所有类型
{#RRGGBB[,<arg1>,<arg2>,...]}	RGB 文本颜色占位符	所有类型
{#RRGGBB->#GGBBRR[,<arg1>,<arg2>,...]}	渐变色文本占位符	所有类型
{delay:<double>}	在显示下一条文本前的间隔时间	1. ACTION_BAR 2. BOSS_BAR
{stay:<double>}	文本的停留时间	1. ACTION_BAR 2. BOSS_BAR
{color:<PINK\|BLUE\|GREEN\|RED\|YELLOW\|PURPLE\|WHITE>}	BOSS 栏的颜色	1. ACTION_BAR 2. BOSS_BAR 3. MULTIPLE_LINE_BOSS_BAR
{update:<double>}	BOSS 栏文本的更新时间	1. BOSS_BAR 2. MULTIPLE_LINE_BOSS_BAR
{progress:<true\|false>}	显示 BOSS 栏进度动画	1. BOSS_BAR 2. MULTIPLE_LINE_BOSS_BAR
{segment:<6\|10\|12\|20>}	BOSS 栏的节段	1. BOSS_BAR 2. MULTIPLE_LINE_BOSS_BAR

配置文件
由于配置内注释量大，请移步相应地址查看。

创建公告

要想创建一个公告，你需要在 announcements.yml 中的 announcements 块下进行如下配置，以 CHAT 类型作为示例

YAML：

# 这个公告的名称，在这里不作限制，你只需要保证它不重复即可
annName:
  # 公告的类型
  type: CHAT
  # 公告的内容
  content:
    - '这是一条会被发送到聊天栏里的公告'
    - '可以发送多行'

注意: 示例配置中 仅列出必填项目，其余选填内容并没有在此列出，选填内容详情请参见 announcements.yml

公告中的必填项目

公告中的必填项目为 type 和 content 字段，分别表示公告类型和公告内容

公告中的选填项目

所有选填项目如下:

配置项	说明	可以用在哪些公告上	备注
delay	当前公告与下一个公告之间的延迟时间，填写格式见这里	所有公告
permission	限制玩家接收到这个公告的权限，没有权限的玩家不会收到这个公告。如果什么都不写或者去除该项，则表示任何玩家都可收到这个公告	所有公告
worlds	限制该公告所发送的世界, 如果不配置该项内容，那么公告则会使用默认设置	所有公告
stay	仅限于多行 Boss 栏公告类型使用，表示该公告的停留时间。	MULTIPLE_LINE_BOSS_BAR	从 1.0.2 版本添加
fadeIn	仅限于 TITLE 类型公告使用，表示 *标题淡入时间*	TITLE
stay	仅限于 TITLE 类型公告使用，表示 *标题停留时间*	TITLE
fadeout	仅限于 TITLE 类型公告使用，表示 *标题淡出时间*	TITLE
sub-fadeIn	仅限于 TITLE 类型公告使用，表示 *副标题淡入时间*	TITLE	从 1.2.0-beta 版本添加
sub-stay	仅限于 TITLE 类型公告使用，表示 *副标题停留时间*	TITLE	从 1.2.0-beta 版本添加
sub-fadeout	仅限于 TITLE 类型公告使用，表示 *副标题淡出时间*	TITLE	从 1.2.0-beta 版本添加

公告延迟时间填写格式

格式为数字+时间单位，示例内容如下：

示例内容	所表示的时间
60s	60 秒
1min	1 分钟

使用 RGB 颜色代码

正如介绍中所言，AdvancedAnnouncement 支持使用 RGB 颜色代码(1.16+) 来让你的公告拥有更多的颜色！

Tips:
支持 PlaceholderAPI 变量
如果你启用了 'Console-broadCast', 占位符会直接显示它的原始值(如果这个占位符必须要以一个玩家解析的话)
如果你的服务器版本低于了 1.16, 那么推荐使用原版颜色代码。尽管插件对低版本做了兼容
(它会自动将 RGB 颜色替换成与原版最接近的颜色), 仍然不建议在低版本服务器中使用 RGB 颜色代码