Entity metadata

Various Entities have different metadata fields and status codes.

Unmerged information

Unmerged content from 1.14.4. This needs to be merged eventually but I don't want to do it now.

Entity metadata shifted in 19w08a; not all entities are copied here. All subclasses of entity had shift of 1; all subclasses of living had a second shift (2 total). All entities listed in the article have been updated, but there are ones not listed here.

Entity Metadata Format

Note that entity metadata is a totally distinct concept from block metadata. It is not required to send all metadata fields, or even any metadata fields, so long as the terminating entry is correctly sent.

Entity Metadata is an array of entries, each of which looks like the following:

Name	Type	Meaning
Index	Unsigned Byte	Unique index key determining the meaning of the following value, see the table below. If this is 0xff then the it is the end of the Entity Metadata array and no more is read.
Type	Optional VarInt Enum	Only if Index is not 0xff; the type of the index, see the table below
Value	Optional value of Type	Only if Index is not 0xff: the value of the metadata field

Value of Type field	Type of Value field	Notes
0	Byte
1	VarInt
2	Float
3	String
4	Chat
5	OptChat (Boolean + Optional Chat)	Chat is present if the Boolean is set to true
6	Slot
7	Boolean
8	Rotation	3 floats: rotation on x, rotation on y, rotation on z
9	Position
10	OptPosition (Boolean + Optional Position)	Position is present if the Boolean is set to true
11	Direction (VarInt)	(Down = 0, Up = 1, North = 2, South = 3, West = 4, East = 5)
12	OptUUID (Boolean + Optional UUID)	UUID is present if the Boolean is set to true
13	OptBlockID (VarInt)	0 for absent otherwise, id << 4 | data
14	NBT
15	Particle
16	Villager Data	3 VarInts: villager type, villager profession, level
17	OptVarInt	0 for absent; 1 + actual value otherwise. Used for entity IDs.
18	Pose	A VarInt enum: 0: STANDING, 1: FALL_FLYING, 2: SLEEPING, 3: SWIMMING, 4: SPIN_ATTACK, 5: SNEAKING, 6: DYING

Villager type (minecraft:villager_type registry):

Name	ID
minecraft:desert	0
minecraft:jungle	1
minecraft:plains	2
minecraft:savanna	3
minecraft:snow	4
minecraft:swamp	5
minecraft:taiga	6

Villager professions (minecraft:villager_profession registry):

Name	ID
minecraft:none	0
minecraft:armorer	1
minecraft:butcher	2
minecraft:cartographer	3
minecraft:cleric	4
minecraft:farmer	5
minecraft:fisherman	6
minecraft:fletcher	7
minecraft:leatherworker	8
minecraft:librarian	9
minecraft:mason	10
minecraft:nitwit	11
minecraft:shepherd	12
minecraft:toolsmith	13
minecraft:weaponsmith	14

Mobs

Entity IDs have shifted with the addition of some new mobs.

Entity

The base class.

Index	Type	Meaning		Default
0	Byte	Bit mask	Meaning	0
		0x01	On Fire
		0x02	Crouched
		0x04	Unused (previously riding)
		0x08	Sprinting
		0x10	Swimming
		0x20	Invisible
		0x40	Glowing effect
		0x80	Flying with elytra
1	VarInt	Air		300
2	OptChat	Custom name		empty
3	Boolean	Is custom name visible		false
4	Boolean	Is silent		false
5	Boolean	No gravity		false
6	Pose	Pose		STANDING

Itemed Throwable

Extends Throwable.

Used for all things that previously extended throwable other than potions, which already had an item.

Index	Type	Meaning		Default
7	Slot	Item		empty (which behaves as if it were a specific item, depending on the subclass)

Egg

Extends Itemed Throwable.

No additional metadata.

An empty item behaves as if the item were a minecraft:egg.

Ender Pearl

Extends Itemed Throwable.

No additional metadata.

An empty item behaves as if the item were a minecraft:ender_pearl.

Experience Bottle

Extends Itemed Throwable.

No additional metadata.

minecraft:experience_bottle

Snowball

Extends Itemed Throwable.

No additional metadata.

minecraft:snowball

Eye of Ender

Extends Entity.

Index	Type	Meaning		Default
7	Slot	Item		empty (which behaves as if it were a minecraft:ender_eye)

Arrow

Extends Entity.

Abstract base class for TippedArrow (which is used for regular arrows as well as tipped ones) and Spectral Arrow.

Index	Type	Meaning		Default
6 7	Byte	Bit mask	Meaning	0
		0x01	Is critical
		0x02	Is noclip (used by loyalty tridents when returning)
7 8	OptUUID	Shooter UUID		Empty
9	Byte	Piercing level		0

TippedArrow

Extends Arrow.

Used for both tipped and regular arrows. If not tipped, then color is set to -1 and no tipped arrow particles are used.

Index	Type	Meaning		Default
8 10	VarInt	Color (-1 for no particles)		-1

Trident

Extends Arrow.

Index	Type	Meaning		Default
8 10	VarInt	Loyalty level (enchantment)		0

Itemed Fireball

Extends Entity.

Used for regular and small fireballs. Not used for dragon fireballs and wither skulls. Interestingly, regular fireballs do not come from an item.

Index	Type	Meaning		Default
7	Slot	Item		empty (which behaves as if it were a minecraft:fire_charge)

Fireball

Extends Abstract Fireball Itemed Fireball. This is the large fireball shot by ghasts.

No additional metadata.

Small Fireball

Extends Abstract Fireball Itemed Fireball. This is the fireball shot by blazes and dispensers with fire charges.

No additional metadata.

Fireworks

Extends Entity.

Index	Type	Meaning		Default
6 7	Slot	Firework info		empty
7 8	VarInt OptVarInt	Entity ID of entity which used firework (for elytra boosting)		0
9	Boolean	Shot at angle (from a crossbow)		false

Living

Extends Entity.

Index	Type	Meaning		Default
6 7	Byte	Hand states, used to trigger blocking/eating/drinking animation.		0
		Bit mask	Meaning
		0x01	Is hand active
		0x02	Active hand (0 = main hand, 1 = offhand)
		0x04	In riptide spin attack
7 8	Float	Health		1.0
8 9	VarInt	Potion effect color (or 0 if there is no effect)		0
9 10	Boolean	Is potion effect ambient: reduces the number of particles generated by potions to 1/5 the normal amount		false
10 11	VarInt	Number of arrows in entity		0
12	OptBlockPos	Unknown (Bed location?)		Absent

Panda

Extends Animal.

Index	Type	Meaning		Default
15	Integer	Breed timer? Set to 32 when something happens, and then counts down to 0 again. At 29 and 14 (before counting down), will play the entity.panda.cant_breed sound event.		0
16	Integer	Sneeze timer. Counts up from 0; when it hits 1 the entity.panda.pre_sneeze event plays and when it hits 21 the entity.panda.sneeze event plays (and it is set back to 0 and the sneeze flag is cleared).		0
17	Integer	Eat timer. If nonzero, counts upwards.		0
18	Byte	Main Gene		0
19	Byte	Hidden Gene		0
20	Byte	Bit mask	Meaning	0
		0x01	Unused
		0x02	Is sneezing
		0x04	Is eating
		0x08	Unknown
		0x10	Unknown

Fox

Extends Animal.

Index	Type	Meaning		Default
15	VarInt	Type (0: red, 1: snow)		0 (red)
16	Byte	Bit mask	Meaning	0
		0x01	Sitting
		0x02	Unused
		0x04	Crouching
		0x08	Unknown
		0x10	Unknown
		0x20	Sleeping
		0x40	Unknown
		0x80	Unknown
17	OptUUID	First UUID (in UUIDs NBT)?		Absent
18	OptUUID	Second UUID (in UUIDs NBT)?		Absent

Mooshroom

Extends Cow.

No additional metadata.

Index	Type	Meaning		Default
15	String	Variant ("red" or "brown")		red

Raid Participant

Extends Monster.

Index	Type	Meaning		Default
14	boolean	Is celebrating		false

"Is celebrating" appears to control the pose for vindicators and does not appear to be used by other types.

Abstract Illager

Extends Monster Raid Participant.

Index	Type	Meaning		Default
12	Byte	Bit mask	Meaning	0
		0x01	Has target (aggressive state)

Replaced with pose (presumably?)

Spellcaster Illager

Extends Abstract Illlager.

Index	Type	Meaning		Default
13 15	Byte	Spell (0: none, 1: summon vex, 2: attack, 3: wololo, 4: disappear, 5: blindness)		0

EvocationIllager Evoker

Extends Spellcaster Illager.

IllusionIllager Illusioner

Extends Spellcaster Illager.

Pillager

Extends Abstract Illlager.

Index	Type	Meaning		Default
15	Boolean	Using crossbow		false

VindicationIllager Vindicator

Extends Abstract Illager.

Ravager

Extends Raid Participant

No additional metadata.

Status	Description
4	Starts the attack animation.
39	Starts the stun animation.

Witch

Extends Monster Raid Participant.

Index	Type	Meaning		Default
12 15	Boolean	Is drinking potion		false

AbstractSkeleton

Extends Monster.

Index	Type	Meaning		Default
12 14	Boolean	Is swinging arms		false

Replaced with pose (presumably?)

Zombie

Extends Monster.

Index	Type	Meaning		Default
12 14	Boolean	Is baby		false
13 15	VarInt	Unused (previously type)		0
14	Boolean	Are hands held up		false
15 16	Boolean	Is becoming a drowned		false

Replaced with pose (presumably?)

Zombie Villager

Extends Zombie.

Index	Type	Meaning		Default
16 17	Boolean	Is converting		false
17 18	VarInt Villager Data	Profession Villager Data		0 Plains/None/1

Ocelot

Extends TameableAnimal Ageable.

Index	Type	Meaning		Default
15	VarInt	Type (0 = untamed, 1 = tuxedo, 2 = tabby, 3 = siamese). Used to render regardless as to whether it is tamed or not.		0
15	Boolean	Is trusting		false

Status	Description
40	Spawn smoke particles (trust gaining failed)
41	Spawn heart particles (trust gaining succeeded)

Cat

Extends TameableAnimal.

Index	Type	Meaning		Default
17	VarInt	Type (0 = tabby, 1 = black, 2 = red, 3 = siamese, 4 = british_shorthair, 5 = calico, 6 = persian, 7 = ragdoll, 8 = white, 9 = all_black)		1
18	Boolean	Unknown		false
19	Boolean	Unknown		false
20	VarInt	Collar color (values are those used with dyes)		14 (Red)

Horse

Extends AbstractHorse.

Index	Type	Meaning		Default
15 17	VarInt	Variant (Color & Style)		0
16	VarInt	Armor (0: none, 1: iron, 2: gold, 3: diamond)		0 (none)
17	Slot	Armor Item (Forge only)		Empty

Replaced with Entity Equipment packet. (Uses chestplate slot)

Trader Llama

Extends Llama.

No additional metadata.

Abstract Merchant

Extends Ageable.

Index	Type	Meaning		Default
15	VarInt	Head shake timer (starts at 40, decrements each tick)		0

Villager

Extends Ageable Abstract Merchant.

Index	Type	Meaning		Default
13 16	VarInt Villager Data	Villager Data		0 Plains/None/1

Wandering Trader

Extends Abstract Merchant.

No additional metadata.

Bee

Extends Animal.

Index	Type	Meaning		Default
16	Byte	Bit mask	Meaning	0
		0x01	Unused
		0x02	Looping
		0x04	Has lost stung
		0x08	Has nectar
17	VarInt	Anger time in ticks		0 (Not angry)

Mobs

Mobs are spawned via Spawn Mob.

Some entities (marked in yellow) should only be spawned using Spawn Object and their Object ID. While they also have an entity ID, this ID is only used internally. Servers should not attempt to spawn these entities using Spawn Mob with that entity ID, although clients should accept such packets if they appear.

Additionally, a few other entities (marked in blue) must be spawned in their own special ways:

• Paintings should be spawned using Spawn Painting
• XP orbs should be spawned using Spawn Experience Orb.

Type	Name	bounding box x and z	bounding box y	ID
0	AreaEffectCloud	2.0 * Radius	0.5	minecraft:area_effect_cloud
1	ArmorStand	normal: 0.5 marker: 0.0 small: 0.25	normal: 1.975 marker: 0.0 small: 0.9875	minecraft:armor_stand
2	Arrow	0.5	0.5	minecraft:arrow
3	Bat	0.5	0.9	minecraft:bat
4	Blaze	0.6	1.8	minecraft:blaze
5	Boat	1.375	0.5625	minecraft:boat
6	CaveSpider	0.7	0.5	minecraft:cave_spider
7	Chicken	0.4	0.7	minecraft:chicken
8	Cod	0.9	1.4	minecraft:cod
9	Cow	0.9	1.4	minecraft:cow
10	Creeper	0.6	1.7	minecraft:creeper
11	Donkey	1.3964844	1.6	minecraft:donkey
12	Dolphin	0.9	0.6	minecraft:dolphin
13	DragonFireball	1.0	1.0	minecraft:dragon_fireball
14	Drowned	?	?	minecraft:drowned
15	ElderGuardian	1.9975 (2.35 * guardian)	1.9975 (2.35 * guardian)	minecraft:elder_guardian
16	EnderCrystal	2.0	2.0	minecraft:end_crystal
17	EnderDragon	16.0	8.0	minecraft:ender_dragon
18	Enderman	0.6	2.9	minecraft:enderman
19	Endermite	0.4	0.3	minecraft:endermite
20	EvocationFangs	0.5	0.8	minecraft:evoker_fangs
21	EvocationIllager	0.6	1.95	minecraft:evoker
22	XPOrb	0.5	0.5	minecraft:experience_orb
23	EyeOfEnderSignal	0.25	0.25	minecraft:eye_of_ender
24	FallingSand	0.98	0.98	minecraft:falling_block
25	FireworksRocketEntity	0.25	0.25	minecraft:fireworks_rocket
26	Ghast	4	4	minecraft:ghast
27	Giant	3.6	10.8	minecraft:giant
28	Guardian	0.85	0.85	minecraft:guardian
29	Horse (EntityHorse until 1.11)	1.3964844	1.6	minecraft:horse
30	Husk	0.6	1.95	minecraft:husk
31	IllusionIllager	0.6	1.95	minecraft:illusioner
32	Item	0.25	0.25	minecraft:item
33	ItemFrame	0.75 or 0.0625 (depth)	0.75	minecraft:item_frame
34	Fireball (ghast)	1.0	1.0	minecraft:fireball
35	LeashKnot	0.375	0.5	minecraft:leash_knot
36	Llama	0.9	1.87	minecraft:llama
37	LlamaSpit	0.25	0.25	minecraft:llama_spit
38	LavaSlime (Magma Cube)	0.51000005 * size	0.51000005 * size	minecraft:magma_cube
39	MinecartRideable	0.98	0.7	minecraft:minecart
40	MinecartChest	0.98	0.7	minecraft:chest_minecart
41	MinecartCommandBlock	0.98	0.7	minecraft:commandblock_minecart
42	MinecartFurnace	0.98	0.7	minecraft:furnace_minecart
43	MinecartHopper	0.98	0.7	minecraft:hopper_minecart
44	MinecartSpawner	0.98	0.7	minecraft:spawner_minecart
45	MinecartTNT	0.98	0.7	minecraft:tnt_minecart
46	Mule	1.3964844	1.6	minecraft:mule
47	MushroomCow (Mooshroom)	0.9	1.4	minecraft:mooshroom
48	Ozelot (Ocelot)	0.6	0.7	minecraft:ocelot
49	Painting	type width or 0.0625 (depth)	type height	minecraft:painting
50	Parrot	0.5	0.9	minecraft:parrot
51	Pig	0.9	0.9	minecraft:pig
52	Pufferfish	?	?	minecraft:pufferfish
53	PigZombie	0.6	1.95	minecraft:zombie_pigman
54	PolarBear	1.3	1.4	minecraft:polar_bear
55	PrimedTnt	0.98	0.98	minecraft:tnt
56	Rabbit	0.4	0.5	minecraft:rabbit
57	Salmon	?	?	minecraft:salmon
58	Sheep	0.9	1.3	minecraft:sheep
59	Shulker	1.0	1.0-2.0 (depending on peek)	minecraft:shulker
60	ShulkerBullet	0.3125	0.3125	minecraft:shulker_bullet
61	Silverfish	0.4	0.3	minecraft:silverfish
62	Skeleton	0.6	1.99	minecraft:skeleton
63	SkeletonHorse	1.3964844	1.6	minecraft:skeleton_horse
64 (67: 1.14)	Slime	0.51000005 * size	0.51000005 * size	minecraft:slime
65	SmallFireball (blaze)	0.3125	0.3125	minecraft:small_fireball
66	SnowMan	0.7	1.9	minecraft:snow_golem
67	Snowball	0.25	0.25	minecraft:snowball
68	SpectralArrow	0.5	0.5	minecraft:spectral_arrow
69	Spider	1.4	0.9	minecraft:spider
70	Squid	0.8	0.8	minecraft:squid
71	Stray	0.6	1.99	minecraft:stray
72	Tropical Fish	0.5	0.4	minecraft:tropical_fish
73	Turtle	1.2	0.4	minecraft:turtle
74	ThrownEgg	0.25	0.25	minecraft:egg
75	ThrownEnderpearl	0.25	0.25	minecraft:ender_pearl
76	ThrownExpBottle	0.25	0.25	minecraft:experience_bottle
77	ThrownPotion	0.25	0.25	minecraft:potion
78	Vex	0.4	0.8	minecraft:vex
79	Villager	0.6	1.95	minecraft:villager
80	VillagerGolem (Iron Golem)	1.4	2.7	minecraft:iron_golem}
81	VindicationIllager	0.6	1.95	minecraft:vindicator
82	Witch	0.6	1.95	minecraft:witch
83	WitherBoss	0.9	3.5	minecraft:wither
84	WitherSkeleton	0.7	2.4	minecraft:wither_skeleton
85	WitherSkull	0.3125	0.3125	minecraft:wither_skull
86	Wolf	0.6	0.85	minecraft:wolf
87	Zombie	0.6	1.95	minecraft:zombie
88	ZombieHorse	1.3964844	1.6	minecraft:zombie_horse
89	ZombieVillager	0.6	1.95	minecraft:zombie_villager
90	Phantom	0.9	0.5	minecraft:phantom
91	Lightning Bolt	-	-	minecraft:lightning_bolt
92	Player	0.8	1.8	minecraft:player
93	Fishing bobber	?	?	minecraft:fishing_bobber
94	Trident	?	?	minecraft:trident

Objects

Objects are spawned via Spawn Object. See Object Data for more details.

Object IDs and Entity IDs are different. Most objects also have an entity ID, but should only ever be spawned via Spawn Object.

ID	Name	bounding box x and z	bounding box y
1	Boat	1.375	0.6
2	Item Stack (Slot)	0.25	0.25
3	Area Effect Cloud	2.0 * Radius	0.5
10	Minecart	0.98	0.7
50	Activated TNT	0.98	0.98
51	EnderCrystal	2.0	2.0
60	Tipped arrow (projectile; also used for regular arrows)	0.5	0.5
61	Snowball (projectile)	0.25	0.25
62	Egg (projectile)	0.25	0.25
63	FireBall (ghast projectile)	1.0	1.0
64	FireCharge (blaze projectile)	0.3125	0.3125
65	Thrown Enderpearl	0.25	0.25
66	Wither Skull (projectile)	0.3125	0.3125
67	Shulker Bullet	0.3125	0.3125
68	Llama spit	0.25	0.25
70	Falling Objects	0.98	0.98
71	Item frames	0.75 or 0.0625	0.75
72	Eye of Ender	0.25	0.25
73	Thrown Potion	0.25	0.25
75	Thrown Exp Bottle	0.25	0.25
76	Firework Rocket	0.25	0.25
77	Leash Knot	0.375	0.5
78	ArmorStand	normal: 0.5 marker: 0.0 small: 0.25	normal: 1.975 marker: 0.0 small: 0.9875
79	Evocation Fangs	0.5	0.8
90	Fishing Hook	0.25	0.25
91	Spectral Arrow	0.5	0.5
93	Dragon Fireball	1.0	1.0
94	Trident	?	?

Since release 1.6, all minecarts are spawned with object type 10 and their functionality is then specified in the Data field within the packet. Also, their visual appearance may be sent via the Entity Metadata packet.

Entity Metadata Format

Note that entity metadata is a totally distinct concept from block metadata. It is not required to send all metadata fields, or even any metadata fields, so long as the terminating entry is correctly sent.

Entity Metadata is an array of entries, each of which looks like the following:

Name	Type	Meaning
Index	Unsigned Byte	Unique index key determining the meaning of the following value, see the table below. If this is 0xff then the it is the end of the Entity Metadata array and no more is read.
Type	Optional VarInt Enum	Only if Index is not 0xff; the type of the index, see the table below
Value	Optional value of Type	Only if Index is not 0xff: the value of the metadata field

Value of Type field	Type of Value field	Notes
0	Byte
1	VarInt
2	Float
3	String
4	Chat
5	OptChat (Boolean + Optional Chat)	Chat is present if the Boolean is set to true
6	Slot
7	Boolean
8	Rotation	3 floats: rotation on x, rotation on y, rotation on z
9	Position
10	OptPosition (Boolean + Optional Position)	Position is present if the Boolean is set to true
11	Direction (VarInt)	(Down = 0, Up = 1, North = 2, South = 3, West = 4, East = 5)
12	OptUUID (Boolean + Optional UUID)	UUID is present if the Boolean is set to true
13	OptBlockID (VarInt)	0 for absent (implies air); otherwise, a block state ID as per the global palette
14	NBT
15	Particle

Entity classes also recursively inherit fields from classes they extend.

Entity

The base class.

Index	Type	Meaning		Default
0	Byte	Bit mask	Meaning	0
		0x01	On Fire
		0x02	Crouched
		0x04	Unused (previously riding)
		0x08	Sprinting
		0x10	Swimming
		0x20	Invisible
		0x40	Glowing effect
		0x80	Flying with elytra
1	VarInt	Air		300
2	OptChat	Custom name		empty
3	Boolean	Is custom name visible		false
4	Boolean	Is silent		false
5	Boolean	No gravity		false

Throwable

Extends Entity.

No additional metadata.

Egg

Extends Throwable.

No additional metadata.

Ender Pearl

Extends Throwable.

No additional metadata.

Experience Bottle

Extends Throwable.

No additional metadata.

Snowball

Extends Throwable.

No additional metadata.

Potion

Extends Throwable.

Index	Type	Meaning		Default
6	Slot	Potion which is thrown		Empty

Eye of Ender

Extends Entity.

No additional metadata.

FallingBlock

Extends Entity.

Index	Type	Meaning		Default
6	Position	spawn position		(0, 0, 0)

AreaEffectCloud

Extends Entity.

Index	Type	Meaning		Default
6	Float	Radius		0.5
7	VarInt	Color (only for mob spell particle)		0
8	Boolean	Ignore radius and show effect as single point, not area		false
9	Particle	The #Particle		effect

FishingHook

Extends Entity.

Index	Type	Meaning		Default
6	VarInt	Hooked entity id + 1, or 0 if there is no hooked entity		0

Arrow

Extends Entity.

Abstract base class for TippedArrow (which is used for regular arrows as well as tipped ones) and Spectral Arrow.

Index	Type	Meaning		Default
6	Byte	Bit mask	Meaning	0
		0x01	Is critical
		0x02	Is noclip (used by loyalty tridents when returning)
7	OptUUID	Shooter UUID		Empty

TippedArrow

Extends Arrow.

Used for both tipped and regular arrows. If not tipped, then color is set to -1 and no tipped arrow particles are used.

Index	Type	Meaning		Default
8	VarInt	Color (-1 for no particles)		-1

Trident

Extends Arrow.

Index	Type	Meaning		Default
8	VarInt	Loyalty level (enchantment)		0

Boat

Extends Entity.

Index	Type	Meaning		Default
6	VarInt	Time since last hit		0
7	VarInt	Forward direction		1
8	Float	Damage taken		0.0
9	VarInt	Type (0=oak, 1=spruce, 2=birch, 3=jungle, 4=acacia, 5=dark oak)		0
10	Boolean	Left paddle turning		false
11	Boolean	Right paddle turning		false
12	VarInt	Splash timer		0

EnderCrystal

Extends Entity.

Index	Type	Meaning		Default
6	OptPosition	Beam target		Absent
7	Boolean	Show bottom		true

Abstract Fireball

Extends Entity.

No additional metadata.

Dragon Fireball

Extends Abstract Fireball.

No additional metadata.

Fireball

Extends Abstract Fireball. This is the large fireball shot by ghasts.

No additional metadata.

Small Fireball

Extends Abstract Fireball. This is the fireball shot by blazes and dispensers with fire charges.

No additional metadata.

WitherSkull

Extends Abstract Fireball.

Index	Type	Meaning		Default
6	Boolean	Invulnerable		false

Fireworks

Extends Entity.

Index	Type	Meaning		Default
6	Slot	Firework info		empty
7	VarInt	Entity ID of entity which used firework (for elytra boosting)		0

Hanging

Extends Entity.

No additional metadata.

ItemFrame

Extends Hanging.

Index	Type	Meaning		Default
6	Slot	Item		Empty
7	VarInt	Rotation		0

Item

Extends Entity.

Index	Type	Meaning		Default
6	Slot	Item		Empty

Living

Extends Entity.

Index	Type	Meaning		Default
6	Byte	Hand states, used to trigger blocking/eating/drinking animation.		0
		Bit mask	Meaning
		0x01	Is hand active
		0x02	Active hand (0 = main hand, 1 = offhand)
		0x04	In riptide spin attack
7	Float	Health		1.0
8	VarInt	Potion effect color (or 0 if there is no effect)		0
9	Boolean	Is potion effect ambient: reduces the number of particles generated by potions to 1/5 the normal amount		false
10	VarInt	Number of arrows in entity		0

Player

Extends Living.

Index	Type	Meaning		Default
11	Float	Additional Hearts		0.0
12	VarInt	Score		0
13	Byte	The Displayed Skin Parts bit mask that is sent in Client Settings		0
		Bit mask	Meaning
		0x01	Cape enabled
		0x02	Jacket enabled
		0x04	Left sleeve enabled
		0x08	Right sleeve enabled
		0x10	Left pants leg enabled
		0x20	Right pants leg enabled
		0x40	Hat enabled
		0x80	Unused
14	Byte	Main hand (0 : Left, 1 : Right)		1
15	NBT	Left shoulder entity data (for occupying parrot)		Empty
16	NBT	Right shoulder entity data (for occupying parrot)		Empty

ArmorStand

Extends Living.

Index	Type	Meaning		Default
11	Byte	Bit mask	Meaning	0
		0x01	is Small
		0x04	has Arms
		0x08	no BasePlate
		0x10	set Marker
12	Rotation	Head rotation		(0.0, 0.0, 0.0)
13	Rotation	Body rotation		(0.0, 0.0, 0.0)
14	Rotation	Left arm rotation		(-10.0, 0.0, -10.0)
15	Rotation	Right arm rotation		(-15.0, 0.0, 10.0)
16	Rotation	Left leg rotation		(-1.0, 0.0, -1.0)
17	Rotation	Right leg rotation		(1.0, 0.0, 1.0)

Note that armor stands with the invisible flag from the base entity class set also cannot be attacked or damaged, except for by the void.

Insentient

Extends Living.

Index	Type	Meaning		Default
11	Byte	Bit mask	Meaning	0
		0x01	NoAI
		0x02	Left handed

Ambient

Extends Insentient.

No additional metadata.

Bat

Extends Ambient.

Index	Type	Meaning		Default
12	Byte	Bit mask	Meaning	0
		0x01	Is hanging

Creature

Extends Insentient.

No additional metadata.

WaterMob

Extends Creature.

No additional metadata.

Squid

Extends WaterMob.

No additional metadata.

Dolphin

Extends WaterMob.

Index	Type	Meaning		Default
12	Position	Treasure position		(0, 0, 0)
13	Boolean	Can find treasure		false
14	Boolean	Has fish		false

Abstract fish

Extends WaterMob.

Index	Type	Meaning		Default
12	Boolean	From bucket		False

Cod

Extends Abstract fish.

No additional metadata.

Puffer fish

Extends Abstract fish.

Index	Type	Meaning		Default
13	VarInt	PuffState (varies from 0 to 2)		0

Salmon

Extends Abstract fish.

No additional metadata.

Tropical fish

Extends Abstract fish.

Index	Type	Meaning		Default
13	VarInt	Variant		0

Ageable

Extends Creature.

Index	Type	Meaning		Default
12	Boolean	Is baby		false

Animal

Extends Ageable.

No additional metadata.

AbstractHorse

Extends Animal.

Index	Type	Meaning		Default
13	Byte	Bit mask	Meaning	0
		0x01	Unused
		0x02	Is Tame
		0x04	Is saddled
		0x08	Has bred
		0x10	Is eating
		0x20	Is rearing (on hind legs)
		0x40	Is mouth open
		0x80	Unused
14	OptUUID	Owner		Absent

Horse

Extends AbstractHorse.

Index	Type	Meaning		Default
15	VarInt	Variant (Color & Style)		0
16	VarInt	Armor (0: none, 1: iron, 2: gold, 3: diamond)		0 (none)
17	Slot	Armor Item (Forge only)		Empty

ZombieHorse

Extends AbstractHorse.

SkeletonHorse

Extends AbstractHorse.

ChestedHorse

Extends AbstractHorse.

Index	Type	Meaning		Default
15	Boolean	Has Chest		false

Donkey

Extends ChestedHorse.

Llama

Extends ChestedHorse.

Index	Type	Meaning		Default
16	VarInt	Strength (number of columns of 3 slots in the llama's inventory once a chest is equipped)		0
17	VarInt	Carpet color (a dye color, or -1 if no carpet equipped)		-1
18	VarInt	Variant (0: llama_creamy.png, 1: llama_white.png, 2: llama_brown.png, 3: llama_gray.png)		0

Mule

Extends ChestedHorse.

Pig

Extends Animal.

Index	Type	Meaning		Default
13	Boolean	Has saddle		false
14	VarInt	Total time to "boost" with a carrot on a stick for		0

Whenever a carrot on a stick is used, if the pig is not currently boosting it will start to boost for 140 to 980 (inclusive) ticks. When boost time is changed, a counter is reset which counts up to the boost time, after which boosting will stop. The value remains set at its modified value even after boosting is stopped.

Rabbit

Extends Animal.

Index	Type	Meaning		Default
13	VarInt	Type		0

Turtle

Extends Animal.

Index	Type	Meaning		Default
13	BlockPos	Home pos		(0, 0, 0)
14	Boolean	Has egg		false
15	Boolean	Laying egg		false
16	BlockPos	Travel pos		(0, 0, 0)
17	Boolean	Going home		false
18	Boolean	Traveling		false

Polar Bear

Extends Animal.

Index	Type	Meaning		Default
13	Boolean	Standing up		false

Chicken

Extends Animal.

No additional metadata.

Cow

Extends Animal.

No additional metadata.

Mooshroom

Extends Cow.

No additional metadata.

Sheep

Extends Animal.

Index	Type	Meaning		Default
13	Byte	Bit mask	Meaning	0
		0x0F	Color (matches dye damage values)
		0x10	Is sheared

TameableAnimal

Extends Animal.

Index	Type	Meaning		Default
13	Byte	Bit mask	Meaning	0
		0x01	Is sitting
		0x02	Is angry (only used with wolves)
		0x04	Is tamed
14	OptUUID	Owner		Absent

Ocelot

Extends TameableAnimal.

Index	Type	Meaning		Default
15	VarInt	Type (0 = untamed, 1 = tuxedo, 2 = tabby, 3 = siamese). Used to render regardless as to whether it is tamed or not.		0

Wolf

Extends TameableAnimal.

Index	Type	Meaning		Default
15	Float	Damage taken (used for tail rotation)		Value of health field (1.0)
16	Boolean	Is begging		false
17	VarInt	Collar color (values are those used with dyes)		14 (Red)

Parrot

Extends TameableAnimal.

Index	Type	Meaning		Default
15	VarInt	Variant (0: red/blue, 1: blue, 2: green, 3: yellow/blue, 4: grey)		0

Villager

Extends Ageable.

Index	Type	Meaning		Default
13	VarInt	Profession (Farmer = 0, Librarian = 1, Priest = 2, Blacksmith = 3, Butcher = 4, Nitwit = 5)		0

Golem

Extends Creature.

No additional metadata.

IronGolem

Extends Golem.

Index	Type	Meaning		Default
12	Byte	Bit mask	Meaning	0
		0x01	Is player-created

Snowman

Extends Golem.

Index	Type	Meaning		Default
12	Byte	Bit mask	Meaning	0x10
		0x10	has pumpkin hat
		0x00	has no pumpkin hat

Shulker

Extends Golem.

Index	Type	Meaning		Default
12	Direction	Attach face		Down (0)
13	OptPosition	Attachment position		Absent
14	Byte	Shield height		0
15	Byte	Color (dye color)		10 (purple)

Monster

Extends Creature.

No additional metadata.

Blaze

Extends Monster.

Index	Type	Meaning		Default
12	Byte	Bit mask	Meaning	0
		0x01	Is on fire

Creeper

Extends Monster.

Index	Type	Meaning		Default
12	VarInt	State (-1 = idle, 1 = fuse)		-1
13	Boolean	Is charged		false
14	Boolean	Is ignited		false

Endermite

Extends Monster.

No additional metadata.

Giant Zombie

Extends Monster.

No additional metadata.

Guardian

Extends Monster.

Index	Type	Meaning		Default
12	Boolean	Is retracting spikes		false
13	VarInt	Target EID		0

ElderGuardian

Extends Guardian.

Silverfish

Extends Monster.

No additional metadata.

Abstract Illager

Extends Monster.

Index	Type	Meaning		Default
12	Byte	Bit mask	Meaning	0
		0x01	Has target (aggressive state)

VindicationIllager

Extends Abstract Illager.

Spellcaster Illager

Extends Abstract Illager.

Index	Type	Meaning		Default
13	Byte	Spell (0: none, 1: summon vex, 2: attack, 3: wololo, 4: disappear, 5: blindness)		0

EvocationIllager

Extends Spellcaster Illager.

IllusionIllager

Extends Spellcaster Illager.

Vex

Extends Monster.

Index	Type	Meaning		Default
12	Byte	Bit mask	Meaning	0
		0x01	Is in attack mode

EvocationFangs

Extends Entity.

No additional metadata.

AbstractSkeleton

Extends Monster.

Index	Type	Meaning		Default
12	Boolean	Is swinging arms		false

Skeleton

Extends AbstractSkeleton.

Wither Skeleton

Extends AbstractSkeleton.

Stray

Extends AbstractSkeleton.

Spider

Extends Monster.

Index	Type	Meaning		Default
12	Byte	Bit mask	Meaning	0
		0x01	Is climbing

Witch

Extends Monster.

Index	Type	Meaning		Default
12	Boolean	Is drinking potion		false

Wither

Extends Monster.

Index	Type	Meaning		Default
12	VarInt	Center head's target (entity ID, or 0 if no target)		0
13	VarInt	Left head's target (entity ID, or 0 if no target)		0
14	VarInt	Right head's target (entity ID, or 0 if no target)		0
15	VarInt	Invulnerable time		0

Zombie

Extends Monster.

Index	Type	Meaning		Default
12	Boolean	Is baby		false
13	VarInt	Unused (previously type)		0
14	Boolean	Are hands held up		false
15	Boolean	Is becoming a drowned		false

Zombie Villager

Extends Zombie.

Index	Type	Meaning		Default
16	Boolean	Is converting		false
17	VarInt	Profession		0

Husk

Extends Zombie.

No additional metadata.

Drowned

Extends Zombie.

No additional metadata.

Enderman

Extends Monster.

Index	Type	Meaning		Default
12	Opt BlockID	Carried block		Absent
13	Boolean	Is screaming		false

EnderDragon

Extends Insentient.

Index	Type	Meaning		Default
12	VarInt	Dragon phase		10 (hover)

Phases (according to the wiki page on dragon data values) are:

• 0: circling
• 1: strafing (preparing to shoot a fireball)
• 2: flying to the portal to land (part of transition to landed state)
• 3: landing on the portal (part of transition to landed state)
• 4: taking off from the portal (part of transition out of landed state)
• 5: landed, performing breath attack
• 6: landed, looking for a player for breath attack
• 7: landed, roar before beginning breath attack
• 8: charging player
• 9: flying to portal to die
• 10: hovering with no AI (default when using the /summon command).

Flying

Extends Insentient.

No additional metadata.

Ghast

Extends Flying.

Index	Type	Meaning		Default
12	Boolean	Is attacking		false

Phantom

Extends Flying.

Index	Type	Meaning		Default
12	VarInt	Size		0

Hitbox size is determined by horizontal=0.9 + 0.2*size and vertical=0.5 + 0.1 * i

Slime

Extends Insentient.

Index	Type	Meaning		Default
12	VarInt	Size		1

LlamaSpit

Extends Entity.

Minecart

Extends Entity.

Index	Type	Meaning		Default
6	VarInt	Shaking power		0
7	VarInt	Shaking direction		1
8	Float	Shaking multiplier		0.0
9	VarInt	Custom block ID and damage		0
10	VarInt	Custom block Y position (in 16ths of a block)		6
11	Boolean	Show custom block		false

If show custom block is false, then each type of Minecart will render its own type of block with its own properties. Note that one does not need to send these values for the metadata fields, as the client will automatically select them if show custom block is false. They are only provided for reference to help with swapping out other blocks.

• Rideable Minecarts contain air (0:0) and have a y position of 6
• Chest Minecarts contain chests facing north (54:0) and have a y position of 8
• Furnace Minecarts contain a normal furnace facing north when unpowered (61:0) and a lit furnace facing north when powered (62:0) and have a y position of 6 in both cases
• Hopper Minecarts contain a hopper (154:0) and have a y position of 1
• TNT Minecarts contain TNT (46:0) and have a y position of 6
• Command block minecarts contain a Command Block (137:0) and have a y position of 6
• Spawner Minecarts contain a spawner (52:0) and have a y position of 6

MinecartRideable

Extends Minecart.

No additional metadata.

MinecartContainer

Extends Minecart.

No additional metadata.

MinecartHopper

Extends MinecartContainer.

No additional metadata.

MinecartChest

Extends MinecartContainer.

No additional metadata.

MinecartFurnace

Extends Minecart.

Index	Type	Meaning		Default
12	Boolean	Has fuel		false

MinecartTNT

Extends Minecart.

No additional metadata.

MinecartSpawner

Extends Minecart.

No additional metadata.

MinecartCommandBlock

Extends Minecart.

Index	Type	Meaning		Default
12	String	Command
13	Chat	Last output		{"text":""}

TNTPrimed

Extends Entity.

Index	Type	Meaning		Default
6	VarInt	Fuse time		80