Minecraft:Block transformer definition: Difference between revisions
From SAS Gaming Wiki
More actions
Sync: new page from Minecraft |
Sync: updated from Minecraft |
||
| Line 24: | Line 24: | ||
**** {{nbt|string|loot}}: Optional. The [[Minecraft:loot table]] to use for dropping items upon successful transformation. If not present, no loot is dropped. | **** {{nbt|string|loot}}: Optional. The [[Minecraft:loot table]] to use for dropping items upon successful transformation. If not present, no loot is dropped. | ||
**** {{nbt|string|drop_strategy}}: Optional. Where in the block space the dropped loot should spawn. Can be either {{cd|from_middle}} (loot spawns at the center of the block space) or {{cd|clicked_face}} (loot spawns at the center of the face interacted with). Defaults to {{cd|from_middle}}. | **** {{nbt|string|drop_strategy}}: Optional. Where in the block space the dropped loot should spawn. Can be either {{cd|from_middle}} (loot spawns at the center of the block space) or {{cd|clicked_face}} (loot spawns at the center of the face interacted with). Defaults to {{cd|from_middle}}. | ||
**** {{nbt|boolean|update_from_neighbors}}: Optional. Whether the transformed block should attempt to update its state based on neighboring blocks after transformation. Defaults to {{cd|true}}. | |||
**** {{nbt|string|transform_type}}: Optional. Configures how nearby blocks should be affected by the transformation. Can be either {{cd|single_block}} (only the targeted block is affected) or {{cd|copper_chest}} (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). | **** {{nbt|string|transform_type}}: Optional. Configures how nearby blocks should be affected by the transformation. Can be either {{cd|single_block}} (only the targeted block is affected) or {{cd|copper_chest}} (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). | ||
**** {{nbt|boolean|consume_on_use}}: 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 {{cd|true}}. | **** {{nbt|boolean|consume_on_use}}: 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 {{cd|true}}. | ||
Revision as of 11:14, 28 August 2026
Template:Exclusive Template:In development
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:NbtTemplate:Nbt: Optional. Template:Json ref to play upon successful transformation. Defaults to none.
- 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" />
- Template:Nbt: A single object in the list.
- Template:Nbt: The game iterates through this list until it finds an element whose Minecraft:block state provider returns a result.