- La configurazione si articola in quattro passaggi: un JDK, il template del mod di esempio, le tue mappature, poi Gradle.
- Il plugin di build Fabric scarica Minecraft e configura le attività di esecuzione per te.
- Non installi mai Gradle direttamente: il template include un wrapper.
- Una discrepanza di versione in
gradle.propertiesè la causa più comune di fallimento di un progetto nuovo.
Configurare un ambiente di sviluppo per Fabric richiede quattro passaggi: installare un JDK, partire dal modello di mod ufficiale, scegliere le mappature (solitamente Yarn), quindi eseguire le attività Gradle che scaricano Minecraft e avviano un client di test. Il plugin di build si occupa del lavoro pesante. Allineare la versione del JDK e di Minecraft fin dall'inizio e il resto seguirà.
Dove si integra Opal
Opal è un mod Fabric con un motore di scripting JavaScript GraalVM, quindi puoi estenderlo con script senza dover configurare un'intera toolchain di mod. Se vuoi solo installarlo ed eseguirlo, segui la guida alla configurazione; per iniziare a scrivere script, consulta la documentazione per gli script.
Cosa ti serve innanzitutto
Hai bisogno di tre cose prima di scrivere qualsiasi codice: un Java Development Kit, un IDE e Git.
- Un JDK. Scegli quello compatibile con la versione di Minecraft a cui miri. Le versioni più recenti di Minecraft richiedono un JDK più recente, quindi verifica i requisiti della versione prima di iniziare.
- Un IDE. IntelliJ IDEA o Eclipse funzionano entrambi. La maggior parte degli sviluppatori di Fabric utilizza IntelliJ perché l'integrazione con Gradle e il decompiler è più fluida.
- Git. Clonerai il repository del template e seguirai le tue modifiche.
Non dovrai installare Gradle manualmente. Il template include uno script wrapper di Gradle che scarica la versione corretta alla prima esecuzione.
Passo dopo passo
Installa un JDK
Installa un JDK compatibile con la versione di Minecraft che intendi utilizzare e configura il tuo IDE per puntare a esso.
Ottieni il modello mod di esempio
Scegli le tue corrispondenze
Il template utilizza Yarn per impostazione predefinita. Yarn fornisce nomi leggibili e documentati per le classi e i metodi di Minecraft. Imposta la versione di Minecraft, la versione del loader e la versione delle corrispondenze Yarn in gradle.properties.
Genera le risorse ed esegui
Apri il progetto nel tuo IDE, attendi la sincronizzazione di Gradle, quindi esegui genSources per decompilare Minecraft rispetto ai nomi di Yarn. Esegui il task runClient per avviare un client di sviluppo con la tua mod caricata.
Cosa fa per te il plugin di build
Il plugin di build Gradle per Fabric scarica Minecraft, lo rimappa alle mappature scelte e configura le run configuration. Lo configuri tramite un piccolo blocco in build.gradle.
| Imposti | Dove | Cosa controlla |
|---|---|---|
| Versione di Minecraft | gradle.properties | La build del gioco a cui compili |
| Versione del loader | gradle.properties | Il loader Fabric su cui gira il tuo mod |
| Versione di Yarn | gradle.properties | I nomi delle mappature utilizzati nel tuo codice sorgente |
| Dipendenze | build.gradle | La Fabric API e qualsiasi libreria |
Mantieni le tre versioni in gradle.properties coerenti. Una discrepanza tra la versione di Minecraft e la versione delle mappature Yarn è la causa più comune per cui un nuovo progetto non riesce a sincronizzarsi.
Perché le mappature sono importanti qui
Minecraft viene distribuito offuscato, quindi le sue classi hanno nomi come a.a.a. Yarn mappa questi nomi in nomi leggibili e si basa sul livello stabile intermediary. Quando esegui genSources, il plugin di build decompile il gioco utilizzando i nomi Yarn in modo che tu possa leggere e fare riferimento direttamente al codice di Minecraft. Quando compila il tuo mod, rimappa il tuo codice con nomi Yarn verso intermediary in modo che il jar finale funzioni su qualsiasi installazione corrispondente indipendentemente dalle modifiche alle mappature.
Quando il progetto non si compila
- La sincronizzazione di Gradle fallisce subito dopo l'importazione: di solito le versioni di Minecraft, del loader e di Yarn in
gradle.propertiesnon sono coerenti. Impostale su una serie nota e corrispondente. - Versione Java errata: la build segnala una versione del file di classe non supportata quando il tuo JDK è più vecchio della versione richiesta da Minecraft. Installa un JDK più recente e punta il progetto verso di esso.
- Nessuna fonte decompilerata da leggere: esegui
genSourcese ricarica. La prima esecuzione richiede un po' di tempo perché decompila l'intero gioco. runClientnon fa nulla: lascia terminare la sincronizzazione iniziale di Gradle prima di eseguire qualsiasi attività. Le configurazioni di esecuzione vengono generate durante la sincronizzazione.
DOMANDE FREQUENTI
No. Il template di esempio di Fabric include un wrapper di Gradle che scarica la versione corretta di Gradle alla prima esecuzione. Utilizza ./gradlew invece di una versione di Gradle installata a livello di sistema.
Utilizza il modello ufficiale per mod. Include già il plugin di build, le Yarn mappings e le attività di esecuzione, quindi salta la configurazione complicata e inizia a scrivere codice.
Yarn è l'impostazione predefinita di Fabric e include nomi documentati, quindi è la scelta più semplice. Puoi creare il progetto anche utilizzando le mappature ufficiali di Mojang, ma il template è configurato per Yarn di default.
Quella richiesta dalla versione di Minecraft che intendi utilizzare. Le versioni più recenti richiedono JDK più recenti, quindi verifica la versione prima di installare e configura il tuo IDE per utilizzare quella JDK.
Decompila Minecraft utilizzando le Yarn mappings scelte, permettendoti di leggere il codice del gioco e fare riferimento alle sue classi con nomi leggibili durante lo sviluppo.
