Wie man eine Fabric-Entwicklungsumgebung einrichtet

Das Einrichten einer Fabric-Modding-Entwicklungsumgebung erfordert vier Schritte: Installieren eines Java Development Kits, Starten mit der offiziellen Beispiel-Mod-Vorlage, Konfigurieren der Yarn-Mappings und anschließendes Ausführen von Gradle. Das Fabric-Build-Plugin lädt Minecraft herunter und verbindet alles andere. Stimmen Sie Ihre JDK- und Minecraft-Version von Anfang an ab, und das Build-System kümmert sich um den Rest.

Was Sie zuerst benötigen

Bevor Sie Code schreiben:

• Ein JDK, das mit Ihrer Minecraft-Version übereinstimmt. Neuere Minecraft-Versionen benötigen neuere JDKs. Überprüfen Sie die Anforderungen Ihrer Zielversion, bevor Sie installieren.
• Eine IDE. IntelliJ IDEA Community (kostenlos) oder Eclipse funktionieren beide gut. Die meisten Fabric-Entwickler verwenden IntelliJ, da die Gradle-Integration reibungsloser ist.
• Git. Sie klonen das Vorlagen-Repository und verwalten Ihren eigenen Code.

Sie müssen Gradle NICHT installieren. Die Vorlage enthält ein Wrapper-Skript, das beim ersten Ausführen die richtige Version herunterlädt.

Schritt für Schritt

1. Installieren Sie ein JDK

   Laden Sie ein JDK von Adoptium oder Oracle herunter, das mit Ihrer Ziel-Minecraft-Version übereinstimmt. Für Minecraft 1.21 installieren Sie Java 21. Verweisen Sie Ihre IDE in ihren Einstellungen auf dieses JDK.

2. Besorgen Sie die Beispiel-Mod-Vorlage

   Gehen Sie zum offiziellen Fabric GitHub-Beispielmod-Repository und klonen Sie es oder verwenden Sie es als Vorlage. Benennen Sie das Paket und die Mod-ID in Ihre eigenen um.

3. Versionen in gradle.properties festlegen

   Öffnen Sie gradle.properties und aktualisieren Sie drei Zeilen:

   • minecraft_version — Ihre Ziel-Minecraft-Version (z. B. 1.21)
   • loader_version — die Fabric-Loader-Version, die mit Ihrem Minecraft-Build übereinstimmt
   • yarn_mappings — die Yarn-Version für Ihre Minecraft-Version

   Diese drei Werte müssen übereinstimmen, sonst lässt sich das Projekt nicht erstellen.

4. Öffnen Sie es in Ihrer IDE und synchronisieren Sie es

   Öffnen Sie den Projektordner in Ihrer IDE. Lassen Sie Gradle eine anfängliche Synchronisierung durchführen (lädt Abhängigkeiten herunter, generiert Run-Konfigurationen).

5. Generiere dekompilierte Quellen

   In deinem IDEs Gradle-Panel führe genSources aus. Dies dekompiliert Minecraft mit Yarn-Namen, sodass du den Code des Spiels lesen kannst.

6. Starten Sie einen Testclient

   Führe runClient aus, um Minecraft mit deinem Mod zu starten. Der Entwicklungsclient bietet umfassende Debugging-Funktionen.

Das war's. Du hast jetzt eine funktionierende Fabric-Entwicklungsumgebung.

Verständnis von gradle.properties

Diese Datei konfiguriert dein gesamtes Build. Drei Versionen müssen synchron gehalten werden:

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

Wenn Minecraft 1.21, aber Yarn 1.20.1 ist, schlägt Gradle mit einem kryptischen Fehler fehl. Hole immer passende Versionen von fabricmc.net/use oder der Beispielvorlage ab.

Was das Build-Plugin macht

Das Fabric Gradle-Plugin wird in build.gradle konfiguriert und übernimmt:

• Herunterladen von Minecraft
• Dekompilieren mit deinen gewählten Mappings
• Remappen deines Codes zurück zu Intermediary für die Kompatibilität
• Generieren von IDE-Ausführungskonfigurationen

Du konfigurierst es einmal; es automatisiert den Rest. Deshalb ist die Vorlage wichtig – sie hat bereits alles korrekt verbunden.

Mappings erklärt

Minecraft wird verschleiert ausgeliefert (Klassennamen wie a, b, c). Mappings übersetzen diese in lesbare Namen.

• Yarn: Fabric's Standard. Enthält Dokumentation. Leicht zu lesen.
• Mojang Mappings: Offiziell, aber weniger dokumentiert. Verschwommene Namen.

Die Vorlage verwendet Yarn. Wenn du genSources ausführst, wird Minecraft mit Yarn-Namen dekompiliert, sodass du den eigentlichen Code lesen kannst. Beim Kompilieren remapt Fabric ihn zurück zu Intermediary (eine stabile Schicht darunter), sodass der Mod mit jeder passenden Minecraft-Version funktioniert.

Häufige Einrichtungsprobleme

• ✓Gradle-Synchronisierung schlägt sofort fehl: Überprüfen Sie gradle.properties. Minecraft-, Loader- und Yarn-Versionen müssen übereinstimmen. Verwenden Sie eine bekannte Kombination von der Fabric-Website.
• ✓Compilerfehler bezüglich der Java-Version: Ihr JDK ist für die Minecraft-Version zu alt. Installieren Sie ein neueres JDK und verweisen Sie Ihre IDE darauf.
• ✓Minecraft-Quellcode nicht lesbar: Führen Sie genSources im Gradle-Panel aus und laden Sie es neu. Der erste Durchlauf ist langsam, da das gesamte Spiel dekompiliert wird.
• ✓runClient tut nichts: Warte auf den Abschluss der ersten Gradle-Synchronisierung. Ausführungs-Konfigurationen werden während der Synchronisierung generiert.
• ✓Die IDE importiert das Projekt nicht: Stellen Sie sicher, dass in den Einstellungen der IDE ein JDK und nicht ein JRE ausgewählt ist.

Nächste Schritte nach der Einrichtung

Sobald Ihre Umgebung funktioniert:

1. Löschen oder benennen Sie die Beispiel-Mod-Klassen um.
2. Erstellen Sie Ihr eigenes Mod-Paket.
3. Implementieren Sie eine einfache Funktion (einen Block, ein Item oder einen Event-Listener).
4. Führen Sie runClient aus und testen Sie im Entwicklungskunden.
5. Iterieren Sie.

Der Entwicklungskunde bietet umfassende Debugging- und Hot-Reload-Unterstützung, wodurch Iterationen schnell werden.

IDE-spezifische Hinweise

IntelliJ IDEA:

• Als Gradle-Projekt importieren (nicht nur als Ordner).
• Lassen Sie Gradle vollständig synchronisieren, bevor Sie eine Aufgabe ausführen.
• Ausführungskonfigurationen finden Sie unter "Gradle" im Ausführungsmenü.

Eclipse:

• Als bestehendes Gradle-Projekt importieren.
• Rechtsklick auf das Projekt → Gradle → Gradle-Projekt aktualisieren nach Synchronisierung.
• Gradle-Aufgaben erscheinen in der Gradle-Aufgabenansicht.

FAQ