Vonix Server Utilities#
Vonix Server Utilities (VSU) is a server-side essentials mod for modded
Minecraft. It provides homes, warps, kits, teleport requests, chat and
messaging, staff tooling, a SQLite-backed moderation system, and a
playtime-driven crate and key system. Every command is gated by a vsu.*
permission node that LuckPerms can grant, with a vanilla operator level as the
floor when LuckPerms is absent or unconfigured.
VSU is server-side only. Clients do not install it, vanilla clients can join a server running it, and nothing in the mod contacts a remote service.
Feature groups#
Movement. /home, /sethome, /delhome, /homes, /warp, /setwarp,
/delwarp, /warps, /spawn, /setspawn, /back, /backdeath, /tpa,
/tpahere, /tpaccept, /tpdeny. Homes and warps persist in SQLite. /back
and /backdeath keep separate stores, so a death never overwrites your last
teleport origin.
Social. /msg, /tell, /r, /reply, /ignore, /nick, /broadcast,
/bc, /gc, /list, /near. Ignore lists and nicknames persist across
restarts. Chat formatting can carry LuckPerms prefix, suffix, and name colour
when LuckPerms is installed.
Utility. /kit, /kits, /hat, /more, /clear, /repair, /anvil,
/workbench, /enderchest, /seen, /whois, /ping, /playtime,
/getpos, /suicide.
Admin. /heal, /feed, /fly, /god, /vanish, /gm, /tp, /tphere,
/tpall, /tppos, /invsee, /backsee, /accsee, /lag, /lightning,
/smite, /vonixsu.
Moderation. /ban, /tempban, /unban, /banlist, /mute, /tempmute,
/unmute, /kick, /warn, /warnings, /clearwarnings. Every action writes
an audit row to the punishments table, and an expiry sweeper runs on a
60-second cadence.
World. /weather, /sun, /rain, /storm, /time, /day, /night.
Crates and keys. /crate list|open|prizes, /crate key give|take|balance,
and the admin tree for crate definitions and weighted prizes. Playtime keys are
granted automatically at a configurable interval.
Requirements#
| Minecraft | 1.18.2, 1.19.2, 1.20.1, 1.21.1, 26.1.2 |
| Loader | Fabric and Forge on 1.18.2–1.20.1; Fabric and NeoForge on 1.21.1; NeoForge on 26.1.2 |
| Java | 17 on 1.18.2–1.20.1, 21 on 1.21.1, 25 on 26.1.2 |
| Side | Server only — no client mod |
| Storage | SQLite, bundled; no external database |
| Optional | LuckPerms 5.4+ for per-node grants and chat metadata |
The SQLite JDBC driver is nested inside the jar on every loader, so no extra library is needed for storage. Architectury API is a declared dependency on the 1.18.2–1.20.1 lanes; see Installation for the per-lane dependency list.
Version matrix#
| Minecraft | Fabric | Forge | NeoForge | Java |
|---|---|---|---|---|
| 26.1.2 | — | — | ✅ | 25 |
| 1.21.1 | ✅ | — | ✅ | 21 |
| 1.20.1 | ✅ | ✅ | — | 17 |
| 1.19.2 | ✅ | ✅ | — | 17 |
| 1.18.2 | ✅ | ✅ | — | 17 |
Nine artifacts are published for 2.2.0, one per cell. NeoForge did not exist
before 1.20.4, so it replaces Forge on 1.21.1 and 26.1.2. Each Minecraft version
is a separate Gradle project with a shared common/ source tree and a
loader-specific module.
Getting started#
Install
Pick the jar for your loader and Minecraft version, verify its SHA-256, and drop it in mods/.
Commands
The complete command reference with syntax, permission node, op fallback, and behaviour.
Permissions
Node model, all 31 nodes, LuckPerms group recipes, and the union rule that keeps ops working.
Kits & crates
kits.json schema, group claim windows, and the playtime key and weighted prize system.
Scope of the 2.2.0 build#
VSU 2.2.0 is deliberately standalone. It has no public API or service-provider
package, no HTTP client, no account linking, no site or donation-rank
integration, and no feature-polling. /vonixsu status reports a fixed module
list rather than a remote feature registry, and the internal feature gates are
always open so that access control lives entirely in the permission gate.
That boundary is what makes the mod safe to run on a private server with no external accounts. The trade-off is that nothing outside the server can query VSU state; see Compatibility for the exact supported surface.
Project#
- Repository — https://github.com/Vonix-Network/Vonix-Server-Utilities
- Releases — https://github.com/Vonix-Network/Vonix-Server-Utilities/releases
- Issues — https://github.com/Vonix-Network/Vonix-Server-Utilities/issues
- License — All rights reserved, Vonix Network
Distribution of unmodified release jars from official Vonix channels is permitted. Redistribution of modified builds is not. The mod ships no secrets, no telemetry, and no outbound network calls.