Yarn vs Mojmap: Comparativo de Mapeamentos para Minecraft (2026)

Yarn vs Mojmap: Qual a Diferença?

Yarn é um mapeamento com nomes definidos pela comunidade, de código aberto, para Fabric, que inclui nomes descritivos e parâmetros de método completos. Mojmap é a própria nomenclatura oficial da Mojang, publicada com cada lançamento desde a versão 1.14.4. Escolha Yarn se você quiser um esquema de nomenclatura gratuito, bem documentado, com nomes de parâmetros e javadoc. Escolha Mojmap se você quiser nomes que correspondam aos da Mojang e nunca se desviem.

A escolha não é sobre qual é o certo — ambos estão corretos. É sobre qual convenção de nomenclatura seu projeto deve seguir e qual ecossistema você está construindo.

O que cada um é

Yarn é um conjunto de mapeamento mantido pela FabricMC. Voluntários atribuem nomes legíveis às classes, campos e métodos ofuscados no Minecraft, e esses nomes ficam sobre a camada estável Intermediary, para que possam ser renomeados sem quebrar os mods compilados.

Mojmap é a tabela de mapeamento oficial que a Mojang publica junto com cada lançamento a partir da versão 1.14.4. Os nomes vêm diretamente do código-fonte da Mojang, então correspondem ao que os desenvolvedores chamam as coisas internamente. Substituiu o MCP e o Searge como padrão para qualquer novo projeto que visa versões modernas.

1. Nomes ofuscados

   Minecraft é distribuído com código ofuscado: classes nomeadas a.a.a, métodos nomeados b, c e d.

2. Lã ou mapa do Mojmap, aqueles

   Cada conjunto de mapeamento traduz a.a.a para EntityPlayer, b para mover, c para atacar.

3. O seu mod usa um ou outro

   Você escreve código contra os nomes do Yarn ou do Mojmap, não os ofuscados.

4. Camada estável abaixo

   Um intermediário (para Yarn) ou o mapa de ofuscação (para Mojmap) mantém os mods compilados compatíveis através de renomeações.

Como eles diferem

A divergência se resume a quem escolhe os nomes e como a licença os trata. Os nomes do Yarn são escolhidos pela comunidade e são livres para usar e compartilhar. Os nomes do Mojmap são da Mojang, e a licença historicamente tem sido generosa em relação ao uso em tempo de compilação, mas mais cuidadosa em relação à redistribuição. Os carregadores modernos cuidam disso por você.

O Yarn se destaca quando você quer entender o que um método faz sem ler código descompilado. Os parâmetros do método são nomeados (entidade, velocidade, dano) e frequentemente carregam javadoc. O Mojmap se destaca quando você está fazendo referência cruzada ao código-fonte da própria Mojang ou trabalhando com desenvolvedores familiarizados com os nomes oficiais.

Qual escolher

Escolha Yarn se você constrói sobre o Fabric e quer nomes descritivos, parâmetros de método nomeados e documentação inline. É o padrão de longa data para o ecossistema Fabric, e a maioria dos mods de terceiros o visam.

Escolha o Mojmap se você deseja nomes que correspondam à fonte própria da Mojang, planeja compartilhar código com pessoas em outros loaders ou está mirando na versão 1.21 ou posterior, onde os mappings oficiais são a base comum. Se você está aprendendo a partir da fonte descompilada da própria Mojang ou trabalhando com múltiplos tipos de loader, o Mojmap mantém você alinhado.

Muitos projetos Fabric agora constroem com base no Mojmap e aplicam remapeamentos Yarn por cima, então você nem sempre precisa escolher apenas um. Suas ferramentas de build podem sobrepor-los.

Como eles se conectam a outros mappings

Ambos fazem parte de um histórico mais longo. Antes da Mojang publicar os mappings, a cena de modding usava MCP e Searge para reverter os nomes ofuscados. A partir da versão 1.14.4, o Mojmap tornou os nomes oficiais disponíveis, e o Yarn cresceu como a alternativa Fabric aberta, sobreposta ao Intermediary. A camada Intermediary é o que mantém os mods compatíveis através de renomes de mapping.

Yarn e Mojmap na prática

Se você está começando um novo mod Fabric e não tem um motivo para preferir o Mojmap, o Yarn é o padrão seguro. O ecossistema padrão utiliza-o, a documentação o direciona e os nomes mantidos pela comunidade frequentemente incluem descrições úteis.

Se você está mantendo uma biblioteca que outros loaders dependem, ou se está compartilhando código com modders Forge (que frequentemente preferem o Mojmap), o Mojmap faz sentido. Os nomes oficiais são um terreno comum.

Se você não tem certeza, use o Yarn. Você sempre pode mudar depois, e as ferramentas para migrar existem. O mapeamento em si é um detalhe; a parte importante é escrever um bom mod.

Perguntas frequentes