Skip to content

serverdoctor 0.1.0

Choose a tag to compare

@SalyyS1 SalyyS1 released this 24 Aug 05:57
· 2 commits to main since this release

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: -1 does 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: true is 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