Minecraft troubleshooting
Troubleshoot Minecraft backup and restore through plugins, saves, game coordination and archive dependencies, retaining useful diagnostics.
Check the chain
Check Host API 3.9, MineRewind provenance/version, Enabled Intent and Active, Kind, valid world path/session.lock, KnotLink/game component and materializable history. Old EnableHotBackup/v2 hooks are not current diagnostic entrypoints.
| Symptom | Check/action |
|---|---|
| No worlds | Roots/AutoDiscoverSaves/instance definitions/scan diagnostics; review drafts |
| Backup warnings | Prefer degradation/handshake/snapshot failure; Require must block; test recovery |
| Wrong region | Block coordinates/floor512/dimensions/scopes/filters/all.mcc rule |
| Quick Restore unchanged | Already at active-branch target; no older version selection |
| Restore blocked | Divergence/closure/multiple worlds/coordination/recovery state |
| Player preservation missing | Local setting/explicit false/ordinaryRestore/allUUID/layout/proposal errors |
| Restored but no rejoin | Separate Host success from rejoin warning; inspect before entering |
Diagnostics
Use GET_CAPABILITIES/LIST_BACKUPS for runtime targets/arguments; percent-encode filenames. Install/activation/readiness/outcomes differ. RecoveryRequired/CommittedRecoveryRequired prohibit destructive retries/automatic rejoin.
Report versions, time, request_id, outcomes and redacted logs. Do not upload tokens/private paths/production worlds. Preserve copied-world game-loading errors; passing NBT tests is insufficient.
Missing saves or wrong edition
Distinguish automatic discovery from explicit-root scanning and select portable/custom locations manually. Check the draft's actual Kind: Java and Bedrock are not interchangeable. Bedrock lacks Java hot coordination, NBT player preservation and region scope; ordinary folders do not require world metadata. Read per-source diagnostics rather than treating partial/budget-limited results as a completed whole-drive scan.