Quickstart

# Record the current world state (pause the server first; see
# "Server coordination")
sekai --store ./sekai-store backup ./world

# Preview what a backup would record, without writing anything
sekai --store ./sekai-store status ./world

# List snapshots
sekai --store ./sekai-store list

# Rebuild the world from snapshot 1 (overwrites region files)
sekai --store ./sekai-store rollback ./world 1

# Compare chunk NBT between snapshots 1 and 2
sekai --store ./sekai-store diff 1 2 --in overworld:0,0

# Name snapshot 2 for later reference
sekai --store ./sekai-store tag stable 2

# Preview unreferenced blobs, then collect them
sekai --store ./sekai-store gc --dry-run
sekai --store ./sekai-store gc

# Delete old snapshots (keep newest 10), then reclaim their blobs
sekai --store ./sekai-store prune --keep-last 10
sekai --store ./sekai-store gc

# Rebuild snapshot 1 into a fresh directory (live world untouched)
sekai --store ./sekai-store export 1 ./restored

# Inspect region files without touching anything
sekai debug scan ./world

--store names the backup store directory (created when missing). Every command accepts --json for machine-readable output and, except list and tag, --timing for a per-phase breakdown. backup, status, rollback, diff, export, gc, and prune take --progress for a stderr progress bar (refused with --json). backup, status, rollback, diff, and export accept a scope (--in, --region, --kind); nothing selected means the whole world.