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.
ActiveEffects
array.png

Lists the entities potion effects it has on it.
Effect (Not A Real Namespace)
jsonObject.png

Effect json object
Ambient
boolean.png

True if the effect was applied by a beacon. This is to make the particles less invasive on the screen.
Amplifier
byte.png

The potion effect level. 0 is level 1.
DisplayOnScreenTextureAnimation
boolean.png
 Displays a screen animation when an effect is applied. This is used in bad omen, totems, and the hero of the village to display the floating icon once you get the effect.
Duration
integer.png
 Number of ticks before the effect wears off.
DurationEasy
integer.png
 Number of ticks before the effect wears off for Easy mode.
DurationNormal
integer.png
 Number of ticks before the effect wears off for Normal mode.
DurationNormal
integer.png
 Number of ticks before the effect wears off for Hard mode.
Id
byte.png

Numerical potion Id.

 

example: 28
ShowParticles
boolean.png

Defines if particles are shown or not.
FactorCalculationData
jsonObject.png

Unknown usage
change_timestamp
integer.png

Unknown
factor_current
float.png

Unknown
factor_previous
float.png Unknown
factor_start
float.png
 Unknown
factor_target
float.png
 Unknown
had_applied
byte.png
 Unknown
had_last_tick
byte.png
 Unknown
padding_duration
integer.png

Unknown
IsInRaid
boolean.png

Boolean only present in villagers that defines if the villager is currently in a raid.
ReactToBell
boolean.png

Defines if a villager will react to a bell ringing and go to its home or not.
TargetCaptainID
long.png

Unique numerical ID of the Illager captain of a patrol. Used by pillagers in patrols.


Example: "-4294967289".
isCreative
boolean.png

Defines if a given projectile was fired from a player in creative mode. (Only projectiles have this)
enchantPower
byte.png

Defines the power level given to an arrow by the power enchantment on the shooters bow.
enchantPunch
byte.png

Defines the punch level given to an arrow by the power enchantment on the shooters bow.
enchantFlame
byte.png

Defines the flame level given to an arrow by the power enchantment on the shooters bow.
enchantInfinity
byte.png

Defines the infinity level given to an arrow by the power enchantment on the shooters bow.
MobEffects
array.png

List of effects that a given entity can pass onto others. This does not apply to itself. (Used in area effect clouds and tipped arrows)
Effect (Not A Real Namespace)
jsonObject.png

Effect json object
Ambient
boolean.png

True if the effect was applied by a beacon. This is to make the particles less invasive on the screen.
Amplifier
byte.png

The potion effect level. 0 is level 1.
DisplayOnScreenTextureAnimation
boolean.png
 Displays a screen animation when an effect is applied. This is used in bad omen, totems, and the hero of the village to display the floating icon once you get the effect.
Duration
integer.png
 Number of ticks before the effect wears off.
DurationEasy
integer.png
 Number of ticks before the effect wears off for Easy mode.
DurationNormal
integer.png
 Number of ticks before the effect wears off for Normal mode.
DurationNormal
integer.png
 Number of ticks before the effect wears off for Hard mode.
Id
byte.png

Numerical potion Id.

 

example: 28
ShowParticles
boolean.png

Defines if particles are shown or not.
FactorCalculationData
jsonObject.png

Unknown usage
change_timestamp
integer.png

Unknown
factor_current
float.png

Unknown
factor_previous
float.png Unknown
factor_start
float.png
 Unknown
factor_target
float.png
 Unknown
had_applied
byte.png
 Unknown
had_last_tick
byte.png
 Unknown
padding_duration
integer.png

Unknown
auxValue
byte.png

Defines a numerical ID for what arrow type it is, whether it is tipped and with what potion.

 

example: 23    (Healing II)
SelectedInventorySlot
integer.png Numerical ID of a slot selected in a players inventory.
SelectedContainerId
integer.png Numerical ID of a container selected by the player. 
Sleeping
boolean.png Defines if the player is sleeping or not.
SleepTimer
short.png Defines for how long the player has been sleeping in a bed.
SpawnBlockPositionX
integer.png

Defines the X location for the players respawn block like a bed or respawn anchor.
SpawnBlockPositionY
integer.png

Defines the Y location for the players respawn block like a bed or respawn anchor.
SpawnBlockPositionZ
integer.png

Defines the Z location for the players respawn block like a bed or respawn anchor.
SpawnDimension
integer.png

Defines what dimension the player's spawn point is located in.
SpawnX
integer.png

Defines the X location for the players respawn point.
SpawnY
integer.png

Defines the Y location for the players respawn point.
SpawnZ
integer.png

Defines the Z location for the players respawn point.
EnchantmentSeed
integer.png

RNG seed for enchantment tables to deterministically give you the same enchantments.
RideID
long.png

Unique numerical ID of an entity that the player is riding.
LeftShoulderRiderID
long.png

Unique numerical ID of an entity that the player has on its left shoulder.
RightShoulderRiderID
long.png

Unique numerical ID of an entity that the player has on its right shoulder.
PlayerGameMode
integer.png

Numerical ID of the gamemode the player is in currently.
PlayerLevel
integer.png

How many experience levels the player has.
PlayerLevelProgress
integer.png

How much experience progress a player has to the next level.

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

Revision #8
Created 2025-10-26 01:26:19 UTC by Nytreon
Updated 2025-11-09 00:36:18 UTC by Nytreon