Bedrock Edition level format/Block entity format

This page lists NBT structures of block entities in Bedrock Edition.

A block entity is used by Minecraft to store information about a block that can't be stored in the block's block states.

Block Entity

All block entities share this base:

• : The block entity's root tag.
  •  id: The namespaced ID of this block entity.
  •  x: The X position of the block entity.
  •  y: The Y position of the block entity.
  •  z: The Z position of the block entity.
  •  isMovable: True if this block entity is movable with piston.
  •  CustomName: (May not exist) The custom name of this block entity.

Additional fields for block entity types

Banner

Additional fields for banner:

• : The block entity's root tag.
  •  Base: The base color of the banner. See Banner#Block_data.
  •  Type: The type of the block entity. 0 is normal banner. 1 is ominous banner‌.
  •  Patterns: (May not exist) List of all patterns applied to the banner.
    • : An individual pattern.
      •  Pattern: The pattern id code. See Banner#Block_data.
      •  Color: The base color of the pattern. See Banner#Block_data.

Beacon

Additional fields for beacon:

• : The block entity's root tag.
  •  primary: The primary effect selected, see Potion effects for IDs. Set to 0 when no effect is selected.
  •  secondary: The secondary effect selected, see Potion effects for IDs. Set to 0 when no effect is selected. When set without a primary effect, does nothing. When set to the same as the primary, the effect is given at level 2 (the normally available behavior for 5 effects). When set to a different value than the primary (normally only Regeneration), gives the effect at level 1.

Bed

Additional fields for bed:

• : The block entity's root tag.
  •  color: The data value that determines the color of the half-bed block. When a bed is broken, the color of the block entity at the bed's head becomes the color of the bed item when it drops. See Bed#Metadata.

Beehive

Additional fields for beehive:

• : The block entity's root tag.
  •  ShouldSpawnBees: True if new bees will be spawned.
  •  Occupants: (May not exist) Entities currently in the hive.
    • : An entity in the hive.
      •  ActorIdentifier: The entity in the hive. Always minecraft:bee<> in vanilla game.
      •  TicksLeftToStay: The time in ticks until the entity leave the beehive.
      •  SaveData: The NBT data of the entity in the hive.
        • Tags common to entity
        • Tags unique to this entity type.

Bell

Additional fields for bell:

• : The block entity's root tag.
  •  Ringing: True if it is ringing.
  •  Ticks: Unknown.
  •  Direction: The direction data of this bell.

Brewing stand

Additional fields for brewing stand:

• : The block entity's root tag.
  •  FuelTotal: The max fuel numder for the fuel bar.
  •  CookTime: The number of ticks until the potions are finished.
  •  FuelAmount: Remaining fuel for the brewing stand.
  •  Items: List of items in brewing stand.
    • : An item in the brewing stand, including the slot tag.
      •  Slot: The slot the item is in.
      • Tags common to item stack

Campfire and Soul campfire

Additional fields for campfire and soul campfire:

• : The block entity's root tag.
  •  ItemTime<num>: How long each item has been cooking. <num> is 1, 2, 3, and 4.
  •  Item<num>: (May not exist) List of up to 4 items currently cooking. <num> is 1, 2, 3, and 4.
    • Tags common to item stack

Cauldron

Additional fields for cauldron:

• : The block entity's root tag.
  •  PotionId: If the cauldron contains a potion, this tag stores the ID of that potion. If there is no potion stored, then this tag is set to -1.
  •  PotionType: If the cauldron contains a potion, this tag stores the type of that potion. 0 is normal, 1 is splash, 2 is lingering. If there is no potion stored, then this tag is set to -1.
  •  CustomColor: (May not exist) This tag exists only if the cauldron stores dyed water; stores a 32-bit ARGB encoded color.
  •  Items: List of items in this container.
    • : An item, including the slot tag.
      •  Slot: The inventory slot the item is in.
      • Tags common to item stack

Chalkboard

Additional fields for chalkboard:

• : The block entity's root tag.
  •  BaseX: The X postionn of its base.
  •  BaseY: The Y postionn of its base.
  •  BaseZ: The Z postionn of its base.
  •  Size: The size of this chalkboard.
  •  OnGround: True if it is on ground.
  •  Locked: True if it is on locked.
  •  Owner: The Unique ID of its owner.
  •  Text: The text on the chalkboard.

Chemistry tables

Additional fields for chemistry tables (compound creator, elemrnt contructor, lab table, material reducer):

• : The block entity's root tag.
  •  itemId: (May not exist) Unknown.
  •  itemAux: (May not exist) Unknown.
  •  itemStack: (May not exist) Unknown.

Chests

Additional fields for chest, trapped chest and ender chest:

• : The block entity's root tag.
  •  forceunpair: (May not exist) True if this chest is unpair with chest next to it.
  •  pairlead: (May not exist) Unknown.
  •  pairx: (May not exist) The X position of the chest paired with.
  •  pairz: (May not exist) The X position of the chest paired with.
  •  Findable: Unknown.
  •  LootTable: (May not exist) Loot table to be used to fill the chest when it is next opened, or the items are otherwise interacted with.
  •  LootTableSeed: (May not exist) Seed for generating the loot table. 0 or omitted use a random seed.
  •  Items: List of items in this container.
    • : An item, including the slot tag.
      •  Slot: The inventory slot the item is in.
      • Tags common to item stack

Command Block

Additional fields for command block:

• : The block entity's root tag.
  •  powered: States whether or not the command block is powered by redstone or not.
  •  auto: Allows to activate the command without the requirement of a redstone signal.
  •  conditionMet: Indicates whether a conditional command block had its condition met when last activated. True if not a conditional command block.
  •  LPCondionalMode: Unknown.
  •  LPRedstoneMode: Unknown.
  •  LPCommandMode: Unknown.
  •  conditionalMode: (May not exist) Unknown.
  • Tags common to command block

Comparator

Additional fields for comparator:

• : The block entity's root tag.
  •  OutputSignal: Represents the strength of the analog signal output of this redstone comparator.

Conduit

Additional fields for conduit:

• : The block entity's root tag.
  •  Target: The Unique ID of the hostile mob the conduit is currently attacking. If there's no target, defaults to -1.
  •  Active: True if it is active.

Dispenser and Dropper

Additional fields for dispenser and droprer:

• : The block entity's root tag.
  •  LootTable: (May not exist) Loot table to be used to fill the chest when it is next opened, or the items are otherwise interacted with.
  •  LootTableSeed: (May not exist) Seed for generating the loot table. 0 or omitted use a random seed.
  •  Items: List of items in this container.
    • : An item, including the slot tag.
      •  Slot: The inventory slot the item is in.
      • Tags common to item stack

Enchanting table

Additional fields for enchanting table:

• : The block entity's root tag.
  •  CustomName: (May not exist) The name of this enchanting table.
  •  rott: The rotation of the book.

End Gateway

Additional fields for end gateway:

• : The block entity's root tag.
  •  Age: Age of the portal, in ticks. This is used to determine when the beam is rendered.
  •  ExitPortal: Location entities are teleported to when entering the portal.
    • : X coordinate of target location.
    • : Y coordinate of target location.
    • : Z coordinate of target location.

Flower Pot

Additional fields for flower pot:

• : The block entity's root tag.
  •  PlantBlock: (May not exist) The block in the pot.
    • Tags common to block

Furnace

Additional fields for furnace, smoker, and blast furnace:

• : The block entity's root tag.
  •  BurnTime: Number of ticks left before the current fuel runs out.
  •  CookTime: Number of ticks the item has been smelting for. The item finishes smelting when this value reaches 200 (10 seconds). Is reset to 0 if BurnTime reaches 0.
  •  BurnDuration: The total time that in ticks that the currently used fuel can burn.
  •  StoredXPInt: The number of experiences it stores.
  •  Items: List of items in this container.
    • : An item in the furnace, including the slot tag.
      •  Slot: The inventory slot the item is in.
      • Tags common to item stack

Hopper

Additional fields for hopper:

• : The block entity's root tag.
  •  TransferCooldown: Time until the next transfer in game ticks, naturally between 1 and 8 or 0 if there is no transfer.
  •  Items: List of items in this container.
    • : An item, including the slot tag.
      •  Slot: The inventory slot the item is in.
      • Tags common to item stack

Item Frame

Additional fields for item frame:

• : The block entity's root tag.
  •  ItemRotation: (May not exist) The rotation of the item in the item frame.
  •  ItemDropChance: (May not exist) The chance of item dropping when the item frame is broken.
  •  Item: The items in this item frame.
    • Tags common to item stack

Jigsaw

Additional fields for jigsaw:

• : The block entity's root tag.
  •  name: The jigsaw block's name. This jigsaw block will be aligned with another structure's jigsaw block which has this value in the target tag.
  •  target: The jigsaw block's target name. This jigsaw block will be aligned with another structure's jigsaw block which has this value in the name tag.
  •  target_pool: The jigsaw block's target pool to select a structure from.
  •  final_state: The block that this jigsaw block becomes.
  •  joint: The joint option value, either "rollable" or "aligned".

Jukebox

Additional fields for jukebox:

• : The block entity's root tag.
  •  RecordItem: (May not exist) The record item in it.
    • Tags common to item stack

Lectern

Additional fields for lectern:

• : The block entity's root tag.
  •  hasBook: (May not exist) True if has a book.
  •  page: (May not exist) The page the book is currently on, starting from 0.
  •  totalPages: (May not exist) The total pages the book has.
  •  book: (May not exist) The book item currently on the lectern.
    • Tags common to item stack

Lodestone

Additional fields for lodestone:

• : The block entity's root tag.
  •  trackingHandle: (May not exist) The id of lodestone.

Mob Spawner

Additional fields for mob spawner:

• : The block entity's root tag.
  • Tags common to mob spawner

Moving Block

Additional fields for moving block:

• : The block entity's root tag.
  •  movingBlock: The main layer of moving block represented by this block entity.
    • Tags common to block
  •  movingBlockExtra: The extra moving block layer represented by this block entity.
    • Tags common to block
  •  pistonPosX: The X position of the piston base.
  •  pistonPosY: The Y position of the piston base.
  •  pistonPosZ: The Z position of the piston base.
  •  movingEntity: (May not exist) The block entity stored in this moving block.
    • Tags common to block entity

Note Block

Additional fields for note block:

• : The block entity's root tag.
  •  note: The pitch of the note block.

Nether Reactor

Additional fields for nether reactor:

• : The block entity's root tag.
  •  HasFinished: True when the reactor has completed its activation phase, and has gone dark.
  •  IsInitialized: True when the reactor has been activated, and has turned red.
  •  Progress: Number of ticks the reactor has been active for. It finishes after 900 game ticks (45 seconds).

Piston

Additional fields for piston:

• : The block entity's root tag.
  •  Progress: How far the block has been moved. Can be 0.0, 0.5, and 1.0.
  •  LastProgress: Unknown.
  •  State: Unknown.
  •  NewState: Unknown.
  •  Sticky: True if this piston is sticky.
  •  AttachedBlocks: The list of positions of blocks it should move.
    • : A block's X position.
    • : A block's Y position.
    • : A block's Z position.
    • : Another block's X position.
    • : Another block's Y position.
    • : Another block's Z position.
    • : etc.
  •  BreakBlocks: The list of positions of blocks it should break.
    • : A block's X position.
    • : A block's Y position.
    • : A block's Z position.
    • : Another block's X position.
    • : Another block's Y position.
    • : Another block's Z position.
    • : etc.

Shulker Box

Additional fields for shulker box:

• : The block entity's root tag.
  • Tags common to chests
  •  facing: The facing of this shulker box.

Sign

Additional fields for sign:

• : The block entity's root tag.
  •  TextOwner: Unknown.
  •  IgnoreLighting: True if the sign has been dyed with a Glow Ink Sac.
  •  SignTextColor: The color that has been used to dye the sign. The default value is "black". One of "white", "orange", "magenta", "light_blue", "yellow", "lime", "pink", "gray", "light_gray", "cyan", "purple", "blue", "brown", "green", "red", or "black".
  •  TextIgnoreLegacyBugResolved: Unknown.
  •  Text: The text on it.

Skull

Additional fields for skull:

• : The block entity's root tag.
  •  SkullType: The type of this skull.
  •  Rotation: The rotation of this skull.
  •  MouthMoving: True if this dragon head's mouth is moving.
  •  MouthTickCount: The animation frame of the dragon head's mouth movement.

Structure Block

Additional fields for structure block:

• : The block entity's root tag.
  •  isPowered: Whether this structure block is being powered by redstone.
  •  data: Unknown.
  •  redstoneSaveMode: The current redstone mode of this structure block.
  •  xStructureOffset: X-offset of the structure.
  •  yStructureOffset: Y-offset of the structure.
  •  zStructureOffset: Z-offset of the structure.
  •  xStructureSize: X-size of the structure.
  •  yStructureSize: Y-size of the structure.
  •  zStructureSize: Z-size of the structure.
  •  structureName: Name of the structure.
  •  dataField: Unknown.
  •  ignoreEntities: Whether entities should be ignored in the structure.
  •  includePlayers: Whether players should be included in the structure.
  •  removeBlocks: Whether blocks should be removed in the structure.
  •  showBoundingBox: Whether to show the structure's bounding box to players in creative mode.
  •  rotation: Rotation of the structure.
  •  mirror: How the structure is mirrored.
  •  animationMode: The mode of animation.
  •  animationSeconds: Unknown.
  •  integrity: How complete the structure is that gets placed.
  •  seed: The seed to use for the structure integrity, 0 means random.