Jak skonfigurować środowisko programistyczne Fabric

Konfiguracja środowiska modowania Fabric składa się z czterech kroków: zainstaluj Java Development Kit, zacznij od oficjalnego szablonu modu, skonfiguruj Yarn mappings, a następnie uruchom Gradle. Wtyczka budowania Fabric pobiera Minecraft i łączy wszystko inne. Dopasuj wersję JDK i Minecrafta na samym początku, a system budowania zajmie się resztą.

Co potrzebujesz na początek

Zanim zaczniesz pisać kod:

• JDK dopasowany do Twojej wersji Minecrafta. Nowsze wersje Minecrafta wymagają nowszych JDK. Sprawdź wymagania docelowej wersji przed instalacją.
• IDE. IntelliJ IDEA Community (darmowa) lub Eclipse sprawdzają się równie dobrze. Większość twórców modów Fabric używa IntelliJ, ponieważ integracja z Gradle jest płynniejsza.
• Git. Będziesz klonować repozytorium szablonu i zarządzać własnym kodem.

Nie musisz instalować Gradle. Szablon zawiera skrypt opakowujący, który pobiera odpowiednią wersję przy pierwszym uruchomieniu.

Krok po kroku

1. Zainstaluj JDK

   Pobierz JDK z Adoptium lub Oracle, dopasowany do wersji Minecrafta, którą chcesz używać. Dla Minecrafta 1.21 zainstaluj Javę 21. Wskaż ten JDK w ustawieniach swojego IDE.

2. Pobierz szablon modyfikacji przykładu

   Przejdź do oficjalnego repozytorium modu przykładów Fabric na GitHubie i sklonuj je lub użyj jako szablon. Zmień nazwę pakietu i identyfikator moda na własne.

3. Ustaw wersje w gradle.properties

   Otwórz plik gradle.properties i zaktualizuj trzy wiersze:

   • minecraft_version — wersja Minecrafta, na którą celujesz (np. 1.21)
   • loader_version — wersja ładowacza Fabric pasująca do Twojej wersji Minecrafta
   • yarn_mappings — wersja Yarn dla Twojej wersji Minecrafta

   Te trzy wartości muszą się zgadzać, w przeciwnym razie projekt nie zostanie skompilowany.

4. Otwórz w swoim IDE i zsynchronizuj

   Otwórz folder projektu w swoim IDE. Pozwól Gradle wykonać początkową synchronizację (pobiera zależności, generuje konfiguracje uruchomieniowe).

5. Wygeneruj skompilowane źródła

   W panelu Gradle w Twoim IDE uruchom genSources. To dekompiluje Minecrafta przy użyciu nazw Yarn, dzięki czemu możesz zapoznać się z kodem gry.

6. Uruchom klienta testowego

   Uruchom runClient, aby rozpocząć Minecraft z załadowanym modem. Client deweloperski oferuje pełne możliwości debugowania.

To wszystko. Teraz masz działające środowisko programistyczne Fabric.

Rozumienie gradle.properties

Ten plik konfiguruje cały proces budowania. Trzy wersje muszą być ze sobą zsynchronizowane:

minecraft_version=1.21
loader_version=0.15.11
yarn_mappings=1.21+build.32

Jeśli Minecraft to 1.21, a Yarn to 1.20.1, Gradle zgłosi błąd z niejasnym komunikatem. Zawsze pobieraj pasujące wersje ze strony fabricmc.net/use lub szablonu przykładu.

Co robi wtyczka budowania

Wtyczka Gradle Fabric jest skonfigurowana w build.gradle i obsługuje:

• Pobieranie Minecrafta
• Deekompilację z wybranymi mapami
• Remapowanie kodu z powrotem do pośredniego formatu w celu zapewnienia kompatybilności
• Generowanie konfiguracji uruchomieniowych IDE

Konfigurujesz ją raz; ona automatyzuje resztę. Dlatego szablon ma znaczenie — on już ma wszystko poprawnie podłączone.

Wyjaśnienie map

Minecraft jest dostarczany z zasłoniętymi nazwami klas (np. a, b, c). Mapy tłumaczą te nazwy na czytelne.

• Yarn: Domyślny dla Fabric. Zawiera dokumentację. Łatwy do odczytania.
• Mapy Mojang: Oficjalne, ale mniej udokumentowane. Bardziej niejasne nazwy.

Szablon używa Yarn. Podczas uruchamiania genSources Minecraft jest dekompilowany przy użyciu nazw Yarn, dzięki czemu możesz czytać rzeczywisty kod. Podczas kompilacji Fabric remapuje go z powrotem do pośredniego formatu (stabilnej warstwy pod spodem), dzięki czemu mod działa na dowolnej pasującej wersji Minecrafta.

Typowe problemy z konfiguracją

• ✓Synchronizacja Gradle nie powodzi się od razu: sprawdź plik gradle.properties. Wersje Minecrafta, loadera i Yarn muszą być zgodne. Użyj sprawdzonej kombinacji z witryny Fabric.
• ✓Błąd kompilatora dotyczący wersji Javy: Twoja wersja JDK jest zbyt stara dla wersji Minecrafta. Zainstaluj nowszą wersję JDK i skieruj swój IDE do niej.
• ✓Nie można odczytać kodu źródłowego Minecrafta: uruchom genSources w panelu Gradle i przeładuj. Pierwsze uruchomienie jest powolne, ponieważ dekompiluje całą grę.
• ✓runClient nic nie robi: czeka na zakończenie początkowej synchronizacji Gradle. Konfiguracje uruchomieniowe są generowane podczas synchronizacji.
• ✓IDE nie importuje projektu: upewnij się, że w ustawieniach IDE wybrano JDK, a nie JRE.

Kolejne kroki po konfiguracji

Gdy środowisko działa:

1. Usuń lub zmień nazwę przykładowych klas modów
2. Utwórz własny pakiet modów
3. Zaimplementuj prostą funkcję (blok, przedmiot lub nasłuchiwacz zdarzeń)
4. Uruchom runClient i przetestuj w kliencie deweloperskim
5. Powtarzaj

Klient deweloperski oferuje pełne wsparcie debugowania i hot-reload, co przyspiesza iterację.

Uwagi specyficzne dla IDE

IntelliJ IDEA:

• Importuj jako projekt Gradle (a nie tylko folder)
• Pozwól Gradle w pełni zsynchronizować się przed uruchomieniem jakiejkolwiek operacji
• Konfiguracje uruchamiania pojawiają się pod "Gradle" w rozwijanym menu uruchamiania

Eclipse:

• Importuj jako istniejący projekt Gradle
• Kliknij prawym przyciskiem myszy projekt → Gradle → Odśwież projekt Gradle po synchronizacji
• Zadania Gradle pojawiają się w widoku Gradle Tasks

FAQ