Toolmetry Server Doctor
适用于 Minecraft Paper 服务器的全方位诊断、优化、监控、安全与报告插件。一条命令(/tm),48 项功能,零服务器延迟。
为什么选择 Toolmetry Server Doctor?
运行 Minecraft 服务器并非易事。你需要关注 TPS、MSPT、内存、插件冲突、安全漏洞、崩溃报告、配置错误、卡顿来源等 50 多项内容——通常分散在 10 个不同的插件中。Toolmetry 将所有这些功能整合到一个插件和一条命令中。
所有操作均异步执行——不会阻塞服务器的主线程。自动扫描默认处于禁用状态,因此即使是 1GB 内存的服务器也能流畅运行,毫无卡顿。
主要功能
服务器审计 (Server Audit)
生成涵盖 5 个类别的 0–100 健康评分:性能、安全性、配置、稳定性、兼容性。分析 TPS、MSPT、内存、CPU、Java 版本、Paper 版本、操作系统、运行时间、插件、世界、区块、实体、视距/模拟距离、在线模式、RCON、白名单等。每个问题都附带清晰、可操作的建议。
插件医生 (Plugin Doctor)
扫描所有已安装的插件,检测重复项、缺失依赖、软依赖、冲突(循环依赖)、已禁用的插件、不兼容的 API 版本、废弃的 API、内存占用过高的插件以及已知不良的配置。
配置验证器 (Config Validator)
验证所有插件中的每个 YAML 配置文件。检测无效的 YAML 语法、重复键、缺失值、错误的类型、无效的材料/粒子/音效/附魔名称、空节以及格式损坏——并提供文件名、行号、严重程度和建议的修复方案。除非你显式启用自动修复,否则绝不会修改你的文件。
卡顿分析器 (Lag Analyzer)
识别导致卡顿的根本原因:实体过载、村民过多、漏斗刷屏、掉落物品堆积、红石时钟滥用、区块加载瓶颈、农场过载、怪物生成压力、调度器过载以及方块实体过载。每个问题都包含影响说明和优化技巧。
崩溃分析器 (Crash Analyzer)
读取 Minecraft 崩溃报告和 latest.log,识别根本原因,尽可能将其归因于某个插件,用通俗英语总结堆栈跟踪信息,并提供具有置信度的具体解决方案。再也不用阅读长达 500 行的 Java 堆栈跟踪了。
安全扫描器 (Security Scanner)
审计 OP 玩家、通配符权限、危险权限、离线模式、暴露且密码弱小的 RCON、不安全的 server.properties、白名单状态、出生点保护。生成 0–100 安全评分,并为每个漏洞提供修复指导。
更新检查器 (Update Checker)
异步检查 Paper 版本(通过 PaperMC API)和插件版本(通过 Spiget API)。将更新分类为安全、推荐、功能或可选。
基准测试 (Benchmark)
安全地测量内存分配、CPU 吞吐量、实体枚举、区块访问、ItemStack 创建、内存余量、TPS 和 MSPT。产生每项测试的分数和整体基准评级。
HTML 报告
生成现代、响应式、可打印的 HTML 报告,包含 Chart.js 图表(雷达图用于评分,柱状图用于指标),支持 4 种主题(浅色/深色/午夜/海洋),并包含完整的审计/安全/崩溃/基准数据。保存至 plugins/Toolmetry-Server-Doctor/reports/。
Discord Webhook 警报
连接一个 Discord 频道并接收:
- ? 服务器启动通知
- ? 服务器关闭通知
- 你运行的每条命令的完整输出(
tm audit、tm security、tm crash 等)
- 当审计分数较低、检测到崩溃或发现安全漏洞时的关键警报
精美的嵌入消息,带有颜色编码的严重程度(蓝色=INFO,黄色=WARN,橙色=ERROR,红色=CRITICAL)、时间戳和页脚中的服务器名称。限流以防止垃圾信息。
27+ 内置管理工具
在一个插件中完成日常管理员任务——不再需要安装 5 个单独的工具插件:
tm ping — 玩家延迟
tm serverinfo / tm worldinfo / tm playerinfo — 信息卡片
tm purge — 清除实体
tm gc — 触发垃圾回收
tm heal / tm feed — 治疗与喂食玩家
tm day / tm night / tm sun / tm rain — 时间与天气
tm saveall — 强制保存世界与玩家
tm broadcast — 向所有人广播
tm gamemode / tm fly / tm god / tm vanish / tm speed — 玩家状态
tm difficulty / tm whitelist / tm opmanager — 服务器配置
tm kickall / tm tphere / tm invclear — 玩家管理
tm diskusage / tm meminfo / tm motd — 服务器统计
游戏内 GUI 仪表板
使用 Adventure API + MiniMessage 构建的美观库存 GUI。点击任意模块即可立即运行。无需命令——只需输入 tm gui 打开即可。
命令 — 仅需 ONE
每个功能都是 /tm(别名 /toolmetry)的子命令。没有别名,没有混淆:
| 命令 |
功能 |
tm audit |
服务器健康评分(0-100) |
tm doctor |
插件健康检查 |
tm lag |
查找卡顿来源 |
tm security |
安全漏洞扫描 |
tm crash |
分析崩溃报告 |
tm benchmark |
性能基准测试 |
tm config |
验证插件 YAML 配置 |
tm scan |
一次性运行所有诊断 |
tm report |
生成 HTML 报告 |
tm webhook |
Discord 设置 |
tm tools |
列出所有 27+ 管理工具 |
tm gui |
打开仪表板(游戏内) |
tm help |
完整命令列表 |
在游戏内或控制台中输入 tm 查看完整菜单。
性能
- 所有扫描均在专用线程池上异步运行——主线程永不阻塞
- 自动扫描默认禁用——除非你主动选择加入,否则后台无工作
- 可配置的线程池(默认 1 个线程)——适用于 1GB 内存的服务器
- Discord 通知限流——防止 Webhook 垃圾信息
- 配置加载故障保护——损坏的
config.yml 会自动备份并用默认值替换,插件永远不会崩溃
要求
- Paper 1.20.x(已在 1.20.1 上测试,适用于 1.20.x)
- Java 17+(适用于 Java 17、21、25)
- 无外部依赖——仅使用 Paper API + Adventure API(随 Paper 捆绑)
安装
- 将
toolmetryai-server-doctor-1.0.0.jar 放入 plugins/ 目录
- 重启服务器
- 在控制台输入
tm,或在游戏内输入 /tm
Discord 设置(可选)
- Discord → 频道设置 → 集成 → Webhook → 新建 Webhook → 复制 URL
- 在控制台中执行:
tm webhook https://discord.com/api/webhooks/...
- 测试:
tm webhook test
完成。现在你运行的每次审计、安全扫描、崩溃分析和基准测试都会同步显示在你的 Discord 频道中。
权限
toolmetry.admin — 访问所有功能(默认:OP)
toolmetry.tools — 使用管理员工具,如 purge、gc、heal(默认:OP)
支持
- 官网:
- 问题反馈:GitHub Issues 标签页
许可证
MIT — 个人和商业用途免费。
Toolmetry Server Doctor
The all-in-one diagnostics, optimization, monitoring, security, and reporting plugin for Minecraft Paper servers. One command (/tm), 48 features, zero server lag.
Why Toolmetry Server Doctor?
Running a Minecraft server is hard. You have to watch TPS, MSPT, memory, plugin conflicts, security holes, crash reports, config errors, lag sources, and 50 other things — usually across 10 different plugins. Toolmetry puts all of that into ONE plugin with ONE command.
Everything runs asynchronously — your server's main thread is never blocked. Auto-scans are disabled by default so even 1GB RAM servers run it without lag.
Key Features
Server Audit
Generates a 0–100 health score across 5 categories: Performance, Security, Configuration, Stability, Compatibility. Analyzes TPS, MSPT, memory, CPU, Java, Paper version, OS, uptime, plugins, worlds, chunks, entities, view/sim distance, online mode, RCON, whitelist, and more. Each issue comes with a clear, actionable recommendation.
Plugin Doctor
Scans every installed plugin for duplicates, missing dependencies, soft dependencies, conflicts (circular deps), disabled plugins, incompatible API versions, deprecated APIs, memory-heavy plugins, and known-bad configurations.
Config Validator
Validates every YAML config file in every plugin. Detects invalid YAML syntax, duplicate keys, missing values, wrong types, invalid Material/Particle/Sound/Enchantment names, empty sections, and broken formatting — with file name, line number, severity, and suggested fix. Never modifies your files unless you explicitly enable auto-fix.
Lag Analyzer
Identifies the real causes of lag: entity overload, excessive villagers, hopper spam, dropped item accumulation, redstone clock abuse, chunk loading bottlenecks, overloaded farms, mob spawning pressure, scheduler overload, and tile entity overload. Each issue includes impact explanation and optimization tips.
Crash Analyzer
Reads Minecraft crash reports and latest.log, identifies the root cause, attributes it to a plugin (when possible), summarizes the stack trace in plain English, and gives you concrete solutions with a confidence score. No more reading 500-line Java stack traces.
Security Scanner
Audits OP players, wildcard permissions, dangerous permissions, offline mode, exposed RCON with weak passwords, unsafe server.properties, whitelist status, spawn protection. Generates a 0–100 Security Score with remediation guidance for every vulnerability.
Update Checker
Asynchronously checks Paper version (via PaperMC API) and plugin versions (via Spiget API). Categorizes updates as Security, Recommended, Feature, or Optional.
Benchmark
Safely measures memory allocation, CPU throughput, entity enumeration, chunk access, ItemStack creation, memory headroom, TPS, and MSPT. Produces per-test scores and an overall benchmark rating.
HTML Reports
Generates modern, responsive, printable HTML reports with Chart.js charts (radar for scores, bar for metrics), 4 themes (light/dark/midnight/ocean), and full audit/security/crash/benchmark data. Saved to plugins/Toolmetry-Server-Doctor/reports/.
Discord Webhook Alerts
Connect a Discord channel and receive:
- ? Server startup notifications
- ? Server shutdown notifications
- Full output of every command you run (
tm audit, tm security, tm crash, etc.)
- Critical alerts when audit score is low, crashes are detected, or security vulnerabilities are found
Pretty embeds with color-coded severity (blue=INFO, yellow=WARN, orange=ERROR, red=CRITICAL), timestamps, and server name in footer. Rate-limited to prevent spam.
27+ Built-in Admin Tools
Everyday admin tasks in one plugin — no more installing 5 separate utility plugins:
tm ping — player latency
tm serverinfo / tm worldinfo / tm playerinfo — info cards
tm purge — clear entities
tm gc — trigger garbage collection
tm heal / tm feed — heal & feed players
tm day / tm night / tm sun / tm rain — time & weather
tm saveall — force save worlds & players
tm broadcast — announce to all
tm gamemode / tm fly / tm god / tm vanish / tm speed — player states
tm difficulty / tm whitelist / tm opmanager — server config
tm kickall / tm tphere / tm invclear — player management
tm diskusage / tm meminfo / tm motd — server stats
In-Game GUI Dashboard
Beautiful inventory GUI built with Adventure API + MiniMessage. Click any module to run it instantly. No commands needed — just open with tm gui.
Commands — Just ONE
Every feature is a subcommand of /tm (alias /toolmetry). No aliases, no confusion:
| Command |
What it does |
tm audit |
Server health score (0-100) |
tm doctor |
Plugin health check |
tm lag |
Find lag sources |
tm security |
Security vulnerability scan |
tm crash |
Analyze crash reports |
tm benchmark |
Performance benchmark |
tm config |
Validate plugin YAML configs |
tm scan |
Run all diagnostics at once |
tm report |
Generate HTML report |
tm webhook |
Discord setup |
tm tools |
List all 27+ admin tools |
tm gui |
Open dashboard (in-game) |
tm help |
Full command list |
Type tm in-game or console for the full menu.
Performance
- All scans run async on a dedicated thread pool — main thread never blocked
- Auto-scans disabled by default — zero background work unless you opt in
- Configurable thread pool (default 1 thread) — works on 1GB RAM servers
- Rate-limited Discord notifications — no webhook spam
- Fail-safe config loading — broken
config.yml is auto-backed up and replaced with defaults, plugin never crashes
Requirements
- Paper 1.20.x (tested on 1.20.1, works on 1.20.x)
- Java 17+ (works on Java 17, 21, 25)
- No external dependencies — uses only Paper API + Adventure API (bundled with Paper)
Installation
- Drop
toolmetryai-server-doctor-1.0.0.jar into plugins/
- Restart server
- Type
tm in console or /tm in-game
Discord Setup (Optional)
- Discord → Channel Settings → Integrations → Webhooks → New Webhook → Copy URL
- In console:
tm webhook https://discord.com/api/webhooks/...
- Test:
tm webhook test
Done. Now every audit, security scan, crash analysis, and benchmark you run will also appear in your Discord channel.
Permissions
toolmetry.admin — access to all features (default: OP)
toolmetry.tools — use admin tools like purge, gc, heal (default: OP)
Support
- Website:
- Issues: GitHub Issues tab
License
MIT — free for personal and commercial use.
评论 0
登录后参与评分
还没有评论,来抢沙发吧