Minecraft:Item format/Before 1.20.5
More actions
Template:Outdated Template:Move Minecraft:Items are used both in the player's inventory and ender chest, in container block entities, in some item entities, and in Minecraft:structure files.
NBT structure
Items are stored in the Minecraft:NBT format. Sometimes a Template:Nbt tag is used to specify the slot the item is in, such as with chests; other times there is no Template:Nbt tag, such as with dropped items.
- Template:Nbt The root tag.
- Template:Nbt: Number of items stacked in this inventory slot. Any item can be stacked, even if unstackable through normal means. Values below 0 cause the item to be treated as air, resulting in the item being removed.
- Template:Nbt: The inventory slot the item is in.
- Template:Nbt: Item/Block ID. If not specified, gets treated as air, resulting in the item being removed.
- Template:Nbt: Additional information about the item; see below. This tag is optional for most items. Unlike other entity or block NBT, this tag is never deserialized and can hold user defined tags that are not used by the game by standard.
Display Properties
All items can have custom display names and lore, as well as a custom model data. Various tooltips can also be hidden.
- Template:Nbt: Parent tag.
Attribute Modifiers
All items can be given Modifiers which affect various Minecraft:Attributes of the player or mob wearing or holding them. Note that if an item has default attribute modifiers, these cease to exist if this tag is added (e.g. a diamond sword given an empty AttributeModifiers list no longer provides a boost to damage). Also note that default attribute modifiers do not use this tag, and as such, it does not appear on a natural item.
- Template:Nbt: Parent tag.
Enchantments
There are two ways enchantments are associated with items; the first way is that the item is actually enchanted and the enchantment affects the behavior of the item, and the second way is that the item is an Minecraft:enchanted book which simply stores the enchantments without actually affecting the behavior of the item. There is also the RepairCost tag which tracks Minecraft:anvil usage for items, making them more costly with every use of the anvil.
- Template:Nbt: Parent tag.
StoredEnchantments tooltips are not displayed if edited onto an item other than an enchanted book. Enchantments stored in Enchantments, however, are always displayed in the tooltip and cause the item to glow, even if they cannot have any effect.
Block Tags
All items can have specifications for Minecraft:Adventure mode, to describe which blocks may be broken with them. Block items can also be given tags to specify what blocks they may be placed against in Adventure mode, and to specify what Tile Entity NBT tags to apply to them when placed.
- Template:Nbt: Parent tag
Durability
Items with durability (Minecraft:tools and Minecraft:armors) can be made unbreakable and never lose any durability.
- Template:Nbt: Parent tag.
Potion Effects
Minecraft:Potions, Minecraft:splash potions, Minecraft:lingering potions, and Minecraft:tipped arrows can have multiple, customized effects via the custom_potion_effects tag. These effects are added to the default effect under the Potion tag if present. In addition the color can be overridden with the CustomPotionColor tag.
- Template:Nbt: Parent tag.
Armors
Every Minecraft:armor can be trimmed. Additionally, Minecraft:leather armor can be colored.
- Template:Nbt: Parent Tag.
Armor Stands, Spawn Eggs, Item Frames and Paintings
Minecraft:Armor stands, Minecraft:spawn eggs, item frames and Minecraft:paintings may contain potential entity data.
- Template:Nbt: Parent tag.
Book and Quills
Minecraft:Book and quills use NBT data to save their contents.
- Template:Nbt: Parent tag.
Written Books
Minecraft:Written books use NBT data to save their contents as well as miscellaneous extra information.
- Template:Nbt: Parent tag.
Knowledge Books
Minecraft:Knowledge books use NBT data to indicate the recipes they contain.
- Template:Nbt: Parent tag.
Buckets of Aquatic Mob
Buckets of aquatic mob may contain potential entity data.
- Template:Nbt: Parent tag.
Bundle
Minecraft:Bundles use NBT data to save what item is stored.
- Template:Nbt: Parent tag.
Compasses
When used as a lodestone compass, Minecraft:compasses store information about their targeted Minecraft:lodestone.
- Template:Nbt: Parent tag.
Crossbows
Minecraft:Crossbows use NBT data to save what item is charged in the crossbow
- Template:Nbt: Parent tag.
Debug Sticks
Minecraft:Debug sticks use the NBT to save the block state to edit for each block.
- Template:Nbt: Parent tag.
Firework Rockets
Minecraft:Firework rockets use the tag tag to store information about their effects.
- Template:Nbt: Parent tag.
Firework Stars
Minecraft:Firework stars use the tag tag to store information about their effects.
- Template:Nbt: Parent tag.
Goat Horns
Minecraft:Goat horns use the instrument tag to control which sound can be played when using them.
- Template:Nbt: Parent tag.
Maps
Minecraft:Maps may be scaled, locked and contain icons.
- Template:Nbt: Parent tag.
Player Heads
Minecraft:Heads of the player variety can be associated with a specific username to take on the skin of that player when placed. The hand-held item is also updated with the new skin. Within this section, the "owner" of a head means the player whose head it is a copy of, and a player whose inventory contains a head is called the "holder".
- Template:Nbt: Parent tag.
Suspicious Stew
Minecraft:Suspicious stews store their Minecraft:potion effects.
- Template:Nbt: Parent tag.
History
References
Template:Navbox Java Edition technical
Minecraft:de:Gegenstandsdaten/Vor 1.20.5 Minecraft:fr:Format d'objet Minecraft:ja:アイテムフォーマット/1.20.5以前 Minecraft:pt:Formato de item Minecraft:zh:物品格式/Java版1.20.5前