Platform & Mod Selector
Vonix mods are server-side only. Connecting players do not install them on clients. Both products target dedicated Fabric, Forge, and NeoForge servers.
1. Which mod to install
Section titled “1. Which mod to install”| Mod | Role | What it covers | Current line |
|---|---|---|---|
| VonixGuardian | Block, container, and entity auditing | CoreProtect-shaped /vg workflows, lookup/filtering, rollback/restore/undo, SQLite/MySQL/PostgreSQL storage |
3.0.0-m1 testing candidate |
| Vonix Server Utilities (VSU) | Essentials and administration | Homes, warps, kits, TPA, back/death-back, messaging, moderation (/tempban, /tempmute), virtual crates |
2.0.2 standalone snapshot |
Install one or both. They do not require each other.
2. Platform selector
Section titled “2. Platform selector”3. Java runtime
Section titled “3. Java runtime”The Minecraft version selects the required Java runtime. A mismatch fails at launch with UnsupportedClassVersionError.
| Minecraft version | Loaders | Required Java |
|---|---|---|
| 1.18.2 | Fabric, Forge | Java 17 |
| 1.19.2 | Fabric, Forge | Java 17 |
| 1.20.1 | Fabric, Forge | Java 17 |
| 1.21.1 | Fabric, NeoForge | Java 21 |
| 26.1.2 | NeoForge | Java 25 |
java -versionForge is not a 1.21.1 or 26.1.2 target in this matrix. NeoForge replaces it on those versions.
4. Permissions
Section titled “4. Permissions”Both mods can use LuckPerms through reflection. LuckPerms is optional.
VonixGuardian
Section titled “VonixGuardian”- With LuckPerms: each
/vgsubcommand usesvonixguardian.command.*nodes. - Without LuckPerms: vanilla op level from
config/vonixguardian/config.json(defaultOpLevel: 3). Op level 3 or higher receives every/vgpermission.
VSU (union semantics)
Section titled “VSU (union semantics)”- A player may run a command if they hold the LuckPerms node or meet the vanilla op fallback.
- Without LuckPerms, non-ops receive standard player commands (
/home,/tpa,/spawn,/back). Staff commands stay restricted to ops. - Installing LuckPerms without default-group configuration does not lock players out of
opFallback = 0commands. That lockout was a historical v1.6.0 behavior.