Learn · frameworks
Qu'est-ce que l'API Fabric ? Le modding expliqué
Fabric API est la bibliothèque partagée dont dépend presque chaque mod Fabric. Voici ce qu'elle fait, pourquoi elle est distincte du chargeur, et si vous en avez besoin.
Qu'est-ce que l'API Fabric ?
L'API Fabric est la boîte à outils commune sur laquelle l'écosystème Fabric s'appuie. Le chargeur lui-même ne sait que démarrer le jeu et appliquer des correctifs ; il ne fournit pratiquement aucune fonctionnalité pratique. L'API comble ce manque avec un ensemble stable d'événements, d'assistants et d'interfaces, afin que les mods individuels ne réinventent pas chacun les mêmes connexions ou ne se gênent pas mutuellement lorsqu'ils le font.
Considérez-la comme la bibliothèque standard que le chargeur omet. Lorsqu'un auteur de mod souhaite réagir à l'arrivée d'un joueur, envoyer un paquet personnalisé ou enregistrer un nouveau bloc, il appelle l'API plutôt que de pirater directement le moteur.
Pourquoi l'API Fabric ne fait-elle pas partie du chargeur ?
Fabric divise délibérément le système en deux parties. Le chargeur est le noyau petit et à évolution lente qui démarre Minecraft et exécute la couche de correctifs. L'API est l'ensemble plus vaste d'interfaces partagées qui s'y superpose et évolue plus rapidement. Les garder séparés permet à chacun d'évoluer à son propre rythme.
| Pièce | Tâche | Fréquence de mise à jour |
|---|---|---|
| Chargeur Fabric | Démarre le jeu, applique les correctifs Mixin, résout les mods | Porté vers une nouvelle version de MC rapidement |
| API Fabric | Événements partagés, réseau, registre, assistants de rendu | Évolue selon son propre calendrier |
Le gain est la rapidité. Lorsqu'une nouvelle version de Minecraft est publiée, un petit loader peut être rendu compatible en quelques heures, tandis que l'API large se met à jour sans bloquer ce premier port. Les assembler et l'ensemble de la pile ne bougerait alors qu'à la vitesse de sa partie la plus lente.
Que fournit réellement l'API Fabric ?
L'API offre aux mods un moyen stable en termes de version pour faire les choses dont la plupart des mods ont besoin. Au lieu que chaque auteur écrive des points d'accroche fragiles contre les entrailles brutes du jeu, ils ciblent une surface partagée que la communauté entretient ensemble.
Cycle de vie et événements de jeu
Des rappels propres pour les ticks, le chargement du monde, l'arrivée des joueurs et les interactions avec les blocs, afin que les mods puissent réagir au jeu sans avoir à le patcher manuellement.
Aides au réseautage
Une manière saine de définir et d'envoyer des paquets personnalisés entre le client et le serveur, la pierre angulaire de la plupart des mods dotés d'une conscience multijoueur.
Aides au contenu et au registre
Plomberie partagée pour l'enregistrement de nouveaux éléments, blocs et entités, permettant à deux mods d'ajouter du contenu sans conflit.
Rendu et outils d'assistance aux ressources
Les mods de rendu, d'outils de ressources et de manipulation de modèles et de textures s'appuient généralement sur des éléments d'accroche communs.
Retirez l'API et chaque mod devrait distribuer sa propre copie de cette infrastructure. Ils dupliqueraient les efforts et divergeraient, puis se casseraient dès que vous les combineriez dans un même dossier. La bibliothèque partagée est ce qui permet à un ensemble de mods sans rapport de fonctionner harmonieusement.
Avez-vous besoin de l'API Fabric ?
Presque toujours, oui. La grande majorité des mods Fabric la déclarent comme dépendance obligatoire, ce qui signifie qu'ils ne se chargeront pas sans elle. Vous l'installez une fois comme un mod jar ordinaire dans votre dossier mods, et chaque mod qui en a besoin puise à partir de cette même copie.
- Exécutez-vous Fabric avec plus d'un ou deux mods ? Installez l'API.
- La page d'un mod indique "Fabric API" dans les prérequis ? Installez-la.
- Faire tourner un mod minuscule et autonome qui indique explicitement qu'il ne nécessite rien ? Vous pouvez omettre l'API, bien qu'il soit rarement mauvais de la conserver.
La version courte : considérez l'API Fabric comme une base de référence. Le coût de son utilisation quand vous n'en avez pas strictement besoin est un bocal supplémentaire. Le coût de son absence est un plantage.
Où trouver l'API Fabric et comment faire correspondre les versions
Téléchargez l'API à partir des canaux officiels de Fabric ou des hébergeurs de mods populaires, et choisissez la version marquée pour votre version exacte de Minecraft. La correspondance des versions est l'erreur la plus fréquente, et elle provoque les plantages les plus bruyants et les plus déroutants.
Confirmez votre version de Minecraft
Notez la version exacte de votre profil au lancement, y compris le numéro de patch.
Téléchargez la version API correspondante
Prenez la version de l'API Fabric étiquetée pour cette même version, pas la plus récente disponible.
Déposez-le dans le dossier mods
Placez le fichier JAR à côté de vos autres modules. Une seule copie suffit pour tous les modules qui en dépendent.
Lancez et consultez le journal si cela échoue
Si quelque chose plante, le journal indique généralement la classe manquante ou la version attendue. Cette ligne pointe directement vers la correction.
Si jongler manuellement avec les versions des chargeurs, des API et des mods vous semble fastidieux, c'est parce que c'est le cas. Les lanceurs gérés et les clients utilitaires existent en partie pour résoudre cette chaîne de dépendances à votre place, afin que le jeu se lance simplement.
FAQ
Pas chacun, mais la plupart. Tout mod qui le déclare comme dépendance refuse de se charger sans lui. Une poignée de petits mods autonomes l'ignorent, mais l'installer est la solution par défaut, car dès que vous ajoutez un deuxième mod, vous en aurez probablement besoin.
Des canaux de distribution officiels de Fabric et des hébergeurs de mods populaires. La seule règle qui compte : téléchargez la version correspondant exactement à votre version de Minecraft. Un fichier .jar 1.21 ne sauvera pas un jeu 1.20.
Par conception. Le chargeur est intentionnellement maintenu petit afin de pouvoir être rapidement porté vers une nouvelle version de Minecraft, tandis que l'API plus vaste évolue à son propre rythme. Les séparer empêche la partie qui évolue rapidement de freiner celle qui doit être mise à jour en premier.
On obtient généralement un crash au lancement, souvent une erreur de classe ou de méthode manquante dans le log. La solution est presque toujours de supprimer le fichier jar incorrect et de remplacer par la version de l'API correspondant à votre version de Minecraft.
Chargeur, API et mods réglés pour vous, sans les tracas de compatibilité des versions.