Java Edition protocol/Entity metadata

Various Entities have different metadata fields and status codes.

These are the valid codes for Minecraft Java Edition 1.21.9; for upcoming snapshots, see Pre-release protocol#Entity Metadata.

This page is maintained semi-automatically using a work-in-progress script made by mat, so it should update fairly quickly to new Minecraft versions. Regardless, it's not recommended that you parse it programmatically. Instead, consider using Bixilon's PixLyzer or Burger (or mat's Burger fork, which the script for updating this page depends on).

Entities

Most entities are spawned via Protocol#Spawn Entity, however, care should be taken for the following cases:

Entities marked in __ blue must be spawned in their own special ways:

• Experience Orb, should be spawned using Spawn Experience Orb

Entities marked in __ red must not be spawned at all, as they're server-side only:

• Marker, more info can be found here.

Type	Name	bounding box x and z	bounding box y	ID
0	Acacia Boat	1.375	0.5625	minecraft:acacia_boat
1	Acacia Boat with Chest	1.375	0.5625	minecraft:acacia_chest_boat
2	Allay	0.35	0.6	minecraft:allay
3	Area Effect Cloud	2.0 * Radius	0.5	minecraft:area_effect_cloud
4	Armadillo	0.7	0.65	minecraft:armadillo
5	Armor Stand	normal: 0.5 marker: 0.0 small: 0.25	normal: 1.975 marker: 0.0 small: 0.9875	minecraft:armor_stand
6	Arrow	0.5	0.5	minecraft:arrow
7	Axolotl	0.75	0.42	minecraft:axolotl
8	Bamboo Raft with Chest	1.375	0.5625	minecraft:bamboo_chest_raft
9	Bamboo Raft	1.375	0.5625	minecraft:bamboo_raft
10	Bat	0.5	0.9	minecraft:bat
11	Bee	0.7	0.6	minecraft:bee
12	Birch Boat	1.375	0.5625	minecraft:birch_boat
13	Birch Boat with Chest	1.375	0.5625	minecraft:birch_chest_boat
14	Blaze	0.6	1.8	minecraft:blaze
15	Block Display	0.0	0.0	minecraft:block_display
16	Bogged	0.6	1.99	minecraft:bogged
17	Breeze	0.6	1.77	minecraft:breeze
18	Wind Charge	0.3125	0.3125	minecraft:breeze_wind_charge
19	Camel	1.7	2.375	minecraft:camel
20	Cat	0.6	0.7	minecraft:cat
21	Cave Spider	0.7	0.5	minecraft:cave_spider
22	Cherry Boat	1.375	0.5625	minecraft:cherry_boat
23	Cherry Boat with Chest	1.375	0.5625	minecraft:cherry_chest_boat
24	Minecart with Chest	0.98	0.7	minecraft:chest_minecart
25	Chicken	0.4	0.7	minecraft:chicken
26	Cod	0.5	0.3	minecraft:cod
27	Copper Golem	0.49	0.98	minecraft:copper_golem
28	Minecart with Command Block	0.98	0.7	minecraft:command_block_minecart
29	Cow	0.9	1.4	minecraft:cow
30	Creaking	0.9	2.7	minecraft:creaking
31	Creeper	0.6	1.7	minecraft:creeper
32	Dark Oak Boat	1.375	0.5625	minecraft:dark_oak_boat
33	Dark Oak Boat with Chest	1.375	0.5625	minecraft:dark_oak_chest_boat
34	Dolphin	0.9	0.6	minecraft:dolphin
35	Donkey	1.3964844	1.5	minecraft:donkey
36	Dragon Fireball	1.0	1.0	minecraft:dragon_fireball
37	Drowned	0.6	1.95	minecraft:drowned
38	Thrown Egg	0.25	0.25	minecraft:egg
39	Elder Guardian	1.9975 (2.35 * guardian)	1.9975 (2.35 * guardian)	minecraft:elder_guardian
40	Enderman	0.6	2.9	minecraft:enderman
41	Endermite	0.4	0.3	minecraft:endermite
42	Ender Dragon	16.0	8.0	minecraft:ender_dragon
43	Thrown Ender Pearl	0.25	0.25	minecraft:ender_pearl
44	End Crystal	2.0	2.0	minecraft:end_crystal
45	Evoker	0.6	1.95	minecraft:evoker
46	Evoker Fangs	0.5	0.8	minecraft:evoker_fangs
47	Thrown Bottle o' Enchanting	0.25	0.25	minecraft:experience_bottle
48	Experience Orb	0.5	0.5	minecraft:experience_orb
49	Eye of Ender	0.25	0.25	minecraft:eye_of_ender
50	Falling Block	0.98	0.98	minecraft:falling_block
51	Fireball	1.0	1.0	minecraft:fireball
52	Firework Rocket	0.25	0.25	minecraft:firework_rocket
53	Fox	0.6	0.7	minecraft:fox
54	Frog	0.5	0.5	minecraft:frog
55	Minecart with Furnace	0.98	0.7	minecraft:furnace_minecart
56	Ghast	4.0	4.0	minecraft:ghast
57	Happy Ghast	4.0	4.0	minecraft:happy_ghast
58	Giant	3.6	12.0	minecraft:giant
59	Glow Item Frame	0.75 or 0.0625 (depth)	0.75	minecraft:glow_item_frame
60	Glow Squid	0.8	0.8	minecraft:glow_squid
61	Goat	1.3	0.9	minecraft:goat
62	Guardian	0.85	0.85	minecraft:guardian
63	Hoglin	1.3964844	1.4	minecraft:hoglin
64	Minecart with Hopper	0.98	0.7	minecraft:hopper_minecart
65	Horse	1.3964844	1.6	minecraft:horse
66	Husk	0.6	1.95	minecraft:husk
67	Illusioner	0.6	1.95	minecraft:illusioner
68	Interaction	0.0	0.0	minecraft:interaction
69	Iron Golem	1.4	2.7	minecraft:iron_golem
70	Item	0.25	0.25	minecraft:item
71	Item Display	0.0	0.0	minecraft:item_display
72	Item Frame	0.75 or 0.0625 (depth)	0.75	minecraft:item_frame
73	Jungle Boat	1.375	0.5625	minecraft:jungle_boat
74	Jungle Boat with Chest	1.375	0.5625	minecraft:jungle_chest_boat
75	Leash Knot	0.375	0.5	minecraft:leash_knot
76	Lightning Bolt	0.0	0.0	minecraft:lightning_bolt
77	Llama	0.9	1.87	minecraft:llama
78	Llama Spit	0.25	0.25	minecraft:llama_spit
79	Magma Cube	0.5202 * size	0.5202 * size	minecraft:magma_cube
80	Mangrove Boat	1.375	0.5625	minecraft:mangrove_boat
81	Mangrove Boat with Chest	1.375	0.5625	minecraft:mangrove_chest_boat
82	Mannequin	0.6	1.8	minecraft:mannequin
83	Marker	0.0	0.0	minecraft:marker
84	Minecart	0.98	0.7	minecraft:minecart
85	Mooshroom	0.9	1.4	minecraft:mooshroom
86	Mule	1.3964844	1.6	minecraft:mule
87	Oak Boat	1.375	0.5625	minecraft:oak_boat
88	Oak Boat with Chest	1.375	0.5625	minecraft:oak_chest_boat
89	Ocelot	0.6	0.7	minecraft:ocelot
90	Ominous Item Spawner	0.25	0.25	minecraft:ominous_item_spawner
91	Painting	type width or 0.0625 (depth)	type height	minecraft:painting
92	Pale Oak Boat	1.375	0.5625	minecraft:pale_oak_boat
93	Pale Oak Boat with Chest	1.375	0.5625	minecraft:pale_oak_chest_boat
94	Panda	1.3	1.25	minecraft:panda
95	Parrot	0.5	0.9	minecraft:parrot
96	Phantom	0.9	0.5	minecraft:phantom
97	Pig	0.9	0.9	minecraft:pig
98	Piglin	0.6	1.95	minecraft:piglin
99	Piglin Brute	0.6	1.95	minecraft:piglin_brute
100	Pillager	0.6	1.95	minecraft:pillager
101	Polar Bear	1.4	1.4	minecraft:polar_bear
102	Splash Potion	0.25	0.25	minecraft:splash_potion
103	Lingering Potion	0.25	0.25	minecraft:lingering_potion
104	Pufferfish	0.7	0.7	minecraft:pufferfish
105	Rabbit	0.4	0.5	minecraft:rabbit
106	Ravager	1.95	2.2	minecraft:ravager
107	Salmon	0.7	0.4	minecraft:salmon
108	Sheep	0.9	1.3	minecraft:sheep
109	Shulker	1.0	1.0-2.0 (depending on peek)	minecraft:shulker
110	Shulker Bullet	0.3125	0.3125	minecraft:shulker_bullet
111	Silverfish	0.4	0.3	minecraft:silverfish
112	Skeleton	0.6	1.99	minecraft:skeleton
113	Skeleton Horse	1.3964844	1.6	minecraft:skeleton_horse
114	Slime	0.5202 * size	0.5202 * size	minecraft:slime
115	Small Fireball	0.3125	0.3125	minecraft:small_fireball
116	Sniffer	1.9	1.75	minecraft:sniffer
117	Snowball	0.25	0.25	minecraft:snowball
118	Snow Golem	0.7	1.9	minecraft:snow_golem
119	Minecart with Monster Spawner	0.98	0.7	minecraft:spawner_minecart
120	Spectral Arrow	0.5	0.5	minecraft:spectral_arrow
121	Spider	1.4	0.9	minecraft:spider
122	Spruce Boat	1.375	0.5625	minecraft:spruce_boat
123	Spruce Boat with Chest	1.375	0.5625	minecraft:spruce_chest_boat
124	Squid	0.8	0.8	minecraft:squid
125	Stray	0.6	1.99	minecraft:stray
126	Strider	0.9	1.7	minecraft:strider
127	Tadpole	0.4	0.3	minecraft:tadpole
128	Text Display	0.0	0.0	minecraft:text_display
129	Primed TNT	0.98	0.98	minecraft:tnt
130	Minecart with TNT	0.98	0.7	minecraft:tnt_minecart
131	Trader Llama	0.9	1.87	minecraft:trader_llama
132	Trident	0.5	0.5	minecraft:trident
133	Tropical Fish	0.5	0.4	minecraft:tropical_fish
134	Turtle	1.2	0.4	minecraft:turtle
135	Vex	0.4	0.8	minecraft:vex
136	Villager	0.6	1.95	minecraft:villager
137	Vindicator	0.6	1.95	minecraft:vindicator
138	Wandering Trader	0.6	1.95	minecraft:wandering_trader
139	Warden	0.9	2.9	minecraft:warden
140	Wind Charge	0.3125	0.3125	minecraft:wind_charge
141	Witch	0.6	1.95	minecraft:witch
142	Wither	0.9	3.5	minecraft:wither
143	Wither Skeleton	0.7	2.4	minecraft:wither_skeleton
144	Wither Skull	0.3125	0.3125	minecraft:wither_skull
145	Wolf	0.6	0.85	minecraft:wolf
146	Zoglin	1.3964844	1.4	minecraft:zoglin
147	Zombie	0.6	1.95	minecraft:zombie
148	Zombie Horse	1.3964844	1.6	minecraft:zombie_horse
149	Zombie Villager	0.6	1.95	minecraft:zombie_villager
150	Zombified Piglin	0.6	1.95	minecraft:zombified_piglin
151	Player	0.6	1.8	minecraft:player
152	Fishing Bobber	0.25	0.25	minecraft:fishing_bobber

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	VarInt Enum	Only if Index is not 0xff; the type of the index, see the table below
Value	Varies	Only if Index is not 0xff: the value of the metadata field, see the table below

Type	Name	Value	Notes
0	Byte	Byte
1	VarInt	VarInt
2	VarLong	VarLong
3	Float	Float
4	String	String (32767)
5	Text Component	Text Component
6	Optional Text Component	(Boolean, Optional Text Component)	Text Component is present if the Boolean is set to true.
7	Slot	Slot
8	Boolean	Boolean
9	Rotations	(Float, Float, Float)	rotation on x, rotation on y, rotation on z
10	Position	Position
11	Optional Position	(Boolean, Optional Position)	Position is present if the Boolean is set to true.
12	Direction	VarInt Enum	Down = 0, Up = 1, North = 2, South = 3, West = 4, East = 5
13	Optional Living Entity Reference	(Boolean, Optional UUID)	UUID is present if the Boolean is set to true.
14	Block State	VarInt	An ID in the block state registry.
15	Optional Block State	VarInt	0 for absent (air is unrepresentable); otherwise, an ID in the block state registry.
16	Particle	(VarInt, Varies)	particle type (an ID in the minecraft:particle_type registry), particle data (See Particles.)
17	Particles	(VarInt, Array of (VarInt, Varies))	length-prefixed list of particle defintions (as above).
18	Villager Data	(VarInt, VarInt, VarInt)	villager type, villager profession, level (See below.)
19	Optional VarInt	VarInt	0 for absent; 1 + actual value otherwise. Used for entity IDs.
20	Pose	VarInt Enum	STANDING = 0, FALL_FLYING = 1, SLEEPING = 2, SWIMMING = 3, SPIN_ATTACK = 4, SNEAKING = 5, LONG_JUMPING = 6, DYING = 7, CROAKING = 8, USING_TONGUE = 9, SITTING = 10, ROARING = 11, SNIFFING = 12, EMERGING = 13, DIGGING = 14, (1.21.3: SLIDING = 15, SHOOTING = 16, INHALING = 17)
21	Cat Variant	VarInt	An ID in the minecraft:cat_variant registry.
22	Cow Variant	VarInt	An ID in the minecraft:cow_variant registry.
23	Wolf Variant	VarInt	An ID in the minecraft:wolf_variant registry.
24	Wolf Sound Variant	VarInt	An ID in the minecraft:wolf_sound_variant registry.
25	Frog Variant	VarInt	An ID in the minecraft:frog_variant registry.
26	Pig Variant	VarInt	An ID in the minecraft:pig_variant registry.
27	Chicken Variant	VarInt	An ID in the minecraft:chicken_variant registry.
28	Optional Global Position	(Boolean, Optional Identifier, Optional Position)	dimension identifier, position; only if the Boolean is set to true.
29	Painting Variant	ID or Painting Variant	An ID in the minecraft:painting_variant registry, or an inline definition.
30	Sniffer State	VarInt Enum	IDLING = 0, FEELING_HAPPY = 1, SCENTING = 2, SNIFFING = 3, SEARCHING = 4, DIGGING = 5, RISING = 6
31	Armadillo State	VarInt Enum	IDLE = 0, ROLLING = 1, SCARED = 2, UNROLLING = 3
32	Copper Golem State	Varint Enum	IDLE = 0, GETTING_ITEM = 1, GETTING_NO_ITEM = 2, DROPPING_ITEM = 3, DROPPING_NO_ITEM = 4
33	Weathering Copper State	Varint Enum	UNAFFECTED = 0, EXPOSED = 1, WEATHERED = 2, OXIDIZED = 3
34	Vector3	(Float, Float, Float)	x, y, z
35	Quaternion	(Float, Float, Float, Float)	x, y, z, w
36	Resolvable Profile	Resolvable Profile

Villager types (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

Wolf Variant

Name	Type	Meaning
Wild texture	Identifier	The texture for the wild version of this wolf. The Notchian client uses the corresponding asset located at textures.
Tame texture	Identifier	The texture for the tamed version of this wolf. The Notchian client uses the corresponding asset located at textures.
Angry texture	Identifier	The texture for the angry version of this wolf. The Notchian client uses the corresponding asset located at textures.
Biomes	ID Set	Biomes in which this wolf can spawn in (IDs in the minecraft:biome registry).

Painting Variant

Name	Type	Meaning
Width	Int	The width of the painting, in blocks.
Height	Int	The height of the painting, in blocks.
Asset ID	Identifier	The texture for the painting. The Notchian client uses the corresponding asset located at textures/painting.
Title	Prefixed Optional Text Component	The displayed title of the painting. Only present if Has title is true.
Author	Prefixed Optional Text Component	The displayed author of the painting. Only present if Has author is true.

Resolvable Profile

Name	Type	Meaning
Profile Kind	VarInt Enum	Defines how the next field is read; either partial or complete.
Unpack	Varies	Profile Kind Name Type Description 0 Partial Username Prefixed Optional String (16) UUID Prefixed Optional UUID Properties Name Prefixed Array (16) String (64) Value String (32767) Signature Prefixed Optional String (1024) 1 Complete Game Profile
Body	Optional Identifier	An override for the skin texture to use, from the player's textures directory.
Cape	Optional Identifier	An override for the cape texture to use, same format as body.
Elytra	Optional Identifier	An override for the elyta texture to use, same format as body.
Model	Optional VarInt	WIDE = 0, SLIM = 1

Entity Metadata

Entity

The base class.

Index	Type	Meaning		Default
0	Byte (0)	Bit mask	Meaning	0
		0x01	Is on fire
		0x02	Is pressing sneak key (hides the name tag, but does not make the entity visually sneak.)
		0x04	Unused (previously riding)
		0x08	Is sprinting (shows sprinting particles when on ground.)
		0x10	Is swimming
		0x20	Is invisible
		0x40	has glowing effect
		0x80	Is flying with an elytra
1	VarInt (1)	Air ticks		300
2	Optional Text Component (6)	Custom name		empty
3	Boolean (8)	Is custom name visible		false
4	Boolean (8)	Is silent		false
5	Boolean (8)	Has no gravity		false
6	Pose (20)	Pose		STANDING
7	VarInt (1)	Ticks frozen in powder snow		0

On the Notchan server Is pressing sneak key reflects the sneak key state indicated by the client rather than the entity's pose, and can thus be set while swimming, flying or crawling, or unset while stuck sneaking under a block.

Freezing ticks cap at 140 in the client for the player's snow overlay when stuck in powder snow. If the entity extends LivingEntity and freezing ticks reaches the cap, the mob will start shaking (this excludes the skeleton, which has its own indicator).

Area Effect Cloud

Extends Entity.

Index	Type	Meaning		Default
8	Float (3)	Radius		3.0
9	Boolean (8)	Ignore radius and show effect as single point, not area		false
10	Particle (16)	The particle		-1

Wind Charge

Extends Entity.

No additional metadata.

Dragon Fireball

Extends Entity.

No additional metadata.

End Crystal

Extends Entity.

Index	Type	Meaning		Default
8	Optional Position (11)	Beam target		Empty
9	Boolean (8)	Show bottom		true

Evoker Fangs

Extends Entity.

No additional metadata.

Experience Orb

Extends Entity.

Index	Type	Meaning		Default
8	VarInt (1)	The amount of experience this orb will reward once collected.		0

Eye of Ender

Extends Entity.

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

Falling Block

Extends Entity.

Index	Type	Meaning		Default
8	Position (10)	spawn position		(0, 0, 0)

Fireball

Extends Entity.

This is the large fireball shot by ghasts.

Index	Type	Meaning		Default
8	Slot (7)	Item		Empty

Firework Rocket

Extends Entity.

Index	Type	Meaning		Default
8	Slot (7)	Firework info		Empty
9	Optional VarInt (19)	Entity ID of entity which used firework (for elytra boosting)		Empty
10	Boolean (8)	Is shot at angle (from a crossbow)		false

Interaction

Extends Entity.

Index	Type	Meaning		Default
8	Float (3)	Width		1.0
9	Float (3)	Height		1.0
10	Boolean (8)	Responsive - can be attacked/interacted with if true		false

Item

Extends Entity.

Index	Type	Meaning		Default
8	Slot (7)	Item		Empty

Item Frame

Extends Entity.

Index	Type	Meaning		Default
8	Direction (12)	Direction		SOUTH
9	Slot (7)	Item		Empty
10	VarInt (1)	Rotation		0

Glow Item Frame

Extends Item Frame.

No additional metadata.

Leash Knot

Extends Entity.

No additional metadata.

Lightning Bolt

Extends Entity.

No additional metadata.

Llama Spit

Extends Entity.

No additional metadata.

Marker

Extends Entity.

No additional metadata.

Ominous Item Spawner

Extends Entity.

Index	Type	Meaning		Default
8	Slot (7)	Item		Empty

Painting

Extends Entity.

Index	Type	Meaning		Default
8	Direction (12)			SOUTH
9	Painting Variant (29)	Painting Type		KEBAB

Shulker Bullet

Extends Entity.

No additional metadata.

Small Fireball

Extends Entity.

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

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

Primed TNT

Extends Entity.

Index	Type	Meaning		Default
8	VarInt (1)	Fuse time		80
9	Block State (14)	The block state ID that is exploding		TNT

Wind Charge

Extends Entity.

No additional metadata.

Wither Skull

Extends Entity.

Index	Type	Meaning		Default
8	Boolean (8)	Is invulnerable		false

Fishing Bobber

Extends Entity.

Index	Type	Meaning		Default
8	VarInt (1)	Hooked entity id + 1, or 0 if there is no hooked entity		0
9	Boolean (8)	Is catchable		False

Abstract Arrow

Extends Entity.

Index	Type	Meaning		Default
8	Byte (0)	Bit mask	Meaning	0
		0x01	Is critical
		0x02	Is noclip (used by loyalty tridents when returning)
9	Byte (0)	Piercing level		0
10	Boolean (8)	Is in ground		false

Arrow

Extends Abstract 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
11	VarInt (1)	Color (-1 for no particles)		-1

Spectral Arrow

Extends Abstract Arrow.

No additional metadata.

Trident

Extends Abstract Arrow.

Index	Type	Meaning		Default
11	Byte (0)	Loyalty level (enchantment)		0
12	Boolean (8)	Has enchantment glint		False

Display

Extends Entity.

Index	Type	Meaning		Default
8	VarInt (1)	Interpolation delay		0
9	VarInt (1)	Transformation interpolation duration		0
10	VarInt (1)	Position/Rotation interpolation duration		0
11	Vector3 (34)	Translation		(0.0, 0.0, 0.0)
12	Vector3 (34)	Scale		(1.0, 1.0, 1.0)
13	Quaternion (35)	Rotation left		(0.0, 0.0, 0.0, 1.0)
14	Quaternion (35)	Rotation right		(0.0, 0.0, 0.0, 1.0)
15	Byte (0)	Billboard Constraints (FIXED = 0, VERTICAL = 1, HORIZONTAL = 2, CENTER = 3)		0
16	VarInt (1)	Brightness override (blockLight << 4 | skyLight << 20)		-1
17	Float (3)	View range		1.0
18	Float (3)	Shadow radius		0.0
19	Float (3)	Shadow strength		1.0
20	Float (3)	Width		0.0
21	Float (3)	Height		0.0
22	VarInt (1)	Glow color override		-1

Block Display

Extends Display.

Index	Type	Meaning		Default
23	Block State (14)	Displayed block state		0 (Air)

Item Display

Extends Display.

Index	Type	Meaning		Default
23	Slot (7)	Displayed item		Empty
24	Byte (0)	Display type: NONE = 0 THIRD_PERSON_LEFT_HAND = 1 THIRD_PERSON_RIGHT_HAND = 2 FIRST_PERSON_LEFT_HAND = 3 FIRST_PERSON_RIGHT_HAND = 4 HEAD = 5 GUI = 6 GROUND = 7 FIXED = 8		0 (NONE)

Text Display

Extends Display.

Index	Type	Meaning		Default
23	Text Component (5)	Text		Empty
24	VarInt (1)	Line width		200
25	VarInt (1)	Background color		1073741824 (0x40000000)
26	Byte (0)	Text opacity		-1 (fully opaque)
27	Byte (0)	Bit mask	Meaning	0
		0x01	Has shadow
		0x02	Is see through
		0x04	Use default background color
		0x08	Alignment: CENTER = 0 LEFT = 1 or 3 RIGHT = 2

Living Entity

Extends Entity.

Index	Type	Meaning		Default
8	Byte (0)	Hand states, used to trigger blocking/eating/drinking animation.		0
		Bit mask	Meaning
		0x01	Is hand active
		0x02	Active hand (main hand = 0, offhand = 1)
		0x04	Is in riptide spin attack
9	Float (3)	Health		1.0
10	Particles (17)	Potion effect color (or 0 if there is no effect)		0
11	Boolean (8)	Is potion effect ambient: reduces the number of particles generated by potions to 1/5 the normal amount		false
12	VarInt (1)	Number of arrows in entity		0
13	VarInt (1)	Number of bee stingers in entity		0
14	Optional Position (11)	Location of the bed that the entity is currently sleeping in (Empty if it isn't sleeping)		Empty

Armor Stand

Extends Living Entity.

Index	Type	Meaning		Default
15	Byte (0)	Bit mask	Meaning	0
		0x01	Is Small
		0x02	Unused
		0x04	Has Arms
		0x08	Has no BasePlate
		0x10	Is Marker
16	Rotations (9)	Head rotation		(0.0, 0.0, 0.0)
17	Rotations (9)	Body rotation		(0.0, 0.0, 0.0)
18	Rotations (9)	Left arm rotation		(-10.0, 0.0, -10.0)
19	Rotations (9)	Right arm rotation		(-15.0, 0.0, 10.0)
20	Rotations (9)	Left leg rotation		(-1.0, 0.0, -1.0)
21	Rotations (9)	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.

Avatar

Extends Living Entity.

Index	Type	Meaning		Default
15	Byte (0)	Main hand (0: left, 1: right)		right (1)
16	Byte (0)	The Displayed Skin Parts bit mask that is sent in Client Information		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

Mannequin

Extends Avatar.

Index	Type	Meaning		Default
17	Resolvable Profile (36)	The player's skin and display name		Partial profile with all fields empty
18	Boolean (8)	Immovable		false
19	Optional Text Component (6)	The description text below the player's username, usually "NPC"		Empty

Player

Extends Avatar.

Index	Type	Meaning		Default
17	Float (3)	Additional Hearts		0.0
18	VarInt (1)	Score		0
19	Optional VarInt (19)	Left shoulder entity data (for occupying parrot)		Empty
20	Optional VarInt (19)	Right shoulder entity data (for occupying parrot)		Empty

Mob

Extends Living Entity.

Index	Type	Meaning		Default
15	Byte (0)	Bit mask	Meaning	0
		0x01	NoAI
		0x02	Is left handed
		0x04	Is aggressive

Bat

Extends Mob.

Index	Type	Meaning		Default
16	Byte (0)	Bit mask	Meaning	0
		0x01	Is hanging

Ender Dragon

Extends Mob.

Index	Type	Meaning		Default
16	VarInt (1)	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).

Ghast

Extends Mob.

Index	Type	Meaning		Default
16	Boolean (8)	Is attacking		false

Phantom

Extends Mob.

Index	Type	Meaning		Default
16	VarInt (1)	Size		0

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

Slime

Extends Mob.

Index	Type	Meaning		Default
16	VarInt (1)	Size		1

Magma Cube

Extends Slime.

No additional metadata.

Creature

Extends Mob.

No additional metadata.

Allay

Extends Creature.

Index	Type	Meaning		Default
16	Boolean (8)	Is dancing		false
17	Boolean (8)	Can duplicate		true

Copper Golem

Extends Creature.

Index	Type	Meaning		Default
16	Weathering Copper State (33)	Weathering state		UNAFFECTED
17	Copper Golem State (32)	Copper golem state		IDLE

Iron Golem

Extends Creature.

Index	Type	Meaning		Default
16	Byte (0)	Bit mask	Meaning	0
		0x01	Is player-created

Pufferfish

Extends Creature.

Index	Type	Meaning		Default
16	Boolean (8)	From bucket		false
17	VarInt (1)	Puff state (0: small, 1: mid, 2: full)		0

Shulker

Extends Creature.

Index	Type	Meaning		Default
16	Direction (12)	Attach face		Down (0)
17	Byte (0)	Shield height		0
18	Byte (0)	Color (dye color)		16

Snow Golem

Extends Creature.

Index	Type	Meaning		Default
16	Byte (0)	Bit mask	Meaning	0x10
		0x01	Unused
		0x02	Unused
		0x04	Unused
		0x08	Unused
		0x10	Has pumpkin hat

Tadpole

Extends Creature.

Index	Type	Meaning		Default
16	Boolean (8)	Is from bucket		false

Ageable Mob

Extends Creature.

Index	Type	Meaning		Default
16	Boolean (8)	Is baby		false

Dolphin

Extends Ageable Mob.

Index	Type	Meaning		Default
17	Boolean (8)	Has fish		false
18	VarInt (1)	Moisture level		2400

Squid

Extends Ageable Mob.

No additional metadata.

Glow Squid

Extends Squid.

Index	Type	Meaning		Default
17	VarInt (1)	Dark ticks remaining		0

Animal

Extends Ageable Mob.

No additional metadata.

Armadillo

Extends Animal.

Index	Type	Meaning		Default
17	Armadillo State (31)	Armadillo state		IDLE

Axolotl

Extends Animal.

Index	Type	Meaning		Default
17	VarInt (1)	Variant (lucy = 0, wild = 1, gold = 2, cyan = 3, blue = 4)		0 (lucy)
18	Boolean (8)	If it is currently playing dead.		false
19	Boolean (8)	If it was spawned from a bucket.		false

Bee

Extends Animal.

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

Chicken

Extends Animal.

Index	Type	Meaning		Default
17	Chicken Variant (27)	Variant		TEMPERATE

Cow

Extends Animal.

Index	Type	Meaning		Default
17	Cow Variant (22)	Variant		TEMPERATE

Fox

Extends Animal.

Index	Type	Meaning		Default
17	VarInt (1)	Type (0: red, 1: snow)		0 (red)
18	Byte (0)	Bit mask	Meaning	0
		0x01	Is sitting
		0x02	Unused
		0x04	Is crouching
		0x08	Is interested
		0x10	Is pouncing
		0x20	Is sleeping
		0x40	Is faceplanted
		0x80	Is defending
19	Optional Living Entity Reference (13)	First UUID (in UUIDs NBT)?		Absent
20	Optional Living Entity Reference (13)	Second UUID (in UUIDs NBT)?		Absent

Frog

Extends Animal.

Index	Type	Meaning		Default
17	Frog Variant (25)	Frog Variant		TEMPERATE
18	Optional VarInt (19)	Tongue Target		0

Happy Ghast

Extends Animal.

Index	Type	Meaning		Default
17	Boolean (8)	Is leash holder		false
18	Boolean (8)	Stays still		false

Goat

Extends Animal.

Index	Type	Meaning		Default
17	Boolean (8)	Is Screaming Goat		false
18	Boolean (8)	Has Left Horn		true
19	Boolean (8)	Has Right Horn		true

Hoglin

Extends Animal.

Index	Type	Meaning		Default
17	Boolean (8)	Is immune to zombification		false

Mooshroom

Extends Animal.

Index	Type	Meaning		Default
17	VarInt (1)	Variant ("red" or "brown")		red

Ocelot

Extends Animal.

Index	Type	Meaning		Default
17	Boolean (8)	Is trusting		false

Panda

Extends Animal.

Index	Type	Meaning		Default
17	VarInt (1)	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
18	VarInt (1)	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
19	VarInt (1)	Eat timer. If nonzero, counts upwards.		0
20	Byte (0)	Main Gene		0
21	Byte (0)	Hidden Gene		0
22	Byte (0)	Bit mask	Meaning	0
		0x01	Unused
		0x02	Is sneezing
		0x04	Is rolling
		0x08	Is sitting
		0x10	Is on back

Pig

Extends Animal.

Index	Type	Meaning		Default
17	VarInt (1)	Total time to "boost" with a carrot on a stick for		0
18	Pig Variant (26)	Variant		TEMPERATE

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.

Polar Bear

Extends Animal.

Index	Type	Meaning		Default
17	Boolean (8)	Is standing up		false

Rabbit

Extends Animal.

Index	Type	Meaning		Default
17	VarInt (1)	Type		0

Sheep

Extends Animal.

Index	Type	Meaning		Default
17	Byte (0)	Bit mask	Meaning	0
		0x0F	Color ID
		0x10	Is sheared

Sniffer

Extends Animal.

Index	Type	Meaning		Default
17	Sniffer State (30)	Sniffer State		IDLING
18	VarInt (1)	Drop seed at tick		0

Strider

Extends Animal.

Index	Type	Meaning		Default
17	VarInt (1)	Total time to "boost" with warped fungus on a stick for		0
18	Boolean (8)	Is shaking (true unless riding a vehicle or on or in a block tagged with strider_warm_blocks (default: lava))		false

Turtle

Extends Animal.

Index	Type	Meaning		Default
17	Boolean (8)	Has egg		false
18	Boolean (8)	Laying egg		false

Abstract Horse

Extends Animal.

Index	Type	Meaning		Default
17	Byte (0)	Bit mask	Meaning	0
		0x01	Unused
		0x02	Is tame
		0x04	Unused (previously is saddled)
		0x08	Has bred
		0x10	Is eating
		0x20	Is rearing (on hind legs)
		0x40	Is mouth open

Camel

Extends Abstract Horse.

Index	Type	Meaning		Default
18	Boolean (8)	Is dashing		False
19	VarLong (2)	Last pose change tick		0

Horse

Extends Abstract Horse.

Index	Type	Meaning		Default
18	VarInt (1)	Variant (Color & Style)		0

Skeleton Horse

Extends Abstract Horse.

No additional metadata.

Zombie Horse

Extends Abstract Horse.

No additional metadata.

Chested Horse

Extends Abstract Horse.

Index	Type	Meaning		Default
18	Boolean (8)	Has Chest		false

Donkey

Extends Chested Horse.

No additional metadata.

Llama

Extends Chested Horse.

Index	Type	Meaning		Default
19	VarInt (1)	Strength (number of columns of 3 slots in the llama's inventory once a chest is equipped)		0
20	VarInt (1)	Variant (0: llama_creamy.png, 1: llama_white.png, 2: llama_brown.png, 3: llama_gray.png)		0

Trader Llama

Extends Llama.

No additional metadata.

Mule

Extends Chested Horse.

No additional metadata.

Tameable Animal

Extends Animal.

Index	Type	Meaning		Default
17	Byte (0)	Bit mask	Meaning	0
		0x01	Is sitting
		0x02	Unused
		0x04	Is tamed
18	Optional Living Entity Reference (13)	Owner		Absent

Cat

Extends Tameable Animal.

Index	Type	Meaning		Default
19	Cat Variant (21)	Cat Variant		BLACK
20	Boolean (8)	Is lying		false
21	Boolean (8)	Is relaxed? (This makes their head go slightly upwards, unknown when used)		false
22	VarInt (1)	Collar color (values are those used with dyes)		14 (Red)

Parrot

Extends Tameable Animal.

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

Wolf

Extends Tameable Animal.

Index	Type	Meaning		Default
19	Boolean (8)	Is begging		false
20	VarInt (1)	Collar color (values are those used with dyes)		14 (Red)
21	VarInt (1)	Anger time		0
22	Wolf Variant (23)	Variant		PALE
23	Wolf Sound Variant (24)	Sound variant		CLASSIC

Abstract Villager

Extends Ageable Mob.

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

Villager

Extends Abstract Villager.

Index	Type	Meaning		Default
18	Villager Data (18)	Villager Data		Plains/None/1

Wandering Trader

Extends Abstract Villager.

No additional metadata.

Abstract Fish

Extends Creature.

Index	Type	Meaning		Default
16	Boolean (8)	From bucket		False

Cod

Extends Abstract Fish.

No additional metadata.

Salmon

Extends Abstract Fish.

Index	Type	Meaning		Default
17	VarInt (1)	Type (SMALL = 0, MEDIUM = 1, LARGE = 2)		1

Tropical Fish

Extends Abstract Fish.

Index	Type	Meaning		Default
17	VarInt (1)	Variant		0

Monster

Extends Creature.

No additional metadata.

Blaze

Extends Monster.

Index	Type	Meaning		Default
16	Byte (0)	Bit mask	Meaning	0
		0x01	Is on fire

Bogged

Extends Monster.

Index	Type	Meaning		Default
16	Boolean (8)	Is sheared		false

Breeze

Extends Monster.

No additional metadata.

Creaking

Extends Monster.

Index	Type	Meaning		Default
16	Boolean (8)	Can move		true
17	Boolean (8)	Is active		false
18	Boolean (8)	Is tearing down		false
19	Optional Position (11)	Home position		Empty

Creeper

Extends Monster.

Index	Type	Meaning		Default
16	VarInt (1)	State (idle = -1, fuse = 1)		-1
17	Boolean (8)	Is charged		false
18	Boolean (8)	Is ignited		false

Enderman

Extends Monster.

Index	Type	Meaning		Default
16	Optional Block State (15)	Carried block		Absent
17	Boolean (8)	Is screaming		false
18	Boolean (8)	Is staring		false

Endermite

Extends Monster.

No additional metadata.

Giant

Extends Monster.

No additional metadata.

Guardian

Extends Monster.

Index	Type	Meaning		Default
16	Boolean (8)	Is retracting spikes		false
17	VarInt (1)	Target EID		0

Elder Guardian

Extends Guardian.

No additional metadata.

Silverfish

Extends Monster.

No additional metadata.

Skeleton

Extends Monster.

Index	Type	Meaning		Default
16	Boolean (8)	Is being converted into a Stray		false

Spider

Extends Monster.

Index	Type	Meaning		Default
16	Byte (0)	Bit mask	Meaning	0
		0x01	Is climbing

Cave Spider

Extends Spider.

No additional metadata.

Stray

Extends Monster.

No additional metadata.

Vex

Extends Monster.

Index	Type	Meaning		Default
16	Byte (0)	Bit mask	Meaning	0
		0x01	Is attacking

Warden

Extends Monster.

Index	Type	Meaning		Default
16	VarInt (1)	Anger Level		0

Wither

Extends Monster.

Index	Type	Meaning		Default
16	VarInt (1)	Center head's target (entity ID, or 0 if no target)		0
17	VarInt (1)	Left head's target (entity ID, or 0 if no target)		0
18	VarInt (1)	Right head's target (entity ID, or 0 if no target)		0
19	VarInt (1)	Invulnerable time		0

Wither Skeleton

Extends Monster.

No additional metadata.

Zoglin

Extends Monster.

Index	Type	Meaning		Default
16	Boolean (8)	Is baby		false

Zombie

Extends Monster.

Index	Type	Meaning		Default
16	Boolean (8)	Is baby		false
17	VarInt (1)	Unused (previously type)		0
18	Boolean (8)	Is becoming a drowned		false

Drowned

Extends Zombie.

No additional metadata.

Husk

Extends Zombie.

No additional metadata.

Zombie Villager

Extends Zombie.

Index	Type	Meaning		Default
19	Boolean (8)	Is converting		false
20	Villager Data (18)	Villager Data		Plains/None/1

Zombified Piglin

Extends Zombie.

No additional metadata.

Base Piglin

Extends Monster.

Index	Type	Meaning		Default
16	Boolean (8)	Is immune to zombification		false

Piglin

Extends Base Piglin.

Index	Type	Meaning		Default
17	Boolean (8)	Is baby		false
18	Boolean (8)	Is charging crossbow		false
19	Boolean (8)	Is dancing		false

Piglin Brute

Extends Base Piglin.

No additional metadata.

Raider

Extends Monster.

Index	Type	Meaning		Default
16	Boolean (8)	Is celebrating		false

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

Pillager

Extends Raider.

Index	Type	Meaning		Default
17	Boolean (8)	Is charging		false

Ravager

Extends Raider.

No additional metadata.

Vindicator

Extends Raider.

No additional metadata.

Witch

Extends Raider.

Index	Type	Meaning		Default
17	Boolean (8)	Is drinking potion		false

Spellcaster Illager

Extends Raider.

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

Evoker

Extends Spellcaster Illager.

No additional metadata.

Illusioner

Extends Spellcaster Illager.

No additional metadata.

Thrown Item Projectile

Extends Entity.

Index	Type	Meaning		Default
8	Slot (7)	Item		Empty (which behaves as the default)

Thrown Egg

Extends Thrown Item Projectile.

Default item is minecraft:egg.

No additional metadata.

Thrown Ender Pearl

Extends Thrown Item Projectile.

Default item is minecraft:ender_pearl.

No additional metadata.

Thrown Bottle o' Enchanting

Extends Thrown Item Projectile.

Default item is minecraft:experience_bottle.

No additional metadata.

Splash Potion

Extends Thrown Item Projectile.

No additional metadata.

Lingering Potion

Extends Thrown Item Projectile.

No additional metadata.

Snowball

Extends Thrown Item Projectile.

Default item is minecraft:snowball.

No additional metadata.

Abstract Vehicle

Extends Entity.

Index	Type	Meaning		Default
8	VarInt (1)	Shaking power		0
9	VarInt (1)	Shaking direction		1
10	Float (3)	Shaking multiplier		0.0

Boat

Extends Abstract Vehicle.

Index	Type	Meaning		Default
11	Boolean (8)	Is left paddle turning		false
12	Boolean (8)	Is right paddle turning		false
13	VarInt (1)	Splash timer		0

Acacia Boat

Extends Boat.

No additional metadata.

Acacia Boat with Chest

Extends Boat.

No additional metadata.

Bamboo Raft with Chest

Extends Boat.

No additional metadata.

Bamboo Raft

Extends Boat.

No additional metadata.

Birch Boat

Extends Boat.

No additional metadata.

Birch Boat with Chest

Extends Boat.

No additional metadata.

Cherry Boat

Extends Boat.

No additional metadata.

Cherry Boat with Chest

Extends Boat.

No additional metadata.

Dark Oak Boat

Extends Boat.

No additional metadata.

Dark Oak Boat with Chest

Extends Boat.

No additional metadata.

Jungle Boat

Extends Boat.

No additional metadata.

Jungle Boat with Chest

Extends Boat.

No additional metadata.

Mangrove Boat

Extends Boat.

No additional metadata.

Mangrove Boat with Chest

Extends Boat.

No additional metadata.

Oak Boat

Extends Boat.

No additional metadata.

Oak Boat with Chest

Extends Boat.

No additional metadata.

Pale Oak Boat

Extends Boat.

No additional metadata.

Pale Oak Boat with Chest

Extends Boat.

No additional metadata.

Spruce Boat

Extends Boat.

No additional metadata.

Spruce Boat with Chest

Extends Boat.

No additional metadata.

Abstract Minecart

Extends Abstract Vehicle.

Index	Type	Meaning		Default
11	Optional Block State (15)	Custom block state		0
12	VarInt (1)	Custom block Y position (in 16ths of a block)		6

If custom block state is unset, 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 they are not overridden by the metadata field. They are only provided for reference to help with swapping out other blocks.

• Rideable Minecarts contain air (minecraft:air) and have a y position of 6
• Chest Minecarts contain chests facing north (minecraft:chest[facing=north]) and have a y position of 8
• Furnace Minecarts contain a normal furnace facing north when unpowered (minecraft:furnace[facing=north]) and a lit furnace facing north when powered (minecraft:furnace[facing=north, lit=true]) and have a y position of 6 in both cases
• Hopper Minecarts contain a hopper (minecraft:hopper) and have a y position of 1
• TNT Minecarts contain TNT (minecraft:tnt) and have a y position of 6
• Command block minecarts contain a Command Block (minecraft:command_block) and have a y position of 6
• Spawner Minecarts contain a spawner (minecraft:spawner) and have a y position of 6

Minecart with Chest

Extends Abstract Minecart.

No additional metadata.

Minecart with Command Block

Extends Abstract Minecart.

Index	Type	Meaning		Default
13	String (4)	Command
14	Text Component (5)	Last output		{"text":""}

Minecart with Furnace

Extends Abstract Minecart.

Index	Type	Meaning		Default
13	Boolean (8)	Has fuel		false

Minecart with Hopper

Extends Abstract Minecart.

No additional metadata.

Minecart

Extends Abstract Minecart.

No additional metadata.

Minecart with Monster Spawner

Extends Abstract Minecart.

No additional metadata.

Minecart with TNT

Extends Abstract Minecart.

No additional metadata.