ChunkRestorer

ChunkRestorer

Created by Remoo · Discord: remoodabest

ChunkRestorer records compact, delta-based checkpoints for loaded chunks and lets admins restore a chunk to an earlier saved state using an in-game GUI.

Features

• Creates periodic checkpoints for loaded chunks (3 minutes by default).
• Stores changes as block deltas instead of full chunk snapshots.
• Browse a chunk's saved history from an in-game paginated menu.
• Restore an earlier checkpoint without deleting the other saved history.
• Force-save pending changes and view plugin status from the main GUI.
• Tracks supported block changes and container inventory changes.
• Saves chest and barrel inventories, including double-chest halves.
• Tracks item-frame placement, interaction, and breaks for restoration.
• Applies restores in batches with physics disabled.
• Stores checkpoint history in SQLite.
• Optional clickable update notices for admins when a newer Modrinth version is available.

Commands

Command · Description
/chunkrestorer · Open the main menu.
/chunkrestorer menu · Open the main menu.
/chunkrestorer restore here · Open saved checkpoints for the chunk you are standing in.
/chunkrestorer forcesave · Save pending changes for the current chunk. Empty saves are not created.
/chunkrestorer status · Show cache and storage status.

Commands require the chunkrestorer.admin permission. It is granted to operators by default.

Requirements

• Paper 26.2 (Minecraft 1.26.2 server line)
• Java 25

Install ChunkRestorer.jar in the server's plugins folder and restart the server.

Configuration

storage:
auto-save-seconds: 180
revert:
blocks-per-tick: 128

storage.auto-save-seconds controls the periodic checkpoint interval and must be at least 30 seconds. revert.blocks-per-tick controls how many block states are applied in each restore tick. Update checking uses this Modrinth project and does not require configuration. Copyright and creator attribution are part of the plugin and are not configurable.

Data and privacy

Checkpoint data is stored in plugins/ChunkRestorer/snapshots.db. Update checks contact the Modrinth API asynchronously and send the plugin version and project identifier. bStats provides anonymous plugin metrics. The plugin does not intentionally collect player names, server addresses, or other identifying server details for update checks.

Limitations

ChunkRestorer uses observed change events and stores only changes it captures; it is not a full chunk backup. It cannot restore edits made before installation, while the plugin is disabled, or through change sources it does not observe.

Paper's public API does not provide a general snapshot interface for all block-entity data. Some data such as sign text, spawner settings, arbitrary plugin data, and other entities is not restored. Minecraft's normal world and chunk persistence remains managed by Paper.