Fabric Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Getting started with Data Generation ======

Data Generation is a module of Fabric API which allows you to programmatically generate Recipes, Language Files, Loot Tables, Advancements and pretty much anything with Custom Providers. Every time you modify the code that generates advancements (or anything else datagen can make like loot tables and such) you'll have to run the gradle task ''**runDatagen**'' which we will create shortly.
 
===== Enabling Data Generation =====

The recommended way to enable the data generation API is to //have// checked the ''**Data Generation**'' box when creating your project using the [[https://fabricmc.net/develop/template/|fabric template mod generator]]:

{{https://i.imgur.com/NjIARzL.png}}

Doing so would've created the gradle task ''**runDatagen**'' for us, and would've made a configuration to run in our IDE so we wouldn't have to use the terminal. The good news is it doesn't take very long to do the same manually.

===== Manually Enabling Data Generation =====

First open up your ''**build.gradle**'' file in the root folder of your project, and add the following anywhere inside that file:

<code groovy build.gradle [highlight_lines_extra="5,6,7"]>

//
// ... (The rest of the file)
//

fabricApi {
    configureDataGeneration()
}
</code>

If you're using version 1.21.4 or above, please replace the ''fabricApi'' section in the code above with the following:

<code groovy>
fabricApi {
    configureDataGeneration() {
        client = true
    }
}
</code>

Next we'll define a new class in our project ''**ExampleModDataGenerator**'' which implements ''**DataGeneratorEntrypoint**''. 

  * The ''**onInitializeDataGenerator**'' function will be called whenever the gradle task we created earlier (''**runDatagen**'') is ran. 

<code java ExampleModDataGenerator.java>
import net.fabricmc.fabric.api.datagen.v1.DataGeneratorEntrypoint;
import net.fabricmc.fabric.api.datagen.v1.FabricDataGenerator;

public class ExampleModDataGenerator implements DataGeneratorEntrypoint {

    @Override
    public void onInitializeDataGenerator(FabricDataGenerator generator) {
        // Adding a provider example:
        
        // For versions below 1.19:
        // generator.addProvider(AdvancementsProvider::new);
        
        // For versions since 1.19:
        FabricDataGenerator.Pack pack = generator.createPack();

        pack.addProvider(AdvancementsProvider::new);
    }

}
</code>

Now we need to tell fabric about this entry point in our ''**fabric.mod.json**'' file:

<code javascript fabric.mod.json [highlight_lines_extra="6,7,8"]>
{

  // ... (The rest of the file)

  "entrypoints": {
    "fabric-datagen": [
      "com.example.ExampleModDataGenerator"
    ],
    "main": [
      "com.example.ExampleMod"
    ],
    "client": [
      "com.example.ExampleModClient"
    ]
  },

  // ... (The rest of the file)

}
</code>

Before continuing further let's see if what we have so far is working, or if we have any errors. Run the ''**runDatagen**'' task. You can have your IDE do that for you, or just open the terminal in the root directory of your project and do:

<code batch Windows>
gradlew runDatagen
</code>

<code bash Linux>
./gradlew runDatagen
</code>

Read the output and make sure there are no errors.

  * You can safely ignore: ''**com.mojang.authlib.exceptions.InvalidCredentialsException: Status: 401**'' if it comes up. That error happens because the debug version of Minecraft we're running doesn't try to authenticate our account.

If you do get an error, it's usually pretty explicit about what's missing or wrong, but if you can't seem to figure it out, you might want to head over to the discord, and get some help.

There should be a new folder in ''**src/main**'' called ''**generated**''. For now it'll be empty, but once we start generating data (like advancements), that is where it'll be saved.


====== Adding Providers ======

This is a generic guide on how to add a provider, for more in depth information on each provider, see their respective pages:

  * [[tutorial:datagen_advancements|Advancements Generation]]
  * [[tutorial:datagen_loot|Loot Table Generation]]
  * [[tutorial:datagen_model|Model Generation]]
  * [[tutorial:datagen_tags|Tag Generation]]
  * [[tutorial:datagen_recipe|Recipe Generation]]
  * [[tutorial:datagen_language|Language File Generation]]

In this example, we will be creating a tag provider, as it is the simplest to understand.

Firstly, inside your ''**ExampleModDataGenerator**'' class, create a new ''**private static class**'' that extends ''**FabricTagProvider<T>**'':

//If you want, you can place this class in a separate file, but we recommend it stays in your datagen entrypoint class.//

<code java>
import net.fabricmc.fabric.api.datagen.v1.DataGeneratorEntrypoint;
import net.fabricmc.fabric.api.datagen.v1.FabricDataGenerator;
import net.fabricmc.fabric.api.datagen.v1.FabricDataOutput;
import net.fabricmc.fabric.api.datagen.v1.provider.FabricTagProvider;
import net.minecraft.item.Item;
import net.minecraft.item.Items;
import net.minecraft.registry.RegistryKeys;
import net.minecraft.registry.RegistryWrapper;
import net.minecraft.registry.tag.ItemTags;
import net.minecraft.registry.tag.TagKey;
import net.minecraft.util.Identifier;
import java.util.concurrent.CompletableFuture;

public class ExampleModDataGenerator implements DataGeneratorEntrypoint {

    @Override
    public void onInitializeDataGenerator(FabricDataGenerator generator) {
        // For versions below 1.19:
        // generator.addProvider(MyTagGenerator::new);
        
        // For versions since 1.19:        
        FabricDataGenerator.Pack pack = generator.createPack();

        pack.addProvider(MyTagGenerator::new);
    }

    private static class MyTagGenerator extends FabricTagProvider.ItemTagProvider {
        public MyTagGenerator(FabricDataOutput output, CompletableFuture<RegistryWrapper.WrapperLookup> completableFuture) {
            super(output, completableFuture);
        }

        @Override
        protected void configure(RegistryWrapper.WrapperLookup arg) {

        }
    }
}
</code>

We will add some basic tags inside ''**configure()**'' for example's sake.

<code java [highlight_lines_extra="9,15,16,17,18"]>
public class ExampleModDataGenerator implements DataGeneratorEntrypoint {

    // ... (The rest of the file)

    private static class MyTagGenerator extends FabricTagProvider.ItemTagProvider {

        // ... (The rest of the file)

        private static final TagKey<Item> SMELLY_ITEMS = TagKey.of(RegistryKeys.ITEM, new Identifier("mymod:smelly_items"));

        @Override
        protected void configure(WrapperLookup arg) {
          // This creates a tag builder, where we add slime balls, rotten flesh and everything in the minecraft:dirt item tag.
          // This will automatically generate "src/main/generated/data/tutorial/tags/items/smelly_items.json" in the "generated" folder.
          getOrCreateTagBuilder(SMELLY_ITEMS)
                  .add(Items.SLIME_BALL)
                  .add(Items.ROTTEN_FLESH)
                  .addOptionalTag(ItemTags.DIRT);
        }
    }
}
</code>

When we run ''**gradlew runDatagen**'', we should see the generated in ''**src/main/generated/data/tutorial/tags/items/smelly_items.json**'', and the item tag json should be present:

<file javascript smelly_items.json>
{
  "replace": false,
  "values": [
    "minecraft:slime_ball",
    "minecraft:rotten_flesh",
    {
      "id": "#minecraft:dirt",
      "required": false
    }
  ]
}
</file>