Skip to main content

Snapshot Commands

Snapshots are full copies of a world at a specific point in time. Blueprint stores them on disk and tracks them in its SQLite database.


/blueprint snapshot create <world>

Creates a new snapshot of the specified world.

/blueprint snapshot create lobby

The snapshot is saved with a timestamped ID (e.g. lobby_20240501_143022). The world does not need to be closed to create a snapshot, but closing it first ensures a consistent file state.

Blueprint enforces a per-world snapshot limit defined by max-snapshots-per-world in config.yml (default: 25). You will receive a warning when this limit is exceeded.


/blueprint snapshot list <world>

Lists all snapshots for the specified world.

/blueprint snapshot list lobby

Each entry shows the snapshot ID and the timestamp it was created.


/blueprint snapshot restore <world> <id>

Restores a world to the state captured in the specified snapshot.

/blueprint snapshot restore lobby lobby_20240501_143022

Before restoring, Blueprint automatically creates a safety snapshot of the current world state. This means you can always undo a restore by restoring the auto-generated safety snapshot.

warning

The world must be closed before restoring a snapshot. Use /blueprint close <world> first.


/blueprint snapshot delete <world> <id>

Permanently removes a snapshot from disk and from the database.

/blueprint snapshot delete lobby lobby_20240501_143022
danger

Snapshot deletion is permanent and cannot be undone.