v2.2.0

Vonix Server Utilities v2.2.0

All nine supported Minecraft/loader lanes are built by GitHub Actions from this tag.

Artifact matrix

Asset	MC Version	Loader
vsu-1.18.2-fabric-2.2.0.jar	1.18.2	fabric
vsu-1.18.2-forge-2.2.0.jar	1.18.2	forge
vsu-1.19.2-fabric-2.2.0.jar	1.19.2	fabric
vsu-1.19.2-forge-2.2.0.jar	1.19.2	forge
vsu-1.20.1-fabric-2.2.0.jar	1.20.1	fabric
vsu-1.20.1-forge-2.2.0.jar	1.20.1	forge
vsu-1.21.1-fabric-2.2.0.jar	1.21.1	fabric
vsu-1.21.1-neoforge-2.2.0.jar	1.21.1	neoforge
vsu-26.1.2-neoforge-2.2.0.jar	26.1.2	neoforge

Checksums

7b7289a2c8b29d4be634879bb1cd85ffe0a59670d87920d530ce06f149608f37  vsu-1.18.2-fabric-2.2.0.jar
89527f584fe1cf5ae06c8bca14f8fa824c300e54e4d2f3dd35aa58d26b926c2a  vsu-1.18.2-forge-2.2.0.jar
05c78fc6db2504de0c8c3677de932823bcfc9e6d574016392474dd3f91eeffbc  vsu-1.19.2-fabric-2.2.0.jar
13756f26b9a2e5df15cf8496eafb2ef6017e57d7c8d4972513e4bfc095c41d42  vsu-1.19.2-forge-2.2.0.jar
60a2fd63261e64996f8637d45e703e2cfdd1bdeba697ba0d8bd7def48b30edcb  vsu-1.20.1-fabric-2.2.0.jar
2567a59a070c373db596a8810101ecde3a1ee9b91f396fe6e7fdaee88e19c338  vsu-1.20.1-forge-2.2.0.jar
6741e964543a9c734b32670978f9fc1232731452f9d4463d845c2f111da9ace0  vsu-1.21.1-fabric-2.2.0.jar
df5de39cd7638a5e0b00670e8c0a8738181119b424bac4f7050d970869975681  vsu-1.21.1-neoforge-2.2.0.jar
42619633bc97327bc74b8735afbde134207cfdb1cddf48eb7b198d5570d6abea  vsu-26.1.2-neoforge-2.2.0.jar

v2.1.2

Vonix Server Utilities v2.1.2

All nine supported Minecraft/loader lanes are included. This release adds optional standalone LuckPerms prefix/suffix/name-color formatting with a safe fallback when LuckPerms is absent; Venary is not required for public VSU functionality.

Artifact matrix

Asset	Minecraft	Loader	SHA-256
vsu-1.18.2-fabric-2.1.2.jar	1.18.2	fabric	6481f4788240003bf0d957860fcbfa5d5e2f179559a93d2b7e4788d882ed5e53
vsu-1.18.2-forge-2.1.2.jar	1.18.2	forge	94a820b0f0618465bd266f27935b695215846cfee776800afd1dfd2254642175
vsu-1.19.2-fabric-2.1.2.jar	1.19.2	fabric	26039bc9e0d24593da4347de16a8e59df80d096c4ef17fb577ea70ecd0afb919
vsu-1.19.2-forge-2.1.2.jar	1.19.2	forge	0cb2c9e3be99175ea3ec53d1ce1e5874240feb980b6a61098b20cc0b5a456f7f
vsu-1.20.1-fabric-2.1.2.jar	1.20.1	fabric	7f6b1abe3738ffe0df7f9cdf15c951e127066a9d75590176e13c3d0620038e52
vsu-1.20.1-forge-2.1.2.jar	1.20.1	forge	974dabe235818054b9957291539fa7fee004023cb468cece18177e2c22cc3388
vsu-1.21.1-fabric-2.1.2.jar	1.21.1	fabric	ab0563831a683e353b313865dac03f22427309c11c28388a87597c58eeea60db
vsu-1.21.1-neoforge-2.1.2.jar	1.21.1	neoforge	f2509c3b4f62f82869fef2416e1bfbe20ac7994d40315d0c2c5a5097ac21dee3
vsu-26.1.2-neoforge-2.1.2.jar	26.1.2	neoforge	3d6b6ae7b5eef27f8d202280faf6d4fa05dc669ac7dedd9b63ae03c07b0e9d46

Verification

• Source candidate: 10b24cdd38b84570bf8cfd51ccea94dc76e94299
• All five lane projects built successfully from the exact candidate.
• Independent read-only verification passed the nine-cell artifact and version matrix.
• Packaged runtime activation, live-server activation, and performance gates were not run.

v2.1.1

Vonix Server Utilities v2.1.1

All nine supported Minecraft/loader lanes are built by GitHub Actions from this tag.

Artifact matrix

Asset	MC Version	Loader
vsu-1.18.2-fabric-2.1.1.jar	1.18.2	fabric
vsu-1.18.2-forge-2.1.1.jar	1.18.2	forge
vsu-1.19.2-fabric-2.1.1.jar	1.19.2	fabric
vsu-1.19.2-forge-2.1.1.jar	1.19.2	forge
vsu-1.20.1-fabric-2.1.1.jar	1.20.1	fabric
vsu-1.20.1-forge-2.1.1.jar	1.20.1	forge
vsu-1.21.1-fabric-2.1.1.jar	1.21.1	fabric
vsu-1.21.1-neoforge-2.1.1.jar	1.21.1	neoforge
vsu-26.1.2-neoforge-2.1.1.jar	26.1.2	neoforge

Checksums

3930e06789e7a77b466badcf244fed36e6492701fb1d8cc0e4fbe0819d818044  vsu-1.18.2-fabric-2.1.1.jar
2ecb70ba7accf6d93ef6a658bb5be2b77b5a66dcf13f2751d46409da9d6e1a4b  vsu-1.18.2-forge-2.1.1.jar
4a61137c6d972860cf5ea7d315d0ace3a75b1746beea6051a66d2497f070ca3a  vsu-1.19.2-fabric-2.1.1.jar
3ed45a9b4fc2a254b7a30fb9ebfd5cddd4bb12dc06cbcdff533c239930290871  vsu-1.19.2-forge-2.1.1.jar
30371a13f14d9786b24038023c28cecb37bd92e24e20e5fb1342cd7b60f241ba  vsu-1.20.1-fabric-2.1.1.jar
f6a9eaae0ccab734509ddf9e09dd038617d44cd381f184df6b21256764fc5efb  vsu-1.20.1-forge-2.1.1.jar
34287db604c927d326508db061def020fab06348ad3b2838b3910a8baeca6d90  vsu-1.21.1-fabric-2.1.1.jar
f204d4dc7e7bd58b3a171c84b05cc1c59ada452075c841dd43c828a33bc1f682  vsu-1.21.1-neoforge-2.1.1.jar
c4e1dfde6fa3ce084b13396ba5402f034c8c887818b08ede56236c746d0e8ee1  vsu-26.1.2-neoforge-2.1.1.jar

v2.1.0

Vonix Server Utilities v2.1.0

Added

• Kit Groups across all five Minecraft lanes. Named kits may share a group in config/vonix_server_utilities/kits.json. A player can claim at most one kit in that group during the claiming kit's cooldown (or forever when one_time is true). Kits in different groups stay independently claimable. A missing, blank, or malformed group field defaults to the kit name, so existing kits.json files keep per-kit cooldowns without edits.
• Companion Panel SPI in network.vonix.serverutilities.api across all five lanes, matching the companion vsu-api-2.0.2 surface. New public types: HomeSnapshot, InventorySlotSnapshot, InventorySnapshot, LastDeathSnapshot, PanelCapabilities, PanelDelivery, PanelEvent, PanelEventKind, PanelFeatureKeys, PanelListener, PanelSubscription, PanelTeleportRequest, PanelTeleportResult, PanelTeleportRules, PanelTeleportStatus, PanelTeleportTarget (sealed; Home and Spawn permitted subtypes), PlayerStateSnapshot, ServerSnapshot, VonixPanel, and VonixPanels.

Changed

• vsu_kit_cooldowns gains a claim_group column. Existing databases are upgraded in place: the column is added if missing and blank values are backfilled from kit_name. The upgrade is idempotent, does not drop cooldown rows, and does not rewrite unrelated tables. VonixCore kit imports write named columns and default claim_group to the kit name.

Fixed

• Confirmed the v1.6.1 PermissionGate LP-OR-op UNION (commit 33ed2fe) is present in all five lanes. LuckPerms grant and vanilla op-fallback remain a union: either alone is sufficient, so ops and opFallback=0 player commands keep working on unconfigured LuckPerms installs.

Artifact Matrix

Asset	MC Version	Loader
vsu-1.18.2-fabric-2.1.0.jar	1.18.2	Fabric
vsu-1.18.2-forge-2.1.0.jar	1.18.2	Forge
vsu-1.19.2-fabric-2.1.0.jar	1.19.2	Fabric
vsu-1.19.2-forge-2.1.0.jar	1.19.2	Forge
vsu-1.20.1-fabric-2.1.0.jar	1.20.1	Fabric
vsu-1.20.1-forge-2.1.0.jar	1.20.1	Forge
vsu-1.21.1-fabric-2.1.0.jar	1.21.1	Fabric
vsu-1.21.1-neoforge-2.1.0.jar	1.21.1	NeoForge
vsu-26.1.2-neoforge-2.1.0.jar	26.1.2	NeoForge

Checksums

See SHA256SUMS attached to this release.

v2.0.1

Vonix Server Utilities v2.0.1

Stable release 2.0.1. All nine supported Minecraft/loader lanes are built by GitHub Actions from this tag.

Artifact matrix

The release contains one matching jar for each supported lane: 1.18.2 Fabric/Forge, 1.19.2 Fabric/Forge, 1.20.1 Fabric/Forge, 1.21.1 Fabric/NeoForge, and 26.1.2 NeoForge.

Included with this release

The release includes the CI-built jars for all nine supported lanes and a SHA-256 checksum file named SHA256SUMS.

v2.0.0

Vonix Server Utilities v2.0.0

Common-generation stable release 2.0.0. All nine supported Minecraft/loader lanes are built by GitHub Actions from this tag.

Artifact matrix

The release contains one matching JAR for each supported lane: 1.18.2 Fabric/Forge, 1.19.2 Fabric/Forge, 1.20.1 Fabric/Forge, 1.21.1 Fabric/NeoForge, and 26.1.2 NeoForge.

Included with this release

The release includes the CI-built JARs for all nine supported lanes and a SHA-256 checksum file named SHA256SUMS. Download the artifact matching your Minecraft version and loader, then follow the installation instructions in the README.

Vonix Server Utilities 1.7.1

Vonix Server Utilities 1.7.1

Patch release for the TempMute moderation subsystem across the supported Minecraft templates.

Fixed

• Apply mute enforcement before asynchronous SQLite persistence so the first chat/command is covered.
• Preserve pending writes during startup hydration.
• Fail closed when the active-mute hydration snapshot cannot be read.
• Reconcile overlapping active mutes before clearing enforcement on expiry or revocation.
• Report persistence and reconciliation uncertainty instead of claiming success.
• Keep version surfaces and the configuration helper aligned at 1.7.1.

Verification

• All eight Fabric/Forge/NeoForge production artifacts rebuilt from commit 3e17e115065aeb518396fed54fbdce146a93ac1f.
• Four common-module checks passed, including MuteStateTest: PASS and CrateRulesTest: PASS in each template.
• Independent read-only Terra verification passed for the exact candidate and all eight artifact hashes.
• Fresh disposable Forge 1.18.2 staging server loaded the exact JAR from mods/, reached Done, reported VSU 1.7.1, registered /tempmute, persisted a MUTE row to SQLite, and recorded expiry.

The staging check covered command registration, persistence, and expiry. Connected-player chat cancellation was not exercised because no client was attached.

Artifacts

See SHA256SUMS for SHA-256 hashes of all eight JARs.

No live server, live world, production configuration, or deployment target was changed.

Vonix Server Utilities 1.7.0

Vonix Server Utilities 1.7.0

Stable release for the supported production loader targets.

Included artifacts

• Minecraft 1.18.2 Forge
• Minecraft 1.19.2 Forge
• Minecraft 1.20.1 Forge
• Minecraft 1.21.1 NeoForge

Highlights

• Completed crate command API ports for 1.20.1 and 1.21.1.
• Preserved crate give, open/redeem, completion, and refund behavior.
• SQLite JDBC 3.46.1.0 is packaged through Jar-in-Jar without root org/sqlite leakage.

Fresh production builds used Java 17/Gradle 8.10.2 for Forge and Java 21/Gradle 8.14 for NeoForge. Independent Routera Sol verification accepted the exact release pin after direct source, build-log, artifact, metadata, and bytecode checks.

See SHA256SUMS for artifact hashes.

Vonix Server Utilities v1.6.1

Vonix Server Utilities v1.6.1

Critical hotfix for the v1.6.0 LuckPerms command lockout.

Fixed

• PermissionGate.check() now treats LuckPerms grants and vanilla op-fallback as a UNION:
  • console / command blocks / functions still always pass;
  • a LuckPerms grant for the exact node passes;
  • otherwise, the vanilla opFallback level is consulted.

v1.6.0 made LuckPerms authoritative whenever LP was installed, so unset nodes denied every non-console source. On LP-installed servers that had not run the default-player permission recipe, this locked users out of every VSU command. v1.6.1 restores the intended default behavior while preserving LP grants for non-op access control.

Affected builds

All supported Minecraft templates were rebuilt:

• 1.18.2 Fabric
• 1.18.2 Forge
• 1.19.2 Fabric
• 1.19.2 Forge
• 1.20.1 Fabric
• 1.20.1 Forge
• 1.21.1 Fabric
• 1.21.1 NeoForge

Live-server hotpatch if still on v1.6.0

If you cannot deploy the 1.6.1 jar immediately, this grants all default player commands on v1.6.0:

lp group default permission set vsu.command.* true

For staff groups, adjust the group name as needed:

lp group admin permission set vsu.admin.* true
lp group admin permission set vsu.mod.* true

Do not wildcard vsu.bypass.*.

Verification

All four templates built successfully locally with ./gradlew --no-daemon clean build before release. SHA256SUMS is attached for jar verification.

v1.6.0 — LuckPerms-aware permissions + moderation subsystem

VSU 1.6.0 — LuckPerms-aware permissions + moderation subsystem

The biggest feature release since 1.5.0. Two big additions, plus a complete refit of every existing command, plus 5 docs.

What's new

Moderation subsystem (11 commands)

Every essentials-style moderation tool you'd expect:

Command	Usage	Permission node
/tempban	/tempban <player> <duration> [reason]	vsu.mod.ban
/ban	/ban <player> [reason]	vsu.mod.ban
/unban	/unban <player>	vsu.mod.ban
/banlist	/banlist [page]	vsu.mod.ban
/tempmute	/tempmute <player> <duration> [reason]	vsu.mod.mute
/mute	/mute <player> [reason]	vsu.mod.mute
/unmute	/unmute <player>	vsu.mod.mute
/kick	/kick <player> [reason]	vsu.mod.kick
/warn	/warn <player> <reason>	vsu.mod.warn
/warnings	/warnings <player> [page]	vsu.mod.warn
/clearwarnings	/clearwarnings <player>	vsu.mod.warn

• Duration syntax: 30s, 5m, 2h, 7d, 4w, 1mo, 1y, perm. Composes (1d12h, 7d6h30m).
• SQLite-backed punishments table (created lazily) with active/revoked semantics — the row is preserved on unban for audit.
• Expiry sweeper runs every 60s; expired tempbans/tempmutes auto-revoke.
• Tellraw + delayed disconnect on online tempbans — the player reads the reason before the kick.
• Tab-complete: <duration> suggests 1h, 6h, 1d, 7d, 30d, perm; <player> suggests online players + historical names from the punishments table.
• Bypass nodes (LuckPerms-only): vsu.bypass.mute, vsu.bypass.ban.

See docs/MODERATION.md for the full operator workflow.

LuckPerms-aware permissions

Every existing command was refit to use real permission nodes:

• vsu.command.X — basic player commands (vsu.command.home, vsu.command.tpa, etc.)
• vsu.admin.X — op-grade commands (vsu.admin.warp, vsu.admin.peek, vsu.admin.world, etc.)
• vsu.mod.X — moderation commands
• vsu.bypass.X — escape hatches

The new PermissionGate composes feature toggles + LP node check + vanilla op-level fallback. If LuckPerms is absent, every command falls back to its previous op-level behaviour automatically — no configuration migration needed.

See docs/PERMISSIONS.md for the canonical node tree + LuckPerms recipe groups (default-player, trusted, builder, mod, admin, owner).

Documentation

• docs/COMMANDS.md — alphabetical reference for every command
• docs/PERMISSIONS.md — permission node tree + LP recipes
• docs/MODERATION.md — operator workflow, duration syntax, audit queries, escalation policy template
• docs/GAP-ANALYSIS-v1.6.0.md — research deliverable comparing VSU to FTB Essentials / EssentialsX / Essential Commands. P0 shortlist for v1.6.1: /rtp, /mail, /afk, /disposal, /rules.
• docs/V1.6.0-SPEC.md — authoritative implementation contract.
• README rewritten to represent the whole project.

Build matrix

All 8 build targets: BUILD SUCCESSFUL.

MC	Loader	JDK
1.18.2	Forge 40.x	17
1.18.2	Fabric	17
1.19.2	Forge 43.x	17
1.19.2	Fabric	17
1.20.1	Forge 47.x	17
1.20.1	Fabric	17
1.21.1	NeoForge 21.x	21
1.21.1	Fabric	21

1.18.2 Fabric note: chat-mute is implemented via a Mixin into ServerGamePacketListenerImpl.handleChat because fabric-message-api-v1 isn't present in fabric-api 0.77.0+1.18.2. The mod ships its vonix_server_utilities.mixins.json automatically — no extra setup.

Verification (all 8 jars)

Check	Result
outer org/sqlite/* classes	0 across all 8 jars (sqlite-jdbc stays JiJ-only — inherits v1.5.2 hardening)
JiJ nested sqlite-jdbc-3.46.1.0	✅ present in all 8
PermissionGate.class shipped	✅ all 8
moderation/ModerationCommands.class shipped	✅ all 8

Deployment

Drop-in replacement for any v1.5.x. Delete the old vonix_server_utilities-*.jar from your mods/ directory before installing — same modId cannot coexist.

After install, on first run the mod will:

1. Migrate LuckPermsBridge to expose hasPermission() (transparent).
2. Lazily create the new punishments SQLite table on first moderation command.
3. Pick up the existing feature.<key>.enabled config for all features.

If you run LuckPerms, define your permission groups per docs/PERMISSIONS.md. If you don't run LP, the vanilla op-level fallback kicks in automatically — same access pattern as v1.5.x.

SHA256SUMS

50260319432dcdc77296cb04c9f5fb948463ce3636d3b598cf3141b92c5af9d0  vonix_server_utilities-fabric-mc1.18.2-1.6.0.jar
d6808c35396aed2acac1a4a3cf6231907f42da073bf3e0f1a6b6924b141b456d  vonix_server_utilities-fabric-mc1.19.2-1.6.0.jar
6bdf6ae165a52b9d03d7b1736e2f7b30770ac1fb841d59c3036edb44a540223e  vonix_server_utilities-fabric-mc1.20.1-1.6.0.jar
ac9bb3d72d47928e10d20d802fff1c25df254674c0cf9a1e73d791aa4ed01c6b  vonix_server_utilities-fabric-mc1.21.1-1.6.0.jar
90cc1032ab2addc0014d946263d12b0fdb867b3e40b97aa2a7bcef40388cc635  vonix_server_utilities-forge-mc1.18.2-1.6.0.jar
99984f31be29030fc93d28ab17055bd8dd97bd807542e40e5fbbaebbf36f803e  vonix_server_utilities-forge-mc1.19.2-1.6.0.jar
fc8d99889e232196e89fcf06d4cd0837320da7330cb9544e38c1e242febd5079  vonix_server_utilities-forge-mc1.20.1-1.6.0.jar
bb81e8737fafcb3e3aa660e92133127c499e9124ad7613130823c6a85133fe97  vonix_server_utilities-neoforge-mc1.21.1-1.6.0.jar

— Hermes Agent (Vonix Network)