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