GriefLog

Block-change logger + selection-based rollback for Minecraft 26.1+ (Tiny Takeover drop).

Key Features

• GriefWand Tool — A specialized wooden axe tool marked with a secure PersistentDataContainer (PDC) signature that cannot be counterfeited. Left-clicking defines selection corners to boundary a rollback region. While holding the wand, normal block breaking is disabled to prevent accidental damage.
• Multi-Point Selections — Supports both 2-point axis-aligned bounding boxes (3D cuboids) and 3-to-4 point horizontal polygon selections extruded across the entire height of the world.
• Complete Event Logging — Tracks player block placements and breakages, block/entity explosions, fire ignitions, fire spreads, and high-frequency water and lava fluid flows.
• Ultra-Low Latency Database WAL Journaling — Employs a local embedded SQLite database utilizing Write-Ahead Logging (WAL) journaling for optimized reading/writing, executing bulk transaction batches asynchronously to prevent server tick stutter.
• Batch Rollbacks — Restores block operations safely by querying data asynchronously and scheduling block mutations in configured chunks on the main server thread.
• Automated Purges — Runs automated purges on configurable intervals (default: 30 minutes) to delete entries older than the configured retention threshold (default: 3 days), preventing storage bloat.

System Requirements

Requirement	Value
Minecraft Server	Spigot / Paper 26.1.x (tested against 26.1.2)
Runtime JRE/JDK	Java 25 or newer (UnsupportedClassVersionError occurs on older runtimes)

Commands & Permissions

Command	Description	Permission Node	Default
/griefwand (or /gw)	Gives the user the selector GriefWand tool.	grieflog.wand	OP
/griefwand pos <1-4>	Manually registers selection points.	grieflog.wand	OP
/griefwand clear	Clears all active selection points.	grieflog.wand	OP
/griefwand info	Prints selection details in chat.	grieflog.wand	OP
/ungrief <time>	Rolls back block changes in selected region. Examples: /ungrief 10m, /ungrief 2h, /ungrief 1d.	grieflog.rollback	OP
grieflog.*	Wildcard permission granting all GriefLog commands.	—	OP

Configuration Sample

Configure GriefLog to fit your server volume. Set custom retention periods, database batch sizes, and event triggers:

# plugins/GriefLog/config.yml

retention: 3d
purge-interval-minutes: 30
flush-interval-ticks: 20
rollback-batch-size: 250

log:
  player-break: true
  player-place: true
  explosions: true
  fire: true
  liquid-flow: true   # High-volume; tune retention accordingly

delete-on-rollback: true