Minecraft:Bedrock Edition level format/Item format

This page lists NBT structures of items in Template:Editions.

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:

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

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.

• Template:Nbt/sprite tag: Parent tag.
  • Template:Nbt/sprite Damage: (May not exist) The damage value for this item. Defaults to 0.
  • Template:Nbt/sprite display: (May not exist) Display properties.
    • Template:Nbt/sprite Lore: (May not exist) List of strings to display as lore for the item.
      • Template:Nbt/sprite: (May not exist) A line of text for the lore of an item.
    • Template:Nbt/sprite Name: (May not exist) The JSON text component to use to display the item name.
  • Template:Nbt/sprite minecraft:item_lock: 1 for "lock in slot". 2 for "lock in inventory".
  • Template:Nbt/sprite minecraft:keep_on_death: 1 if keeping on death.<needs testing></needs testing>
  • Template:Nbt/sprite RepairCost: (May not exist) Number of experience levels to add to the base level cost when repairing, combining, or renaming this item with an Minecraft:Anvil.
  • Template:Nbt/sprite Unbreakable: 1 or 0 (true/false) - (may not exist) if this item's durability is allowed to take damage.

Enchantment Tags

in Template:Editions, there's only one way to store enchantment NBTs: both enchanted items and Minecraft:Enchanted Book share the Template:Nbt/sprite ench tag.

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

Armor Trim

Additional fields when an Minecraft:armor is trimmed:

• Template:Nbt/sprite tag: Parent tag.
  • Template:Nbt/sprite Trim: Properties of the armor trim.
    • Template:Nbt/sprite Material: The material which decides the color of armor trim.
    • Template:Nbt/sprite Pattern: The pattern of armor trim.

Book and Quills

Additional fields for book and quills:

• Template:Nbt/sprite tag: Parent tag.
  • Template:Nbt/sprite pages: (May not exist) The list of pages in the book.
    • Template:Nbt/sprite: A single page in the book.
      • Template:Nbt/sprite photoname: Filename of a Minecraft:photo in this page if included.
      • Template:Nbt/sprite text: The text in this page.

Bucket of Aquatic Mob

Additional fields for Minecraft:bucket:

• Template:Nbt/sprite tag: Parent tag.
  • Template:Bedrock nbt/inherit
  • Additional tags unique to fish or axolotl entity.
  • Template:Nbt/sprite AppendCustomName: 1 or 0 (true/false) - true if the entity color, state, and id are used to generate the bucket item's name.
  • Template:Nbt/sprite BodyID: (May not exist) The translation key of entity's state. Used to generate the bucket item's name.
  • Template:Nbt/sprite ColorID: (May not exist) The translation key of a color. Used to generate the bucket item's name.
  • Template:Nbt/sprite Color2ID: (May not exist) The translation key of another color. Used to generate the bucket item's name.
  • Template:Nbt/sprite CustomName: (May not exist) The custom name of entity in it. Used to generate the bucket item's name.
  • Template:Nbt/sprite GroupName: (May not exist) Unknown. Used to generate the bucket item's name.

Crossbow

Additional fields for Minecraft:crossbow:

• Template:Nbt/sprite tag: Parent tag.
  • Template:Nbt/sprite chargedItem: The items this crossbow has charged.
    • Template:Bedrock nbt/inherit

Filled Map

Additional fields for filled map:

• Template:Nbt/sprite tag: Parent tag.
  • Template:Nbt/sprite map_display_players: 1 or 0 (true/false) - (may not exist) true if the map displays player markers.
  • Template:Nbt/sprite map_is_init: (May not exist) Unknown.
  • Template:Nbt/sprite map_is_scaling: (May not exist) Unknown.
  • Template:Nbt/sprite map_name_index: The index of the map's name.
  • Template:Nbt/sprite map_scale: (May not exist) Unknown.
  • Template:Nbt/sprite map_uuid: The UUID of the map used in this item.

Firework Rocket

Additional fields for firework rocket:

• Template:Nbt/sprite tag: Parent tag.
  • Template:Nbt/sprite Fireworks
    • Template:Nbt/sprite Explosions: List of compounds representing each explosion this firework causes.
      • Template:Nbt/sprite: A explosion effect.
        • Template:Bedrock nbt/inherit
    • Template:Nbt/sprite 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:

• Template:Nbt/sprite tag: Parent tag.
  • Template:Nbt/sprite customColor: The color of this firework star.
  • Template:Nbt/sprite FireworksItem: The explosion effect contributed by this firework star.
    • Template:Bedrock nbt/inherit

Glow Stick

Additional fields for glow stick:

• Template:Nbt/sprite: Parent tag.
  • Template:Nbt/sprite active_time: (May not exist) Unknown.

Horse Armor

Additional fields for horse armor:

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

Lodestone Compass

Additional fields for lodestone compass:

• Template:Nbt/sprite tag: Parent tag.
  • Template:Nbt/sprite trackingHandle: The ID of lodestone to track.

Potion

Additional fields for Minecraft:potion:

• Template:Nbt/sprite tag: Parent tag.
  • Template:Nbt/sprite wasJustBrewed: 1 or 0 (true/false) - (may not exist) true if item is brewed in brewing stand.

Shield

Additional fields for Minecraft:shield:

• Template:Nbt/sprite tag: Parent tag.
  • Template:Nbt/sprite Base: The base color of the banner on the shield. See Minecraft:Banner#Block_data.
  • Template:Nbt/sprite Patterns: (May not exist) List of all patterns applied to the banner on the shield.
    • Template:Nbt/sprite: An individual pattern.
      • Template:Nbt/sprite Color: The base color of the pattern. See Minecraft:Banner#Block_data.
      • Template:Nbt/sprite Pattern: The pattern ID code. See Minecraft:Banner#Block_data.

Written Book

Additional fields for written book:

• Template:Nbt/sprite tag: Parent tag.
  • Template:Nbt/sprite author: The author of this book.
  • Template:Nbt/sprite generation: The copy tier of the book. 0 = Original, 1 = Copy of original, 2 = Copy of copy.
  • Template:Nbt/sprite pages: The list of pages in the book.
    • Template:Nbt/sprite: A single page in the book.
      • Template:Nbt/sprite photoname: Filename of a Minecraft:photo in this page if included.
      • Template:Nbt/sprite text: The text in this page.
  • Template:Nbt/sprite title: The title of this book.
  • Template:Nbt/sprite xuid: Unknown.

pt:Formato de nível da Edição Bedrock/Formatos de item zh:基岩版存档格式/物品格式