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

This page lists the entity NBT structures in Bedrock Edition.

Entity[]

All entities share this base:

  • : The entity's root tag.
    •  identifier: The namespaced ID of this entity。
    •  definitions: (May not exist) The namespaced ID of this entity and its current and previous component groups.
      • : Unknown
    •  UniqueID: The Unique ID of this entity.
    •  Pos: Three TAG_Floats describing the current X, Y and Z position of the entity.
      • : X
      • : Y
      • : Z
    •  Rotation: Two TAG_Floats representing rotation in degrees.
      • : The entity's rotation clockwise around the Y axis (called yaw). Due south is 0. Does not exceed 360 degrees.
      • : The entity's declination from the horizon (called pitch). Horizontal is 0. Positive values look downward. Does not exceed positive or negative 90 degrees.
    •  Motion: (May not exist) Three TAG_Floats describing the current dX, dY and dZ velocity of the entity in meters per tick.
      • : dX
      • : dY
      • : dZ
    •  CustomName: (May not exist) The custom name of this entity.
    •  CustomNameVisible: (May not exist) If true, and this entity has a custom name, the name always appears above the entity, regardless of where the cursor points. If the entity does not have a custom name, a default name is shown.
    •  LastDimensionId: (May not exist) Unknown.
    •  FallDistance: Distance the entity has fallen. Larger values cause more damage when the entity lands.
    •  Fire: Number of ticks until the fire is put out. Default 0 when not on fire.
    •  OnGround: True if the entity is touching the ground.
    •  Invulnerable: True if the entity should not take damage. This applies to living and nonliving entities alike: mobs should not take damage from any source (including potion effects), and cannot be moved by fishing rods, attacks, explosions, or projectiles, and objects such as vehicles cannot be destroyed. Invulnerable player entities are also ignored by any hostile mobs. Note that these entities can be damaged by players in Creative mode.[needs testing]
    •  PortalCooldown: The number of ticks before which the entity may be teleported back through a nether portal. Initially starts at 300 ticks (15 seconds) after teleportation and counts down to 0.
    •  IsGlobal: True if this entity is a global entity (e.g. lightning bolt, ender dragon, arrow)
    •  IsAutonomous: Unknown. Defauts to 0.
    •  LinksTag: (May not exist) Unknown
      •  entityID: The Unique ID of an entity.
      •  LinkID: Unknown.
    •  LootDropped: Unknown. Defaults to 0.
    •  Color: Unknown. Defauts to 0.
    •  Color2: Unknown. Defauts to 0.
    •  Strength: Unknown. Defauts to 0.
    •  StrengthMax: Unknown. Defauts to 0.
    •  Sheared: True if this entity is sheared.
    •  IsIllagerCaptain: Unknown. Defauts to 0.
    •  OwnerNew: Unknown. Defauts to -1.
    •  Sitting: True if this entity is sittting.
    •  IsBaby: True if this entity is a baby.
    •  IsTamed: True if this entity is tamed.
    •  IsTrusting: True if this entity is trusting a player.
    •  IsOrphaned: Unknown. Defauts to 0.
    •  IsAngry: True if this entity is angry.
    •  IsOutOfControl: Unknown. Defauts to 0.
    •  Variant: Unknown. Defauts to 0.
    •  MarkVariant: Unknown. Defauts to 0.
    •  Saddled: True if this entity is saddled.
    •  Chested: True if this entity is chested.
    •  ShowBottom: True if the End Crystal shows the bedrock slate underneath.[needs testing] Defaults to 0.
    •  IsGliding: True if this entity is gliding.
    •  IsSwimming: True if this entity is swimming.
    •  IsEating: True if this entity is eating.
    •  IsScared: True if this entity is scared.
    •  IsStunned: True if this entity is stunned.
    •  IsRoaring: True if this entity is roaring.
    •  SkinID: Unknown. Defauts to 0.
    •  Persistent:
    •  Tags: (May not exist) List of scoreboard tags of this entity.
      • : A tag.
    • Additional fields for all entity components except "minecraft:hide"

Additional fields for entity categories[]

Minecart[]

Minecart entities include:

    • minecart
    • minecart with block

Additional fields for minecart entities:

  • : The entity's root tag.
    •  CustomDisplayTile: (May not exist) Whether to display the custom tile in this minecart.
    •  DisplayBlock: (May not exist) The custom block in the minecart.
      • Tags common to block
    •  DisplayOffset: (May not exist) The offset of the block displayed in the Minecart in pixels. Positive values move the block upwards, while negative values move it downwards. A value of 16 moves the block up by exactly one multiple of its height.[needs testing]

Villagers[]

Villager entities include:

    • villager
    • villagerV2

Additional fields for village entities:

  • : The entity's root tag.
    •  Willing: True if the villager is willing to mate. Becomes true after certain trades (those that would cause offers to be refreshed), and false after mating.

Monster[]

Monster entities include:

    • Humanoid Monster
    • blaze
    • cave spider
    • creeper
    • enderman
    • endermite
    • evocation illager
    • ghast
    • guardian
    • ravager
    • lava slime
    • phantom
    • piglin
    • pillager
    • sliverfish
    • skeleton
    • wither skeleton
    • stray
    • slime
    • spider
    • vex
    • wither
    • ender dragon

Additional fields for monsters:

  • : The entity's root tag.
    •  SpawnedByNight: True if spawned by night.

Humanoid Monster[]

Humanoid monster entities include:

    • witch
    • zombie
    • zombie villager
    • vindication illager
    • zombiefied piglin

Additional fields for humanoid monsters:

  • : The entity's root tag.
    • Monster
    •  ItemInHand: (May not exist) The items in the entity's hand.
      • Tags common to item stack

Mob[]

Mob entities include:

    • #Monsters
    • Npc
    • Villagers
      • Villager
      • VillagerV2
    • Wandering Trader
    • Agent
    • Armor Stand
    • Shulker
    • Tripod Camera
    • Bat
    • Animal
      • Goat
      • Sheep
      • Strider
      • Turtle
      • Wolf
      • Axolotl
      • Bee
      • Cat
      • Chicken
      • Horse
      • Llama
      • Mushroom Cow
      • Panda
      • Parrot
      • Pig
      • Polar Bear
      • Rabit
    • Iron Golem
    • Squid
    • Glow Squid
    • Water Animal
      • Fish
      • Pufferfish
      • Dolphin
      • Salmon
      • Tropical Fish

Additional fields for mobs:

  • : The entity's root tag.
    •  limitedLife: The left time in ticks until this entity disapears. Only[needs testing] effects Evoker Fangs. For other entities, it is set to 0.
    •  LeasherID: The Unique ID of an entity that is leashing it with a lead. Set to -1 if there's no leasher.
    •  TradeTier: (May not exist) Trade tier of this trader entity.
    •  TradeExperience: (May not exist) Trade experiences of this trader entity.
    •  canPickupItems: True if this entity can pick up items.
    •  hasSetCanPickupItems: True if canPickupItems has been set by the game.
    •  persistingOffers: (May not exist) Unknown.
    •  persistingRiches: (May not exist) Unknown.
    •  Mainhand: The item being held in the mob's main hand.
      • : The item.
        • Tags common to item stack
    •  Offhand: The item being held in the mob's off hand.
      • : The item.
        • Tags common to item stack
    •  Armor: The list of items the mob is wearing as armor.
      • : The item on the head.
        • Tags common to item stack
      • : The item on the chest.
        • Tags common to item stack
      • : The item on the legs.
        • Tags common to item stack
      • : The item on the feets.
        • Tags common to item stack
    •  HurtTime: Number of ticks the mob turns red for after being hit. 0 when not recently hit.
    •  DeathTime: Number of ticks the mob has been dead for. Controls death animations. 0 when alive.
    •  Dead: True if dead.
    •  AttackTime: Number of ticks the mob attacks for. 0 when not attacking.
    •  Surface: True if it is naturally spawned on the surface.
    •  NaturalSpawn: True if it is naturally spawned.
    •  TargetID: The Unique ID of an entity that this entity is angry at.
    •  hasBoundOrigin: Whather this mob has bound origin. Only[needs testing] effects Vex. When a vex is idle, it wanders, selecting air blocks from within a 15×11×15[needs testing] cuboid range centered at BoundX, BoundY, BoundZ. when it summoned the vex, this value is set to 1, and the central spot is the location of the evoker. Or if an evoker was not involved, this value is 0.
    •  boundX: X of the bound origin.
    •  boundY: Y of the bound origin.
    •  boundZ: Z of the bound origin.
    •  Attributes: A list of Attributes for this mob. These are used for many purposes in internal calculations. Valid Attributes for a given mob are listed in the main article.
      • : An Attribute.
        • Tags common to attribute
    •  ActiveEffects: (May not exist) The list of potion effects on this mob.
      • : An effect.
        • Tags common to mob effect
    •  BodyRot: (May not exist) Unknown.
    •  WantsToBeJockey: (May not exist) True if it wants to be Jockey.
    • Tags common to hide
    •  IsPregnant: True if the turtle has eggs.
    •  TargetCaptainID: (May not exist) Unknown.

Abstract Arrow[]

Abstract arrow entities include:

    • Thrown Trident
    • Arrow

Additional fields for abstract arrow entities:

  • : The entity's root tag.
    •  OwnerID: The Unique ID of the entity this projectile was thrown by. Set to -1 if it has no owner.
    •  player: True if its owner is a player.
    •  isCreative: True if its owner is a player in Creative mode.

Throwable[]

Throwable entities include:

    • experience potion
    • thrown ender pearl
    • thrown potion

Additional fields for throwable entities:

  • : The entity's root tag.
    •  shake: Unknown.
    •  inGround: Unknown.
    •  OwnerID: The Unique ID of the entity this projectile was thrown by.

Additional fields for entity types[]

Arrow[]

Additional fields for arrow:

  • : The entity's root tag.
    •  enchantPower: The level of Power enchantment on the bow that shot this arrow, where 1 is level 1. 0 if no Power enchantment.
    •  enchantPunch: The level of Punch enchantment on the bow that shot this arrow, where 1 is level 1. 0 if no Punch enchantment.
    •  enchantFlame: The level of Flame enchantment on the bow that shot this arrow, where 1 is level 1. 0 if no Flame enchantment.
    •  enchantInfinity: The level of Infinity enchantment on the bow that shot this arrow, where 1 is level 1. 0 if no Infinity enchantment.
    •  mobEffects: Effects on a tipped arrow.
      • : An effect.
        • Tags common to mob effect
    •  auxValue: The metadata of this arrow. See Arrow#Metadata.

Player[]

Additional fields for player:

  • : The entity's root tag.
    •  Offhand: The items the player is holding in off hand.
    •  Inventory: Each compound tag in this list is an item in the player's inventory.
      • : An item in the inventory, including the slot tag.
        •  Slot: The slot the item is in.
        • Tags common to item stack
    •  format_version: The format version of this NBT.
    •  SelectedInventorySlot: The selected inventory slot of the player.
    •  SelectedContainerId: Unknown.
    •  Sleeping: True if the player is sleeping
    •  SleepTimer: The number of ticks the player had been in bed. 0 when the player is not sleeping. In bed, increases up to 100, then stops. Skips the night after all players in bed have reached 100. When getting out of bed, instantly changes to 100 and then increases for another 9 ticks (up to 109) before returning to 0.[needs testing]
    •  SpawnBlockPositionX: The X coordinate of the player's spawn block.
    •  SpawnBlockPositionY: The Y coordinate of the player's spawn block.
    •  SpawnBlockPositionZ: The Z coordinate of the player's spawn block.
    •  SpawnDimension: The dimension of the player's spawn point.
    •  SpawnX: The X coordinate of the player's spawn point.
    •  SpawnY: The Y coordinate of the player's spawn point.
    •  SpawnZ: The Z coordinate of the player's spawn point.
    •  EnchantmentSeed: The seed used for the next enchantment in enchantment tables.
    •  RideID: The Unique ID of the entity that the player is riding.
    •  LeftShoulderRiderID: The Unique ID of the entity that is on the player's left shoulder.
    •  RightShoulderRiderID: The Unique ID of the entity that is on the player's right shoulder.
    •  PlayerGameMode: The game mode of the player.
    •  PlayerLevel: The level shown on the XP bar.
    •  PlayerLevelProgress: The progress/percent across the XP bar to the next level.
    •  DimensionId: The ID of the dimension the player is in.
    •  EnderChestInventory: Each compound tag in this list is an item in the player's 27-slot ender chest inventory.
      • : An item in the inventory.
        •  Slot: The slot the item is in.
        • Tags common to item stack
    •  HasSeenCredits: True if the player has traveled to the Overworld via an End portal.
    •  PlayerUIItems: Unknown
      • : An item in the UI, including the slot tag.
        •  Slot: The slot the item is in.
        • Tags common to item stack
    •  MapIndex: Unknown.
    •  Sneaking: True if the player is sneaking.
    •  AgentID: The Unique ID of the player's agent.
    • Tags common to abilities

Vex[]

Additional fields for vex:

  • : The entity's root tag.
    •  ItemInHand: (May not exist) The item in its hand. Defaults to an iron sword.
      • Tags common to item stack

Zombie Villager[]

Additional fields for zombie villager:

  • : The entity's root tag.
    •  SpawnedFromVillage: True if spawned from village.

Area Effect Cloud[]

Additional fields for area effect cloud:

  • : The entity's root tag.
    •  Duration: The maximum age of the field.
    •  ReapplicationDelay: The number of ticks before reapplying the effect.
    •  DurationOnUse: The amount the duration of the field changes upon applying the effect.
    •  InitialRadius: The field's initial radius.
    •  RadiusOnUse: The amount the radius changes upon applying the effect. Normally negative.
    •  RadiusPerTick: The amount the radius changes per tick. Normally negative.
    •  Radius: The field's current radius.
    •  OwnerId: The Unique ID of the entity who created the cloud. If it has no owner, defaults to -1.
    •  PotionId: The name of the default potion effect. See potion data values for valid IDs.
    •  ParticleId: The particles displayed by the field.
    •  ParticleColor: The color of the particles.
    •  mobEffects: A list of the applied effects.
      • Tags common to mob effect
    •  SpawnTick: The time when it was spawned.
    •  RadiusChangeOnPickup: The amount the radius changes whrn picked up by a glass bottle.
    •  PickupCount: How many dragon's breath can be picked up.

Armor Stand[]

Additional fields for armor stand:

  • : The entity's root tag.
    •  Pose: The ArmorStand's pose.
      •  PoseIndex: The index of current pose.
      •  LastSignal: The redstone signal level it recieved.

Painting[]

Additional fields for painting:

  • : The entity's root tag.
    •  Motive: (May not exist) The ID of the painting's artwork.
    •  Direction: Unknown.
    •  Dir: The direction the painting faces: 0 is south, 1 is west, 2 is north, 3 is east.[needs testing]

Fireball[]

Additional fields for fireball:

  • : The entity's root tag.
    •  inGround: Unknown.
    •  Direction: List of 3 doubles. Should be identical to Motion.[needs testing]
      • : X
      • : Y
      • : Z
    •  power: List of 3 floats that adds to Direction every tick. Act as the acceleration.
      • : X
      • : Y
      • : Z

Thrown Potion[]

Additional fields for thrown potion:

Thrown Trident[]

Additional fields for thrown trident:

  • : The entity's root tag.
    •  favoredSlot: The slot id when it is thrown out.This means thrown trifent with Loyalty prefers to return to this slot when this slot is empty. Set to -1 when without Loyalty enchantment.
    •  Trident: The the item that is given when the entity is picked up.
      • Tags common to item stack

Endermite[]

Additional fields for endermite:

  • : The entity's root tag.
    •  Lifetime: How long the endermite has existed in ticks. Disappears when this reaches around 2400.

Zombiefied Piglin[]

Additional fields for zombiefied piglin:

  • : The entity's root tag.
    •  Anger: Unknown.

Shulker[]

Additional fields for shulker:

Slime[]

Additional fields for slime:

  • : The entity's root tag.
    •  Size: The size of the slime. Note that this value is zero-based, so 0 is the smallest slime, 1 is the next larger, etc.

Rabbit[]

Additional fields for rabbit:

  • : The entity's root tag.
    •  MoreCarrotTicks: Set to 40 when a carrot crop is eaten, decreases by 0–2 every tick until it reaches 0.[needs testing]
    •  CarrotsEaten: Unknown.

Goat[]

Additional fields for goat:

  • : The entity's root tag.
    •  GoatHornCount: Unknown.

Ender Crystal[]

Additional fields for ender crystal:

  • : The entity's root tag.
    •  BlockTargetX: (May not exist) The block location its beam points to.
    •  BlockTargetY: (May not exist) See above.
    •  BlockTargetZ: (May not exist) See above.

Fireworks Rocket[]

Additional fields for firework rocket:

  • : The entity's root tag.
    •  Life: The number of ticks this fireworks rocket has been flying for.
    •  LifeTime: The number of ticks before this fireworks rocket explodes. This value is randomized when the firework is launched.[needs testing]

Item Entity[]

Additional fields for item entity:

  • : The entity's root tag.
    •  Health: The health of the item, which starts at 5. Items take damage from fire, lava, and explosions. The item is destroyed when its health reaches 0.[needs testing]
    •  Age: The number of ticks the item has been "untouched". After 6000 ticks (5 minutes) the item is destroyed. If set to -32768, the Age does not increase, preventing the item from despawning automatically.[needs testing]
    •  Item: The item of this stack.
      • Tags common to item stack
    •  OwnerID: If present, only the player[needs testing] with this Unique ID can pick up the item.

Wither[]

Additional fields for wither:

  • : The entity's root tag.
    •  Invul: The number of ticks of invulnerability left after being initially created. 0 once invulnerability has expired.[needs testing]
    •  AirAttack: Unknown.
    •  ShieldHealth: Unknown.
    •  Phase: Unknown.
    •  SpawningFrames: Unknown.
    •  maxHealth: Unknown.
    •  lastHealthInterval: Unknown.
    •  dyingFrames: Unknown.
    •  overlayAlpha: Unknown.
    •  swellAmount: Unknown.
    •  oldSwellAmount: Unknown.
    •  firerate: Unknown.

Bat[]

Additional fields for bat:

  • : The entity's root tag.
    •  BatFlags: Unknown.

Guardian and Elder Guardian[]

Additional fields for guardian and elder guardian:

  • : The entity's root tag.
    •  Elder: True if it is an elder guardian.

Experience Orb[]

Additional fields for experience orb:

  • : The entity's root tag.
    •  Age: The number of ticks the XP orb has been "untouched". After 6000 ticks (5 minutes) the orb is destroyed.[needs testing]
    •  experience value: The amount of experience the orb gives when picked up.

Falling Block[]

Additional fields for falling block:

  • : The entity's root tag.
    •  FallingBlock:
      • Tags common to block
    •  Time: The number of ticks the entity has existed. If set to 0, the moment it ticks to 1, it vanishes if the block at its location has a different ID than the entity's FallingBlock.Name. If the block at its location has the same ID as its FallingBlock.Name when Time ticks from 0 to 1, the block is deleted, and the entity continues to fall, having overwritten it. When Time goes above 600, or above 100 while the block is below Y=1 or is outside building height, the entity is deleted. [needs testing]
    •  Tale: Deprecated. The numeric id of the block.
    •  Date: Deprecated. The metadata of the block.

Enderman[]

Additional fields for enderman:

  • : The entity's root tag.
    •  carriedBlock: The block carried by the enderman.
      • Tags common to block
    •  carriedData: Deprecated. The numeric id of the block.
    •  carried: Deprecated. The metadata of the block.
Advertisement