BlockRollback

BlockRollback is a lightweight audit and rollback plugin for Bukkit-family 1.21.x servers such as Paper, Spigot, and Purpur.
It records player actions, some natural changes, and command-based edits into SQLite so they can later be inspected, looked up, and rolled back with inspect, lookup, and rollback.

You can use /br as an alias for /blockrollback.

Main Features

• Records block placement and breaking, bucket actions, explosions, fire, fluid flow, and natural block updates
• Records container item transactions and block click interactions
• Records block placement and breaking, mob deaths, item despawns, and changes caused by /fill and /kill
• Inspect mode lets you check the history of the clicked coordinates in place
• Search logs by player name, special tags, time range, and radius
• Supports rolling back block changes as well as restoring killed mobs and despawned items
• Uses SQLite locally, so no external database server is required
• Supports multilingual messages

Supported Environment

• Bukkit-family 1.21.x
• Based on the Paper API 1.21.4
• Java 21
• Paper, Spigot, Purpur, and compatible loaders

Commands

Command	Description
/br inspect [on|off]	Toggles Inspect mode. While it is on, clicking a block shows the history of that block position.
/br lookup <player|*|#Mobs|#DespawnItem> <time> [radius] [page]	Searches logs that match the given conditions. time uses formats such as 30m, 1h, 1d, 1w, and 1y.
/br rollback <player|*|#Mobs|#DespawnItem> <time> [radius]	Applies rollbackable records that match the given conditions.
/br tp <world> <x> <y> <z>	Teleports you to the coordinates from a lookup result.
/br cancel	Cancels the currently running rollback.
/br status	Shows database size, log count, write queue status, and rollback progress.
/br reload	Reloads config.yml, config.json, and language files.
/br help	Shows help.

Examples

• /br inspect on
• /br lookup Steve 1h 20
• /br lookup #TNT 1d
• /br rollback Steve 30m 20
• /br rollback #Mobs 15m 30
• /br rollback #DespawnItem 10m 20

How Filters Work

• A player name such as Steve targets block-related changes associated with that player
• * targets every rollbackable record within the scope
• #Mobs targets mob death records
• #DespawnItem targets item despawn records
• Special tags such as #TNT, #Creeper, #Fire, #Fluid, and #Natural can also be used for lookup and rollback

What Gets Logged

Rollbackable

• Block placement and breaking
• Bucket placement and pickup
• Destruction caused by explosions
• Burning caused by fire
• Fluid flow
• Natural block changes
• Block changes caused by /fill
• Mob deaths and mob removals caused by /kill
• Item despawns

Audit Only

• Putting items into containers and taking items out
• Left-click and right-click interactions on blocks

Permissions

Permission	Description	Default
blockrollback.inspect	Toggle Inspect mode	OP
blockrollback.lookup	Run lookup and use /br tp	OP
blockrollback.rollback	Run rollback and cancel	OP
blockrollback.admin	Run status and reload	OP

Configuration

config.yml

Main settings:

Key	Description
database-file	SQLite file name
log.block-place-break	Log block placement and breaking
log.buckets	Log bucket actions
log.container-transactions	Log container transactions
log.item-despawn	Log item despawns
log.mob-kill	Log mob deaths
log.interactions	Log block clicks
log.explosions	Log explosions
log.fire	Log burning caused by fire
log.fluid-flow	Log fluid flow
log.natural-block-updates	Log natural block updates
inspect.use-adjacent-when-holding-block	When holding a block and right-clicking, inspect the adjacent target position
rollback.default-radius	Default radius used when a player omits the radius
rollback.max-radius	Maximum rollback radius
rollback.max-records-per-run	Maximum records processed in one rollback run
rollback.apply-per-tick	Number of records applied per tick
command-tracking.fill	Enable /fill tracking
command-tracking.fill-max-blocks	Maximum number of blocks tracked for /fill
command-tracking.kill	Enable /kill tracking
command-tracking.kill-max-entities	Maximum number of entities tracked for /kill
command-tracking.console-world	World name used for console-issued commands
command-tracking.notify-skip	Notify when tracking is skipped because the target is too large

config.json

config.json is used to configure the language.

{
  "configVersion": 1,
  "language": "en_us "
}

Supported languages:

• ja_jp
• en_us
• de_de
• fr_fr
• ru_ru
• zh_cn

The default value on first launch is en_us.
You can also edit the .lang files generated in plugins/BlockRollback/lang/ to create your own translation.

Behavior Notes

• Only one rollback can run at a time
• For lookup and rollback, radius filtering uses the executor's current position when run by a player
• Radius-based lookup cannot be used from the console
• While Inspect mode is enabled, normal block interaction is cancelled so the click can be used for audit display
• A record is skipped if the destination world does not exist or if the target entity is already present

Stored Data

• Logs are stored as SQLite in plugins/BlockRollback/<database-file>
• The table name is action_logs
• Indexes are created for time, player name plus time, and location