Edit

Share via


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.

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 not set 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 not set 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 item type

Use On Properties

Name Default Value Type Description Example Values
name not set String
states not set Integer number
states (Alternate 1) not set String
states (Alternate 2) not set Boolean true/false
tags not set 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"
  ]
}