Hindsight

Hindsight records who changed what, where, and when — then lets you inspect it, search it, and reverse it. A modern CoreProtect-style alternative for Paper servers: fully async storage, clickable chat output, and a ghost-block preview before every rollback so you see the result before it happens.

Why Hindsight

• Preview before every rollback. Rollbacks render as client-side ghost blocks first, with clickable ✔ confirm / ✘ cancel in chat. Nothing touches the world until you confirm — previews expire on their own if you walk away.
• /hs undo. Every rollback and restore captures exact prior states. Undo puts them back; undoing again redoes.
• Clickable everything. Lookup rows have hover cards (exact timestamp, full block data, position) and click-to-teleport. Page buttons in chat. Result counts flash in the action bar while inspecting.
• Chests come back full. Container contents (full NBT — enchantments, custom names, shulker innards) and sign text are captured at destruction and restored on rollback.
• Zero main-thread disk I/O. Events flow through a bounded queue into a dedicated writer thread, batched into WAL-mode SQLite transactions. Lookups run on a separate reader thread. Rollbacks apply on a per-tick block budget (default 1000/tick) so TPS never dips.

What gets logged
Block place & break • buckets (including waterlogging) • explosions, attributed to the player who lit the TNT when one did ( #creeper / #tnt otherwise) • TNT being primed • fire • fluid flow destroying blocks • pistons ( #piston) • endermen, zombie doors, and other mob changes • crop trampling, by name • container transactions with item + count (hoppers included) • sign text • item frames, paintings & armor stands • kills of named animals and pets.

Commands
Times parse naturally: 30m, 2h30m, 3d, 1w. Rollback targets can be a player, a cause like #creeper, or * for anyone — /hs rollback * 20 1h explosion fixes any crater without knowing who made it.

Permissions
hindsight.* grants everything; each subcommand has its own hindsight.command.<name> node (inspect, lookup, near, rollback, restore, undo, status, purge). Everything defaults to op — safe out of the box.

Installation

1. Drop the jar into plugins/.
2. Restart the server. First boot downloads the SQLite driver from Maven Central (one time — the server needs internet access for it), creates plugins/Hindsight/config.yml plus the database, and starts logging immediately.
3. Optionally grant permission nodes with LuckPerms; otherwise only ops can use it.

Retention defaults to 90 days and purges itself daily. Batch sizes, rollback speed, page size, and per-category logging toggles (hoppers, pistons, natural causes, fluid flow) all live in the config.

Requirements & honest limitations

• Paper only — Hindsight uses the Paper API throughout and will not load on Spigot. Built and tested on Paper 26.1.x with Java 25.
• Sign edits are logged, but rollback restores the text of destroyed signs only — a rewritten sign keeps its new text.
• Items inside item frames and armor stand equipment aren't restored (the frames and stands themselves are logged and searchable).
• Falling sand/gravel landings aren't tracked, and dispenser-placed fluids aren't attributed.
• TNT fired from cannons or primed by redstone logs as #tnt — vanilla loses the igniter through redstone chains. The damage rolls back fine; find the shooter from the named TNT placements at the cannon. (CoreProtect has the same limitation.)
• SQLite storage only — no MySQL or cross-server sync, and no WorldEdit integration yet.

Found a bug or missing something you need? Start a discussion — reports that include the exact command you ran and what it replied get fixed fastest.