Minecraft Wiki

The Minecraft Wiki is no longer considered as official by Microsoft and therefore several changes are required to be made, including to the wiki's logo. Please read this announcement for more information.

READ MORE

Minecraft Wiki
Advertisement
Minecraft Wiki
Information icon.svg
This feature is exclusive to Bedrock Edition. 

This page lists NBT structures of items in Bedrock Edition.

Item NBT is used both in the player's inventory and Ender inventory, and in chest block entities, dropped item entities, etc.

Item Stack[]

All items share this base:

  • : The item's root tag.
    •  Name: The item ID
    •  Count: Number of items stacked in this inventory slot.
    •  Damage: The metadata value. Note that this tag does not store items' damage value.
    •  WasPickedUp: Unknown.
    •  Block: (May not exist) What block is placed when placing a block item.
      • Tags common to block
    •  tag: (May not exist) Additional information about the item.
    •  CanDestroy: (May not exist) Controls what block types this item can destroy.
      • : An item ID.
    •  CanPlaceOn: (May not exist) Controls what block types this block may be placed on.
      • : An item ID.

General Tags[]

Items with durability store their damage value in NBT. Additionally, items can have custom display names and lore. There is also the RepairCost tag which tracks anvil usage for items, making them more costly with every use of the anvil.

  •  tag: Parent tag.
    •  Damage: (May not exist) The damage value for this item. Defaults to 0.
    •  display: (May not exist) Display properties.
      •  Name: (May not exist) The JSON text component to use to display the item.
      •  Lore: (May not exist) List of strings to display as lore for the item.
        • : (May not exist) A line of text for the lore of an item.
    •  RepairCost: (May not exist) Number of experience levels to add to the base level cost when repairing, combining, or renaming this item with an Anvil.
    •  minecarft:item_lock: 1 for "lock in slot". 2 for "lock in inventory".
    •  minecraft:keep_on_death: 1 if keeping on death.[needs testing]

Enchantment Tags[]

In Java Edition, there are two ways enchantment NBTs are stored: 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 Enchanted Book which simply stores the enchantments without actually affecting the behavior of the item.

However, in Bedrock Edition, there's only one way to store enchantment NBTs: both enchanted items and Enchanted Book share the  ench tag.

  •  tag: Parent tag.
    •  ench: Contains enchantments on this item.
      • : A single enchantment.
        •  id: The id of the enchantment.
        •  lvl: The level of the enchantment, where 1 is level 1. Values are clamped between 0 and 255 when reading.

Bucket of Aquatic Mob[]

Additional fields for bucket:

  •  tag: Parent tag.
    •  AppendCustomName: Whether entity color, state, and id are used to generate the bucket item's name. Defaults to 1.
    •  CustomName: (May not exist) The custom name of entity in it. Used to generate the bucket item's name.
    •  ColorID: (May not exist) The translation key of a color. Used to generate the bucket item's name.
    •  Color2ID: (May not exist) The translation key of another color. Used to generate the bucket item's name.
    •  BodyID: (May not exist) The translation key of entity's state. Used to generate the bucket item's name.
    •  GroupName: (May not exist) Unknown. Used to generate the bucket item's name.
    • Tags common to entity
    • Additional tags unique to fish or axolotl entity.

Lodestone Compass[]

Additional fields for lodestone compass:

  •  tag: Parent tag.
    •  trackingHandle: The id of lodestone to track.

Filled Map[]

Additional fields for filled map:

  •  tag: Parent tag.
    •  map_is_init: (May not exist) Unknown.
    •  map_uuid: The uuid of the map used in this item.
    •  map_name_index: The index of the map's name.
    •  map_display_players: (May not exist) Whether the map displays player markers.
    •  map_scale: (May not exist) Unknown.
    •  map_is_scaling: (May not exist) Unknown.

Horse Armor[]

Additional fields for horse armor:

  •  tag: Parent tag.
    •  customColor: (May not exist) The color of the leather armor.

Glow Stick[]

Additional fields for glow stick:

  • : Parent tag.
    •  active_time: (May not exist) Unknown.

[]

Additional fields for banner:

  •  tag: Parent tag.
    •  Type: (May not exist) 1 is ominous banner‌.
    •  Patterns: List of all patterns applied to the banner.

Firework[]

Additional fields for firework:

  •  tag: Parent tag.
    •  Fireworks
    •  Explosions: List of compounds representing each explosion this firework causes.
      • : A explosion effect.
        • Tags common to firework explosion
    •  Flight: Indicates the flight duration of the firework (equals the amount of gunpowder used in crafting the rocket). Can be anything from -128 to 127.

Firework Star[]

Additional fields for firework star:

  •  tag: Parent tag.
    •  FireworksItem: The explosion effect contributed by this firework star.
      • Tags common to firework explosion
    •  customColor: The color of this firework star.

Written Book[]

Additional fields for written book:

  •  tag: Parent tag.
    •  author: The author of this book.
    •  title: The title of this book.
    •  xuid: Unknown.
    •  pages: The list of pages in the book.
      • : A single page in the book.
        •  text: The text in this page.
        •  photoname: Unknown.
    •  generation: The copy tier of the book. 0 = original, 1 = copy of original, 2 = copy of copy.

Book and Quills[]

Additional fields for book and quills:

  •  tag: Parent tag.
    •  pages: (May not exist) The list of pages in the book.
      • : A single page in the book.
        •  text: The text in this page.
        •  photoname: Unknown.

Shulker Box[]

Additional fields for shulker box:

  •  tag: Parent tag.
    •  Items: List of items in the shulker box.
      • : An item in the box, including the slot tag.
        •  Slot: The slot the item is in.
        • Tags common to item stack

Crossbow[]

Additional fields for crossbow:

  •  tag: Parent tag.
    •  chargedItem: The items this crossbow has charged.
      • Tags common to item stack

Potion[]

Additional fields for potion:

  •  tag: Parent tag.
    •  wasJustBrewed: (May not exist) True if item is brewed in brewing stand.
Advertisement