- 版权类型
- 原创
- 插件中文名称
- 资源占用显示插件
- 插件英文名称
- ServerMonitor
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- Purpur
- 语言支持
- 中文（简体）
- 前置组件
- 无
- 适配版本（Java）
- 26.x
- 1.21
[MD]# ServerMonitor - Paper 服务器状态 Tab 显示插件
适用于 **Minecraft Paper 26.2** 服务端的轻量级监控插件，在玩家 Tab 列表中实时显示服务器内存占用和 TPS。
## 功能特性
- ✅ **内存监控**：实时显示已用内存/最大内存及占用百分比
- ✅ **TPS 监控**：显示服务器当前 TPS（每秒刻数），带颜色标识
- 🟢 绿色：TPS ≥ 18（服务器流畅）
- 🟡 黄色：12 ≤ TPS < 18（轻微延迟）
- 🔴 红色：TPS < 12（服务器卡顿）
- ✅ **异步采集**：所有数据采集（内存、TPS）均在独立异步线程中执行，**不占用主线程**，不影响服务器性能
- ✅ **低开销**：每 2 秒更新一次，对服务器几乎无影响
## 安装方法
1. 下载 `ServerMonitor-1.0.0.jar`
2. 放入服务器的 `plugins/` 目录
3. 重启服务器或使用插件管理器加载
## 权限节点
| 权限 | 描述 | 默认 |
|------|------|------|
| `servermonitor.see` | 在 Tab 列表中看到服务器状态 | 所有人（op 默认拥有） |
## 显示效果
Tab 列表顶部（页眉 / 玩家列表 / 页脚）：
```
[自定义页眉 - /motd 设置，支持 & 颜色码]
玩家1 §a25ms
玩家2 §e87ms
玩家3 §c156ms
[内存: 1024/4096 MB (25.0%) | TPS: 19.8]
[带宽 ↓ 512 Kbps | ↑ 128 Kbps]
```
### /motd 指令
| 用法 | 说明 |
|------|------|
| `/motd` | 查看当前页眉 |
| `/motd <文本>` | 设置页眉（支持 & 颜色码） |
权限：`servermonitor.motd`（默认 op）
### 延迟 / 带宽颜色分级
| 指标 | 绿色 | 黄色 | 红色 |
|------|------|------|------|
| 延迟 | < 60ms | 60-119ms | ≥ 120ms |
| TPS | ≥ 18 | 12-17.9 | < 12 |
### v1.2.0 (2026-08-07)
- 新增带宽监控：下行 ↓ / 上行 ↑ Kbps，异步线程采样
- Linux：读取 /proc/net/dev（零进程开销）
- Windows：PowerShell Get-NetAdapterStatistics（异步执行，不影响主线程）
- 新增 `/motd` 指令：在线自定义 Tab 页眉，支持 & 颜色码（如 `/motd &a&l我的服务器`）
- 页脚升级为两行：内存+TPS 一行，带宽一行
- 权限 `servermonitor.motd`（默认 op）控制页眉修改
### v1.1.0 (2026-08-07)
- 支持玩家延迟（ping）显示在玩家名字后面
- 每秒刷新（1s 间隔）
- 兼容 Paper 1.21.x 全系列（1.21.0 ~ 1.21.11 / Paper 26.2）
- 所有采集（内存/TPS/延迟）完全异步，不占用主线程
- 延迟颜色：🟢 <60ms / 🟡 60-119ms / 🔴 ≥120ms
- ⚠️ 弃用警告：`setPlayerListName` / `setPlayerListHeaderFooter` 在 Paper 1.21 中被标记（仍可正常使用，后续版本迁移到新 API 即可）
### v1.0.0 (2026-08-07)
- 初始版本
- 支持内存和 TPS 在 Tab 列表中显示
- 异步线程采集，不占用主线程
## 注：可能存在覆盖其他插件Tab页面的bug，资源占用仅供参考，便于快速找到卡顿来源。
## 许可证
GNU GPL 3.0
[/MD]
