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

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[]

[]

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.

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.[needs testing]

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. [more information needed]
        •  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:

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) An 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 position of its base.
    •  BaseY: The Y position of its base.
    •  BaseZ: The Z position 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, element constructor, 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, barrel, 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 Z 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. [more information needed]

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.[needs testing]
    •  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 it 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.

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".[needs testing]
    •  TextIgnoreLegacyBugResolved: Unknown.
    •  Text: The text on it.

Skull[]

Additional fields for skull:

  • : The block entity's root tag.

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.[more information needed]
    •  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.[more information needed]
    •  mirror: How the structure is mirrored.[more information needed]
    •  animationMode: The mode of animation.[more information needed]
    •  animationSeconds: Unknown.
    •  integrity: How complete the structure is that gets placed.
    •  seed: The seed to use for the structure integrity, 0 means random.[needs testing]
Advertisement