Come configurare un ambiente di sviluppo Fabric

Configurare un ambiente di modding per Fabric richiede quattro passaggi: installare un Java Development Kit, partire dal modello di mod ufficiale, configurare le Yarn mappings, quindi eseguire Gradle. Il plugin di build di Fabric scarica Minecraft e connette tutto il resto. Allinea la versione del tuo JDK e di Minecraft fin dall'inizio e il sistema di build si occuperà del resto.

Cosa ti serve per prima cosa

Prima di scrivere codice:

• Un JDK compatibile con la tua versione di Minecraft. Le versioni più recenti di Minecraft richiedono JDK più recenti. Verifica i requisiti della versione di destinazione prima dell'installazione.
• Un IDE. IntelliJ IDEA Community (gratuito) o Eclipse funzionano bene. La maggior parte degli sviluppatori di Fabric utilizza IntelliJ perché l'integrazione con Gradle è più fluida.
• Git. Clonerai il repository del modello e gestirai il tuo codice.

NON è necessario installare Gradle. Il modello include uno script wrapper che scarica la versione corretta alla prima esecuzione.

Passo dopo passo

1. Installa un JDK

   Scarica un JDK da Adoptium o Oracle compatibile con la versione di Minecraft che ti interessa. Per Minecraft 1.21, installa Java 21. Indica al tuo IDE questo JDK nelle impostazioni.

2. Ottieni il modello mod di esempio

   Vai nel repository ufficiale di mod di esempio di Fabric su GitHub e clonalo o usalo come modello. Rinomina il pacchetto e l'ID della mod con i tuoi.

3. Imposta le versioni in gradle.properties

   Apri gradle.properties e aggiorna tre righe:

   • minecraft_version — la versione di Minecraft a cui miri (ad esempio, 1.21)
   • loader_version — la versione del loader Fabric corrispondente alla tua build di Minecraft
   • yarn_mappings — la versione di Yarn per la tua release di Minecraft

   Queste tre versioni devono corrispondere, altrimenti il progetto non verrà compilato.

4. Apri nel tuo IDE e sincronizza

   Apri la cartella del progetto nel tuo IDE. Lascia che Gradle esegua una sincronizzazione iniziale (scarica le dipendenze, genera le configurazioni di esecuzione).

5. Genera sorgenti decompiler

   Nel pannello Gradle del tuo IDE, esegui genSources. Questo decompile Minecraft utilizzando i nomi di Yarn, così potrai leggere il codice del gioco.

6. Avvia un client di prova

   Esegui runClient per avviare Minecraft con la tua mod caricata. Il client di sviluppo include funzionalità di debug complete.

Ecco fatto. Ora hai un ambiente di sviluppo Fabric funzionante.

Comprendere gradle.properties

Questo file configura l'intero processo di build. Tre versioni devono rimanere sincronizzate:

minecraft_version=1.21
loader_version=0.15.11
yarn_mappings=1.21+build.32

Se Minecraft è 1.21 ma Yarn è 1.20.1, Gradle non si sincronizza con un errore criptico. Scarica sempre le versioni corrispondenti da fabricmc.net/use o dal modello di esempio.

Cosa fa il plugin di build

Il plugin Gradle di Fabric è configurato in build.gradle e gestisce:

• Il download di Minecraft
• La decompilazione con le mappature scelte
• La rimappatura del tuo codice a intermediary per la compatibilità
• La generazione delle configurazioni di esecuzione dell'IDE

Lo configuri una volta; automatizza il resto. Ecco perché il modello è importante: ha già tutto configurato correttamente.

Spiegazione delle mappature

Minecraft viene fornito con codice offuscato (nomi di classe come a, b, c). Le mappature traducono questi in nomi leggibili.

• Yarn: L'impostazione predefinita di Fabric. Include la documentazione. Facile da leggere.
• Mappature Mojang: Ufficiali ma meno documentate. Nomi più oscuri.

Il modello utilizza Yarn. Quando esegui genSources, Minecraft viene decompilato utilizzando i nomi Yarn in modo da poter leggere il codice effettivo. Quando compili, Fabric lo rimappa a intermediary (un livello stabile sottostante) in modo che il mod funzioni su qualsiasi versione di Minecraft corrispondente.

Problemi comuni di configurazione

• ✓La sincronizzazione di Gradle fallisce immediatamente: verificare gradle.properties. Le versioni di Minecraft, del loader e di Yarn devono corrispondere. Utilizzare una combinazione nota dal sito web di Fabric.
• ✓Errore del compilatore relativo alla versione di Java: il tuo JDK è troppo vecchio per la versione di Minecraft. Installa un JDK più recente e punta il tuo IDE verso di esso.
• ✓Impossibile leggere il codice sorgente di Minecraft: esegui genSources nel pannello Gradle e ricarica. La prima esecuzione è lenta perché decompila l'intero gioco.
• ✓runClient non fa nulla: attendi il completamento della sincronizzazione Gradle iniziale. Le configurazioni di esecuzione vengono generate durante la sincronizzazione.
• ✓L'IDE non importa il progetto: assicurati che l'IDE abbia un JDK selezionato nelle impostazioni, non una JRE.

Passaggi successivi dopo la configurazione

Una volta che il tuo ambiente funziona:

1. Elimina o rinomina le classi mod di esempio
2. Crea il tuo pacchetto mod
3. Implementa una funzionalità semplice (un blocco, un oggetto o un listener di eventi)
4. Esegui runClient e testa nel client di sviluppo
5. Itera

Il client di sviluppo include il supporto completo per il debug e il hot-reload, rendendo l'iterazione veloce

Note specifiche per IDE

IntelliJ IDEA:

• Importa come progetto Gradle (non solo una cartella)
• Lascia che Gradle sincronizzi completamente prima di eseguire qualsiasi attività
• Le configurazioni di esecuzione appaiono sotto "Gradle" nel menu a tendina di esecuzione

Eclipse:

• Importa come progetto Gradle esistente
• Clic destro sul progetto → Gradle → Aggiorna progetto Gradle dopo la sincronizzazione
• Le attività Gradle appaiono nella vista Gradle Tasks

DOMANDE FREQUENTI