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 ` Show interaction logs for last right-clicked block (paged) - `/craftaudit blocklog ` Show block logs for last left-clicked block (paged)

### Area Queries - `/craftaudit near ` Search logs near player (by radius & time) - Time format: Ns/Nm/Nh/Nd (e.g., `30m`, `12h`, `5d`)

### Rollback/Restore/Undo - `/craftaudit rollback ` Roll back a player’s place/break within area & time - `/craftaudit restore ` 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:`: restore kills (respawn non-player entities) - `/craftaudit undo` Undo last rollback/restore (revert blocks, remove spawned entities) - `/craftaudit purge ` 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