📦 ChestLogger

High-Performance, Zero-Blocking Container Audit & Rollback System
Native releases for Fabric Mod and Paper Plugin.

---

✨ Overview

ChestLogger is an ultra-fast, zero-lag anti-griefing and container transaction logger for modern Minecraft servers. It captures player interactions and automation events across all containers (chests, double chests, barrels, trapped chests, and shulker boxes).

⚡ Performance

• 0 ms Tick Lag: Lock-free asynchronous MPSC queue ensures disk writes never block server ticks.
• Compact Storage: Custom .clog binary format with LZ4 compression (< 30 bytes per transaction).
• Low-End HDD Tuned: Sequential batch writing prevents disk seek storms on budget hosts.
• Crash-Safe: Self-healing CRC32 tail checkpoints prevent corruption on sudden shutdowns.

---

🚀 Features

🔍 Container Inspection

• Target any container and run /chestlog inspect to view transaction history.
• Filter by radius, player, item ID, or time range.
• Fabric Client: Custom in-game GUI with item icons and pagination.

👥 Double Chest Support

• Dual-Block Indexing: Inspecting either half returns the full 54-slot history.
• Adaptive Recovery: Relocates items into available slots if one half is broken.

⏪ Safe Rollbacks

• 2-step confirmation token system prevents accidental mass rollbacks.
• Non-Destructive: Never deletes or overwrites newer legitimate items.

📊 Web Dashboard

• Zero-dependency web UI on http://localhost:8080/.
• Real-time event streaming, telemetry meters, and CSV/JSON export.

---

🎮 Commands

🔒 Requires OP (Fabric) or Bukkit permissions (Paper).

• /chestlog inspect <X> <Y> <Z> [page] — Inspect container history
• /chestlog inspect <X> <Y> <Z> <player> [page] — Filter inspection by player
• /chestlog rollback <X> <Y> <Z> <seconds> [player] — Preview rollback plan
• /chestlog rollback <X> <Y> <Z> <seconds> confirm <token> — Execute live rollback
• /chestlog stats — View queue depth and storage metrics

---

📦 Installation

Fabric

1. Place chestlogger-fabric-2.1.0.jar into your mods/ directory.
2. Requires Fabric API on Minecraft 26.2.

Paper

1. Place chestlogger-paper-2.1.0.jar into your plugins/ directory.
2. Restart or reload the server (No dependencies required).

---

📜 Links

• Source Code: GitHub
• Issues: Bug Reports
• License: MIT