Einrichtung der Datengenerierung
Ein Leitfaden zur Einrichtung der Datengenerierung mit der Fabric API.
WARNING
Diese Seite ist für die Version 1.21.10 geschrieben. Dokumentationen für ältere Versionen sind möglicherweise unvollständig.
Was ist Datengenerierung?
Datengenerierung (oder datagen) ist eine API für das programmatische generieren von Rezepten, Fortschritten, Tags, Itemmodellen, Sprachdateien, Beutetabllen und im Grunde allem auf JSON Basis.
Aktivieren der Datengenerierung
Bei der Projekterstellung
Der leichteste Weg die Datengenerierung zu aktivieren ist bei der Projekterstellung. Aktiviere das Kontrollkästchen "Enable Data Generation", wenn du den Vorlagengenerator verwendest.
TIP
Wenn die Datengenerierung aktiviert ist, solltest du eine "Data Generation" Laufkonfiguration udn einen runDatagen Gradle Task haben.
Manuell
Zuerst müssen wir die Datengenerierung in der build.Gradle-Datei aktivieren.
fabricApi {
configureDataGeneration() {
client = true
}
}Als nächstes, benötigen wir eine Klasse für den Einstiegspunkt. Dies ist dort, wo unsere Datengenerierung startet. Platziere diese irgendwo in dem client Packet - dieses Beispiel platziert diese in src/client/java/com/example/docs/datagen/ExampleModDataGenerator.java.
public class ExampleModDataGenerator implements DataGeneratorEntrypoint {
@Override
public void onInitializeDataGenerator(FabricDataGenerator fabricDataGenerator) {
}
}Schließlich müsen wir Fabric in der fabric.mod.json über den Einstiegspunkt informieren:
{
// ...
"entrypoints": {
// ...
"client": [
// ...
],
"fabric-datagen": [
"com.example.docs.datagen.ExampleModDataGenerator"
]
}
}WARNING
Vergesse nicht, ein Komma (,) nach dem vorherigen Einstiegspunkt-Block hinzuzufügen!
Schließe IntelliJ und öffne es erneut, um eine Laufkonfiguration für die Datengenerierung zu erstellen.
Ein Packet erstellen
Innerhalb der Methode onInitializeDataGenerator deines Einstiegspunktes für die Datengenerierung m+ssen wir ein Pack erstellen. Später fügst du Provider hinzu, die generierte Daten in dieses Pack einfügen.
FabricDataGenerator.Pack pack = fabricDataGenerator.createPack();Ausführen des Datengenerators
Um die Datengenerierung auszuführen, nutze die Laufkonfiguration in deiner IDE oder führe in der Konsole ./gradlew runDatagen aus. Die generierten Dateien werden in src/main/generated erstellt.
Nächste Schritte
Nachdem der Datengenerator nun eingerichtet ist, müssen wir Provider hinzufügen. Diese erzeugen die Daten, die du zu deinem Pack hinzufügst. Auf den folgenden Seiten wird beschrieben, wie du dies tun kannst.