Learn · guides
Comment installer un mod Fabric
Trois étapes pour installer n'importe quel mod Fabric : Fabric Loader, Fabric API, puis le fichier JAR du mod. Guide complet avec résolution des problèmes.
L'installation d'un mod Fabric suit un processus simple en trois étapes : assurez-vous que le Fabric Loader est installé pour votre version de Minecraft, ajoutez l'API Fabric à votre dossier de mods, puis déposez le fichier JAR du mod à côté. La plupart des problèmes d'installation sont dus à des incompatibilités de versions, vérifiez donc que chaque élément est ciblé pour la même version de Minecraft
Prérequis
Avant d’installer un mod :
- Fabric Loader installé pour votre version de Minecraft (voir Comment installer Fabric Loader)
- Vous avez lancé le profil Fabric au moins une fois pour que le dossier des mods existe
- Le fichier JAR du mod téléchargé
Le processus en trois étapes
Avoir Fabric Loader installé
Assurez-vous d'avoir installé et lancé le Fabric Loader pour votre version de Minecraft. Si ce n'est pas le cas, suivez d'abord le guide d'installation du Fabric Loader : Fabric loader installation guide.
Téléchargez et ajoutez l'API Fabric
Téléchargez le fichier JAR de l'API Fabric (https://fabricmc.net/use/api/) correspondant à votre version de Minecraft. Placez-le dans votre dossier mods. La plupart des mods en dépendent.
Ajouter le fichier JAR
Téléchargez le fichier JAR du mod et placez-le dans le même dossier mods, à côté de l'API Fabric. Ne le décompressez pas, il doit rester au format JAR.
Lancez Minecraft en utilisant le profil Fabric et les mods se chargeront automatiquement au démarrage.
Le dossier des mods
Votre dossier des mods se trouve à :
| Système d'exploitation | Chemin |
|---|---|
| Windows | %appdata%\.minecraft\mods |
| macOS | ~/Library/Application Support/minecraft/mods |
| Linux | ~/.minecraft/mods |
Si le dossier n'existe pas, lancez le profil Fabric une fois et il sera créé pour vous.
Fabric API : pourquoi vous en avez besoin
La plupart des mods Fabric dépendent de l'API Fabric, une bibliothèque partagée qui fournit des utilitaires courants pour les moddeurs. L'installer en premier évite les plantages dus à des bibliothèques manquantes. Même si un mod spécifique prétend ne pas avoir besoin de l'API, l'ajouter ne nuit pas et évite les mauvaises surprises.
Que faire lorsqu'un mod ne se charge pas
- Le mod n'apparaît pas dans la liste des mods : le fichier JAR se trouve dans le mauvais dossier, ou vous avez lancé la version vanilla au lieu de Fabric. Vérifiez le chemin et le profil.
- Crash avec l'erreur "classe manquante" : l'API Fabric est manquante ou d'une version incorrecte. Téléchargez la bonne version de l'API pour votre version de Minecraft.
- Erreur de non-correspondance de version dans les journaux: le chargeur, l’API ou le module cible des versions Minecraft différentes. Les trois doivent correspondre exactement (par exemple, 1.21, et non 1.21.1 si le module cible 1.21).
- Le mod se charge mais plante lors de l'utilisation : il pourrait entrer en conflit avec un autre mod ou un paramètre. Essayez de le lancer avec uniquement ce mod pour isoler le problème.
Correspondance de version
C'est le piège le plus important. Chaque élément doit cibler la même version :
Minecraft version: 1.21
Fabric loader version: 1.21 ✓
Fabric API version: 1.21 ✓
Mod version: 1.21 ✓
All match → no crash
Si votre Minecraft est en version 1.21 mais qu'un mod est ciblé pour la version 1.20.1, il ne se chargera pas. Vérifiez la page de téléchargement du mod pour connaître la version exacte qu'il prend en charge.
Exécution de plusieurs mods
Une fois qu'un mod fonctionne, l'ajout d'autres est simple :
- Téléchargez chaque fichier JAR du mod
- Déposez-les tous dans le dossier mods
- Lancez Fabric
- Tous les mods se chargent ensemble (en supposant qu'il n'y ait pas de conflits)
Certains mods sont incompatibles entre eux. Si des plantages surviennent après l'ajout d'un nouveau mod, désactivez-le pour confirmer qu'il est à l'origine du problème, puis vérifiez si l'auteur du mod documente ce conflit.
FAQ
La plupart des mods Fabric en dépendent, il est donc conseillé de l'installer par défaut. Quelques mods autonomes rares n'en ont pas besoin, mais l'ajouter ne pose aucun problème et résout la plupart des plantages liés à des "classes manquantes".
Généralement, il y a un décalage de version. Veuillez vérifier que le Fabric Loader, l'API Fabric et votre mod sont tous conçus pour la même version exacte de Minecraft. Consultez la page de téléchargement du mod pour obtenir des informations sur la version.
Dans le dossier « mods » à l’intérieur de votre répertoire Minecraft (chemins indiqués ci-dessus). Si le dossier n’existe pas, lancez une fois le profil Fabric et il sera créé.
Oui. Déposez chaque fichier JAR dans le dossier "mods" et lancez Fabric. Tant qu'ils sont destinés à votre version de Minecraft et qu'ils ne sont pas conflictuels, le lanceur les exécutera tous.