Chronos

Chronos is a Paper/Folia plugin that logs every change made to your world and lets you undo it precisely, with a visual rollback preview smart attribution of environmental events, player snapshots, and staff activity alerts.

What it does

• Full logging: blocks broken and placed, containers (with exact contents, including enchantments), signs, kills, chat, commands, login/logout.
• GUI lookup: an inventory-based menu with click filters for player, time, and action type, plus an inspector that shows a block's history when you click it.
• Rollback with preview: before undoing anything, you see the blocks change as "ghost" blocks visible only to you, along with a summary of how many blocks and items will be affected. Confirm or cancel with a click.
• Selective rollback: by area (selection wand or radius), player, block type, or a single incident. Multi-level undo and redo.
• Grouped incidents: chain TNT, fire, lava, water, end crystals, and the Wither are attributed to whoever caused them, even after several steps, and grouped into a single "incident" that can be undone with one command.
• Player snapshots: inventory, ender chest, XP, and position saved on death, logout, and at regular intervals. Restoring is reversible (a "pre-restore" snapshot is created automatically).
• Staff activity alerts: notifies staff in game, in the console, and via an optional Discord webhook about unusual block-breaking patterns or large container withdrawals.
• Performance: asynchronous batched writes, SQLite/MySQL/PostgreSQL support, rollbacks applied with a per-tick block budget to avoid lag spikes, automatic retention of old data.
• Multi-language: English and Italian included out of the box, with support for adding more languages by editing a simple YAML file.

Who it's for

Admins and staff on survival, faction, anarchy, or any server where you need to find and undo griefing, restore inventories lost to bugs, or keep an eye on unusual player activity without slowing down the server.

Main commands

• /chronos lookup <filters> — search the history through a GUI menu
• /chronos rollback / restore <filters> — undo or reapply changes, with preview
• /chronos inspect — click a block to see its history
• /chronos snapshot restore <player> — restore inventory/XP
• /chronos incidents — list recent grouped incidents

Full list of commands, filters, and permissions in the attached README.

Requirements

• Paper, Purpur, or Folia, version 1.21.x
• Java 21

Configuration

All settings (language, database, what to log, alert thresholds, retention) live in plugins/Chronos/config.yml, with every option commented.