Minecraft:Block components - Revision history

SyncBot: Sync: updated from Minecraft

2026-05-22T11:03:40Z

Sync: updated from Minecraft

@@ Line 56: / Line 56: @@
 == Component types ==
 === <code>minecraft:block_entity</code> ===
-{{In development|be||26.30|section=1}}
+{{In development|be||26.30||experimental=Upcoming Creator Features|section=1}}
 This component is used to define whether a block has an associated [[Minecraft:block entity]]. This component can not be specified in entries in the {{cd|permutations}} array.
@@ Line 442: / Line 442: @@
    },
    "uv_lock": ["bottom"]
+}
 </syntaxhighlight>

SyncBot: Sync: updated from Minecraft

2026-05-21T11:05:03Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:05, 21 May 2026
Line 362:		Line 362:
	** ''Optional.'' The chance the block is destroyed while on fire. Default is 20.		** ''Optional.'' The chance the block is destroyed while on fire. Default is 20.
	** If 0, the block will not be destroyed by fire.		** If 0, the block will not be destroyed by fire.
	* '''{{cd\|lava_flammable}}'''{{Upcoming\|be 26.30}}:~~{{OnlyExperimental\|Upcoming Creator Features}}~~		* '''{{cd\|lava_flammable}}'''{{Upcoming\|be 26.30}}:
	** ''Optional.'' Can be {{cd\|always}} and {{cd\|never}}.		** ''Optional.'' Can be {{cd\|always}} and {{cd\|never}}.
	** when {{cd\|always}} the block always burns like [[Minecraft:lava]] when {{cd\|never}} it never burns like small [[Minecraft:flowers]].		** when {{cd\|always}} the block always burns like [[Minecraft:lava]] when {{cd\|never}} it never burns like small [[Minecraft:flowers]].
Line 1,025:		Line 1,025:
	\|{{HistoryLine\|\|26.30\|dev=Preview 26.30.27\|Released the {{cd\|culling_shape}} field in the [[#minecraft:geometry\|{{cd\|minecraft:geometry}}]] component from behind the Voxel Shapes experiment. Non-unit-cube culling shapes for certain blocks (e.g. [[Minecraft:fence]]s, [[Minecraft:bell]]s, [[Minecraft:slab]]s) still require the experiment.\|Released the snowlogging behavior for [[#minecraft:precipitation_interactions\|{{cd\|minecraft:precipitation_interactions}}]] component out of experimental.}}		\|{{HistoryLine\|\|26.30\|dev=Preview 26.30.27\|Released the {{cd\|culling_shape}} field in the [[#minecraft:geometry\|{{cd\|minecraft:geometry}}]] component from behind the Voxel Shapes experiment. Non-unit-cube culling shapes for certain blocks (e.g. [[Minecraft:fence]]s, [[Minecraft:bell]]s, [[Minecraft:slab]]s) still require the experiment.\|Released the snowlogging behavior for [[#minecraft:precipitation_interactions\|{{cd\|minecraft:precipitation_interactions}}]] component out of experimental.}}
	\|{{HistoryLine\|\|26.30\|dev=Preview 26.30.28\|exp=Upcoming Creator Features\|Added the [[#minecraft:block_entity\|{{cd\|minecraft:block_entity}}]] block component. It has a single boolean field {{cd\|dynamic_properties}}, when a block with a {{cd\|minecraft:block_entity}} is placed in the world, an associated block-entity will be placed with the intent.}}		\|{{HistoryLine\|\|26.30\|dev=Preview 26.30.28\|exp=Upcoming Creator Features\|Added the [[#minecraft:block_entity\|{{cd\|minecraft:block_entity}}]] block component. It has a single boolean field {{cd\|dynamic_properties}}, when a block with a {{cd\|minecraft:block_entity}} is placed in the world, an associated block-entity will be placed with the intent.}}
			\|{{HistoryLine\|\|\|dev=Preview 26.30.29\|Added the component [[Minecraft:Block components#minecraft:instrument_sound\|{{cd\|minecraft:instrument_sound}}]] it can be used to assign an instrument to "up" and "down" faces of a custom block, all current instruments can be used to define a sound.}}
			\|{{HistoryLine\|\|26.30\|dev=Preview 26.30.29\|The {{cd\|lava_flammable}} field of the [[#minecraft:flammable\|{{cd\|minecraft:flammable}}]] component is now usable without the Experimental Upcoming Creator Features.}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-05-16T11:03:16Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:03, 16 May 2026
Line 55:		Line 55:

	== Component types ==		== Component types ==
			=== <code>minecraft:block_entity</code> ===
			{{In development\|be\|\|26.30\|section=1}}
			This component is used to define whether a block has an associated [[Minecraft:block entity]]. This component can not be specified in entries in the {{cd\|permutations}} array.

			Fields:

			* '''{{cd\|dynamic_properties}}''':
			** Can be {{cd\|true}} or {{cd\|false}} determines whether the block entity will store properties, if {{cd\|true}} the block gains the internal component {{cd\|minecraft:dynamic_properties}}.

			Example:
			<syntaxhighlight lang=json copy>
			"minecraft:block_entity":{
			"dynamic_properties": true
			}
			</syntaxhighlight>

	=== <code>minecraft:chest_obstruction</code> ===		=== <code>minecraft:chest_obstruction</code> ===
Line 347:		Line 362:
	** ''Optional.'' The chance the block is destroyed while on fire. Default is 20.		** ''Optional.'' The chance the block is destroyed while on fire. Default is 20.
	** If 0, the block will not be destroyed by fire.		** If 0, the block will not be destroyed by fire.
			* '''{{cd\|lava_flammable}}'''{{Upcoming\|be 26.30}}:{{OnlyExperimental\|Upcoming Creator Features}}
			** ''Optional.'' Can be {{cd\|always}} and {{cd\|never}}.
			** when {{cd\|always}} the block always burns like [[Minecraft:lava]] when {{cd\|never}} it never burns like small [[Minecraft:flowers]].

	Example:		Example:
Line 353:		Line 371:
	"minecraft:flammable": {		"minecraft:flammable": {
	"catch_chance_modifier": 5,		"catch_chance_modifier": 5,
	"destroy_chance_modifier": 20		"destroy_chance_modifier": 20,
			"lava_flammable": "always"
	}		}
	</syntaxhighlight>		</syntaxhighlight>
Line 1,003:		Line 1,022:
	\|{{HistoryLine\|upcoming bedrock}}		\|{{HistoryLine\|upcoming bedrock}}
	\|{{HistoryLine\|\|26.30\|dev=Preview 26.30.20\|exp=Upcoming Creator Features\|Renamed field {{cd\|snow_log_no_collision}} to {{cd\|snowlogging}} in [[#minecraft:precipitation_interactions\|{{cd\|minecraft:precipitation_interactions}}]] component.}}		\|{{HistoryLine\|\|26.30\|dev=Preview 26.30.20\|exp=Upcoming Creator Features\|Renamed field {{cd\|snow_log_no_collision}} to {{cd\|snowlogging}} in [[#minecraft:precipitation_interactions\|{{cd\|minecraft:precipitation_interactions}}]] component.}}
			\|{{HistoryLine\|\|\|dev=Preview 26.30.27\|Added the {{cd\|lava_flammable}} field to the [[#minecraft:flammable\|{{cd\|minecraft:flammable}}]] component under Upcoming Creator Features. Supported values are {{cd\|always}} and {{cd\|never}}.}}
			\|{{HistoryLine\|\|26.30\|dev=Preview 26.30.27\|Released the {{cd\|culling_shape}} field in the [[#minecraft:geometry\|{{cd\|minecraft:geometry}}]] component from behind the Voxel Shapes experiment. Non-unit-cube culling shapes for certain blocks (e.g. [[Minecraft:fence]]s, [[Minecraft:bell]]s, [[Minecraft:slab]]s) still require the experiment.\|Released the snowlogging behavior for [[#minecraft:precipitation_interactions\|{{cd\|minecraft:precipitation_interactions}}]] component out of experimental.}}
			\|{{HistoryLine\|\|26.30\|dev=Preview 26.30.28\|exp=Upcoming Creator Features\|Added the [[#minecraft:block_entity\|{{cd\|minecraft:block_entity}}]] block component. It has a single boolean field {{cd\|dynamic_properties}}, when a block with a {{cd\|minecraft:block_entity}} is placed in the world, an associated block-entity will be placed with the intent.}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-05-12T11:02:22Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:02, 12 May 2026
Line 578:		Line 578:
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound\|minecraft:material_instances}}: The component root.		* {{nbt\|compound\|minecraft:material_instances}}: The component root.
	** {{nbt\|string}}{{nbt\|compound\|''''{{!}}<block face>~~{{!}}~~<material name>''}}: A material instance definition, or the name of a material instance. The name of the property can be the name of a block face, a "" to map to all block faces, or a custom name to define a material instance.		** {{nbt\|string}}{{nbt\|compound\|}} / '''<block face>''' / '''<material name>''': A material instance definition, or the name of a material instance. The name of the property can be the name of a block face, a "" to map to all block faces, or a custom name to define a material instance.
	*** {{nbt\|float\|ambient_occlusion}}: ''Optional.'' Whether the block should have ambient occlusion, and its intensity.		*** {{nbt\|float\|ambient_occlusion}}: ''Optional.'' Whether the block should have ambient occlusion, and its intensity.
	*** {{nbt\|boolean\|face_dimming}}: ''Optional.'' Sets if these faces are dimmed by their direction.		*** {{nbt\|boolean\|face_dimming}}: ''Optional.'' Sets if these faces are dimmed by their direction.

SyncBot: Sync: updated from Minecraft

2026-05-07T11:03:35Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:03, 7 May 2026
Line 579:		Line 579:
	* {{nbt\|compound\|minecraft:material_instances}}: The component root.		* {{nbt\|compound\|minecraft:material_instances}}: The component root.
	** {{nbt\|string}}{{nbt\|compound\|''''{{!}}<block face>{{!}}<material name>''}}: A material instance definition, or the name of a material instance. The name of the property can be the name of a block face, a "" to map to all block faces, or a custom name to define a material instance.		** {{nbt\|string}}{{nbt\|compound\|''''{{!}}<block face>{{!}}<material name>''}}: A material instance definition, or the name of a material instance. The name of the property can be the name of a block face, a "" to map to all block faces, or a custom name to define a material instance.
	*** ~~{{nbt\|boolean}}~~{{nbt\|float\|ambient_occlusion}}: ''Optional.'' Whether the block should have ambient occlusion, and its intensity.		*** {{nbt\|float\|ambient_occlusion}}: ''Optional.'' Whether the block should have ambient occlusion, and its intensity.
	*** {{nbt\|boolean\|face_dimming}}: ''Optional.'' Sets if these faces are dimmed by their direction.		*** {{nbt\|boolean\|face_dimming}}: ''Optional.'' Sets if these faces are dimmed by their direction.
	*** {{nbt\|boolean\|isotropic}}: ''Optional.'' Should the UVs for these faces be randomly rotated based on position?		*** {{nbt\|boolean\|isotropic}}: ''Optional.'' Should the UVs for these faces be randomly rotated based on position?

SyncBot: Sync: updated from Minecraft

2026-05-06T11:02:14Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:02, 6 May 2026
Line 11:		Line 11:

	=== Tags ===		=== Tags ===
	{{~~In development~~\|~~be\|\|26.20\|note=Replaced with~~ the [[#minecraft:tags\|minecraft:tags]] ~~component~~.\|~~removed~~=1\|section=1}}		{{Removed feature\|This tag format has been removed and replaced by the component [[#minecraft:tags\|minecraft:tags]]. It cannot be used in blocks with format version 1.26.20+ only earlier versions are compatible.\|nocat=1\|section=1}}

	Tags are used to categorize blocks and allow them to work better with vanilla blocks and items. Both vanilla and custom [[Minecraft:Block tag (Bedrock Edition)\|block tags]] can be added. Tags are added with other components, as an empty object with the format: <code>"tag:''<tag_name>''": {}</code>		Tags are used to categorize blocks and allow them to work better with vanilla blocks and items. Both vanilla and custom [[Minecraft:Block tag (Bedrock Edition)\|block tags]] can be added. Tags are added with other components, as an empty object with the format: <code>"tag:''<tag_name>''": {}</code>
Line 57:		Line 57:

	=== <code>minecraft:chest_obstruction</code> ===		=== <code>minecraft:chest_obstruction</code> ===
	~~{{Experimental\|be\|\|be=Upcoming Creator Features\|untilbe=26.20\|section=1}}~~
	Defines how the block should obstruct [[Minecraft:chest]]s from opening when placed above one.		Defines how the block should obstruct [[Minecraft:chest]]s from opening when placed above one.

Line 673:		Line 672:
	*** {{cd\|obstruct_rain}}: Rain particles will land on the block, but snow will not accumulate.		*** {{cd\|obstruct_rain}}: Rain particles will land on the block, but snow will not accumulate.
	*** {{cd\|none}}: Rain and snow will pass through the block.		*** {{cd\|none}}: Rain and snow will pass through the block.
	*** {{cd\|snow_log_no_collision~~}}{{Upcoming\|be 26.20~~}}/{{cd\|snowlogging}}{{Upcoming\|be 26.30}}:{{OnlyExperimental\|Upcoming Creator Features}} Snow will accumulate inside the block if it is snowing, causing it to become [[Minecraft:snowlogged]].		*** {{cd\|snow_log_no_collision}}/{{cd\|snowlogging}}{{Upcoming\|be 26.30}}:{{OnlyExperimental\|Upcoming Creator Features}} Snow will accumulate inside the block if it is snowing, causing it to become [[Minecraft:snowlogged]].
	</div>		</div>

Line 857:		Line 856:

	=== <code>minecraft:tags</code> ===		=== <code>minecraft:tags</code> ===
	~~{{In development\|be\|\|26.20\|section=1}}~~		Defines the block's [[Minecraft:Block tag (Bedrock Edition)\|tags]] available in format version 1.26.20+. Tags are used to categorize blocks and allow them to work better with vanilla blocks and items. Both vanilla and custom block tags can be added. This component is defined as an array.

	Defines the block's [[Minecraft:Block tag (Bedrock Edition)\|tags]]. Tags are used to categorize blocks and allow them to work better with vanilla blocks and items. Both vanilla and custom block tags can be added. This component is defined as an array.

	Structure:		Structure:
Line 937:		Line 934:

	* {{cd\|beforeOnPlayerPlace}}: Called before the player places the block.		* {{cd\|beforeOnPlayerPlace}}: Called before the player places the block.
	* {{cd\|onBlockStateChange}}: Called when a block has its state changed.~~{{upcoming\|BE 26.20}}~~{{OnlyExperimental\|Beta APIs}}		* {{cd\|onBlockStateChange}}: Called when a block has its state changed.{{OnlyExperimental\|Beta APIs}}
	* {{cd\|onBreak}}: Called when the block is [[Minecraft:destroyed]].		* {{cd\|onBreak}}: Called when the block is [[Minecraft:destroyed]].
	* {{cd\|onEntity}}: Called when an entity sends an event to the block.		* {{cd\|onEntity}}: Called when an entity sends an event to the block.
Line 999:		Line 996:
	\|{{HistoryLine\|\|\|dev=Preview 26.10.25\|Experiment disabled, and all changes have been disabled, including restricted components and the {{cd\|minecraft:tags}} component.}}		\|{{HistoryLine\|\|\|dev=Preview 26.10.25\|Experiment disabled, and all changes have been disabled, including restricted components and the {{cd\|minecraft:tags}} component.}}
	\|{{HistoryLine\|\|26.10\|dev=Preview 26.10.25\|exp=Upcoming Creator Features\|If trait [[Minecraft:Block definition#minecraft:multi_block\| {{cd\|minecraft:multi_block}}]] is defined, the components [[#minecraft:movable\|{{cd\|minecraft:movable}}]] and [[#minecraft:placement_filter\|{{cd\|minecraft:placement_filter}}]] cannot be used in permutations, and movable will have some excluded types.\|Added [[#minecraft:chest_obstruction\|{{cd\|minecraft:chest_obstruction}}]] component it defines how a block placed above a [[Minecraft:chest]] or [[Minecraft:ender chest]] should obstruct their opening.}}		\|{{HistoryLine\|\|26.10\|dev=Preview 26.10.25\|exp=Upcoming Creator Features\|If trait [[Minecraft:Block definition#minecraft:multi_block\| {{cd\|minecraft:multi_block}}]] is defined, the components [[#minecraft:movable\|{{cd\|minecraft:movable}}]] and [[#minecraft:placement_filter\|{{cd\|minecraft:placement_filter}}]] cannot be used in permutations, and movable will have some excluded types.\|Added [[#minecraft:chest_obstruction\|{{cd\|minecraft:chest_obstruction}}]] component it defines how a block placed above a [[Minecraft:chest]] or [[Minecraft:ender chest]] should obstruct their opening.}}
	~~\|{{HistoryLine\|upcoming bedrock}}~~
	\|{{HistoryLine\|\|26.20\|dev=Preview 26.20.20\|[[Minecraft:Block tag (Bedrock Edition)\|Block tags]] are no longer allowed as {{cd\|"tag:tag_name":<nowiki>{}</nowiki>}} objects in the components list. Instead, they must be specified in the [[#minecraft:tags\|{{cd\|minecraft:tags}}]] array component. Many block components have become more restricted. However, in practice, all the changes were not implemented despite being mentioned as having been added.\|Fixed y-offset for [[#minecraft:flower_pottable\|{{cd\|minecraft:flower_pottable}}]] blocks in flower pots to match vanilla for format version 1.26.20+.\|For {{cd\|format_version}} 1.26.20+ the component [[#minecraft:redstone_producer\|{{cd\|minecraft:redstone_producer}}]] cannot be defined in the permutations array without defining it in the base components object as well.\|Fixed [[#minecraft:placement_filter\|{{cd\|minecraft:placement_filter}}]] for blocks with trait [[Minecraft:Block definition#minecraft:multi_block\|{{cd\|minecraft:multi_block}}]] however, the block will not be destroyed when the base is broken.\|[[#Custom components\|Custom components]] no longer work due to a bug.<ref>{{Bug\|MCPE-237057\|\|An error is incorrectly thrown when using custom components}}</ref>}}		\|{{HistoryLine\|\|26.20\|dev=Preview 26.20.20\|[[Minecraft:Block tag (Bedrock Edition)\|Block tags]] are no longer allowed as {{cd\|"tag:tag_name":<nowiki>{}</nowiki>}} objects in the components list. Instead, they must be specified in the [[#minecraft:tags\|{{cd\|minecraft:tags}}]] array component. Many block components have become more restricted. However, in practice, all the changes were not implemented despite being mentioned as having been added.\|Fixed y-offset for [[#minecraft:flower_pottable\|{{cd\|minecraft:flower_pottable}}]] blocks in flower pots to match vanilla for format version 1.26.20+.\|For {{cd\|format_version}} 1.26.20+ the component [[#minecraft:redstone_producer\|{{cd\|minecraft:redstone_producer}}]] cannot be defined in the permutations array without defining it in the base components object as well.\|Fixed [[#minecraft:placement_filter\|{{cd\|minecraft:placement_filter}}]] for blocks with trait [[Minecraft:Block definition#minecraft:multi_block\|{{cd\|minecraft:multi_block}}]] however, the block will not be destroyed when the base is broken.\|[[#Custom components\|Custom components]] no longer work due to a bug.<ref>{{Bug\|MCPE-237057\|\|An error is incorrectly thrown when using custom components}}</ref>}}
	\|{{HistoryLine\|\|\|dev=Preview 26.20.21\|[[Minecraft:Block tag (Bedrock Edition)\|Block tags]] are no longer allowed as {{cd\|"tag:tag_name":<nowiki>{}</nowiki>}} objects in the components list as it should. The component [[#minecraft:tags\|{{cd\|minecraft:tags}}]] is now being used. All restrictions are now in place as they should be in format version 1.26.20.\|[[#minecraft:material_instances\|{{cd\|ambient_occlusion}}]] no longer supports {{cd\|true\|false\|d=and}} values in the format version 1.26.20 only numerical values.}}		\|{{HistoryLine\|\|\|dev=Preview 26.20.21\|[[Minecraft:Block tag (Bedrock Edition)\|Block tags]] are no longer allowed as {{cd\|"tag:tag_name":<nowiki>{}</nowiki>}} objects in the components list as it should. The component [[#minecraft:tags\|{{cd\|minecraft:tags}}]] is now being used. All restrictions are now in place as they should be in format version 1.26.20.\|[[#minecraft:material_instances\|{{cd\|ambient_occlusion}}]] no longer supports {{cd\|true\|false\|d=and}} values in the format version 1.26.20 only numerical values.}}
Line 1,005:		Line 1,001:
	\|{{HistoryLine\|\|26.20\|dev=Preview 26.20.23\|[[#Custom components\|Custom components]] now parse properly with the modern block definition loader.}}		\|{{HistoryLine\|\|26.20\|dev=Preview 26.20.23\|[[#Custom components\|Custom components]] now parse properly with the modern block definition loader.}}
	\|{{HistoryLine\|\|\|dev=Preview 26.20.26\|The [[#minecraft:chest_obstruction\|{{cd\|minecraft:chest_obstruction}}]] component no longer requires the "Upcoming Creator Features" experiment.}}		\|{{HistoryLine\|\|\|dev=Preview 26.20.26\|The [[#minecraft:chest_obstruction\|{{cd\|minecraft:chest_obstruction}}]] component no longer requires the "Upcoming Creator Features" experiment.}}
			\|{{HistoryLine\|upcoming bedrock}}
	\|{{HistoryLine\|\|26.30\|dev=Preview 26.30.20\|exp=Upcoming Creator Features\|Renamed field {{cd\|snow_log_no_collision}} to {{cd\|snowlogging}} in [[#minecraft:precipitation_interactions\|{{cd\|minecraft:precipitation_interactions}}]] component.}}		\|{{HistoryLine\|\|26.30\|dev=Preview 26.30.20\|exp=Upcoming Creator Features\|Renamed field {{cd\|snow_log_no_collision}} to {{cd\|snowlogging}} in [[#minecraft:precipitation_interactions\|{{cd\|minecraft:precipitation_interactions}}]] component.}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-04-24T11:03:29Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:03, 24 April 2026
Line 54:		Line 54:
	</syntaxhighlight>		</syntaxhighlight>

	== ~~Components list~~ ==		== Component types ==

	=== <code>minecraft:chest_obstruction</code> ===		=== <code>minecraft:chest_obstruction</code> ===
	{{Experimental\|be\|\|be=Upcoming Creator Features\|untilbe=26.20}}		{{Experimental\|be\|\|be=Upcoming Creator Features\|untilbe=26.20\|section=1}}
	Defines how the block should obstruct [[Minecraft:chest]]s from opening when placed above one.		Defines how the block should obstruct [[Minecraft:chest]]s from opening when placed above one.

SyncBot: Sync: updated from Minecraft

2026-04-22T11:07:53Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:07, 22 April 2026
Line 673:		Line 673:
	*** {{cd\|obstruct_rain}}: Rain particles will land on the block, but snow will not accumulate.		*** {{cd\|obstruct_rain}}: Rain particles will land on the block, but snow will not accumulate.
	*** {{cd\|none}}: Rain and snow will pass through the block.		*** {{cd\|none}}: Rain and snow will pass through the block.
	*** {{cd\|snow_log_no_collision}}:{{Upcoming\|be 26.20}}{{OnlyExperimental\|Upcoming Creator Features}} Snow will accumulate inside the block if it is snowing, causing it to become [[Minecraft:snowlogged]].		*** {{cd\|snow_log_no_collision}}{{Upcoming\|be 26.20}}/{{cd\|snowlogging}}{{Upcoming\|be 26.30}}:{{OnlyExperimental\|Upcoming Creator Features}} Snow will accumulate inside the block if it is snowing, causing it to become [[Minecraft:snowlogged]].
	</div>		</div>

Line 1,005:		Line 1,005:
	\|{{HistoryLine\|\|26.20\|dev=Preview 26.20.23\|[[#Custom components\|Custom components]] now parse properly with the modern block definition loader.}}		\|{{HistoryLine\|\|26.20\|dev=Preview 26.20.23\|[[#Custom components\|Custom components]] now parse properly with the modern block definition loader.}}
	\|{{HistoryLine\|\|\|dev=Preview 26.20.26\|The [[#minecraft:chest_obstruction\|{{cd\|minecraft:chest_obstruction}}]] component no longer requires the "Upcoming Creator Features" experiment.}}		\|{{HistoryLine\|\|\|dev=Preview 26.20.26\|The [[#minecraft:chest_obstruction\|{{cd\|minecraft:chest_obstruction}}]] component no longer requires the "Upcoming Creator Features" experiment.}}
			\|{{HistoryLine\|\|26.30\|dev=Preview 26.30.20\|exp=Upcoming Creator Features\|Renamed field {{cd\|snow_log_no_collision}} to {{cd\|snowlogging}} in [[#minecraft:precipitation_interactions\|{{cd\|minecraft:precipitation_interactions}}]] component.}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-04-17T11:02:16Z

Sync: updated from Minecraft

Show changes

SyncBot: Fix template calls: add MC/ prefix

2026-04-09T19:54:48Z

Fix template calls: add MC/ prefix

Show changes

← Older revision		Revision as of 11:02, 12 May 2026
Line 578:		Line 578:
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound\|minecraft:material_instances}}: The component root.		* {{nbt\|compound\|minecraft:material_instances}}: The component root.
	** {{nbt\|string}}{{nbt\|compound\|''''{{!}}<block face>~~{{!}}~~<material name>''}}: A material instance definition, or the name of a material instance. The name of the property can be the name of a block face, a "" to map to all block faces, or a custom name to define a material instance.		** {{nbt\|string}}{{nbt\|compound\|}} / '''<block face>''' / '''<material name>''': A material instance definition, or the name of a material instance. The name of the property can be the name of a block face, a "" to map to all block faces, or a custom name to define a material instance.
	*** {{nbt\|float\|ambient_occlusion}}: ''Optional.'' Whether the block should have ambient occlusion, and its intensity.		*** {{nbt\|float\|ambient_occlusion}}: ''Optional.'' Whether the block should have ambient occlusion, and its intensity.
	*** {{nbt\|boolean\|face_dimming}}: ''Optional.'' Sets if these faces are dimmed by their direction.		*** {{nbt\|boolean\|face_dimming}}: ''Optional.'' Sets if these faces are dimmed by their direction.

← Older revision		Revision as of 11:03, 7 May 2026
Line 579:		Line 579:
	* {{nbt\|compound\|minecraft:material_instances}}: The component root.		* {{nbt\|compound\|minecraft:material_instances}}: The component root.
	** {{nbt\|string}}{{nbt\|compound\|''''{{!}}<block face>{{!}}<material name>''}}: A material instance definition, or the name of a material instance. The name of the property can be the name of a block face, a "" to map to all block faces, or a custom name to define a material instance.		** {{nbt\|string}}{{nbt\|compound\|''''{{!}}<block face>{{!}}<material name>''}}: A material instance definition, or the name of a material instance. The name of the property can be the name of a block face, a "" to map to all block faces, or a custom name to define a material instance.
	*** ~~{{nbt\|boolean}}~~{{nbt\|float\|ambient_occlusion}}: ''Optional.'' Whether the block should have ambient occlusion, and its intensity.		*** {{nbt\|float\|ambient_occlusion}}: ''Optional.'' Whether the block should have ambient occlusion, and its intensity.
	*** {{nbt\|boolean\|face_dimming}}: ''Optional.'' Sets if these faces are dimmed by their direction.		*** {{nbt\|boolean\|face_dimming}}: ''Optional.'' Sets if these faces are dimmed by their direction.
	*** {{nbt\|boolean\|isotropic}}: ''Optional.'' Should the UVs for these faces be randomly rotated based on position?		*** {{nbt\|boolean\|isotropic}}: ''Optional.'' Should the UVs for these faces be randomly rotated based on position?

← Older revision		Revision as of 11:02, 6 May 2026
Line 11:		Line 11:

	=== Tags ===		=== Tags ===
	{{~~In development~~\|~~be\|\|26.20\|note=Replaced with~~ the [[#minecraft:tags\|minecraft:tags]] ~~component~~.\|~~removed~~=1\|section=1}}		{{Removed feature\|This tag format has been removed and replaced by the component [[#minecraft:tags\|minecraft:tags]]. It cannot be used in blocks with format version 1.26.20+ only earlier versions are compatible.\|nocat=1\|section=1}}

	Tags are used to categorize blocks and allow them to work better with vanilla blocks and items. Both vanilla and custom [[Minecraft:Block tag (Bedrock Edition)\|block tags]] can be added. Tags are added with other components, as an empty object with the format: <code>"tag:''<tag_name>''": {}</code>		Tags are used to categorize blocks and allow them to work better with vanilla blocks and items. Both vanilla and custom [[Minecraft:Block tag (Bedrock Edition)\|block tags]] can be added. Tags are added with other components, as an empty object with the format: <code>"tag:''<tag_name>''": {}</code>
Line 57:		Line 57:

	=== <code>minecraft:chest_obstruction</code> ===		=== <code>minecraft:chest_obstruction</code> ===
	~~{{Experimental\|be\|\|be=Upcoming Creator Features\|untilbe=26.20\|section=1}}~~
	Defines how the block should obstruct [[Minecraft:chest]]s from opening when placed above one.		Defines how the block should obstruct [[Minecraft:chest]]s from opening when placed above one.

Line 673:		Line 672:
	*** {{cd\|obstruct_rain}}: Rain particles will land on the block, but snow will not accumulate.		*** {{cd\|obstruct_rain}}: Rain particles will land on the block, but snow will not accumulate.
	*** {{cd\|none}}: Rain and snow will pass through the block.		*** {{cd\|none}}: Rain and snow will pass through the block.
	*** {{cd\|snow_log_no_collision~~}}{{Upcoming\|be 26.20~~}}/{{cd\|snowlogging}}{{Upcoming\|be 26.30}}:{{OnlyExperimental\|Upcoming Creator Features}} Snow will accumulate inside the block if it is snowing, causing it to become [[Minecraft:snowlogged]].		*** {{cd\|snow_log_no_collision}}/{{cd\|snowlogging}}{{Upcoming\|be 26.30}}:{{OnlyExperimental\|Upcoming Creator Features}} Snow will accumulate inside the block if it is snowing, causing it to become [[Minecraft:snowlogged]].
	</div>		</div>

Line 857:		Line 856:

	=== <code>minecraft:tags</code> ===		=== <code>minecraft:tags</code> ===
	~~{{In development\|be\|\|26.20\|section=1}}~~		Defines the block's [[Minecraft:Block tag (Bedrock Edition)\|tags]] available in format version 1.26.20+. Tags are used to categorize blocks and allow them to work better with vanilla blocks and items. Both vanilla and custom block tags can be added. This component is defined as an array.

	Defines the block's [[Minecraft:Block tag (Bedrock Edition)\|tags]]. Tags are used to categorize blocks and allow them to work better with vanilla blocks and items. Both vanilla and custom block tags can be added. This component is defined as an array.

	Structure:		Structure:
Line 937:		Line 934:

	* {{cd\|beforeOnPlayerPlace}}: Called before the player places the block.		* {{cd\|beforeOnPlayerPlace}}: Called before the player places the block.
	* {{cd\|onBlockStateChange}}: Called when a block has its state changed.~~{{upcoming\|BE 26.20}}~~{{OnlyExperimental\|Beta APIs}}		* {{cd\|onBlockStateChange}}: Called when a block has its state changed.{{OnlyExperimental\|Beta APIs}}
	* {{cd\|onBreak}}: Called when the block is [[Minecraft:destroyed]].		* {{cd\|onBreak}}: Called when the block is [[Minecraft:destroyed]].
	* {{cd\|onEntity}}: Called when an entity sends an event to the block.		* {{cd\|onEntity}}: Called when an entity sends an event to the block.
Line 999:		Line 996:
	\|{{HistoryLine\|\|\|dev=Preview 26.10.25\|Experiment disabled, and all changes have been disabled, including restricted components and the {{cd\|minecraft:tags}} component.}}		\|{{HistoryLine\|\|\|dev=Preview 26.10.25\|Experiment disabled, and all changes have been disabled, including restricted components and the {{cd\|minecraft:tags}} component.}}
	\|{{HistoryLine\|\|26.10\|dev=Preview 26.10.25\|exp=Upcoming Creator Features\|If trait [[Minecraft:Block definition#minecraft:multi_block\| {{cd\|minecraft:multi_block}}]] is defined, the components [[#minecraft:movable\|{{cd\|minecraft:movable}}]] and [[#minecraft:placement_filter\|{{cd\|minecraft:placement_filter}}]] cannot be used in permutations, and movable will have some excluded types.\|Added [[#minecraft:chest_obstruction\|{{cd\|minecraft:chest_obstruction}}]] component it defines how a block placed above a [[Minecraft:chest]] or [[Minecraft:ender chest]] should obstruct their opening.}}		\|{{HistoryLine\|\|26.10\|dev=Preview 26.10.25\|exp=Upcoming Creator Features\|If trait [[Minecraft:Block definition#minecraft:multi_block\| {{cd\|minecraft:multi_block}}]] is defined, the components [[#minecraft:movable\|{{cd\|minecraft:movable}}]] and [[#minecraft:placement_filter\|{{cd\|minecraft:placement_filter}}]] cannot be used in permutations, and movable will have some excluded types.\|Added [[#minecraft:chest_obstruction\|{{cd\|minecraft:chest_obstruction}}]] component it defines how a block placed above a [[Minecraft:chest]] or [[Minecraft:ender chest]] should obstruct their opening.}}
	~~\|{{HistoryLine\|upcoming bedrock}}~~
	\|{{HistoryLine\|\|26.20\|dev=Preview 26.20.20\|[[Minecraft:Block tag (Bedrock Edition)\|Block tags]] are no longer allowed as {{cd\|"tag:tag_name":<nowiki>{}</nowiki>}} objects in the components list. Instead, they must be specified in the [[#minecraft:tags\|{{cd\|minecraft:tags}}]] array component. Many block components have become more restricted. However, in practice, all the changes were not implemented despite being mentioned as having been added.\|Fixed y-offset for [[#minecraft:flower_pottable\|{{cd\|minecraft:flower_pottable}}]] blocks in flower pots to match vanilla for format version 1.26.20+.\|For {{cd\|format_version}} 1.26.20+ the component [[#minecraft:redstone_producer\|{{cd\|minecraft:redstone_producer}}]] cannot be defined in the permutations array without defining it in the base components object as well.\|Fixed [[#minecraft:placement_filter\|{{cd\|minecraft:placement_filter}}]] for blocks with trait [[Minecraft:Block definition#minecraft:multi_block\|{{cd\|minecraft:multi_block}}]] however, the block will not be destroyed when the base is broken.\|[[#Custom components\|Custom components]] no longer work due to a bug.<ref>{{Bug\|MCPE-237057\|\|An error is incorrectly thrown when using custom components}}</ref>}}		\|{{HistoryLine\|\|26.20\|dev=Preview 26.20.20\|[[Minecraft:Block tag (Bedrock Edition)\|Block tags]] are no longer allowed as {{cd\|"tag:tag_name":<nowiki>{}</nowiki>}} objects in the components list. Instead, they must be specified in the [[#minecraft:tags\|{{cd\|minecraft:tags}}]] array component. Many block components have become more restricted. However, in practice, all the changes were not implemented despite being mentioned as having been added.\|Fixed y-offset for [[#minecraft:flower_pottable\|{{cd\|minecraft:flower_pottable}}]] blocks in flower pots to match vanilla for format version 1.26.20+.\|For {{cd\|format_version}} 1.26.20+ the component [[#minecraft:redstone_producer\|{{cd\|minecraft:redstone_producer}}]] cannot be defined in the permutations array without defining it in the base components object as well.\|Fixed [[#minecraft:placement_filter\|{{cd\|minecraft:placement_filter}}]] for blocks with trait [[Minecraft:Block definition#minecraft:multi_block\|{{cd\|minecraft:multi_block}}]] however, the block will not be destroyed when the base is broken.\|[[#Custom components\|Custom components]] no longer work due to a bug.<ref>{{Bug\|MCPE-237057\|\|An error is incorrectly thrown when using custom components}}</ref>}}
	\|{{HistoryLine\|\|\|dev=Preview 26.20.21\|[[Minecraft:Block tag (Bedrock Edition)\|Block tags]] are no longer allowed as {{cd\|"tag:tag_name":<nowiki>{}</nowiki>}} objects in the components list as it should. The component [[#minecraft:tags\|{{cd\|minecraft:tags}}]] is now being used. All restrictions are now in place as they should be in format version 1.26.20.\|[[#minecraft:material_instances\|{{cd\|ambient_occlusion}}]] no longer supports {{cd\|true\|false\|d=and}} values in the format version 1.26.20 only numerical values.}}		\|{{HistoryLine\|\|\|dev=Preview 26.20.21\|[[Minecraft:Block tag (Bedrock Edition)\|Block tags]] are no longer allowed as {{cd\|"tag:tag_name":<nowiki>{}</nowiki>}} objects in the components list as it should. The component [[#minecraft:tags\|{{cd\|minecraft:tags}}]] is now being used. All restrictions are now in place as they should be in format version 1.26.20.\|[[#minecraft:material_instances\|{{cd\|ambient_occlusion}}]] no longer supports {{cd\|true\|false\|d=and}} values in the format version 1.26.20 only numerical values.}}
Line 1,005:		Line 1,001:
	\|{{HistoryLine\|\|26.20\|dev=Preview 26.20.23\|[[#Custom components\|Custom components]] now parse properly with the modern block definition loader.}}		\|{{HistoryLine\|\|26.20\|dev=Preview 26.20.23\|[[#Custom components\|Custom components]] now parse properly with the modern block definition loader.}}
	\|{{HistoryLine\|\|\|dev=Preview 26.20.26\|The [[#minecraft:chest_obstruction\|{{cd\|minecraft:chest_obstruction}}]] component no longer requires the "Upcoming Creator Features" experiment.}}		\|{{HistoryLine\|\|\|dev=Preview 26.20.26\|The [[#minecraft:chest_obstruction\|{{cd\|minecraft:chest_obstruction}}]] component no longer requires the "Upcoming Creator Features" experiment.}}
			\|{{HistoryLine\|upcoming bedrock}}
	\|{{HistoryLine\|\|26.30\|dev=Preview 26.30.20\|exp=Upcoming Creator Features\|Renamed field {{cd\|snow_log_no_collision}} to {{cd\|snowlogging}} in [[#minecraft:precipitation_interactions\|{{cd\|minecraft:precipitation_interactions}}]] component.}}		\|{{HistoryLine\|\|26.30\|dev=Preview 26.30.20\|exp=Upcoming Creator Features\|Renamed field {{cd\|snow_log_no_collision}} to {{cd\|snowlogging}} in [[#minecraft:precipitation_interactions\|{{cd\|minecraft:precipitation_interactions}}]] component.}}
	}}		}}

← Older revision		Revision as of 11:07, 22 April 2026
Line 673:		Line 673:
	*** {{cd\|obstruct_rain}}: Rain particles will land on the block, but snow will not accumulate.		*** {{cd\|obstruct_rain}}: Rain particles will land on the block, but snow will not accumulate.
	*** {{cd\|none}}: Rain and snow will pass through the block.		*** {{cd\|none}}: Rain and snow will pass through the block.
	*** {{cd\|snow_log_no_collision}}:{{Upcoming\|be 26.20}}{{OnlyExperimental\|Upcoming Creator Features}} Snow will accumulate inside the block if it is snowing, causing it to become [[Minecraft:snowlogged]].		*** {{cd\|snow_log_no_collision}}{{Upcoming\|be 26.20}}/{{cd\|snowlogging}}{{Upcoming\|be 26.30}}:{{OnlyExperimental\|Upcoming Creator Features}} Snow will accumulate inside the block if it is snowing, causing it to become [[Minecraft:snowlogged]].
	</div>		</div>

Line 1,005:		Line 1,005:
	\|{{HistoryLine\|\|26.20\|dev=Preview 26.20.23\|[[#Custom components\|Custom components]] now parse properly with the modern block definition loader.}}		\|{{HistoryLine\|\|26.20\|dev=Preview 26.20.23\|[[#Custom components\|Custom components]] now parse properly with the modern block definition loader.}}
	\|{{HistoryLine\|\|\|dev=Preview 26.20.26\|The [[#minecraft:chest_obstruction\|{{cd\|minecraft:chest_obstruction}}]] component no longer requires the "Upcoming Creator Features" experiment.}}		\|{{HistoryLine\|\|\|dev=Preview 26.20.26\|The [[#minecraft:chest_obstruction\|{{cd\|minecraft:chest_obstruction}}]] component no longer requires the "Upcoming Creator Features" experiment.}}
			\|{{HistoryLine\|\|26.30\|dev=Preview 26.30.20\|exp=Upcoming Creator Features\|Renamed field {{cd\|snow_log_no_collision}} to {{cd\|snowlogging}} in [[#minecraft:precipitation_interactions\|{{cd\|minecraft:precipitation_interactions}}]] component.}}
	}}		}}