Minecraft:Block transformer definition

A block transformer contains rules for transforming blocks into another blocks. They are used by the Template:Data component link component to allow an item to transform blocks on use.

Definition

Block transformers can be defined in Minecraft:data packs, as part of the directory structure below.

JSON Format

Block transformers are defined using the following format:

• Template:Nbt The root object.<section begin="json format" />
  • Template:Nbt: The game iterates through this list until it finds an element whose Minecraft:block state provider returns a result.
    • Template:Nbt: A single object in the list.
      • Template:Nbt: A Minecraft:block state provider which provides the state for the transformed block. Only block state providers used in world generation are allowed.
        • Template:Nbt inherit/block state provider
      • Template:NbtTemplate:Nbt: Optional. Template:Json ref to play upon successful transformation. Defaults to none.
        • Template:Nbt inherit/sound event
      • Template:Nbt: Optional. The particle to use for the interaction. Can be one of Template:Cd. Defaults to Template:Cd.
      • Template:Nbt: Optional. Interacting with one of the specified faces will not transform the block.
        • Template:Nbt: An element in the list. Can be one of Template:Cd.
      • Template:Nbt: Optional. The Minecraft:loot table to use for dropping items upon successful transformation. If not present, no loot is dropped.
      • Template:Nbt: Optional. Where in the block space the dropped loot should spawn. Can be either Template:Cd (loot spawns at the center of the block space) or Template:Cd (loot spawns at the center of the face interacted with). Defaults to Template:Cd.
      • Template:Nbt: Optional. Whether the transformed block should attempt to update its state based on neighboring blocks after transformation. Defaults to Template:Cd.
      • Template:Nbt: Optional. Configures how nearby blocks should be affected by the transformation. Can be either Template:Cd (only the targeted block is affected) or Template:Cd (if input and output blocks are both copper chests of any weathering state, waxed or unwaxed, this transformation will affect both sides of a double chest).
      • Template:Nbt: Optional. Whether or not the item should be consumed upon successful transformation, if it is stackable and the player is in survival or adventure mode. Defaults to Template:Cd.
      • Template:Nbt: Optional. How much Minecraft:durability the item loses upon successful transformation, if it is not stackable and the player is in survival or adventure mode. Defaults to Template:Cd.<section end="json format" />

Vanilla usage

Vanilla uses block transformers for tools that strip, scrape, unwax, till or flatten blocks. Template:Cd is always set to Template:Cd.

Item	Blocks affected	Result	Sound	Particle	Additional properties
Template:ItemLink	Template:BlockLink, Template:BlockLink, Template:BlockLink, Template:BlockLink, and Template:BlockLink	Converts to the matching stripped variant	Template:Cd	None
	Any unwaxed oxidized state of Minecraft:copper blocks: Template:BlockLink, Template:BlockLink, Template:BlockLink, Template:BlockLink, Template:BlockLink, Template:BlockLink, Template:BlockLink, Template:BlockLink, Template:BlockLink, Template:BlockLink, Template:BlockLink, Template:BlockLink, Template:BlockLink, Template:BlockLink, and Template:BlockLink	Reduces the oxidation stage by one (oxidized → weathered → exposed → unoxidized)	Template:Cd	Template:Cd	Template:Cd: Template:Cd for doors and chests Template:Cd: Template:Cd for chests
	Waxed variant of any block listed above (all oxidation stages, including unoxidized)	Converts to the matching unwaxed variant	Template:Cd	Template:Cd
Template:ItemLink	Blocks in Template:Tag link tag with air directly above	Template:BlockLink	Template:Cd	None	Template:Cd contains Template:Cd
	Template:BlockLink with air directly above	Template:BlockLink	Template:Cd	None
	Template:BlockLink	Template:BlockLink	Template:Cd	None	Template:Cd: Template:Cd Template:Cd: Template:Cd
Template:ItemLink	Blocks in Template:Tag link tag with air directly above	Template:BlockLink	Template:Cd	None	Template:Cd contains Template:Cd