RollBack

Conflict-aware history and rollback for Minecraft servers.

Inspect block changes, search gameplay history, and safely roll back world and inventory changes without NMS.

Support RollBack on Ko-fi

Overview

RollBack is a lightweight CoreProtect-style history plugin for Bukkit-compatible servers. It records server changes and gives administrators a clear way to inspect and reverse them without restarting the server.

The plugin uses Bukkit APIs and platform-aware scheduling. SQLite works out of the box. WorldEdit and DuckDB are optional.

Quick Start

1. Install the backend artifact matching the server family and Minecraft version.
2. Start the server and check /rb status.
3. Preview a rollback before applying it:

/rb rollback 10m --near=10 --preview

4. Apply the same operation when the preview is correct:

/rb rollback 10m --near=10

--near=10 means ten blocks in each direction from your current position. It searches a block cube, not ten chunks.

Features

• Block history with placement and break summaries.
• Conflict-aware block rollback, restore, and undo.
• Inventory snapshots with transaction IDs and current-state checks.
• Container, item, death, kill, crafting, chat, command, session, and sign history.
• Time, radius, world, actor, event type, include, action, and count filters.
• Chunk, looking, radius, and optional WorldEdit selection scopes.
• SQLite by default with optional DuckDB support and migration.
• Paginated chat results with clickable navigation.
• Folia-aware region and global scheduling.
• Optional Velocity and Waterfall command-routing adapters.
• Java/Kotlin API with lookup and rollback callbacks.
• English, Russian, Polish, German, Italian, Spanish, Portuguese, Brazilian Portuguese, Japanese, and Finnish locales.

Compatibility

Platform	Artifact	Status
Paper, Folia, Pufferfish, Purpur, Leaf, Patina	RollBack-1.20.x.jar, RollBack-1.21.x.jar, RollBack-26.1.x.jar, RollBack-26.2.jar	Paper API build for the matching version family
Spigot and Bukkit-compatible forks	RollBack-Spigot-1.20.x.jar, RollBack-Spigot-1.21.x.jar	Spigot API build for the matching version family
Velocity	rollback-velocity-0.6.0.jar	One proxy adapter; independent of backend Minecraft version
Waterfall / BungeeCord-compatible proxy	rollback-waterfall-0.6.0.jar	One proxy adapter; independent of backend Minecraft version

Each backend artifact is compiled against the matching Paper or Spigot API family and should be used only with its corresponding Minecraft version family. Runtime verification must use the matching server version. Proxy adapters must not be installed in a Bukkit or Paper server.

See COMPATIBILITY.md for the support matrix and verification notes. See PROXY.md for network deployment.

Installation

1. Download the matching backend JAR from the release artifacts.
2. Put it in the backend server plugins directory.
3. Start the server once.
4. Review plugins/RollBack/config.yml.
5. Grant the required rollback.* permissions.

WorldEdit is optional. Install WorldEdit or FAWE when using --scope=selection.

Commands

Command	Description
/rb status	Show plugin and database status.
/rb inspect	Inspect the block under the crosshair.
/rb lookup <time> [radius] [player] [type]	Search history without changing the world.
/rb rollback <time> [radius] [player] [type]	Apply conflict-aware rollback.
/rb restore <time> [radius] [player] [type]	Reapply recorded block or inventory state.
/rb undo	Undo the latest completed rollback operation.
/rb purge <duration>	Remove old events.
/rb reload	Reload configuration and locale settings.
/rb migrate-db	Copy SQLite data to a new DuckDB file.

The full command is /rollback; /rb is its alias.

Common examples

/rb lookup 1h --near=10
/rb lookup 1h --scope=chunk --type=BLOCK
/rb lookup 1h --world=world_nether --include=diamond
/rb lookup 1h --player=Steve,Alex --action=+BLOCK
/rb lookup 1h --scope=selection
/rb rollback 10m --near=10 --preview
/rb rollback 10m --near=10 --action=+BLOCK
/rb undo

--near=10 searches a 10-block cube around the player's current position. It is not a chunk radius. A rollback changes only events in the selected scope and time range; blocks with a newer conflicting state are skipped.

What gets rolled back

• Blocks are rolled back automatically when their current state still matches the recorded change.
• Player inventory transactions use before/after snapshots and are skipped when the inventory changed afterwards.
• Container transfer events are recorded and searchable; automatic container restoration is not enabled yet.
• Preview never changes the world or inventory.

See CONFIGURATION.md for filters, database settings, permissions, and inventory rollback behavior.

Database

SQLite is the default and is recommended for a single backend server. DuckDB is available for local analytics and lookup-heavy workloads:

database:
  type: sqlite

To migrate to DuckDB:

/rb migrate-db

The command creates a timestamped SQLite backup. Set database.type: duckdb and restart the server after a successful migration. PostgreSQL or MariaDB is the recommended future option for shared multi-server network history; SQLite and DuckDB should not be used as a concurrently-written proxy-wide database.

Building

mvn clean test package
mvn -f proxy/pom.xml clean test package

Backend artifacts are written to:

target/RollBack-1.20.x.jar
target/RollBack-Spigot-1.20.x.jar
target/RollBack-1.21.x.jar
target/RollBack-Spigot-1.21.x.jar
target/RollBack-26.1.x.jar
target/RollBack-26.2.jar

Proxy artifacts are written to:

```text
proxy/velocity/target/rollback-velocity-0.6.0.jar
proxy/waterfall/target/rollback-waterfall-0.6.0.jar

Build a backend target with its Maven profile:

mvn clean test package -Pmc-1.20
mvn clean test package -Pspigot-1.20
mvn clean test package -Pmc-1.21
mvn clean test package -Pspigot-1.21
mvn clean test package -Pmc-26-1
mvn clean test package -Pmc-26

Velocity and Waterfall adapters are compiled against their proxy APIs, not against Minecraft backend APIs. Use the same adapter JAR with supported backend versions; install the matching backend artifact separately on each server.

License

RollBack is licensed under GNU General Public License v3.0.

Support

If RollBack is useful for your server, you can support development on Ko-fi.

TrueWulf is the original author and maintainer of RollBack.