CervLogger

CervLogger

Block logging, lookup, rollback and restore for NeoForge 1.21.1 servers.

CervLogger records player activity in a local database and lets staff inspect
block history, search the logs and roll back grief in seconds — with **no
client-side installation required**. Vanilla and modded clients can join freely.

✨ Features

• 📝 Comprehensive logging — block place/break, explosions, fire, container transactions, signs, buckets, interactions (doors, levers, buttons…), entity kills, chat, commands and login/logout sessions
• 🔍 Inspector mode (/cl i) — click any block to instantly see who placed, broke or changed it and when
• ⏪ Rollback & restore — undo grief filtered by player, time, radius, action and block types (/cl rollback u:Player t:2h r:20)
• 🗄️ Flexible storage — SQLite works out of the box with zero setup; MySQL supported for larger servers (both drivers bundled)
• 🖥️ Server-side only — nothing to install on clients

📋 Commands

| Command | Description | Permission |
| — | — | — |
| /cl inspect (/cl i) | Toggle the inspector | everyone |
| /cl lookup <params> | Search the logs | op |
| /cl rollback <params> | Roll back changes | op |
| /cl restore <params> | Re-apply rolled back changes | op |
| /cl near [radius] | Lookup around you | op |
| /cl structures | List loaded Create/Sable structures | op |
| /cl purge t:<time> | Delete old log data | op |

Parameters: u:<player> t:<time> r:<radius|#global> a:<action>
b:<blocks> e:<exclude> w:<world> p:<page>

Example: /cl rollback u:Notch t:2h r:20 a:-block

⚙️ Configuration

Everything is created on first run at config/cervlogger/config.properties:
per-category logging toggles, radius limits, page size, extra interact block
IDs, and MySQL credentials if you set storage-type=mysql.

🤝 Compatibility

Rollbacks run on the main server thread — safe alongside c2me, Lithium and
other optimization mods. Blocks moving inside Create contraptions or Sable
sub-levels bypass standard block events and are not logged while in motion.