FragGuard

FragGuard is a Paper plugin that logs block changes for 30 days, lets server operators inspect block history in a radius, and rolls an area back to the state it was in at a chosen time.

What it tracks

• Player block placement
• Player block destruction
• Explosion block changes
• Fire spread
• Blocks destroyed by fire burn events
• Lava and water flow
• Player bucket water/lava placement and removal
• Blocks broken by lava/water flow
• Piston extension and retraction changes
• Blocks broken or moved by pistons
• Player name and UUID when a player caused the change
• System cause labels when the server/environment caused the change
• World and block coordinates
• Time of change
• Block data before and after the change

FragGuard stores data in plugins/FragGuard/fragguard.db using SQLite.

Commands

Only server operators with fragguard.admin can use these commands.

/fg help
/fg lookup r:30
/fg lookup r:30 p:2
/fg rollback r:30 t:2d 7h 15m

Lookup

/fg lookup r:30

Shows recent block-change logs in a full-height cylinder around your current position. Results are paginated.

Rollback

/fg rollback r:30 t:2d 7h 15m

Restores every logged block change in a radius of 30 blocks back to the state it was in 2 days, 7 hours, and 15 minutes ago. The radius covers the full world height, from bedrock/minimum world height to maximum build height.

Config

plugins/FragGuard/config.yml

retention-days: 30
cleanup-interval-minutes: 60

log-explosions: true
log-fire-spread: true
log-liquid-flow: true
log-pistons: true

lookup-page-size: 15
max-lookup-radius: 150

max-rollback-radius: 100
rollback-blocks-per-tick: 500
rollback-max-blocks-per-command: 50000
apply-physics-during-rollback: false

Notes and limitations

• This restores block type and block data, including things like facing direction, slab state, stair shape, and similar block data.
• It does not restore inventories inside containers, sign text, books, or other tile-entity contents.
• Explosion, fire burn, bucket, liquid, and piston handlers record the before-state during the event and the after-state on the next server tick so the saved log matches what the server actually changed.
• Fire-burn and bucket-source logging was added after the first version. Old damage that happened before installing this update cannot be rolled back unless it was already logged.
• Rollbacks are applied in batches to reduce lag.