Bedrock Edition level format/Item format

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:

• [NBT Compound / JSON Object]: The item's root tag.

• • [NBT Compound / JSON Object] Block: (May not exist) What block is placed when placing a block item.
    • Tags common to all blocks see Template:Bedrock nbt/block/template
  • [NBT List / JSON Array] CanDestroy: (May not exist) Controls what block types this item can destroy.
    • [String]: A block ID.
  • [NBT List / JSON Array] CanPlaceOn: (May not exist) Controls what block types this block may be placed on.
    • [String]: A block ID.
  • [Byte] Count: Number of items stacked in this inventory slot.
  • [Short] Damage: The metadata value. Note that this tag does not store items' damage value.
  • [String] Name: The item ID.
  • [Byte] Slot: The slot where the item is located in the container.
  • [Byte] WasPickedUp: Unknown.
  • [NBT Compound / JSON Object] tag: (May not exist) Additional information about the item.

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.

• [NBT Compound / JSON Object] tag: Parent tag.
  • [Int] Damage: (May not exist) The damage value for this item. Defaults to 0.
  • [NBT Compound / JSON Object] display: (May not exist) Display properties.
    • [NBT List / JSON Array] Lore: (May not exist) List of strings to display as lore for the item.
      • [String]: (May not exist) A line of text for the lore of an item.
    • [String] Name: (May not exist) The JSON text component to use to display the item name.
  • [Byte] minecraft:item_lock: 1 for "lock in slot". 2 for "lock in inventory".
  • [Byte] minecraft:keep_on_death: 1 if keeping on death.^{[needs testing]}
  • [Int] 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.
  • [Byte] Unbreakable: 1 or 0 (true/false) - (may not exist) if this item's durability is allowed to take damage.

Enchantment Tags

in Bedrock Edition, there's only one way to store enchantment NBTs: both enchanted items and Enchanted Book share the [NBT List / JSON Array] ench tag.

• [NBT Compound / JSON Object] tag: Parent tag.
  • [NBT List / JSON Array] ench: Contains enchantments on this item.
    • [NBT Compound / JSON Object]: A single enchantment.
      • [Short] id: The ID of the enchantment.
      • [Short] lvl: The level of the enchantment, where 1 is level 1. Values are clamped between -32768 and 32767 when reading.

Armor Trim

Additional fields when an armor is trimmed:

• [NBT Compound / JSON Object] tag: Parent tag.
  • [NBT Compound / JSON Object] Trim: Properties of the armor trim.
    • [String] Material: The material which decides the color of armor trim.
    • [String] Pattern: The pattern of armor trim.

Book and Quills

Additional fields for book and quills:

• [NBT Compound / JSON Object] tag: Parent tag.
  • [NBT List / JSON Array] pages: (May not exist) The list of pages in the book.
    • [NBT Compound / JSON Object]: A single page in the book.
      • [String] photoname: Filename of a photo in this page if included.
      • [String] text: The text in this page.

Bucket of Aquatic Mob

Additional fields for bucket:

• [NBT Compound / JSON Object] tag: Parent tag.
  • Tags common to all entities see Template:Bedrock nbt/entity/template
  • [Byte] AppendCustomName: 1 or 0 (true/false) - true if the entity color, state, and id are used to generate the bucket item's name.
  • [String] BodyID: (May not exist) The translation key of entity's state. Used to generate the bucket item's name.
  • [String] ColorID: (May not exist) The translation key of a color. Used to generate the bucket item's name.
  • [String] Color2ID: (May not exist) The translation key of another color. Used to generate the bucket item's name.
  • [String] CustomName: (May not exist) The custom name of entity in it. Used to generate the bucket item's name.
  • [String] GroupName: (May not exist) Unknown. Used to generate the bucket item's name.

Crossbow

Additional fields for crossbow:

• [NBT Compound / JSON Object] tag: Parent tag.
  • [NBT Compound / JSON Object] chargedItem: The items this crossbow has charged.
    • item see Item Stack

Filled Map

Additional fields for filled map:

• [NBT Compound / JSON Object] tag: Parent tag.
  • [Byte] map_display_players: 1 or 0 (true/false) - (may not exist) true if the map displays player markers.
  • [Byte] map_is_init: (May not exist) Unknown.
  • [Byte] map_is_scaling: (May not exist) Unknown.
  • [Int] map_name_index: The index of the map's name.
  • [Int] map_scale: (May not exist) Unknown.
  • [Long] map_uuid: The UUID of the map used in this item.

Firework Rocket

Additional fields for firework rocket:

• [NBT Compound / JSON Object] tag: Parent tag.
  • [NBT Compound / JSON Object] Fireworks
    • [NBT List / JSON Array] Explosions: List of compounds representing each explosion this firework causes.
      • [NBT Compound / JSON Object]: A explosion effect.
        • {{{2}}} see Firework Explosion
    • [Byte] 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:

• [NBT Compound / JSON Object] tag: Parent tag.
  • [Int] customColor: The color of this firework star.
  • [NBT Compound / JSON Object] FireworksItem: The explosion effect contributed by this firework star.
    • {{{2}}} see Firework Explosion

Glow Stick

Additional fields for glow stick:

• [NBT Compound / JSON Object]: Parent tag.
  • [Long] active_time: (May not exist) Unknown.

Horse Armor

Additional fields for horse armor:

• [NBT Compound / JSON Object] tag: Parent tag.
  • [Int] customColor: (May not exist) The color of the leather armor.

Lodestone Compass

Additional fields for lodestone compass:

• [NBT Compound / JSON Object] tag: Parent tag.
  • [Int] trackingHandle: The ID of lodestone to track.

Potion

Additional fields for potion:

• [NBT Compound / JSON Object] tag: Parent tag.
  • [Byte] wasJustBrewed: 1 or 0 (true/false) - (may not exist) true if item is brewed in brewing stand.

Shield

Additional fields for shield:

• [NBT Compound / JSON Object] tag: Parent tag.
  • [Int] Base: The base color of the banner on the shield. See Banner#Block_data.
  • [NBT List / JSON Array] Patterns: (May not exist) List of all patterns applied to the banner on the shield.
    • [NBT Compound / JSON Object]: An individual pattern.
      • [Int] Color: The base color of the pattern. See Banner#Block_data.
      • [String] Pattern: The pattern ID code. See Banner#Block_data.

Written Book

Additional fields for written book:

• [NBT Compound / JSON Object] tag: Parent tag.
  • [String] author: The author of this book. Can be customized by the player during signing, and does not have to be a real username. Defaults to "Author Unknown".
  • [NBT Compound / JSON Object] display: (May not exist)
    • [String] Name: (May not exist) The display name of the book shown in the UI. Overrides title. Appears if the book is renamed with an anvil.
  • [Int] generation: The copy tier of the book. 0 = Original, 1 = Copy of original, 2 = Copy of copy.
  • [NBT List / JSON Array] pages: The list of pages in the book.
    • [NBT Compound / JSON Object]: A single page in the book.
      • [String] photoname: Filename of a photo in this page if included.
      • [String] text: The text in this page.
  • [String] title: The title of this book. Does not change after signing.
  • [String] xuid: The Xbox user ID of the player that signed the book.