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