{"id":47726,"date":"2026-06-02T14:20:48","date_gmt":"2026-06-02T11:20:48","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/craftaudit\/"},"modified":"2026-06-02T14:20:48","modified_gmt":"2026-06-02T11:20:48","slug":"craftaudit","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/craftaudit\/","title":{"rendered":"CraftAudit"},"content":{"rendered":"<p># CraftAudit \u2013 Block\/Entity Audit Logger &#038; Rollback Tool (Forge)<\/p>\n<p>## Overview<br \/>\nCraftAudit 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.<\/p>\n<p>## Features<br \/>\n&#8211; **Block Change Logging**<br \/>\n  &#8211; Player break\/place (with optional BlockState\/NBT snapshots)<br \/>\n  &#8211; Environment breaks (natural_break): explosion, fluid, gravity<\/p>\n<p>&#8211; **Interaction Logging**<br \/>\n  &#8211; Container put\/take (menu session-based, accurate block position)<br \/>\n  &#8211; Sign editing (logs text)<br \/>\n  &#8211; Ignition (campfire\/candle\/TNT\/fire)<br \/>\n  &#8211; Redstone interactions: button\/lever\/door<br \/>\n  &#8211; Item frame\/painting: put\/take\/rotate\/place\/break<br \/>\n  &#8211; Bucket: fill\/empty\/catch\/milk<br \/>\n  &#8211; Kill: logs killer, victim, reason, projectile, weapon, distance, etc.<\/p>\n<p>&#8211; **Query**<br \/>\n  &#8211; In audit mode, left\/right-click a block to view logs for that position (paged)<br \/>\n  &#8211; Area+time queries (`near` command)<\/p>\n<p>&#8211; **Rollback\/Restore\/Undo**<br \/>\n  &#8211; Rollback a player\u2019s place\/break within radius &#038; time window (`rollback`)<br \/>\n  &#8211; Restore all breaks (player &#038; environment) or filtered by type (`restore`)<br \/>\n  &#8211; Restore kills: respawn non-player entities at log positions (`restore &#8230; kill`)<br \/>\n  &#8211; Undo last rollback\/restore (`undo`): revert blocks or remove spawned entities<\/p>\n<p>&#8211; **Storage**<br \/>\n  &#8211; SQLite (default) or MySQL backend<br \/>\n  &#8211; Configurable file location and MySQL parameters<\/p>\n<p>&#8211; **Other**<br \/>\n  &#8211; Localized names for items\/blocks<br \/>\n  &#8211; Audit mode exempt from logging (auditor actions ignored)<\/p>\n<p>## Commands<br \/>\n_All `craftaudit` commands have `\/ca` alias. OP level 2 required._<\/p>\n<p>### Basic<br \/>\n&#8211; `\/craftaudit status`<br \/>\n  Show database\/mode status<br \/>\n&#8211; `\/craftaudit inspect` or `\/ca i`<br \/>\n  Toggle audit mode (left-click: block logs, right-click: interaction logs)<br \/>\n&#8211; `\/craftaudit log [page]`<br \/>\n  Show interaction logs for last right-clicked block (paged)<br \/>\n&#8211; `\/craftaudit blocklog [page]`<br \/>\n  Show block logs for last left-clicked block (paged)<\/p>\n<p>### Area Queries<br \/>\n&#8211; `\/craftaudit near <radius> <time> [page]`<br \/>\n  Search logs near player (by radius &#038; time)<br \/>\n  &#8211; Time format: Ns\/Nm\/Nh\/Nd (e.g., `30m`, `12h`, `5d`)<\/p>\n<p>### Rollback\/Restore\/Undo<br \/>\n&#8211; `\/craftaudit rollback <player> <time> [radius=10]`<br \/>\n  Roll back a player\u2019s place\/break within area &#038; time<br \/>\n&#8211; `\/craftaudit restore <time> [radius=10] [type]`<br \/>\n  Restore breaks or kills, optionally filtered by type:<br \/>\n  &#8211; No type: all breaks (player &#038; environment)<br \/>\n  &#8211; `break`: only player breaks<br \/>\n  &#8211; `natural`\/`natural_break`: only environment breaks<br \/>\n  &#8211; `explosion`\/`fluid`\/`gravity`: environment breaks by cause<br \/>\n  &#8211; `kill` or `kill:<entity_id>`: restore kills (respawn non-player entities)<br \/>\n&#8211; `\/craftaudit undo`<br \/>\n  Undo last rollback\/restore (revert blocks, remove spawned entities)<br \/>\n&#8211; `\/craftaudit purge <time>`<br \/>\n  Purge logs older than time (irreversible)<\/p>\n<p>### Time Format<br \/>\n&#8211; Examples: `30s`, `15m`, `12h`, `7d`<\/p>\n<p>## Installation<br \/>\n&#8211; Place the mod jar in your Forge server\u2019s `mods` folder<br \/>\n&#8211; Requires Java 17 (Forge 1.19+)<br \/>\n&#8211; Config file is generated after first run<\/p>\n<p>## Configuration<br \/>\n&#8211; Database:<br \/>\n  &#8211; SQLite: default at `gameDir\/craftaudit\/craftaudit.db`<br \/>\n  &#8211; MySQL: configurable host, port, database, user, password, SSL, params<\/p>\n<p>## Data &#038; Privacy<br \/>\n&#8211; Only logs essential events, coordinates, item\/block\/entity IDs for audit\/rollback<br \/>\n&#8211; BlockEntity NBT is stored (compressed, size-limited, opt-in) for BE blocks on break<br \/>\n&#8211; Use `purge` regularly to clean up old logs<\/p>\n<p>## Build<br \/>\n&#8211; Requires JDK 17 and Forge MDK<br \/>\n&#8211; Typical steps: import Gradle, sync dependencies, build jar<\/p>\n<p>## Contributing<br \/>\n&#8211; Issues, PRs, and feature requests welcome<\/p>\n<p>## License<br \/>\nLicensed under Creative Commons Attribution 4.0 International (CC BY 4.0)<br \/>\nSee [LICENSE](LICENSE).<\/p>\n<p>Copyright (c) 2025 CraftAudit contributors<\/p>\n","protected":false},"excerpt":{"rendered":"<p>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.).<\/p>\n","protected":false},"featured_media":47727,"template":"","meta":{"_minecraft_slug":"craftaudit","_minecraft_project_id":"XURvx0KZ","_minecraft_author":"YuWan030","_minecraft_license":"CC-BY-4.0","_minecraft_downloads":761,"_minecraft_follows":6,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"craftaudit.zip","_minecraft_size_bytes":462479,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-15T22:05:34.929221Z","_minecraft_date_created":"2025-09-28T02:43:24.544139Z","_minecraft_date_modified":"2025-10-06T08:25:22.229768Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/craftaudit","_minecraft_icon_attachment_id":47727,"_minecraft_imported_at":"2026-06-02T11:20:49+00:00","_minecraft_import_hash":"06a8b7e99b2907b7091b39fc003451a2","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[104,89,126,158,91],"mod_loader":[106,160],"minecraft_version":[36,60,93,94,101],"class_list":["post-47726","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-forge","mod_category-game-mechanics","mod_category-management","mod_category-neoforge","mod_category-storage","mod_loader-forge","mod_loader-neoforge","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>CraftAudit - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/craftaudit\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"CraftAudit - Minecraft\" \/>\n<meta property=\"og:description\" content=\"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.).\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/craftaudit\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/craftaudit\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/craftaudit\\\/\",\"name\":\"CraftAudit - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/craftaudit\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/craftaudit\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/craftaudit-icon-315f2e9e777da51e3f9e62464227b3c717045d52.png\",\"datePublished\":\"2026-06-02T11:20:48+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/craftaudit\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/craftaudit\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/craftaudit\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/craftaudit-icon-315f2e9e777da51e3f9e62464227b3c717045d52.png\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/craftaudit-icon-315f2e9e777da51e3f9e62464227b3c717045d52.png\",\"width\":256,\"height\":256},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/craftaudit\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"CraftAudit\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"CraftAudit - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/craftaudit\/","og_locale":"en_US","og_type":"article","og_title":"CraftAudit - Minecraft","og_description":"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.).","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/craftaudit\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/craftaudit\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/craftaudit\/","name":"CraftAudit - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/craftaudit\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/craftaudit\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/craftaudit-icon-315f2e9e777da51e3f9e62464227b3c717045d52.png","datePublished":"2026-06-02T11:20:48+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/craftaudit\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/craftaudit\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/craftaudit\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/craftaudit-icon-315f2e9e777da51e3f9e62464227b3c717045d52.png","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/craftaudit-icon-315f2e9e777da51e3f9e62464227b3c717045d52.png","width":256,"height":256},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/craftaudit\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"CraftAudit"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/47726","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/47727"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=47726"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=47726"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=47726"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=47726"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}