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.