Skip to main content

Entity NBT Format

NBT FORMAT (WIP)

Legend
Icon Meaning
string.png String
short.png Short
longArray.png Long Array
long.png Long
jsonObject.png JSON Object
integerArray.png Integer Array
integer.png Integer
float.png Float
double.png Double
byteArray.png Byte Array
byte.png Byte
boolean.png Boolean
array.png

Array

Format Tree

root label
jsonObject.png
 Where the NBT tree starts
identifier
string.png
 Defines entity type ID.

Example: "minecraft:pig".
definitions
array.png

Adds or removes components from the from the baseline entity components. These are entity mostly specific. + adds a component not on the base entity and - removes a component on the base entity.


Example: "+minecraft:can_ride_default"
UniqueID
long.png

Unique numerical ID of the entity used to identify it from others of it type.


Example: "-4294967289".
Pos
array.png

Shows numerical values as to the position of the entity in 3D space.
X
float.png

Shows the X position of the entity.
Y
float.png

Shows the Y position of the entity.
Z
float.png

Shows the Z position of the entity.
Rotation
array.png

Defines the orientation angle of the entity. 
Yaw
float.png

The orientation of the entity rotating clockwise around the X axis. (No more than 360°)
Pitch
float.png

The orientation of the entity rotating up and down along the Y axis. (No more than ±90°)
Motion
array.png

Defines the momentum assigned to a given entity.
dX
float.png

Defines momentum along the X axis.
dY
float.png

Defines momentum along the Y axis.
dZ
float.png

Defines momentum along the Z axis.
CustomNameVisible
boolean.png
 Shows a custom name given to an entity regardless if you are looking directly at them or not.
LastDimensionId
integer.png
 Last dimension visited by the entity. (Seemingly deprecated)
FallDistance
float.png
 Distance the entity has fallen.
Fire
short.png
 Number of ticks till the fire on the entity is extinguished.
OnGround
boolean.png
 Defines if an entity is in the state of being on the ground. (Not falling)
Invulnerable
boolean.png
 Makes the target entity unable to be harmed by any natural source. Entities with this tag cannot be moved by fishing rods. Creative players can deal damage regardless of the tag being applied to the target entity.
PortalCooldown
integer.png
 Number of ticks before a given entity can use a nether portal again.
IsGlobal
boolean.png
 Defines if the entity can function in unloaded chunks.
IsAutonomous
boolean.png
 Exact use is unknown.
LinksTag
array.png Defines a connection between a ride and a rider. 
entityID
long.png

Unique numerical ID of the rider entity the ride entity has linked to.


Example: "-3410204032983".
linkID
integer.png
 Numerical value used to determine which rider is which on the ride entity. (Starts at 0 and increments by 1 for each passenger) 
LootDropped
boolean.png Defines if an entity can or cannot drop loot. This is applied after the entity has received the Dead tag to ensure it doesn't drop loot more than once.
Color
byte.png Defines an entities color type. For example the difference between a black cat and a siamese cat is this value.
Color2
byte.png Defines an entities secondary color. Only tropical fish use this.
Strength
integer.png Defines how much a llama can carry. ( 3 * number = Items carriable ) 
StrengthMax
integer.png Does the same thing as "Strength" seemingly.
Sheared
boolean.png Defines whether a sheep is sheared. 
IsIllagerCaptain
boolean.png Defines whether an entity is an Illager Captain.
OwnerNew
long.png

Shows new owner ID. This is often for projectiles.

 

Example: "-4294967295"
OwnerID
long.png

Shows current owner ID. This is often for projectiles.

 

Example: "-4294967295"
Sitting
boolean.png

Defines whether an entity is sitting.
IsBaby
boolean.png

Defines whether an entity is in its baby variant.
IsTamed
boolean.png

Defines whether an entity is tame.
IsTrusting
boolean.png

Defines whether an entity is trusting of the player.
IsOrphaned
boolean.png

Defines whether an entity is spawned without parents.
IsAngry
boolean.png

Defines whether an entity is hostile when it is normally neutral.
IsOutOfControl
boolean.png

Is set to true when a player is controlling it and it is a ship.
Variant
integer.png

Defines entity variant type.
MarkVariant
integer.png

Defines the mark variant of an entity. 
Saddled
boolean.png

Is set to true when a player has mounted it and it is a living entity.
IsChested
boolean.png

Defines if a working animal such as a horse carries a chest on its back.
ShowBottom
boolean.png

Defines whether an end crystal shows the bedrock slab below it. (Used in the end dimension's crystals)
IsGliding
boolean.png

Defines whether an entity is in the gliding state with an elytra.
IsSwiming
boolean.png

Defines whether an entity is in the swimming state.
IsEating
boolean.png

Defines whether an entity is eating something.
IsScared
boolean.png

Defines whether an entity is in the scared state.
IsStunned
boolean.png

Defines whether ravager is stunned.
IsRoaring
boolean.png

Defines whether ravager is roaring.
SkinID
integer.png

Defines a villager/zombie villagers skin texture.
Persistent
boolean.png

Defines if an entity can or cannot despawn when out of the player's mob spawning radius.
Tags
array.png

Holds player applied tags that an entity has. (these are applied via /tag)
tag (not a real namespace)
string.png

Tag identifier

 

Example: "CanopyAdmin"
CustomDisplayTile
boolean.png

Set to true when a minecart is displaying a custom block.
DisplayBlock
jsonObject.png

Set to true when a minecart is displaying a custom block.
block (not a real namespace)
string.png

Block ID of a block to be displayed within the minecart.

 

Example: "minecraft:dirt"
DisplayOffset
integer.png

Number of pixels the display block of a minecart is offset along the Y axis.
Willing
boolean.png

Defines if a villager is willing to breed or not. This value is set to false for a period of time after breeding.
SpawnedByNight
boolean.png

Defines if a mob was spawned naturally by the night cycle or not.
ItemInHand
jsonObject.png

Defines what item an entity holding.
Count
integer.png

Count of items in the hand.
Name
string.png

Defines the item type in the hand.

 

Example: "minecraft:crossbow"
WasPickedUp
boolean.png

Defines if the entity got the item by picking it up.
Damage
short.png

This may say damage but it does not store the damage for the item.
CanPlaceOn
array.png

Defines what the item be placed on when the user is in Adventure mode.
block (not real namespace)
string.png

Block ID it can be placed on.

 

Example: "minecraft:stone"
CanDestroy
array.png

Defines what the item can break when the user is in Adventure mode.
block (Not real namespace)
string.png

Block ID it can destroy.

 

Example: "minecraft:stone"
tag
array.png

Defines additional properties.
Mainhand
array.png

Defines what item is in the entities mainhand.
item (not a real namespace)
jsonObject.png

Item object.
Count
integer.png

Count of items.
Name
string.png

Defines the item type.

 

Example: "minecraft:crossbow"
WasPickedUp
boolean.png

Defines if the entity got the item by picking it up.
Damage
short.png

This may say damage but it does not store the damage for the item.
CanPlaceOn
array.png

Defines what the item be placed on when the user is in Adventure mode.
block (not real namespace)
string.png

Block ID it can be placed on.

 

Example: "minecraft:stone"
CanDestroy
array.png

Defines what the item can break when the user is in Adventure mode.
block (Not real namespace)
string.png

Block ID it can destroy.

 

Example: "minecraft:stone"
tag
array.png

Defines additional properties.
Offhand
array.png

Defines what item is in the entities offhand.
item (not a real namespace)
jsonObject.png

Item object.
Count
integer.png

Count of items.
Name
string.png

Defines the item type.

 

Example: "minecraft:crossbow"
WasPickedUp
boolean.png

Defines if the entity got the item by picking it up.
Damage
short.png

This may say damage but it does not store the damage for the item.
CanPlaceOn
array.png

Defines what the item be placed on when the user is in Adventure mode.
block (not real namespace)
string.png

Block ID it can be placed on.

 

Example: "minecraft:stone"
CanDestroy
array.png

Defines what the item can break when the user is in Adventure mode.
block (Not real namespace)
string.png

Block ID it can destroy.

 

Example: "minecraft:stone"
tag
array.png

Defines additional properties.
limitedLife
long.png

Sets a number of ticks before an entity is deleted. 
TradeTier
integer.png

Defines a villagers trading level.
TradeExperience
integer.png

Defines a villagers experience progress to next level.
canPickupItems
boolean.png

Defines if an entity can pick up items.
hasSetCanPickupItems
boolean.png

Set to true if the canPickupItems component has been set by the game.
HurtTime
short.png

Duration an entity has the invulnerable tag set to true after taking damage. This also controls the duration in which the entity is red after taking damage.
DeathTime
short.png

Duration an entity executes its death animation to the player before deletion. 
Dead
boolean.png

Defines if the entity has died.
AttackTime
short.png

Ticks before attack cooldown is complete.
Surface
boolean.png

True if the entity has spawned naturally on the surface. (IE, surface cap)
portal_transition
jsonObject.png

Internally used entity NBT for transitioning entities between dimensions. This is used because when an entity enters the portal it's reference is destroyed, so it needs some way to know the conditions in which it entered the portal.
axis
integer.png

Saves the the axis in which the portal the entity entered is facing. (1 = z, 2 = x)
dimension
integer.png

Defines which dimension the entity is coming from (0 = overworld, 1 = nether, 2 = end)
X
float.png

Shows the X position the entity entered a portal at.
Y
float.png

Shows the Y position the entity entered a portal at.
Z
float.png

Shows the Z position the entity entered a portal at.
NaturalSpawn
boolean.png

True if the entity has spawned naturally via cave or surface cap.
TargetID
long.png

Unique numerical ID of an entity that this entity is targeting for some purpose.

Not all NBT tags are used in a standard entity, this just includes all known NBT tags and their known purpose.

No comments to display

Back to top