Home

ServerDoctor Wiki

Read-only analysis, diagnostics and monitoring for Minecraft servers and proxies. ServerDoctor analyzes, evaluates, recommends and warns — it never changes anything on your server.

The same engine runs on Paper / Folia and Velocity, shipped as a single jar. The analysis core is platform-neutral; thin adapters wire it into each platform. A strict architecture boundary (enforced as a build breaker) guarantees the analysis layer can never reach into a platform SDK, and the platform adapters stay strictly read-only.

What it does

• Five scanners — Plugin, Dependency, Conflict, Performance, Security.
• Recommendations — actionable suggestions derived from findings (never executed automatically).
• Performance history — TPS/MSPT/RAM snapshots persisted over time.
• Pluggable storage — In-Memory, SQLite, PostgreSQL, MariaDB, MongoDB.
• REST API — read-only HTTP/JSON access to the latest data.
• Webhooks — Discord, Slack and Microsoft Teams notifications on status changes.
• Public API + event bus — other plugins can read results and register their own scanners.
• PlaceholderAPI support on Paper/Folia.
• Update checker against GitHub releases.

Start here

• Installation — build and install on Paper/Folia and Velocity
• Configuration — config.yml, storage, REST API, webhooks
• Storage Backends — per-backend details and when to use which
• REST API — HTTP/JSON endpoints and auth
• Webhooks — Discord / Slack / Teams notifications
• Commands — every subcommand, aliases, permissions
• Scanners — what each scanner checks and its thresholds
• PlaceholderAPI — available placeholders
• Developer API — integrate from your own plugin
• Architecture — modules and the read-only guarantees
• Building from Source
• FAQ

Compatibility

Server	Paper / Folia 1.21.x
Proxy	Velocity 3.4.x
Java	21
Version	0.8.0
License	MIT