Wie man einen Minecraft-Mod erstellt: Fabric-Projekt, Java-Code und JAR-Erstellung

Diese Anleitung basiert auf Minecraft Java Edition 26.2 und Fabric und erstellt einen Mod, der beim ersten Start ein Log ausgibt. Dies ist ein Einsteigerbeispiel, das den Schritten folgt, bis die Mod-Datei vom Loader erkannt und der von Ihnen geschriebene Java-Code ausgeführt wird. Da sich die Struktur von Bedrock-Add-ons und Forge·NeoForge-Projekten unterscheidet, sollten Sie diese nicht in einem einzigen Projekt mischen.

1. Vorbereitung der Entwicklungsumgebung

Die aktuelle Fabric-Dokumentation für 26.2 empfiehlt JDK 25. Anstatt nur die Java-Laufzeitumgebung zu installieren, installieren Sie das Entwicklungs-JDK und bereiten Sie IntelliJ IDEA oder VS Code vor. Überprüfen Sie das aktuell verwendete Java mit dem folgenden Befehl im Terminal. Die Project SDK der IDE und die Gradle JVM müssen ebenfalls auf dieselbe Version verweisen. Um für eine ältere Version wie 1.21.1 zu entwickeln, ändern Sie die Versionsauswahl am Anfang des Dokuments und die Generatorversion zusammen und folgen Sie den JDK-Anforderungen dieser Version.

java -version
javac -version

2. Erstellen eines Projekts im Fabric-Generator

1. Öffnen Sie den offiziellen Fabric Template Mod Generator.
2. Setzen Sie den Mod Name auf TroubleMaker Hello, die Mod ID auf tmhello und den Package Name auf com.ascgame.tmhello.
3. Passen Sie die Minecraft-Version auf 26.2 an. Erweiterte Optionen wie Kotlin oder separate Datengenerierung müssen für das erste Beispiel nicht hinzugefügt werden.
4. Laden Sie die ZIP-Datei herunter und entpacken Sie sie in einen einfachen Pfad wie C:/Projects/TMHello. Bestimmen Sie den Projektordner entsprechend Ihrem tatsächlichen Betriebssystem.
5. Öffnen Sie build.gradle oder das Projektstammverzeichnis in der IDE und warten Sie, bis der Gradle-Import abgeschlossen ist. Behalten Sie die vom Generator festgelegten Loader-, Loom- und API-Versionen bei.

3. Verstehen, was die Dateien tun

src/main/java ist der gemeinsame Java-Code, src/main/resources/fabric.mod.json ist die Deklaration für Mod-ID, Einstiegsklasse und Abhängigkeiten, und gradle.properties ist für Version und Projekteinstellungen zuständig. Je nach Generator kann der Client-Code in src/client/java unterteilt sein. Dieses Beispiel ändert nur den gemeinsamen Initialisierungscode. Löschen Sie nicht willkürlich alle Konfigurationsdateien und überschreiben Sie keine Einstellungen anderer Versionen aus dem Internet.

4. Schreiben Ihrer Initialisierungsklasse

Suchen Sie die generierte gemeinsame ModInitializer-Implementierungsdatei und passen Sie sie an die folgende Struktur an. Wenn Sie den Dateinamen in TMHello.java geändert haben, passen Sie auch den Package-Ordner und den Klassennamen an. Da SLF4J-Protokolle verwendet werden, können Sie die Initialisierung überprüfen, ohne die Item-Registrierungs-API zu verwenden, die sich in verschiedenen Spielversionen leicht ändern kann.

package com.ascgame.tmhello;

import net.fabricmc.api.ModInitializer;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class TMHello implements ModInitializer {
    public static final String MOD_ID = "tmhello";
    private static final Logger LOG = LoggerFactory.getLogger(MOD_ID);

    @Override
    public void onInitialize() {
        LOG.info("TroubleMaker: my first Fabric mod is ready.");
    }
}

Stellen Sie sicher, dass entrypoints.main auf den vollständigen Namen der obigen Klasse verweist, während Sie den Rest des Inhalts von fabric.mod.json beibehalten. Das Folgende ist der zu überprüfende Teil, nicht die gesamte Datei. Ersetzen Sie bestehende Mixins oder Client-Einstellungen nicht vollständig.

{
  "entrypoints": {
    "main": ["com.ascgame.tmhello.TMHello"]
  }
}

5. Entwicklungsausführung und Erstellung der finalen Datei

1. Führen Sie im Projektstammverzeichnis gradlew.bat runClient unter Windows oder ./gradlew runClient unter macOS/Linux aus.
2. Suchen Sie nach dem Text TroubleMaker in der Entwicklungsklient-Konsole oder in run/logs/latest.log. Dies ist ein Beispiel, das während der Initialisierung vor dem Betreten der Welt einmal ausgegeben wird.
3. Beenden Sie das Spiel und erstellen Sie die Distributionsdatei mit gradlew.bat build unter Windows oder ./gradlew build unter macOS/Linux.
4. Überprüfen Sie das normale Distributions-JAR in build/libs. Verwenden Sie keine Entwicklungsdateien mit „sources“ oder „dev“ im Namen als normale Distribution.
5. Legen Sie das JAR in den mods-Ordner einer separaten Fabric-Instanz derselben Minecraft-Version. Wenn die Fabric API in den generierten Abhängigkeiten enthalten ist, installieren Sie sie passend zur selben Version.
6. Starten Sie das Spiel mit dem echten Launcher und überprüfen Sie, ob derselbe Text in den logs/latest.log der Instanz ausgegeben wird.

6. Häufige Fehler und Behebung

Bei „Unsupported class file version“ überprüfen Sie die Java-Version, bei Ladefehlern der Einstiegsklasse prüfen Sie zuerst Unstimmigkeiten zwischen Package, Klassenname und entrypoints. Wenn nach dem Einfügen in den mods-Ordner nichts passiert, überprüfen Sie, ob Sie es in eine andere Launcher-Instanz eingefügt haben. Dieses Beispiel fügt keine Speicherdaten hinzu, sodass Sie das Spiel beenden und das JAR zum Vergleich entfernen können. Wenn Sie später Items oder Blöcke hinzufügen, lesen Sie das Fabric First Item-Dokument der Zielversion und passen Sie Dateipfad und Registrierungs-API an diese Version an.

7. Informationen, die beim Teilen angegeben werden sollten

Schreiben Sie Mod-ID, unterstützte Minecraft-Version, Loader- und Fabric API-Bedingungen, JDK-Anforderungen, Beispielfunktionen und die Entfernungsmethode in die README. Trennen Sie Quellcode und Distributions-JAR und fügen Sie weder das Hauptspiel noch Mod-Dateien anderer Ersteller bei. Verteilen Sie die erste Version erst, nachdem Sie überprüft haben, ob das Log im echten Launcher ausgegeben wird, und versehen Sie sie mit einer Versionsnummer wie 1.0.0.

Originaldokument und Verifizierungskriterien

Einsteiger-Anleitung, verfasst vom TroubleMaker-Betriebsteam nach Überprüfung der offiziellen Tool-Dokumentation der Ersteller am 7. Oktober 2026. Code und Diagramme sind eigene Beispiele zur Erläuterung und stellen keine Testergebnisse des tatsächlichen Gameplays dieses Spiels auf diesem Server dar. Bitte überprüfen Sie dies vor der Verbreitung in einem separaten Test-Save mit den im Text angegebenen Versionen. Vergleichen Sie die neuesten Versionen und Abhängigkeiten der einzelnen Tools unter den folgenden Quellen:

Fabric 개발 환경

Fabric 프로젝트 생성

Fabric 모드 빌드

Fabric 공식 생성기