Chronos

# 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!