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" />