Toolmetry Server Doctor — All-in-One Paper Diagnostics Plugin
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
1. SERVER AUDIT — Generates a 0–100 health score across 5 categories: Performance, Security, Configuration, Stability, Compatibility.
2. PLUGIN DOCTOR — Scans every installed plugin for duplicates, missing dependencies, conflicts, disabled plugins, incompatible API versions, deprecated APIs, memory-heavy plugins.
3. CONFIG VALIDATOR — Validates every YAML config file in every plugin. Detects invalid syntax, duplicate keys, wrong types, invalid Material/Particle/Sound/Enchantment names with file name, line number, severity, and suggested fix.
4. LAG ANALYZER — Identifies real causes of lag: entity overload, excessive villagers, hopper spam, dropped items, redstone clocks, chunk bottlenecks, overloaded farms, mob spawning pressure, scheduler overload.
5. CRASH ANALYZER — Reads crash reports and latest.log, identifies root cause, attributes to a plugin, summarizes stack trace in plain English, gives concrete solutions with confidence score.
6. SECURITY SCANNER — Audits OP players, wildcard/dangerous permissions, offline mode, exposed RCON, unsafe server.properties, whitelist status, spawn protection. Generates 0–100 Security Score.
7. UPDATE CHECKER — Asynchronously checks Paper version (PaperMC API) and plugin versions (Spiget API). Categorizes as Security/Recommended/Feature/Optional.
8. BENCHMARK — Safely measures memory allocation, CPU throughput, entity enumeration, chunk access, ItemStack creation, memory headroom, TPS, MSPT.
9. HTML REPORTS — Modern, responsive, printable reports with Chart.js charts, 4 themes (light/dark/midnight/ocean).
10. DISCORD WEBHOOK ALERTS — Get server startup/shutdown notifications, full output of every command you run, and critical alerts (low audit scores, crashes, security vulnerabilities) in your Discord channel.
11. 27+ BUILT-IN ADMIN TOOLS — 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.
12. IN-GAME GUI DASHBOARD — Beautiful inventory GUI built with Adventure API + MiniMessage. Open with `tm gui`.
COMMANDS — JUST ONE
Every feature is a subcommand of /tm (alias /toolmetry). No aliases, no confusion.
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, plugin never crashes
REQUIREMENTS
- Paper 1.20.x (tested on 1.20.1)
- Java 17+ (works on Java 17, 21, 25)
- No external dependencies — uses only Paper API + Adventure API
INSTALLATION
1. Drop toolmetryai-server-doctor-1.0.0.jar into plugins/
2. Restart server
3. Type `tm` in console or `/tm` in-game
DISCORD SETUP (OPTIONAL)
1. Discord → Channel Settings → Integrations → Webhooks → New Webhook → Copy URL
2. In console: tm webhook https://discord.com/api/webhooks/...
3. Test: tm webhook test
Done. 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 (default: OP)
SUPPORT
- Website: https://toolmetry.pro
- Issues: GitHub Issues tab
LICENSE: MIT — free for personal and commercial use.
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
1. SERVER AUDIT — Generates a 0–100 health score across 5 categories: Performance, Security, Configuration, Stability, Compatibility.
2. PLUGIN DOCTOR — Scans every installed plugin for duplicates, missing dependencies, conflicts, disabled plugins, incompatible API versions, deprecated APIs, memory-heavy plugins.
3. CONFIG VALIDATOR — Validates every YAML config file in every plugin. Detects invalid syntax, duplicate keys, wrong types, invalid Material/Particle/Sound/Enchantment names with file name, line number, severity, and suggested fix.
4. LAG ANALYZER — Identifies real causes of lag: entity overload, excessive villagers, hopper spam, dropped items, redstone clocks, chunk bottlenecks, overloaded farms, mob spawning pressure, scheduler overload.
5. CRASH ANALYZER — Reads crash reports and latest.log, identifies root cause, attributes to a plugin, summarizes stack trace in plain English, gives concrete solutions with confidence score.
6. SECURITY SCANNER — Audits OP players, wildcard/dangerous permissions, offline mode, exposed RCON, unsafe server.properties, whitelist status, spawn protection. Generates 0–100 Security Score.
7. UPDATE CHECKER — Asynchronously checks Paper version (PaperMC API) and plugin versions (Spiget API). Categorizes as Security/Recommended/Feature/Optional.
8. BENCHMARK — Safely measures memory allocation, CPU throughput, entity enumeration, chunk access, ItemStack creation, memory headroom, TPS, MSPT.
9. HTML REPORTS — Modern, responsive, printable reports with Chart.js charts, 4 themes (light/dark/midnight/ocean).
10. DISCORD WEBHOOK ALERTS — Get server startup/shutdown notifications, full output of every command you run, and critical alerts (low audit scores, crashes, security vulnerabilities) in your Discord channel.
11. 27+ BUILT-IN ADMIN TOOLS — 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.
12. IN-GAME GUI DASHBOARD — Beautiful inventory GUI built with Adventure API + MiniMessage. Open with `tm gui`.
COMMANDS — JUST ONE
Every feature is a subcommand of /tm (alias /toolmetry). No aliases, no confusion.
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, plugin never crashes
REQUIREMENTS
- Paper 1.20.x (tested on 1.20.1)
- Java 17+ (works on Java 17, 21, 25)
- No external dependencies — uses only Paper API + Adventure API
INSTALLATION
1. Drop toolmetryai-server-doctor-1.0.0.jar into plugins/
2. Restart server
3. Type `tm` in console or `/tm` in-game
DISCORD SETUP (OPTIONAL)
1. Discord → Channel Settings → Integrations → Webhooks → New Webhook → Copy URL
2. In console: tm webhook https://discord.com/api/webhooks/...
3. Test: tm webhook test
Done. 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 (default: OP)
SUPPORT
- Website: https://toolmetry.pro
- Issues: GitHub Issues tab
LICENSE: MIT — free for personal and commercial use.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.16, 1.17, 1.18
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Toolmetry Server Doctor — All-in-One Paper Diagnostics Plugin is a free Minecraft Java mod. Compatible with Minecraft 1.16, 1.17, 1.18, 1.19 and newer. Downloaded 10 times (via Spigot). Download it and open it directly in the game.