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 Projectile
- 3.3 Potion
- 3.4 FallingBlock
- 3.5 AreaEffectCloud
- 3.6 FishingHook
- 3.7 Arrow
- 3.8 TippedArrow
- 3.9 Boat
- 3.10 EnderCrystal
- 3.11 Fireball
- 3.12 WitherSkull
- 3.13 Fireworks
- 3.14 Hanging
- 3.15 ItemFrame
- 3.16 Item
- 3.17 Living
- 3.18 Player
- 3.19 ArmorStand
- 3.20 Insentient
- 3.21 Ambient
- 3.22 Bat
- 3.23 WaterMob
- 3.24 Squid
- 3.25 Creature
- 3.26 Ageable
- 3.27 Animal
- 3.28 AbstractHorse
- 3.29 Horse
- 3.30 ZombieHorse
- 3.31 SkeletonHorse
- 3.32 ChestedHorse
- 3.33 Donkey
- 3.34 Llama
- 3.35 Mule
- 3.36 Pig
- 3.37 Rabbit
- 3.38 Polar Bear
- 3.39 Sheep
- 3.40 TameableAnimal
- 3.41 Ocelot
- 3.42 Wolf
- 3.43 Parrot
- 3.44 Villager
- 3.45 Golem
- 3.46 IronGolem
- 3.47 Snowman
- 3.48 Shulker
- 3.49 Monster
- 3.50 Blaze
- 3.51 Creeper
- 3.52 Endermite
- 3.53 Giant Zombie
- 3.54 Guardian
- 3.55 ElderGuardian
- 3.56 Silverfish
- 3.57 EvocationIllager
- 3.58 IllusionIllager
- 3.59 Vex
- 3.60 VindicationIllager
- 3.61 EvocationFangs
- 3.62 AbstractSkeleton
- 3.63 Skeleton
- 3.64 Wither Skeleton
- 3.65 Stray
- 3.66 Spider
- 3.67 Witch
- 3.68 Wither
- 3.69 Zombie
- 3.70 Zombie Villager
- 3.71 Husk
- 3.72 Enderman
- 3.73 EnderDragon
- 3.74 Flying
- 3.75 Ghast
- 3.76 Slime
- 3.77 LlamaSpit
- 3.78 Minecart
- 3.79 MinecartRideable
- 3.80 MinecartContainer
- 3.81 MinecartHopper
- 3.82 MinecartChest
- 3.83 MinecartFurnace
- 3.84 MinecartTNT
- 3.85 MinecartSpawner
- 3.86 MinecartCommandBlock
- 3.87 TNTPrimed
Mobs
Mobs are spawned via Spawn Mob.
Some entities (marked in yellow) should only be spawned using Spawn Object and their Object ID. While they also have an entity ID, this ID is only used internally. Servers should not attempt to spawn these entities using Spawn Mob with that entity ID, although clients should accept such packets if they appear.
Additionally, a few other entities (marked in blue) must be spawned in their own special ways:
- Paintings should be spawned using Spawn Painting
- XP orbs should be spawned using Spawn Experience Orb.
Type | Name | bounding box x and z | bounding box y | ID |
---|---|---|---|---|
1 | Item | 0.25 | 0.25 | minecraft:item
|
2 | XPOrb | 0.5 | 0.5 | minecraft:xp_orb
|
3 | AreaEffectCloud | 2.0 * Radius | 0.5 | minecraft:area_effect_cloud
|
4 | ElderGuardian | 1.9975 (2.35 * guardian) | 1.9975 (2.35 * guardian) | minecraft:elder_guardian
|
5 | WitherSkeleton | 0.7 | 2.4 | minecraft:wither_skeleton
|
6 | Stray | 0.6 | 1.99 | minecraft:stray
|
7 | ThrownEgg | 0.25 | 0.25 | minecraft:egg
|
8 | LeashKnot | 0.375 | 0.5 | minecraft:leash_knot
|
9 | Painting | type width or 0.0625 (depth) | type height | minecraft:painting
|
10 | Arrow | 0.5 | 0.5 | minecraft:arrow
|
11 | Snowball | 0.25 | 0.25 | minecraft:snowball
|
12 | Fireball (ghast) | 1.0 | 1.0 | minecraft:fireball
|
13 | SmallFireball (blaze) | 0.3125 | 0.3125 | minecraft:small_fireball
|
14 | ThrownEnderpearl | 0.25 | 0.25 | minecraft:ender_pearl
|
15 | EyeOfEnderSignal | 0.25 | 0.25 | minecraft:eye_of_ender_signal
|
16 | ThrownPotion | 0.25 | 0.25 | minecraft:potion
|
17 | ThrownExpBottle | 0.25 | 0.25 | minecraft:xp_bottle
|
18 | ItemFrame | 0.75 or 0.0625 (depth) | 0.75 | minecraft:item_frame
|
19 | WitherSkull | 0.3125 | 0.3125 | minecraft:wither_skull
|
20 | PrimedTnt | 0.98 | 0.98 | minecraft:tnt
|
21 | FallingSand | 0.98 | 0.98 | minecraft:falling_block
|
22 | FireworksRocketEntity | 0.25 | 0.25 | minecraft:fireworks_rocket
|
23 | Husk | 0.6 | 1.95 | minecraft:husk
|
24 | SpectralArrow | 0.5 | 0.5 | minecraft:spectral_arrow
|
25 | ShulkerBullet | 0.3125 | 0.3125 | minecraft:shulker_bullet
|
26 | DragonFireball | 1.0 | 1.0 | minecraft:dragon_fireball
|
27 | ZombieVillager | 0.6 | 1.95 | minecraft:zombie_villager
|
28 | SkeletonHorse | 1.3964844 | 1.6 | minecraft:skeleton_horse
|
29 | ZombieHorse | 1.3964844 | 1.6 | minecraft:zombie_horse
|
30 | ArmorStand | normal: 1.975 marker: 0.0 small: 0.9875 | normal: 0.5 marker: 0.0 small: 0.25 | minecraft:armor_stand
|
31 | Donkey | 1.3964844 | 1.6 | minecraft:donkey
|
32 | Mule | 1.3964844 | 1.6 | minecraft:mule
|
33 | EvocationFangs | 0.5 | 0.8 | minecraft:evocation_fangs
|
34 | EvocationIllager | 0.6 | 1.95 | minecraft:evocation_illager
|
35 | Vex | 0.4 | 0.8 | minecraft:vex
|
36 | VindicationIllager | 0.6 | 1.95 | minecraft:vindication_illager
|
37 | IllusionIllager | 0.6 | 1.95 | minecraft:illusion_illager
|
40 | MinecartCommandBlock | 0.98 | 0.7 | minecraft:commandblock_minecart
|
41 | Boat | 1.375 | 0.5625 | minecraft:boat
|
42 | MinecartRideable | 0.98 | 0.7 | minecraft:minecart
|
43 | MinecartChest | 0.98 | 0.7 | minecraft:chest_minecart
|
44 | MinecartFurnace | 0.98 | 0.7 | minecraft:furnace_minecart
|
45 | MinecartTNT | 0.98 | 0.7 | minecraft:tnt_minecart
|
46 | MinecartHopper | 0.98 | 0.7 | minecraft:hopper_minecart
|
47 | MinecartSpawner | 0.98 | 0.7 | minecraft:spawner_minecart
|
50 | Creeper | 0.6 | 1.7 | minecraft:creeper
|
51 | Skeleton | 0.6 | 1.99 | minecraft:skeleton
|
52 | Spider | 1.4 | 0.9 | minecraft:spider
|
53 | Giant | 3.6 | 10.8 | minecraft:giant
|
54 | Zombie | 0.6 | 1.95 | minecraft:zombie
|
55 | Slime | 0.51000005 * size | 0.51000005 * size | minecraft:slime
|
56 | Ghast | 4 | 4 | minecraft:ghast
|
57 | PigZombie | 0.6 | 1.95 | minecraft:zombie_pigman
|
58 | Enderman | 0.6 | 2.9 | minecraft:enderman
|
59 | CaveSpider | 0.7 | 0.5 | minecraft:cave_spider
|
60 | Silverfish | 0.4 | 0.3 | minecraft:silverfish
|
61 | Blaze | 0.6 | 1.8 | minecraft:blaze
|
62 | LavaSlime (Magma Cube) | 0.51000005 * size | 0.51000005 * size | minecraft:magma_cube
|
63 | EnderDragon | 16.0 | 8.0 | minecraft:ender_dragon
|
64 | WitherBoss | 0.9 | 3.5 | minecraft:wither
|
65 | Bat | 0.5 | 0.9 | minecraft:bat
|
66 | Witch | 0.6 | 1.95 | minecraft:witch
|
67 | Endermite | 0.4 | 0.3 | minecraft:endermite
|
68 | Guardian | 0.85 | 0.85 | minecraft:guardian
|
69 | Shulker | 1.0 | 1.0-2.0 (depending on peek) | minecraft:shulker
|
90 | Pig | 0.9 | 0.9 | minecraft:pig
|
91 | Sheep | 0.9 | 1.3 | minecraft:sheep
|
92 | Cow | 0.9 | 1.4 | minecraft:cow
|
93 | Chicken | 0.4 | 0.7 | minecraft:chicken
|
94 | Squid | 0.8 | 0.8 | minecraft:squid
|
95 | Wolf | 0.6 | 0.85 | minecraft:wolf
|
96 | MushroomCow (Mooshroom) | 0.9 | 1.4 | minecraft:mooshroom
|
97 | SnowMan | 0.7 | 1.9 | minecraft:snowman
|
98 | Ozelot (Ocelot) | 0.6 | 0.7 | minecraft:ocelot
|
99 | VillagerGolem (Iron Golem) | 1.4 | 2.7 | minecraft:villager_golem
|
100 | Horse (EntityHorse until 1.11) | 1.3964844 | 1.6 | minecraft:horse
|
101 | Rabbit | 0.4 | 0.5 | minecraft:rabbit
|
102 | PolarBear | 1.3 | 1.4 | minecraft:polar_bear
|
103 | Llama | 0.9 | 1.87 | minecraft:llama
|
104 | LlamaSpit | 0.25 | 0.25 | minecraft:llama_spit
|
105 | Parrot | 0.5 | 0.9 | minecraft:parrot
|
120 | Villager | 0.6 | 1.95 | minecraft:villager
|
200 | EnderCrystal | 2.0 | 2.0 | minecraft:end_crystal
|
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 | x, z | y |
---|---|---|---|
1 | Boat | 1.5 | 0.6 |
2 | Item Stack (Slot) | 0.25 | 0.25 |
3 | Area Effect Cloud | 2.0 * Radius | 0.5 |
10 | Minecart | 0.98 | 0.7 |
50 | Activated TNT | 0.98 | 0.98 |
51 | EnderCrystal | 2.0 | 2.0 |
60 | Tipped arrow (projectile; also used for regular arrows) | 0.5 | 0.5 |
61 | Snowball (projectile) | 0.25 | 0.25 |
62 | Egg (projectile) | 0.25 | 0.25 |
63 | FireBall (ghast projectile) | 1.0 | 1.0 |
64 | FireCharge (blaze projectile) | 0.3125 | 0.3125 |
65 | Thrown Enderpearl | 0.25 | 0.25 |
66 | Wither Skull (projectile) | 0.3125 | 0.3125 |
67 | Shulker Bullet | 0.3125 | 0.3125 |
68 | Llama spit | 0.25 | 0.25 |
70 | Falling Objects | 0.98 | 0.98 |
71 | Item frames | varies | varies |
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.3750 (9px) | 0.25 (9px) |
78 | ArmorStand | 0.5 | 1.975 |
79 | Evocation Fangs | 0.5 | 0.8 |
90 | Fishing Hook | 0.25 | 0.25 |
91 | Spectral Arrow | 0.5 | 0.5 |
93 | Dragon Fireball | 1.0 | 1.0 |
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 Byte 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 | Slot | |
6 | Boolean | |
7 | Rotation | 3 floats: rotation on x, rotation on y, rotation on z |
8 | Position | |
9 | OptPosition (Boolean + Optional Position) | Position is present if the Boolean is set to true |
10 | Direction (VarInt) | (Down = 0, Up = 1, North = 2, South = 3, West = 4, East = 5) |
11 | OptUUID (Boolean + Optional UUID) | UUID is present if the Boolean is set to true |
12 | OptBlockID (VarInt) | 0 for absent otherwise, id << 4 | data
|
13 | NBT Tag |
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 | |||
0x08 | Sprinting | |||
0x10 | Unused (previously eating/drinking/blocking; use hand state now) | |||
0x20 | Invisible | |||
0x40 | Glowing effect | |||
0x80 | Flying with elytra | |||
1 | VarInt | Air | 300 | |
2 | String | Custom name |
| |
3 | Boolean | Is custom name visible | false | |
4 | Boolean | Is silent | false | |
5 | Boolean | No gravity | false |
Statuses:
- 21
- Plays the guardian sound effect from this entity (works with any entity)
- 35
- Plays the Totem of Undying animation
Projectile
Extends Entity.
No additional metadata.
Potion
Extends Projectile.
Index | Type | Meaning | Default | |
---|---|---|---|---|
6 | Slot | Potion which is thrown | Empty |
FallingBlock
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
6 | Position | spawn position | (0, 0, 0) |
AreaEffectCloud
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
6 | Float | Radius | 0.5 | |
7 | VarInt | Color (only for mob spell particle) | 0 | |
8 | Boolean | Ignore radius and show effect as single point, not area | false | |
9 | VarInt | Particle ID | 15 (mobSpell) | |
10 | VarInt | Particle parameter 1 | 0 | |
11 | VarInt | Particle parameter 2 | 0 |
FishingHook
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
6 | VarInt | Hooked entity id + 1, or 0 if there is no hooked entity | 0 |
Statuses:
- 31
- If the caught entity is the connected player, then cause them to be pulled toward the caster of the fishing rod.
Arrow
Extends Entity.
Abstract base class for TippedArrow (which is used for regular arrows as well as tipped ones) and Spectral Arrow.
Index | Type | Meaning | Default | |
---|---|---|---|---|
6 | Byte | Bit mask | Meaning | 0 |
0x01 | Is critical |
TippedArrow
Extends Arrow.
Used for both tipped and regular arrows. If not tipped, then color is set to -1 and no tipped arrow particles are used.
Index | Type | Meaning | Default | |
---|---|---|---|---|
7 | VarInt | Color (-1 for no particles) | -1 |
Statuses:
- 0
- Spawns tipped arrow particle effects, if the color is not -1.
Boat
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
6 | VarInt | Time since last hit | 0 | |
7 | VarInt | Forward direction | 1 | |
8 | Float | Damage taken | 0.0 | |
9 | VarInt | Type (0=oak, 1=spruce, 2=birch, 3=jungle, 4=acacia, 5=dark oak) | 0 | |
10 | Boolean | Right paddle turning | false | |
11 | Boolean | Left paddle turning | false |
EnderCrystal
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
6 | OptPosition | Beam target | Absent | |
7 | Boolean | Show bottom | true |
Fireball
Extends Entity.
No additional metadata.
WitherSkull
Extends Fireball.
Index | Type | Meaning | Default | |
---|---|---|---|---|
6 | Boolean | Invulnerable | false |
Fireworks
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
6 | Slot | Firework info | empty | |
7 | VarInt | Entity ID of entity which used firework (for elytra boosting) | 0 |
Statuses:
- 17
- Triggers the firework explosion effect (based off of the firework info metadata)
Hanging
Extends Entity.
No additional metadata.
ItemFrame
Extends Hanging.
Index | Type | Meaning | Default | |
---|---|---|---|---|
6 | Slot | Item | Empty | |
7 | VarInt | Rotation | 0 |
Item
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
6 | Slot | Item | Empty |
Living
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
6 | Byte | Hand states, used to trigger blocking/eating/drinking animation. | 0 | |
Bit mask | Meaning | |||
0x01 | Is hand active | |||
0x02 | Active hand (0 = main hand, 1 = offhand) | |||
7 | Float | Health | 1.0 | |
8 | VarInt | Potion effect color (or 0 if there is no effect) | 0 | |
9 | Boolean | Is potion effect ambient: reduces the number of particles generated by potions to 1/5 the normal amount | false | |
10 | VarInt | Number of arrows in entity | 0 |
Statuses:
- 2
- Plays the hurt animation and hurt sound
- 3
- Plays the death sound and death animation
- 29
- Plays the shield block sound
- 30
- Plays the shield break sound
- 33
- Plays the thorns sound in addition to playing the hurt animation and hurt sound
Player
Extends Living.
Index | Type | Meaning | Default | |
---|---|---|---|---|
11 | Float | Additional Hearts | 0.0 | |
12 | VarInt | Score | 0 | |
13 | Byte | The Displayed Skin Parts bit mask that is sent in Client Settings | 0 | |
Bit mask | Meaning | |||
0x01 | Cape enabled | |||
0x02 | Jacket enabled | |||
0x04 | Left sleeve enabled | |||
0x08 | Right sleeve enabled | |||
0x10 | Left pants leg enabled | |||
0x20 | Right pants leg enabled | |||
0x40 | Hat enabled | |||
0x80 | Unused | |||
14 | Byte | Main hand (0 : Left, 1 : Right) | 1 | |
15 | NBT Tag | Left shoulder entity data (for occupying parrot) | Empty | |
16 | NBT Tag | Right shoulder entity data (for occupying parrot) | Empty |
Statuses:
- 9
- Marks item use as finished (finished eating, finished drinking, etc)
- This status is not required if you want more control on the server side, this basicly finishes the interaction on the client side to decrease the food quantity, arrow quantity, ...
- But you can trigger these changes manually through other packets or prevent those changes on the client.
- Examples:
- - Create a 'Infinity Bow' without the first arrow in your inventory constantly changing in quantity.
- - Create a custom found that is infinite, and prevent the stack quantity from descreasing.
- - ...
- Note: This works together with the 'Hand data' so this will have to be updated accordingly to 'finish' the interaction manually.
- 22
- Enables reduced debug screen information
- 23
- Disables reduced debug screen information
- 24
- Set op permission level to 0
- 25
- Set op permission level to 1
- 26
- Set op permission level to 2
- 27
- Set op permission level to 3
- 28
- Set op permission level to 4
ArmorStand
Extends Living.
Index | Type | Meaning | Default | |
---|---|---|---|---|
11 | Byte | Bit mask | Meaning | 0 |
0x01 | is Small | |||
0x04 | has Arms | |||
0x08 | no BasePlate | |||
0x10 | set Marker | |||
12 | Rotation | Head rotation | (0.0, 0.0, 0.0) | |
13 | Rotation | Body rotation | (0.0, 0.0, 0.0) | |
14 | Rotation | Left arm rotation | (-10.0, 0.0, -10.0) | |
15 | Rotation | Right arm rotation | (-15.0, 0.0, 10.0) | |
16 | Rotation | Left leg rotation | (-1.0, 0.0, -1.0) | |
17 | Rotation | Right leg rotation | (1.0, 0.0, 1.0) |
Note that armor stands with the invisible flag from the base entity class set also cannot be attacked or damaged, except for by the void.
Statuses:
- 32
- Plays the hit sound, and resets a hit cooldown.
Insentient
Extends Living.
Index | Type | Meaning | Default | |
---|---|---|---|---|
11 | Byte | Bit mask | Meaning | 0 |
0x01 | NoAI | |||
0x02 | Left handed |
Statuses:
- 20
- Spawn explosion particle. Used when:
- A silverfish enters a block
- A silverfish exits a block
- A mob spawner (or minecart mob spawner) spawns an entity (only with entities that support this status)
Ambient
Extends Insentient.
No additional metadata.
Bat
Extends Ambient.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | Byte | Bit mask | Meaning | 0 |
0x01 | Is hanging |
WaterMob
Extends Insentient.
No additional metadata.
Squid
Extends WaterMob
No additional metadata.
Statuses:
- 19
- Resets the squid's rotation to 0 radians. Occurs whenever the server calculates that the squid has rotated more than 2 pi radians.
Creature
Extends Insentient.
No additional metadata.
Ageable
Extends Creature.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | Boolean | Is baby | false |
Animal
Extends Ageable.
No additional metadata.
Statuses:
- 18
- Spawn "love mode" heart particles
AbstractHorse
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
13 | Byte | Bit mask | Meaning | 0 |
0x01 | Unused | |||
0x02 | Is Tame | |||
0x04 | Is saddled | |||
0x08 | Has Chest | |||
0x10 | Is Bred (not used on the Notchian server; controlled via the unused Bred NBT flag) | |||
0x20 | Is eating | |||
0x40 | Is rearing (on hind legs) | |||
0x80 | Is mouth open | |||
14 | OptUUID | Owner | Absent |
Statuses:
- 6
- Spawn smoke particles (taming failed)
- 7
- Spawn heart particles (taming succeeded)
Horse
Extends AbstractHorse.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | VarInt | Variant (Color & Style) | 0 | |
16 | VarInt | Armor (0: none, 1: iron, 2: gold, 3: diamond) | 0 (none) |
ZombieHorse
Extends AbstractHorse.
SkeletonHorse
Extends AbstractHorse.
ChestedHorse
Extends AbstractHorse.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | Boolean | Has Chest | false |
Donkey
Extends ChestedHorse.
Llama
Extends ChestedHorse.
Index | Type | Meaning | Default | |
---|---|---|---|---|
16 | VarInt | Strength (number of columns of 3 slots in the llama's inventory once a chest is equipped) | 0 | |
17 | VarInt | Carpet color (a dye color, or -1 if no carpet equipped) | -1 | |
18 | VarInt | Variant (0: llama_creamy.png , 1: llama_white.png , 2: llama_brown.png , 3: llama_gray.png )
|
0 |
Mule
Extends ChestedHorse.
Pig
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
13 | Boolean | Has saddle | false | |
14 | VarInt | Total time to "boost" with a carrot on a stick for | 0 |
Whenever a carrot on a stick is used, if the pig is not currently boosting it will start to boost for 140 to 980 (inclusive) ticks. When boost time is changed, a counter is reset which counts up to the boost time, after which boosting will stop. The value remains set at its modified value even after boosting is stopped.
Rabbit
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
13 | VarInt | Type | 0 |
Polar Bear
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
13 | Boolean | Standing up | false |
Statuses:
- 1
- Causes the rabbit to use its rotated jumping animation, and displays jumping particles.
Sheep
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
13 | Byte | Bit mask | Meaning | 0 |
0x0F | Color (matches dye damage values) | |||
0x10 | Is sheared |
Statuses:
- 10
- Causes the sheep to play the eating grass animation for the next 40 ticks
TameableAnimal
Extends Animal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
13 | Byte | Bit mask | Meaning | 0 |
0x01 | Is sitting | |||
0x02 | Is angry (only used with wolves) | |||
0x04 | Is tamed | |||
14 | OptUUID | Owner | Absent |
Statuses:
- 6
- Spawn smoke particles (taming failed)
- 7
- Spawn heart particles (taming succeeded)
Ocelot
Extends TameableAnimal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | VarInt | Type (0 = untamed, 1 = tuxedo, 2 = tabby, 3 = siamese). Used to render regardless as to whether it is tamed or not. | 0 |
Wolf
Extends TameableAnimal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | Float | Damage taken (used for tail rotation) | Value of health field (1.0) | |
16 | Boolean | Is begging | false | |
17 | VarInt | Collar color (values are those used with dyes) | 14 (Red) |
Statuses:
- 8
- Play wolf shaking water animation
Parrot
Extends TameableAnimal.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | VarInt | Variant (0: red/blue, 1: blue, 2: green, 3: yellow/blue, 4: silver) | 0 |
Villager
Extends Ageable.
Index | Type | Meaning | Default | |
---|---|---|---|---|
13 | VarInt | Profession (Farmer = 0, Librarian = 1, Priest = 2, Blacksmith = 3, Butcher = 4, Nitwit = 5) | 0 |
Statuses:
- 12
- Spawn villager mating heart particles
- 13
- Spawn villager angry particles
- 14
- Spawn villager happy particles
Golem
Extends Creature.
No additional metadata.
IronGolem
Extends Golem.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | Byte | Bit mask | Meaning | 0 |
0x01 | Is player-created |
Statuses:
- 4
- Plays attack animation and attack sound
- 11
- Causes golem to hold out a
rosepoppy for 400 ticks (20 seconds) - 34
- Puts away golem's poppy
Snowman
Extends Golem.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | Byte | Bit mask | Meaning | 0x10 |
0x10 | has no pumpkin hat |
Shulker
Extends Golem.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | Direction | Facing direction | Down (0) | |
13 | OptPosition | Attachment position | Absent | |
14 | Byte | Shield height | 0 | |
15 | Byte | Color (dye color) | 10 (purple) |
Monster
Extends Creature.
No additional metadata.
Blaze
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | Byte | Bit mask | Meaning | 0 |
0x01 | Is on fire |
Creeper
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | VarInt | State (-1 = idle, 1 = fuse) | -1 | |
13 | Boolean | Is charged | false | |
14 | Boolean | Is ignited | false |
Endermite
Extends Monster.
No additional metadata.
Giant Zombie
Extends Monster.
No additional metadata.
Guardian
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | Boolean | Is retracting spikes | false | |
13 | VarInt | Target EID | 0 |
ElderGuardian
Extends Guardian.
Silverfish
Extends Monster.
No additional metadata.
EvocationIllager
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | Byte | Spell (0: none, 1: summon vex, 2: attack, 3: wololo) | 0 |
IllusionIllager
Extends EvocationIllager.
Vex
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | Byte | Bit mask | Meaning | 0 |
0x01 | Is in attack mode |
VindicationIllager
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | Byte | Bit mask | Meaning | 0 |
0x01 | Has target (aggressive state) |
EvocationFangs
Extends Entity.
AbstractSkeleton
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | Boolean | Is swinging arms | false |
Skeleton
Extends AbstractSkeleton.
Wither Skeleton
Extends AbstractSkeleton.
Stray
Extends AbstractSkeleton.
Spider
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | Byte | Bit mask | Meaning | 0 |
0x01 | Is climbing |
Witch
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | Boolean | Is aggressive | false |
Statues:
- 15
- Spawns between 10 and 45
witchMagic
particles. This status has a .075% chance of happening each tick.
Wither
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | VarInt | Center head's target (entity ID, or 0 if no target) | 0 | |
13 | VarInt | Left(?) head's target (entity ID, or 0 if no target) | 0 | |
14 | VarInt | Right(?) head's target (entity ID, or 0 if no target) | 0 | |
15 | VarInt | Invulnerable time | 0 |
Zombie
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | Boolean | Is baby | false | |
13 | VarInt | Unused (previously type) | 0 | |
14 | Boolean | Are hands held up | false |
Zombie Villager
Extends Zombie.
Index | Type | Meaning | Default | |
---|---|---|---|---|
15 | Boolean | Is converting | false | |
16 | VarInt | Profession | 0 |
Statuses:
- 16
- Plays the zombie cure finished sound effect (unless the entity is silent)
Husk
Extends Zombie.
Enderman
Extends Monster.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | Opt BlockID | Carried block | Absent | |
13 | Boolean | Is screaming | false |
EnderDragon
Extends Insentient.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | VarInt | Dragon phase | 10 (hover) |
Phases (according to the wiki page on dragon data values) are:
- 0: circling
- 1: strafing (preparing to shoot a fireball)
- 2: flying to the portal to land (part of transition to landed state)
- 3: landing on the portal (part of transition to landed state)
- 4: taking off from the portal (part of transition out of landed state)
- 5: landed, performing breath attack
- 6: landed, looking for a player for breath attack
- 7: landed, roar before beginning breath attack
- 8: charging player
- 9: flying to portal to die
- 10: hovering with no AI (default when using the /summon command).
Flying
Extends Insentient.
No additional metadata.
Ghast
Extends Flying.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | Boolean | Is attacking | false |
Slime
Extends Insentient.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | VarInt | Size | 1 |
LlamaSpit
Extends Entity.
Minecart
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
6 | VarInt | Shaking power | 0 | |
7 | VarInt | Shaking direction | 1 | |
8 | Float | Shaking multiplier | 0.0 | |
9 | VarInt | Custom block ID and damage | 0 | |
10 | VarInt | Custom block Y position (in 16ths of a block) | 6 | |
11 | Boolean | Show custom block | false |
If show custom block is false, then each type of Minecart will render its own type of block with its own properties. Note that one does not need to send these values for the metadata fields, as the client will automatically select them if show custom block is false. They are only provided for reference to help with swapping out other blocks.
- Rideable Minecarts contain air (0:0) and have a y position of 6
- Chest Minecarts contain chests facing north (54:0) and have a y position of 8
- Furnace Minecarts contain a normal furnace facing north when unpowered (61:0) and a lit furnace facing north when powered (62:0) and have a y position of 6 in both cases
- Hopper Minecarts contain a hopper (154:0) and have a y position of 1
- TNT Minecarts contain TNT (46:0) and have a y position of 6
- Command block minecarts contain a Command Block (137:0) and have a y position of 6
- Spawner Minecarts contain a spawner (52:0) and have a y position of 6
MinecartRideable
Extends Minecart.
No additional metadata.
MinecartContainer
Extends Minecart.
No additional metadata.
MinecartHopper
Extends MinecartContainer.
No additional metadata.
MinecartChest
Extends MinecartContainer.
No additional metadata.
MinecartFurnace
Extends Minecart.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | Boolean | Is powered | false |
MinecartTNT
Extends Minecart.
No additional metadata.
Statuses:
- 10
- Causes the TNT to ignite. Does not play a sound; the sound must be played separately.
MinecartSpawner
Extends Minecart.
No additional metadata.
Statuses:
- 1
- Resets the delay of the spawner to 200 ticks (the default minimum value).
MinecartCommandBlock
Extends Minecart.
Index | Type | Meaning | Default | |
---|---|---|---|---|
12 | String | Command |
| |
13 | Chat | Last output | {"text":""}
|
TNTPrimed
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
6 | VarInt | Fuse time | 80 |