serverdoctor 0.1.0
First release.
serverdoctor reads what a Minecraft server has already written — its log, its configuration files,
its start script, the jars in plugins/ — and reports what is wrong with it. It does not start a
server, connect to one, or load any plugin code, which is what makes it usable on the box that just
crashed and against jars you did not compile.
Five commands: scan for a whole server directory, then log, config, flags and plugins
individually. mcp serves the same audits to an AI coding agent over stdio, and rules prints the
catalogue.
Fifty-six rules. Each states one fact and names where that fact was read from: a file and line in
Paper or Folia, a JEP, or an API response. Some of what that turned up is worth knowing on its own:
- Paper deletes vanilla's
Can't keep up! Is the server overloaded?, so on Paper the line never
appears however far behind the server falls — and if your log has it, the log is not from Paper. timeout-time: -1does not disable the watchdog. Paper substitutes 300 seconds. The only real kill
switch is-Ddisable.watchdog, which is reported as critical.- The EULA refusal is logged at INFO, which is why a panel showing only errors reports a clean
shutdown and no reason. folia-supported: trueis the single thing Folia checks at load, and it is written by the plugin's
author.
Requires Java 21 or newer. The jar is self-contained; the network is used only by
plugins --online.
java -jar serverdoctor-0.1.0.jar scan /srv/mc --host-memory 8G
sha256 of serverdoctor-0.1.0.jar:
54536741c7b6719130249e7ce73de47677f8da2682bd5ad23dc24146c1ad7bff