Entity metadata
Various Entities have different metadata fields and status codes.
Contents
- 1 Mobs
- 2 Objects
- 3 Entity Metadata Format
- 3.1 Entity
- 3.2 Throwable
- 3.3 Itemed Throwable
- 3.4 Egg
- 3.5 Ender Pearl
- 3.6 Experience Bottle
- 3.7 Snowball
- 3.8 Potion
- 3.9 Eye of Ender
- 3.10 FallingBlock
- 3.11 AreaEffectCloud
- 3.12 FishingHook
- 3.13 Arrow
- 3.14 Spectral Arrow
- 3.15 Trident
- 3.16 Boat
- 3.17 EnderCrystal
- 3.18 Abstract Fireball
- 3.19 Dragon Fireball
- 3.20 Itemed Fireball
- 3.21 Fireball
- 3.22 Small Fireball
- 3.23 WitherSkull
- 3.24 Fireworks
- 3.25 Hanging
- 3.26 ItemFrame
- 3.27 Item
- 3.28 Living
- 3.29 Player
- 3.30 ArmorStand
- 3.31 Insentient
- 3.32 Ambient
- 3.33 Bat
- 3.34 Creature
- 3.35 WaterMob
- 3.36 Squid
- 3.37 Dolphin
- 3.38 Abstract fish
- 3.39 Cod
- 3.40 Puffer fish
- 3.41 Salmon
- 3.42 Tropical fish
- 3.43 Ageable
- 3.44 Animal
- 3.45 AbstractHorse
- 3.46 Horse
- 3.47 ZombieHorse
- 3.48 SkeletonHorse
- 3.49 ChestedHorse
- 3.50 Donkey
- 3.51 Llama
- 3.52 Trader Llama
- 3.53 Mule
- 3.54 Bee
- 3.55 Fox
- 3.56 Ocelot
- 3.57 Panda
- 3.58 Pig
- 3.59 Rabbit
- 3.60 Turtle
- 3.61 Polar Bear
- 3.62 Chicken
- 3.63 Cow
- 3.64 Mooshroom
- 3.65 Sheep
- 3.66 TameableAnimal
- 3.67 Cat
- 3.68 Wolf
- 3.69 Parrot
- 3.70 Abstract Merchant
- 3.71 Villager
- 3.72 Wandering Trader
- 3.73 Golem
- 3.74 IronGolem
- 3.75 Snowman
- 3.76 Shulker
- 3.77 Monster
- 3.78 Blaze
- 3.79 Creeper
- 3.80 Endermite
- 3.81 Giant Zombie
- 3.82 Guardian
- 3.83 ElderGuardian
- 3.84 Silverfish
- 3.85 Raid Participant
- 3.86 Abstract Illager
- 3.87 Vindicator
- 3.88 Pillager
- 3.89 Spellcaster Illager
- 3.90 Evoker
- 3.91 Illusioner
- 3.92 Ravager
- 3.93 Witch
- 3.94 EvocationFangs
- 3.95 Vex
- 3.96 AbstractSkeleton
- 3.97 Skeleton
- 3.98 Wither Skeleton
- 3.99 Stray
- 3.100 Spider
- 3.101 Wither
- 3.102 Zombie
- 3.103 Zombie Villager
- 3.104 Husk
- 3.105 Drowned
- 3.106 Zombified Piglin
- 3.107 Enderman
- 3.108 EnderDragon
- 3.109 Flying
- 3.110 Ghast
- 3.111 Phantom
- 3.112 Slime
- 3.113 LlamaSpit
- 3.114 Minecart
- 3.115 MinecartRideable
- 3.116 MinecartContainer
- 3.117 MinecartHopper
- 3.118 MinecartChest
- 3.119 MinecartFurnace
- 3.120 MinecartTNT
- 3.121 MinecartSpawner
- 3.122 MinecartCommandBlock
- 3.123 TNTPrimed
- 3.124 Piglin
- 3.125 Piglin Brute
Mobs
Mobs are spawned via Spawn Mob.
Some entities (marked in yellow) should only be spawned using Spawn Object and their Object ID. While they also have an entity ID, this ID is only used internally. Servers should not attempt to spawn these entities using Spawn Mob with that entity ID, although clients should accept such packets if they appear.
Additionally, a few other entities (marked in blue) must be spawned in their own special ways:
- Paintings should be spawned using Spawn Painting
- XP orbs should be spawned using Spawn Experience Orb.
These entity IDs are out of date. Use Data Generators or Burger to get current IDs.
Type | Name | bounding box x and z | bounding box y | ID |
---|---|---|---|---|
0 | Area Effect Cloud | 2.0 * Radius | 0.5 | minecraft:area_effect_cloud
|
1 | Armor Stand | normal: 0.5 marker: 0.0 small: 0.25 | normal: 1.975 marker: 0.0 small: 0.9875 | minecraft:armor_stand
|
2 | Arrow | 0.5 | 0.5 | minecraft:arrow
|
3 | Bat | 0.5 | 0.9 | minecraft:bat
|
4 | Bee | 0.7 | 0.6 | minecraft:bee
|
5 | Blaze | 0.6 | 1.8 | minecraft:blaze
|
6 | Boat | 1.375 | 0.5625 | minecraft:boat
|
7 | Cat | 0.6 | 0.7 | minecraft:cat
|
8 | Cave Spider | 0.7 | 0.5 | minecraft:cave_spider
|
9 | Chicken | 0.4 | 0.7 | minecraft:chicken
|
10 | Cod | 0.5 | 0.3 | minecraft:cod
|
11 | Cow | 0.9 | 1.4 | minecraft:cow
|
12 | Creeper | 0.6 | 1.7 | minecraft:creeper
|
13 | Dolphin | 0.9 | 0.6 | minecraft:dolphin
|
14 | Donkey | 1.5 | 1.39648 | minecraft:donkey
|
15 | Dragon Fireball | 1.0 | 1.0 | minecraft:dragon_fireball
|
16 | Drowned | 0.6 | 1.95 | minecraft:drowned
|
17 | Elder Guardian | 1.9975 (2.35 * guardian) | 1.9975 (2.35 * guardian) | minecraft:elder_guardian
|
18 | End Crystal | 2.0 | 2.0 | minecraft:end_crystal
|
19 | Ender Dragon | 16.0 | 8.0 | minecraft:ender_dragon
|
20 | Enderman | 0.6 | 2.9 | minecraft:enderman
|
21 | Endermite | 0.4 | 0.3 | minecraft:endermite
|
22 | Evoker | 0.6 | 1.95 | minecraft:evoker
|
23 | Evoker Fangs | 0.5 | 0.8 | minecraft:evoker_fangs
|
24 | Experience Orb | 0.5 | 0.5 | minecraft:experience_orb
|
24 | Eye of Ender | 0.25 | 0.25 | minecraft:eye_of_ender
|
26 | Falling Block | 0.98 | 0.98 | minecraft:falling_block
|
27 | Firework Rocket | 0.25 | 0.25 | minecraft:firework_rocket
|
28 | Fox | 0.6 | 0.7 | minecraft:fox
|
29 | Ghast | 4.0 | 4.0 | minecraft:ghast
|
30 | Giant | 3.6 | 12.0 | minecraft:giant
|
31 | Guardian | 0.85 | 0.85 | minecraft:guardian
|
32 | Hoglin | 1.39648 | 1.4 | minecraft:hoglin
|
33 | Horse | 1.39648 | 1.6 | minecraft:horse
|
34 | Husk | 0.6 | 1.95 | minecraft:husk
|
35 | Illusioner | 0.6 | 1.95 | minecraft:illusioner
|
36 | Iron Golem | 1.4 | 2.7 | minecraft:iron_golem
|
37 | Item | 0.25 | 0.25 | minecraft:item
|
38 | ItemFrame | 0.75 or 0.0625 (depth) | 0.75 | minecraft:item_frame
|
39 | Fireball | 1.0 | 1.0 | minecraft:fireball
|
40 | Leash Knot | 0.375 | 0.5 | minecraft:leash_knot
|
41 | Lightning Bolt | 0.0 | 0.0 | minecraft:lightning_bolt
|
42 | Llama | 0.9 | 1.87 | minecraft:llama
|
43 | Llama Spit | 0.25 | 0.25 | minecraft:llama_spit
|
44 | Magma Cube | 0.51000005 * size | 0.51000005 * size | minecraft:magma_cube
|
45 | Minecart | 0.98 | 0.7 | minecraft:minecart
|
46 | Minecart with Chest | 0.98 | 0.7 | minecraft:chest_minecart
|
47 | Minecart with Command Block | 0.98 | 0.7 | minecraft:commandblock_minecart
|
48 | Minecart with Furnace | 0.98 | 0.7 | minecraft:furnace_minecart
|
49 | Minecart with Hopper | 0.98 | 0.7 | minecraft:hopper_minecart
|
50 | MinecartSpawner | 0.98 | 0.7 | minecraft:spawner_minecart
|
51 | MinecartTNT | 0.98 | 0.7 | minecraft:tnt_minecart
|
52 | Mule | 1.39648 | 1.6 | minecraft:mule
|
53 | Mushroom | 0.9 | 1.4 | minecraft:mooshroom
|
54 | Ocelot | 0.6 | 0.7 | minecraft:ocelot
|
55 | Painting | type width or 0.0625 (depth) | type height | minecraft:painting
|
56 | Panda | 1.3 | 1.25 | minecraft:panda
|
57 | Parrot | 0.5 | 0.9 | minecraft:parrot
|
58 | Phantom | 0.9 | 0.5 | minecraft:phantom
|
59 | Pig | 0.9 | 0.9 | minecraft:pig
|
60 | Piglin | 0.6 | 1.95 | minecraft:piglin
|
61 | Pillager | 0.6 | 1.95 | minecraft:pillager
|
62 | Polar Bear | 1.4 | 1.4 | minecraft:polar_bear
|
63 | Primed TNT | 0.98 | 0.98 | minecraft:tnt
|
64 | Pufferfish | 0.7 | 0.7 | minecraft:pufferfish
|
65 | Rabbit | 0.4 | 0.5 | minecraft:rabbit
|
66 | Ravager | 1.95 | 2.2 | minecraft:ravager
|
67 | Salmon | 0.7 | 0.4 | minecraft:salmon
|
68 | Sheep | 0.9 | 1.3 | minecraft:sheep
|
69 | Shulker | 1.0 | 1.0-2.0 (depending on peek) | minecraft:shulker
|
70 | Shulker Bullet | 0.3125 | 0.3125 | minecraft:shulker_bullet
|
71 | Silverfish | 0.4 | 0.3 | minecraft:silverfish
|
72 | Skeleton | 0.6 | 1.99 | minecraft:skeleton
|
73 | Skeleton Horse | 1.39648 | 1.6 | minecraft:skeleton_horse
|
74 | Slime | 0.51000005 * size | 0.51000005 * size | minecraft:slime
|
75 | Small Fireball (blaze) | 0.3125 | 0.3125 | minecraft:small_fireball
|
76 | Snow Golem | 0.7 | 1.9 | minecraft:snow_golem
|
77 | Snowball | 0.25 | 0.25 | minecraft:snowball
|
78 | SpectralArrow | 0.5 | 0.5 | minecraft:spectral_arrow
|
79 | Spider | 1.4 | 0.9 | minecraft:spider
|
80 | Squid | 0.8 | 0.8 | minecraft:squid
|
81 | Stray | 0.6 | 1.99 | minecraft:stray
|
82 | Strider | 0.9 | 1.7 | minecraft:strider
|
83 | Thrown Egg | 0.25 | 0.25 | minecraft:egg
|
84 | Thrown Ender Pearl | 0.25 | 0.25 | minecraft:ender_pearl
|
85 | Thrown Bottle o' Enchanting | 0.25 | 0.25 | minecraft:experience_bottle
|
86 | Potion | 0.25 | 0.25 | minecraft:potion
|
87 | Trident | 0.5 | 0.5 | minecraft:trident
|
88 | Trader LLama | 0.9 | 1.87 | minecraft:trader_llama
|
89 | Tropical Fish | 0.5 | 0.4 | minecraft:tropical_fish
|
90 | Turtle | 1.2 | 0.4 | minecraft:turtle
|
91 | Vex | 0.4 | 0.8 | minecraft:vex
|
92 | Villager | 0.6 | 1.95 | minecraft:villager
|
93 | Vindicator | 0.6 | 1.95 | minecraft:vindicator
|
94 | Wandering Trader | 0.6 | 1.95 | minecraft:wandering_trader
|
95 | Witch | 0.6 | 1.95 | minecraft:witch
|
96 | Wither | 0.9 | 3.5 | minecraft:wither
|
97 | Wither Skeleton | 0.7 | 2.4 | minecraft:wither_skeleton
|
98 | Wither Skull | 0.3125 | 0.3125 | minecraft:wither_skull
|
99 | Wolf | 0.6 | 0.85 | minecraft:wolf
|
100 | Zoglin | 1.39648 | 1.4 | minecraft:zoglin
|
101 | Zombie | 0.6 | 1.95 | minecraft:zombie
|
102 | Zombie Horse | 1.39648 | 1.6 | minecraft:zombie_horse
|
103 | Zombie Villager | 0.6 | 1.95 | minecraft:zombie_villager
|
104 | Zombified Piglin | 0.6 | 1.95 | minecraft:zombified_piglin
|
105 | Player | 0.6 | 1.8 | minecraft:player
|
106 | Fishing Bobber | 0.25 | 0.25 | minecraft:fishing_bobber
|
Objects
Objects are spawned via Spawn Object. See Object Data for more details.
Object IDs and Entity IDs are different. Most objects also have an entity ID, but should only ever be spawned via Spawn Object.
ID | Name | bounding box x and z | bounding box y |
---|---|---|---|
1 | Boat | 1.375 | 0.5625 |
2 | Item Stack (Slot) | 0.25 | 0.25 |
3 | Area Effect Cloud | 2.0 * Radius | 0.5 |
10 | Minecart | 0.98 | 0.7 |
50 | Primed TNT | 0.98 | 0.98 |
51 | End Crystal | 2.0 | 2.0 |
60 | Tipped arrow (projectile; also used for regular arrows) | 0.5 | 0.5 |
61 | Snowball (projectile) | 0.25 | 0.25 |
62 | Egg (projectile) | 0.25 | 0.25 |
63 | Fireball (Ghast projectile) | 1.0 | 1.0 |
64 | Small Fireball (Blaze projectile) | 0.3125 | 0.3125 |
65 | Thrown Ender Pearl | 0.25 | 0.25 |
66 | Wither Skull (Wither projectile) | 0.3125 | 0.3125 |
67 | Shulker Bullet | 0.3125 | 0.3125 |
68 | Llama spit | 0.25 | 0.25 |
70 | Falling Block | 0.98 | 0.98 |
71 | Item Frame | 0.75 or 0.0625 | 0.75 |
72 | Eye of Ender | 0.25 | 0.25 |
73 | Thrown Potion | 0.25 | 0.25 |
75 | Thrown Exp Bottle | 0.25 | 0.25 |
76 | Firework Rocket | 0.25 | 0.25 |
77 | Leash Knot | 0.375 | 0.5 |
78 | ArmorStand | normal: 0.5 marker: 0.0 small: 0.25 | normal: 1.975 marker: 0.0 small: 0.9875 |
79 | Evoker Fangs Fangs | 0.5 | 0.8 |
90 | Fishing Hook | 0.25 | 0.25 |
91 | Spectral Arrow | 0.5 | 0.5 |
93 | Dragon Fireball | 1.0 | 1.0 |
94 | Trident | 0.5 | 0.5 |
Since release 1.6, all minecarts are spawned with object type 10 and their functionality is then specified in the Data field within the packet. Also, their visual appearance may be sent via the Entity Metadata packet.
Entity Metadata Format
Note that entity metadata is a totally distinct concept from block metadata. It is not required to send all metadata fields, or even any metadata fields, so long as the terminating entry is correctly sent.
Entity Metadata is an array of entries, each of which looks like the following:
Name | Type | Meaning |
---|---|---|
Index | Unsigned Byte | Unique index key determining the meaning of the following value, see the table below. If this is 0xff then the it is the end of the Entity Metadata array and no more is read.
|
Type | Optional VarInt Enum | Only if Index is not 0xff ; the type of the index, see the table below
|
Value | Optional value of Type | Only if Index is not 0xff : the value of the metadata field
|
Value of Type field | Type of Value field | Notes |
---|---|---|
0 | Byte | |
1 | VarInt | |
2 | Float | |
3 | String | |
4 | Chat | |
5 | OptChat (Boolean + Optional Chat) | Chat is present if the Boolean is set to true |
6 | Slot | |
7 | Boolean | |
8 | Rotation | 3 floats: rotation on x, rotation on y, rotation on z |
9 | Position | |
10 | OptPosition (Boolean + Optional Position) | Position is present if the Boolean is set to true |
11 | Direction (VarInt) | (Down = 0, Up = 1, North = 2, South = 3, West = 4, East = 5) |
12 | OptUUID (Boolean + Optional UUID) | UUID is present if the Boolean is set to true |
13 | OptBlockID (VarInt) | 0 for absent (implies air); otherwise, a block state ID as per the global palette |
14 | NBT | |
15 | Particle | |
16 | Villager Data | 3 VarInts: villager type, villager profession, level |
17 | OptVarInt | 0 for absent; 1 + actual value otherwise. Used for entity IDs. |
18 | Pose | A VarInt enum: 0: STANDING, 1: FALL_FLYING, 2: SLEEPING, 3: SWIMMING, 4: SPIN_ATTACK, 5: SNEAKING, 6: DYING |
Villager type (minecraft:villager_type
registry):
Name | ID |
---|---|
minecraft:desert |
0 |
minecraft:jungle |
1 |
minecraft:plains |
2 |
minecraft:savanna |
3 |
minecraft:snow |
4 |
minecraft:swamp |
5 |
minecraft:taiga |
6 |
Villager professions (minecraft:villager_profession
registry):
Name | ID |
---|---|
minecraft:none |
0 |
minecraft:armorer |
1 |
minecraft:butcher |
2 |
minecraft:cartographer |
3 |
minecraft:cleric |
4 |
minecraft:farmer |
5 |
minecraft:fisherman |
6 |
minecraft:fletcher |
7 |
minecraft:leatherworker |
8 |
minecraft:librarian |
9 |
minecraft:mason |
10 |
minecraft:nitwit |
11 |
minecraft:shepherd |
12 |
minecraft:toolsmith |
13 |
minecraft:weaponsmith |
14 |
Entity classes also recursively inherit fields from classes they extend.
Entity
The base class.
Index | Type | Meaning | Default | |
---|---|---|---|---|
0 | Byte | Bit mask | Meaning | 0 |
0x01 | On Fire | |||
0x02 | Crouched | |||
0x04 | Unused (previously riding) | |||
0x08 | Sprinting | |||
0x10 | Swimming | |||
0x20 | Invisible | |||
0x40 | Glowing effect | |||
0x80 | Flying with elytra | |||
1 | VarInt | Air | 300 | |
2 | OptChat | Custom name | empty | |
3 | Boolean | Is custom name visible | false | |
4 | Boolean | Is silent | false | |
5 | Boolean | No gravity | false | |
6 | Pose | Pose | STANDING |
Throwable
Extends Entity.
No additional metadata.
Itemed Throwable
Extends Throwable. Used for all things that previously extended throwable other than potions, which already had an item.
Index | Type | Meaning | Default | |
---|---|---|---|---|
7 | Slot | Item | empty (which behaves as if it were a specific item, depending on the subclass) |
Egg
Extends Itemed Throwable.
No additional metadata.
An empty item behaves as if the item were a minecraft:egg
.
Ender Pearl
Extends Itemed Throwable.
No additional metadata.
An empty item behaves as if the item were a minecraft:ender_pearl
.
Experience Bottle
Extends Itemed Throwable.
No additional metadata.
An empty item behaves as if the item were a minecraft:experience_bottle
Snowball
Extends Itemed Throwable.
No additional metadata.
An empty item behaves as if the item were a minecraft:snowball
Potion
Extends Throwable.
Index | Type | Meaning | Default | |
---|---|---|---|---|
7 | Slot | Potion which is thrown | Empty |
Eye of Ender
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
7 | Slot | Item | empty (which behaves as if it were a minecraft:ender_eye )
|
FallingBlock
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
7 | Position | spawn position | (0, 0, 0) |
AreaEffectCloud
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
7 | Float | Radius | 0.5 | |
8 | VarInt | Color (only for mob spell particle) | 0 | |
9 | Boolean | Ignore radius and show effect as single point, not area | false | |
10 | Particle | The #Particle | effect
|
FishingHook
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
7 | VarInt | Hooked entity id + 1, or 0 if there is no hooked entity | 0 |
Arrow
Extends Entity.
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 | |
---|---|---|---|---|
7 | Byte | Bit mask | Meaning | 0 |
0x01 | Is critical | |||
0x02 | Is noclip (used by loyalty tridents when returning) | |||
8 | Byte | Piercing level | 0 | |
9 | VarInt | Color (-1 for no particles) | -1 |
Spectral Arrow
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
7 | Byte | Bit mask | Meaning | 0 |
0x01 | Is critical | |||
0x02 | Is noclip (used by loyalty tridents when returning) | |||
8 | Byte | Piercing level | 0 |
Trident
Extends Abstract Arrow.
Inherited entity Abstract Arrow does not exist
Index | Type | Meaning | Default | |
---|---|---|---|---|
0 | VarInt | Loyalty level (enchantment) | 0 | |
1 | Boolean | Has enchantment glint | False |
Boat
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
7 | VarInt | Time since last hit | 0 | |
8 | VarInt | Forward direction | 1 | |
9 | Float | Damage taken | 0.0 | |
10 | VarInt | Type (0=oak, 1=spruce, 2=birch, 3=jungle, 4=acacia, 5=dark oak) | 0 | |
11 | Boolean | Left paddle turning | false | |
12 | Boolean | Right paddle turning | false | |
13 | VarInt | Splash timer | 0 |
EnderCrystal
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
7 | OptPosition | Beam target | Absent | |
8 | Boolean | Show bottom | true |
Abstract Fireball
Extends Entity.
No additional metadata.
Dragon Fireball
Extends Abstract Fireball.
No additional metadata.
Itemed Fireball
Extends Abstract Fireball.
Used for regular and small fireballs. Not used for dragon fireballs and wither skulls. Interestingly, regular fireballs do not come from an item.
Index | Type | Meaning | Default | |
---|---|---|---|---|
7 | Slot | Item | empty (which behaves as if it were a minecraft:fire_charge )
|
Fireball
Extends Itemed Fireball. This is the large fireball shot by ghasts.
No additional metadata.
Small Fireball
Extends Itemed Fireball. This is the fireball shot by blazes and dispensers with fire charges.
No additional metadata.
WitherSkull
Extends Abstract Fireball.
Index | Type | Meaning | Default | |
---|---|---|---|---|
7 | Boolean | Invulnerable | false |
Fireworks
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
7 | Slot | Firework info | empty | |
8 | OptVarInt | Entity ID of entity which used firework (for elytra boosting) | 0 | |
9 | Boolean | Shot at angle (from a crossbow) | false |
Hanging
Extends Entity.
No additional metadata.
ItemFrame
Extends Hanging.
Index | Type | Meaning | Default | |
---|---|---|---|---|
7 | Slot | Item | Empty | |
8 | VarInt | Rotation | 0 |
Item
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
7 | Slot | Item | Empty |
Living
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
7 | Byte | Hand states, used to trigger blocking/eating/drinking animation. | 0 | |
Bit mask | Meaning | |||
0x01 | Is hand active | |||
0x02 | Active hand (0 = main hand, 1 = offhand) | |||
0x04 | In riptide spin attack | |||
8 | Float | Health | 1.0 | |
9 | VarInt | Potion effect color (or 0 if there is no effect) | 0 | |
10 | Boolean | Is potion effect ambient: reduces the number of particles generated by potions to 1/5 the normal amount | false | |
11 | VarInt | Number of arrows in entity | 0 | |
12 | VarInt | Health added by absorption (based on the AbsorptionAmount tag) | 0 | |
13 | OptBlockPos | Unknown (Bed location?) | Absent |
Player
Extends Living.
Index | Type | Meaning | Default | |
---|---|---|---|---|
14 | Float | Additional Hearts | 0.0 | |
15 | VarInt | Score | 0 | |
16 | 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 | |||
17 | Byte | Main hand (0 : Left, 1 : Right) | 1 | |
18 | NBT | Left shoulder entity data (for occupying parrot) | Empty | |
19 | NBT | Right shoulder entity data (for occupying parrot) | Empty |
ArmorStand
Extends Living.
Index | Type | Meaning | Default | |
---|---|---|---|---|
14 | Byte | Bit mask | Meaning | 0 |
0x01 | is Small | |||
0x04 | has Arms | |||
0x08 | no BasePlate | |||
0x10 | set Marker | |||
15 | Rotations | Head rotation | (0.0, 0.0, 0.0) | |
16 | Rotations | Body rotation | (0.0, 0.0, 0.0) | |
17 | Rotations | Left arm rotation | (-10.0, 0.0, -10.0) | |
18 | Rotations | Right arm rotation | (-15.0, 0.0, 10.0) | |
19 | Rotations | Left leg rotation | (-1.0, 0.0, -1.0) | |
20 | 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.
Insentient
Extends Living.
Index | Type | Meaning | Default | |
---|---|---|---|---|
14 | Byte | Bit mask | Meaning | 0 |
0x01 | NoAI | |||
0x02 | Left handed |
Ambient
Extends Insentient.
No additional metadata.
Bat
Extends Ambient.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | Byte | Bit mask | Meaning | 0 |
0x01 | Is hanging |
Creature
Extends Insentient.
No additional metadata.
WaterMob
Extends Creature.
No additional metadata.
Squid
Extends WaterMob.
No additional metadata.
Dolphin
Extends WaterMob.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | Position | Treasure position | (0, 0, 0) | |
16 | Boolean | Can find treasure | false | |
17 | Boolean | Has fish | false |
Abstract fish
Extends WaterMob.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | Boolean | From bucket | False |
Cod
Extends Abstract fish.
No additional metadata.
Puffer fish
Extends Abstract fish.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | VarInt | PuffState (varies from 0 to 2) | 0 |
Salmon
Extends Abstract fish.
No additional metadata.
Tropical fish
Extends Abstract fish.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | VarInt | Variant | 0 |
Ageable
Extends Creature.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | Boolean | Is baby | false |
Animal
Extends Ageable.
No additional metadata.
AbstractHorse
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | 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 | |||
17 | OptUUID | Owner | Absent |
Horse
Extends AbstractHorse.
Index | Type | Meaning | Default | |
---|---|---|---|---|
18 | VarInt | Variant (Color & Style) | 0 |
ZombieHorse
Extends AbstractHorse.
SkeletonHorse
Extends AbstractHorse.
ChestedHorse
Extends AbstractHorse.
Index | Type | Meaning | Default | |
---|---|---|---|---|
18 | Boolean | Has Chest | false |
Donkey
Extends ChestedHorse.
Llama
Extends ChestedHorse.
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
The base class.
No additional metadata.
Mule
Extends ChestedHorse.
Bee
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Byte | Flags | 0 | |
0x01 | Unused | |||
0x02 | Is angry | |||
0x04 | Has stung | |||
0x08 | Has nectar | |||
17 | VarInt | Anger time in ticks | 0 (Not angry) |
Fox
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | VarInt | Type (0: red, 1: snow) | 0 (red) | |
17 | Byte | Bit mask | Meaning | 0 |
0x01 | Sitting | |||
0x02 | Unused | |||
0x04 | Crouching | |||
0x08 | Unknown | |||
0x10 | Unknown | |||
0x20 | Sleeping | |||
0x40 | Unknown | |||
0x80 | Unknown | |||
18 | OptUUID | First UUID (in UUIDs NBT)?
|
Absent | |
19 | OptUUID | Second UUID (in UUIDs NBT)?
|
Absent |
Ocelot
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Boolean | Is trusting | false |
Panda
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Integer | Breed timer? Set to 32 when something happens, and then counts down to 0 again. At 29 and 14 (before counting down), will play the entity.panda.cant_breed sound event.
|
0 | |
17 | Integer | Sneeze timer. Counts up from 0; when it hits 1 the entity.panda.pre_sneeze event plays and when it hits 21 the entity.panda.sneeze event plays (and it is set back to 0 and the sneeze flag is cleared).
|
0 | |
18 | Integer | Eat timer. If nonzero, counts upwards. | 0 | |
19 | Byte | Main Gene | 0 | |
20 | Byte | Hidden Gene | 0 | |
21 | 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 | |
---|---|---|---|---|
16 | Boolean | Has saddle | false | |
17 | 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 | |
---|---|---|---|---|
16 | VarInt | Type | 0 |
Turtle
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | BlockPos | Home pos | (0, 0, 0) | |
17 | Boolean | Has egg | false | |
18 | Boolean | Laying egg | false | |
19 | BlockPos | Travel pos | (0, 0, 0) | |
20 | Boolean | Going home | false | |
21 | Boolean | Traveling | false |
Polar Bear
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Boolean | Standing up | false |
Chicken
Extends Animal.
No additional metadata.
Cow
Extends Animal.
No additional metadata.
Mooshroom
Extends Cow.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | String | Variant ("red" or "brown") | red |
Sheep
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Byte | Bit mask | Meaning | 0 |
0x0F | Color (matches dye damage values) | |||
0x10 | Is sheared |
TameableAnimal
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Byte | Bit mask | Meaning | 0 |
0x01 | Is sitting | |||
0x02 | Is angry (only used with wolves) | |||
0x04 | Is tamed | |||
17 | OptUUID | Owner | Absent |
Cat
Extends TameableAnimal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
18 | VarInt | Type (0 = tabby, 1 = black, 2 = red, 3 = siamese, 4 = british_shorthair, 5 = calico, 6 = persian, 7 = ragdoll, 8 = white, 9 = all_black) | 1 | |
19 | Boolean | Unknown | false | |
20 | Boolean | Unknown | false | |
21 | VarInt | Collar color (values are those used with dyes) | 14 (Red) |
Wolf
Extends TameableAnimal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
18 | Boolean | Is begging | false | |
19 | VarInt | Collar color (values are those used with dyes) | 14 (Red) |
Parrot
Extends TameableAnimal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
18 | VarInt | Variant (0: red/blue, 1: blue, 2: green, 3: yellow/blue, 4: grey) | 0 |
Abstract Merchant
Extends Ageable.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | VarInt | Head shake timer (starts at 40, decrements each tick) | 0 |
Villager
Extends Abstract Merchant.
Index | Type | Meaning | Default | |
---|---|---|---|---|
17 | Villager Data | Villager Data | Plains/None/1 |
Wandering Trader
Extends Abstract Merchant.
No additional metadata.
Golem
Extends Creature.
No additional metadata.
IronGolem
Extends Golem.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | Byte | Bit mask | Meaning | 0 |
0x01 | Is player-created |
Snowman
Extends Golem.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | Byte | Bit mask | Meaning | 0x10 |
0x10 | has pumpkin hat | |||
0x00 | has no pumpkin hat |
Shulker
Extends Golem.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | Direction | Attach face | Down (0) | |
16 | OptPosition | Attachment position | Absent | |
17 | Byte | Shield height | 0 | |
18 | Byte | Color (dye color) | 10 (purple) |
Monster
Extends Creature.
No additional metadata.
Blaze
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | Byte | Bit mask | Meaning | 0 |
0x01 | Is on fire |
Creeper
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | VarInt | State (-1 = idle, 1 = fuse) | -1 | |
16 | Boolean | Is charged | false | |
17 | Boolean | Is ignited | false |
Endermite
Extends Monster.
No additional metadata.
Giant Zombie
Extends Monster.
No additional metadata.
Guardian
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | Boolean | Is retracting spikes | false | |
16 | VarInt | Target EID | 0 |
ElderGuardian
Extends Guardian.
Silverfish
Extends Monster.
No additional metadata.
Raid Participant
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | 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 Raid Participant.
No additional metadata.
Vindicator
Extends Abstract Illager.
Pillager
Extends Abstract Illager.
Spellcaster Illager
Extends Abstract Illager.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Byte | Spell (0: none, 1: summon vex, 2: attack, 3: wololo, 4: disappear, 5: blindness) | 0 |
Evoker
Extends Spellcaster Illager.
Illusioner
Extends Spellcaster Illager.
Ravager
Extends Raid Participant.
No additional metadata.
Witch
Extends Raid Participant.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | Boolean | Is drinking potion | false |
EvocationFangs
Extends Entity.
No additional metadata.
Vex
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | Byte | Bit mask | Meaning | 0 |
0x01 | Is in attack mode |
AbstractSkeleton
Extends Monster.
No additional metadata.
Skeleton
Extends AbstractSkeleton.
Wither Skeleton
Extends AbstractSkeleton.
Stray
Extends AbstractSkeleton.
Spider
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | Byte | Bit mask | Meaning | 0 |
0x01 | Is climbing |
Wither
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | VarInt | Center head's target (entity ID, or 0 if no target) | 0 | |
16 | VarInt | Left head's target (entity ID, or 0 if no target) | 0 | |
17 | VarInt | Right head's target (entity ID, or 0 if no target) | 0 | |
18 | VarInt | Invulnerable time | 0 |
Zombie
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | Boolean | Is baby | false | |
16 | VarInt | Unused (previously type) | 0 | |
17 | Boolean | Is becoming a drowned | false |
Zombie Villager
Extends Zombie.
Index | Type | Meaning | Default | |
---|---|---|---|---|
18 | Boolean | Is converting | false | |
19 | 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 | |
---|---|---|---|---|
15 | Opt BlockID | Carried block | Absent | |
16 | Boolean | Is screaming | false | |
17 | Boolean | Is stared at | false |
EnderDragon
Extends Insentient.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | VarInt | Dragon phase | 10 (hover) |
Phases (according to the wiki page on dragon data values) are:
- 0: circling
- 1: strafing (preparing to shoot a fireball)
- 2: flying to the portal to land (part of transition to landed state)
- 3: landing on the portal (part of transition to landed state)
- 4: taking off from the portal (part of transition out of landed state)
- 5: landed, performing breath attack
- 6: landed, looking for a player for breath attack
- 7: landed, roar before beginning breath attack
- 8: charging player
- 9: flying to portal to die
- 10: hovering with no AI (default when using the /summon command).
Flying
Extends Insentient.
No additional metadata.
Ghast
Extends Flying.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | Boolean | Is attacking | false |
Phantom
Extends Flying.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | VarInt | Size | 0 |
Hitbox size is determined by horizontal=0.9 + 0.2*size and vertical=0.5 + 0.1 * i
Slime
Extends Insentient.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | VarInt | Size | 1 |
LlamaSpit
Extends Entity.
Minecart
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
7 | VarInt | Shaking power | 0 | |
8 | VarInt | Shaking direction | 1 | |
9 | Float | Shaking multiplier | 0.0 | |
10 | VarInt | Custom block ID and damage | 0 | |
11 | VarInt | Custom block Y position (in 16ths of a block) | 6 | |
12 | Boolean | Show custom block | false |
If show custom block is false, then each type of Minecart will render its own type of block with its own properties. Note that one does not need to send these values for the metadata fields, as the client will automatically select them if show custom block is false. They are only provided for reference to help with swapping out other blocks.
- Rideable Minecarts contain air (0:0) and have a y position of 6
- Chest Minecarts contain chests facing north (54:0) and have a y position of 8
- Furnace Minecarts contain a normal furnace facing north when unpowered (61:0) and a lit furnace facing north when powered (62:0) and have a y position of 6 in both cases
- Hopper Minecarts contain a hopper (154:0) and have a y position of 1
- TNT Minecarts contain TNT (46:0) and have a y position of 6
- Command block minecarts contain a Command Block (137:0) and have a y position of 6
- Spawner Minecarts contain a spawner (52:0) and have a y position of 6
MinecartRideable
Extends Minecart.
No additional metadata.
MinecartContainer
Extends Minecart.
No additional metadata.
MinecartHopper
Extends MinecartContainer.
No additional metadata.
MinecartChest
Extends MinecartContainer.
No additional metadata.
MinecartFurnace
Extends Minecart.
Index | Type | Meaning | Default | |
---|---|---|---|---|
13 | Boolean | Has fuel | false |
MinecartTNT
Extends Minecart.
No additional metadata.
MinecartSpawner
Extends Minecart.
No additional metadata.
MinecartCommandBlock
Extends Minecart.
Index | Type | Meaning | Default | |
---|---|---|---|---|
13 | String | Command |
| |
14 | Chat | Last output | {"text":""}
|
TNTPrimed
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
7 | VarInt | Fuse time | 80 |
Piglin
Extends Monster.
Index | Type | Meaning | Deafult | |
---|---|---|---|---|
15 | Boolean | ??? | false | |
16 | Boolean | ??? | false | |
17 | Boolean | ??? | false | |
18 | Boolean | ??? | false | |
19 | Boolean | ??? | false |
Piglin Brute
Extends Monster.
No additional metadata.