Tags
From Forge Community Wiki
Tags are generalized sets of objects in the game, used for grouping related things together and providing fast membership checks.
Declaring Your Own Groupings
Tags are declared in your mod’s datapack. For example, a TagKey<Block> with a given identifier of modid:foo/tagname will reference a tag at /data/<modid>/tags/blocks/foo/tagname.json. Tags for Blocks, Items, EntityTypes, Fluids, and GameEvents use the plural forms for their folder location while all other registries use the singular version (EntityType uses the folder entity_types while Potion would use the folder potion). Similarly, you may append to or override tags declared in other domains, such as Vanilla, by declaring your own JSONs. For example, to add your own mod’s saplings to the Vanilla sapling tag, you would specify it in /data/minecraft/tags/blocks/saplings.json, and Vanilla will merge everything into one tag at reload, if the replace option is false. If replace is true, then all entries before the json specifying replace will be removed.
Values listed that are not present will cause the tag to error unless the value is listed using an id string and required boolean set to false, as in the following example:
{
"replace": false,
"values": [
"minecraft:gold_ingot",
"mymod:my_ingot",
{
"id": "othermod:ingot_other",
"required": false
}
]
}
See the Vanilla wiki for a description of the base syntax.
There is also a Forge extension on the Vanilla syntax.
You may declare a remove array of the same format as the values array. Any values listed here will be removed from the tag. This acts as a finer grained version of the Vanilla replace option.
Using Tags In Code
Tags for all registries are automatically sent from the server to any remote clients on login and reload. Blocks, Items, EntityTypes, Fluids, and GameEvents are special cased as they have Holders allowing for available tags to be accessible through the object itself.
Tags wrappers can be created using TagKey#create where the registry the tag should belong to and the tag name are supplied. Some vanilla defined helpers are also available to create wrappers via *Tags#create where * refers to the name of the registry object. Forge wrapped registries can create a tag using ITagManager via IForgeRegistry#tags. TagKeys can then be obtained via ITagManager#createTagKey.
Forge wrapped registry objects can grab their associated holder using IForgeRegistry#getHolder. Additionally, other streamlined operations can be performed using ITagManager. Non-Forge registry objects use either Registry#getHolder or Registry#getHolderOrThrow to get the current holder.
They then can compare if the registry object has a tag using Holder#is. Tag-holding registry objects contain a method called #is in either their registry object or state-aware class to check whether the object belongs to a certain tag.
As an example:
public static final TagKey<Item> myItemTag = ItemTags.create(new ResourceLocation("mymod", "myitemgroup"));
public static final TagKey<Potion> myPotionTag = ForgeRegistries.POTIONS.tags().createTagKey(new ResourceLocation("mymod", "mypotiongroup"));
public static final TagKey<VillagerType> myVillagerTypeTag = TagKey.create(Registry.VILLAGER_TYPE, new ResourceLocation("mymod", "myvillagertypegroup"));
// In some method where stack is an ItemStack
boolean isInItemGroup = stack.is(myItemTag);
// In some method where potion is a Potion
boolean isInPotionGroup = ForgeRegistries.POTIONS.tags().getTag(myPotionTag).contains(potion);
// In some method where villagerTypeKey is a ResourceKey<VillagerType>
boolean isInVillagerTypeGroup = Registry.VILLAGER_TYPE.getHolder(villagerTypeKey).map(holder -> holder.is(myVillagerTypeTag)).orElse(false);
Migration from OreDictionary
- For recipes, tags can be used directly in the vanilla recipe format (see below)
- For matching items in code, see the section above.
- If you are declaring a new type of item grouping, follow a couple naming conventions:
- Use
domain:type/material. When the name is a common one that all modders should adopt, use theforgedomain. - For example, brass ingots should be registered under the
forge:ingots/brasstag, and cobalt nuggets under theforge:nuggets/cobalttag.
- Use
Using Tags in Recipes and Advancements
Tags are directly supported by Vanilla, see the respective Vanilla wiki pages for recipes and advancements for usage details.
Conventions
There are several conventions that will help facilitate compatibility in the ecosystem:
* If there is a Vanilla tag that fits your block or item, add it to that tag. See the list of Vanilla tags. * If there is a Forge tag that fits your block or item, add it to that tag. The list of tags declared by Forge can be seen on GitHub. * If there is a group of something you feel should be shared by the community, consider PR-ing it to Forge instead of making your own tag * Tag naming conventions should follow Vanilla conventions. In particular, item and block groupings are plural instead of singular. E.g.minecraft:logs,minecraft:saplings. * Item tags should be sorted into subdirectories according to the type of item, e.g.forge:ingots/iron,forge:nuggets/brass, etc.
Forge Tags
This is a list of all tags using the forge namespace that are currently defined by Forge along those that are commonly used by other mods. These can all be found within the Tags class.
Important
Tags that are not officially defined within the Forge codebase will have
* as a suffix. To use those outside the Forge codebase, an IOptionalNamedTag must be created using *Tags#createOptional where the asterisk can be replaced by its associated class name.Blocks
| Name | Super Tag(s) | Contains |
|---|---|---|
forge:barrels |
None | Barrels |
forge:barrels/wooden |
forge:barrels |
Wooden barrels |
forge:chests |
None | Chests |
forge:chests/ender |
forge:chests |
Ender chests |
forge:chests/trapped |
forge:chests |
Trapped chests |
forge:chests/wooden |
forge:chests |
Wooden chests |
forge:cobblestone |
None | Cobblestones |
forge:cobblestone/normal |
forge:cobblestone |
Normal cobblestones |
forge:cobblestone/infested |
forge:cobblestone |
Infested cobblestones |
forge:cobblestone/mossy |
forge:cobblestone |
Mossy cobblestones |
forge:cobblestone/deepslate |
forge:cobblestone |
Deepslate cobblestones |
forge:end_stones |
None | End stones |
forge:enderman_place_on_blacklist |
None | Blocks that an enderman cannot place its held block on |
forge:fence_gates |
None | Fence gates |
forge:fence_gates/wooden |
forge:fence_gates |
Wooden fence gates |
forge:fences |
None | Fences |
forge:fences/nether_brick |
forge:fences |
Nether brick fences |
forge:fences/wooden |
forge:fences |
Wooden fences |
forge:glass |
None | Glass |
forge:glass/black |
None | Black glass |
forge:glass/blue |
None | Blue glass |
forge:glass/brown |
None | Brown glass |
forge:glass/colorless |
forge:glass |
Normal glass |
forge:glass/cyan |
None | Cyan glass |
forge:glass/gray |
None | Gray glass |
forge:glass/green |
None | Green glass |
forge:glass/light_blue |
None | Light blue glass |
forge:glass/light_gray |
None | Light gray glass |
forge:glass/lime |
None | Lime glass |
forge:glass/magenta |
None | Magenta glass |
forge:glass/orange |
None | Orange glass |
forge:glass/pink |
None | Pink glass |
forge:glass/purple |
None | Purple glass |
forge:glass/red |
None | Red glass |
forge:glass/silica |
None | Sand-based glass with minor ingredient variation |
forge:glass/tinted |
forge:glass |
Tinted glass |
forge:glass/white |
None | White glass |
forge:glass/yellow |
None | Yellow glass |
forge:glass_panes |
None | Glass panes |
forge:glass_panes/black |
None | Black glass panes |
forge:glass_panes/blue |
None | Blue glass panes |
forge:glass_panes/brown |
None | Brown glass panes |
forge:glass_panes/colorless |
forge:glass_panes |
Normal glass panes |
forge:glass_panes/cyan |
None | Cyan glass panes |
forge:glass_panes/gray |
None | Gray glass panes |
forge:glass_panes/green |
None | Green glass panes |
forge:glass_panes/light_blue |
None | Light blue glass panes |
forge:glass_panes/light_gray |
None | Light gray glass panes |
forge:glass_panes/lime |
None | Lime glass panes |
forge:glass_panes/magenta |
None | Magenta glass panes |
forge:glass_panes/orange |
None | Orange glass panes |
forge:glass_panes/pink |
None | Pink glass panes |
forge:glass_panes/purple |
None | Purple glass panes |
forge:glass_panes/red |
None | Red glass panes |
forge:glass_panes/white |
None | White glass panes |
forge:glass_panes/yellow |
None | Yellow glass panes |
forge:gravel |
None | Gravel |
forge:netherrack |
None | Netherrack |
forge:obsidian |
None | Obsidian |
forge:ore_bearing_ground/deepslate |
None | Blocks replaced by deepslate ores during world generation |
forge:ore_bearing_ground/netherrack |
None | Blocks replaced by netherrack ores during world generation |
forge:ore_bearing_ground/stone |
None | Blocks replaced by stone ores during world generation |
forge:ore_rates/dense |
None | Ores which produce numerous resources on average |
forge:ore_rates/singular |
None | Ores which produce a single resource on average |
forge:ore_rates/sparse |
None | Ores which produce less than a single resource on average |
forge:ores |
None | Ores |
forge:ores/coal |
forge:ores |
Coal ores |
forge:ores/copper |
forge:ores |
Copper ores |
forge:ores/diamond |
forge:ores |
Diamond ores |
forge:ores/emerald |
forge:ores |
Emerald ores |
forge:ores/gold |
forge:ores |
Gold ores |
forge:ores/lapis |
forge:ores |
Lapis ores |
forge:ores/netherite_scrap |
forge:ores |
Netherite scrap ores |
forge:ores/quartz |
forge:ores |
Quartz ores |
forge:ores/redstone |
forge:ores |
Redstone ores |
forge:ores_in_ground/deepslate |
None | Ores which can be found in deepslate |
forge:ores_in_ground/netherrack |
None | Ores which can be found in netherrack |
forge:ores_in_ground/stone |
None | Ores which can be found in stone |
forge:sand |
None | Sand |
forge:sand/colorless |
forge:sand |
Normal sand |
forge:sand/red |
forge:sand |
Red sand |
forge:sandstone |
None | Sandstone |
forge:stained_glass |
forge:glass |
Stained glass |
forge:stained_glass_panes |
forge:glass_panes |
Stained glass planes |
forge:stone |
None | Stones |
forge:storage_blocks |
None | Storage blocks |
forge:storage_blocks/amethyst |
forge:storage_blocks |
Amethyst blocks |
forge:storage_blocks/coal |
forge:storage_blocks |
Coal blocks |
forge:storage_blocks/copper |
forge:storage_blocks |
Copper blocks |
forge:storage_blocks/diamond |
forge:storage_blocks |
Diamond blocks |
forge:storage_blocks/emerald |
forge:storage_blocks |
Emerald blocks |
forge:storage_blocks/gold |
forge:storage_blocks |
Gold blocks |
forge:storage_blocks/iron |
forge:storage_blocks |
Iron blocks |
forge:storage_blocks/lapis |
forge:storage_blocks |
Lapis blocks |
forge:storage_blocks/netherite |
forge:storage_blocks |
Netherite blocks |
forge:storage_blocks/quartz |
forge:storage_blocks |
Quartz blocks |
forge:storage_blocks/raw_copper |
forge:storage_blocks |
Raw copper blocks |
forge:storage_blocks/raw_gold |
forge:storage_blocks |
Raw gold blocks |
forge:storage_blocks/raw_iron |
forge:storage_blocks |
Raw iron blocks |
forge:storage_blocks/redstone |
forge:storage_blocks |
Redstone blocks |
forge:needs_wood_tool |
None | Blocks which need a wooden tool to be mined efficiently |
forge:needs_gold_tool |
None | Blocks which need a gold tool to be mined efficiently |
forge:needs_netherite_tool |
None | Blocks which need a netherite tool to be mined efficiently |
Items
| Name | Super Tag(s) | Contains |
|---|---|---|
forge:barrels |
None | Barrels |
forge:barrels/wooden |
forge:barrels |
Wooden barrels |
forge:bones |
None | Bones |
forge:bookshelves |
None | Bookshelves |
forge:chests |
None | Chests |
forge:chests/ender |
forge:chests |
Ender chests |
forge:chests/trapped |
forge:chests |
Trapped chests |
forge:chests/wooden |
forge:chests |
Wooden chests |
forge:cobblestone |
None | Cobblestones |
forge:cobblestone/normal |
forge:cobblestone |
Normal cobblestones |
forge:cobblestone/infested |
forge:cobblestone |
Infested cobblestones |
forge:cobblestone/mossy |
forge:cobblestone |
Mossy cobblestones |
forge:cobblestone/deepslate |
forge:cobblestone |
Deepslate cobblestones |
forge:crops |
None | Crops |
forge:crops/beetroot |
forge:crops |
Beetroot crops |
forge:crops/carrot |
forge:crops |
Carrot crops |
forge:crops/nether_wart |
forge:crops |
Nether wart crops |
forge:crops/potato |
forge:crops |
Potato crops |
forge:crops/wheat |
forge:crops |
Wheat crops |
forge:dusts |
None | Dusts |
forge:dusts/prismarine |
forge:dusts |
Prismarine dusts |
forge:dusts/redstone |
forge:dusts |
Redstone dusts |
forge:dusts/glowstone |
forge:dusts |
Glowstone dusts |
forge:dyes |
None | Dyes |
forge:dyes/black |
forge:dyes |
Black dyes |
forge:dyes/blue |
forge:dyes |
Blue dyes |
forge:dyes/brown |
forge:dyes |
Brown dyes |
forge:dyes/cyan |
forge:dyes |
Cyan dyes |
forge:dyes/gray |
forge:dyes |
Gray dyes |
forge:dyes/green |
forge:dyes |
Green dyes |
forge:dyes/light_blue |
forge:dyes |
Light blue dyes |
forge:dyes/light_gray |
forge:dyes |
Light green dyes |
forge:dyes/lime |
forge:dyes |
Lime dyes |
forge:dyes/magenta |
forge:dyes |
Magenta dyes |
forge:dyes/orange |
forge:dyes |
Orange dyes |
forge:dyes/pink |
forge:dyes |
Pink dyes |
forge:dyes/purple |
forge:dyes |
Purple dyes |
forge:dyes/red |
forge:dyes |
Red dyes |
forge:dyes/white |
forge:dyes |
White dyes |
forge:dyes/yellow |
forge:dyes |
Yellow dyes |
forge:eggs |
None | Eggs |
forge:enchanting_fuels |
None | Enchantment table fuels |
forge:end_stones |
None | End stones |
forge:ender_pearls |
None | Ender pearls |
forge:feathers |
None | Feathers |
forge:fence_gates |
None | Fence gates |
forge:fence_gates/wooden |
forge:fence_gates |
Wooden fence gates |
forge:fences |
None | Fences |
forge:fences/nether_brick |
forge:fences |
Nether brick fences |
forge:fences/wooden |
forge:fences |
Wooden fences |
forge:gems |
None | Gems |
forge:gems/amethyst |
forge:gems |
Amethyst gems |
forge:gems/diamond |
forge:gems |
Diamond gems |
forge:gems/emerald |
forge:gems |
Emerald gems |
forge:gems/lapis |
forge:gems forge:enchanting_fuels |
Lapis gems |
forge:gems/prismarine |
forge:gems |
Prismarine gems |
forge:gems/quartz |
forge:gems |
Quartz gems |
forge:glass |
None | Glass |
forge:glass/black |
None | Black glass |
forge:glass/blue |
None | Blue glass |
forge:glass/brown |
None | Brown glass |
forge:glass/colorless |
forge:glass |
Normal glass |
forge:glass/cyan |
None | Cyan glass |
forge:glass/gray |
None | Gray glass |
forge:glass/green |
None | Green glass |
forge:glass/light_blue |
None | Light blue glass |
forge:glass/light_gray |
None | Light gray glass |
forge:glass/lime |
None | Lime glass |
forge:glass/magenta |
None | Magenta glass |
forge:glass/orange |
None | Orange glass |
forge:glass/pink |
None | Pink glass |
forge:glass/purple |
None | Purple glass |
forge:glass/red |
None | Red glass |
forge:glass/silica |
None | Sand-based glass with minor ingredient variation |
forge:glass/tinted |
forge:glass |
Tinted glass |
forge:glass/white |
None | White glass |
forge:glass/yellow |
None | Yellow glass |
forge:glass_panes |
None | Glass panes |
forge:glass_panes/black |
None | Black glass panes |
forge:glass_panes/blue |
None | Blue glass panes |
forge:glass_panes/brown |
None | Brown glass panes |
forge:glass_panes/colorless |
forge:glass_panes |
Normal glass panes |
forge:glass_panes/cyan |
None | Cyan glass panes |
forge:glass_panes/gray |
None | Gray glass panes |
forge:glass_panes/green |
None | Green glass panes |
forge:glass_panes/light_blue |
None | Light blue glass panes |
forge:glass_panes/light_gray |
None | Light gray glass panes |
forge:glass_panes/lime |
None | Lime glass panes |
forge:glass_panes/magenta |
None | Magenta glass panes |
forge:glass_panes/orange |
None | Orange glass panes |
forge:glass_panes/pink |
None | Pink glass panes |
forge:glass_panes/purple |
None | Purple glass panes |
forge:glass_panes/red |
None | Red glass panes |
forge:glass_panes/white |
None | White glass panes |
forge:glass_panes/yellow |
None | Yellow glass panes |
forge:gravel |
None | Gravel |
forge:gunpowder |
None | Gunpowder |
forge:heads |
None | Heads |
forge:ingots |
None | Ingots |
forge:ingots/brick |
forge:ingots |
Brick ingots |
forge:ingots/copper |
forge:ingots |
Copper ingots |
forge:ingots/gold |
forge:ingots |
Gold ingots |
forge:ingots/iron |
forge:ingots |
Iron ingots |
forge:ingots/netherite |
forge:ingots |
Netherite ingots |
forge:ingots/nether_brick |
forge:ingots |
Nether brick ingots |
forge:leather |
None | Leather |
forge:mushrooms |
None | Mushrooms |
forge:nether_stars |
None | Nether stars |
forge:netherrack |
None | Netherrack |
forge:nuggets |
None | Nuggets |
forge:nuggets/gold |
forge:nuggets |
Gold nuggets |
forge:nuggets/iron |
forge:nuggets |
Iron nuggets |
forge:obsidian |
None | Obsidian |
forge:ore_bearing_ground/deepslate |
None | Blocks replaced by deepslate ores during world generation |
forge:ore_bearing_ground/netherrack |
None | Blocks replaced by netherrack ores during world generation |
forge:ore_bearing_ground/stone |
None | Blocks replaced by stone ores during world generation |
forge:ore_rates/dense |
None | Ores which produce numerous resources on average |
forge:ore_rates/singular |
None | Ores which produce a single resource on average |
forge:ore_rates/sparse |
None | Ores which produce less than a single resource on average |
forge:ores |
None | Ores |
forge:ores/coal |
forge:ores |
Coal ores |
forge:ores/copper |
forge:ores |
Copper ores |
forge:ores/diamond |
forge:ores |
Diamond ores |
forge:ores/emerald |
forge:ores |
Emerald ores |
forge:ores/gold |
forge:ores |
Gold ores |
forge:ores/lapis |
forge:ores |
Lapis ores |
forge:ores/netherite_scrap |
forge:ores |
Netherite scrap ores |
forge:ores/quartz |
forge:ores |
Quartz ores |
forge:ores/redstone |
forge:ores |
Redstone ores |
forge:ores_in_ground/deepslate |
None | Ores which can be found in deepslate |
forge:ores_in_ground/netherrack |
None | Ores which can be found in netherrack |
forge:ores_in_ground/stone |
None | Ores which can be found in stone |
forge:raw_materials |
None | Raw materials |
forge:raw_materials/copper |
forge:raw_materials |
Copper raw materials |
forge:raw_materials/gold |
forge:raw_materials |
Gold raw materials |
forge:raw_materials/iron |
forge:raw_materials |
Iron raw materials |
forge:rods |
None | Rods |
forge:rods/blaze |
forge:rods |
Blaze rods |
forge:rods/wooden |
forge:rods |
Wooden rods |
forge:sand |
None | Sand |
forge:sand/colorless |
forge:sand |
Normal sand |
forge:sand/red |
forge:sand |
Red sand |
forge:sandstone |
None | Sandstone |
forge:seeds |
None | Seeds |
forge:seeds/beetroot |
forge:seeds |
Beetroot seeds |
forge:seeds/melon |
forge:seeds |
Melon seeds |
forge:seeds/pumpkin |
forge:seeds |
Pumpkin seeds |
forge:seeds/wheat |
forge:seeds |
Wheat seeds |
forge:shears |
None | Shears |
forge:slimeballs |
None | Slimeballs |
forge:stained_glass |
forge:glass |
Stained glass |
forge:stained_glass_panes |
forge:glass_panes |
Stained glass planes |
forge:stone |
None | Stones |
forge:storage_blocks |
None | Storage blocks |
forge:storage_blocks/amethyst |
forge:storage_blocks |
Amethyst blocks |
forge:storage_blocks/coal |
forge:storage_blocks |
Coal blocks |
forge:storage_blocks/copper |
forge:storage_blocks |
Copper blocks |
forge:storage_blocks/diamond |
forge:storage_blocks |
Diamond blocks |
forge:storage_blocks/emerald |
forge:storage_blocks |
Emerald blocks |
forge:storage_blocks/gold |
forge:storage_blocks |
Gold blocks |
forge:storage_blocks/iron |
forge:storage_blocks |
Iron blocks |
forge:storage_blocks/lapis |
forge:storage_blocks |
Lapis blocks |
forge:storage_blocks/netherite |
forge:storage_blocks |
Netherite blocks |
forge:storage_blocks/quartz |
forge:storage_blocks |
Quartz blocks |
forge:storage_blocks/raw_copper |
forge:storage_blocks |
Raw copper blocks |
forge:storage_blocks/raw_gold |
forge:storage_blocks |
Raw gold blocks |
forge:storage_blocks/raw_iron |
forge:storage_blocks |
Raw iron blocks |
forge:storage_blocks/redstone |
forge:storage_blocks |
Redstone blocks |
forge:string |
None | String |
Fluids
| Name | Super Tag(s) | Contains |
|---|---|---|
forge:milk |
None | Milk |
Community Tags
This is a list of all tags in the Forge namespace that are not part of Forge but agreed on by the modding community as the standard.
Blocks
| Name | Super Tag(s) | Contains |
|---|---|---|
forge:storage_blocks/honeycombs |
forge:storage_blocks |
Honeycomb blocks |
forge:storage_blocks/wax |
forge:storage_blocks |
Wax blocks |
Items
| Name | Super Tag(s) | Contains |
|---|---|---|
forge:buckets/honey |
None | Buckets holding honey fluids |
forge:concrete |
None | Concrete |
forge:concrete_powder |
None | Concrete Powder |
forge:honeycombs |
None | Honeycombs |
forge:honey_bottles |
None | Honey bottles |
forge:glazed_terracotta |
None | Glazed Terracotta |
forge:pollen |
None | Pollen |
forge:shulker_boxes |
None | Shulker Boxes |
forge:storage_blocks/honeycombs |
forge:storage_blocks |
Honeycomb blocks |
forge:storage_blocks/wax |
forge:storage_blocks |
Wax blocks |
forge:wax |
None | Wax |
Fluids
| Name | Super Tag(s) | Contains |
|---|---|---|
forge:honey |
None | Honey |