Vonix Server Utilities — Installation Guide

State: 2.0.2 standalone snapshot — publication pending

Install VSU only on the dedicated server. Clients do not need the jar. Exact public download URLs are not published here.

Current Dev/Test

1. Prerequisites

1. Dedicated Minecraft Server: Running Fabric, Forge, or NeoForge on a supported Minecraft version (1.18.2, 1.19.2, 1.20.1, 1.21.1, or 26.1.2).
2. Java Runtime:
   • Minecraft 1.18.2 / 1.19.2 / 1.20.1: Java 17
   • Minecraft 1.21.1: Java 21
   • Minecraft 26.1.2: Java 25
3. Optional Permissions Mod: LuckPerms is recommended for role-based permission grouping. If LuckPerms is absent, VSU falls back to vanilla op levels.

---

2. Artifact Matrix

Select the jar corresponding to your loader and Minecraft version:

Minecraft Version	Loader	Expected Jar Artifact	Required Java
26.1.2	NeoForge	vonix_server_utilities-neoforge-26.1.2-2.0.2.jar	Java 25
1.21.1	NeoForge	vonix_server_utilities-neoforge-1.21.1-2.0.2.jar	Java 21
1.21.1	Fabric	vonix_server_utilities-fabric-1.21.1-2.0.2.jar	Java 21
1.20.1	Forge	vonix_server_utilities-forge-1.20.1-2.0.2.jar	Java 17
1.20.1	Fabric	vonix_server_utilities-fabric-1.20.1-2.0.2.jar	Java 17
1.19.2	Forge	vonix_server_utilities-forge-1.19.2-2.0.2.jar	Java 17
1.19.2	Fabric	vonix_server_utilities-fabric-1.19.2-2.0.2.jar	Java 17
1.18.2	Forge	vonix_server_utilities-forge-1.18.2-2.0.2.jar	Java 17
1.18.2	Fabric	vonix_server_utilities-fabric-1.18.2-2.0.2.jar	Java 17

---

3. Installation Steps

Step 1: Shut Down Server Cleanly

/stop

Step 2: Place Jar in Mods Folder

Copy the candidate jar into the server’s mods/ directory:

cp vonix_server_utilities-fabric-1.21.1-2.0.2.jar /path/to/server/mods/

Step 3: Launch the Server

Start the server process. On first startup, VSU generates:

• config/vonix_server_utilities.properties — Core configuration file.
• config/vonix_server_utilities/data.db — Local SQLite database (initialized in WAL mode).

---

4. First Boot Verification

After the server prints Done (Xs)!, confirm the running snapshot:

/vonixsu version

The documented /vonixsu version contract reports the embedded version (2.0.2), the active loader, and the local SQLite persistence state. Exact console banner wording can vary by loader; treat the command output as the operator check, not a live status feed.

---

5. When This Does Not Apply

• Client Modpacks: Do not include VSU in client-side curseforge/modrinth modpack distributions; it is an operator server utility.
• External Website Sync: VSU 2.0.2 does not connect to web endpoints or require API keys. Do not search for web configuration fields.