Jakie są mapy w Minecraft? Wyjaśnione nazwy

Minecraft: wyjaśnienie mapowań: jak MCP, Yarn i Mojmap przekształcają zaciemnione nazwy klas w czytelny kod, aby mody i klienty mogły podłączać się do gry.

Mappingsby trqUpdated June 4, 2026
Key takeaways
  • Mapowania to tabele nazw, które tłumaczą zaciemniony kod Minecrafta na czytelne nazwy.
  • Mojang zaciemnia nazwy klas, pól i metod, a te zmieniają się z każdą wersją.
  • Trzy, o których usłyszysz, to MCP, Yarn i mapowania Mojang (Mojmap).
  • Mapowanie jest stosowane w czasie kompilacji, a nie w czasie działania, więc nigdy nie trafia do graczy.

Mapowania Minecrafta to tabele nazw, które tłumaczą zaszyfrowany kod gry na czytelne nazwy. Mojang dostarcza Minecrafta z pomieszanymi nazwami klas i pól, takimi jak a.a.a, dlatego twórcy modów i klientów stosują zestaw mapowań, taki jak MCP, Yarn lub mapowania Mojang, aby uzyskać nazwy, które mogą faktycznie czytać i do których mogą się podłączać.

Gdzie mieści się Opal

Opal to mod Fabric, więc pod spodem korzysta z nowoczesnych mapowań i udostępnia czysty interfejs skryptowy GraalVM JavaScript. Piszesz skrypty, używając czytelnych nazw, nie ingerując bezpośrednio w mapowania. Zobacz przewodnik po skryptach.

Dlaczego istnieją mapowania

Mojang zaciemnia Minecrafta przed wydaniem. Dostarczany plik jar zmienia nazwy klas, metod i pól na krótkie, pozbawione znaczenia ciągi znaków, aby zmniejszyć rozmiar pliku i utrudnić czytanie kodu. To zaciemnianie uniemożliwia po prostu otwarcie gry i rozpoczęcie jej edycji.

Mapowanie to słownik, który odwraca ten proces. Łączy każdą zaciemnioną nazwę z czytelną dla człowieka, dzięki czemu pole o nazwie field_70181_x staje się motionY. Dzięki zastosowanemu mapowaniu programista widzi kod o normalnym wyglądzie i może tworzyć mody.

Istnieje jednak pewien haczyk. Zaciemnione nazwy zmieniają się w każdej wersji Minecrafta, więc to samo pole może być a w jednej wersji, a bk w następnej. Mapowania absorbują te zmiany, dlatego są podstawą każdego łańcucha narzędzi modowania.

Trzy, o których będziesz słyszał

MCP (Mod Coder Pack) to mapowanie tworzone przez społeczność, które umożliwiło modowanie przed wersją 1.14. Używał dwuwarstwowego schematu: projekt Searge generował stabilne, ale brzydkie nazwy pośrednie, takie jak field_70181_x, a MCP otaczał je przyjaznymi nazwami, takimi jak motionY. Większość starszych, samodzielnych klientów 1.8.9 kompiluje się z drzewa źródłowego zmapowanego przez MCP i opiera swoje odbicie na nazwach MCP i Searge.

Praca z Yarn to otwarte, rozwijane przez FabricMC mapowanie, utrzymywane dla ekosystemu Fabric. Jest to projekt napędzany przez społeczność, objęty swobodną licencją i szybko aktualizowany po każdej nowej wersji Minecrafta, co jest jedną z przyczyn, dla której mody Fabric szybko docierają do nowych wersji.

Mapowania Mojang, często nazywane Mojmap, to własne mapowania firmy Mojang, publikowane wraz z każdą oficjalną wersją od 1.14.4. Ponieważ pochodzą bezpośrednio od Mojang, nazwy odpowiadają temu, jak rzeczy nazywają twórcy. Skutecznie zastąpiły MCP i Searge jako domyślne mapowanie dla każdego nowego klienta celującego w 1.21 lub nowszą.

Jak się porównują

MCPYarnMapowania Mojang
Utrzymywane przezSpołeczność (Searge + MCP)FabricMCMojang
EraPrzed 1.14 (1.7-1.12)1.14+1.14.4+
ŹródłoPochodzące ze społecznościPochodzące ze społecznościOficjalne
Używane zStarsze klienty, stare modowanieFabricFabric, Forge
StatusWycofane na rzecz mapowań MojangAktywneAktywne domyślnie

Jak mapowania wpisują się w łańcuch narzędzi modowania

Mapowanie jest stosowane w czasie kompilacji, a nie w czasie działania. Narzędzie budowania pobiera zamazaną wersję gry, uruchamia na niej mapowanie i przekazuje Ci czytelną wersję do pisania kodu. Twój gotowy mod jest następnie ponownie mapowany, aby odpowiadał zamazanym nazwom, których faktycznie używa gra gracza.

Różne loadery radzą sobie z tym na różne sposoby. Fabric kompiluje się z Yarn lub bazą mapowania Mojang, w zależności od projektu. Forge historycznie dzielił to zadanie, używając jednej mapy do kodu źródłowego, a innej do tego, co jest uruchamiane. Licencja na mapowania Mojang jest na tyle liberalna, że można z nich korzystać w czasie kompilacji, dlatego nowoczesne łańcuchy narzędzi sięgają po nie.

FAQ