Items Documentation - minecraft:block_placer

Sets the item as a planter item component for blocks. Items with this component will place a block when used.

Note

This component can also be used instead of the minecraft:icon component to render the block this item will place as the icon.

Note

This item requires a format version of at least 1.21.50.

Item Components Block Placer Properties

Name Default Value Type Description Example Values
block not set Object Defines the block that will be placed. My Sword Singing: "minecraft:dirt"
replace_block_item false Boolean true/false If true, the item will be registered as the item for this block. This item will be returned by default when the block is broken/picked. Note: the identifier for this item must match the block's identifier for this field to be valid.
use_on (Use On) [] Array of Use On items List of block descriptors of the blocks that this item can be used on. If left empty, all blocks will be allowed. My Sword Singing: ["dirt","grass","anvil"]
use_on (Alternate 1) not set String
use_on (Alternate 2) not set Object

Use On

Use On Properties

Name Default Value Type Description Example Values
name String
states {} Integer number
states (Alternate 1) not set String
states (Alternate 2) not set Boolean true/false
tags String

Samples

"minecraft:block_placer": {
  "block": "seeds",
  "use_on": [
    "dirt",
    "grass"
  ],
  "replace_block_item": true
}

My Sword Singing

"minecraft:block_placer": {
  "block": "minecraft:dirt",
  "use_on": [
    "dirt",
    "grass",
    "anvil"
  ]
}