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.

TRtrolPublished 5 min read

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ęśćZadanieCzęstotliwość aktualizacji
Ładowacz FabricUruchamia grę, stosuje poprawki Mixin, rozwiązuje modySzybko przenoszony na nową wersję MC
API FabricWspółdzielone zdarzenia, sieci, rejestr, pomocnicy renderowaniaRozwija 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.

  1. Potwierdź swoją wersję Minecrafta

    Zwróć uwagę na dokładną wersję, z której uruchamiasz profil, aż po numer łatki.

  2. Pobierz odpowiednią wersję API

    Pobierz wersję Fabric API oznaczoną dla tej samej wersji, a nie najnowszą dostępną.

  3. 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.

  4. 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

Zdobądź Terminus

Ładowanie, API i mody uporządkowane za Ciebie, bez problemów z dopasowywaniem wersji.