Block Tags

Block tags can be used to ensure that a block meets certain conditions.

Applying Tags

Block tags can be applied in the same way as items - in the block's components - as seen below:

BP/blocks/tree_stump.jsonCopy
json
{
  "format_version": "1.20.30",
  "minecraft:block": {
    "description": {
      "identifier": "wiki:tree_stump",
      "menu_category": {
        "category": "nature"
      }
    },
    "components": {
      "tag:wood": {},
      "tag:my_lovely_tag": {},
      "tag:wiki:very_useless": {}
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

Testing for Tags

Tags can be queried with:

  • q.all_tags
  • q.any_tag

EXPERIMENTAL

The following query functions require experimental Molang features to be enabled.

  • q.block_has_all_tags
  • q.block_has_any_tag
  • q.block_neighbor_has_all_tags
  • q.block_neighbor_has_any_tag
  • q.relative_block_has_all_tags
  • q.relative_block_has_any_tag

Example of an item querying a block's tags:

BP/items/custom_pickaxe.jsonCopy
json
{
  "format_version": "1.20.30",
  "minecraft:item": {
    "description": {
      "identifier": "wiki:custom_pickaxe",
      "menu_category": {
        "category": "equipment",
        "group": "itemGroup.name.pickaxe"
      }
    },
    "components": {
      "minecraft:digger": {
        "use_efficiency": true,
        "destroy_speeds": [
          {
            "speed": 5,
            "block": {
              "tags": "q.any_tag('custom_ore', 'stone', 'metal')"
            }
          }
        ]
      }
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

Lists of Block Tags

Vanilla Tags

Vanilla tags can be applied to custom blocks, and some vanilla blocks are tagged internally. This kind of tag doesn't give blocks vanilla features. The only usage of it is to tag blocks to make them have the same tags as the vanilla blocks for queries or tests.

TagVanilla Usage
woodOak Trapdoor, Spruce Trapdoor, Birch Trapdoor, Jungle Trapdoor, Acacia Trapdoor, Dark Oak Trapdoor, Oak Door, Spruce Door, Birch Door, Jungle Door, Acacia Door, Dark Oak Door, Oak Fence, Spruce Fence, Birch Fence, Jungle Fence, Acacia Fence, Dark Oak Fence, Oak Fence Gate, Spruce Fence Gate, Birch Fence Gate, Jungle Fence Gate, Acacia Fence Gate, Dark Oak Fence Gate, Oak Log, Spruce Log, Birch Log, Jungle Log, Acacia Log, Dark Oak Log, Oak Planks, Spruce Planks, Birch Planks, Jungle Planks, Acacia Planks, Dark Oak Planks, Oak Slab, Spruce Slab, Birch Slab, Jungle Slab, Acacia Slab, Dark Oak Slab, Oak Stairs, Spruce Stairs, Birch Stairs, Jungle Stairs, Acacia Stairs, Dark Oak Stairs, Oak Sign, Spruce Sign, Birch Sign, Jungle Sign, Acacia Sign, Dark Oak Sign, Oak Pressure Plate, Spruce Pressure Plate, Birch Pressure Plate, Jungle Pressure Plate, Acacia Pressure Plate, Dark Oak Pressure Plate, Smithing Table, Fletching Table, Barrel, Beehive, Bee Nest, Ladder
pumpkinPumpkin, Carved Pumpkin, Jack o'Lantern
plantTall Grass, Large Fern, Sunflower, Lilac, Rose Bush, Peony, Oak Sapling, Oak Sapling, Spruce Sapling, Birch Sapling, Jungle Sapling, Acacia Sapling, Dark Oak Sapling
stoneStone, Cobblestone, Mossy Cobblestone, Dripstone Block, Bricks, Cobblestone Stairs, Smooth Stone Slab, Sandstone Slab, Cobblestone Slab, Brick Slab, Stone Bricks Slab, Quartz Slab, Nether Brick Slab, Cobblestone Wall, Mossy Cobblestone Wall, Stone Brick Wall, Mossy Stone Brick Wall, Andesite Wall, Diorite Wall, Granite Wall, Sandstone Wall, Red Sandstone Wall, Brick Wall, Prismarine Wall, Nether Brick Wall, Red Nether Brick Wall, End Stone Brick Wall, Andesite, Granite, Polished Andesite, Polished Granite, Polished Diorite, Diorite
metalBlock of Gold, Block of Iron, Cauldron, Iron Bars
diamond_pick_diggableObsidian, Coal Ore, Deepslate Coal Ore, Deepslate Diamond Ore, Deepslate Emerald Ore, Deepslate Gold Ore, Deepslate Iron Ore, Deepslate Redstone Ore, Diamond Ore, Emerald Ore, Gold ore, Iron Ore, Lapis Lazuli Ore, Redstone Ore, Block of Raw Iron, Block of Raw Gold
gold_pick_diggable
iron_pick_diggableCoal Ore, Deepslate Coal Ore, Deepslate Diamond Ore, Deepslate Emerald Ore, Deepslate Gold Ore, Deepslate Iron Ore, Deepslate Redstone Ore, Diamond Ore, Emerald Ore, Gold ore, Iron Ore, Lapis Lazuli Ore, Redstone Ore, Block of Raw Iron, Block of Raw Gold
stone_pick_diggable
wood_pick_diggable
dirtFarmland
sandRed Sand, Sand
gravelGravel
grassGrass Block, Dirt, Coarse Dirt, Dirt Path
snowSnow
railRail, Powered Rail, Detector Rail, Activator Rail
waterWater
mob_spawnerSpawner
lush_plants_replaceable
azalea_log_replaceable
not_feature_replaceablechest, bedrock, end portal frame, mob spawner
text_signAll kinds of signs
minecraft:cropBeetroot, Carrot, Potato, Wheat
fertilize_areaAll types of Flowers, except Tall Flowers & Wither Rose; Crimson Nylium, Warped Nylium, Grass, Moss

Vanilla Block Tags

Vanilla block tags are tags built specifically for blocks. They can give some vanilla features to the blocks which are tagged with them.

TagVanilla UsageDescription
acaciaAcacia Log
birchBirch Log
dark_oakDark Oak Log
jungleJungle Log
logOak Log, Spruce Log, Birch Log, Jungle Log, Acacia Log, Dark Oak LogA log block.
oakOak Log
spruceSpruce Log

Contributors

QuazChickSmokeyStackTheItsNamelessMedicalJewel105SirLichvictorsigmaChikorita-LoverLuthoriusaexer0eyanasakana