Java Edition:Any NBT on Any Item

Almost any NBT can be obtained on any item in the April Fools' version 23w13a_or_b (first upload and reupload).^{[note 1]} Several votes in this version replace one item with another but keep the replaced item's NBT. This allows NBT to be transfered from one item type to another. NBT crafting is another vote in this version that allows the player to craft items with any custom NBT tags they desire. Combining NBT crafting with replacement votes allows nearly any NBT to be transferred onto any item.

This method is extremely powerful and allows for many discontinued features. Using spawn eggs with custom NBT allows nearly any entity with custom NBT to be spawned. Using the BlockStateTag and BlockEntityTag allows for nearly any individual block to be created. Using potions with custom NBT, any effect can be obtained. The player can specify any used or unused NBT on items. If the player downgrades certain items before operator restriction bugs were fixed, the player can run commands in their world using this method.

Item NBT is replaced with item components in 24w09a (1.20.5 snapshot). Updated NBT is converted into its corresponding components. Unused NBT is copied into the minecraft:custom_data component by the data fixer.

Replacement Methods

There are five methods to replace an item and have its NBT remain. An item replaced from replace_items, replace_items_with_bottle_of_void, replace_recipe_output, replace_loot_drop, or even gold replacements from the midas_touch vote will retain their NBT.

Item Selection

The source and target items for the replace_items, replace_items_with_bottle_of_void, replace_recipe_output, and replace_loot_drop votes are all chosen using the same method except the target for replace_items_with_bottle_of_void is always Bottle of Void (bottle_of_void). The midas_touch vote does not use a source and target item. The source and target items of the replace vote cannot be the same. These two items are chosen using different methods:

• 90% of the time the source item will be a random item on the list of all items that have a picked up, used, or crafted statistic greater than one by any online player in the world. This rule is intended to help the replace vote actually have an effect by excluding items the players have not obtained yet. Negative statistics and offline players will not count for this list. Unobtainable item statistics are required to get the unobtainable items on the 90% odds list. The other 10% of the time it will be randomly chosen from the 1,287 items in 23w13a_or_b. Also, if no player has picked up, used, or crafted any item then the latter method will always be used.
• The target item will be randomly chosen from 1,288 options. The target will either be one of the 1,287 items in 23w13a_or_b or the target could be Air (air not the air_block item with the same name). If the target is Air, all of the source item will be deleted from every players' inventory.

Vote Searching

It is rare to find a specific desired conversion at random, the probability depends on how many items are in players' statistics. If the player has few items in their statistics, the chances of finding the desired source item will be much higher. In multiplayer, a player can be added who only gets a single statistic. If that player is the only one online, then slightly over 90% of the time^{[note 2]} the source item will be that only item they have a statistic of.

Replace recipe text before (top) and after (bottom) applying the A or B Unique Item Names resource pack

There are several items that cannot be distinguished by their English names within the text of the replacement vote. There are 17 "Smithing Template", 15 "Music Disc", 7 "Banner Pattern", and 2 "Air". Some other in game languages have these items named differently, for example, Catalan^{[note 3]} has a different name for each banner pattern (but not for music discs). There is no default language that has no repeat strings for all music discs and banner patterns. A resource pack can be used to uniquely identify the music discs, banner patterns, and air. Even with the resource pack, smithing templates can not be uniquely named because unlike all other items they shared a translation ID; this issue was classified as a bug and fixed in 23w31a (1.20.2 snapshot) after 23w13a_or_b.^[1] The A or B Unique Item Names resource pack created by bluecrab2 uniquely identifies all the items except the smithing templates by adding descriptions after the item names in parentheses.^{[note 4]}

Replace Items Vote

The "Replace all <ITEM> with <ITEM> in player inventories" (replace_items) vote directly converts all of the specified source item in every players' inventory into the target item. The probability that a new vote will be this type is 1000/113008, which is approximately 0.885%.^{[note 5]}

This works to convert any item into any other item in this version, while retaining the NBT. The replacement is only applied once, when it is approved. The items will remain in the same slot with the same count, also allowing for overstacked items.

Replace Items with Bottle of Void Vote

The "Replace all <ITEM> with Bottle of Void in player inventories" (replace_items_with_bottle_of_void) vote is similar to the replace items vote above except its resulting item will always be a Bottle of Void. The probability that a new vote will be this type is 500/113008, which is approximately 0.442%.^{[note 5]} The Bottle of Void will vanish when loaded in later versions, therefore its NBT can only be preserved by doing another replacement using a different method here, replacing to an item that exists in later versions.

Replace Recipe Output Vote

The diamond pickaxe recipe being replaced with an end portal frame and gaining the {Damage:0} NBT

The "Replace recipe output <ITEM> with <ITEM>" (replace_recipe_output) vote replaces the source item output with the target in crafting grids, furnaces, blast furnaces, smokers, stonecutters, campfires, and smithing tables. Only certain crafting and smithing table recipes can result in NBT. The probability that a new vote will be this type is 1000/113008, which is approximately 0.885%.^{[note 5]} The vote chooses its source and target item with the same process as the replace items vote described above. The vote remains active unless repealed or replaced with another replace recipe vote that has the same source item. There can only be one replace recipe vote from any source item. These votes do not chain. This means that if, for example, a bucket to egg and egg to clay vote were both actively applied, then crafting a bucket would only make an egg, not clay.

A list of all recipes that result in NBT is below. The recipes can copy NBT from an ingredient to the output item and/or create new NBT that goes onto the output item. The NBT copying recipes will move any NBT onto the resulting item, even if that NBT was not intended to be on the item.

A stray's slowness tipped arrow being replaced by a barrier, that retains the potion NBT.

Replace Loot Drop Vote

The "Replace loot drop <ITEM> with <ITEM>" (replace_loot_drop) vote will replace the specified source item from any loot with the target item. The loot can be from archaeology, block drops, entity drops, bartering, fishing, or villager gifts. Several vanilla loot tables give items with NBT, all of which can be put on any item with this vote. The probability that a new vote will be this type is 1000/113008, which is approximately 0.885%.^{[note 5]} The vote remains active unless repealed or replaced with another replace loot vote that has the same source item. There can only be one replace recipe vote from any source item. These votes do not chain. This means that if, for example, a bucket to egg and egg to clay vote were both actively applied, then a bucket loot drop would drop an egg, not clay.

A list of vanilla loot tables resulting in items with NBT is below. The name of the NBT function is given for each resulting NBT except for tools, weapons, and armor that gain the damage 0 tag by default without any function.

List of Loot Tables that Give Items with NBT
Loot Table	Item	NBT Function	Resulting NBT
archaeology/desert_well	Suspicious Stew (suspicious_stew)	set_stew_effect	Effects:<value>
archaeology/ocean_ruin_cold	Iron Axe (iron_axe)	N/A (Equipment Durability)	Damage:0
	Wooden Hoe (wooden_hoe)	N/A (Equipment Durability)	Damage:0
archaeology/ocean_ruin_warm	Iron Axe (iron_axe)	N/A (Equipment Durability)	Damage:0
	Wooden Hoe (wooden_hoe)	N/A (Equipment Durability)	Damage:0
archaeology/trail_ruins	Wooden Hoe (wooden_hoe)	N/A (Equipment Durability)	Damage:0
All Banner Loot Tables[note 6]	Respective Banner[note 7]	copy_name	display:{Name:<value>}
		copy_nbt	BlockEntityTag:{Patterns:<value>}
All Shulker Box Loot Tables[note 8]	Respective Shulker Box[note 9]	copy_name	display:{Name:<value>}
		copy_nbt	BlockEntityTag:{LootTable:<value>,LootTableSeed:<value>,id:"minecraft:shulker_box",Lock:<value>}
		set_contents	BlockEntityTag:{Items:<value>}
blocks/barrel	Barrel (barrel)	copy_name	display:{Name:<value>}
blocks/beacon	Beacon (beacon)	copy_name	display:{Name:<value>}
blocks/beehive	Beehive (beehive)	copy_nbt	BlockEntityTag:{Bees:<value>}
		copy_state	BlockStateTag:{honey_level:<value>}
blocks/bee_nest	Bee Nest (bee_nest	copy_nbt	BlockEntityTag:{Bees:<value>}
		copy_state	BlockStateTag:{honey_level:<value>}
blocks/blast_furnace	Blast Furnace (blast_furnace)	copy_name	display:{Name:<value>}
blocks/brewing_stand	Brewing Stand (brewing_stand)	copy_name	display:{Name:<value>}
blocks/chest	Chest (chest)	copy_name	display:{Name:<value>}
blocks/decorated_pot	Decorated Pot (decorated_pot)	copy_nbt	BlockEntityTag:{shards:<value>}
blocks/dispenser	Dispenser (dispenser)	copy_name	display:{Name:<value>}
blocks/dropper	Dropper (dropper)	copy_name	display:{Name:<value>}
blocks/enchanting_table	Enchanting Table (enchanting_table)	copy_name	display:{Name:<value>}
blocks/furnace	Furnace (furnace)	copy_name	display:{Name:<value>}
blocks/hopper	Hopper (hopper)	copy_name	display:{Name:<value>}
blocks/player_head	Player Head (player_head)	copy_nbt	SkullOwner:{Id:<value>,Properties:<value>,Name:<value>}
blocks/smoker	Smoker (smoker)	copy_name	display:{Name:<value>}
blocks/trapped_chest	Trapped Chest (trapped_chest)	copy_name	display:{Name:<value>}
chests/abandoned_mineshaft	Enchanted Book (enchanted_book)	enchant_randomly	StoredEnchantments:<value>
	Iron Pickaxe (iron_pickaxe)	N/A (Equipment Durability)	Damage:0
chests/ancient_city	Diamond Hoe (diamond_hoe)	set_damage	Damage:<value>
		enchant_with_levels	Enchantments:<value>
	Diamond Leggings (diamond_leggings)	enchant_with_levels	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Enchanted Book (enchanted_book)	enchant_randomly	StoredEnchantments:<value>
	Iron Leggings (iron_leggings)	enchant_with_levels	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Potion of Regeneration (potion)	set_potion	Potion:"minecraft:strong_regeneration"
chests/ancient_city_ice_box	Suspicious Stew (suspicious_stew)	set_stew_effect	Effects:<value>
chests/bastion_bridge	Crossbow (crossbow)	set_damage	Damage:<value>
		enchant_randomly	Enchantments:<value>
	Golden Sword (golden_sword)	N/A (Equipment Durability)	Damage:0
	Golden Chestplate (golden_chestplate)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Golden Helmet (golden_helmet)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Golden Leggings (golden_leggings)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Golden Boots (golden_boots)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Golden Axe (golden_axe)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
chests/bastion_hoglin_stable	Diamond Shovel (diamond_shovel)	set_damage	Damage:<value>
		enchant_randomly	Enchantments:<value>
	Diamond Pickaxe (diamond_pickaxe)	set_damage	Damage:<value>
		enchant_randomly	Enchantments:<value>
	Golden Axe (golden_axe)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
chests/bastion_other	Diamond Pickaxe (diamond_pickaxe)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Diamond Shovel (diamond_shovel)	N/A (Equipment Durability)	Damage:0
	Crossbow (crossbow)	set_damage	Damage:<value>
		enchant_randomly	Enchantments:<value>
	Enchanted Book (enchanted_book)	enchant_randomly	StoredEnchantments:<value>
	Iron Sword (iron_sword)	set_damage	Damage:<value>
		enchant_randomly	Enchantments:<value>
	Golden Boots (golden_boots)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Golden Axe (golden_axe)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Crossbow (crossbow)	N/A (Equipment Durability)	Damage:0
	Golden Sword (golden_sword)	N/A (Equipment Durability)	Damage:0
	Golden Chestplate (golden_chestplate)	N/A (Equipment Durability)	Damage:0
	Golden Helmet (golden_helmet)	N/A (Equipment Durability)	Damage:0
	Golden Leggings (golden_leggings)	N/A (Equipment Durability)	Damage:0
chests/bastion_treasure	Diamond Sword (diamond_sword)	set_damage	Damage:<value>
		enchant_randomly	Enchantments:<value>
	Diamond Chestplate (diamond_chestplate)	set_damage	Damage:<value>
		enchant_randomly	Enchantments:<value>
	Diamond Helmet (diamond_helmet)	set_damage	Damage:<value>
		enchant_randomly	Enchantments:<value>
	Diamond Leggings (diamond_leggings)	set_damage	Damage:<value>
		enchant_randomly	Enchantments:<value>
	Diamond Boots (diamond_boots)	set_damage	Damage:<value>
		enchant_randomly	Enchantments:<value>
	Diamond Sword (diamond_sword)	N/A (Equipment Durability)	Damage:0
	Diamond Chestplate (diamond_chestplate)	N/A (Equipment Durability)	Damage:0
	Diamond Helmet (diamond_helmet)	N/A (Equipment Durability)	Damage:0
	Diamond Boots (diamond_boots)	N/A (Equipment Durability)	Damage:0
	Diamond Leggings (diamond_leggings)	N/A (Equipment Durability)	Damage:0
chests/buried_treasure	Leather Tunic (leather_chestplate)	N/A (Equipment Durability)	Damage:0
	Iron Sword (iron_sword)	N/A (Equipment Durability)	Damage:0
chests/desert_pyramid	Enchanted Book (enchanted_book)	enchant_randomly	StoredEnchantments:<value>
chests/end_city_treasure	Diamond Sword (diamond_sword)	enchant_with_levels	StoredEnchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Diamond Boots (diamond_boots)	enchant_with_levels	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Diamond Chestplate (diamond_chestplate)	enchant_with_levels	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Diamond Leggings (diamond_leggings)	enchant_with_levels	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Diamond Helmet (diamond_helmet)	enchant_with_levels	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Diamond Pickaxe (diamond_pickaxe)	enchant_with_levels	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Diamond Shovel (diamond_shovel)	enchant_with_levels	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Iron Sword (iron_sword)	enchant_with_levels	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Iron Boots (iron_boots)	enchant_with_levels	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Iron Chestplate (iron_chestplate)	enchant_with_levels	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Iron Leggings (iron_leggings)	enchant_with_levels	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Iron Helmet (iron_helmet)	enchant_with_levels	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Iron Pickaxe (iron_pickaxe)	enchant_with_levels	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Iron Shovel (iron_shovel)	enchant_with_levels	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
chests/igloo_chest	Stone Axe (stone_axe)	N/A (Equipment Durability)	Damage:0
chests/jungle_temple	Enchanted Book (enchanted_book)	enchant_with_levels	StoredEnchantments:<value>
chests/moon_lab[note 10]	Elytra (elytra)	N/A (Equipment Durability)	Damage:0
	Diamond Pickaxe (diamond_pickaxe)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
chests/nether_bridge	Golden Sword (golden_sword)	N/A (Equipment Durability)	Damage:0
	Golden Chestplate (golden_chestplate)	N/A (Equipment Durability)	Damage:0
	Flint and Steel (flint_and_steel)	N/A (Equipment Durability)	Damage:0
chests/pillager_outpost	Crossbow (crossbow)	N/A (Equipment Durability)	Damage:0
	Enchanted Book (enchanted_book)	enchant_randomly	StoredEnchantments:<value>
chests/ruined_portal	Flint and Steel (flint_and_steel)	N/A (Equipment Durability)	Damage:0
	Golden Sword (golden_sword)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Golden Axe (golden_axe)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Golden Hoe (golden_hoe)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Golden Shovel (golden_shovel)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Golden Pickaxe (golden_pickaxe)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Golden Boots (golden_boots)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Golden Chestplate (golden_chestplate)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Golden Helmet (golden_helmet)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Golden Leggings (golden_leggings)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
chests/shipwreck_map	Map (filled_map)	exploration_map	Decorations:[{x:<value>,z:<value>,id:"+",type:26b,rot:180.0d}],map:<value>
		set_name	display:{Name:'{"translate":"filled_map.buried_treasure"}'}
chests/shipwreck_supply	Suspicious Stew (suspicious_stew)	set_stew_effect	Effects:<value>
	Leather Cap (leather_helmet)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Leather Tunic (leather_chestplate)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Leather Pants (leather_leggings)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Leather Boots (leather_boots)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
chests/simple_dungeon	Enchanted Book (enchanted_book)	enchant_randomly	StoredEnchantments:<value>
chests/spawn_bonus_chest	Stone Axe (stone_axe)	N/A (Equipment Durability)	Damage:0
	Wooden Axe (wooden_axe)	N/A (Equipment Durability)	Damage:0
	Stone Pickaxe (stone_pickaxe)	N/A (Equipment Durability)	Damage:0
	Wooden Pickaxe (wooden_pickaxe)	N/A (Equipment Durability)	Damage:0
chests/stronghold_corridor	Iron Pickaxe (iron_pickaxe)	N/A (Equipment Durability)	Damage:0
	Iron Sword (iron_sword)	N/A (Equipment Durability)	Damage:0
	Iron Chestplate (iron_chestplate)	N/A (Equipment Durability)	Damage:0
	Iron Helmet (iron_helmet)	N/A (Equipment Durability)	Damage:0
	Iron Leggings (iron_leggings)	N/A (Equipment Durability)	Damage:0
	Iron Boots (iron_boots)	N/A (Equipment Durability)	Damage:0
	Enchanted Book (enchanted_book)	enchant_with_levels	StoredEnchantments:<value>
chests/stronghold_crossing	Iron Pickaxe (iron_pickaxe)	N/A (Equipment Durability)	Damage:0
	Enchanted Book (enchanted_book)	enchant_with_levels	StoredEnchantments:<value>
chests/stronghold_library	Enchanted Book (enchanted_book)	enchant_with_levels	StoredEnchantments:<value>
chests/underwater_ruin_big	Enchanted Book (enchanted_book)	enchant_randomly	StoredEnchantments:<value>
	Leather Tunic (leather_chestplate)	N/A (Equipment Durability)	Damage:0
	Golden Helmet (golden_helmet)	N/A (Equipment Durability)	Damage:0
	Fishing Rod (fishing_rod)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Map (filled_map)	exploration_map	Decorations:[{x:<value>,z:<value>,id:"+",type:26b,rot:180.0d}],map:<value>
		set_name	display:{Name:'{"translate":"filled_map.buried_treasure"}'}
chests/underwater_ruin_small	Stone Axe (stone_axe)	N/A (Equipment Durability)	Damage:0
	Leather Tunic (leather_chestplate)	N/A (Equipment Durability)	Damage:0
	Golden Helmet (golden_helmet)	N/A (Equipment Durability)	Damage:0
	Fishing Rod (fishing_rod)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Map (filled_map)	exploration_map	Decorations:[{x:<value>,z:<value>,id:"+",type:26b,rot:180.0d}],map:<value>
		set_name	display:{Name:'{"translate":"filled_map.buried_treasure"}'}
chests/village/village_armorer	Iron Helmet (iron_helmet)	N/A (Equipment Durability)	Damage:0
chests/village/village_shepherd	Shears (shears)	N/A (Equipment Durability)	Damage:0
chests/village/village_tannery	Leather Tunic (leather_chestplate)	N/A (Equipment Durability)	Damage:0
	Leather Boots (leather_boots)	N/A (Equipment Durability)	Damage:0
	Leather Cap (leather_helmet)	N/A (Equipment Durability)	Damage:0
	Leather Pants (leather_leggings)	N/A (Equipment Durability)	Damage:0
chests/village/village_toolsmith	Iron Pickaxe (iron_pickaxe)	N/A (Equipment Durability)	Damage:0
	Iron Shovel (iron_shovel)	N/A (Equipment Durability)	Damage:0
chests/village/village_weaponsmith	Iron Pickaxe (iron_pickaxe)	N/A (Equipment Durability)	Damage:0
	Iron Sword (iron_sword)	N/A (Equipment Durability)	Damage:0
	Iron Chestplate (iron_chestplate)	N/A (Equipment Durability)	Damage:0
	Iron Helmet (iron_helmet)	N/A (Equipment Durability)	Damage:0
	Iron Leggings (iron_leggings)	N/A (Equipment Durability)	Damage:0
	Iron Boots (iron_boots)	N/A (Equipment Durability)	Damage:0
chests/woodland_mansion	Chainmail Chestplate (chainmail_chestplate)	N/A (Equipment Durability)	Damage:0
	Diamond Hoe (diamond_hoe)	N/A (Equipment Durability)	Damage:0
	Diamond Chestplate (diamond_chestplate)	N/A (Equipment Durability)	Damage:0
	Enchanted Book (enchanted_book)	enchant_randomly	StoredEnchantments:<value>
entities/stray	Arrow of Slowness (tipped_arrow)	set_potion	Potion:"minecraft:slowness"
gameplay/dream_piglin_bartering	Enchanted Book (enchanted_book)	enchant_randomly	StoredEnchantments:<value>
	Iron Boots (iron_boots)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Potion of Fire Resistance (potion)	set_potion	Potion:"minecraft:fire_resistance"
	Splash Potion of Fire Resistance (splash_potion)	set_potion	Potion:"minecraft:fire_resistance"
gameplay/fishing/junk	Leather Boots (leather_boots)	set_damage	Damage:<value>
	Water Bottle (potion)	set_potion	Potion:"minecraft:water"
	Fishing Rod (fishing_rod)	set_damage	Damage:<value>
gameplay/fishing/treasure	Bow (bow)	set_damage	Damage:<value>
		enchant_with_levels	Enchantments:<value>
	Fishing Rod (fishing_rod)	set_damage	Damage:<value>
		enchant_with_levels	Enchantments:<value>
	Enchanted Book (enchanted_book)	enchant_with_levels	StoredEnchantments:<value>
gameplay/hero_of_the_village/armorer_gift	Chainmail Helmet (chainmail_helmet)	N/A (Equipment Durability)	Damage:0
	Chainmail Chestplate (chainmail_chestplate)	N/A (Equipment Durability)	Damage:0
	Chainmail Leggings (chainmail_leggings)	N/A (Equipment Durability)	Damage:0
	Chainmail Boots (chainmail_boots)	N/A (Equipment Durability)	Damage:0
gameplay/hero_of_the_village/fletcher_gift	Tipped Arrow (tipped_arrow)	set_potion	Potion:<value>
gameplay/hero_of_the_village/toolsmith_gift	Stone Pickaxe (stone_pickaxe)	N/A (Equipment Durability)	Damage:0
	Stone Axe (stone_axe)	N/A (Equipment Durability)	Damage:0
	Stone Hoe (stone_hoe)	N/A (Equipment Durability)	Damage:0
	Stone Shovel (stone_shovel)	N/A (Equipment Durability)	Damage:0
gameplay/hero_of_the_village/weaponsmith_gift	Stone Axe (stone_axe)	N/A (Equipment Durability)	Damage:0
	Golden Axe (golden_axe)	N/A (Equipment Durability)	Damage:0
	Iron Axe (iron_axe)	N/A (Equipment Durability)	Damage:0
gameplay/piglin_bartering	Enchanted Book (enchanted_book)	enchant_randomly	StoredEnchantments:<value>
	Iron Boots (iron_boots)	enchant_randomly	Enchantments:<value>
		N/A (Equipment Durability)	Damage:0
	Potion of Fire Resistance (potion)	set_potion	Potion:"minecraft:fire_resistance"
	Splash Potion of Fire Resistance (splash_potion)	set_potion	Potion:"minecraft:fire_resistance"

Midas Touch Vote

A player wearing a block of gold (after equipping a carved pumpkin) has a golden shine due to the applied Midas Touch vote.

While the "Claim the power of the mighty Midas" (midas_touch) vote is applied, players can turn items golden. The probability that a new vote will be this type is 125/113008, which is approximately 0.111%.^{[note 5]} This replacement method is more limited since it only allows the NBT onto the golden result items. There are three methods to cause items to turn golden:

1. Items in the players' main hand, off hand, and armor slots will convert to gold. Every second, the game chooses one of these 6 slots to turn golden.
2. Item entities will always convert to gold when they contact the player. This will always occur when the player throws or picks up a stack of item. The item entity will still convert to gold if the player stands on the stack of items with a full inventory.
3. Items inside a single gold chest will convert to gold while the player has it open. The gold chest is obtained by opening a chest while the vote is applied. Every game tick, there is a 1/20 chance that the game chooses a random slot inside the open single gold chest, the stack of items in that chosen slot will be converted to gold. This conversion will still work after repealing the Midas Touch vote. The conversion does not work in a double gold chest and also does not happen while the chest is closed.

Most items will turn into gold ingots and most blocks will turn into blocks of gold but there are exceptions. A full list of exceptions is below in a collapsible table. In addition, every result item will remain itself and not convert (except the golden apple which converts again into an enchanted golden apple).

Midas Touch Conversion Exceptions
Starting Item	Result Item
Rail (rail)	Powered Rail (powered_rail)
Detector Rail (detector_rail)
Activator Rail (activator_rail)
Any Pickaxe[note 11]	Golden Pickaxe (golden_pickaxe
Any Sword[note 12]	Golden Sword (golden_sword)
Any Shovel[note 13]	Golden Shovel (golden_shovel)
Any Hoe[note 14]	Golden Hoe (golden_hoe)
Any Axe[note 15]	Golden Axe (golden_axe)
Any Helmet[note 16]	Golden Helmet (golden_helmet)
Any Chestplate[note 17]	Golden Chestplate (golden_chestplate)
Any Leggings[note 18]	Golden Leggings (golden_leggings)
Any Boots[note 19]	Golden Boots (golden_boots)
Apple (apple)	Golden Apple (golden_apple)
Golden Apple (golden_apple)	Enchanted Golden Apple (enchanted_golden_apple)
Carrot (carrot)	Golden Carrot (golden_carrot)
Arrow (arrow)	Spectral Arrow (spectral_arrow)
Iron Ingot (iron_ingot)	Gold Ingot (gold_ingot)[note 20]
Copper Ingot (copper_ingot)
Netherite Ingot (netherite_ingot)
Iron Nugget (iron_nugget)	Gold Nugget (gold_nugget)
Raw Copper (raw_copper)	Raw Gold (raw_gold)
Raw Iron (raw_iron)
Melon Slice (melon_slice)	Glistering Melon Slice (glistering_melon_slice)
Leather Horse Armor (leather_horse_armor)	Golden Horse Armor (golden_horse_armor)
Iron Horse Armor (iron_horse_armor)
Diamond Horse Armor (diamond_horse_armor)
Block of Raw Copper (raw_copper_block)	Block of Raw Gold (raw_gold_block)
Block of Raw Iron (raw_iron_block)
Copper Ore (copper_ore)	Gold Ore (gold_ore)
Iron Ore (iron_ore)
Coal Ore (coal_ore)
Emerald Ore (emerald_ore)
Redstone Ore (redstone_ore)
Diamond Ore (diamond_ore)
Lapis Lazuli Ore (lapis_ore)
Deepslate Copper Ore (deepslate_copper_ore)	Deepslate Gold Ore (deepslate_gold_ore)
Deepslate Iron Ore (deepslate_iron_ore)
Deepslate Coal Ore (deepslate_coal_ore)
Deepslate Emerald Ore (deepslate_emerald_ore)
Deepslate Redstone Ore (deepslate_redstone_ore)
Deepslate Lapis Lazuli Ore (deepslate_lapis_ore)
Nether Quartz Ore (nether_quartz_ore)	Nether Gold Ore (nether_gold_ore)

NBT Crafting

NBT crafting is a feature in 23w13a_or_b that allows for the player to craft items corresponding to NBT tags. Before NBT crafting can be used, the "Enable NBT crafting" (nbt_crafting) vote must be applied. The probability that a new vote will be this type is 500/113008, which is approximately 0.442%.^{[note 5]} There are 16 tag items that can be used to craft the different NBT tags.

All possible NBT tags can be crafted except for the Byte Array, Int Array, and Long Array tags (not to be confused with the List tag). Byte Array and Long Array are impossible to obtain on items. However, there are three items that have the Int Array through default playthrough: the skull owner on player heads (Id in SkullOwner), the colors of firework stars (Colors and FadeColors in Explosions), and the colors of firework rockets (Colors and FadeColors in Explosions).

NBT Crafting Recipes
Item	Description	Recipe	Shapeless
Name	Specifies the names of tags. May not be greater than 50 characters in length due to anvil limitations. Cannot be set to "Name" without either changing the translated name to be something else (singleplayer only), or transforming a compound tag into a name tag via a replacement vote containing the tag {name:"Name"}.		N/A
Tag	A base crafting item for other tag types.		N/A
Bit	A base crafting item for other tag types.		N/A
Byte	Represents a number between -128 and 127, inclusive. Changing the amount of sticks present in the recipe changes the value the tag is set to.		Yes
Short	Represents a number between -32,768 and 32,767, inclusive. The ordering of the byte items and their values are used in setting the value this tag is set to.		Yes
Int	Represents a number between -2,147,483,648 and 2,147,483,647, inclusive. The ordering of the byte or short items and their values are used in setting the value this tag is set to.		Yes
Long	Represents a number between -9,223,372,036,854,775,808 and 9,223,372,036,854,775,807, inclusive. The ordering of the byte, short or int items and their values are used in setting the value this tag is set to.		Yes
Float	Represents a number between ~-1.4012984643*10^−45 and ~3.4028234664*10^38, as defined by the Single-precision floating-point format. Also has special placeholders for -∞, +∞, and NaN. The byte item may also be a short, int, or long. If the bit item is not included, then the value of the float is set to the closest equivalent. If the bit item is included, then the Float.intBitsToFloat() method will be used to convert the bit value of the byte to a float.		Yes
Double	Represents a number between ~-4.9406564584124654*10^−324 and ~1.7976931348623157*10^308, as defined by the Double-precision floating-point format. Also has special placeholders for -∞, +∞, and NaN. The byte item may also be a short, int, or long. If the bit item is not included, then the value of the double is set to the closest equivalent. If the bit item is included, then the Double.intBitsToDouble() method will be used to convert the bit value of the byte to a double.		Yes
String	Stores a string. May be concatenated with other String tags to create strings longer than the anvil's 50 character limit.		Yes
Left Curly Bracket	A base crafting item for other tag types.		No
Right Curly Bracket	A base crafting item for other tag types.		No
Left Square Bracket	A base crafting item for other tag types.		No
Right Square Bracket	A base crafting item for other tag types.		No
List	Contains a list of bytes, shorts, ints, longs, floats, doubles, strings, arrays, or compound tags. Note that this will always be a NBTList tag, and will not allow for the creation of NBTByteArray, NBTIntArray, or NBTLongArray tags. May be concatenated to create lists with more than 7 entries.		No
Compound	Holds all tag types, including itself. Tags nested over 512 layers deep will not save. The start of a compound or a list tag increases the layer count by 1. Each tag requires a Name to identify it, which is to be placed before the tag when crafting. May be concatenated to create compound tags with more than 3 entries.		No

Int Array NBT Tag

Player Head nbt with the player's UUID stored as an int array tag

Since int arrays cannot be created from the NBT Crafting system, there are only two vanilla ways to obtain int array NBT tags:

1. Only in 23w13a_or_b, the player_head_drop vote could be applied. When it is active, any player blown up by a charged creeper will drop their head. This is the only method of obtaining player heads with skin data associated. The Id int array tag is inside the SkullOwner compound NBT tag. The SkullOwner int array has four integers that represent the UUID of the slain player.
2. Firework stars and firework rockets can have color and fade color tags when crafted that uses an int array. The Colors and FadeColors int array tags can be in any compound tag inside the Explosion list NBT tag. There are at most seven explosions in the Explosions tag, each of which can have their own Colors and FadeColors tag inside. There are at most eight colors in the Colors or FadeColors int array. The values inside the Colors and FadeColors int arrays are very limited to only the 16 values possible from dye colors.^{[note 21]}

Once obtained, these int array NBT tags can be swapped onto other items like all the other NBT tag types.

Uses

There is an infinite number of possible NBT combinations that can be obtained on any item.^{[note 22]} Unless an NBT tag has a coded function, it will have no effect on its item.

Used NBT

Used NBT has an in-game effect on items. Some NBT tags work on all types of items while other only work on a specific item or category of items.

NBT that has an effect on all items includes a name, lore, and enchantments. Some examples of NBT that is specifically used for one item or item category include Damage which only works on equipment and author that only works on written books. For help finding all used NBT in 23w13a_or_b, see the table in the Updating section. MCStacker for version 1.19 is a useful tool for creating custom item NBT.

Four especially powerful used NBT are mentioned below. These are EntityTag on spawn eggs which allow for almost any entity, BlockEntityTag and BlockStateTag on many blocks that allow for almost any block, and CustomPotionEffects on potions that allows for any effect.

Any Entity

A spawn egg with custom NBT can spawn almost any entity with almost any custom NBT. The entity of a spawn egg can be specified as id under EntityTag (regardless of spawn egg type). For example, the following NBT on a spawn egg will create a giant: {EntityTag:{id:"minecraft:giant"}}.

There are a few exceptions, command block minecarts, falling blocks, and spawner minecarts will spawn without their custom NBT in a world without cheats. This protects from users gaining access to commands. Additionally, since Int Arrays cannot be crafted, UUIDs cannot be crafted in entity NBT. UUIDs are used in NBT tags of mobs in the UUID of the entity itself, the Owner NBT of tameable mobs, the AngryAt NBT, the LeashedTo NBT, and more.

Any Block

Almost any block can be obtained using the BlockStateTag and BlockEntityTag NBT tags. The BlockStateTag tag allows the block states of the placed block to be controlled (e.g. orientation of a chest). The BlockEntityTag tag allows for the block entity data to be controlled (e.g. contents of a chest). Once obtained, these items can be used in any future version.

For one example, a waterlogged lit campfire with a diamond, an invalid item for a campfire, that will take 1 year to cook can be obtained by placing a campfire with the following NBT:

{BlockEntityTag:{Items:[{Slot:0b,id:"minecraft:diamond",Count:1b}],CookingTotalTimes:[I;630720000,0,0,0]},BlockStateTag:{lit:"true",waterlogged:"true"}}

Any Effect

Potions, splash potions, or lingering potions with the CustomPotionEffects NBT tag can give any effect in the game at any duration and level including those not normally obtainable in survival. Suspicious stew with the Effects NBT tag can give any effect and duration as well but can only give level 1 effects.

Unused NBT

Any NBT tag can be crafted even if it has no effect. For example, the NBT {Banana:1b} can be crafted and transferred onto a potato. This NBT is saved on the potato but does not cause any effects. With advanced tooltips enabled, the number of NBT tags will display, but the names and values of those NBT tags are not revealed and are unobservable. Additionally, items with differing NBTs will not stack.

Saving Items for Future Versions

Items that do not exist in 23w13a_or_b can be stored in a container with NBT, such as a chest, for future versions. The future item should be saved in one of the container's slots. The future item can have its own custom NBT saved within the container. The container should not be placed until the future item is added to the game. For example, a mace (added in 24w11a) with sharpness 100 can be saved in a chest with the following NBT:

{BlockEntityTag:{Items:[{Slot:1b,id:"minecraft:mace",Count:1b,tag:{Enchantments:[{id:"minecraft:sharpness",lvl:100s}]}}]}}

This chest should not be placed and opened until 24w11a (with the Update 1.21 experimental datapack enabled) or later otherwise the mace will disappear.

Commands

Warning: Command Method 

This method gives permanent access to commands that are normally locked behind the command toggle, which may be dangerous. Perform at your own risk.

Warning: Downgrading 

This feature requires downgrading which can result in crashes, data loss, or corruption, and requires specific versions. Follow the page instructions carefully.

In 23w13a_or_b itself, there is no way to run commands using any NBT on any item due to several command running protections implemented by Mojang to safeguard servers. For example, a spawn egg can be crafted that can spawn a Minecart with Command Block that has a command. This spawn egg will spawn a command block minecart when used, but it will have no command set when it is either not spawned by a player, used in a world with cheats disabled, or used on a server where the player does not have operator privileges. Below are all operator protected blocks and entities:

• Command block and command block minecart items cannot be placed without Creative mode and cheats or operator privileges.
• Lectern, mob spawner, and sign blocks will place with no custom NBT without cheats or operator privileges.
• Command block minecarts, falling blocks, and spawner minecarts will spawn with no custom NBT without cheats or operator privileges.

However, if the player downgrades the command granting items to an earlier version before these protections exist, commands can run in the world. The most recent version range where this is possible is in 19w34a to 19w35a (1.15 snapshots) with beehives or bee nests.^[2] In these snapshots, beehives and bee nests can spawn any entity, including a falling command block with a command set in it. This downgrade is far enough back that any chunks loaded will be regenerated, including spawn chunks. The player should avoid loading any chunks they want to save. An example of the necessary NBT to create a bee nest with a falling block with a command inside:

{BlockEntityTag:{Bees:[{EntityData:{id:"minecraft:falling_block",BlockState:{Name:"minecraft:command_block"},TileEntityData:{Command:"give @p diamond 64"},Time:1}}]}}

In this example, the command is give @p diamond 64, but that command can be replaced with any other command.

From 18w21a (a 1.13 snapshot) and 1.13.2-pre1, spawner minecarts have no operator restrictions when spawned from a spawn egg.^[3] Without these restrictions, it is possible to set spawner minecarts to spawn any entity with any NBT, including operator restricted entities. An example of the necessary NBT to create a spawn egg that spawns a spawner minecart that spawns falling command blocks with a command inside:

18w21a to 1.13-pre2:^[4][5]

{EntityTag:{SpawnData:{id:"minecraft:falling_block",BlockState:{Name:"minecraft:command_block"},TileEntityData:{Command:"give @p diamond 64"},Time:1}},id:"minecraft:spawner_minecart",display:{Name:"a custom name is necessary"}}

1.13-pre3 to 1.13.2-pre1:

{EntityTag:{id:"minecraft:spawner_minecart",SpawnData:{id:"minecraft:falling_block",BlockState:{Name:"minecraft:command_block"},TileEntityData:{Command:"give @p diamond 64"},Time:1}}}

From 14w07a (a 1.8 snapshot) to 1.8.5, there are no operator restrictions on placing blocks with NBT in the BlockEntityData tag.^[6] Three items can be used to run commands:

1. Command blocks: An example of the necessary NBT is {BlockEntityTag:{Command:"give @p diamond 64"}}.
2. Signs: Signs gained the ability to run commands through custom click events in 14w25a (a 1.8 snapshot). An example of the necessary NBT on a sign is {BlockEntityTag:{Text1:"{\"text\":\"run command\",\"clickEvent\":{\"action\":\"run_command\",\"value\":\"give @p diamond 64\"}}"}}. Signs are more complicated than command blocks; signs cannot be directly downgraded from 23w13a_or_b to this 1.8 version range since there was only one variant of sign with the id minecraft:sign. Signs must be stored in a container with the minecraft:sign id and the container cannot be placed and opened until after the downgrade. Signs additionally would run their commands with an operator level of 4 instead of 2 from 14w25a to 1.8.4.
3. Spawners: Like signs, the spawner block ID used to be minecraft:mob_spawner instead of minecraft:spawner, so it must be created in a container that is not placed and opened until after downgrading. Spawners can spawn any of three command granting entities:
   1. Falling block of one of the three command granting blocks above
   2. Spawner minecart that spawns another one of these command granting entities
   3. Command block minecart with a set command that can be run using an activator rail

Updating

In 24w09a, not many versions after 23w13a_or_b, item NBT is completely replaced with item components. The components available are restricted by the data fixer, the code that converts item NBT into components.^{[note 23]} While used NBT is converted into its appropriate component, any unrecognized NBT for an item is transferred into the minecraft:custom_data component. Any NBT allows for almost any minecraft:custom_data component, except the NBT tags that actually convert cannot be obtained in the minecraft:custom_data component. On the contrary, some components have no NBT that converts into them. For example, the minecraft:food component had no equivalent in NBT and so no NBT will convert into this component. During conversion, many tags employ checks to ensure a valid data type and/or value is converted into the component.

A list of NBT to component conversion is below. The table shows which components each NBT tag can effect and which items this conversion applies on. Many NBT converts on all items but some are restricted to the items they normally apply to. For example, the LodestonePos NBT tag will convert into the minecraft:lodestone_tracker component for compasses but will convert into the minecraft:custom_data component on any other item.

Item NBT to Item Components Conversions
Item(s) Conversion Applies To	NBT Tag	Component
Every Item	HideFlags	minecraft:attribute_modifiers
		minecraft:enchantments
		minecraft:unbreakable
		minecraft:can_place_on
		minecraft:can_break
		minecraft:trim
		minecraft:dyed_color
		minecraft:hide_additional_tooltip
	Damage	minecraft:damage
	RepairCost	minecraft:repair_cost
	CustomModelData	minecraft:custom_model_data
	BlockStateTag	minecraft:block_state
	EntityTag	minecraft:entity_data
	BlockEntityTag	minecraft:block_entity_data
		minecraft:banner_patterns
		minecraft:base_color
		minecraft:bees
		minecraft:block_entity_data
		minecraft:container
		minecraft:container_loot
		minecraft:lock
		minecraft:note_block_sound
		minecraft:pot_decorations
	Unbreakable	minecraft:unbreakable
	Enchantments	minecraft:enchantments
		minecraft:enchantment_glint_override
	display	minecraft:custom_name
		minecraft:lore
		minecraft:dyed_color
		minecraft:map_color
	CanDestroy	minecraft:can_break
	CanPlace	minecraft:can_place_on
	AttributeModifiers	minecraft:attribute_modifiers
	Trim	minecraft:trim
Enchanted Book (enchanted_book)	StoredEnchantments	minecraft:stored_enchantments
Crossbow (minecraft:crossbow)	ChargedProjectiles	minecraft:charged_projectiles
	Charged	Deleted[note 24]
Bundle (minecraft:bundle)	Items	minecraft:bundle_contents
Map (minecraft:filled_map)	map	minecraft:map_id
	Decorations	minecraft:map_decorations
Potion (minecraft:potion) Splash Potion (minecraft:splash_potion) Lingering Potion (minecraft:lingering_potion) Tipped Arrow (minecraft:tipped_arrow)	Potion	minecraft:potion_contents
	CustomPotionColor
	custom_potion_effects
Book and Quill (minecraft:writable_book)	pages	minecraft:writable_book_content
	filtered_pages
Written Book (minecraft:written_book)	pages	minecraft:written_book_content
	filtered_pages
	title
	filtered_title
	author
	resolved
	generation
Suspicious Stew (minecraft:suspicious_stew)	Effects	minecraft:suspicious_stew_effects
	effects[note 25]
Debug Stick (minecraft:debug_stick)	DebugProperty	minecraft:debug_stick_state
Bucket of Pufferfish (minecraft:pufferfish_bucket) Bucket of Salmon (minecraft:salmon_bucket) Bucket of Cod (minecraft:cod_bucket) Bucket of Tropical Fish (minecraft:tropical_fish_bucket) Bucket of Axolotl (minecraft:axolotl_bucket) Bucket of Tadpole (minecraft:tadpole_bucket)	NoAI	minecraft:bucket_entity_data
	Silent
	NoGravity
	Glowing
	Invulnerable
	Health
	Age
	Variant
	HuntingCooldown
	BucketVariantTag
Goat Horn (minecraft:goat_horn)	instrument	minecraft:instrument
Knowledge Book (minecraft:knowledge_book)	Recipes	minecraft:recipes
Compass (minecraft:compass)	LodestonePos	minecraft:lodestone_tracker
	LodestoneDimension
	LodestoneTracked
Firework Rocket (minecraft:firework_rocket)	Fireworks	minecraft:fireworks
Firework Star (minecraft:firework_star)	Explosion	minecraft:firework_explosion
Player Head (minecraft:player_head)	SkullOwner	minecraft:profile

See also

• Any Enchantment on Any Item
• Curse of Vanishing on Any Item
• Any Potion Tag on Any Item
• NBT Removal

Notes

References