Yarn contro Mojmap: Confronto tra le Mappe di Minecraft (2026)

Yarn vs Mojmap: Qual è la Differenza?

Yarn è una mappatura denominata dalla comunità, open-source per Fabric, che include nomi descrittivi e parametri di metodo completi. Mojmap è la propria denominazione ufficiale di Mojang, pubblicata con ogni versione a partire dalla 1.14.4. Scegli Yarn se desideri uno schema di denominazione gratuito, ben documentato, con nomi di parametri e javadoc. Scegli Mojmap se desideri nomi che corrispondano a quelli di Mojang e non si discostino mai.

La scelta non riguarda quale sia giusto: entrambi sono corretti. Riguarda quale convenzione di denominazione il tuo progetto dovrebbe seguire e quale ecosistema stai costruendo.

Cosa è ciascuno

Yarn è un set di mappature mantenuto da FabricMC. Volontari assegnano nomi leggibili alle classi, ai campi e ai metodi offuscati in Minecraft, e questi nomi si basano sullo stabile livello Intermediary, in modo da poter essere rinominati senza interrompere i mod compilati.

Mojmap è la tabella di mappature ufficiale che Mojang pubblica insieme a ogni versione a partire dalla 1.14.4. I nomi provengono direttamente dal codice sorgente di Mojang, quindi corrispondono a come gli sviluppatori chiamano le cose internamente. Ha sostituito MCP e Searge come predefinito per qualsiasi nuovo progetto che mira a versioni moderne.

1. Nomi oscurati

   Minecraft viene distribuito con codice offuscato: le classi sono denominate a.a.a, i metodi b, c, d.

2. Quella mappa di Yarn o Mojmap

   Ogni set di mappatura traduce a.a.a in EntityPlayer, b in move, c in attacco.

3. Il tuo mod usa l'uno o l'altro

   Scrivi codice basandoti sui nomi di Yarn o Mojmap, non su quelli offuscati.

4. Strato stabile sottostante

   L'intermediario (per Yarn) o la mappa di offuscamento (per Mojmap) mantengono compatibili le mod compilate anche in caso di ridenominazione.

Come Differiscono

La differenza risiede in chi sceglie i nomi e in come la licenza li tratta. I nomi di Yarn sono scelti dalla comunità e sono liberi di essere utilizzati e condivisi. I nomi di Mojmap appartengono a Mojang, e la licenza è storicamente stata generosa riguardo all'uso a tempo di compilazione, ma più cauta riguardo alla ridistribuzione. I moderni loader si occupano di questo per te.

Yarn eccelle quando si desidera capire cosa fa un metodo senza leggere il codice decompilato. I parametri del metodo sono nominati (entità, velocità, danno) e spesso includono javadoc. Mojmap eccelle quando si fa cross-referencing con il codice sorgente di Mojang o si lavora con sviluppatori che conoscono i nomi ufficiali.

Quale Scegliere

Scegli Yarn se costruisci su Fabric e desideri nomi descrittivi, parametri di metodo nominati e documentazione inline. È l'impostazione predefinita di lunga data per l'ecosistema Fabric, e la maggior parte dei mod di terze parti lo prendono di mira.

Scegli Mojmap se desideri nomi che corrispondano a quelli presenti nel codice sorgente di Mojang, prevedi di condividere codice con persone che utilizzano altri loader, o se ti stai orientando verso la versione 1.21 o successive, dove le mappings ufficiali sono la base comune. Se stai imparando dal codice sorgente decompilato di Mojang o lavori con più tipi di loader, Mojmap ti mantiene allineato.

Molti progetti Fabric ora compilano utilizzando una base Mojmap e applicano le rimappature Yarn sopra, quindi non è sempre necessario sceglierne solo uno. I tuoi strumenti di build possono sovrapporli.

Come si collegano alle altre mappings

Entrambi si inseriscono in una storia più lunga. Prima che Mojang pubblicasse le mappings, la scena del modding utilizzava MCP e Searge per invertire i nomi offuscati. A partire dalla versione 1.14.4, Mojmap ha reso disponibili i nomi ufficiali, e Yarn si è sviluppato come alternativa Fabric aperta, sovrapposta a Intermediary. Lo strato Intermediary è ciò che mantiene compatibili i mod attraverso le modifiche ai nomi delle mappings.

Yarn e Mojmap in pratica

Se stai iniziando un nuovo mod Fabric e non hai una ragione specifica per preferire Mojmap, Yarn è l'opzione predefinita più sicura. L'ecosistema si basa su di essa, la documentazione la prende di mira e i nomi mantenuti dalla comunità spesso includono descrizioni utili.

Se stai mantenendo una libreria su cui dipendono altri loader, o se stai condividendo codice con modder Forge (che spesso preferiscono Mojmap), Mojmap ha senso. I nomi ufficiali sono un punto d'incontro.

Se non sei sicuro, usa Yarn. Puoi sempre passare ad un'altra soluzione in seguito, e gli strumenti per la migrazione esistono. La mappatura in sé è un dettaglio; la parte importante è scrivere un buon mod.

FAQ