How to Make a Tag

Section

What are Tags

Tag elements give mod creators a way to group vanilla, mod or other creator mods to a group. Tags can then be used to share recipes or groups or items in procedures. There are a bunch of settings and a few ways to configure your tag so let's get started.

Naming

Tag

If your mod is made for Minecraft versions higher than 1.13.2 you will want to make sure Tag Namespaces are set up properly. Tags can be used for blocks and items like Ore Dictionary, but aside from that tags can also be used in procedures or in other MCreator elements.

Valid names

  • acacia_log
  • lava
  • oakboat

Ore Dictionary

If your mod is made for Minecraft versions lower than 1.12.2 you don't need to configure Tag Namespaces. Ore Dictionary only has support for items and blocks. Also, the Ore Dictionary has support for capital letters, not just lowercase letters.

Valid names

  • acacia_log
  • Lava
  • oakBoat

Tag Namespace

Tag Namespaces have three option, this setting defines the way the tag will function. Read the settings below to further understand what each setting offers and can be used for.

  • Forge: is a replacement for Ore Dictionary for tags. They can be used to give other mod creators access to their mod with your mod if you provide them with the tag name.
  • Minecraft: is used to add custom blocks or items to vanilla tag groups. For example, adding your mod logs to Minecraft's log group.
  • Mod: is used for grouping things in your mod only.

Tag Type

Tag Namespaces have three option, this setting defines the way the tag will function. Read the settings below to further understand what each setting offers and can be used for.

  • Items: both Tags and Ore Dictionary can use the item type.
  • Blocks: only use the block type if you are targeting a block. Ore Dictionary does not have support for this type.
  • Functions: only use this for Tags. This is used for tagging functions into groups. One such group is called "tick" from the "Minecraft" namespace listed above. Functions tagged under the "tick" namespace will be executed each game tick.

Procedures Use

When you are working with procedures you can also test for tags for both blocks and items, using the namespace followed by a colon then tag name.

  • Use the namespace "forge:" with a colon then the tag name to test for tags from other mods.
    (To use this one your item or block must be under the "forge" namespace)
  • Use the namespace "minecraft:" with a colon then the tag name to test for tags from Minecraft.
    (To use this one your item or block must be under the "minecraft" namespace)
  • Use the namespace "mod_id:" with a colon then the tag name to test for tags from your mod. 
    (To use this one your item or block must be under the "mod" namespace)

Examples

  • forge:copper_ingot - This will test for a tag used by another mod called "copper_ingot"
  • minecraft:logs - This will test for a tag that Minecraft uses called "logs"
  • ruby_craft:ruby - This will test for a tag in your mod that is part of the tag "ruby"

Tag procedure example

Video tutorial

If you prefer to watch the video, you can find the wiki page above summarized in a video:



Donate to MCreator

By donating to developers you can speed up development, as with more resources, we can dedicate more time to MCreator. It is a free project made by developers working on it in their free time.