Jak zainstalować Fabric i Fabric API

Aktualizacja:

Spis treści:

Żeby zainstalować Fabric, pobierz instalator ze strony fabricmc.net, wybierz w nim zakładkę Client i swoją wersję Minecrafta, a potem kliknij Install. Następnie pobierz Fabric API dla tej samej wersji gry, wrzuć go razem z innymi modami do folderu .minecraft/mods i uruchom w launcherze profil fabric-loader. Najczęstszy błąd na Fabricu to pominięcie Fabric API, dlatego niżej wyjaśniamy, czym różni się od samego Fabrica i jak dobrać jego wersję.

Fabric Loader i Fabric API - czym się różnią

Nazwa "Fabric" oznacza w praktyce dwie osobne rzeczy, które nowi gracze często mylą:

  • Fabric Loader - właściwy modloader. Instalujesz go instalatorem i to on sprawia, że gra w ogóle wczytuje mody. Sam nie dodaje do gry żadnej zawartości.
  • Fabric API - biblioteka, z której korzysta zdecydowana większość modów fabricowych. To zwykły plik .jar do folderu mods, pobierany osobno, jak każdy inny mod.

Loader jest mały i niezależny od wersji gry - jedna jego wersja obsługuje wiele wersji Minecrafta, więc aktualizuje się go rzadko. Fabric API wychodzi natomiast osobno dla każdej wersji gry i musi do niej dokładnie pasować. Kilka modów, głównie wydajnościowych, obchodzi się bez Fabric API, ale to wyjątki. Bezpieczniej założyć, że jest potrzebne zawsze.

Kiedy wybrać Fabric

Fabric jest lekki, szybko się uruchamia i zwykle jako pierwszy dostaje wsparcie dla nowych wersji gry. To naturalny wybór, jeśli chcesz zainstalować kilka modów poprawiających wydajność i wygodę, na przykład Sodium i Lithium, albo grać z shaderami przez Iris. Duże mody technologiczne i rozbudowane paczki częściej wychodzą na NeoForge - jeśli to ich szukasz, przejdź do poradnika jak zainstalować NeoForge.

Ostatecznie decyduje lista modów, w które chcesz grać. Na naszej stronie możesz od razu wyświetlić mody na Fabric i zawęzić je do swojej wersji gry - pobieranie jest darmowe.

Skąd pobrać instalator Fabric

Instalator pobierasz z oficjalnej strony fabricmc.net. Dla Windowsa dostępna jest wersja .exe, a dla wszystkich systemów uniwersalny plik .jar.

Jeśli wersja .exe nie chce się uruchomić albo grasz na Linuksie czy macOS, pobierz plik .jar. Do jego otwarcia potrzebna jest Java zainstalowana w systemie - oficjalny launcher ma własną Javę dla gry, ale inne programy z niej nie korzystają. Wybierz wersję Javy zgodną z wersją gry: Java 17 dla 1.18-1.20.4, Java 21 dla 1.20.5 i całej serii 1.21. Darmową dystrybucję Temurin znajdziesz na stronie adoptium.net.

Instalacja Fabric krok po kroku

  1. Jeśli to świeża instalacja gry, uruchom najpierw w oficjalnym launcherze wybraną wersję Minecrafta bez modów i zamknij ją.
  2. Otwórz instalator Fabric i zostań w zakładce Client.
  3. W polu Minecraft Version wybierz wersję gry. Pole Loader Version zostaw na najnowszej wersji.
  4. Sprawdź, czy ścieżka instalacji prowadzi do folderu .minecraft, i zostaw zaznaczoną opcję tworzenia profilu (Create profile).
  5. Kliknij Install i poczekaj na komunikat o udanej instalacji.

W launcherze pojawi się nowy profil z nazwą zaczynającą się od fabric-loader i numerem wersji gry, na przykład fabric-loader-1.21.1. Wybierz go obok przycisku Graj i uruchom grę raz bez modów. Jeśli dochodzisz do menu głównego, Loader działa.

W przeciwieństwie do Forge, Fabric nie dodaje w menu przycisku z listą zainstalowanych modów. Jeśli chcesz ją mieć, a przy okazji wygodny dostęp do ustawień modów, zainstaluj Mod Menu.

Fabric w launcherach do modów

W Prism Launcher, Modrinth App i CurseForge App Fabric wybierasz przy tworzeniu nowej instancji lub profilu - launcher pobierze go automatycznie i nie musisz uruchamiać instalatora. Każda instancja ma tam własny folder z modami, co ułatwia trzymanie kilku zestawów modów obok siebie.

Jak zainstalować Fabric API

Fabric API pobierasz jak każdy inny mod - z CurseForge, Modrinth albo z naszej strony. Na liście plików wybierz ten, który ma w nazwie twoją wersję gry. Nazwy wyglądają tak: fabric-api-0.xx.x+1.21.1.jar - numer po znaku + to wersja Minecrafta. Gdy dla jednej wersji gry jest kilka plików, bierz najnowszy.

Plik wrzuć do folderu mods bez rozpakowywania i bez zmiany nazwy. Fabric API nie aktualizuje się samo: gdy przechodzisz na nowszą wersję Minecrafta, pobierz nowy plik, a stary usuń. Trzymaj w folderze tylko jedną wersję Fabric API, żeby nie zgadywać później, która z nich jest wczytywana.

Wgrywanie modów na Fabric

Fabric korzysta z tego samego folderu .minecraft/mods co Forge i NeoForge. Jeśli leżą w nim pliki z innego modloadera, przenieś je w inne miejsce, zanim wrzucisz mody fabricowe. Gdzie dokładnie leży ten folder na Windowsie, Linuksie i macOS, opisujemy w ogólnym poradniku instalacji modów.

Poza Fabric API wiele modów wymaga dodatkowych bibliotek. Najczęściej spotkasz:

Wymagania są wypisane na stronie każdego moda i warto je przeczytać przed pobraniem. Jeśli zależy ci głównie na płynności gry, zajrzyj do naszego zestawienia modów na FPS.

Najczęstsze błędy przy uruchamianiu

Gdy coś jest nie tak z modami, Fabric zamiast uruchomić grę pokazuje okno z listą problemów. Ten sam opis znajdziesz w pliku logs/latest.log. Oto, co najczęściej się w nim pojawia.

Brakuje Fabric API

W komunikacie widać fabric-api albo nazwy zaczynające się od fabric- i kończące numerem modułu, na przykład fabric-resource-loader-v0. Wszystkie to części Fabric API, więc rozwiązanie jest jedno: pobierz Fabric API dla swojej wersji gry i wrzuć do folderu mods. Jeśli brakująca nazwa wygląda zupełnie inaczej, chodzi o inną bibliotekę - wyszukaj ją po nazwie i doinstaluj tak samo.

Mod wymaga nowszego Fabric Loadera

Komunikat wspomina wtedy o fabricloader i podaje minimalną wymaganą wersję. Uruchom ponownie instalator Fabric, wybierz tę samą wersję gry i najnowszą wersję Loadera. Mody i światy zostają na miejscu, zmienia się tylko profil w launcherze.

Mod do innej wersji gry

Jeśli w opisie problemu pojawia się minecraft z innym numerem wersji niż ta, na której grasz, plik jest przeznaczony dla innej wersji gry. Pobierz właściwy - podmiana numeru w nazwie pliku nic nie da.

W folderze są mody na Forge lub NeoForge

Mod wydany na inny modloader nie zadziała na Fabricu - w najlepszym razie zostanie pominięty, w najgorszym zablokuje start. Usuń go i poszukaj wersji fabricowej. Jeśli po usunięciu takich plików gra nadal się zamyka, pomoże poradnik jak naprawić crash Minecrafta z modami.

Najczęstsze pytania

Czy Fabric API to to samo co Fabric?

Nie. Fabric (Fabric Loader) instalujesz instalatorem i to on wczytuje mody. Fabric API to osobny mod-biblioteka, który wrzucasz do folderu mods. Do większości modów potrzebne są oba.

Czy mody na Fabric działają na Forge?

Nie bezpośrednio. Wielu twórców wydaje osobne wersje moda na każdy modloader - wtedy trzeba pobrać tę właściwą. Istnieją nakładki uruchamiające część modów fabricowych na NeoForge, ale to rozwiązanie dla zaawansowanych i nie działa z każdym modem.

Jak zaktualizować Fabric?

Loader aktualizujesz, uruchamiając ponownie instalator i wybierając najnowszą wersję. Fabric API i pozostałe mody aktualizujesz, podmieniając pliki w folderze mods na nowsze, wydane dla tej samej wersji gry.

Czy na Fabric zainstaluję OptiFine?

OptiFine nie jest modem fabricowym. Dawniej łączyło się je przez dodatkowy mod pośredniczący, ale dziś znacznie lepiej sprawdzają się Sodium i Iris, które działają natywnie na Fabricu, dają zwykle więcej klatek i obsługują te same paczki shaderów. Całą instalację opisujemy w poradniku jak zainstalować shadery.