Plateformes
Mods Fabric
Mods Fabric avec Codexe : quoi demander, versions de Minecraft et du loader, build Gradle/Loom (Java 21 pour 1.20.1), mixins et problèmes courants.
Mis à jour
Sur cette page
Fabric est un mod loader léger qui prend généralement en charge rapidement les nouvelles versions de Minecraft. Codexe génère un projet Gradle complet qui utilise le plugin Loom de Fabric.
#Ce qu'il faut mettre dans la demande
- Version de Minecraft : « Fabric pour 1.20.1 », « 1.21.1 ». Sans précision, 1.20.1 est utilisée.
- Ce que le mod ajoute : blocs, objets, entités, commandes, raccourcis clavier, éléments de HUD. Soyez précis sur le comportement.
- Client ou serveur : indiquez s'il est uniquement côté client (HUD, raccourcis clavier), uniquement côté serveur, ou les deux.
- Dépendances : Fabric API est incluse. Nommez toutes les autres (Cloth Config, Mod Menu…).
A Fabric mod for 1.21.1: a "Magnet" item that pulls nearby dropped items to the player within 8 blocks while held in the offhand. Toggle with a keybind (default M). Crafting: iron ingots around a redstone block. English lang file and item model.#Ce que Codexe génère
build.gradle,gradle.properties(versions de Minecraft, de Yarn, du loader et de Fabric API) etsettings.gradle.fabric.mod.jsonavec des points d'entrée séparés par environnement (main,client).- La configuration et les classes de mixins quand la fonctionnalité en a besoin.
- Les ressources : fichiers de langue, modèles, textures provisoires.
#Fonctionnement du build
- Codexe fixe une version stable de Loom (les anciennes versions
-SNAPSHOTdisparaissent du dépôt de Fabric et cassent les builds). - Si la version demandée du loader, de Yarn ou de Fabric API n'existe pas, Codexe la remplace par une version réelle pour cette version de Minecraft.
- Loom a besoin d'un environnement Java 21 pour exécuter Gradle. Pour un mod 1.20.1 (qui cible Java 17), Codexe exécute Gradle sous Java 21 tandis que votre mod reste compilé pour Java 17. Le JAR fonctionne sur un serveur Java 17.
Le premier build d'un mod prend plus de temps (souvent quelques minutes) : Loom télécharge Minecraft et les mappings. Les builds de mods s'arrêtent au bout de 10 minutes.
#Vérification
Le mod est compilé avant d'être Prêt, et le JAR doit contenir fabric.mod.json (ou quilt.mod.json). La compilation prouve qu'il compile, pas qu'il tourne sans planter : testez-le donc dans un client.
#Problèmes courants
| Symptôme | Cause probable |
|---|---|
| Plantage sur un serveur dédié qui mentionne des classes client | Du code réservé au client dans le point d'entrée main. Demandez au chat de le déplacer vers le point d'entrée client. |
| « Incompatible mods found », mauvaise version de Minecraft | Le mod cible une version de Minecraft différente de celle de votre jeu. Indiquez la version exacte. |
| Fabric API manquante à l'exécution | Installez Fabric API dans mods/ à côté du mod. |