Minecraft:Data component format - Revision history

SyncBot: Sync: updated from Minecraft

2026-10-22T11:15:47Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:15, 22 October 2026
Line 1,505:		Line 1,505:
	{{info needed section\|		{{info needed section\|
	* later 26.1 changes		* later 26.1 changes
	* 26.3 snapshot 7 additions (are they done already?)
	}}		}}
	{{HistoryTable		{{HistoryTable
Line 1,586:		Line 1,585:
	\|{{HistoryLine\|\|\|dev=snap7\|Added {{cd\|minecraft:attack_animation}} and {{cd\|minecraft:interact_animation}}.\|Removed {{cd\|minecraft:swing_animation}} and {{cd\|minecraft:map_color}}.}}		\|{{HistoryLine\|\|\|dev=snap7\|Added {{cd\|minecraft:attack_animation}} and {{cd\|minecraft:interact_animation}}.\|Removed {{cd\|minecraft:swing_animation}} and {{cd\|minecraft:map_color}}.}}
	\|{{HistoryLine\|\|\|dev=snap10\|Re-added the {{cd\|none}} swing animation type.\|{{cd\|minecraft:consumable}}: Added a new optional field to the {{cd\|teleport_randomly}} consume effect: {{cd\|directional_particles}}\|{{cd\|minecraft:block_transformer}}: Must now always refer to new block transformer registry. Can no longer be defined inline.\|{{cd\|minecraft:attack_animation}} and {{cd\|minecraft:interact_animation}}: The {{cd\|duration}} field is now a non-negative integer.}}		\|{{HistoryLine\|\|\|dev=snap10\|Re-added the {{cd\|none}} swing animation type.\|{{cd\|minecraft:consumable}}: Added a new optional field to the {{cd\|teleport_randomly}} consume effect: {{cd\|directional_particles}}\|{{cd\|minecraft:block_transformer}}: Must now always refer to new block transformer registry. Can no longer be defined inline.\|{{cd\|minecraft:attack_animation}} and {{cd\|minecraft:interact_animation}}: The {{cd\|duration}} field is now a non-negative integer.}}
			\|{{HistoryLine\|java upcoming}}
			\|{{HistoryLine\|\|26.4\|dev=snap5\|{{cd\|minecraft:consumable}} and {{cd\|minecraft:equippable}}: The sound fields are now fully optional.}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-10-19T11:12:11Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:12, 19 October 2026
Line 29:		Line 29:
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound}} The root tag. <section begin="item format" /><section begin="item format nocount" />		* {{nbt\|compound}} The root tag. <section begin="item format" /><section begin="item format nocount" />
	** {{nbt\|string\|id}}: The [[Minecraft:~~resource location~~]] of the item. Must not be <code>minecraft:air</code>.<section end="item format nocount" />		** {{nbt\|string\|id}}: The [[Minecraft:identifier]] of the item. Must not be <code>minecraft:air</code>.<section end="item format nocount" />
	** {{nbt\|int\|count}}: Number of [[Minecraft:item]]s stacked in this inventory slot. Any item can be stacked, even if unstackable through normal means. Defaults to 1 if not specified. Valid range is 1 to 99.<section begin="item format nocount" />		** {{nbt\|int\|count}}: Number of [[Minecraft:item]]s stacked in this inventory slot. Any item can be stacked, even if unstackable through normal means. Defaults to 1 if not specified. Valid range is 1 to 99.<section begin="item format nocount" />
	** {{nbt\|compound\|components}}: Optional map of additional (non-default) data components.		** {{nbt\|compound\|components}}: Optional map of additional (non-default) data components.

SyncBot: Sync: updated from Minecraft

2026-10-14T11:11:30Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:11, 14 October 2026
Line 1,485:		Line 1,485:

	=== map_color ===		=== map_color ===
	This component was removed in [[Minecraft:Java Edition 26.3\|26.3]].		This component was removed in [[Minecraft:Java Edition 26.3\|26.3]]. Now each [[Minecraft:exploration map]] has its own model, instead of using a single model with a colored layer.
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound\|components}}: Parent tag.		* {{nbt\|compound\|components}}: Parent tag.
Line 1,516:		Line 1,516:
	\|{{cd\|lore}} and {{cd\|fireworks}} components now allow up to 256 entries in their list.		\|{{cd\|lore}} and {{cd\|fireworks}} components now allow up to 256 entries in their list.
	\|{{cd\|container}} component now applies to all [[Minecraft:container]]s, instead of only [[Minecraft:shulker box]]es.		\|{{cd\|container}} component now applies to all [[Minecraft:container]]s, instead of only [[Minecraft:shulker box]]es.
	\|{{nbt\|string\|name}} is no longer required in {{cd\|profile}} component.}}		\|{{nbt\|string\|name}} is no longer required in {{cd\|profile}} component.
			\|Something has changed in this snapshot such that invalid banner_pattern values for shields and banners can now be specified.{{info needed\|what exactly changed?}}}}
	\|{{HistoryLine\|\|\|dev=24w12a\|Added {{cd\|d=and\|food\|max_stack_size\|max_damage\|fire_resistant\|rarity\|tool\|hide_tooltip}} components.		\|{{HistoryLine\|\|\|dev=24w12a\|Added {{cd\|d=and\|food\|max_stack_size\|max_damage\|fire_resistant\|rarity\|tool\|hide_tooltip}} components.
	\|The old <code>{...}</code> item format has been removed, and can no longer be used as a shortcut for {{cd\|custom_data}} component.}}		\|The old <code>{...}</code> item format has been removed, and can no longer be used as a shortcut for {{cd\|custom_data}} component.}}

SyncBot: Sync: updated from Minecraft

2026-10-12T11:06:27Z

Sync: updated from Minecraft

@@ Line 1,480: / Line 1,480: @@
 </div>
 {{Collapse|tail=1}}
 == History ==
@@ Line 1,565: / Line 1,586: @@
 |{{HistoryLine|||dev=snap10|Re-added the {{cd|none}} swing animation type.|{{cd|minecraft:consumable}}: Added a new optional field to the {{cd|teleport_randomly}} consume effect: {{cd|directional_particles}}|{{cd|minecraft:block_transformer}}: Must now always refer to new block transformer registry. Can no longer be defined inline.|{{cd|minecraft:attack_animation}} and {{cd|minecraft:interact_animation}}: The {{cd|duration}} field is now a non-negative integer.}}
 }}
 == Notes ==

SyncBot: Sync: updated from Minecraft

2026-09-20T11:07:30Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:07, 20 September 2026
Line 1,484:		Line 1,484:
	{{info needed section\|		{{info needed section\|
	* later 26.1 changes		* later 26.1 changes
	* 26.3 snapshot 7 additions		* 26.3 snapshot 7 additions (are they done already?)
	}}		}}
	{{HistoryTable		{{HistoryTable
Line 1,586:		Line 1,586:
	{{/swing_animation}}		{{/swing_animation}}
	</div>		</div>


	== Notes ==		== Notes ==

SyncBot: Sync: updated from Minecraft

2026-09-18T11:14:12Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:14, 18 September 2026
Line 8:		Line 8:
	Data components are only partly implemented for [[Minecraft:block entities]]. They partially replace the [[Minecraft:NBT format]] and allow some block data to be read or copied through predicates and loot functions.		Data components are only partly implemented for [[Minecraft:block entities]]. They partially replace the [[Minecraft:NBT format]] and allow some block data to be read or copied through predicates and loot functions.

	Similarly, entities can interact with data components through predicates and loot functions, ~~however~~ they still strictly use the [[Minecraft:NBT format]] and other older internal systems to store their data in memory, not data components.		Similarly, entities can interact with data components through predicates and loot functions, but they still strictly use the [[Minecraft:NBT format]] and other older internal systems to store their data in memory, not data components.

	{{TOC\|none\|limit=2}}		{{TOC\|none\|limit=2}}
Line 347:		Line 347:
	Controls whether an item can be used as [[Minecraft:smelting]] fuel and how effective a fuel it is.		Controls whether an item can be used as [[Minecraft:smelting]] fuel and how effective a fuel it is.

	All vanilla fuel items set the values in this component to [[Minecraft:number provider]]s that give higher speed and lower burn time if the current block is a [[Minecraft:smoker]] or [[Minecraft:blast furnace]], checked using the {{cd\|minecraft:block/fast_cooking}} [[Minecraft:predicate]]. If ~~you use~~ fuel that doesn't have this check, recipes for those blocks have the same speed and fuel efficiency as normal [[Minecraft:furnace]] recipes.		All vanilla fuel items set the values in this component to [[Minecraft:number provider]]s that give higher speed and lower burn time if the current block is a [[Minecraft:smoker]] or [[Minecraft:blast furnace]], checked using the {{cd\|minecraft:block/fast_cooking}} [[Minecraft:predicate]]. If fuel that doesn't have this check is used, recipes for those blocks have the same speed and fuel efficiency as normal [[Minecraft:furnace]] recipes.

	<div class="treeview">		<div class="treeview">

SyncBot: Sync: updated from Minecraft

2026-09-16T11:16:58Z

Sync: updated from Minecraft

Show changes

SyncBot: Sync: updated from Minecraft

2026-09-14T11:05:18Z

Sync: updated from Minecraft

@@ Line 1,001: / Line 1,001: @@
 * {{EntityLink|axolotl|axolotl/variant|link=#axolotl/variant}}
 * {{EntityLink|cat|cat/collar|link=#cat/collar}}
 * {{EntityLink|cat|cat/variant|link=#cat/variant}}
 * {{EntityLink|chicken|chicken/variant|link=#chicken/variant}}
 * {{EntityLink|cow|cow/variant|link=#cow/variant}}
 * {{EntityLink|cushion|cushion/color|link=#cushion/color}}{{upcoming|java 26.3}}
@@ Line 1,012: / Line 1,015: @@
 * {{EntityLink|painting|painting/variant|link=#painting/variant}}
 * {{EntityLink|parrot|parrot/variant|link=#parrot/variant}}
 * {{EntityLink|pig|pig/variant|link=#pig/variant}}
 * {{EntityLink|rabbit|rabbit/variant|link=#rabbit/variant}}
@@ Line 1,024: / Line 1,028: @@
 * {{EntityLink|wolf|wolf/sound_variant|link=#wolf/sound_variant}}
 * {{EntityLink|wolf|wolf/variant|link=#wolf/variant}}
 }}
@@ Line 1,041: / Line 1,046: @@
 ''Example:'' {{command|/give @s cat_spawn_egg[cat/collar{{=}}"blue"]}}
 * Gives a cat spawn egg that spawns a cat with a blue collar (once tamed).
 === cat/variant ===
@@ Line 1,049: / Line 1,062: @@
 ''Example:'' {{cmd|/give @s cat_spawn_egg[cat/variant{{=}}"jellie"]}}
 * Gives a cat spawn egg that spawns a Jellie (gray and white) cat.
 === chicken/variant ===
@@ Line 1,060: / Line 1,084: @@
 ''Example 2:'' {{cmd|/give @s egg[chicken/variant{{=}}"cold"]}}
 * Gives an egg that has a chance to hatch a cold chicken.
 === cow/variant ===
@@ Line 1,134: / Line 1,166: @@
 ''Example:'' {{cmd|/give @s parrot_spawn_egg[parrot/variant{{=}}"blue"]}}
 * Gives a parrot spawn egg that spawns a blue parrot.
 === pig/variant ===
@@ Line 1,226: / Line 1,266: @@
 ''Example:'' {{cmd|/give @s wolf_spawn_egg[wolf/variant{{=}}"rusty"]}}
 * Gives a wolf spawn egg that spawns a rusty wolf.
 == Non-encoded components ==

SyncBot: Sync: updated from Minecraft

2026-08-31T11:07:28Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:07, 31 August 2026
Line 613:		Line 613:
	{{/kinetic_weapon}}		{{/kinetic_weapon}}
	</div>		</div>
	''Example:'' {{command\|/give @s amethyst_shard[kinetic_weapon{{=}}{~~forward_movement:0.0,~~delay_ticks:20,damage_conditions:{max_duration_ticks:60},knockback_conditions:{max_duration_ticks:40},dismount_conditions:{max_duration_ticks:20},hit_sound:"block.~~amethyst_cluster~~.~~step~~"}]}}		''Example:'' {{command\|/give @s amethyst_shard[kinetic_weapon{{=}}{delay_ticks:20,damage_conditions:{max_duration_ticks:120},knockback_conditions:{max_duration_ticks:80},dismount_conditions:{max_duration_ticks:40},sound:"item.spear.use",hit_sound:"block.amethyst_block.hit"}]}}
	* Gives an amethyst shard which can perform a charge attack after a 1-second delay. The attack can damage entities for 3 seconds, knock them back for the first 2 seconds and dismount them for the first ~~second~~. Hitting a target with the attack plays an amethyst sound.		* Gives an amethyst shard which can perform a charge attack after a 1-second delay. The attack can damage entities for 6 seconds, knock them back for the first 4 seconds and dismount them for the first 2 seconds. Hitting a target with the attack plays an amethyst sound.

	=== lock ===		=== lock ===

SyncBot: Sync: updated from Minecraft

2026-08-30T11:05:38Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:05, 30 August 2026
Line 226:		Line 226:
	* {{nbt\|compound\|components}}: Parent tag.		* {{nbt\|compound\|components}}: Parent tag.
	{{/block transformer}}</div>		{{/block transformer}}</div>
			''Example:'' {{command\|give @s blaze_rod[minecraft:block_transformer{{=}}"shovel"]}}
			* Gives a blaze rod which can create dirt paths as a shovel can.

	=== blocks_attacks ===		=== blocks_attacks ===

← Older revision		Revision as of 11:12, 19 October 2026
Line 29:		Line 29:
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound}} The root tag. <section begin="item format" /><section begin="item format nocount" />		* {{nbt\|compound}} The root tag. <section begin="item format" /><section begin="item format nocount" />
	** {{nbt\|string\|id}}: The [[Minecraft:~~resource location~~]] of the item. Must not be <code>minecraft:air</code>.<section end="item format nocount" />		** {{nbt\|string\|id}}: The [[Minecraft:identifier]] of the item. Must not be <code>minecraft:air</code>.<section end="item format nocount" />
	** {{nbt\|int\|count}}: Number of [[Minecraft:item]]s stacked in this inventory slot. Any item can be stacked, even if unstackable through normal means. Defaults to 1 if not specified. Valid range is 1 to 99.<section begin="item format nocount" />		** {{nbt\|int\|count}}: Number of [[Minecraft:item]]s stacked in this inventory slot. Any item can be stacked, even if unstackable through normal means. Defaults to 1 if not specified. Valid range is 1 to 99.<section begin="item format nocount" />
	** {{nbt\|compound\|components}}: Optional map of additional (non-default) data components.		** {{nbt\|compound\|components}}: Optional map of additional (non-default) data components.

← Older revision		Revision as of 11:11, 14 October 2026
Line 1,485:		Line 1,485:

	=== map_color ===		=== map_color ===
	This component was removed in [[Minecraft:Java Edition 26.3\|26.3]].		This component was removed in [[Minecraft:Java Edition 26.3\|26.3]]. Now each [[Minecraft:exploration map]] has its own model, instead of using a single model with a colored layer.
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound\|components}}: Parent tag.		* {{nbt\|compound\|components}}: Parent tag.
Line 1,516:		Line 1,516:
	\|{{cd\|lore}} and {{cd\|fireworks}} components now allow up to 256 entries in their list.		\|{{cd\|lore}} and {{cd\|fireworks}} components now allow up to 256 entries in their list.
	\|{{cd\|container}} component now applies to all [[Minecraft:container]]s, instead of only [[Minecraft:shulker box]]es.		\|{{cd\|container}} component now applies to all [[Minecraft:container]]s, instead of only [[Minecraft:shulker box]]es.
	\|{{nbt\|string\|name}} is no longer required in {{cd\|profile}} component.}}		\|{{nbt\|string\|name}} is no longer required in {{cd\|profile}} component.
			\|Something has changed in this snapshot such that invalid banner_pattern values for shields and banners can now be specified.{{info needed\|what exactly changed?}}}}
	\|{{HistoryLine\|\|\|dev=24w12a\|Added {{cd\|d=and\|food\|max_stack_size\|max_damage\|fire_resistant\|rarity\|tool\|hide_tooltip}} components.		\|{{HistoryLine\|\|\|dev=24w12a\|Added {{cd\|d=and\|food\|max_stack_size\|max_damage\|fire_resistant\|rarity\|tool\|hide_tooltip}} components.
	\|The old <code>{...}</code> item format has been removed, and can no longer be used as a shortcut for {{cd\|custom_data}} component.}}		\|The old <code>{...}</code> item format has been removed, and can no longer be used as a shortcut for {{cd\|custom_data}} component.}}