Learn · concepts

Przędza vs Mojmap: Porównanie Map w Minecraft (2026)

Wyjaśnienie Yarn vs Mojmap: jak różnią się te dwa zestawy map do Minecrafta pod względem nazywania, licencji i narzędzi, oraz który z nich wybrać do moda Fabric.

TRtrolPublished 5 min read

Yarn vs Mojmap: Na czym polega różnica?

Yarn to nazewnictwo tworzone przez społeczność, open-source’owe mapowanie dla Fabric, które zawiera opisowe nazwy i pełne parametry metod. Mojmap to oficjalne, własne nazewnictwo firmy Mojang, publikowane wraz z każdą wersją od 1.14.4. Wybierz Yarn, jeśli chcesz darmowego, dobrze udokumentowanego schematu nazewnictwa z nazwami parametrów i javadoc. Wybierz Mojmap, jeśli chcesz nazw, które odpowiadają tym używanym przez Mojang i nigdy się nie zmieniają.

Wybór nie dotyczy tego, które z nich jest lepsze – oba są poprawne. Chodzi o to, jakiej konwencji nazewnictwa powinien przestrzegać Twój projekt i w jakim ekosystemie go budujesz.

Co przedstawia każdy z nich

Yarn to zestaw mapowań utrzymywany przez FabricMC. Wolontariusze przypisują czytelne nazwy do zaciemnionych klas, pól i metod w Minecraft, a te nazwy nakładają się na stabilną warstwę Intermediary, dzięki czemu można je zmieniać bez łamania skompilowanych modów.

Mojmap to oficjalna tabela mapowań publikowana przez Mojang wraz z każdą wersją od 1.14.4. Nazwy pochodzą bezpośrednio z kodu źródłowego Mojang, więc odpowiadają temu, jak programiści nazywają rzeczy wewnętrznie. Zastąpił MCP i Searge jako domyślny standard dla nowych projektów skierowanych do nowoczesnych wersji.

  1. Zamazane nazwy

    Minecraft jest dystrybuowany z zaciemnionym kodem: klasy o nazwach a.a.a, metody o nazwach b, c, d.

  2. Wełna lub mapa Mojmapa te

    Każdy zestaw mapowań tłumaczy a.a.a na EntityPlayer, b na ruch, c na atak.

  3. Twój mod używa jednego lub drugiego

    Piszesz kod pod Yarn lub Mojmap names, a nie pod zamazane.

  4. Stabilna warstwa pod spodem

    Pośrednik (dla Yarn) lub mapa zaciemnień (dla Mojmap) utrzymuje kompatybilność skompilowanych modów pomimo zmian nazw.

Jak się różnią

Podział sprowadza się do tego, kto wybiera nazwy i jak licencja je traktuje. Nazwy Yarn są wybierane przez społeczność i można ich swobodnie używać i udostępniać. Nazwy Mojmap należą do Mojang, a licencja historycznie była hojna w kwestii użycia w czasie kompilacji, ale bardziej ostrożna w kwestii dystrybucji. Nowoczesne loadery zajmują się tym za Ciebie.

YarnMojmap
Kto nadaje nazwySpołeczność FabricMCMojang (oficjalnie)
Pierwsza dostępnośćEra FabricOd wersji 1.14.4
Parametry metodNazwane i udokumentowaneCzęsto brakujące
LicencjonowanieOtwarte, można swobodnie udostępniaćPozwalające na użycie w czasie kompilacji
Stabilna warstwa pod spodemWarstwa pośredniaMapa obfuscacji na każdą wersję
Najlepsze dopasowanieMody Fabric, które chcą dokumentacjiProjekty dopasowane do kodu źródłowego Mojang

Yarn sprawdza się, gdy chcesz zrozumieć, co robi metoda, bez konieczności czytania kodu dekompilowanego. Parametry metod są nazwane (entity, velocity, damage) i często zawierają javadoc. Mojmap sprawdza się, gdy krzyżowo odwołujesz się do własnego kodu źródłowego Mojang lub pracujesz z programistami zaznajomionymi z oficjalnymi nazwami.

Który wybrać

Wybierz Yarn, jeśli budujesz na Fabric i chcesz opisowe nazwy, nazwane parametry metod i dokumentację inline. Jest to standardowy wybór od dawna dla ekosystemu Fabric, a większość modów firm trzecich jest do niego skierowana.

Wybierz Mojmap, jeśli chcesz nazw, które odpowiadają źródłom Mojang, planujesz udostępniać kod osobom korzystającym z innych loaderów lub celujesz w wersję 1.21 lub nowszą, gdzie oficjalne mapowania stanowią powszechny punkt odniesienia. Jeśli uczysz się na podstawie własnego zdekompilowanego kodu źródłowego Mojang lub pracujesz z wieloma typami loaderów, Mojmap zapewnia Ci spójność.

Wiele projektów Fabric teraz buduje w oparciu o bazę Mojmap i nakłada Yarn remappings na wierzch, więc nie musisz zawsze wybierać tylko jednego. Twoje narzędzia do budowania mogą je warstwić.

Jak łączą się z innymi mapowaniami

Oba znajdują się w dłuższej historii. Zanim Mojang opublikował mapowania, scena moddingowa używała MCP i Searge do odwrócenia zasłoniętych nazw. Od wersji 1.14.4, Mojmap udostępnił oficjalne nazewnictwo, a Yarn rozwijał się jako otwarta alternatywa Fabric, warstwą nad Intermediary. To warstwa Intermediary zapewnia kompatybilność modów pomimo zmian nazw mapowań.

Yarn i Mojmap w praktyce

Jeśli zaczynasz nowy mod Fabric i nie masz powodu preferować Mojmap, Yarn jest bezpiecznym wyborem domyślnym. Ekosystem domyślnie go obsługuje, dokumentacja jest do niego skierowana, a społecznościowo utrzymywane nazwy często zawierają pomocne opisy.

Jeśli utrzymujesz bibliotekę, od której zależą inne loadery, lub jeśli dzielisz się kodem z twórcami modów Forge (którzy często preferują Mojmap), użycie Mojmap ma sens. Oficjalne nazwy stanowią wspólny grunt.

Jeśli nie jesteś pewien, użyj Yarn. Zawsze możesz przełączyć się później, a narzędzia do migracji istnieją. Sama mapa jest szczegółem; ważna jest pisanie dobrego moda.

FAQ