Bukkit [1.12.2] ServerStatus 为群组服务器状态管理插件PAPI 1.0.0

### 服务器状态检测
- 自动读取BungeeCord配置文件 (支持所有BC分支：Waterfall、Velocity等)
- **异步检测**10个节点服务器在线状态，**无延迟无卡顿**
- Socket连接验证，确保状态准确性
- **智能缓存机制**，变量获取毫秒级响应
- 可配置检测间隔 (默认5秒)
- 支持自定义服务器配置

### 维护模式控制
- 独立的维护模式开关系统
- 仅限OP权限操作，确保安全性
- 支持单独控制每个服务器节点
- 默认关闭维护模式

### PlaceholderAPI集成
- 提供20个动态变量节点
- 支持菜单插件动态图标显示
- 实时状态更新
- 完全可自定义返回文本

### 完全中文化
- 所有文本支持自定义
- 专业的中文界面
- 详细的帮助信息

## 安装教程
### 前置要求
1. Minecraft 1.12.2 或更高版本
2. 已安装 PlaceholderAPI 插件
3. 服务器需要有BungeeCord群组环境
### 安装步骤
1. 下载 `ServerStatus-1.0.0.jar`
2. 将插件放入服务器的 `plugins` 文件夹
3. 重启服务器或使用 `/plugman load ServerStatus`
4. 插件会自动生成配置文件

## 配置文件
### config.yml
```yaml
# BungeeCord配置文件路径
bungeecord-config-path: "../config.yml"
# 服务器检测超时时间 (毫秒)
server-timeout: 3000
# 状态检测间隔 (秒) - 推荐5-10秒
status-check-interval: 5
# 备用服务器列表
servers:
server1:
host: "localhost"
port: 25565
# ... 更多服务器配置
```
### lang.yml
```yaml
# 服务器状态文本
server:
online: "§a在线"
offline: "§c离线"
# 维护模式文本
maintenance:
enabled: "§c维护中"
disabled: "§a正常"
```
## PlaceholderAPI变量
### 服务器在线状态变量
```
%serverstatus_{服务器名}_status%
例如:
%serverstatus_zf_status% - zf服务器在线状态
%serverstatus_lobby_status% - lobby服务器在线状态
%serverstatus_survival_status% - survival服务器在线状态
```
### 维护模式状态变量
```
%serverstatus_{服务器名}_maintenance%
例如:
%serverstatus_zf_maintenance% - zf服务器维护状态
%serverstatus_lobby_maintenance% - lobby服务器维护状态
%serverstatus_survival_maintenance% - survival服务器维护状态
```
## 命令使用
### 基础命令
```
/serverstatus - 显示帮助信息
/ss - 命令别名
/sstatus - 命令别名
```
### 维护模式控制 (需要OP权限)
```
/serverstatus maintenance zf on - 开启zf维护模式
/serverstatus maintenance lobby off - 关闭lobby维护模式
/serverstatus maintenance survival enable - 启用survival维护模式
/serverstatus maintenance pvp disable - 禁用pvp维护模式
```
### 状态查询
```
/serverstatus status - 查看所有服务器状态
/serverstatus status zf - 查看zf状态
/serverstatus status lobby - 查看lobby状态
```
### 配置管理 (需要OP权限)
```
/serverstatus reload - 重载配置文件
```
## 菜单插件集成示例

Trmenu V3

A:
update: 10
display:
mats: chest
name: '&6'
lore:
- ''
- ' &7服务器状态&7: &a开放中'
- ' &7在线&7: &a%serverstatus_zf_status% '
- ''
actions:
left:
- 'close'
- 'console: stp %player_name% spawn'
icons:
- condition: 'check papi *%serverstatus_zf_status% == *§c离线'
update: 10
display:
material: 'Barrier'
name:
- '&f'
lore:
- ''
- ' &7服务器状态&7: &c已关闭'
- ' &7状态&7: &a%serverstatus_zf_status%'
actions:
left:
- 'close'
- 'sound: BLOCK_NOTE_BLOCK_PLING-1-2'
- 'title: `&c进入失败` `&7服务器已关闭 请看&e菜单说明信息` 15 150 15'
- condition: 'check papi *%serverstatus_zf_maintenance% == *§c开启维护模式'
update: 10
display:
material: 'paper'
name:
- '&f'
lore:
- ' &7服务器状态&7: &c维护中'
- ' &7在线&7: &a%serverstatus_zf_maintenance% '
actions:
left:
- 'close'
- 'sound: BLOCK_NOTE_BLOCK_PLING-1-2'
- 'title: `&e进入失败` `&7服务器维护中 请看&e菜单说明信息` 15 150 15'


## 权限节点
```yaml
serverstatus.admin # 管理员权限 (默认: OP)
serverstatus.maintenance # 维护模式控制权限 (默认: OP)
serverstatus.reload # 重载配置权限 (默认: OP)
```
## 热重载支持
插件完美支持热重载和卸载：

### 内存完全释放
插件在卸载时会：
- 清理所有Map和变量
- 释放PlaceholderAPI扩展
- 完全清空内存引用
- 支持删除jar文件
## 常见问题
### Q: 服务器状态显示不准确？
A: 请检查BungeeCord配置文件路径是否正确，确保插件能读取到BC配置。
### Q: 变量在菜单中不显示？
A: 确保已安装PlaceholderAPI，并使用 `/papi reload` 重载变量。
### Q: 维护模式命令无法使用？
A: 维护模式控制需要OP权限，请确保执行者有足够权限。
### Q: 如何自定义显示文本？
A: 编辑 `plugins/ServerStatus/lang.yml` 文件，修改对应的文本内容。
### Q: 状态检测有延迟吗？会卡服务器吗？
A: **完全不会！** 插件使用异步检测+缓存机制，变量获取毫秒级响应，不会阻塞主线程。
### Q: 支持哪些BungeeCord分支？
A: 支持所有BC分支：原版BungeeCord、Waterfall、Velocity、FlameCord等。
### Q: 服务器关闭后多久能检测到？
A: 默认5秒检测间隔，可在config.yml中调整 `status-check-interval` 参数。
## 技术支持
如果遇到问题或需要帮助，请：
1. 检查控制台错误日志
2. 确认依赖插件已正确安装
3. 验证配置文件格式正确

=== 主要变量 ===
服务器状态：%serverstatus_{服务器名}_status%
维护模式：%serverstatus_{服务器名}_maintenance%
例如：%serverstatus_zf_status%、%serverstatus_lobby_maintenance%

4. 联系作者：空太 2897626982+ai

总之这个就是个变量插件 控制你的bc或者破布核心 里面的那个服务器的那个子服务器的配置 名字你填上去就行了 那些返回的变量文本都可以自定义 注意那个变量判断一定也要加颜色，我上面的那个tr的那个已经给出示例了

## 更新日志
### v1.0.0 (初始版本)
- 支持10个服务器节点状态检测
- BungeeCord配置文件自动读取
- 独立维护模式控制系统
- PlaceholderAPI完美集成
- 完全可自定义文本系统
- 热重载和内存释放支持
- 详细的权限控制
- 专业中文界面