Frequently Asked Questions

❓ Frequently Asked Questions (FAQ)

Find answers to common questions about installation, performance, compatibility, and troubleshooting.

---

1. Does ChestLogger cause server lag (tick drops)?

No. ChestLogger uses a lock-free, asynchronous MPSC memory queue. When a player opens a chest or moves an item, the event is intercepted and placed into an in-memory queue in under 0.01 milliseconds. All disk writes and LZ4 compression happen on a separate background thread, resulting in 0 ms main-thread tick impact.

---

2. Can I use ChestLogger on Aternos, Minehut, or budget VPS hosts?

Yes! ChestLogger was specifically engineered for low-end host durability. It writes sequential batches to prevent disk seek thrashing on shared HDD hosts, and features self-healing CRC32 tail checkpoints so sudden server kills/restarts never corrupt the database.

---

3. Do players need to install the mod to join my server?

No. ChestLogger runs entirely server-side.

• Vanilla / Bedrock (Geyser) players can join without installing anything.
• If staff or players do install chestlogger-fabric on their Fabric client, they get access to the rich in-game History Viewer GUI.

---

4. How does ChestLogger compare to CoreProtect?

• Focused & Lightweight: ChestLogger focuses exclusively on high-throughput container tracking and non-destructive rollbacks, eliminating unnecessary database bloat.
• Storage Size: Uses custom binary .clog files with LZ4 compression (< 30 bytes/transaction) instead of massive SQLite/MySQL tables.
• Built-in Web Dashboard: Includes a live browser UI (http://localhost:8080/) out of the box with zero external web plugins needed.

---

5. What happens if a griefer breaks one half of a double chest?

ChestLogger's Adaptive Recovery Engine automatically detects that only 27 slots remain. During a rollback, it restores items from the missing half into free slots within the surviving single chest instead of losing them.

---

6. How do I change the Web Dashboard port?

You can configure the web server port (default: 8080) in:

• Fabric: config/chestlogger.json
• Paper: plugins/ChestLogger/config.yml

---

7. Where are transaction logs stored?

All compressed transaction logs and spatial index files are stored in the server's world directory under:

• world/chestlogger/data/ (or world/chestlogger/indexes/)