- Konfiguracja składa się z czterech kroków: JDK, szablonu modułu przykładu, twoich mapowań, a następnie Gradle.
- Wtyczka budowania Fabric pobiera Minecrafta i konfiguruje zadania uruchomieniowe.
- Nigdy nie instalujesz Gradle samodzielnie: szablon zawiera wrapper.
- Niezgodność wersji w
gradle.propertiesjest najczęstszym powodem niepowodzenia nowego projektu.
Konfiguracja środowiska programistycznego dla Fabric wymaga czterech kroków: zainstalowania JDK, rozpoczęcia od oficjalnego szablonu modu, wyboru mapowań (zazwyczaj Yarn), a następnie uruchomienia zadań Gradle, które pobierają Minecraft i uruchamiają testowego klienta. Wtyczka budowania wykonuje większość pracy. Dopasuj wersję JDK i Minecrafta na samym początku, a reszta pójdzie gładko.
Gdzie pasuje Opal
Opal to mod Fabric z wykorzystaniem silnika skryptów JavaScript GraalVM, dzięki czemu możesz go rozszerzać skryptami bez konieczności konfigurowania pełnego środowiska modyfikacji. Jeśli chcesz po prostu go zainstalować i uruchomić, postępuj zgodnie z instrukcją konfiguracji; aby zacząć pisać skrypty, zapoznaj się z dokumentacją skryptów.
Co potrzebujesz na początek
Zanim zaczniesz pisać kod, potrzebujesz trzech rzeczy: Java Development Kit, IDE oraz Git.
- JDK. Dopasuj go do wersji Minecraft, którą chcesz targetować. Nowsze wersje Minecrafta wymagają nowszych JDK, więc sprawdź wymagania wersji przed rozpoczęciem.
- IDE. Zarówno IntelliJ IDEA, jak i Eclipse działają. Większość twórców Fabric używa IntelliJ, ponieważ integracja z Gradle i dekompilatorem jest bardziej płynna.
- Git. Będziesz klonować repozytorium szablonu i śledzić swoje zmiany.
Nie instalujesz Gradle samodzielnie. Szablon zawiera skrypt Gradle Wrapper, który pobierze odpowiednią wersję przy pierwszym uruchomieniu.
Krok po kroku
Zainstaluj JDK
Zainstaluj JDK, która odpowiada wersji Minecrafta, której używasz, i skonfiguruj swój IDE, aby wskazywała na nią.
Pobierz szablon modyfikacji przykładu
Wybierz mapowania
Szablon domyślnie używa Yarn. Yarn nadaje czytelne, udokumentowane nazwy klas i metod Minecrafta. Ustaw wersję Minecrafta, wersję ładowacza oraz wersję mapowań Yarn w gradle.properties.
Generuj źródła i uruchom
genSources, aby zdekompilować Minecrafta względem nazw Yarn. Uruchom zadanie runClient, aby uruchomić klienta deweloperskiego z załadowanym modemCo plugin budowania robi dla Ciebie
Wtyczka budowania Gradle dla Fabric pobiera Minecrafta, przekształca go zgodnie z wybranymi mapowaniem i konfiguruje ustawienia uruchomieniowe. Konfigurujesz ją za pomocą małego bloku w build.gradle.
| Ustawiasz | Gdzie | Co kontroluje |
|---|---|---|
| Wersja Minecrafta | gradle.properties | Na którą wersję gry kompilujesz |
| Wersja Loadera | gradle.properties | Loader Fabric, na którym działa Twój mod |
| Wersja Yarn | gradle.properties | Nazwy mapowań używane w Twoim kodzie źródłowym |
| Zależności | build.gradle | Fabric API oraz wszelkie biblioteki |
Utrzymuj spójność trzech wersji w gradle.properties. Niezgodność między wersją Minecrafta a wersją mapowań Yarn jest najczęstszym powodem, dla którego nowy projekt nie synchronizuje się.
Dlaczego mapowania są ważne
Minecraft jest dostarczany z zasłoniętymi klasami, więc ich nazwy wyglądają jak a.a.a. Yarn mapuje je na czytelne nazwy i opiera się na stabilnej warstwie [intermediary](/pl/learn/what-is-intermediary]. Podczas uruchamiania genSources wtyczka budowania dekompiluje grę, używając nazw Yarn, abyś mógł czytać i odwoływać się bezpośrednio do kodu Minecrafta. Podczas kompilacji Twojego moda przekształca Twój kod nazwany Yarn z powrotem do intermediary, aby gotowy plik JAR działał na dowolnej pasującej instalacji, niezależnie od zmian nazw mapowań.
Kiedy projekt nie zbuduje się
- Synchronizacja Gradle nie powodzi się bezpośrednio po imporcie: zwykle wersje Minecrafta, loadera i Yarn w pliku
gradle.propertiesnie są zgodne. Ustaw je na znaną, pasującą kombinację. - Nieprawidłowa wersja Javy: kompilacja zgłasza błąd nieobsługiwanej wersji pliku klasy, gdy Twój JDK jest starszy niż wymagana wersja Minecrafta. Zainstaluj nowszy JDK i skieruj projekt do niego.
- Brak skompilowanych źródeł do odczytu: uruchom
genSourcesi przeładuj. Pierwsze uruchomienie trwa długo, ponieważ dekompiluje całą grę. runClientnic nie robi: poczekaj, aż początkowa synchronizacja Gradle się zakończy, zanim uruchomisz jakiekolwiek zadanie. Konfiguracje uruchamiania są generowane podczas synchronizacji.
FAQ
Nie. Szablon przykładowy Fabric zawiera Gradle wrapper, który pobiera odpowiednią wersję Gradle przy pierwszym uruchomieniu. Użyj ./gradlew zamiast lokalnej instalacji Gradle.
Użyj oficjalnego szablonu moda. Zawiera wbudowany plugin, Yarn mappings oraz zadania uruchomieniowe, więc pomijasz żmudną konfigurację i zaczynasz pisać kod.
Yarn jest domyślnym ustawieniem Fabric i dostarczany z udokumentowanymi nazwami, więc jest to najłatwiejszy wybór. Można budować w oparciu o oficjalne mapowania Mojang, ale szablon jest domyślnie skonfigurowany do pracy z Yarn.
Tę, której wymaga docelowa wersja Minecrafta. Nowsze wersje wymagają nowszych JDK, więc sprawdź wersję przed instalacją i skieruj swój IDE do tej wersji JDK.
Dezakceptuje Minecrafta, używając wybranych przez Ciebie Yarn mappings, abyś mógł czytać kod gry i odwoływać się do jej klas za pomocą czytelnych nazw podczas tworzenia.
