Tags

Minecraft tags

Minecraft has tags grouping multiple blocks/items/biomes/etc having similar behavior or type. For example, #minecraft:dirt contains Grass block, Podzol, Mycelium, Dirt, Coarse dirt, Rooted dirt, Mud, Moss block, Pale moss block and Muddy mangrove root.

Also, any mods or even datapacks can add their own tags. For example, #c:glass_blocks is Fabric API's tag grouping glass blocks of all kinds and colors.

You can check full list of blocks on your version by searching items by tag in the creative game mode. You can also find useful the page on the wiki about Tags and a mod to view item's tags such as Tag Tooltips.

Important: Condition config uploading will fail if a given Identifier or a Custom tag is unknown, but it cannot check whether a Tag exists. Be careful and double-check yourselves when using them.

Custom tags

In addition to the game's tags PreventBuild allows to create your own ones and use them with ##custom_tag_name format. They do not register in the game and are working simply as lists of identifiers regardless of what type (block/item/entity/etc) is needed.

It allows you to be sure about and control what identifiers are grouped by this tag and keep it the same across any game versions.

Custom tags are registered and described in the configs/preventbuild/custom_tags.json file.

{
  "some_workstations": [
    "minecraft:stonecutter",
    "minecraft:crafting_table",
    "minecraft:furnace",
    "minecraft:blast_furnace",
    "minecraft:smoker"
  ],
  "example": [
    "minecraft:stone",
    "minecraft:dirt"
  ]
}

The config contains the structure of key: [Identifiers list] pairs where the key is used to refer to the custom tag.

To update the config in game, use /pb update.