Tag Generation 1.21.1

A guide to setting up tag generation with datagen.

WARNING

This page is written for version 1.21.1. Documentation for older versions may be incomplete.

PREREQUISITES

Make sure you've completed the datagen setup process first.

Setup

First, create your own class that extends FabricTagProvider<T>, where T is the type of thing you'd like to provide a tag for. This is your provider. Here we'll show how to create Item tags, but the same principal applies for other things. Let your IDE fill in the required code, then replace the registryKey constructor parameter with the ResourceKey for your type:

public class ExampleModItemTagProvider extends FabricTagProvider<Item> {
	public ExampleModItemTagProvider(FabricDataOutput output, CompletableFuture<HolderLookup.Provider> registriesFuture) {
		super(output, Registries.ITEM, registriesFuture);
	}

	@Override
	protected void addTags(HolderLookup.Provider wrapperLookup) {
	}
}

NOTE

You will need a different provider for each type of tag (eg. one FabricTagProvider<EntityType<?>> and one FabricTagProvider<Item>).

To finish setup, add this provider to your DataGeneratorEntrypoint within the onInitializeDataGenerator method.

pack.addProvider(ExampleModRecipeProvider::new);

Creating a Tag

Now that you've created a provider, let's add a tag to it. First, create a TagKey<T>:

public static final TagKey<Item> SMELLY_ITEMS = TagKey.create(Registries.ITEM, ResourceLocation.fromNamespaceAndPath(ExampleMod.MOD_ID, "smelly_items"));

Next, call getOrCreateTagBuilder inside your provider's configure method. From there, you can add individual items, add other tags, or make this tag replace pre-existing tags.

If you want to add a tag, use addOptionalTag, as the tag's contents may not be loaded during datagen. If you are certain the tag is loaded, call addTag.

To forcefully add a tag and ignore the broken format, use forceAddTag.

getOrCreateTagBuilder(SMELLY_ITEMS)
		.add(Items.SLIME_BALL)
		.add(Items.ROTTEN_FLESH)
		.addOptionalTag(ItemTags.DIRT)
		.add(ResourceLocation.withDefaultNamespace("oak_planks"))
		.forceAddTag(ItemTags.BANNERS)
		.setReplace(true);