Learn · frameworks
Czym jest API Fabric? Wyjaśnienie modyfikacji
Fabric API to współdzielona biblioteka, od której zależę niemal wszystkie mody Fabric. Oto co ona robi, dlaczego funkcjonuje oddzielnie od ładowarki i czy jest Ci potrzebna.
Czym jest Fabric API?
Fabric API to wspólny zestaw narzędzi, na którym opiera się ekosystem Fabric. Sam ładowacz zna tylko sposób na uruchomienie gry i zastosowanie poprawek; dostarcza bardzo niewiele funkcji ułatwiających pracę. API wypełnia tę lukę stabilnym zestawem zdarzeń, pomocników i interfejsów, dzięki czemu poszczególne mody nie muszą każdorazowo wymyślać tych samych połączeń lub ze sobą kolidować, gdy już to robią.
Wyobraź sobie to jako bibliotekę standardową, której brakuje ładowaczowi. Kiedy autor moda chce zareagować na dołączenie gracza, wysłać niestandardowy pakiet lub zarejestrować nowy blok, korzysta z API zamiast bezpośrednio ingerować w silnik.
Dlaczego Fabric API nie jest częścią ładowacza?
Fabric celowo dzieli system na dwie części. Ładowacz to małe, wolno zmieniające się jądro, które uruchamia Minecraft i obsługuje warstwę poprawek. API to większy, szybciej rozwijający się zestaw współdzielonych interfejsów, które są nałożone na to. Oddzielenie ich pozwala każdej z nich rozwijać się we własnym tempie.
| Część | Zadanie | Częstotliwość aktualizacji |
|---|---|---|
| Ładowacz Fabric | Uruchamia grę, stosuje poprawki Mixin, rozwiązuje mody | Szybko przenoszony na nową wersję MC |
| API Fabric | Współdzielone zdarzenia, sieci, rejestr, pomocnicy renderowania | Rozwija się według własnego harmonogramu |
Zyskujesz szybkość. Kiedy pojawia się nowa wersja Minecrafta, mały loader może zostać dostosowany w ciągu kilku godzin, a rozbudowany API nadąża bez blokowania pierwszego portu. Połącz je ze sobą, a cały stos poruszałby się tylko z prędkością jego najwolniejszej części.
Co właściwie oferuje API Fabric?
API udostępnia modom stabilny sposób działania, który jest potrzebny niemal każdemu modowi. Zamiast tego, by każdy autor pisał kruche połączenia z surowymi wnętrznościami gry, celują w jedną wspólną powierzchnię, którą społeczność utrzymuje wspólnie.
Cykl życia i wydarzenia rozgrywki
Czyste callbacki dla tyknięć, ładowania świata, dołączenia gracza i interakcji z blokami, aby mody mogły reagować na grę bez ręcznego łatania.
Pomocnicy w budowaniu sieci kontaktów
Rozsądny sposób definiowania i wysyłania niestandardowych pakietów między klientem a serwerem, kręgosłup większości modyfikacji uwzględniających rozgrywkę wieloosobową.
Pomocnicy zawartości i rejestru
Wspólne rurociągi do rejestrowania nowych przedmiotów, bloków i bytów, aby dwa mody mogły dodawać zawartość bez konfliktów.
Renderowanie i narzędzia pomocnicze zasobów
Popularne mody dotyczące haków renderowania i narzędzi zasobów opierają się na nich w przypadku pracy z HUD-em, modelami i teksturami.
Pozbądź się API, a każdy mod musiałby dołączać własną kopię tego mechanizmu. Powieliliby wysiłki i zaczęłyby się rozjeżdżać, a następnie psułyby się nawzajem w momencie połączenia ich w jednej teczce. Wspólna biblioteka to to, co sprawia, że sterta niezwiązanych modów współpracuje.
Czy potrzebujesz Fabric API?
Prawie zawsze, tak. Ogromna większość modów Fabric deklaruje je jako twarde zależności, co oznacza, że nie załadują się bez niego. Instalujesz je raz jako zwykły plik JAR w folderze mods, a każdy mod, który go potrzebuje, pobiera z tej samej kopii.
- Uruchamiasz Fabric z więcej niż jednym lub dwoma modami? Zainstaluj API.
- Strona moda wymienia "Fabric API" w wymaganiach? Zainstaluj go.
- Uruchamianie pojedynczego, malutkiego, samodzielnego moda, który wyraźnie wskazuje, że niczego nie potrzebuje? Możesz pominąć API, choć rzadko to zaszkodzi.
Krótka wersja: traktuj Fabric API jako punkt odniesienia. Koszt posiadania go, gdy go nie potrzebujesz, to dodatkowy plik JAR. Koszt jego braku to awaria.
Skąd pobrać Fabric API i jak dopasować wersje
Pobierz API z oficjalnych kanałów Fabric lub popularnych hostów modyfikacji i wybierz wersję oznaczona dla dokładnie Twojej wersji Minecrafta. Dopasowywanie wersji to najczęstszy błąd, który powoduje najgłośniejsze i najbardziej mylące awarie.
Potwierdź swoją wersję Minecrafta
Zwróć uwagę na dokładną wersję, z której uruchamiasz profil, aż po numer łatki.
Pobierz odpowiednią wersję API
Pobierz wersję Fabric API oznaczoną dla tej samej wersji, a nie najnowszą dostępną.
Wrzuć to do folderu z modami
Umieść plik JAR obok pozostałych modów. Jedna kopia wystarczy dla każdego moda, który na niej polega.
Uruchom i przeczytaj log, jeśli wystąpi błąd
Jeśli coś się zawiesi, dziennik zazwyczaj podaje brakującą klasę lub wersję, której się spodziewał. Ten wiersz wskazuje bezpośrednio na poprawkę.
Jeśli ręczne zarządzanie wersjami loadera, API i modów brzmi żmudne, to dlatego, że tak jest. Zarządzane launchery i programy klienckie istnieją częściowo po to, by rozwiązać ten łańcuch zależności za Ciebie, dzięki czemu gra po prostu się uruchamia.
FAQ
Nie każdy, ale większość. Każdy mod, który deklaruje je jako zależność, nie załaduje się bez niego. Kilka małych, samodzielnych modyfikacji go pomija, ale instalowanie go jest bezpiecznym domyślnym ustawieniem, ponieważ dodanie drugiego moda prawdopodobnie będzie go wymagało.
Z oficjalnych kanałów dystrybucji Fabric oraz popularnych hostów modyfikacji. Jedyna zasada, która się liczy: pobierz wersję, która podaje dokładną wersję Twojej gry Minecraft. Plik .jar dla 1.21 nie uratuje gry w wersji 1.20.
Z założenia. Ładowarka jest celowo utrzymywana w małych rozmiarach, aby można było szybko przenieść ją na nową wersję Minecrafta, podczas gdy większy interfejs API rozwija się we własnym tempie. Rozdzielenie ich zapobiega hamowaniu części, która musi zostać zaktualizowana jako pierwsza, przez część, która się szybko zmienia.
Zazwyczaj występuje awaria przy uruchamianiu, często błąd braku klasy lub metody w logu. Naprawą jest niemal zawsze usunięcie niezgodnego pliku JAR i zastąpienie go wersją API pasującą do Twojej wersji Minecrafta.
Ładowanie, API i mody uporządkowane za Ciebie, bez problemów z dopasowywaniem wersji.