Comment configurer un environnement de développement Fabric

La configuration d'un environnement de modding Fabric nécessite quatre étapes : installer un kit de développement Java, partir du modèle de mod officiel, configurer les mappings Yarn, puis exécuter Gradle. Le plugin de construction Fabric télécharge Minecraft et configure tout le reste. Assurez-vous que votre JDK et votre version de Minecraft sont compatibles dès le départ, et le système de construction s'occupe du reste.

Ce dont vous avez besoin en premier

Avant d'écrire du code :

• Un JDK compatible avec votre version de Minecraft. Les versions récentes de Minecraft nécessitent des JDK plus récents. Vérifiez les exigences de la version cible avant d'installer.
• Un IDE. IntelliJ IDEA Community (gratuit) ou Eclipse fonctionnent bien. La plupart des développeurs Fabric utilisent IntelliJ car l'intégration Gradle est plus fluide.
• Git. Vous clonerez le dépôt de modèle et gérerez votre propre code.

Vous n'avez PAS besoin d'installer Gradle. Le modèle inclut un script wrapper qui télécharge la bonne version lors de la première exécution.

Étape par étape

1. Installez un JDK

   Téléchargez un JDK à partir d'Adoptium ou d'Oracle correspondant à la version de Minecraft que vous ciblez. Pour Minecraft 1.21, installez Java 21. Indiquez à votre IDE ce JDK dans ses paramètres.

2. Obtenez le modèle de modulaire d'exemple

   Rendez-vous sur le dépôt officiel des mods Fabric sur GitHub et clonez-le ou utilisez-le comme modèle. Renommez le paquet et l'identifiant du mod avec vos propres noms.

3. Définir les versions dans gradle.properties

   Ouvrez gradle.properties et mettez à jour trois lignes :

   • minecraft_version — la version de Minecraft cible (par exemple, 1.21)
   • loader_version — la version du chargeur Fabric correspondant à votre build Minecraft
   • yarn_mappings — la version de Yarn pour votre version de Minecraft

   Ces trois éléments doivent correspondre, sinon le projet ne pourra pas être compilé.

4. Ouvrez dans votre IDE et synchronisez

   Ouvrez le dossier du projet dans votre IDE. Laissez Gradle effectuer une synchronisation initiale (téléchargement des dépendances, génération des configurations d'exécution).

5. Générer les sources décompilées

   Dans le panneau Gradle de votre IDE, exécutez genSources. Cela décompile Minecraft en utilisant les noms Yarn, ce qui vous permet de lire le code du jeu.

6. Lancer un client de test

   Exécutez runClient pour lancer Minecraft avec votre mod chargé. Le client de développement inclut des capacités de débogage complètes.

C'est tout. Vous disposez maintenant d'un environnement de développement Fabric opérationnel.

Comprendre gradle.properties

Ce fichier configure toute votre construction. Trois versions doivent rester synchronisées :

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

Si Minecraft est 1.21 mais que Yarn est 1.20.1, Gradle ne se synchronise pas et affiche une erreur obscure. Téléchargez toujours les versions correspondantes sur fabricmc.net/use ou à partir du modèle d'exemple.

Ce que fait le plugin de construction

Le plugin Gradle Fabric est configuré dans build.gradle et gère :

• Le téléchargement de Minecraft
• La décompilation avec les mappings que vous avez choisis
• Le remappage de votre code vers l'intermédiaire pour la compatibilité
• La génération de configurations d'exécution IDE

Vous le configurez une fois ; il automatise le reste. C'est pourquoi le modèle est important : il est déjà correctement câblé.

Explication des mappings

Minecraft est fourni avec du code obscurci (noms de classes tels que a, b, c). Les mappings traduisent ces noms en noms lisibles.

• Yarn : Le choix par défaut de Fabric. Inclut la documentation. Facile à lire.
• Mappings Mojang : Officiels mais moins documentés. Noms plus obscurs.

Le modèle utilise Yarn. Lorsque vous exécutez genSources, Minecraft est décompilé à l'aide des noms Yarn afin que vous puissiez lire le code réel. Lors de la compilation, Fabric le remappe vers l'intermédiaire (une couche stable en dessous) afin que le mod fonctionne avec n'importe quelle version de Minecraft compatible.

Problèmes de configuration courants

• ✓L'opération Gradle Sync échoue immédiatement : vérifiez gradle.properties. Les versions de Minecraft, du loader et de Yarn doivent correspondre. Utilisez une combinaison connue du site web de Fabric.
• ✓Erreur du compilateur concernant la version de Java : votre JDK est trop ancien pour la version de Minecraft. Installez un JDK plus récent et configurez votre IDE en conséquence.
• ✓Impossible de lire le code source de Minecraft : exécutez genSources dans le panneau Gradle et rechargez. La première exécution est lente car elle décompile tout le jeu.
• ✓runClient ne fait rien : attendez que la synchronisation Gradle initiale soit terminée. Les configurations d'exécution sont générées pendant la synchronisation.
• ✓L'IDE ne parvient pas à importer le projet : assurez-vous que l'IDE a un JDK sélectionné dans ses paramètres, et non un JRE.

Prochaines étapes après l'installation

Une fois votre environnement opérationnel :

1. Supprimez ou renommez les classes de mod d'exemple
2. Créez votre propre paquet de mod
3. Implémentez une fonctionnalité simple (un bloc, un objet ou un écouteur d'événements)
4. Exécutez runClient et testez dans le client de développement
5. Itérez

Le client de développement inclut un support complet du débogage et du rechargement à chaud, ce qui permet une itération rapide.

Notes spécifiques à l'IDE

IntelliJ IDEA :

• Importez en tant que projet Gradle (et non simplement un dossier)
• Laissez Gradle se synchroniser complètement avant d'exécuter toute tâche
• Les configurations d'exécution apparaissent sous "Gradle" dans le menu déroulant d'exécution

Eclipse :

• Importez en tant que projet Gradle existant
• Cliquez avec le bouton droit sur le projet → Gradle → Actualiser le projet Gradle après la synchronisation
• Les tâches Gradle apparaissent dans la vue Tâches Gradle

FAQ