## 概述
AsBroadcast 是一个轻量级、多功能的 Minecraft 插件，旨在通过各种格式的自定义广播消息来增强服务器通信。
| 功能 | 描述 |
|---------|-------------|
| 多种消息类型 | 以聊天、标题、副标题或操作栏消息的形式发送消息 |
| 组合标题/副标题 | 同时发送标题和副标题 |
| 制表符自动完成 | 通过智能建议轻松使用命令 |
| 版本兼容性 | 与 Minecraft 1.18.x 到 1.21.x 兼容 |
| 颜色支持 | 完全支持传统颜色代码 (&) |
| 权限系统 | 对命令访问进行细粒度控制 |
## 命令
| 命令 | 描述 | 权限 |
|---------|-------------|------------|
| `/as <类型> <目标> <时间> <消息>` | 发送广播消息 | asbroadcast.use |
| `/asadmin <时间> <标题> \|\| <副标题>` | 同时发送标题和副标题 | asbroadcast.admin |
| `/asreload` | 重新加载插件配置 | asbroadcast.reload |
### 消息类型
- **chat**: 普通聊天消息
- **title**: 居中大文本
- **subtitle**: 标题下方的较小文本
- **actionbar**: 热条上方消息
### 时间格式
指定标题/副标题/操作栏的显示时长：
- `10s` - 10 秒
- `1m` - 1 分钟
- `2h` - 2 小时
## 配置
```yaml
# AsBroadcast 配置
# 调试模式 - 启用附加的控制台日志
debug: false
# 启用命令的制表符自动完成
tab-completion: true
# 启用管理员的欢迎消息
welcome-message:
enabled: true
messages:
- "&a欢迎来到服务器！"
- "&7使用 &e/as&7 发送消息"
# 默认显示时长（毫秒）
durations:
default: 5000 # 如果未指定，则为默认显示时间
fade-in: 500 # 标题淡入时间
fade-out: 500 # 标题淡出时间
# 消息
messages:
errors:
no-permission: "&c您没有使用此命令的权限。"
player-not-found: "&c未找到玩家: %player%"
no-players: "&c没有玩家可以发送消息。"
invalid-type: "&c无效的消息类型: %type%"
success:
message-sent: "&a消息发送成功！"
```
## 示例
```
/as chat all 大家好！
/as title all 10s &b欢迎来到服务器！
/as subtitle player1 5s &e祝您玩得愉快！
/as actionbar all 3s &6服务器即将重启！
/asadmin 10s &b欢迎来到服务器! || &e祝您玩得愉快！
```
## 兼容性
AsBroadcast 旨在跨多个 Minecraft 版本工作，并具有强大的错误处理功能：
| 版本 | 兼容性 |
|---------|--------------|
| 1.18.x | ✅ 完全支持 |
| 1.19.x | ✅ 完全支持 |
| 1.20.x | ✅ 完全支持 |
| 1.21.x | ✅ 完全支持 |
## 安装
1. 下载最新版本
2. 将 JAR 文件放置在服务器的插件文件夹中
3. 重新启动您的服务器或使用 `/reload`
4. 如果需要，编辑 `plugins/AsBroadcast/config.yml` 中的配置
5. 使用 `/asreload` 应用配置更改
## 权限
- `asbroadcast.use` - 访问 `/as` 命令
- `asbroadcast.admin` - 访问 `/asadmin` 命令
- `asbroadcast.reload` - 访问 `/asreload` 命令
## 支持
对于问题、功能请求或问题，请在 [Discord](https://discord.gg/6NXA8BWGbh) 中提出。
---
*AsBroadcast - 简单有效的服务器通信*
### 注意：
> AsBroadcast 采用开源方式，仅用于展示目的。代码可用于展示我的开发技能和插件设计。虽然您欢迎探索代码，但在未获得明确许可的情况下，不允许完全重用、修改或再分发。代码的某些部分是我的清晰代码。
`如果您对协作或超出查看范围的使用感兴趣，请通过 Discord 联系我。`