Minecraft:Java Edition protocol/Entity metadata

Various Entities have different metadata fields and status codes.

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

! Value
! Notes

| Template:Type
|

| Template:Type
|

| Template:Type
|

| Template:Type
|

| Template:Type (32767)
|

| Template:Type
|

| (Template:Type, Template:Type Template:Type)
| Text Component is present if the Boolean is set to true.

| Template:Type
|

| Template:Type
|

| (Template:Type, Template:Type, Template:Type)
| rotation on x, rotation on y, rotation on z

| Template:Type
|

| (Template:Type, Template:Type Template:Type)
| Position is present if the Boolean is set to true.

| Template:Type Template:Type
| Down = 0, Up = 1, North = 2, South = 3, West = 4, East = 5

| (Template:Type, Template:Type Template:Type)
| UUID is present if the Boolean is set to true.

| Template:Type
| An ID in the block state registry.

| Template:Type
| 0 for absent (air is unrepresentable); otherwise, an ID in the block state registry.

| (Template:Type, Varies)
| particle type (an ID in the minecraft:particle_type registry), particle data (See Particles.)

| (Template:Type, Template:Type of (Template:Type, Varies))
| length-prefixed list of particle defintions (as above).

| (Template:Type, Template:Type, Template:Type)
| villager type, villager profession, level (See below.)

| Template:Type
| 0 for absent; 1 + actual value otherwise. Used for entity IDs.

| Template:Type Template:Type
| 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, SLIDING = 15, SHOOTING = 16, INHALING = 17

| Template:Type
| An ID in the minecraft:cat_variant registry.

| Template:Type
| An ID in the minecraft:cat_sound_variant registry.

| Template:Type
| An ID in the minecraft:cow_variant registry.

| Template:Type
| An ID in the minecraft:cow_sound_variant registry.

| Template:Type
| An ID in the minecraft:wolf_variant registry.

| Template:Type
| An ID in the minecraft:wolf_sound_variant registry.

| Template:Type
| An ID in the minecraft:frog_variant registry.

| Template:Type
| An ID in the minecraft:pig_variant registry.

| Template:Type
| An ID in the minecraft:pig_sound_variant registry.

| Template:Type
| An ID in the minecraft:chicken_variant registry.

| Template:Type
| An ID in the minecraft:chicken_sound_variant registry.

| Template:Type
| An ID in the minecraft:zombie_nautilus_variant registry.

| (Template:Type, Template:Type Template:Type, Template:Type Template:Type)
| dimension identifier, position; only if the Boolean is set to true.

| Template:Type Painting Variant
| An ID in the minecraft:painting_variant registry, or an inline definition.

| Template:Type Template:Type
| IDLING = 0, FEELING_HAPPY = 1, SCENTING = 2, SNIFFING = 3, SEARCHING = 4, DIGGING = 5, RISING = 6

| Template:Type Template:Type
| IDLE = 0, ROLLING = 1, SCARED = 2, UNROLLING = 3

| Template:Type Template:Type
| IDLE = 0, GETTING_ITEM = 1, GETTING_NO_ITEM = 2, DROPPING_ITEM = 3, DROPPING_NO_ITEM = 4

| Template:Type Template:Type
| UNAFFECTED = 0, EXPOSED = 1, WEATHERED = 2, OXIDIZED = 3

| (Template:Type, Template:Type, Template:Type)
| x, y, z

| (Template:Type, Template:Type, Template:Type, Template:Type)
| x, y, z, w

| Template:Type
|

| Template:Type Template:Type
| LEFT = 0, RIGHT = 1
|}

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	Template:Type	The texture for the wild version of this wolf. The Notchian client uses the corresponding asset located at textures.
Tame texture	Template:Type	The texture for the tamed version of this wolf. The Notchian client uses the corresponding asset located at textures.
Angry texture	Template:Type	The texture for the angry version of this wolf. The Notchian client uses the corresponding asset located at textures.
Biomes	Template:Type	Biomes in which this wolf can spawn in (IDs in the minecraft:biome registry).

Painting Variant

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

Entity Metadata

Entity

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	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 Minecraft:elytra
Template:Metadata id	Template:Metadata type	Air ticks		300
Template:Metadata id	Template:Metadata type	Custom name		empty
Template:Metadata id	Template:Metadata type	Is custom name visible		false
Template:Metadata id	Template:Metadata type	Is silent		false
Template:Metadata id	Template:Metadata type	Has no gravity		false
Template:Metadata id	Template:Metadata type	Pose		STANDING
Template:Metadata id	Template:Metadata type	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

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Radius		3.0
Template:Metadata id	Template:Metadata type	Ignore radius and show effect as single point, not area		false
Template:Metadata id	Template:Metadata type	The particle		-1

Wind Charge

No additional metadata.

Dragon Fireball

No additional metadata.

End Crystal

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Beam target		Empty
Template:Metadata id	Template:Metadata type	Show bottom		true

Evoker Fangs

No additional metadata.

Experience Orb

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	The amount of experience this orb will reward once collected.		0

Eye of Ender

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Item		Empty (which behaves as if it were a minecraft:ender_eye)

Falling Block

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	spawn position		(0, 0, 0)

Fireball

This is the large fireball shot by ghasts.

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Item		Empty

Firework Rocket

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Firework info		Empty
Template:Metadata id	Template:Metadata type	Entity ID of entity which used firework (for elytra boosting)		Empty
Template:Metadata id	Template:Metadata type	Is shot at angle (from a crossbow)		false

Interaction

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Width		1.0
Template:Metadata id	Template:Metadata type	Height		1.0
Template:Metadata id	Template:Metadata type	Responsive - can be attacked/interacted with if true		false

Item

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Item		Empty

Item Frame

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Direction		SOUTH
Template:Metadata id	Template:Metadata type	Item		Empty
Template:Metadata id	Template:Metadata type	Rotation		0

Glow Item Frame

No additional metadata.

Leash Knot

No additional metadata.

Lightning Bolt

No additional metadata.

Llama Spit

No additional metadata.

Marker

No additional metadata.

Ominous Item Spawner

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Item		Empty

Painting

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type			SOUTH
Template:Metadata id	Template:Metadata type	Painting Type		KEBAB

Shulker Bullet

No additional metadata.

Small Fireball

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

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Item		Empty (which behaves as if it were a minecraft:fire_charge)

Primed TNT

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Fuse time. Automatically decreases by 1 each client tick. On the tick on which it is decremented to 0, the entity is deleted by the client, and further attempts to set this value will be ignored.		80
Template:Metadata id	Template:Metadata type	The block state ID that is exploding		TNT

Wind Charge

No additional metadata.

Wither Skull

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is invulnerable		false

Fishing Bobber

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Hooked entity id + 1, or 0 if there is no hooked entity		0
Template:Metadata id	Template:Metadata type	Is catchable		False

Abstract Arrow

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Bit mask	Meaning	0
		0x01	Is critical
		0x02	Is noclip (used by loyalty tridents when returning)
Template:Metadata id	Template:Metadata type	Piercing level		0
Template:Metadata id	Template:Metadata type	Is in ground		false

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
Template:Metadata id	Template:Metadata type	Color (-1 for no particles)		-1

Spectral Arrow

No additional metadata.

Trident

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Loyalty level (enchantment)		0
Template:Metadata id	Template:Metadata type	Has enchantment glint		False

Display

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Interpolation delay		0
Template:Metadata id	Template:Metadata type	Transformation interpolation duration		0
Template:Metadata id	Template:Metadata type	Position/Rotation interpolation duration		0
Template:Metadata id	Template:Metadata type	Translation		(0.0, 0.0, 0.0)
Template:Metadata id	Template:Metadata type	Scale		(1.0, 1.0, 1.0)
Template:Metadata id	Template:Metadata type	Rotation left		(0.0, 0.0, 0.0, 1.0)
Template:Metadata id	Template:Metadata type	Rotation right		(0.0, 0.0, 0.0, 1.0)
Template:Metadata id	Template:Metadata type	Billboard Constraints (FIXED = 0, VERTICAL = 1, HORIZONTAL = 2, CENTER = 3)		0
Template:Metadata id	Template:Metadata type	Brightness override (blockLight << 4 | skyLight << 20)		-1
Template:Metadata id	Template:Metadata type	View range		1.0
Template:Metadata id	Template:Metadata type	Shadow radius		0.0
Template:Metadata id	Template:Metadata type	Shadow strength		1.0
Template:Metadata id	Template:Metadata type	Width		0.0
Template:Metadata id	Template:Metadata type	Height		0.0
Template:Metadata id	Template:Metadata type	Glow color override		-1

Block Display

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Displayed block state		0 (Air)

Item Display

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Displayed item		Empty
Template:Metadata id	Template:Metadata type	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

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Text		Empty
Template:Metadata id	Template:Metadata type	Line width		200
Template:Metadata id	Template:Metadata type	Background color		1073741824 (0x40000000)
Template:Metadata id	Template:Metadata type	Text opacity		-1 (fully opaque)
Template:Metadata id	Template:Metadata type	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

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	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
Template:Metadata id	Template:Metadata type	Health		1.0
Template:Metadata id	Template:Metadata type	Potion effect color (or 0 if there is no effect)		0
Template:Metadata id	Template:Metadata type	Is potion effect ambient: reduces the number of particles generated by potions to 1/5 the normal amount		false
Template:Metadata id	Template:Metadata type	Number of arrows in entity		0
Template:Metadata id	Template:Metadata type	Number of bee stingers in entity		0
Template:Metadata id	Template:Metadata type	Location of the bed that the entity is currently sleeping in (Empty if it isn't sleeping)		Empty

Armor Stand

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Bit mask	Meaning	0
		0x01	Is Small
		0x02	Unused
		0x04	Has Arms
		0x08	Has no BasePlate
		0x10	Is Marker
Template:Metadata id	Template:Metadata type	Head rotation		(0.0, 0.0, 0.0)
Template:Metadata id	Template:Metadata type	Body rotation		(0.0, 0.0, 0.0)
Template:Metadata id	Template:Metadata type	Left arm rotation		(-10.0, 0.0, -10.0)
Template:Metadata id	Template:Metadata type	Right arm rotation		(-15.0, 0.0, 10.0)
Template:Metadata id	Template:Metadata type	Left leg rotation		(-1.0, 0.0, -1.0)
Template:Metadata id	Template:Metadata type	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

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Main hand (0: left, 1: right)		right (1)
Template:Metadata id	Template:Metadata type	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

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	The player's skin and display name		Partial profile with all fields empty
Template:Metadata id	Template:Metadata type	Immovable		false
Template:Metadata id	Template:Metadata type	The description text below the player's username, usually "NPC"		Empty

Player

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Additional Hearts		0.0
Template:Metadata id	Template:Metadata type	Score		0
Template:Metadata id	Template:Metadata type	Left shoulder entity data (for occupying parrot)		Empty
Template:Metadata id	Template:Metadata type	Right shoulder entity data (for occupying parrot)		Empty

Mob

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Bit mask	Meaning	0
		0x01	NoAI
		0x02	Is left handed
		0x04	Is aggressive

Bat

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Bit mask	Meaning	0
		0x01	Is hanging

Ender Dragon

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	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

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is attacking		false

Phantom

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Size		0

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

Creature

No additional metadata.

Allay

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is dancing		false
Template:Metadata id	Template:Metadata type	Can duplicate		true

Copper Golem

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Weathering state		UNAFFECTED
Template:Metadata id	Template:Metadata type	Copper golem state		IDLE

Iron Golem

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Bit mask	Meaning	0
		0x01	Is player-created

Pufferfish

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	From bucket		false
Template:Metadata id	Template:Metadata type	Puff state (0: small, 1: mid, 2: full)		0

Shulker

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Attach face		Down (0)
Template:Metadata id	Template:Metadata type	Shield height		0
Template:Metadata id	Template:Metadata type	Color (dye color)		16

Snow Golem

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Bit mask	Meaning	0x10
		0x01	Unused
		0x02	Unused
		0x04	Unused
		0x08	Unused
		0x10	Has pumpkin hat

Tadpole

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is from bucket		false
Template:Metadata id	Template:Metadata type	Age locked		false

Ageable Mob

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is baby		false
Template:Metadata id	Template:Metadata type	Age locked		false

Dolphin

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Has fish		false
Template:Metadata id	Template:Metadata type	Moisture level		2400

Squid

No additional metadata.

Glow Squid

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Dark ticks remaining		0

Animal

No additional metadata.

Armadillo

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Armadillo state		IDLE

Axolotl

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Variant (lucy = 0, wild = 1, gold = 2, cyan = 3, blue = 4)		0 (lucy)
Template:Metadata id	Template:Metadata type	If it is currently playing dead.		false
Template:Metadata id	Template:Metadata type	If it was spawned from a bucket.		false

Bee

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Bit mask	Meaning	0
		0x01	Unused
		0x02	Is angry
		0x04	Has stung
		0x08	Has nectar
Template:Metadata id	Template:Metadata type	Anger time in ticks		0 (Not angry)

Chicken

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Variant		TEMPERATE
Template:Metadata id	Template:Metadata type	Sound variant		CLASSIC

Cow

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Variant		TEMPERATE
Template:Metadata id	Template:Metadata type	Sound variant		CLASSIC

Fox

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Type (0: red, 1: snow)		0 (red)
Template:Metadata id	Template:Metadata type	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
Template:Metadata id	Template:Metadata type	First UUID (in UUIDs NBT)?		Absent
Template:Metadata id	Template:Metadata type	Second UUID (in UUIDs NBT)?		Absent

Frog

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Frog Variant		TEMPERATE
Template:Metadata id	Template:Metadata type	Tongue Target		0

Happy Ghast

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is leash holder		false
Template:Metadata id	Template:Metadata type	Stays still		false

Goat

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is Screaming Goat		false
Template:Metadata id	Template:Metadata type	Has Left Horn		true
Template:Metadata id	Template:Metadata type	Has Right Horn		true

Hoglin

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is immune to zombification		false

Mooshroom

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Variant ("red" or "brown")		red

Ocelot

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is trusting		false

Panda

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	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
Template:Metadata id	Template:Metadata type	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
Template:Metadata id	Template:Metadata type	Eat timer. If nonzero, counts upwards.		0
Template:Metadata id	Template:Metadata type	Main Gene		0
Template:Metadata id	Template:Metadata type	Hidden Gene		0
Template:Metadata id	Template:Metadata type	Bit mask	Meaning	0
		0x01	Unused
		0x02	Is sneezing
		0x04	Is rolling
		0x08	Is sitting
		0x10	Is on back

Pig

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Total time to "boost" with a carrot on a stick for		0
Template:Metadata id	Template:Metadata type	Variant		TEMPERATE
Template:Metadata id	Template:Metadata type	Sound variant		CLASSIC

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

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is standing up		false

Rabbit

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Type		0

Sheep

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Bit mask	Meaning	0
		0x0F	Color ID
		0x10	Is sheared

Sniffer

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Sniffer State		IDLING
Template:Metadata id	Template:Metadata type	Drop seed at tick		0

Strider

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Total time to "boost" with warped fungus on a stick for		0
Template:Metadata id	Template:Metadata type	Is shaking (true unless riding a vehicle or on or in a block tagged with strider_warm_blocks (default: lava))		false

Turtle

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Has egg		false
Template:Metadata id	Template:Metadata type	Laying egg		false

Abstract Horse

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	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

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is dashing		False
Template:Metadata id	Template:Metadata type	Last pose change tick		0

Camel Husk

No additional metadata.

Horse

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Variant (Color & Style)		0

Skeleton Horse

No additional metadata.

Zombie Horse

No additional metadata.

Chested Horse

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Has Chest		false

Donkey

No additional metadata.

Llama

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

Trader Llama

No additional metadata.

Mule

No additional metadata.

Tameable Animal

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Bit mask	Meaning	0
		0x01	Is sitting
		0x02	Unused
		0x04	Is tamed
Template:Metadata id	Template:Metadata type	Owner		Absent

Cat

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Cat Variant		BLACK
Template:Metadata id	Template:Metadata type	Is lying		false
Template:Metadata id	Template:Metadata type	Is relaxed? (This makes their head go slightly upwards, unknown when used)		false
Template:Metadata id	Template:Metadata type	Collar color (values are those used with dyes)		14 (Red)
Template:Metadata id	Template:Metadata type	Sound variant		CLASSIC

Parrot

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Variant (0: red/blue, 1: blue, 2: green, 3: yellow/blue, 4: grey)		0

Wolf

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is begging		false
Template:Metadata id	Template:Metadata type	Collar color (values are those used with dyes)		14 (Red)
Template:Metadata id	Template:Metadata type	Anger time		0
Template:Metadata id	Template:Metadata type	Variant		PALE
Template:Metadata id	Template:Metadata type	Sound variant		CLASSIC

Abstract Nautilus

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is dashing		false

Nautilus

No additional metadata.

Zombie Nautilus

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Variant ID		TEMPERATE

Abstract Cube Mob

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Size		1

Magma Cube

No additional metadata.

Slime

No additional metadata.

Sulfur Cube

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Max fuse		-1
Template:Metadata id	Template:Metadata type	From bucket		false

Abstract Villager

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Head shake timer (starts at 40, decrements each tick)		0

Villager

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Villager Data		Plains/None/1
Template:Metadata id	Template:Metadata type	Villager data finalized		false

Wandering Trader

No additional metadata.

Abstract Fish

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	From bucket		False

Cod

No additional metadata.

Salmon

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Type (SMALL = 0, MEDIUM = 1, LARGE = 2)		1

Tropical Fish

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Variant		0

Monster

No additional metadata.

Blaze

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Bit mask	Meaning	0
		0x01	Is on fire

Bogged

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is sheared		false

Breeze

No additional metadata.

Creaking

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Can move		true
Template:Metadata id	Template:Metadata type	Is active		false
Template:Metadata id	Template:Metadata type	Is tearing down		false
Template:Metadata id	Template:Metadata type	Home position		Empty

Creeper

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	State (idle = -1, fuse = 1)		-1
Template:Metadata id	Template:Metadata type	Is charged		false
Template:Metadata id	Template:Metadata type	Is ignited		false

Enderman

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Carried block		Absent
Template:Metadata id	Template:Metadata type	Is screaming		false
Template:Metadata id	Template:Metadata type	Is staring		false

Endermite

No additional metadata.

Giant

No additional metadata.

Guardian

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is retracting spikes		false
Template:Metadata id	Template:Metadata type	Target EID		0

Elder Guardian

No additional metadata.

Parched

No additional metadata.

Silverfish

No additional metadata.

Skeleton

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is being converted into a Stray		false

Spider

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Bit mask	Meaning	0
		0x01	Is climbing

Cave Spider

No additional metadata.

Stray

No additional metadata.

Vex

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Bit mask	Meaning	0
		0x01	Is attacking

Warden

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Anger Level		0

Wither

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Center head's target (entity ID, or 0 if no target)		0
Template:Metadata id	Template:Metadata type	Left head's target (entity ID, or 0 if no target)		0
Template:Metadata id	Template:Metadata type	Right head's target (entity ID, or 0 if no target)		0
Template:Metadata id	Template:Metadata type	Invulnerable time		0

Wither Skeleton

No additional metadata.

Zoglin

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is baby		false

Zombie

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is baby		false
Template:Metadata id	Template:Metadata type	Unused (previously type)		0
Template:Metadata id	Template:Metadata type	Is becoming a drowned		false

Drowned

No additional metadata.

Husk

No additional metadata.

Zombie Villager

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is converting		false
Template:Metadata id	Template:Metadata type	Villager Data		Plains/None/1
Template:Metadata id	Template:Metadata type	Villager data finalized		false

Zombified Piglin

No additional metadata.

Base Piglin

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is immune to zombification		false

Piglin

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is baby		false
Template:Metadata id	Template:Metadata type	Is charging crossbow		false
Template:Metadata id	Template:Metadata type	Is dancing		false

Piglin Brute

No additional metadata.

Raider

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is celebrating		false

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

Pillager

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is charging		false

Ravager

No additional metadata.

Vindicator

No additional metadata.

Witch

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is drinking potion		false

Spellcaster Illager

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Spell (0: none, 1: summon vex, 2: attack, 3: wololo, 4: disappear, 5: blindness)		0

Evoker

No additional metadata.

Illusioner

No additional metadata.

Thrown Item Projectile

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Item		Empty (which behaves as the default)

Thrown Egg

Default item is minecraft:egg.

No additional metadata.

Thrown Ender Pearl

Default item is minecraft:ender_pearl.

No additional metadata.

Thrown Bottle o' Enchanting

Default item is minecraft:experience_bottle.

No additional metadata.

Splash Potion

No additional metadata.

Lingering Potion

No additional metadata.

Snowball

Default item is minecraft:snowball.

No additional metadata.

Abstract Vehicle

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Shaking power		0
Template:Metadata id	Template:Metadata type	Shaking direction		1
Template:Metadata id	Template:Metadata type	Shaking multiplier		0.0

Boat

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Is left paddle turning		false
Template:Metadata id	Template:Metadata type	Is right paddle turning		false
Template:Metadata id	Template:Metadata type	Splash timer		0

Acacia Boat

No additional metadata.

Acacia Boat with Chest

No additional metadata.

Bamboo Raft with Chest

No additional metadata.

Bamboo Raft

No additional metadata.

Birch Boat

No additional metadata.

Birch Boat with Chest

No additional metadata.

Cherry Boat

No additional metadata.

Cherry Boat with Chest

No additional metadata.

Dark Oak Boat

No additional metadata.

Dark Oak Boat with Chest

No additional metadata.

Jungle Boat

No additional metadata.

Jungle Boat with Chest

No additional metadata.

Mangrove Boat

No additional metadata.

Mangrove Boat with Chest

No additional metadata.

Oak Boat

No additional metadata.

Oak Boat with Chest

No additional metadata.

Pale Oak Boat

No additional metadata.

Pale Oak Boat with Chest

No additional metadata.

Spruce Boat

No additional metadata.

Spruce Boat with Chest

No additional metadata.

Abstract Minecart

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Custom block state		0
Template:Metadata id	Template:Metadata type	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

No additional metadata.

Minecart with Command Block

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Command
Template:Metadata id	Template:Metadata type	Last output		{"text":""}

Minecart with Furnace

Index	Type	Meaning		Default
Template:Metadata id	Template:Metadata type	Has fuel		false

Minecart with Hopper

No additional metadata.

Minecart

No additional metadata.

Minecart with Monster Spawner

No additional metadata.

Minecart with TNT

No additional metadata. Template:License wiki.vg