Creare un Progetto

Fabric offre un modo facile per creare un nuovo progetto per una mod attraverso il Generatore di Mod Modello di Fabric - se vuoi, puoi creare un nuovo progetto manualmente usando la repository della mod esempio, dovresti riferirti alla sezione Creazione Manuale del Progetto.

Generare un Progetto

Puoi usare il Generatore di Mod Modello di Fabric per generare un nuovo progetto per la tua mod - dovresti compilare i campi richiesti, come il nome della mod, quello del package, e la versione di Minecraft per la quale vuoi sviluppare.

Il nome del package dovrebbe essere minuscolo, separato da punti, e unico per evitare conflitti con package di altri programmatori. Di solito viene formattato come un domain internet invertito, per esempio com.example.example-mod.

IMPORTANTE

Prendi nota dell'ID della tua mod! Se trovi example-mod in questa documentazione, soprattutto nei percorsi dei file, dovrai sostituirlo con il tuo ID.

Se, per esempio, l'ID della tua mod fosse la-mia-mod, invece di resources/assets/example-mod usa resources/assets/la-mia-mod.

Se avessi intenzione di usare Kotlin, o di usare i mapping di Fabric Yarn invece di quelli predefiniti di Mojang, o volessi aggiungere generatori di dati, puoi selezionare le opzioni appropriate nella sezione Advanced Options.

INFO

Gli esempi in codice presenti su questo sito usano i nomi ufficiali di Mojang. Se la tua mod non usasse gli stessi mapping di questa documentazione, dovrai convertirne il codice usando strumenti online come mappings.dev o Linkie.

Una volta che hai compilato i campi richiesti, premi il pulsante Generate, e il generatore creerà un nuovo progetto per te sotto forma di file zip.

Dovresti estrarre questo file zip a una posizione che scegli tu, e poi aprire la cartella estratta nel tuo IDE.

TIP

È buona prassi seguire queste regole nel scegliere il percorso del tuo progetto:

• Evita cartelle sincronizzate sul cloud (per esempio Microsoft OneDrive)
• Evita caratteri non in ASCII (per esempio emoji, lettere con l'accento)
• Evita spazi

Per esempio, un "buon" percorso potrebbe essere: C:\Progetti\NomeDelProgetto

Creazione Manuale del Progetto

PREREQUISITI

Ti servirà che Git sia installato per clonare la repository della mod esempio.

Se non puoi usare il Generatore di Mod Modello di Fabric, dovresti creare un nuovo progetto manualmente seguendo questi passaggi.

Anzitutto, clona la repository della mod esempio tramite Git:

git clone https://github.com/FabricMC/fabric-example-mod/ example-mod

Questo clonerà la repository in una nuova cartella chiamata example-mod.

Dovresti poi eliminare la cartella .git dalla repository clonata, e poi aprire il progetto. Se la cartella .git dovesse non apparire, dovresti attivare la visualizzazione dei file nascosti nel tuo gestore file.

Quando avrai aperto il progetto nel tuo IDE, esso dovrebbe automaticamente caricare la configurazione Gradle del progetto ed effettuare le operazioni di setup necessarie.

Di nuovo, come già detto in precedenza, se ricevi una notifica riguardo a uno script di build Gradle, dovresti cliccare il pulsante Importa Progetto Gradle.

Modificare il Template

Una volta che il progetto sarà importato, dovresti modificare i dettagli del progetto per corrispondere a quelli della tua mod:

• Modifica il file gradle.properties del tuo progetto per cambiare le proprietà maven_group e archive_base_name e farle corrispondere con i dettagli della tua mod.
• Modifica il file fabric.mod.json per cambiare le proprietà id, name, e descrizione per farle corrispondere ai dettagli della tua mod.
• Assicurati di aggiornare le versioni di Minecraft, i mapping, il Loader e il Loom - tutte queste possono essere trovate attraverso https://fabricmc.net/develop/ - per farle corrispondere alle versioni che vorresti prendere di mira.

Ovviamente puoi cambiare il nome del package e la classe principale della mod per farli corrispondere ai dettagli della tua mod.