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, Velocity and BungeeCord, 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

• Eight scanners — Plugin, Dependency, Conflict, Performance, Security, Compatibility, Regression, Configuration.
• Recommendations — actionable suggestions derived from findings (never executed automatically).
• Performance history — TPS/MSPT/RAM snapshots persisted over time.
• Regression detection — spots gradual TPS/MSPT/RAM decline by comparing stored snapshots.
• Config review — flags risky settings in server.properties, Spigot/Paper YAMLs and velocity.toml.
• In-game GUI — read-only menu on Paper/Folia (/serverdoctor gui).
• 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.
• Optional advisory/compatibility feeds — enriched data from sources you configure; never invented.
• 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, Velocity and BungeeCord
• Configuration — config.yml, storage, GUI, tasks, REST API, webhooks
• Storage Backends — per-backend details and when to use which
• Scanners — what each scanner checks and its thresholds
• GUI — the in-game menu (Paper/Folia)
• REST API — HTTP/JSON endpoints and auth
• Webhooks — Discord / Slack / Teams notifications
• Commands — every subcommand, aliases, permissions
• 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.5.x · BungeeCord 1.21
Java	21
Version	0.10.0
License	MIT