Piattaforme

Mod Fabric

Mod Fabric con Codexe: cosa chiedere, versioni di Minecraft e del loader, la build con Gradle/Loom (Java 21 per la 1.20.1), mixin e problemi più comuni.

Aggiornato 27 settembre 2026

In questa pagina

Cosa mettere nella richiesta
Cosa genera Codexe
Come funziona la build
Verifica
Problemi comuni

Fabric è un mod loader leggero che di solito supporta in fretta le nuove versioni di Minecraft. Codexe genera un progetto Gradle completo che usa il plugin Loom di Fabric.

#Cosa mettere nella richiesta

Versione di Minecraft: "Fabric per la 1.20.1", "1.21.1". Se non la indichi, viene usata la 1.20.1.
Cosa aggiunge la mod: blocchi, oggetti, entità, comandi, tasti, elementi dell'HUD. Sii preciso sul comportamento.
Client o server: di' se è solo client (HUD, tasti), solo server o entrambi.
Dipendenze: Fabric API è inclusa. Nomina le altre (Cloth Config, Mod Menu…).

Text

A Fabric mod for 1.21.1: a "Magnet" item that pulls nearby dropped items to the player within 8 blocks while held in the offhand. Toggle with a keybind (default M). Crafting: iron ingots around a redstone block. English lang file and item model.

#Cosa genera Codexe

build.gradle, gradle.properties (versioni di Minecraft, Yarn, loader e Fabric API) e settings.gradle.
fabric.mod.json con gli entrypoint divisi per ambiente (main, client).
Configurazione e classi dei mixin quando la funzione ne ha bisogno.
Asset: file di lingua, modelli, texture provvisorie.

#Come funziona la build

Codexe fissa una versione stabile di Loom (le vecchie versioni -SNAPSHOT spariscono dal repository di Fabric e rompono le build).
Se la versione richiesta del loader, di Yarn o di Fabric API non esiste, Codexe la sostituisce con una vera per quella versione di Minecraft.
Loom ha bisogno di un runtime Java 21 per eseguire Gradle. Per una mod per la 1.20.1 (che punta a Java 17), Codexe esegue Gradle su Java 21 mentre la tua mod resta compilata per Java 17. Il JAR funziona su un server con Java 17.

La prima build di una mod richiede più tempo (spesso qualche minuto): Loom scarica Minecraft e i mapping. Le build delle mod si fermano dopo 10 minuti.

#Verifica

La mod viene compilata prima di essere Pronta, e il JAR deve contenere fabric.mod.json (o quilt.mod.json). La compilazione dimostra che si compila, non che giri senza crash, quindi provala in un client.

#Problemi comuni

Sintomo	Causa probabile
Crash su un server dedicato che cita classi del client	Codice solo client nell'entrypoint `main`. Chiedi alla chat di spostarlo nell'entrypoint `client`.
"Incompatible mods found", versione di Minecraft sbagliata	La mod punta a una versione di Minecraft diversa da quella del tuo gioco. Indica la versione esatta.
Fabric API mancante durante l'esecuzione	Installa Fabric API in `mods/` insieme alla mod.