Compatibility Matrices & Toolchains
1. Unified matrix
Section titled “1. Unified matrix”| Minecraft | Loader | VonixGuardian | VSU | Java | Toolchain |
|---|---|---|---|---|---|
| 26.1.2 | NeoForge (26.1.2.93) | 3.0.0-m1 | 2.0.2 | Java 25 | ModDevGradle 2.0.140 |
| 1.21.1 | NeoForge | 3.0.0-m1 | 2.0.2 | Java 21 | net.neoforged.moddev jarJar / Architectury |
| 1.21.1 | Fabric | 3.0.0-m1 | 2.0.2 | Java 21 | Fabric Loom JarInJar (META-INF/jars) |
| 1.20.1 | Forge | 3.0.0-m1 | 2.0.2 | Java 17 | ForgeGradle 6 jarJar / Architectury |
| 1.20.1 | Fabric | 3.0.0-m1 | 2.0.2 | Java 17 | Fabric Loom JarInJar (META-INF/jars) |
| 1.19.2 | Forge | 3.0.0-m1 | 2.0.2 | Java 17 | ForgeGradle 6 jarJar / Architectury |
| 1.19.2 | Fabric | 3.0.0-m1 | 2.0.2 | Java 17 | Fabric Loom JarInJar (META-INF/jars) |
| 1.18.2 | Forge | 3.0.0-m1 | 2.0.2 | Java 17 | ForgeGradle 6 jarJar / Architectury |
| 1.18.2 | Fabric | 3.0.0-m1 | 2.0.2 | Java 17 | Fabric Loom JarInJar (META-INF/jars) |
2. Java class versions
Section titled “2. Java class versions”Minecraft servers reject mismatched class-file versions:
- Java 17 (class version 61.0): required for 1.18.2, 1.19.2, and 1.20.1.
- Java 21 (class version 65.0): required for 1.21.1 (Fabric and NeoForge).
- Java 25 (class version 69.0): required for 26.1.2 (NeoForge).
java -version3. Optional integrations
Section titled “3. Optional integrations”Neither mod hard-depends on these products. Behavior when they are absent is documented below.
LuckPerms
Section titled “LuckPerms”- Status: supported through reflection.
- Behavior: LuckPerms classes are never hard-imported. Without LuckPerms, VonixGuardian uses
defaultOpLevel: 3. VSU uses union semantics (HasLuckPermsNode OR OpLevel >= opFallback).
Curios and Trinkets
Section titled “Curios and Trinkets”- Status: VSU
/accseebridge. - Behavior: Curios on Forge/NeoForge, Trinkets on Fabric. If neither is installed,
/accseereports that no accessory provider is available.
Modded griefing attribution
Section titled “Modded griefing attribution”- Status: VonixGuardian universal attribution chain.
- Behavior: Player blame is resolved through vanilla ownership interfaces (
getControllingPassenger(),TamableAnimal.getOwnerUUID(),OwnableEntity). Per-mod adapters are not required. Coverage of a specific third-party mechanic is not a compatibility guarantee.
WorldEdit
Section titled “WorldEdit”- Status: soft-dependency in VonixGuardian.
- Behavior:
r:#worldeditandr:#weare accepted by the parser. In3.0.0-m1they fall back to an unbounded global radius rather than a WorldEdit selection box.
4. Modpack validation boundary
Section titled “4. Modpack validation boundary”Known validation boundary: external Fabric 1.21.1 server pack
In a headless Fabric 1.21.1 pack test, VonixGuardian loaded with zero hopper or dispenser errors.
The pack itself did not reach readiness because an unrelated third-party mixin failed:
owo.mixins.json:MainMixin afterQuiltHook injection failed.
Treat this as an external pack dependency boundary, not as a VonixGuardian crash.