Vonix Server Utilities — Mod Overview
1. What is Vonix Server Utilities?
Section titled “1. What is Vonix Server Utilities?”Vonix Server Utilities (VSU) is a server-side essentials, admin, and moderation mod for dedicated Minecraft servers.
In the current 2.0.2 snapshot:
- Local storage: homes, warps, moderation records, and virtual crate balances persist in
config/vonix_server_utilities/data.db. - Standalone core: no website, API key, or companion mod is required.
- Nine loader cells: Fabric/Forge/NeoForge across 1.18.2–26.1.2 as listed below.
- Union permissions: a player may hold a LuckPerms node or meet the vanilla op fallback, which avoids the historical v1.6.0 lockout.
- Accessory peeking:
/accseeuses Curios on Forge/NeoForge and Trinkets on Fabric when those mods are present.
2. Feature Surface Summary
Section titled “2. Feature Surface Summary”| Category | Primary Commands | Capabilities |
|---|---|---|
| Movement | /home, /sethome, /delhome, /homes, /warp, /setwarp, /spawn, /back, /backdeath, /tpa, /tpaccept, /tpdeny |
Player homes with configurable limits (default: 5), server warps, TPA request timeouts, and teleport/death return origins. |
| Social | /msg, /tell, /r, /ignore, /broadcast, /bc, /nick, /list |
Private messaging, reply shortcuts, chat ignoring, formatted server-wide announcements, and customizable player nicknames. |
| Utility | /kit, /kits, /hat, /more, /repair, /clear, /workbench, /anvil, /afk, /ping, /playtime, /seen, /whois |
Virtual crafting/anvil access, kit claims, playtime tracking, item repairs, and whois diagnostics. |
| Admin | /vanish, /god, /fly, /heal, /feed, /gm, /tp, /tphere, /tpall, /tppos, /invsee, /backsee, /accsee, /lag, /smite |
Staff fly/god/vanish, interactive inventory/accessory peeking, lag metrics, and coordinate teleportation. |
| Moderation | /tempban, /ban, /unban, /banlist, /tempmute, /mute, /unmute, /kick, /warn, /warnings, /clearwarnings |
SQLite-persisted bans and mutes with duration parser, automated 60s expiry sweeper, and pre-kick reason broadcast. |
| Crates | /crate key give, /crate prizes, /crate open |
Server-authoritative playtime and event virtual crates with persistent weighted prize tables. |
| World | /weather, /sun, /rain, /storm, /time, /day, /night, /lightning |
Environmental controls and time manipulation. |
| Outside-Mod SPI | VonixPanels.current() |
Optional companion bridge for external web panels. Compiles against network.vonix.serverutilities.api. |
3. Supported Version Lanes
Section titled “3. Supported Version Lanes”VSU maintains source parity across five Minecraft versions:
| Minecraft Version | Fabric | Forge | NeoForge | Java Required | Architecture / Template |
|---|---|---|---|---|---|
| 26.1.2 | — | — | ✅ | Java 25 | Dedicated ModDevGradle 2.0.140 project |
| 1.21.1 | ✅ | — | ✅ | Java 21 | Architectury template (Fabric & NeoForge) |
| 1.20.1 | ✅ | ✅ | — | Java 17 | Architectury template (Fabric & Forge) |
| 1.19.2 | ✅ | ✅ | — | Java 17 | Architectury template (Fabric & Forge) |
| 1.18.2 | ✅ | ✅ | — | Java 17 | Architectury template (Fabric & Forge) |
4. Standalone Boundary in 2.0.2
Section titled “4. Standalone Boundary in 2.0.2”Operators upgrading from historical versions (v1.6.x–v1.7.x) must note the architectural changes introduced in the 2.0.2 line:
- Removed Services: Venary HTTP client, remote API key configuration (
api_key=), remote server-config polling, player-stat web sync, and donation-rank sync are removed. - Removed Commands:
/linkand/unlinkaccount transport commands are completely removed. - Local Control: All feature gates are toggled locally via
config/vonix_server_utilities.propertiesor/vonixsu feature.
5. Navigation & Guides
Section titled “5. Navigation & Guides”- Installation Guide — Jar placement, properties creation, and first launch.
- Command Reference — Alphabetical command list, syntax, and permission nodes.
- Permissions & Union Semantics — LuckPerms union model, group recipes, and bypass nodes.
- Movement & Teleportation — Homes, warps, spawn, TPA requests, and death origins.
- Social & Messaging — Chat commands, formatting, ignore system, and nicknames.
- Utility & Admin Tools — Inventory peeking (
/invsee,/accsee), kits, and virtual crafting. - Moderation System — Tempbans, tempmutes, warnings, duration grammar, and audit queries.
- Playtime & Event Crates — Virtual keys, weighted prizes, and drop rates.
- Configuration & Data Path — Properties reference, SQLite WAL data path, and retained snapshot recovery.
- Troubleshooting & Diagnostics — TempMute race prevention, database recovery, and event hooks.
- Outside-Mod SPI & Developer — Immutable projection API and companion contracts.
- Testing & Validation Status — Evaluation notes across all nine loader cells.