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 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) 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, 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 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. [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 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