Block Tags

Applying Tags
Testing for Tags
List of Vanilla Tags

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

Applying Tags

Block tags can be applied in the block's components, prefixed with tag:, as seen below:

BP/blocks/tree_stump.json

json

{
    "format_version": "1.21.120",
    "minecraft:block": {
        "description": {
            "identifier": "wiki:tree_stump",
            "menu_category": {
                "category": "nature"
            }
        },
        "components": {
            "tag:wood": {},
            "tag:minecraft:is_axe_item_destructible": {},
            "tag:wiki:very_useless": {}
        }
    }
}

Testing for Tags

From Block Descriptors

q.all_tags(...tags)
- Returns whether the block has all of the listed tags.
q.any_tag(...tags)
- Returns whether the block has at least one of the listed tags.

Block Descriptor

json

{
    "tags": "q.any_tag('wiki:glowing') && q.all_tags('wiki:custom_ore', 'stone')"
}

From Entities

q.block_has_all_tags(x, y, z, ...tags)
- Returns whether the block at the specified coordinates has all of the listed tags.
q.block_has_any_tag(x, y, z, ...tags)
- Returns whether the block at the specified coordinates has at least one of the listed tags.
q.relative_block_has_all_tags(x, y, z, ...tags)
- Returns whether the block at the specified offset from the entity has all of the listed tags.
q.relative_block_has_any_tag(x, y, z, ...tags)
- Returns whether the block at the specified offset from the entity has at least one of the listed tags.

minecraft:client_entity > description

json

"scripts": {
    "pre_animation": [
        "v.is_on_sand = q.relative_block_has_any_tag(0, -1, 0, 'sand');"
    ]
}

Additional Queries

NOTE: The following query functions have no known use cases.

q.block_neighbor_has_all_tags(x, y, z, ...tags)
q.block_neighbor_has_any_tag(x, y, z, ...tags)

Digger Example

Example of an item querying a block's tags:

BP/items/custom_pickaxe.json

json

{
    "format_version": "1.21.120",
    "minecraft:item": {
        "description": {
            "identifier": "wiki:custom_pickaxe",
            "menu_category": {
                "category": "equipment",
                "group": "minecraft:itemGroup.name.pickaxe"
            }
        },
        "components": {
            "minecraft:digger": {
                "use_efficiency": true,
                "destroy_speeds": [
                    {
                        "speed": 5,
                        "block": {
                            "tags": "q.any_tag('minecraft:is_pickaxe_item_destructible')"
                        }
                    }
                ]
            }
        }
    }
}

List of Vanilla Tags

Tag	Vanilla Usage	Functionality
`acacia`	`minecraft:acacia_log`
`birch`	`minecraft:birch_log`
`minecraft:cornerable_stairs`	`minecraft:acacia_stairs` `minecraft:andesite_stairs` `minecraft:bamboo_mosaic_stairs` `minecraft:bamboo_stairs` `minecraft:birch_stairs` `minecraft:blackstone_stairs` `minecraft:brick_stairs` `minecraft:cherry_stairs` `minecraft:cobbled_deepslate_stairs` `minecraft:crimson_stairs`
`minecraft:crop`	`minecraft:beetroot` `minecraft:carrots` `minecraft:pitcher_crop` `minecraft:potatoes` `minecraft:sweet_berry_bush` `minecraft:torchflower_crop` `minecraft:wheat`	Allows the block to be pollinated by entities with the `minecraft:grows_crops` component (such as bees). Given that custom blocks cannot have the `growth` state, pollination will only result in particles and sounds playing.
`dark_oak`	`minecraft:dark_oak_log`
`diamond_pick_diggable`	`minecraft:coal_ore` `minecraft:deepslate_coal_ore` `minecraft:deepslate_diamond_ore` `minecraft:deepslate_emerald_ore` `minecraft:deepslate_gold_ore` `minecraft:deepslate_iron_ore` `minecraft:deepslate_redstone_ore` `minecraft:diamond_ore` `minecraft:emerald_ore` `minecraft:gold_ore`	Deprecated — check for the `minecraft:is_pickaxe_item_destructible` and `minecraft:diamond_tier_destructible` tags instead.
`minecraft:diamond_tier_destructible`	`minecraft:ancient_debris` `minecraft:crying_obsidian` `minecraft:glowingobsidian` `minecraft:netherite_block` `minecraft:obsidian` `minecraft:respawn_anchor`	Indicates that the block must be destroyed by a tool of diamond tier or better in order to drop. This does not automatically prevent drops for custom blocks.
`dirt`	`minecraft:coarse_dirt` `minecraft:dirt` `minecraft:dirt_with_roots` `minecraft:farmland` `minecraft:grass_block` `minecraft:moss_block` `minecraft:mud` `minecraft:muddy_mangrove_roots` `minecraft:mycelium` `minecraft:pale_moss_block`	Allows trees to be placed on this block during world generation. The block will be replaced with Dirt if a tree does generate above it. Also allows some plants to be placed on the block, including Bamboo, Dead Bush, Pink Petals, Sugar Cane and Wildflowers.
`fertilize_area`	`minecraft:allium` `minecraft:azure_bluet` `minecraft:blue_orchid` `minecraft:cornflower` `minecraft:crimson_nylium` `minecraft:dandelion` `minecraft:grass_block` `minecraft:lily_of_the_valley` `minecraft:moss_block` `minecraft:orange_tulip`
`grass`	`minecraft:coarse_dirt` `minecraft:dirt` `minecraft:grass_block` `minecraft:grass_path`
`gravel`	`minecraft:gravel` `minecraft:suspicious_gravel`	Allows Bamboo to be placed on the block.
`iron_pick_diggable`	`minecraft:coal_ore` `minecraft:deepslate_coal_ore` `minecraft:deepslate_diamond_ore` `minecraft:deepslate_emerald_ore` `minecraft:deepslate_gold_ore` `minecraft:deepslate_iron_ore` `minecraft:deepslate_redstone_ore` `minecraft:diamond_ore` `minecraft:emerald_ore` `minecraft:gold_ore`	Deprecated — check for the `minecraft:is_pickaxe_item_destructible` and `minecraft:iron_tier_destructible` tags instead.
`minecraft:iron_tier_destructible`	`minecraft:deepslate_diamond_ore` `minecraft:deepslate_emerald_ore` `minecraft:deepslate_gold_ore` `minecraft:deepslate_redstone_ore` `minecraft:diamond_block` `minecraft:diamond_ore` `minecraft:emerald_block` `minecraft:emerald_ore` `minecraft:gold_block` `minecraft:gold_ore`	Indicates that the block must be destroyed by a tool of iron tier or better in order to drop. This does not automatically prevent drops for custom blocks.
`minecraft:is_axe_item_destructible`	`minecraft:acacia_button` `minecraft:acacia_door` `minecraft:acacia_double_slab` `minecraft:acacia_fence` `minecraft:acacia_fence_gate` `minecraft:acacia_hanging_sign` `minecraft:acacia_log` `minecraft:acacia_planks` `minecraft:acacia_pressure_plate` `minecraft:acacia_shelf`	Instructs axes to mine this block faster. Custom axes should check for this tag in their digger component.
`minecraft:is_hoe_item_destructible`	`minecraft:acacia_leaves` `minecraft:azalea_leaves` `minecraft:azalea_leaves_flowered` `minecraft:birch_leaves` `minecraft:calibrated_sculk_sensor` `minecraft:cherry_leaves` `minecraft:dark_oak_leaves` `minecraft:dried_kelp_block` `minecraft:hay_block` `minecraft:jungle_leaves`	Instructs hoes to mine this block faster. Custom hoes should check for this tag in their digger component.
`minecraft:is_pickaxe_item_destructible`	`minecraft:activator_rail` `minecraft:amethyst_block` `minecraft:amethyst_cluster` `minecraft:ancient_debris` `minecraft:andesite` `minecraft:andesite_double_slab` `minecraft:andesite_slab` `minecraft:andesite_stairs` `minecraft:andesite_wall` `minecraft:anvil`	Instructs pickaxes to mine this block faster. Custom pickaxes should check for this tag in their digger component.
`minecraft:is_shears_item_destructible`	`minecraft:web`	Instructs shears to mine this block faster. Custom shears should check for this tag in their digger component.
`minecraft:is_shovel_item_destructible`	`minecraft:black_concrete_powder` `minecraft:blue_concrete_powder` `minecraft:brown_concrete_powder` `minecraft:clay` `minecraft:coarse_dirt` `minecraft:cyan_concrete_powder` `minecraft:dirt` `minecraft:dirt_with_roots` `minecraft:farmland` `minecraft:grass_block`	Instructs shovels to mine this block faster. Custom shovels should check for this tag in their digger component.
`minecraft:is_sword_item_destructible`	`minecraft:web`	Instructs swords to mine this block faster. Custom swords should check for this tag in their digger component.
`jungle`	`minecraft:jungle_log`
`log`	`minecraft:acacia_log` `minecraft:birch_log` `minecraft:dark_oak_log` `minecraft:jungle_log` `minecraft:oak_log` `minecraft:spruce_log`
`metal`	`minecraft:cauldron` `minecraft:copper_bars` `minecraft:exposed_copper_bars` `minecraft:gold_block` `minecraft:iron_bars` `minecraft:iron_block` `minecraft:iron_door` `minecraft:oxidized_copper_bars` `minecraft:waxed_copper_bars` `minecraft:waxed_exposed_copper_bars`
`mob_spawner`	`minecraft:mob_spawner`
`not_feature_replaceable`	`minecraft:acacia_shelf` `minecraft:bamboo_shelf` `minecraft:bedrock` `minecraft:birch_shelf` `minecraft:cherry_shelf` `minecraft:chest` `minecraft:chiseled_bookshelf` `minecraft:copper_chest` `minecraft:crimson_shelf` `minecraft:dark_oak_shelf`
`oak`	`minecraft:oak_log`
`one_way_collidable`	`minecraft:acacia_door` `minecraft:acacia_fence_gate` `minecraft:acacia_trapdoor` `minecraft:bamboo_door` `minecraft:bamboo_fence_gate` `minecraft:bamboo_trapdoor` `minecraft:birch_door` `minecraft:birch_fence_gate` `minecraft:birch_trapdoor` `minecraft:cherry_door`	Prevents entities inside a block from being automatically pushed out of the block's collision.
`plant`	`minecraft:acacia_sapling` `minecraft:birch_sapling` `minecraft:dark_oak_sapling` `minecraft:jungle_sapling` `minecraft:large_fern` `minecraft:lilac` `minecraft:oak_sapling` `minecraft:peony` `minecraft:pitcher_crop` `minecraft:pitcher_plant`
`pumpkin`	`minecraft:carved_pumpkin` `minecraft:lit_pumpkin` `minecraft:pumpkin`
`rail`	`minecraft:activator_rail` `minecraft:detector_rail` `minecraft:golden_rail` `minecraft:rail`	Allows minecarts to be placed on the block. Causes entities with the `minecraft:rail_movement` component (such as minecarts) to snap to the block and move across it towards the north or south as long as the block does not have a collision box.
`sand`	`minecraft:red_sand` `minecraft:sand` `minecraft:suspicious_sand`	Allows cacti and sugarcane to be placed on the block.
`snow`	`minecraft:snow_layer`
`spruce`	`minecraft:spruce_log`
`stone`	`minecraft:andesite` `minecraft:andesite_wall` `minecraft:brick_block` `minecraft:brick_double_slab` `minecraft:brick_slab` `minecraft:brick_wall` `minecraft:cobblestone` `minecraft:cobblestone_double_slab` `minecraft:cobblestone_slab` `minecraft:cobblestone_wall`
`stone_pick_diggable`	`minecraft:chiseled_copper` `minecraft:copper_block` `minecraft:copper_bulb` `minecraft:copper_chest` `minecraft:copper_golem_statue` `minecraft:copper_grate` `minecraft:copper_ore` `minecraft:cut_copper` `minecraft:cut_copper_stairs` `minecraft:deepslate_copper_ore`	Deprecated — check for the `minecraft:is_pickaxe_item_destructible` and `minecraft:stone_tier_destructible` tags instead.
`minecraft:stone_tier_destructible`	`minecraft:chiseled_copper` `minecraft:copper_block` `minecraft:copper_bulb` `minecraft:copper_chest` `minecraft:copper_grate` `minecraft:copper_ore` `minecraft:copper_trapdoor` `minecraft:cut_copper` `minecraft:cut_copper_slab` `minecraft:cut_copper_stairs`	Indicates that the block must be destroyed by a tool of stone tier or better in order to drop. This does not automatically prevent drops for custom blocks.
`text_sign`	`minecraft:acacia_hanging_sign` `minecraft:acacia_standing_sign` `minecraft:acacia_wall_sign` `minecraft:bamboo_hanging_sign` `minecraft:bamboo_standing_sign` `minecraft:bamboo_wall_sign` `minecraft:birch_hanging_sign` `minecraft:birch_standing_sign` `minecraft:birch_wall_sign` `minecraft:cherry_hanging_sign`
`trapdoors`	`minecraft:acacia_trapdoor` `minecraft:bamboo_trapdoor` `minecraft:birch_trapdoor` `minecraft:cherry_trapdoor` `minecraft:copper_trapdoor` `minecraft:crimson_trapdoor` `minecraft:dark_oak_trapdoor` `minecraft:exposed_copper_trapdoor` `minecraft:iron_trapdoor` `minecraft:jungle_trapdoor`	Trapdoors are avoided by the Breeze.
`water`	`minecraft:flowing_water` `minecraft:water`	Allows Sugar Cane to be placed on horizontally adjacent blocks that have the `dirt` tag.
`wood`	`minecraft:acacia_button` `minecraft:acacia_door` `minecraft:acacia_double_slab` `minecraft:acacia_fence` `minecraft:acacia_fence_gate` `minecraft:acacia_hanging_sign` `minecraft:acacia_log` `minecraft:acacia_planks` `minecraft:acacia_pressure_plate` `minecraft:acacia_slab`