Learn · guides
Come installare una mod Fabric
Tre passaggi per installare qualsiasi mod di Fabric: Fabric Loader, Fabric API, poi il file JAR della mod. Guida completa con risoluzione dei problemi.
L'installazione di una mod Fabric segue un semplice processo in tre fasi: assicurati che il Fabric Loader sia installato per la tua versione di Minecraft, aggiungi la Fabric API alla cartella delle mod, quindi trascina il file JAR della mod accanto ad essa. La maggior parte dei problemi di installazione derivano da incompatibilità di versione, quindi verifica che ogni componente sia mirato alla stessa versione di Minecraft
Prerequisiti
Prima di installare una mod:
- Fabric Loader installato per la tua versione di Minecraft (vedi Come installare Fabric Loader)
- Hai lanciato almeno una volta il profilo Fabric in modo che la cartella delle mod esista
- Il file JAR della mod scaricato
Il processo in tre fasi
Avere il caricatore Fabric installato
Assicurati di aver installato e avviato il Fabric loader per la tua versione di Minecraft. Se non l'hai fatto, segui prima la guida all'installazione del Fabric loader.
Scarica e aggiungi Fabric API
Scarica il file JAR dell'API Fabric corrispondente alla tua versione di Minecraft. Inseriscilo nella cartella mods. La maggior parte dei mod ne dipende.
Aggiungi il JAR della mod
Scarica il file JAR della mod e posizionalo nella stessa cartella delle mod, accanto a Fabric API. Non estrarlo: deve rimanere un file JAR.
Avvia Minecraft utilizzando il profilo Fabric e i mod si caricheranno automaticamente all'avvio.
La cartella dei mod
La tua cartella dei mod si trova in:
| Sistema operativo | Percorso |
|---|---|
| Windows | %appdata%\.minecraft\mods |
| macOS | ~/Library/Application Support/minecraft/mods |
| Linux | ~/.minecraft/mods |
Se la cartella non esiste, esegui il profilo Fabric una volta e verrà creata per te.
Fabric API: perché ti serve
La maggior parte dei mod Fabric dipende dalla Fabric API, una libreria condivisa che fornisce utilità comuni per i modder. Installarla per prima previene crash dovuti a librerie mancanti. Anche se un mod specifico afferma di non aver bisogno dell'API, aggiungerla non fa male ed evita sorprese.
Cosa fare quando un mod non si carica
- Il mod non compare nella lista dei mod: il JAR si trova nella cartella sbagliata, oppure hai avviato la versione vanilla invece di Fabric. Verifica il percorso e il profilo.
- Crash con errore "classe mancante": l'API di Fabric non è presente o è la versione sbagliata. Scarica la versione corretta dell'API per la tua versione di Minecraft.
- Errore di incongruenza di versione nei log: il loader, l'API o il mod sono mirati a versioni di Minecraft diverse. Tutti e tre devono corrispondere esattamente (ad esempio, 1.21, non 1.21.1 se il mod è mirato a 1.21).
- Il mod si carica ma si blocca quando utilizzato: il mod potrebbe essere in conflitto con un altro mod o con un'impostazione. Prova ad avviare il gioco solo con quel mod per isolare il problema.
Corrispondenza delle versioni
Questo è l'ostacolo più grande. Ogni componente deve essere indirizzato alla stessa versione:
Minecraft version: 1.21
Fabric loader version: 1.21 ✓
Fabric API version: 1.21 ✓
Mod version: 1.21 ✓
All match → no crash
Se Minecraft è alla versione 1.21 ma un mod è indirizzato alla versione 1.20.1, non si caricherà. Controlla la pagina di download del mod per la versione esatta che supporta.
Esecuzione di più mod
Una volta che hai un mod funzionante, aggiungere altri è semplice:
- Scarica ogni file JAR del mod
- Trascinali tutti nella cartella mods
- Avvia Fabric
- Tutti i mod si caricano insieme (a condizione che non ci siano conflitti)
Alcuni mod sono in conflitto tra loro. Se si verificano crash dopo aver aggiunto un nuovo mod, disabilitalo per confermare che sia la causa, quindi controlla se l'autore del mod documenta il conflitto.
FAQ
La maggior parte delle mod per Fabric ne dipende, quindi installala di default. Poche mod autonome e rare non la richiedono, ma aggiungerla non causa mai problemi e risolve la maggior parte dei crash dovuti a "classi mancanti".
Di solito è un problema di versione non corrispondente. Verifica che il Fabric Loader, la Fabric API e il tuo mod siano tutti mirati alla stessa versione esatta di Minecraft. Controlla la pagina di download del mod per le informazioni sulla versione.
Nella cartella "mods" all'interno della directory di Minecraft (percorsi sopra). Se la cartella non esiste, avvia una volta il profilo Fabric e verrà creata.
Sì. Inserisci ogni JAR nella cartella mods e avvia Fabric. Finché sono compatibili con la tua versione di Minecraft e non confliggono, il loader le eseguirà tutte.