VonixGuardian Vonix Mods v2.3.2 Search GitHub
VonixGuardian

VonixGuardian#

VonixGuardian is a server-side block, container, and entity audit log for modded Minecraft, with rollback and restore tools. It records what players and mobs do to the world, lets staff search that history, and can undo or reapply it.

It is a server-side mod. Clients do not install it, and vanilla clients can join a server running it.

Fabric Forge NeoForge 1.18.2 → 26.3 SQLite · MySQL · PostgreSQL MIT

Download: CurseForge · GitHub Releases

What it does#

Audits the world. Every block place and break, container deposit and withdrawal, item drop, pickup and craft, entity kill and spawn, explosion, chat message, command, sign edit, session join and leave, and a wide set of natural world events is written to a database with the actor, position, time, and — where relevant — the block state and NBT needed to reconstruct it.

Answers "who did this." /vg inspect turns a block into a query. /vg lookup searches by player, time, radius, action, block or item id. /vg near shows what just happened around you.

Undoes damage. /vg rollback reverses the matching actions in the world. /vg restore reapplies a previous rollback. /vg undo reverses your own last mutation. Every mutation is transactional, recorded as a batch, and reported with a status.

Attributes modded griefing. When a mob breaks blocks, the row carries both a sentinel (#mob:isleofberk:night_fury) and, when the attribution chain resolved one, the responsible player's UUID. This is what makes a dragon-mounted griefer answerable instead of anonymous.

Getting started#

Install

Pick the jar for your loader and Minecraft version, verify its checksum, drop it in mods/.

Commands

Every subcommand under /vg with syntax, arguments, permissions, and behaviour.

Filters

The u: t: r: a: i: e: parameter language shared by lookup, rollback, restore, and purge.

Configuration

Every key in config.json with type, default, valid range, and reload behaviour.

Requirements#
Minecraft 1.18.2, 1.19.2, 1.20.1, 1.21.1, 26.1.2, 26.2, or 26.3
Loader Fabric, Forge (1.18.2–1.20.1), or NeoForge (1.21.1+)
Java 17 on 1.18.2–1.20.1, 21 on 1.21.1, 25 on 26.x
Storage SQLite (bundled, zero-config), MySQL/MariaDB, or PostgreSQL
Side Server only — no client mod required

No other library, coremod, or plugin is required. The SQLite JDBC driver ships nested inside the jar on every loader.

Version matrix#

Minecraft Fabric Forge NeoForge
26.3 ✅ — ✅
26.2 ✅ — ✅
26.1.2 ✅ — ✅
1.21.1 ✅ — ✅
1.20.1 ✅ ✅ —
1.19.2 ✅ ✅ —
1.18.2 ✅ ✅ —

Thirteen jars are published for 2.3.0. NeoForge did not exist before 1.20.4, so NeoForge replaces Forge on 1.21.1 and every 26.x version. The NeoForge 26.3 cell is compiled against NeoForge 26.3.0.6-beta; no stable 26.3 loader exists yet.

A first rollback#

/vg inspect                              ← toggle inspector, then click a block
/vg lookup u:Steve t:1h                  ← what did Steve do in the last hour
/vg rollback u:Steve t:1h r:50 #preview  ← see what would be undone
/vg rollback u:Steve t:1h r:50           ← undo it
/vg undo                                 ← change your mind

/vg rollback and /vg restore default to a 10-block radius centred on you when you omit r:. Use r:#global for a whole-world mutation, and #preview first on anything you have not done before.

Project#

VonixGuardian is a clean-room implementation. It is inspired by CoreProtect (Artistic-2.0) and Ledger (LGPL-3), neither of which shares code with this project.