Entity metadata
Various Entities have different metadata fields and status codes.
These are the valid codes for Minecraft Java Edition 1.20.2; for upcoming snapshots, see Pre-release protocol#Entity Metadata.
Because this is always updated late, only valid for the latest version and not computer parseable, Bixilon wrote PixLyzer. Burger burger might help.
Contents
- 1 Entities
- 2 Entity Metadata Format
- 3 Entity Metadata
- 3.1 Entity
- 3.2 Interaction
- 3.3 Display
- 3.4 Block Display
- 3.5 Item Display
- 3.6 Text Display
- 3.7 Thrown Item Projectile
- 3.8 Thrown Egg
- 3.9 Thrown Ender Pearl
- 3.10 Thrown Experience Bottle
- 3.11 Thrown Potion
- 3.12 Snowball
- 3.13 Eye of Ender
- 3.14 Falling Block
- 3.15 Area Effect Cloud
- 3.16 Fishing Hook
- 3.17 Abstract Arrow
- 3.18 Arrow
- 3.19 Spectral Arrow
- 3.20 Thrown Trident
- 3.21 Boat
- 3.22 Chest Boat
- 3.23 End Crystal
- 3.24 Dragon Fireball
- 3.25 Small Fireball
- 3.26 Fireball
- 3.27 Wither Skull
- 3.28 Firework Rocket Entity
- 3.29 Item Frame
- 3.30 Glowing Item Frame
- 3.31 Painting
- 3.32 Item Entity
- 3.33 Living Entity
- 3.34 Player
- 3.35 Armor Stand
- 3.36 Mob
- 3.37 Ambient Creature
- 3.38 Bat
- 3.39 Pathfinder Mob
- 3.40 Water Animal
- 3.41 Squid
- 3.42 Dolphin
- 3.43 Abstract fish
- 3.44 Cod
- 3.45 Puffer fish
- 3.46 Salmon
- 3.47 Tropical fish
- 3.48 Tadpole
- 3.49 Ageable Mob
- 3.50 Animal
- 3.51 Sniffer
- 3.52 Abstract Horse
- 3.53 Horse
- 3.54 Zombie Horse
- 3.55 Skeleton Horse
- 3.56 Camel
- 3.57 Chested Horse
- 3.58 Donkey
- 3.59 Llama
- 3.60 Trader Llama
- 3.61 Mule
- 3.62 Axolotl
- 3.63 Bee
- 3.64 Fox
- 3.65 Frog
- 3.66 Ocelot
- 3.67 Panda
- 3.68 Pig
- 3.69 Rabbit
- 3.70 Turtle
- 3.71 Polar Bear
- 3.72 Chicken
- 3.73 Cow
- 3.74 Hoglin
- 3.75 Mooshroom
- 3.76 Sheep
- 3.77 Strider
- 3.78 Tameable Animal
- 3.79 Cat
- 3.80 Wolf
- 3.81 Parrot
- 3.82 Abstract Villager
- 3.83 Villager
- 3.84 Wandering Trader
- 3.85 Abstract Golem
- 3.86 Iron Golem
- 3.87 Snow Golem
- 3.88 Shulker
- 3.89 Monster
- 3.90 Base Piglin
- 3.91 Piglin
- 3.92 Piglin Brute
- 3.93 Blaze
- 3.94 Creeper
- 3.95 Endermite
- 3.96 Giant
- 3.97 Goat
- 3.98 Guardian
- 3.99 Elder Guardian
- 3.100 Silverfish
- 3.101 Raider
- 3.102 Abstract Illager
- 3.103 Vindicator
- 3.104 Pillager
- 3.105 Spellcaster Illager
- 3.106 Evoker
- 3.107 Illusioner
- 3.108 Ravager
- 3.109 Witch
- 3.110 Evoker Fangs
- 3.111 Vex
- 3.112 Abstract Skeleton
- 3.113 Skeleton
- 3.114 Wither Skeleton
- 3.115 Stray
- 3.116 Spider
- 3.117 Warden
- 3.118 Wither
- 3.119 Zoglin
- 3.120 Zombie
- 3.121 Zombie Villager
- 3.122 Husk
- 3.123 Drowned
- 3.124 Zombified Piglin
- 3.125 Enderman
- 3.126 Ender Dragon
- 3.127 Flying
- 3.128 Ghast
- 3.129 Phantom
- 3.130 Slime
- 3.131 Llama Spit
- 3.132 Abstract Minecart
- 3.133 Minecart
- 3.134 Abstract Minecart Container
- 3.135 Minecart Hopper
- 3.136 Minecart Chest
- 3.137 Minecart Furnace
- 3.138 Minecart TNT
- 3.139 Minecart Spawner
- 3.140 Minecart Command Block
- 3.141 Primed Tnt
Entities
These entity IDs are up to date for 1.20.2. Use Data Generators or Burger to get older IDs. If using Burger just replace the version number to what you want to see.
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 | Allay | 0.35 | 0.6 | minecraft:allay
|
1 | Area Effect Cloud | 2.0 * Radius | 0.5 | minecraft:area_effect_cloud
|
2 | Armor Stand | normal: 0.5 marker: 0.0 small: 0.25 | normal: 1.975 marker: 0.0 small: 0.9875 | minecraft:armor_stand
|
3 | Arrow | 0.5 | 0.5 | minecraft:arrow
|
4 | Axolotl | 0.75 | 0.42 | minecraft:axolotl
|
5 | Bat | 0.5 | 0.9 | minecraft:bat
|
6 | Bee | 0.7 | 0.6 | minecraft:bee
|
7 | Blaze | 0.6 | 1.8 | minecraft:blaze
|
8 | Block Display | 0.0 | 0.0 | minecraft:block_display
|
9 | Boat | 1.375 | 0.5625 | minecraft:boat
|
10 | Camel | 1.7 | 2.375 | minecraft:camel
|
11 | Cat | 0.6 | 0.7 | minecraft:cat
|
12 | Cave Spider | 0.7 | 0.5 | minecraft:cave_spider
|
13 | Chest Boat | 1.375 | 0.5625 | minecraft:chest_boat
|
14 | Chest Minecart | 0.98 | 0.7 | minecraft:chest_minecart
|
15 | Chicken | 0.4 | 0.7 | minecraft:chicken
|
16 | Cod | 0.5 | 0.3 | minecraft:cod
|
17 | Command Block Minecart | 0.98 | 0.7 | minecraft:command_block_minecart
|
18 | Cow | 0.9 | 1.4 | minecraft:cow
|
19 | Creeper | 0.6 | 1.7 | minecraft:creeper
|
20 | Dolphin | 0.9 | 0.6 | minecraft:dolphin
|
21 | Donkey | 1.3964844 | 1.5 | minecraft:donkey
|
22 | Dragon Fireball | 1.0 | 1.0 | minecraft:dragon_fireball
|
23 | Drowned | 0.6 | 1.95 | minecraft:drowned
|
24 | Egg | 0.25 | 0.25 | minecraft:egg
|
25 | Elder Guardian | 1.9975 (2.35 * guardian) | 1.9975 (2.35 * guardian) | minecraft:elder_guardian
|
26 | End Crystal | 2.0 | 2.0 | minecraft:end_crystal
|
27 | Ender Dragon | 16.0 | 8.0 | minecraft:ender_dragon
|
28 | Ender Pearl | 0.25 | 0.25 | minecraft:ender_pearl
|
29 | Enderman | 0.6 | 2.9 | minecraft:enderman
|
30 | Endermite | 0.4 | 0.3 | minecraft:endermite
|
31 | Evoker | 0.6 | 1.95 | minecraft:evoker
|
32 | Evoker Fangs | 0.5 | 0.8 | minecraft:evoker_fangs
|
33 | Experience Bottle | 0.25 | 0.25 | minecraft:experience_bottle
|
34 | Experience Orb | 0.5 | 0.5 | minecraft:experience_orb
|
35 | Eye Of Ender | 0.25 | 0.25 | minecraft:eye_of_ender
|
36 | Falling Block | 0.98 | 0.98 | minecraft:falling_block
|
37 | Firework Rocket | 0.25 | 0.25 | minecraft:firework_rocket
|
38 | Fox | 0.6 | 0.7 | minecraft:fox
|
39 | Frog | 0.5 | 0.5 | minecraft:frog
|
40 | Furnace Minecart | 0.98 | 0.7 | minecraft:furnace_minecart
|
41 | Ghast | 4.0 | 4.0 | minecraft:ghast
|
42 | Giant | 3.6 | 12.0 | minecraft:giant
|
43 | Glow Item Frame | 0.75 or 0.0625 (depth) | 0.75 | minecraft:glow_item_frame
|
44 | Glow Squid | 0.8 | 0.8 | minecraft:glow_squid
|
45 | Goat | 1.3 | 0.9 | minecraft:goat
|
46 | Guardian | 0.85 | 0.85 | minecraft:guardian
|
47 | Hoglin | 1.3964844 | 1.4 | minecraft:hoglin
|
48 | Hopper Minecart | 0.98 | 0.7 | minecraft:hopper_minecart
|
49 | Horse | 1.3964844 | 1.6 | minecraft:horse
|
50 | Husk | 0.6 | 1.95 | minecraft:husk
|
51 | Illusioner | 0.6 | 1.95 | minecraft:illusioner
|
52 | Interaction | 0.0 | 0.0 | minecraft:interaction
|
53 | Iron Golem | 1.4 | 2.7 | minecraft:iron_golem
|
54 | Item | 0.25 | 0.25 | minecraft:item
|
55 | Item Display | 0.0 | 0.0 | minecraft:item_display
|
56 | Item Frame | 0.75 or 0.0625 (depth) | 0.75 | minecraft:item_frame
|
57 | Fireball | 1.0 | 1.0 | minecraft:fireball
|
58 | Leash Knot | 0.375 | 0.5 | minecraft:leash_knot
|
59 | Lightning Bolt | 0.0 | 0.0 | minecraft:lightning_bolt
|
60 | Llama | 0.9 | 1.87 | minecraft:llama
|
61 | Llama Spit | 0.25 | 0.25 | minecraft:llama_spit
|
62 | Magma Cube | 0.5202 * size | 0.5202 * size | minecraft:magma_cube
|
63 | Marker | 0.0 | 0.0 | minecraft:marker
|
64 | Minecart | 0.98 | 0.7 | minecraft:minecart
|
65 | Mooshroom | 0.9 | 1.4 | minecraft:mooshroom
|
66 | Mule | 1.3964844 | 1.6 | minecraft:mule
|
67 | Ocelot | 0.6 | 0.7 | minecraft:ocelot
|
68 | Painting | type width or 0.0625 (depth) | type height | minecraft:painting
|
69 | Panda | 1.3 | 1.25 | minecraft:panda
|
70 | Parrot | 0.5 | 0.9 | minecraft:parrot
|
71 | Phantom | 0.9 | 0.5 | minecraft:phantom
|
72 | Pig | 0.9 | 0.9 | minecraft:pig
|
73 | Piglin | 0.6 | 1.95 | minecraft:piglin
|
74 | Piglin Brute | 0.6 | 1.95 | minecraft:piglin_brute
|
75 | Pillager | 0.6 | 1.95 | minecraft:pillager
|
76 | Polar Bear | 1.4 | 1.4 | minecraft:polar_bear
|
77 | Potion | 0.25 | 0.25 | minecraft:potion
|
78 | Pufferfish | 0.7 | 0.7 | minecraft:pufferfish
|
79 | Rabbit | 0.4 | 0.5 | minecraft:rabbit
|
80 | Ravager | 1.95 | 2.2 | minecraft:ravager
|
81 | Salmon | 0.7 | 0.4 | minecraft:salmon
|
82 | Sheep | 0.9 | 1.3 | minecraft:sheep
|
83 | Shulker | 1.0 | 1.0-2.0 (depending on peek) | minecraft:shulker
|
84 | Shulker Bullet | 0.3125 | 0.3125 | minecraft:shulker_bullet
|
85 | Silverfish | 0.4 | 0.3 | minecraft:silverfish
|
86 | Skeleton | 0.6 | 1.99 | minecraft:skeleton
|
87 | Skeleton Horse | 1.3964844 | 1.6 | minecraft:skeleton_horse
|
88 | Slime | 0.5202 * size | 0.5202 * size | minecraft:slime
|
89 | Small Fireball | 0.3125 | 0.3125 | minecraft:small_fireball
|
90 | Sniffer | 1.9 | 1.75 | minecraft:sniffer
|
91 | Snow Golem | 0.7 | 1.9 | minecraft:snow_golem
|
92 | Snowball | 0.25 | 0.25 | minecraft:snowball
|
93 | Spawner Minecart | 0.98 | 0.7 | minecraft:spawner_minecart
|
94 | Spectral Arrow | 0.5 | 0.5 | minecraft:spectral_arrow
|
95 | Spider | 1.4 | 0.9 | minecraft:spider
|
96 | Squid | 0.8 | 0.8 | minecraft:squid
|
97 | Stray | 0.6 | 1.99 | minecraft:stray
|
98 | Strider | 0.9 | 1.7 | minecraft:strider
|
99 | Tadpole | 0.4 | 0.3 | minecraft:tadpole
|
100 | Text Display | 0.0 | 0.0 | minecraft:text_display
|
101 | Tnt | 0.98 | 0.98 | minecraft:tnt
|
102 | Tnt Minecart | 0.98 | 0.7 | minecraft:tnt_minecart
|
103 | Trader Llama | 0.9 | 1.87 | minecraft:trader_llama
|
104 | Trident | 0.5 | 0.5 | minecraft:trident
|
105 | Tropical Fish | 0.5 | 0.4 | minecraft:tropical_fish
|
106 | Turtle | 1.2 | 0.4 | minecraft:turtle
|
107 | Vex | 0.4 | 0.8 | minecraft:vex
|
108 | Villager | 0.6 | 1.95 | minecraft:villager
|
109 | Vindicator | 0.6 | 1.95 | minecraft:vindicator
|
110 | Wandering Trader | 0.6 | 1.95 | minecraft:wandering_trader
|
111 | Warden | 0.9 | 2.9 | minecraft:warden
|
112 | Witch | 0.6 | 1.95 | minecraft:witch
|
113 | Wither | 0.9 | 3.5 | minecraft:wither
|
114 | Wither Skeleton | 0.7 | 2.4 | minecraft:wither_skeleton
|
115 | Wither Skull | 0.3125 | 0.3125 | minecraft:wither_skull
|
116 | Wolf | 0.6 | 0.85 | minecraft:wolf
|
117 | Zoglin | 1.3964844 | 1.4 | minecraft:zoglin
|
118 | Zombie | 0.6 | 1.95 | minecraft:zombie
|
119 | Zombie Horse | 1.3964844 | 1.6 | minecraft:zombie_horse
|
120 | Zombie Villager | 0.6 | 1.95 | minecraft:zombie_villager
|
121 | Zombified Piglin | 0.6 | 1.95 | minecraft:zombified_piglin
|
122 | Player | 0.6 | 1.8 | minecraft:player
|
123 | 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 (VarInt Enum) | Value (Varies) | Notes |
---|---|---|
0 | Byte | |
1 | VarInt | |
2 | VarLong | |
3 | Float | |
4 | String | |
5 | Chat | |
6 | OptChat (Boolean + Chat) | Chat is present if the Boolean is set to true |
7 | Slot | |
8 | Boolean | |
9 | Rotation | 3 Floats: rotation on x, rotation on y, rotation on z |
10 | Position | |
11 | OptPosition (Boolean + Position) | Position is present if the Boolean is set to true |
12 | Direction (VarInt) | (Down = 0, Up = 1, North = 2, South = 3, West = 4, East = 5) |
13 | OptUUID (Boolean + UUID) | UUID is present if the Boolean is set to true |
14 | BlockID (VarInt) | |
15 | OptBlockID (VarInt) | 0 for absent (implies air); otherwise, a block state ID as per the block state registry |
16 | NBT | |
17 | Particle | |
18 | Villager Data | 3 VarInts: villager type, villager profession, level |
19 | OptVarInt | 0 for absent; 1 + actual value otherwise. Used for entity IDs. |
20 | Pose | A VarInt enum: 0: STANDING, 1: FALL_FLYING, 2: SLEEPING, 3: SWIMMING, 4: SPIN_ATTACK, 5: SNEAKING, 6: LONG_JUMPING, 7: DYING, 8: CROAKING, 9: USING_TONGUE, 10: SITTING, 11: ROARING, 12: SNIFFING, 13: EMERGING, 14: DIGGING |
21 | Cat Variant | A VarInt that points towards the CAT_VARIANT registry. |
22 | Frog Variant | A VarInt that points towards the FROG_VARIANT registry. |
23 | OptGlobalPos (Boolean + GlobalPos) | GlobalPos consists of a dimension identifier and Position. |
24 | Painting Variant | A VarInt that points towards the PAINTING_VARIANT registry. |
25 | Sniffer State | A VarInt enum: IDLING = 0, FEELING_HAPPY = 1, SCENTING = 2, SNIFFING = 3, SEARCHING = 4, DIGGING = 5, RISING = 6 |
26 | Vector3 | 3 Floats: x, y, z |
27 | Quaternion | 4 Floats: x, y, z, w |
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 |
Entity classes also recursively inherit fields from classes they extend.
Entity Metadata
Entity
The base class.
Index | Type | Meaning | Default | |
---|---|---|---|---|
0 | Byte | Bit mask | Meaning | 0 |
0x01 | Is on fire | |||
0x02 | Is crouching | |||
0x04 | Unused (previously riding) | |||
0x08 | Is sprinting | |||
0x10 | Is swimming | |||
0x20 | Is invisible | |||
0x40 | has glowing effect | |||
0x80 | Is flying with an elytra | |||
1 | VarInt | Air ticks | 300 | |
2 | OptChat | Custom name | empty | |
3 | Boolean | Is custom name visible | false | |
4 | Boolean | Is silent | false | |
5 | Boolean | Has no gravity | false | |
6 | Pose | Pose | STANDING | |
7 | VarInt | Ticks frozen in powdered snow | 0 |
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).
Interaction
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | Float | Width | 1.0 | |
9 | Float | Height | 1.0 | |
10 | Boolean | Responsive - can be attacked/interacted with if true | false |
Display
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | VarInt | Interpolation delay | 0 | |
9 | VarInt | Transformation interpolation duration | 0 | |
10 | VarInt | Position/Rotation interpolation duration | 0 | |
11 | Vector3 | Translation | (0.0, 0.0, 0.0) | |
12 | Vector3 | Scale | (1.0, 1.0, 1.0) | |
13 | Quaternion | Rotation left | (0.0, 0.0, 0.0, 1.0) | |
14 | Quaternion | Rotation right | (0.0, 0.0, 0.0, 1.0) | |
15 | Byte | Billboard Constraints (0 = FIXED, 1 = VERTICAL, 2 = HORIZONTAL, 3 = CENTER) | 0 | |
16 | VarInt | Brightness override (blockLight << 4 | skyLight << 20 )
|
-1 | |
17 | Float | View range | 1.0 | |
18 | Float | Shadow radius | 0.0 | |
19 | Float | Shadow strength | 1.0 | |
20 | Float | Width | 0.0 | |
21 | Float | Height | 0.0 | |
22 | VarInt | Glow color override | -1 |
Block Display
Extends Display.
Index | Type | Meaning | Default | |
---|---|---|---|---|
23 | BlockID | Displayed block state | 0 (Air) |
Item Display
Extends Display.
Index | Type | Meaning | Default | |
---|---|---|---|---|
23 | Slot | Displayed item | Empty | |
24 | Byte | Display type:
|
0 (NONE) |
Text Display
Extends Display.
Index | Type | Meaning | Default | |
---|---|---|---|---|
23 | Chat | Text | Empty | |
24 | VarInt | Line width | 200 | |
25 | VarInt | Background color | 1073741824 (0x40000000) | |
26 | Byte | Text opacity | -1 (fully opaque) | |
27 | Byte | Bit mask | Meaning | 0 |
0x01 | Has shadow | |||
0x02 | Is see through | |||
0x04 | Use default background color | |||
0x08 | Alignment:
|
Thrown Item Projectile
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | Slot | 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 Experience Bottle
Extends Thrown Item Projectile.
Default item is minecraft:experience_bottle
.
No additional metadata.
Thrown Potion
Extends Thrown Item Projectile.
Default item is minecraft:splash_potion
.
No additional metadata.
Snowball
Extends Thrown Item Projectile.
Default item is minecraft:snowball
.
No additional metadata.
Eye of Ender
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | Slot | Item | Empty (which behaves as if it were a minecraft:ender_eye )
|
Falling Block
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | BlockPos | spawn position | (0, 0, 0) |
Area Effect Cloud
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | Float | Radius | 0.5 | |
9 | VarInt | Color (only for mob spell particle) | 0 | |
10 | Boolean | Ignore radius and show effect as single point, not area | false | |
11 | Particle | The #Particle | effect
|
Fishing Hook
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | VarInt | Hooked entity id + 1, or 0 if there is no hooked entity | 0 | |
9 | Boolean | Is catchable | False |
Abstract Arrow
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | Byte | Bit mask | Meaning | 0 |
0x01 | Is critical | |||
0x02 | Is noclip (used by loyalty tridents when returning) | |||
9 | Byte | Piercing level | 0 |
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 | |
---|---|---|---|---|
10 | VarInt | Color (-1 for no particles) | -1 |
Spectral Arrow
Extends Abstract Arrow.
No additional metadata.
Thrown Trident
Extends Abstract Arrow.
Index | Type | Meaning | Default | |
---|---|---|---|---|
10 | VarInt | Loyalty level (enchantment) | 0 | |
11 | Boolean | Has enchantment glint | False |
Boat
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | VarInt | Time since last hit | 0 | |
9 | VarInt | Forward direction | 1 | |
10 | Float | Damage taken | 0.0 | |
11 | VarInt | Type (0=oak, 1=spruce, 2=birch, 3=jungle, 4=acacia, 5=dark oak) | 0 | |
12 | Boolean | Is left paddle turning | false | |
13 | Boolean | Is right paddle turning | false | |
14 | VarInt | Splash timer | 0 |
Chest Boat
Extends Boat.
No additional metadata.
End Crystal
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | OptBlockPos | Beam target | Empty | |
9 | Boolean | Show bottom | true |
Dragon Fireball
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 | Item | Empty (which behaves as if it were a minecraft:fire_charge )
|
Fireball
Extends Entity.
This is the large fireball shot by ghasts.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | Slot | Item | Empty |
Wither Skull
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | Boolean | Is invulnerable | false |
Firework Rocket Entity
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | Slot | Firework info | Empty | |
9 | OptVarInt | Entity ID of entity which used firework (for elytra boosting) | Empty | |
10 | Boolean | Is shot at angle (from a crossbow) | false |
Item Frame
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | Slot | Item | Empty | |
9 | VarInt | Rotation | 0 |
Glowing Item Frame
Extends Item Frame.
No additional metadata.
Painting
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | PaintingVariant | Painting Type | KEBAB |
Item Entity
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | Slot | Item | Empty |
Living Entity
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | 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 | Is in riptide spin attack | |||
9 | Float | Health | 1.0 | |
10 | VarInt | Potion effect color (or 0 if there is no effect) | 0 | |
11 | Boolean | Is potion effect ambient: reduces the number of particles generated by potions to 1/5 the normal amount | false | |
12 | VarInt | Number of arrows in entity | 0 | |
13 | VarInt | Number of bee stingers in entity | 0 | |
14 | OptBlockPos | Location of the bed that the entity is currently sleeping in (Empty if it isn't sleeping) | Empty |
Player
Extends Living Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | Float | Additional Hearts | 0.0 | |
16 | VarInt | Score | 0 | |
17 | 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 | |||
18 | Byte | Main hand (0 : Left, 1 : Right) | 1 | |
19 | NBT | Left shoulder entity data (for occupying parrot) | Empty | |
20 | NBT | Right shoulder entity data (for occupying parrot) | Empty |
Armor Stand
Extends Living Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | Byte | Bit mask | Meaning | 0 |
0x01 | Is Small | |||
0x04 | Has Arms | |||
0x08 | Has no BasePlate | |||
0x10 | Is Marker | |||
16 | Rotations | Head rotation | (0.0, 0.0, 0.0) | |
17 | Rotations | Body rotation | (0.0, 0.0, 0.0) | |
18 | Rotations | Left arm rotation | (-10.0, 0.0, -10.0) | |
19 | Rotations | Right arm rotation | (-15.0, 0.0, 10.0) | |
20 | Rotations | Left leg rotation | (-1.0, 0.0, -1.0) | |
21 | Rotations | 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.
Mob
Extends Living Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | Byte | Bit mask | Meaning | 0 |
0x01 | NoAI | |||
0x02 | Is left handed | |||
0x04 | Is aggressive |
Ambient Creature
Extends Mob.
No additional metadata.
Bat
Extends Ambient Creature.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Byte | Bit mask | Meaning | 0 |
0x01 | Is hanging |
Pathfinder Mob
Extends Mob.
No additional metadata.
Water Animal
Extends Pathfinder Mob.
No additional metadata.
Squid
Extends Water Animal.
No additional metadata.
Dolphin
Extends Water Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Position | Treasure position | (0, 0, 0) | |
17 | Boolean | Has fish | false | |
18 | VarInt | Moisture level | 2400 |
Abstract fish
Extends Water Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Boolean | From bucket | False |
Cod
Extends Abstract fish.
No additional metadata.
Puffer fish
Extends Abstract fish.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | VarInt | PuffState (varies from 0 to 2) | 0 |
Salmon
Extends Abstract fish.
No additional metadata.
Tropical fish
Extends Abstract fish.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | VarInt | Variant | 0 |
Tadpole
Extends Abstract fish.
No additional metadata.
Ageable Mob
Extends Pathfinder Mob.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Boolean | Is baby | false |
Animal
Extends Ageable Mob.
No additional metadata.
Sniffer
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | Sniffer State | Sniffer State | IDLING | |
18 | VarInt | Drop seed at tick | 0 |
Abstract Horse
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | 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 |
Horse
Extends Abstract Horse.
Index | Type | Meaning | Default | |
---|---|---|---|---|
18 | VarInt | Variant (Color & Style) | 0 |
Zombie Horse
Extends Abstract Horse.
No additional metadata.
Skeleton Horse
Extends Abstract Horse.
No additional metadata.
Camel
Extends Abstract Horse.
Index | Type | Meaning | Default | |
---|---|---|---|---|
18 | Boolean | Is dashing | False | |
19 | VarLong | Last pose change tick | 0 |
Chested Horse
Extends Abstract Horse.
Index | Type | Meaning | Default | |
---|---|---|---|---|
18 | Boolean | Has Chest | false |
Donkey
Extends Chested Horse.
No additional metadata.
Llama
Extends Chested Horse.
Index | Type | Meaning | Default | |
---|---|---|---|---|
19 | VarInt | Strength (number of columns of 3 slots in the llama's inventory once a chest is equipped) | 0 | |
20 | VarInt | Carpet color (a dye color, or -1 if no carpet equipped) | -1 | |
21 | VarInt | 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.
Axolotl
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | VarInt | Variant (0 = lucy, 1 = wild, 2 = gold, 3 = cyan, 4 = blue) | 0 (lucy) | |
18 | Boolean | If it is currently playing dead. | false | |
19 | Boolean | If it was spawned from a bucket. | false |
Bee
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | Byte | Flags | 0 | |
0x01 | Unused | |||
0x02 | Is angry | |||
0x04 | Has stung | |||
0x08 | Has nectar | |||
18 | VarInt | Anger time in ticks | 0 (Not angry) |
Fox
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | VarInt | Type (0: red, 1: snow) | 0 (red) | |
18 | Byte | 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 | OptUUID | First UUID (in UUIDs NBT)?
|
Absent | |
20 | OptUUID | Second UUID (in UUIDs NBT)?
|
Absent |
Frog
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | FrogVariant | Frog Variant | TEMPERATE | |
18 | Optional Unsigned VarInt | Tongue Target | 0 |
Ocelot
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | Boolean | Is trusting | false |
Panda
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | VarInt | 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 | 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 | Eat timer. If nonzero, counts upwards. | 0 | |
20 | Byte | Main Gene | 0 | |
21 | Byte | Hidden Gene | 0 | |
22 | Byte | 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 | Boolean | Has saddle | false | |
18 | 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 | |
---|---|---|---|---|
17 | VarInt | Type | 0 |
Turtle
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | BlockPos | Home pos | (0, 0, 0) | |
18 | Boolean | Has egg | false | |
19 | Boolean | Is laying egg | false | |
20 | BlockPos | Travel pos | (0, 0, 0) | |
21 | Boolean | Is going home | false | |
22 | Boolean | Is traveling | false |
Polar Bear
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | Boolean | Is standing up | false |
Chicken
Extends Animal.
No additional metadata.
Cow
Extends Animal.
No additional metadata.
Hoglin
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | Boolean | Is immune to zombification | false |
Mooshroom
Extends Cow.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | String | Variant ("red" or "brown") | red |
Sheep
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | Byte | Bit mask | Meaning | 0 |
0x0F | Color ID | |||
0x10 | Is sheared |
Strider
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | VarInt | Total time to "boost" with warped fungus on a stick for | 0 | |
18 | Boolean | Is shaking (true unless riding a vehicle or on or in a block tagged with strider_warm_blocks (default: lava)) | false | |
19 | Boolean | Has saddle | false |
Tameable Animal
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | Byte | Bit mask | Meaning | 0 |
0x01 | Is sitting | |||
0x02 | Unused | |||
0x04 | Is tamed | |||
18 | OptUUID | Owner | Absent |
Cat
Extends Tameable Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
19 | Cat Variant | Cat Variant | BLACK | |
20 | Boolean | Is lying | false | |
21 | Boolean | Is relaxed? (This makes their head go slightly upwards, unknown when used) | false | |
22 | VarInt | Collar color (values are those used with dyes) | 14 (Red) |
Wolf
Extends Tameable Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
19 | Boolean | Is begging | false | |
20 | VarInt | Collar color (values are those used with dyes) | 14 (Red) | |
21 | VarInt | Anger time | 0 |
Parrot
Extends Tameable Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
19 | VarInt | Variant (0: red/blue, 1: blue, 2: green, 3: yellow/blue, 4: grey) | 0 |
Abstract Villager
Extends Ageable Mob.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | VarInt | Head shake timer (starts at 40, decrements each tick) | 0 |
Villager
Extends Abstract Villager.
Index | Type | Meaning | Default | |
---|---|---|---|---|
18 | Villager Data | Villager Data | Plains/None/1 |
Wandering Trader
Extends Abstract Villager.
No additional metadata.
Abstract Golem
Extends Pathfinder Mob.
No additional metadata.
Iron Golem
Extends Abstract Golem.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Byte | Bit mask | Meaning | 0 |
0x01 | Is player-created |
Snow Golem
Extends Abstract Golem.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Byte | Bit mask | Meaning | 0x10 |
0x00 | Has no pumpkin hat | |||
0x10 | Has pumpkin hat |
Shulker
Extends Abstract Golem.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Direction | Attach face | Down (0) | |
17 | Byte | Shield height | 0 | |
18 | Byte | Color (dye color) | 10 (purple) |
Monster
Extends Pathfinder Mob.
No additional metadata.
Base Piglin
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Boolean | Is immune to zombification | false |
Piglin
Extends Base Piglin.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | Boolean | Is baby | false | |
18 | Boolean | Is charging crossbow | false | |
19 | Boolean | Is dancing | false |
Piglin Brute
Extends Base Piglin.
No additional metadata.
Blaze
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Byte | Bit mask | Meaning | 0 |
0x01 | Is on fire |
Creeper
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | VarInt | State (-1 = idle, 1 = fuse) | -1 | |
17 | Boolean | Is charged | false | |
18 | Boolean | Is ignited | false |
Endermite
Extends Monster.
No additional metadata.
Giant
Extends Monster.
No additional metadata.
Goat
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | Boolean | Is Screaming Goat | false | |
18 | Boolean | Has Left Horn | true | |
19 | Boolean | Has Right Horn | true |
Guardian
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Boolean | Is retracting spikes | false | |
17 | VarInt | Target EID | 0 |
Elder Guardian
Extends Guardian.
No additional metadata.
Silverfish
Extends Monster.
No additional metadata.
Raider
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | 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 Raider.
No additional metadata.
Vindicator
Extends Abstract Illager.
No additional metadata.
Pillager
Extends Abstract Illager.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | Boolean | Is charging | false |
Spellcaster Illager
Extends Abstract Illager.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | Byte | 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.
Ravager
Extends Raider.
No additional metadata.
Witch
Extends Raider.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | Boolean | Is drinking potion | false |
Evoker Fangs
Extends Entity.
No additional metadata.
Vex
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Byte | Bit mask | Meaning | 0 |
0x01 | Is attacking |
Abstract Skeleton
Extends Monster.
No additional metadata.
Skeleton
Extends Abstract Skeleton.
No additional metadata.
Wither Skeleton
Extends Abstract Skeleton.
No additional metadata.
Stray
Extends Abstract Skeleton.
No additional metadata.
Spider
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Byte | Bit mask | Meaning | 0 |
0x01 | Is climbing |
Warden
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | VarInt | Anger Level | 0 |
Wither
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | VarInt | Center head's target (entity ID, or 0 if no target) | 0 | |
17 | VarInt | Left head's target (entity ID, or 0 if no target) | 0 | |
18 | VarInt | Right head's target (entity ID, or 0 if no target) | 0 | |
19 | VarInt | Invulnerable time | 0 |
Zoglin
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Boolean | Is baby | false |
Zombie
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Boolean | Is baby | false | |
17 | VarInt | Unused (previously type) | 0 | |
18 | Boolean | Is becoming a drowned | false |
Zombie Villager
Extends Zombie.
Index | Type | Meaning | Default | |
---|---|---|---|---|
19 | Boolean | Is converting | false | |
20 | Villager Data | Villager Data | Plains/None/1 |
Husk
Extends Zombie.
No additional metadata.
Drowned
Extends Zombie.
No additional metadata.
Zombified Piglin
Extends Zombie.
No additional metadata.
Enderman
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Opt BlockID | Carried block | Absent | |
17 | Boolean | Is screaming | false | |
18 | Boolean | Is staring | false |
Ender Dragon
Extends Mob.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | 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 Mob.
No additional metadata.
Ghast
Extends Flying.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Boolean | Is attacking | false |
Phantom
Extends Flying.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | VarInt | 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 | Size | 1 |
Llama Spit
Extends Entity.
No additional metadata.
Abstract Minecart
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | VarInt | Shaking power | 0 | |
9 | VarInt | Shaking direction | 1 | |
10 | Float | Shaking multiplier | 0.0 | |
11 | VarInt | Custom block ID and damage | 0 | |
12 | VarInt | Custom block Y position (in 16ths of a block) | 6 | |
13 | 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
Minecart
Extends Abstract Minecart.
No additional metadata.
Abstract Minecart Container
Extends Abstract Minecart.
No additional metadata.
Minecart Hopper
Extends Abstract Minecart Container.
No additional metadata.
Minecart Chest
Extends Abstract Minecart Container.
No additional metadata.
Minecart Furnace
Extends Abstract Minecart.
Index | Type | Meaning | Default | |
---|---|---|---|---|
14 | Boolean | Has fuel | false |
Minecart TNT
Extends Abstract Minecart.
No additional metadata.
Minecart Spawner
Extends Abstract Minecart.
No additional metadata.
Minecart Command Block
Extends Abstract Minecart.
Index | Type | Meaning | Default | |
---|---|---|---|---|
14 | String | Command |
| |
15 | Chat | Last output | {"text":""}
|
Primed Tnt
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | VarInt | Fuse time | 80 |