ServerDoctor

Analyze your Minecraft server, detect plugin conflicts, identify performance issues, and receive actionable recommendations — completely read-only.

Read-Only by Design
ServerDoctor analyzes, evaluates, recommends, and warns — but it never modifies your server. No files are edited, no configurations are changed, and no automated fixes are applied.

✨ Features

Plugin Analysis

• Detects installed plugins
• Reads versions, authors, and dependencies
• Identifies missing hard dependencies

⚔️ Conflict Detection

• Detects known plugin conflicts
• Warns about overlapping functionality
• Extensible conflict database

Performance Monitoring

• TPS analysis
• MSPT evaluation
• Memory usage diagnostics
• Threshold-based health checks

️ Security Checks

• Detects plugins with incomplete metadata
• Highlights potential security concerns

Recommendation Engine

Transforms findings into clear and actionable recommendations for improving stability and performance.

Public Developer API

• Access performance snapshots
• Read conflicts and risks
• Subscribe to events
• Register custom scanner modules

Event System

• AnalysisFinishedEvent
• PluginConflictDetectedEvent
• SecurityRiskDetectedEvent

Persistent Scan History

• SQLite storage
• In-memory fallback
• Automatic scan history

⚙️ Commands

Alias: /sd

Automatic Background Scans

Performs asynchronous diagnostics every 5 minutes.

Requirements

• Paper 1.21.x
• ☕ Java 21

‍ For Developers

ServerDoctor exposes a public API that allows other plugins to consume diagnostics data and register custom scanner modules.

Planned Features

• BungeeCord Support
• REST API
• Discord/Slack/Teams Webhooks
• PostgreSQL Support
• ️ MariaDB Support
• Security Advisory Sources

Philosophy

Many tools try to automatically fix your server. ServerDoctor doesn't.

Instead, it provides visibility, diagnostics, and recommendations while keeping full control in your hands.

Your server's health report — without touching your server.