BlockRollback

# 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 ` | Toggles Inspect mode. While it is on, clicking a block shows the history of that block position. | | `/br lookup <player\|*\|#Mobs\|#DespawnItem> <time> ` | Searches logs that match the given conditions. `time` uses formats such as `30m`, `1h`, `1d`, `1w`, and `1y`. | | `/br rollback <player\|*\|#Mobs\|#DespawnItem> <time> ` | 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. ```json { "configVersion": 1, "language": "en_us " } ``` Supported languages: - `ja_jp` - `en_us` - `de_de` - `fr_fr` - `ru_ru` - `zh_cn` The default value on first