CraftAudit

CraftAudit – Block/Entity Audit Logger & Rollback Tool (Forge)

Overview

CraftAudit is a server-side audit mod/plugin for Minecraft Forge that records world changes made by players and the environment (block place/break, container I/O, ignition, item-frame/painting actions, bucket usage, kills, etc.). It provides in-place inspection, area queries, rollback/restore and undo features, supporting SQLite or MySQL storage.

Features

- Block Change Logging - Player break/place (with optional BlockState/NBT snapshots) - Environment breaks (natural_break): explosion, fluid, gravity

- Interaction Logging - Container put/take (menu session-based, accurate block position) - Sign editing (logs text) - Ignition (campfire/candle/TNT/fire) - Redstone interactions: button/lever/door - Item frame/painting: put/take/rotate/place/break - Bucket: fill/empty/catch/milk - Kill: logs killer, victim, reason, projectile, weapon, distance, etc.

- Query - In audit mode, left/right-click a block to view logs for that position (paged) - Area+time queries (`near` command)

- Rollback/Restore/Undo - Rollback a player’s place/break within radius & time window (`rollback`) - Restore all breaks (player & environment) or filtered by type (`restore`) - Restore kills: respawn non-player entities at log positions (`restore ... kill`) - Undo last rollback/restore (`undo`): revert blocks or remove spawned entities

- Storage - SQLite (default) or MySQL backend - Configurable file location and MySQL parameters

- Other - Localized names for items/blocks - Audit mode exempt from logging (auditor actions ignored)

Commands

All `craftaudit` commands have `/ca` alias. OP level 2 required.

Basic

- `/craftaudit status` Show database/mode status - `/craftaudit inspect` or `/ca i` Toggle audit mode (left-click: block logs, right-click: interaction logs) - `/craftaudit log [page]` Show interaction logs for last right-clicked block (paged) - `/craftaudit blocklog [page]` Show block logs for last left-clicked block (paged)

Area Queries

- `/craftaudit near <radius> <time> [page]` Search logs near player (by radius & time) - Time format: Ns/Nm/Nh/Nd (e.g., `30m`, `12h`, `5d`)

Rollback/Restore/Undo

- `/craftaudit rollback <player> <time> [radius=10]` Roll back a player’s place/break within area & time - `/craftaudit restore <time> [radius=10] [type]` Restore breaks or kills, optionally filtered by type: - No type: all breaks (player & environment) - `break`: only player breaks - `natural`/`natural_break`: only environment breaks - `explosion`/`fluid`/`gravity`: environment breaks by cause - `kill` or `kill:<entity_id>`: restore kills (respawn non-player entities) - `/craftaudit undo` Undo last rollback/restore (revert blocks, remove spawned entities) - `/craftaudit purge <time>` Purge logs older than time (irreversible)

Time Format

- Examples: `30s`, `15m`, `12h`, `7d`

Installation

- Place the mod jar in your Forge server’s `mods` folder - Requires Java 17 (Forge 1.19+) - Config file is generated after first run

Configuration

- Database: - SQLite: default at `gameDir/craftaudit/craftaudit.db` - MySQL: configurable host, port, database, user, password, SSL, params

Data & Privacy

- Only logs essential events, coordinates, item/block/entity IDs for audit/rollback - BlockEntity NBT is stored (compressed, size-limited, opt-in) for BE blocks on break - Use `purge` regularly to clean up old logs

Build

- Requires JDK 17 and Forge MDK - Typical steps: import Gradle, sync dependencies, build jar

Contributing

- Issues, PRs, and feature requests welcome

License

Licensed under Creative Commons Attribution 4.0 International (CC BY 4.0) See LICENSE.

Copyright (c) 2025 CraftAudit contributors