Skip to content

Lag Doctor 0.2.0 — Public Beta

Pre-release
Pre-release

Choose a tag to compare

View all tags
@starchlorddotcom starchlorddotcom released this 02 Oct 17:48
· 2 commits to main since this release
v0.2.0
da8b1e3
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Created by William Liu (@starchlorddotcom).

Lag Doctor helps Minecraft Java server owners investigate lag with evidence, safe next steps, and before/after comparisons.

Features

  • Tick-time monitoring: mean, p95, maximum and slow-tick percentage.
  • Evidence hypotheses from GC, chunk activity and entity counts, with healthy/slow comparisons and explicit uncertainty.
  • Optional scans of loaded entity chunks, including type counts and locations for admins.
  • Incident history, recovery detection and workload-aware baseline comparisons.
  • Offline HTML and text reports with locations omitted by default.
  • Private, repeatable demos for sustained lag and recurring spikes.

Install

Requires Paper 1.21.11 and Java 21+. Download LagDoctor-0.2.0.jar, stop your server, replace any older LagDoctor JAR in plugins/, and restart. Run /ld report after about a minute.

Download LagDoctor-0.2.0-source.zip for the complete source, Gradle build, tests, documentation and example reports. Extract it before following the build instructions.

Validation and limitations

18 automated tests pass. Live Paper testing verified scan counts and locations, scan controls, incident recovery, comparisons and exports. This is an early beta: counts and associations do not prove CPU cost or cause. Large-server overhead and Paper 26.x compatibility have not been validated. HTML content and escaping were tested; visual rendering was not verified.

No account, telemetry, automatic destructive fixes or player punishment. MIT licensed. Minecraft and Paper are separate projects and are not bundled.

Verify downloads against SHA256SUMS.txt.

Assets 5
Loading