- Die Einrichtung erfolgt in vier Schritten: ein JDK, die Beispiel-Mod-Vorlage, Ihre Zuordnungen und dann Gradle.
- Das Fabric Build-Plugin lädt Minecraft herunter und richtet die Ausführungstasks für Sie ein.
- Sie installieren Gradle nie selbst: die Vorlage enthält einen Wrapper.
- Eine Versionsabweichung in
gradle.propertiesist der häufigste Grund, warum ein neues Projekt fehlschlägt.
Die Einrichtung einer Fabric Entwicklungsumgebung erfordert vier Schritte: die Installation eines JDK, der Start von der offiziellen Beispiel-Mod-Vorlage, die Auswahl der Mappings (meist Yarn) und anschließend die Ausführung der Gradle-Aufgaben, die Minecraft herunterladen und einen Testclient starten. Das Build-Plugin erledigt den Großteil der Arbeit. Stimmen Sie Ihre JDK- und Minecraft-Version von Anfang an ab, und der Rest ergibt sich daraus.
Wo Opal Einzug hält
Opal ist ein Fabric-Mod mit einem GraalVM JavaScript Scripting Engine, sodass du es mit Skripten erweitern kannst, ohne eine vollständige Mod-Toolchain einrichten zu müssen. Wenn du es nur installieren und ausführen möchtest, folge der Einrichtungsanleitung; um mit dem Schreiben von Skripten zu beginnen, siehe die Skripting-Dokumentation.
Was du zuerst brauchst
Du benötigst drei Dinge, bevor du überhaupt Code schreibst: ein Java Development Kit, eine IDE und Git.
- Ein JDK. Wähle es passend zur Minecraft-Version aus, die du anvisierst. Neuere Minecraft-Versionen benötigen ein neueres JDK, also überprüfe die Versionsanforderung, bevor du anfängst.
- Eine IDE. Sowohl IntelliJ IDEA als auch Eclipse funktionieren. Die meisten Fabric-Entwickler nutzen IntelliJ, da die Gradle- und Dekompilierungsintegration reibungsloser ist.
- Git. Du wirst das Template-Repository klonen und deine eigenen Änderungen verfolgen.
Du installierst Gradle nicht selbst. Das Template enthält ein Gradle-Wrapper-Skript, das die richtige Version beim ersten Start herunterlädt.
Schritt für Schritt
Installieren Sie ein JDK
Besorgen Sie die Beispiel-Mod-Vorlage
Wählen Sie Ihre Zuordnungen
gradle.properties festgelegtQuellen generieren und ausführen
genSources aus, um Minecraft gegen Yarn-Namen zu dekompilieren. Starten Sie die Aufgabe runClient, um einen Entwicklungskunden mit Ihrem Mod zu startenWas das Build-Plugin für Sie tut
Das Gradle-Build-Plugin für Fabric lädt Minecraft herunter, ordnet es Ihren gewählten Mappings zu und richtet die Run-Konfigurationen ein. Sie konfigurieren es über einen kleinen Block in build.gradle.
| Sie legen fest | Wo | Was es steuert |
|---|---|---|
| Minecraft-Version | gradle.properties | Gegen welche Spielversion Sie kompilieren |
| Loader-Version | gradle.properties | Den Fabric-Loader, auf dem Ihr Mod läuft |
| Yarn-Version | gradle.properties | Die Mapping-Namen, die in Ihrem Quellcode verwendet werden |
| Abhängigkeiten | build.gradle | Die Fabric API und alle Bibliotheken |
Halten Sie die drei Versionen in gradle.properties konsistent. Ein Ungleichgewicht zwischen der Minecraft-Version und der Yarn-Mappings-Version ist der häufigste Grund, warum ein neues Projekt nicht synchronisiert werden kann.
Warum Mappings hier wichtig sind
Minecraft wird verschleiert ausgeliefert, sodass seine Klassen Namen wie a.a.a haben. Yarn ordnet diese lesbaren Namen zu und sitzt auf der stabilen intermediary-Schicht. Wenn Sie genSources ausführen, dekompiliert das Build-Plugin das Spiel mit Yarn-Namen, sodass Sie Minecraft-Code direkt lesen und referenzieren können. Beim Kompilieren Ihres Mods ordnet es Ihren Yarn-benannten Code zurück zu intermediary, sodass die fertige JAR-Datei auf jeder passenden Installation funktioniert, unabhängig von Mapping-Umbenennungen.
Wenn das Projekt nicht erstellt werden kann
- Gradle-Synchronisierung schlägt direkt nach dem Import fehl: in der Regel stimmen die Minecraft-, Loader- und Yarn-Versionen in
gradle.propertiesnicht überein. Setzen Sie diese auf eine bekannte, übereinstimmende Version. - Falsche Java-Version: Der Build beschwert sich über eine nicht unterstützte Klassen-Dateiversion, wenn Ihr JDK älter ist als die Minecraft-Version benötigt. Installieren Sie ein neueres JDK und verweisen Sie das Projekt darauf.
- Keine dekompilierten Quellen zum Lesen: führen Sie
genSourcesaus und laden Sie es neu. Der erste Durchlauf dauert eine Weile, da das gesamte Spiel dekompiliert wird. runClienttut nichts: lassen Sie die anfängliche Gradle-Synchronisierung abschließen, bevor Sie eine Aufgabe ausführen. Die Run-Konfigurationen werden während der Synchronisierung generiert.
Häufig gestellte Fragen
Nein. Die Fabric-Beispielvorlage enthält einen Gradle-Wrapper, der beim ersten Start die korrekte Gradle-Version herunterlädt. Verwenden Sie ./gradlew anstelle einer systemweiten Gradle-Installation.
Verwenden Sie die offizielle Beispiel-Mod-Vorlage. Sie enthält bereits das Build-Plugin, die Yarn-Zuordnungen und die Ausführung von Aufgaben, sodass Sie den umständlichen Einrichtungsaufwand überspringen und direkt mit dem Schreiben von Code beginnen können.
Yarn ist die Standardeinstellung von Fabric und wird mit dokumentierten Namen ausgeliefert, daher ist es die einfache Wahl. Sie können auch gegen die offiziellen Mojang-Mappings bauen, aber die Vorlage ist standardmäßig für Yarn eingerichtet.
Die, die von Ihrer Ziel-Minecraft-Version benötigt wird. Neuere Versionen benötigen neuere JDKs, daher sollten Sie die Version prüfen, bevor Sie installieren, und Ihre IDE auf dieses JDK ausrichten.
Es dekompiliert Minecraft mithilfe Ihrer ausgewählten Yarn-Mappings, sodass Sie den Code des Spiels lesen und seine Klassen während der Entwicklung mit lesbaren Namen referenzieren können.
