PlugTrace · v0.4.0

---

Know whether your Minecraft server update actually worked.

Local-first deployment safety and forensics: checkpoint → verify → explain → report → recover. Paper, Folia, and experimental Bukkit/Spigot artifacts. Complements Spark (soft-link evidence) — PlugTrace is not a profiler.

Site · Discord · PlugDev

Status

0.4.0 — early public release. Optional hosted report sharing on plugtrace.dev after an explicit /plugtrace report upload — nothing uploads automatically.

Quick start

1. Download the JAR for your server (PlugTrace-*.jar paper-modern, PlugTrace-folia-*.jar, or experimental PlugTrace-bukkit-modern-*.jar) from Releases.
2. Drop into plugins/ and restart.
3. /plugtrace selfcheck · /plugtrace mark healthy
4. After a risky update: /plugtrace diff · /plugtrace report preview · /plugtrace report
5. Local web UI (default): http://127.0.0.1:9465 — create a token with /plugtrace web token create …

Test with PlugDev

npm i -g @plugdev/cli
cd plugtrace   # this repo
plugdev init --setup
.\gradlew.bat :paper-modern:shadowJar
plug run

To co-install PlugTrace while developing another plugin, in that project's plugdev.yml:

integrations:
  plugtrace:
    enabled: true
    jar: path/to/PlugTrace-0.4.0.jar
    artifact: auto

Hosted reports (optional)

/plugtrace report preview
/plugtrace report upload

Prints a share URL like https://plugtrace.dev/r/{id}#k=… (ciphertext in the cloud; key in the fragment). Local JSON/Markdown/HTML always remain under plugins/PlugTrace/reports/. Privacy: plugtrace.dev/privacy.

Build

Requirements: JDK 21. Bundled web assets live under paper-modern/src/main/resources/web.

cd web-ui
pnpm install
pnpm run build
cd ..
.\gradlew.bat :paper-modern:copyWebUi
.\gradlew.bat clean matrixSmoke

Config

Defaults in config.yml (synced across artifacts). After edits: /plugtrace reload.

Section	Notes
retention	Deployments, samples, JAR retention
verification	Post-ready delay + observation window
expected	Plugins/commands/worlds/services
privacy	hash-only only in 0.4.0
web	Local UI bind/port; remote is opt-in
cloud	Optional uploadUrl / viewerUrl for hosted reports

License

Apache License 2.0 — see LICENSE. Managed cloud on plugtrace.dev is a separate service; the plugin never requires it.