# SimpleServerUtility
轻量级、完全可配置的实用工具，适用于 **Spigot/Paper 1.20+** (Java 17+)。 通过 `config.yml` 切换所有功能。
## ✨ 功能
- 自定义 **服务器列表 MOTD** (多行)
- **首次加入** DM + 广播
- 自定义 **加入/离开** 消息
- **Tablist** 标题/页脚，支持 `%nl%` 行分割
- 定期 **自动广播**
- 加入 **标题 + 音效**
- **/rules** 命令
- **/broadcast** 命令 (颜色 + 占位符)
- **聊天格式** (全局)
- **维护模式** (+ 绕过 + 切换命令)
- **聊天慢速模式** (+ 绕过 + 切换/设置命令)
- **/clearchat** 命令
---
## ✅ 要求
- **服务器:** Spigot 或 Paper **1.20+**
- **Java:** **17+** (Java 21 也可以)
---
## ⌨️ 命令 & 权限
| 命令 | 描述 | 权限 | 默认 |
|---|---|---|---|
| `/ssu reload` | 重新加载 `config.yml` | `ssu.reload` | OP |
| `/rules` | 显示配置的规则列表 | *(无)* | 所有人 |
| `/broadcast <消息>` | 广播消息 (支持 & + 十六进制颜色，%nl%，%online%，%max%，%ip%) | `ssu.broadcast` | OP |
| `/maintenance ` | 切换或查看维护模式 | `ssu.maintenance` | OP |
| *(加入维护期间)* | 绕过维护踢出 | `ssu.maintenance.bypass` | OP |
| `/slowmode >` | 切换/设置全局聊天慢速模式 | `ssu.slowmode` | OP |
| *(慢速模式绕过)* | 忽略慢速模式延迟 | `ssu.slowmode.bypass` | OP |
| `/clearchat` | 清空公共聊天 | `ssu.clearchat` | OP |
---
## 🧩 占位符
- `%player%` — 玩家名称
- `%online%` — 在线玩家数量
- `%max%` — 最大玩家数量
- `%ip%` — 服务器 IP
- `%nl%` / `%n%` — 换行
MC 1.16+ 支持十六进制颜色 `&#RRGGBB`。
---
## 🛠 安装
1. 将 jar 文件放在 `plugins/` 目录下。
2. 启动服务器以生成 `plugins/SimpleServerUtility/config.yml`。
3. 编辑配置文件并运行 `/ssu reload` 以应用。
---
## ⚙️ 配置文件 (片段)
```yml
motd:
enabled: true
lines:
- "&a欢迎来到 &lMyServer&r"
- "&7祝你玩得开心, %player%!"
tablist:
enabled: true
header: "&6&lMyServer%nl%&7在线: %online%/%max%"
footer: "&7IP: &fplay.example.com"
broadcasts:
enabled: true
interval-seconds: 300
messages:
- "&a加入我们的Discord: &bdiscord.gg/example"
```
> 完整的、带有文档配置文件的jar包已随插件发布。
---
## 🧪 测试环境
- Paper 1.20.x, Spigot 1.20.x (Java 17, 21)
---
## 📄 许可证
MIT。