Fabric Loader uruchamia mody Fabric; Fabric API to dodatkowa biblioteka modów. Nowy Loader nie zastąpi ani brakującego API, ani pliku moda przeznaczonego dla złej wersji Minecrafta. Na serwerze Fabric w mcfreehost sprawdzasz więc najpierw cały zestaw wersji i konkretny komunikat przy starcie. Dopiero potem zmieniasz dotknięty komponent i testujesz z pasującym klientem.
Zawartość sprawdzona: 7 października 2026. Ten poradnik dotyczy Javy z Fabric. Pluginy Paper, pliki Forge/NeoForge i natywne serwery Bedrock to inne ścieżki oprogramowania. Nie zalecamy żadnej konkretnej wersji Loadera jako pasującej do każdego packa.
Minecraft, Loader i API to trzy różne informacje
| Komponent | Co określa | Gdzie to porównasz |
|---|---|---|
| Minecraft | Wersja gry i podstawa danych świata | Log startowy serwera i faktycznie uruchomiona instancja klienta |
| Fabric Loader | Ładowanie modów i sprawdzanie zadeklarowanych wymagań | Log startowy, zarządzanie oprogramowaniem i wytyczne packa |
| Fabric API | Funkcje biblioteki dla modów, które jej potrzebują | Plik moda w folderze mods i jego metadane pobierania |
| Modpack i poszczególne mody | Zawartość, zależności i wymagana strona | Wersja packa, pakiet serwerowy, dane pliku/projektu |
| Java | Środowisko uruchomieniowe, w którym startują Minecraft i mody | Log startowy/crashu i wymagania wybranej wersji gry |
Te trzy elementy muszą pasować do wymagań Twojego packa. Najnowsze wydanie biblioteki nie oznacza wspólnego numeru wersji dla całej trójki.
W opisie instalacji modów Fabric wyjaśnia, że musisz sprawdzić wersję gry, rodzinę Loadera i edycję Javy. Plik Fabric API dla innej gałęzi Minecrafta nie stanie się kompatybilny przez samo przemianowanie. Podobnie umieszczenie moda Forge w folderze Fabric nie zrobi z niego moda Fabric.
1. Zanotuj faktyczny zestaw wersji
Przed ingerencją zanotuj te dane dla serwera i używanej instancji klienta:
Minecraft: dokładna wersja gry
Fabric Loader: faktycznie załadowana wersja
Fabric API: nazwa pliku i opublikowana wersja
Modpack: nazwa i konkretna wersja paczki
Java: środowisko uruchomieniowe użyte w logu startowym
Ostatnia zmiana: co jest inaczej od ostatniego udanego startu
To szablon do Twoich notatek, a nie gotowy zestaw zgodnych wersji. Szczególnie przy kilku instancjach launchera nie wystarczy mieć gdzieś zainstalowaną właściwą wersję: musisz uruchomić dokładnie tę instancję. Aktualizacja launchera, wersja packa i aktualizacja Minecrafta to różne zmiany.
Przy gotowym modpacku zacznij od jego udokumentowanego pakietu serwerowego i przewidzianej wersji klienta. Nie aktualizuj każdego moda z osobna do „najnowszej” wersji. Skład packa może celowo używać starszego pliku. Do samego pobrania klienta i dołączenia pomoże poradnik dołączania do modpacka (en).
2. Wybierz właściwy plik API i stronę moda
Otwórz listę plików oficjalnego projektu Fabric API i przefiltruj ją według swojej wersji Minecrafta. Następnie sprawdź, czy wybrany plik spełnia wymagania packa i dotkniętych modów. Sama data wydania nie odpowiada na to pytanie; nowe wydanie może być przeznaczone dla innej gałęzi gry.
Przy każdym kolejnym pliku sprawdź:
- Czy jest opublikowany dla Fabric i dopuszczony dla Twojej wersji Minecrafta?
- Czy należy na klienta, serwer dedykowany, czy na obie strony?
- Jakich dodatkowych bibliotek wymaga dokładnie ta wersja?
- Czy w folderze serwera leży jeszcze starsze wydanie tego samego moda?
Drugi plik API obok starego to nie czysta wymiana. Zabezpiecz dotychczasowy plik poza aktywnym folderem mods, zanim wstawisz pasującą wersję. Dowolnie przemianowany JAR nadal może zostać załadowany; naprawdę usuń stary aktywny plik z tego folderu.
Mody czysto graficzne lub interfejsowe często potrzebne są tylko na kliencie. Dlatego nie kopiuj całego folderu klienta na serwer bez sprawdzenia. Metadane modów Fabric rozróżniają środowiska client, server i *. Wiążące pozostają dane projektu lub pakietu serwerowego; błędnie zadeklarowany mod może mimo to ulec awarii dopiero później.
3. Poprawnie przeczytaj komunikat
Otwórz w panelu serwera dane wyjściowe startu. Jeśli przerwanie zaczyna się od listy zależności, takiej jak Incompatible mods found!, zanotuj: który mod, jakie wymaganie i jaka obecna wersja są podane.
| Obserwacja | Znaczenie | Celowy następny krok |
|---|---|---|
| Brakuje wymaganego moda | Obowiązkowa zależność nie jest spełniona | Zdobądź brakującą bibliotekę dla tej samej gałęzi Minecrafta |
| Obecne API jest zbyt stare | Mod wymaga innej wersji lub zakresu wersji API | Wybierz dopuszczony do tego plik API; zastąp stare aktywne wydanie |
| Mod wymaga innej wersji Minecrafta | Pobrany plik moda nie pasuje do gałęzi gry | Znajdź pasujące wydanie moda; nie aktualizuj na ślepo istniejącego świata |
| Loader nie spełnia wymagania | Załadowana wersja Loadera nie pasuje do wytycznych packa | Przygotuj zmianę Loadera jako zmianę oprogramowania startowego |
| Ten sam identyfikator moda pojawia się wielokrotnie | Dwa aktywne pliki mogą oferować tego samego moda | Sprawdź listę plików i zawartość packa pod kątem zduplikowanych wydań |
| Start przechodzi dalej i zawodzi dopiero z wyjątkiem | Sprawdzenie zależności nie tłumaczy błędu w pełni | Zbadaj raport startu/crashu i ostatnią zmianę |
Lista może zawierać kilka powiązanych wymagań. Rozwiąż wskazany konflikt jako spójny zestaw; najwyższy wiersz nie jest automatycznie jedyną przyczyną. Potem sprawdzasz nowe dane wyjściowe startu, zamiast dalej śledzić stary komunikat.
Błąd Mixin lub NoClassDefFoundError sam w sobie nie dowodzi braku Fabric API. Poradnik Fabric o raportach crashu wyjaśnia istotne łańcuchy błędów, dane systemowe i listę modów. Mod wymieniony jako pierwszy może być zaangażowany, nie będąc jedynym winnym. Jeśli serwer w ogóle nie startuje, poradnik o błędach startu (en) zawęża także przyczyny poza wyborem wersji.
4. Zmiana w mcfreehost i test z drogą powrotu
Najpierw zabezpiecz świat, konfigurację i dotychczasowy zestaw wersji. Kopia samych plików modów nie wystarczy do powrotu po konwersji świata. Zaplanuj zmianę na czas, gdy Twoja ekipa nie gra, i zatrzymaj serwer czysto przez panel zarządzania.
Loader należy do oprogramowania startowego. Użyj do tego przewidzianej ścieżki oprogramowania/wersji Twojego serwera; nie wkładaj JAR-a Loadera do mods jako rzekomego API. Przy zmianie lub reinstalacji przeczytaj wyświetlaną wskazówkę o zachowaniu danych. Przed potwierdzeniem zatrzymaj się, jeśli nie masz jeszcze pełnej kopii zapasowej. API i inne biblioteki modów trafiają natomiast jako pasujące pliki modów do mods.
Przy zarządzanym modpacku trzymaj się jego ścieżki aktualizacji i instalacji. Późniejsza aktualizacja packa może ponownie zastąpić ręczną wymianę plików. Dlatego zanotuj własne zmiany i wyjaśnij, czy w ogóle są zgodne z docelową wersją packa. Jak kontrolować automatyczne aktualizacje, opisuje poradnik o aktualizacjach (en).
Po zmianie sprawdzasz po kolei:
- Serwer osiąga stan gotowości; nowy log startowy pokazuje oczekiwany stan gry i Loadera.
- Klient z przewidzianą wersją packa rzeczywiście może dołączyć.
- Ważna dla Waszej gry funkcja moda działa we właściwym świecie.
- Po czystym restarcie świat i ustawienia pozostają zachowane.
Udany start nie potwierdza jeszcze udanego dołączenia do modpacka. Z kolei nowsze API nie rozwiąże braku RAM-u. Jeśli start działa, a serwer przeciążają dopiero nowe chunki lub wiele encji, oddziel to zagadnienie zasobów od błędu wersji. Dla serwerów Free obowiązują granice darmowego startu (en); dodatkowa biblioteka nie zwiększa dostępnego RAM-u.
Jeśli nowy stan zawodzi, zatrzymaj dalsze zmiany i przywróć udokumentowany stary stan oprogramowania razem z kopią zapasową sprzed zmiany. Nie uruchamiaj świata załadowanego już w nowszym Minecrafcie jako improwizowanego downgrade'u ze starszym oprogramowaniem. Na potrzeby pomocy zanotuj wersję packa, ostatnią zmianę i istotne linie logu; przed udostępnieniem sprawdź logi pod kątem danych dostępowych.
FAQ
Czy mogę zawsze ustawić Fabric Loader na najnowszą wersję?
Loader obsługuje kilka wersji gry, ale to nie jest obietnica dla każdego składu packa. Sprawdź wytyczne packa i modów, zabezpiecz stan i przetestuj zmianę. Aktualizacja Loadera nie zastąpi błędnie wybranego pliku moda.
Czy Fabric API musi mieć ten sam numer wersji co Minecraft?
Nie. Fabric API ma własny numer wersji. Decydujące są wersje Minecrafta podane dla danego pliku oraz wymagania modów, które z niego korzystają.
Czy Fabric API musi być na serwerze i na kliencie?
Zależy to od modów po danej stronie. Jeśli potrzebują Fabric API, musi tam być pasujące wydanie. Dane packa i projektu mówią Ci, które pliki są przewidziane dla klienta, a które dla serwera.
Czy klient i serwer muszą mieć ten sam Loader?
Sam numer Loadera nie decyduje o dołączeniu. Obie strony muszą spełniać swoje wymagania modów. Dla gotowego packa używasz po obu stronach jego przewidzianej wersji i dbasz o pasującą wersję Minecrafta; nie wymieniaj Loadera niezależnie od packa.
Czy mogę po prostu wyłączyć brakującą obowiązkową zależność?
Wyłączone sprawdzanie zależności nie sprawi, że brakujące funkcje staną się dostępne. Znajdź pasujący plik lub wróć do działającego stanu packa. Zmiany w pliku metadanych nie są w tym poradniku normalną drogą naprawy.
Dlaczego mimo udanego startu serwera nie mogę dołączyć?
Start serwera sprawdza jego własne środowisko. Błędnie uruchomiona instancja klienta, inna wersja packa lub brakująca wspólna zawartość mogą wyjść na jaw dopiero przy dołączaniu. Porównaj wtedy faktyczne wersje i konkretny komunikat błędu klienta.
Źródła i podstawa weryfikacji
- Fabric: instalacja modów — wersja gry, rodzina Loadera i instalacja.
- Fabric: instalacja i launcher serwera — Loader jako część instalacji startowej.
- Fabric API: opublikowane pliki — przypisanie do wersji gry.
- Fabric: metadane modów — środowiska i zadeklarowane zależności.
- Fabric: czytanie raportów crashu — łańcuchy błędów i dane systemowe/modów.
Źródła sprawdzono 7 października 2026. Konkretny zestaw wersji pozostaje decyzją dotyczącą Twojego packa; ten artykuł nie twierdzi, że przeprowadzono nowy test startu lub dołączenia w Twoim indywidualnym świecie.