
Modrinth · Minecraft mod
CraftAudit
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.).
Quick answer
Which CraftAudit release matches 1.20.1 Forge?
CraftAudit 1.0.8 targets 1.20.1, 1.20.2, 1.20.4 with Forge, NeoForge. Do not install it on the client. It must be installed on the dedicated server. All 2 required mods have matching files.
Where it goes
Is CraftAudit required on the client, server, or both?
Do not install it on the client. It must be installed on the dedicated server.
This file is marked server-only.
What else does CraftAudit 1.0.8 need?
1.0.8 on 1.20.1 Forge. Every mod below is checked against that same setup.
Install SQLite JDBC, MySQL JDBC first. We found matching files for this game-version and loader setup.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add CraftAudit without breaking your instance.
Built for CraftAudit 1.0.8 on 1.20.1 Forge. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 1.0.8. It targets 1.20.1, 1.20.2, 1.20.4 with Forge, NeoForge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install SQLite JDBC, MySQL JDBC first. We found matching files for this game-version and loader setup.
- 03
Put it on the correct side
Do not install it on the client. It must be installed on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside 1.0.8. It opens that exact file at the source.
About this project
What does CraftAudit add?
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 (
nearcommand)
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
- Rollback a player’s place/break within radius & time window (
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 inspector/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)
- Time format: Ns/Nm/Nh/Nd (e.g.,
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 breaksnatural/natural_break: only environment breaksexplosion/fluid/gravity: environment breaks by causekillorkill:<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
modsfolder - 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
- SQLite: default at
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
purgeregularly 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
Project description from Modrinth.
Pick your setup
CraftAudit by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
1.20.5
2 loader builds1.20.4
2 loader builds1.20.3
2 loader builds1.20.2
2 loader builds1.20.1
2 loader buildsCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
CraftAudit versions and loaders
1.0.8
CraftAudit-1.0.8.jar
6 Oct 2025
1.0.7
craftaudit-1.0.7.jar
3 Oct 2025
1.0.6
craftaudit-1.0.6.jar
1 Oct 2025
1.0.5
craftaudit-1.0.5.jar
30 Sept 2025
1.0.4
craftaudit-1.0.4.jar
28 Sept 2025
1.0.3
craftaudit-1.0.3.jar
28 Sept 2025
Looking for an older file? The official Modrinth project page is in Resources.