Yarn contre Mojmap : Comparaison des cartes Minecraft (2026)

Yarn vs Mojmap : Quelle est la différence ?

Yarn est un système de nommage communautaire, open source, pour Fabric, qui inclut des noms descriptifs et tous les paramètres de méthode. Mojmap est le propre système de nommage officiel de Mojang, publié avec chaque version depuis la 1.14.4. Choisissez Yarn si vous souhaitez un système de nommage gratuit, bien documenté, avec des noms de paramètres et de la javadoc. Choisissez Mojmap si vous souhaitez des noms qui correspondent à ceux de Mojang et ne dérivent jamais.

Le choix ne consiste pas à déterminer lequel est le bon—les deux sont corrects. Il s'agit de savoir quelle convention de nommage votre projet doit suivre et dans quel écosystème vous construisez.

Ce qu'est chacun

Yarn est un ensemble de mapping maintenu par FabricMC. Des bénévoles attribuent des noms lisibles aux classes, champs et méthodes obscurcis de Minecraft, et ces noms reposent sur la couche Intermédiaire stable, afin qu'ils puissent être renommés sans casser les mods compilés.

Mojmap est le tableau de mapping officiel que Mojang publie avec chaque version à partir de la 1.14.4. Les noms proviennent directement du code source de Mojang, ils correspondent donc à ce que les développeurs appellent les choses en interne. Il a remplacé MCP et Searge comme standard pour tout nouveau projet ciblant les versions modernes.

1. Noms obscurcis

   Minecraft est livré avec du code obscurci : les classes sont nommées a.a.a, et les méthodes b, c et d.

2. Laine ou carte Mojmap, celles-ci

   Chaque ensemble de correspondance traduit a.a.a en EntityPlayer, b en move, c en attaque.

3. Votre mod utilise l'un ou l'autre

   Vous codez contre les noms de Yarn ou Mojmap, pas les noms obscurcis.

4. Couche stable en dessous

   L'intermédiaire (pour Yarn) ou la carte d'obscurcissement (pour Mojmap) maintient la compatibilité des mods compilés malgré les renommages.

Comment ils diffèrent

La divergence se résume à savoir qui choisit les noms et à la manière dont la licence les traite. Les noms de Yarn sont choisis par la communauté et sont libres d'utilisation et de partage. Les noms de Mojmap appartiennent à Mojang, et la licence a historiquement été généreuse quant à leur utilisation lors de la compilation, mais plus prudente quant à leur redistribution. Les chargeurs modernes s'en occupent pour vous.

Yarn excelle lorsque vous souhaitez comprendre ce qu'une méthode fait sans lire de code décompilé. Les paramètres de méthode sont nommés (entité, vélocité, dégâts) et sont souvent accompagnés de javadoc. Mojmap excelle lorsque vous faites des références croisées à la source de Mojang ou que vous travaillez avec des développeurs familiarisés avec les noms officiels.

Lequel choisir

Choisissez Yarn si vous construisez sur Fabric et que vous souhaitez des noms descriptifs, des paramètres de méthode nommés et une documentation intégrée. C'est le choix par défaut de longue date pour l'écosystème Fabric, et la plupart des mods tiers le ciblent.

Choisissez Mojmap si vous souhaitez des noms qui correspondent à la source officielle de Mojang, si vous prévoyez de partager du code avec des personnes utilisant d'autres chargeurs, ou si vous ciblez la version 1.21 ou ultérieure, où les mappings officiels sont la base commune. Si vous apprenez à partir de la source décompilée de Mojang ou si vous travaillez avec plusieurs types de chargeurs, Mojmap vous permet de rester aligné.

De nombreux projets Fabric construisent désormais sur une base Mojmap et appliquent des remappings Yarn par-dessus, vous n'êtes donc pas obligé de choisir l'un ou l'autre. Vos outils de construction peuvent les superposer.

Comment ils se connectent aux autres mappings

Ils s'inscrivent tous deux dans une histoire plus longue. Avant que Mojang ne publie des mappings, la scène modding utilisait MCP et Searge pour inverser les noms obscurcis. À partir de la version 1.14.4, Mojmap a rendu les noms officiels disponibles, et Yarn s'est développé comme l'alternative Fabric ouverte, superposée à Intermediary. C'est la couche Intermediary qui permet de maintenir la compatibilité des mods malgré les changements de noms des mappings.

Yarn et Mojmap en pratique

Si vous commencez un nouveau mod Fabric et n'avez pas de raison particulière de préférer Mojmap, Yarn est le choix par défaut le plus sûr. L'écosystème s'y base, la documentation le cible, et les noms maintenus par la communauté incluent souvent des descriptions utiles.

Si vous maintenez une bibliothèque dont d'autres chargeurs dépendent, ou si vous partagez du code avec des moddeurs Forge (qui préfèrent souvent Mojmap), Mojmap est un choix judicieux. Les noms officiels constituent un terrain d'entente.

Si vous n'êtes pas sûr, utilisez Yarn. Vous pourrez toujours passer à l'autre plus tard, et les outils de migration existent. Le mapping en lui-même n'est qu'un détail ; l'important est d'écrire un bon mod.

FAQ