PluginDoctor
Detect plugin conflicts, analyze server health, monitor performance, and generate diagnostic reports for Paper servers.
⬇ Download on Modrinth
PluginDoctor
PluginDoctor is a diagnostic and health-monitoring plugin for Paper servers designed to help server owners identify plugin conflicts, compatibility issues, performance concerns, and overall server health.
The plugin performs automated scans of installed plugins, analyzes server conditions, and generates detailed reports that can be used for troubleshooting and maintenance.
Features
Plugin Conflict Detection
PluginDoctor checks installed plugins against a database of known conflict patterns and warns administrators about potentially problematic combinations.
Examples include:
- Multiple economy providers
- Multiple permission systems
- Overlapping chat plugins
- Feature duplication between plugins
Server Health Scoring
Each scan generates a health score based on detected issues and severity levels.
Scores include:
- Overall server score
- Stability rating
- Compatibility rating
- Performance rating
- Security rating
Performance Analysis
PluginDoctor collects runtime information including:
- TPS statistics
- Memory usage
- Loaded chunks
- Entity counts
- Player counts
This information is attached to diagnostic reports to provide additional context during troubleshooting.
Report Generation
Diagnostic reports can be exported in multiple formats:
- HTML
- JSON
- TXT
Reports are stored for future reference and can be shared with developers or server administrators.
Scan History
Previous scans are stored in SQLite and remain available after server restarts.
Historical scan data can be used to compare server health over time.
Configuration Reloading
Most configuration changes can be applied without restarting the server.
Commands
| Command | Description |
|---|---|
/doctor |
Run a full diagnostic scan |
/doctor quick |
Run a quick scan |
/doctor full |
Run a complete diagnostic scan |
/doctor conflicts |
Run conflict analysis |
/doctor lag |
Run performance analysis |
/doctor score |
View current server health score |
/doctor report html |
Generate an HTML report |
/doctor report json |
Generate a JSON report |
/doctor report txt |
Generate a TXT report |
/doctor history |
View previous scan history |
/doctor reload |
Reload configuration |
/doctor gui |
Open the diagnostic interface |
Storage
PluginDoctor uses SQLite for persistent storage of:
- Scan history
- Generated reports
- Performance snapshots
Compatibility
- Paper 1.21.x
- Java 21+
Status
PluginDoctor is currently under active testing and development.
Server owners are encouraged to test the plugin on development or staging servers and report any issues they encounter.
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21.4
- 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 Modrinth — 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.
- Ships as PluginDoctor-1.0.0-SNAPSHOT.jar — drop this file into the mods folder
- Download size: 607 KB
- Download link checked 24 Aug 2026 — working
These come from our own check of the pack file, not from the source page.