Chronos

Chronos is a fast, precise data logging and rollback tool for your Minecraft server. Inspect, look up, roll back, and restore changes with a live preview, without impacting server performance.

Quick Links

Core Features

• Fast, asynchronous, batched data logging — never blocks the main thread.
• Ghost-block preview before every rollback or restore: see exactly what will change before you confirm.
• Multi-level undo and redo for every rollback or restore you perform.
• No required configuration — sensible defaults out of the box, everything else is optional.
• SQLite by default, with optional MySQL and PostgreSQL support.
• Built for Paper, Purpur, and Folia.
• Permission-based access with granular control per command.
• Clickable, paginated GUI lookup with filters for player, time, action type, and more.
• Selective rollback by player, radius, WorldEdit-style selection wand, block type, or a single incident.
• Container inventory rollback with full item data (enchantments, custom names, nested shulker boxes).
• Purge old data automatically by time, with optional CSV archive before deletion.
• Multi-world support with per-world and global logging settings.
• Include or exclude specific players or blocks from logging.
• Full localization support — switch languages from the config, add your own.

What does it log?

Blocks and World Changes

• Blocks placed or broken by players.
• Attached blocks breaking automatically when their support is removed (torches, signs, doors, tall plants).
• Water and lava placement, removal, and flow.
• Fire ignition and spread, block burning.
• TNT, Creeper, and other explosions, with the blocks traced back to whoever triggered them, even through chain reactions.
• Entities changing blocks (Endermen, Ravagers, Withers).
• Piston-moved blocks (optional, off by default).

Containers and Items

• Items taken from or placed into any container, tracked per session with exact deltas.
• Full item data preserved on rollback: enchantments, custom names, lore, nested containers.
• Sign text, including dye color and glow state, on both sides.

Entities and Player Activity

• Player-caused kills, with detailed victim data.
• Player chat messages and commands.
• Player sessions: logins and logouts.
• Inventory, ender chest, XP, and position snapshots on death, logout, and at configurable intervals — fully restorable, reversibly.

Activity Alerts

• Unusual block-breaking patterns and ore-to-stone ratios.
• Large or sudden container withdrawals.
• In-game, console, and optional Discord webhook notifications for staff.

How to use the inspector

Enable the inspector with /chronos inspect, then:

• Left-click a block to see who placed or broke it.
• Right-click a block to see the adjacent block's history, or a container's full transaction log.

Rollback with preview

Run /chronos rollback u:<player> t:<time> (or any combination of filters) to calculate the changes. Before anything is applied, you'll see a ghost-block preview visible only to you, along with a summary of how many blocks and items will be affected. Confirm or cancel with a click — nothing changes until you do.

Useful Links

• Documentation & full command list: see the included README
• Feedback & bug reports: github.com/yw4pfcv7td-stack/Chronos/issues

Thanks for using Chronos!