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.