Investigate Paper server lag: tick summaries, entity hotspots, incident history, comparisons and offline reports.
Lag Doctor 0.2.0 — public beta
Created by William Liu (@starchlorddotcom), with substantial AI assistance.
Features
- Tick summaries: mean, worst per-window p95, maximum and slow-tick percentage.
- Healthy/slow comparisons using GC, chunk activity and entity counts, with explicit uncertainty.
- Optional bounded scans of loaded entity chunks.
- Incident history and recovery detection.
- Baseline comparisons that flag changed workloads.
- Offline HTML and text exports with locations omitted by default.
Compatibility and installation
Paper 1.21.11, Java 21+. Stop the server, remove any older LagDoctor JAR, put this JAR in plugins/, restart, and run /ld report after about a minute. Test on a disposable compatible server first. No additional plugin dependencies.
Validation and limitations
18 automated tests and local Paper smoke tests pass. Large-server overhead and other Paper versions are not validated. Evidence is heuristic and does not prove the cause of lag. HTML escaping was tested; visual rendering was not verified. No telemetry or automatic world changes.
Testing steps and feedback · Complete source, docs and example reports
JAR SHA-256: 31823926ad704b3e2a3aca754252fde3b4e8cf7ac503fa259d54a4f18d69bdab