Cosa sono le mappe di Minecraft? Nomi spiegati

Le mappature di Minecraft sono tabelle di nomi che traducono il codice offuscato del gioco in nomi leggibili. Mojang distribuisce Minecraft con nomi di classi e campi offuscati come a.a.a, quindi gli sviluppatori di mod e client applicano un set di mappature come MCP, Yarn o le mappature di Mojang per ottenere nomi che possono effettivamente leggere e a cui possono fare riferimento.

Perché esistono le mappe

Mojang offusca Minecraft prima del rilascio. Il file jar distribuito rinomina classi, metodi e campi con stringhe corte e senza significato per ridurre le dimensioni del file e rendere il codice difficile da leggere. È per questo scrambling che non puoi semplicemente aprire il gioco e iniziare a modificarlo.

Una mappa è il dizionario che annulla questa operazione. Abbina ogni nome offuscato a uno leggibile, quindi un campo chiamato field_70181_x diventa motionY. Con una mappa applicata, uno sviluppatore vede un codice sorgente dall'aspetto normale e può scrivere mod su di esso.

C'è un aspetto da considerare. I nomi offuscati cambiano con ogni versione di Minecraft, quindi lo stesso campo può essere a in una versione e bk nella successiva. Le mappe assorbono questo cambiamento, ed è per questo che sono il fulcro di ogni toolchain di modding.

Le tre di cui sentirai parlare

MCP (Mod Coder Pack) è la mappa della comunità che ha reso possibile il modding precedente alla versione 1.14. Utilizzava uno schema a due livelli: il progetto Searge produceva nomi intermedi stabili ma brutti come field_70181_x, e MCP li avvolgeva con nomi amichevoli come motionY. La maggior parte dei client standalone 1.8.9 più datati compilano rispetto a un albero sorgente mappato da MCP e basano la loro reflection sui nomi MCP e Searge.

Yarn è la mappatura open-source mantenuta da FabricMC per l'ecosistema Fabric. È guidata dalla comunità, con licenza libera e si aggiorna rapidamente quando viene rilasciata una nuova versione di Minecraft, il che è in parte il motivo per cui i mod di Fabric raggiungono rapidamente le nuove versioni.

Le mappature di Mojang, spesso chiamate Mojmap, sono la mappatura proprietaria di Mojang, pubblicata insieme a ogni versione ufficiale a partire dalla 1.14.4. Poiché provengono direttamente da Mojang, i nomi corrispondono a quelli che gli sviluppatori utilizzano effettivamente. Hanno sostituito efficacemente MCP e Searge come standard predefinito per qualsiasi client che punta alla 1.21 o versioni successive.

Come si confrontano

Come le mappature si inseriscono in una toolchain di modding

Una mappatura viene applicata in fase di compilazione, non in fase di runtime. Lo strumento di build prende il gioco offuscato, applica la mappatura e ti fornisce una versione leggibile su cui scrivere codice. Il tuo mod completato viene quindi rimappato in modo che corrisponda ai nomi offuscati che il gioco del giocatore utilizza effettivamente.

Diversi loader gestiscono questa cosa in modi differenti. Fabric compila rispetto a Yarn o a una base di mapping di Mojang, a seconda del progetto. Forge storicamente divideva il compito, utilizzando una mappa per il codice sorgente che si legge e un'altra per quello che viene eseguito. La licenza delle mappe di Mojang è sufficientemente permissiva da poterle utilizzare in fase di compilazione, motivo per cui le moderne toolchain si basano su di esse.

FAQ