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.
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.
Zamazane nazwy
Minecraft jest dystrybuowany z zaciemnionym kodem: klasy o nazwach a.a.a, metody o nazwach b, c, d.
Wełna lub mapa Mojmapa te
Każdy zestaw mapowań tłumaczy a.a.a na EntityPlayer, b na ruch, c na atak.
Twój mod używa jednego lub drugiego
Piszesz kod pod Yarn lub Mojmap names, a nie pod zamazane.
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.
| Yarn | Mojmap | |
|---|---|---|
| Kto nadaje nazwy | Społeczność FabricMC | Mojang (oficjalnie) |
| Pierwsza dostępność | Era Fabric | Od wersji 1.14.4 |
| Parametry metod | Nazwane i udokumentowane | Często brakujące |
| Licencjonowanie | Otwarte, można swobodnie udostępniać | Pozwalające na użycie w czasie kompilacji |
| Stabilna warstwa pod spodem | Warstwa pośrednia | Mapa obfuscacji na każdą wersję |
| Najlepsze dopasowanie | Mody Fabric, które chcą dokumentacji | Projekty 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
Obaj pracują nad Fabric. Yarn był domyślnym ekosystemem i oferuje nazwane parametry oraz dokumentację, natomiast Mojmap odpowiada nazwom używanym przez Mojang. Wybierz, którego nazewnictwa i narzędzi preferuje Twój zespół.
Nie. Te zaciemnione nazwy wyglądają jak a.a.a. Mojmap mapuje je na czytelne nazwy, których używa wewnętrznie Mojang, publikowane wraz z każdą wersją.
Tak, w pewnym sensie. Niektóre konfiguracje Fabric bazują na Mojmapie i nakładają remappingi Yarn, więc te dwa rozwiązania współistnieją w jednym środowisku programistycznym, zamiast bezpośrednio konkurować.
Oba uczyniły MCP i Searge przestarzałymi dla nowych projektów od wersji 1.14.4. Starsze projekty z zakresu 1.7 do 1.12 nadal korzystają z nazewnictwa MCP.