Difference between revisions of "Entity metadata"

From wiki.vg
Jump to navigation Jump to search
m (→‎Bee: Not finifhed yet)
m (Added missing cat type (jellie), and fixed mislabeled all_black type)
(35 intermediate revisions by 8 users not shown)
Line 1: Line 1:
Various '''Entities''' have different metadata fields and [[Entity_statuses|status codes]].
+
Various '''Entities''' have different metadata fields and [[Entity statuses|status codes]].  
  
== Unmerged information ==
+
These are the valid codes for Minecraft Java Edition 1.16.5; for upcoming changes for 1.17 snapshots, see [[Pre-release protocol#Entity Metadata]].
<div style="background: repeating-linear-gradient(-55deg, #dff, #dff 10px, #fdf 10px, #fdf 20px); padding: 10px">
 
{{Warning2|Unmerged content from 1.14.4. This needs to be merged eventually but I don't want to do it now.}}
 
  
{{Warning2|Entity metadata shifted in 19w08a; not all entities are copied here. All subclasses of entity had shift of 1; all subclasses of living had a second shift (2 total). All entities listed in the article have been updated, but there are ones not listed here. }}
+
Because this is always updated late, only valid for the latest version and not computer parseable, Bixilon wrote a generator and wrote the mappings for 1.8.9 by hand. See [https://gitlab.bixilon.de/bixilon/minosoft/-/tree/master/util Mappings Generator]. Also [https://github.com/Pokechu22/Burger/tree/master burger] might help.
  
=== Entity Metadata Format ===
+
== Mobs ==
  
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.
+
Mobs are spawned via [[Protocol#Spawn_Mob|Spawn Mob]].
 +
 
 +
{{Warning2|Some entities (marked in yellow) should only be spawned using [[Protocol#Spawn_Object|Spawn Object]] and their [[#Objects|Object ID]].  While they also have an entity ID, this ID is only used internally. Servers should not attempt to spawn these entities using [[Protocol#Spawn Mob|Spawn Mob]] with that entity ID, although clients should accept such packets if they appear.
  
Entity Metadata is an array of entries, each of which looks like the following:
+
Additionally, a few other entities (marked in blue) must be spawned in their own special ways:
 +
* {{Minecraft Wiki|Painting}}s should be spawned using [[Protocol#Spawn_Painting|Spawn Painting]]
 +
* XP orbs should be spawned using [[Protocol#Spawn_Experience_Orb|Spawn Experience Orb]].}}
  
{| class="wikitable"
+
{{Warning2|These entity IDs are up to date for 1.16.5. Use [[Data Generators]] or [https://pokechu22.github.io/Burger/1.15.2.html Burger] to get older IDs. If using Burger just replace the version number to what you want to see.}}
! Name
 
! Type
 
! Meaning
 
|-
 
| Index
 
| Unsigned Byte
 
| Unique index key determining the meaning of the following value, see the table below. If this is <code>0xff</code> 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 <code>0xff</code>; the type of the index, see the table below
 
|-
 
| Value
 
| Optional ''value of Type''
 
| Only if Index is not <code>0xff</code>: the value of the metadata field
 
|}
 
  
 
{| class="wikitable"
 
{| class="wikitable"
! Value of Type field
+
|-
! [[Data types|Type]] of Value field
+
! Type
! Notes
+
! Name
|-
+
! bounding box x and z
| 0
+
! bounding box y
| Byte
+
! ID
|
+
|- style="background: #ffff88;"
|-
+
| 0
| 1
+
| Area Effect Cloud
| VarInt
+
| 2.0 * Radius
|
+
| 0.5
|-
+
| <code>minecraft:area_effect_cloud</code>
| 2
+
|- style="background: #ffff88;"
| Float
+
| 1
|
+
| Armor Stand
|-
+
| normal: 0.5 marker: 0.0 small: 0.25
| 3
+
| normal: 1.975 marker: 0.0 small: 0.9875
| String
+
| <code>minecraft:armor_stand</code>
|
+
|- style="background: #ffff88;"
|-
+
| 2
| 4
+
| Arrow
| [[Chat]]
+
| 0.5
|
+
| 0.5
|-
+
| <code>minecraft:arrow</code>
| 5
+
|-
| OptChat (Boolean + Optional [[Chat]])
+
| 3
| [[Chat]] is present if the Boolean is set to true
+
| Bat
|-
+
| 0.5
| 6
+
| 0.9
| [[Slot]]
+
| <code>minecraft:bat</code>
|
+
|-
|-
+
| 4
| 7
+
| Bee
| Boolean
+
| 0.7
|
+
| 0.6
|-
+
| <code>minecraft:bee</code>
| 8
+
|-
| Rotation
+
| 5
| 3 floats: rotation on x, rotation on y, rotation on z
+
| Blaze
|-
+
| 0.6
| 9
+
| 1.8
| [[Data Types#Position|Position]]
+
| <code>minecraft:blaze</code>
|
+
|- style="background: #ffff88;"
|-
+
| 6
| 10
+
| Boat
| OptPosition (Boolean + Optional Position)
+
| 1.375
| Position is present if the Boolean is set to true
+
| 0.5625
|-
+
| <code>minecraft:boat</code>
| 11
+
|-
| Direction (VarInt)
+
| 7
| (Down = 0, Up = 1, North = 2, South = 3, West = 4, East = 5)
+
| Cat
|-
+
| 0.6
| 12
+
| 0.7
| OptUUID (Boolean + Optional UUID)
+
| <code>minecraft:cat</code>
| UUID is present if the Boolean is set to true
+
|-
|-
+
| 8
| 13
+
| Cave Spider
| OptBlockID (VarInt)
+
| 0.7
| 0 for absent otherwise, <code><nowiki>id &lt;&lt; 4 | data</nowiki></code>
+
| 0.5
|-
+
| <code>minecraft:cave_spider</code>
| 14
+
|-
| [[NBT]]
+
| 9
|
+
| Chicken
|-
+
| 0.4
| 15
+
| 0.7
| [[Data Types#Particle|Particle]]
+
| <code>minecraft:chicken</code>
|
+
|-
|- {{Added}}
+
| 10
| 16
+
| Cod
| Villager Data
+
| 0.5
| 3 VarInts: villager type, villager profession, level
+
| 0.3
|- {{Added}}
+
| <code>minecraft:cod</code>
| 17
+
|-
| OptVarInt
+
| 11
| 0 for absent; 1 + actual value otherwise.  Used for entity IDs.
+
| Cow
|- {{Added}}
+
| 0.9
| 18
+
| 1.4
| Pose
+
| <code>minecraft:cow</code>
| A VarInt enum: 0: STANDING, 1: FALL_FLYING, 2: SLEEPING, 3: SWIMMING, 4: SPIN_ATTACK, 5: SNEAKING, 6: DYING
+
|-
|}
+
| 12
 
+
| Creeper
Villager type (<code>minecraft:villager_type</code> registry):
+
| 0.6
 
+
| 1.7
{| class="wikitable"
+
| <code>minecraft:creeper</code>
! Name !! ID
+
|-
|-
+
| 13
| <code>minecraft:desert</code> || 0
+
| Dolphin
|-
+
| 0.9
| <code>minecraft:jungle</code> || 1
+
| 0.6
|-
+
| <code>minecraft:dolphin</code>
| <code>minecraft:plains</code> || 2
+
|-
|-
+
| 14
| <code>minecraft:savanna</code> || 3
+
| Donkey
|-
+
| 1.5
| <code>minecraft:snow</code> || 4
+
| 1.39648
|-
+
| <code>minecraft:donkey</code>
| <code>minecraft:swamp</code> || 5
+
|- style="background: #ffff88;"
|-
+
| 15
| <code>minecraft:taiga</code> || 6
+
| Dragon Fireball
|}
+
| 1.0
 
+
| 1.0
Villager professions (<code>minecraft:villager_profession</code> registry):
+
| <code>minecraft:dragon_fireball</code>
 
+
|-
{| class="wikitable"
+
| 16
! Name !! ID
+
| Drowned
|-
+
| 0.6
| <code>minecraft:none</code> || 0
+
| 1.95
|-
+
| <code>minecraft:drowned</code>
| <code>minecraft:armorer</code> || 1
+
|-
|-
+
| 17
| <code>minecraft:butcher</code> || 2
+
| Elder Guardian
|-
+
| 1.9975 (2.35 * guardian)
| <code>minecraft:cartographer</code> || 3
+
| 1.9975 (2.35 * guardian)
|-
+
| <code>minecraft:elder_guardian</code>
| <code>minecraft:cleric</code> || 4
+
|- style="background: #ffff88;"
|-
+
| 18
| <code>minecraft:farmer</code> || 5
+
| End Crystal
|-
+
| 2.0
| <code>minecraft:fisherman</code> || 6
+
| 2.0
|-
+
| <code>minecraft:end_crystal</code>
| <code>minecraft:fletcher</code> || 7
+
|-
|-
+
| 19
| <code>minecraft:leatherworker</code> || 8
+
| Ender Dragon
|-
+
| 16.0
| <code>minecraft:librarian</code> || 9
+
| 8.0
|-
+
| <code>minecraft:ender_dragon</code>
| <code>minecraft:mason</code> || 10
+
|-
|-
+
| 20
| <code>minecraft:nitwit</code> || 11
+
| Enderman
|-
+
| 0.6
| <code>minecraft:shepherd</code> || 12
+
| 2.9
|-
+
| <code>minecraft:enderman</code>
| <code>minecraft:toolsmith</code> || 13
+
|-
|-
+
| 21
| <code>minecraft:weaponsmith</code> || 14
+
| Endermite
|}
+
| 0.4
 
+
| 0.3
=== Mobs ===
+
| <code>minecraft:endermite</code>
 
+
|- style="background: #ffff88;"
Entity IDs have shifted with the addition of some new mobs.
+
| 22
 
+
| Evoker
=== Entity ===
+
| 0.6
 
+
| 1.95
The base class.
+
| <code>minecraft:evoker</code>
 
+
|-
{| class="wikitable"
+
| 23
! Index
+
| Evoker Fangs
! Type
+
| 0.5
!style="width: 250px;" colspan="2"| Meaning
+
| 0.8
! Default
+
| <code>minecraft:evoker_fangs</code>
|-
+
|- style="background: #aaaaff;"
|rowspan="9"| 0
+
| 24
|rowspan="9"| Byte
+
| Experience Orb
! Bit mask
+
| 0.5
! Meaning
+
| 0.5
|rowspan="9"| 0
+
| <code>minecraft:experience_orb</code>
|-
+
|- style="background: #ffff88;"
| 0x01
+
| 24
| On Fire
+
| Eye of Ender
|-
+
| 0.25
| 0x02
+
| 0.25
| Crouched
+
| <code>minecraft:eye_of_ender</code>
|-
+
|- style="background: #ffff88;"
| 0x04
+
| 26
| Unused (previously riding)
+
| Falling Block
|-
+
| 0.98
| 0x08
+
| 0.98
| Sprinting
+
| <code>minecraft:falling_block</code>
|-
+
|- style="background: #ffff88;"
| 0x10
+
| 27
| Swimming
+
| Firework Rocket Entity
|-
+
| 0.25
| 0x20
+
| 0.25
| Invisible
+
| <code>minecraft:firework_rocket</code>
|-
+
|-
| 0x40
+
| 28
| Glowing effect
+
| Fox
|-
+
| 0.6
| 0x80
+
| 0.7
| Flying with {{Minecraft Wiki|elytra}}
+
| <code>minecraft:fox</code>
|-
+
|-
| 1
+
| 29
| VarInt
+
| Ghast
|colspan="2"| Air
+
| 4.0
| 300
+
| 4.0
|-
+
| <code>minecraft:ghast</code>
| 2
+
|-
| OptChat
+
| 30
|colspan="2"| Custom name
+
| Giant
| empty
+
| 3.6
|-
+
| 12.0
| 3
+
| <code>minecraft:giant</code>
| Boolean
+
|-
|colspan="2"| Is custom name visible
+
| 31
| false
+
| Guardian
|-
+
| 0.85
| 4
+
| 0.85
| Boolean
+
| <code>minecraft:guardian</code>
|colspan="2"| Is silent
+
|-
| false
+
| 32
|-
+
| Hoglin
| 5
+
| 1.39648
| Boolean
+
| 1.4
|colspan="2"| No gravity
+
| <code>minecraft:hoglin</code>
| false
+
|-
|- {{Added}}
+
| 33
| 6
+
| Horse
| Pose
+
| 1.39648
|colspan="2"| Pose
+
| 1.6
| STANDING
+
| <code>minecraft:horse</code>
|}
+
|-
 
+
| 34
=== Itemed Throwable ===
+
| Husk
 
+
| 0.6
Extends [[#Throwable|Throwable]].
+
| 1.95
 
+
| <code>minecraft:husk</code>
Used for all things that previously extended throwable other than potions, which already had an item.
+
|-
 
+
| 35
{| class="wikitable" {{added}}
+
| Illusioner
! Index
+
| 0.6
! Type
+
| 1.95
!style="width: 250px;" colspan="2"| Meaning
+
| <code>minecraft:illusioner</code>
! Default
+
|- style="background: #ffff88;"
|-
+
| 36
| 7
+
| Iron Golem
| Slot
+
| 1.4
|colspan="2"| Item
+
| 2.7
| empty (which behaves as if it were a specific item, depending on the subclass)
+
| <code>minecraft:iron_golem</code>
|}
+
|-
 
+
| 37
=== Egg ===
+
| Item
 
+
| 0.25
Extends [[#Itemed_Throwable|Itemed Throwable]].
+
| 0.25
 
+
| <code>minecraft:item</code>
No additional metadata.
+
|- style="background: #ffff88;"
 
+
| 38
An empty item behaves as if the item were a <code>minecraft:egg</code>.
+
| Item Frame
 
+
| 0.75 or 0.0625 (depth)
=== Ender Pearl ===
+
| 0.75
 
+
| <code>minecraft:item_frame</code>
Extends [[#Itemed_Throwable|Itemed Throwable]].
+
|- style="background: #ffff88;"
 
+
| 39
No additional metadata.
+
| Fireball
 
+
| 1.0
An empty item behaves as if the item were a <code>minecraft:ender_pearl</code>.
+
| 1.0
 
+
| <code>minecraft:fireball</code>
=== Experience Bottle ===
+
|- style="background: #ffff88;"
 
+
| 40
Extends [[#Itemed_Throwable|Itemed Throwable]].
+
| Leash Knot
 
+
| 0.375
No additional metadata.
+
| 0.5
 
+
| <code>minecraft:leash_knot</code>
<code>minecraft:experience_bottle</code>
+
|- style="background: #ffff88;"
 
+
| 41
=== Snowball ===
+
| Lightning Bolt
 
+
| 0.0
Extends [[#Itemed_Throwable|Itemed Throwable]].
+
| 0.0
 
+
| <code>minecraft:lightning_bolt</code>
No additional metadata.
+
|-
 
+
| 42
<code>minecraft:snowball</code>
+
| Llama
 
+
| 0.9
=== Eye of Ender ===
+
| 1.87
 
+
| <code>minecraft:llama</code>
Extends [[#Entity|Entity]].
+
|- style="background: #ffff88;"
 
+
| 43
{| class="wikitable" {{added}}
+
| Llama Spit
! Index
+
| 0.25
! Type
+
| 0.25
!style="width: 250px;" colspan="2"| Meaning
+
| <code>minecraft:llama_spit</code>
! Default
+
|-
|-
+
| 44
| 7
+
| Magma Cube
| Slot
+
| 0.51000005 * size
|colspan="2"| Item
+
| 0.51000005 * size
| empty (which behaves as if it were a <code>minecraft:ender_eye</code>)
+
| <code>minecraft:magma_cube</code>
|}
+
|- style="background: #ffff88;"
 
+
| 45
=== Arrow ===
+
| Minecart
 
+
| 0.98
Extends [[#Entity|Entity]].
+
| 0.7
 
+
| <code>minecraft:minecart</code>
Abstract base class for [[#TippedArrow|TippedArrow]] (which is used for regular arrows as well as tipped ones) and Spectral Arrow.
+
|- style="background: #ffff88;"
 
+
| 46
{| class="wikitable"
+
| Minecart Chest
! Index
+
| 0.98
! Type
+
| 0.7
!style="width: 250px;" colspan="2"| Meaning
+
| <code>minecraft:chest_minecart</code>
! Default
+
|- style="background: #ffff88;"
|-
+
| 47
| rowspan="3" | {{change|6|7}}
+
| Minecart Command Block
| rowspan="3" | Byte
+
| 0.98
! Bit mask
+
| 0.7
! Meaning
+
| <code>minecraft:commandblock_minecart</code>
| rowspan="3" | 0
+
|- style="background: #ffff88;"
|-
+
| 48
| 0x01
+
| Minecart Furnace
| Is critical
+
| 0.98
|-
+
| 0.7
| 0x02
+
| <code>minecraft:furnace_minecart</code>
| Is noclip (used by loyalty tridents when returning)
+
|- style="background: #ffff88;"
|-
+
| 49
| {{change|7|8}}
+
| Minecart Hopper
| OptUUID
+
| 0.98
|colspan="2"| Shooter UUID
+
| 0.7
| Empty
+
| <code>minecraft:hopper_minecart</code>
|- {{added}}
+
|- style="background: #ffff88;"
| 9
+
| 50
| Byte
+
| Minecart Spawner
|colspan="2"| Piercing level
+
| 0.98
| 0
+
| 0.7
|}
+
| <code>minecraft:spawner_minecart</code>
 
+
|- style="background: #ffff88;"
=== TippedArrow ===
+
| 51
 
+
| Minecart TNT
Extends [[#Arrow|Arrow]].
+
| 0.98
 
+
| 0.7
Used for both tipped and regular arrows.  If not tipped, then color is set to -1 and no tipped arrow particles are used.
+
| <code>minecraft:tnt_minecart</code>
 
+
|-
{| class="wikitable"
+
| 52
! Index
+
| Mule
! Type
+
| 1.39648
!style="width: 250px;" colspan="2"| Meaning
+
| 1.6
! Default
+
| <code>minecraft:mule</code>
|-
+
|-
| {{change|8|10}}
+
| 53
| VarInt
+
| Mushroom
|colspan="2"| Color (-1 for no particles)
+
| 0.9
| -1
+
| 1.4
|}
+
| <code>minecraft:mooshroom</code>
 
+
|-
=== Trident ===
+
| 54
 
+
| Ocelot
Extends [[#Arrow|Arrow]].
+
| 0.6
 
+
| 0.7
{| class="wikitable"
+
| <code>minecraft:ocelot</code>
! Index
+
|- style="background: #aaaaff;"
! Type
+
| 55
!style="width: 250px;" colspan="2"| Meaning
+
| Painting
! Default
+
| type width or 0.0625 (depth)
|-
+
| type height
| {{change|8|10}}
+
| <code>minecraft:painting</code>
| VarInt
+
|-
|colspan="2"| Loyalty level (enchantment)
+
| 56
| 0
+
| Panda
|}
+
| 1.3
 
+
| 1.25
=== Itemed Fireball ===
+
| <code>minecraft:panda</code>
 
+
|-
Extends [[#Entity|Entity]].
+
| 57
 
+
| Parrot
Used for regular and small fireballs.  Not used for dragon fireballs and wither skulls.  Interestingly, regular fireballs do not come from an item.
+
| 0.5
 
+
| 0.9
{| class="wikitable" {{added}}
+
| <code>minecraft:parrot</code>
! Index
+
|-
! Type
+
| 58
!style="width: 250px;" colspan="2"| Meaning
+
| Phantom
! Default
+
| 0.9
|-
+
| 0.5
| 7
+
| <code>minecraft:phantom</code>
| Slot
+
|-
|colspan="2"| Item
+
| 59
| empty (which behaves as if it were a <code>minecraft:fire_charge</code>)
+
| Pig
|}
+
| 0.9
 
+
| 0.9
=== Fireball ===
+
| <code>minecraft:pig</code>
 
+
|-
Extends {{change|[[#Abstract Fireball|Abstract Fireball]]|[[#Itemed Fireball|Itemed Fireball]]}}.  This is the large fireball shot by ghasts.
+
| 60
 
+
| Piglin
No additional metadata.
+
| 0.6
 
+
| 1.95
=== Small Fireball ===
+
| <code>minecraft:piglin</code>
 
+
|-
Extends {{change|[[#Abstract Fireball|Abstract Fireball]]|[[#Itemed Fireball|Itemed Fireball]]}}.  This is the fireball shot by blazes and dispensers with fire charges.
+
| 61
 
+
| Piglin Brute
No additional metadata.
+
| 0.6
 
+
| 1.95
=== Fireworks ===
+
| <code>minecraft:piglin_brute</code>
 
+
|-
Extends [[#Entity|Entity]].
+
| 62
 
+
| Pillager
{| class="wikitable"
+
| 0.6
! Index
+
| 1.95
! Type
+
| <code>minecraft:pillager</code>
!style="width: 250px;" colspan="2"| Meaning
+
|-
! Default
+
| 63
|-
+
| Polar Bear
| {{change|6|7}}
+
| 1.4
| [[Slot]]
+
| 1.4
|colspan="2"| Firework info
+
| <code>minecraft:polar_bear</code>
| empty
+
|- style="background: #aaaaff;"
|-
+
| 64
| {{change|7|8}}
+
| Primed TNT
| {{Change|VarInt|OptVarInt}}
+
| 0.98
|colspan="2"| Entity ID of entity which used firework (for elytra boosting)
+
| 0.98
| 0
+
| <code>minecraft:tnt</code>
|- {{Added}}
+
|-
| 9
+
| 65
| Boolean
+
| Pufferfish
|colspan="2"| Shot at angle (from a crossbow)
+
| 0.7
| false
+
| 0.7
|}
+
| <code>minecraft:pufferfish</code>
 
+
|-
=== Living ===
+
| 66
 
+
| Rabbit
Extends [[#Entity|Entity]].
+
| 0.4
 
+
| 0.5
{| class="wikitable"
+
| <code>minecraft:rabbit</code>
! Index
+
|-
! Type
+
| 67
!style="width: 250px;" colspan="2"| Meaning
+
| Ravager
! Default
+
| 1.95
|-
+
| 2.2
|rowspan="5"| {{change|6|7}}
+
| <code>minecraft:ravager</code>
|rowspan="5"| Byte
+
|-
|colspan="2"| Hand states, used to trigger blocking/eating/drinking animation.
+
| 68
|rowspan="5"| 0
+
| Salmon
|-
+
| 0.7
! Bit mask
+
| 0.4
! Meaning
+
| <code>minecraft:salmon</code>
|-
+
|-
| 0x01
+
| 69
| Is hand active
+
| Sheep
|-
+
| 0.9
| 0x02
+
| 1.3
| Active hand (0 = main hand, 1 = offhand)
+
| <code>minecraft:sheep</code>
|-
+
|-
| 0x04
+
| 70
| In riptide spin attack
+
| Shulker
|-
+
| 1.0
| {{change|7|8}}
+
| 1.0-2.0 (depending on peek)
| Float
+
| <code>minecraft:shulker</code>
|colspan="2"| Health
+
|- style="background: #ffff88;"
| 1.0
+
| 71
|-
+
| Shulker Bullet
| {{change|8|9}}
+
| 0.3125
| VarInt
+
| 0.3125
|colspan="2"| Potion effect color (or 0 if there is no effect)
+
| <code>minecraft:shulker_bullet</code>
| 0
+
|-
|-
+
| 72
| {{change|9|10}}
+
| Silverfish
| Boolean
+
| 0.4
|colspan="2"| Is potion effect ambient: reduces the number of particles generated by potions to 1/5 the normal amount
+
| 0.3
| false
+
| <code>minecraft:silverfish</code>
|-
+
|-
| {{change|10|11}}
+
| 73
| VarInt
+
| Skeleton
|colspan="2"| Number of arrows in entity
+
| 0.6
| 0
+
| 1.99
|- {{Added}}
+
| <code>minecraft:skeleton</code>
| 12
+
|-
| OptBlockPos
+
| 74
|colspan="2"| Unknown (Bed location?)
+
| Skeleton Horse
| Absent
+
| 1.39648
|}
+
| 1.6
 
+
| <code>minecraft:skeleton_horse</code>
=== Panda ===
+
|-
 
+
| 75
Extends [[#Animal|Animal]].
+
| Slime
 
+
| 0.51000005 * size
{| class="wikitable" {{added}}
+
| 0.51000005 * size
! Index
+
| <code>minecraft:slime</code>
! Type
+
|- style="background: #ffff88;"
!style="width: 250px;" colspan="2"| Meaning
+
| 76
! Default
+
| Small Fireball
|-
+
| 0.3125
| 15
+
| 0.3125
| Integer
+
| <code>minecraft:small_fireball</code>
|colspan="2"| 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 <code>entity.panda.cant_breed</code> sound event.
+
|-
| 0
+
| 77
|-
+
| Snow Golem
| 16
+
| 0.7
| Integer
+
| 1.9
|colspan="2"| Sneeze timer.  Counts up from 0; when it hits 1 the <code>entity.panda.pre_sneeze</code> event plays and when it hits 21 the <code>entity.panda.sneeze</code> event plays (and it is set back to 0 and the sneeze flag is cleared).
+
| <code>minecraft:snow_golem</code>
| 0
+
|- style="background: #ffff88;"
|-
+
| 78
| 17
+
| Snowball
| Integer
+
| 0.25
|colspan="2"| Eat timer.  If nonzero, counts upwards.
+
| 0.25
| 0
+
| <code>minecraft:snowball</code>
|-
+
|- style="background: #ffff88;"
| 18
+
| 79
| Byte
+
| Spectral Arrow
|colspan="2"| Main Gene
+
| 0.5
| 0
+
| 0.5
|-
+
| <code>minecraft:spectral_arrow</code>
| 19
+
|-
| Byte
+
| 80
|colspan="2"| Hidden Gene
+
| Spider
| 0
+
| 1.4
|-
+
| 0.9
|rowspan="6"| 20
+
| <code>minecraft:spider</code>
|rowspan="6"| Byte
+
|-
! Bit mask
+
| 81
! Meaning
+
| Squid
|rowspan="6"| 0
+
| 0.8
|-
+
| 0.8
| 0x01
+
| <code>minecraft:squid</code>
| Unused
+
|-
|-
+
| 82
| 0x02
+
| Stray
| Is sneezing
+
| 0.6
|-
+
| 1.99
| 0x04
+
| <code>minecraft:stray</code>
| Is eating
+
|-
|-
+
| 83
| 0x08
+
| Strider
| Unknown
+
| 0.9
|-
+
| 1.7
| 0x10
+
| <code>minecraft:strider</code>
| Unknown
+
|- style="background: #ffff88;"
|}
+
| 84
 
+
| Thrown Egg
=== Fox ===
+
| 0.25
 
+
| 0.25
Extends [[#Animal|Animal]].
+
| <code>minecraft:egg</code>
 
+
|- style="background: #ffff88;"
{| class="wikitable" {{added}}
+
| 85
! Index
+
| Thrown Ender Pearl
! Type
+
| 0.25
!style="width: 250px;" colspan="2"| Meaning
+
| 0.25
! Default
+
| <code>minecraft:ender_pearl</code>
|-
+
|- style="background: #ffff88;"
| 15
+
| 86
| VarInt
+
| Thrown Expierience Bottle
| colspan="2" | Type (0: red, 1: snow)
+
| 0.25
| 0 (red)
+
| 0.25
|-
+
| <code>minecraft:experience_bottle</code>
| rowspan="9" | 16
+
|- style="background: #ffff88;"
| rowspan="9" | Byte
+
| 87
! Bit mask
+
| Thrown Potion
! Meaning
+
| 0.25
| rowspan="9" | 0
+
| 0.25
|-
+
| <code>minecraft:potion</code>
| 0x01 || Sitting
+
|- style="background: #ffff88;"
|-
+
| 88
| 0x02 || ''Unused''
+
| Thrown Trident
|-
+
| 0.5
| 0x04 || Crouching
+
| 0.5
|-
+
| <code>minecraft:trident</code>
| 0x08 || Unknown
+
|-
|-
+
| 89
| 0x10 || Unknown
+
| Trader Llama
|-
+
| 0.9
| 0x20 || Sleeping
+
| 1.87
|-
+
| <code>minecraft:trader_llama</code>
| 0x40 || Unknown
+
|-
|-
+
| 90
| 0x80 || Unknown
+
| Tropical Fish
|-
+
| 0.5
| 17
+
| 0.4
| OptUUID
+
| <code>minecraft:tropical_fish</code>
| colspan="2" | First UUID (in <code>UUIDs</code> NBT)?
+
|-
| Absent
+
| 91
|-
+
| Turtle
| 18
+
| 1.2
| OptUUID
+
| 0.4
| colspan="2" | Second UUID (in <code>UUIDs</code> NBT)?
+
| <code>minecraft:turtle</code>
| Absent
+
|-
|}
+
| 92
 
+
| Vex
=== Mooshroom ===
+
| 0.4
 
+
| 0.8
Extends [[#Cow|Cow]].
+
| <code>minecraft:vex</code>
 
+
|-
{{change|No additional metadata.}}
+
| 93
 
+
| Villager
{| class="wikitable" {{added}}
+
| 0.6
! Index
+
| 1.95
! Type
+
| <code>minecraft:villager</code>
!style="width: 250px;" colspan="2"| Meaning
+
|-
! Default
+
| 94
|-
+
| Vindicator
| 15
+
| 0.6
| String
+
| 1.95
| colspan="2"| Variant ("red" or "brown")
+
| <code>minecraft:vindicator</code>
| red
+
|-
|}
+
| 95
 
+
| Wandering Trader
=== Raid Participant ===
+
| 0.6
 
+
| 1.95
{{change||Extends [[#Monster|Monster]].}}
+
| <code>minecraft:wandering_trader</code>
 
+
|-
{| class="wikitable" {{added}}
+
| 96
! Index
+
| Witch
! Type
+
| 0.6
!style="width: 250px;" colspan="2"| Meaning
+
| 1.95
! Default
+
| <code>minecraft:witch</code>
|-
+
|-
| 14
+
| 97
| boolean
+
| Wither
| colspan="2"| Is celebrating
+
| 0.9
| false
+
| 3.5
|}
+
| <code>minecraft:wither</code>
 
+
|-
"Is celebrating" appears to control the pose for vindicators and does not appear to be used by other types.
+
| 98
 +
| Wither Skeleton
 +
| 0.7
 +
| 2.4
 +
| <code>minecraft:wither_skeleton</code>
 +
|- style="background: #ffff88;"
 +
| 99
 +
| Wither Skull
 +
| 0.3125
 +
| 0.3125
 +
| <code>minecraft:wither_skull</code>
 +
|-
 +
| 100
 +
| Wolf
 +
| 0.6
 +
| 0.85
 +
| <code>minecraft:wolf</code>
 +
|-
 +
| 101
 +
| Zoglin
 +
| 1.39648
 +
| 1.4
 +
| <code>minecraft:zoglin</code>
 +
|-
 +
| 102
 +
| Zombie
 +
| 0.6
 +
| 1.95
 +
| <code>minecraft:zombie</code>
 +
|-
 +
| 103
 +
| Zombie Horse
 +
| 1.39648
 +
| 1.6
 +
| <code>minecraft:zombie_horse</code>
 +
|-
 +
| 104
 +
| Zombie Villager
 +
| 0.6
 +
| 1.95
 +
| <code>minecraft:zombie_villager</code>
 +
|-
 +
| 105
 +
| Zombified Piglin
 +
| 0.6
 +
| 1.95
 +
| <code>minecraft:zombified_piglin</code>
 +
|- style="background: #aaaaff;"
 +
| 106
 +
| Player
 +
| 0.6
 +
| 1.8
 +
| <code>minecraft:player</code>
 +
|- style="background: #ffff88;"
 +
| 107
 +
| Fishing Hook
 +
| 0.25
 +
| 0.25
 +
| <code>minecraft:fishing_bobber</code>
 +
|}
  
=== Abstract Illager ===
+
== Objects ==
  
Extends {{change|[[#Monster|Monster]]|[[#Raid Participant|Raid Participant]]}}.
+
Objects are spawned via [[Protocol#Spawn_Object|Spawn Object]]. See [[Object Data]] for more details.
  
{| class="wikitable" {{removed}}
+
{{Note|Object IDs and Entity IDs are different. Most objects also have an entity ID, but should only ever be spawned via [[Protocol#Spawn_Object|Spawn Object]].}}
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
|rowspan="2"| 12
 
|rowspan="2"| Byte
 
! Bit mask
 
! Meaning
 
|rowspan="2"| 0
 
|-
 
| 0x01
 
  | Has target (aggressive state)
 
|}
 
 
 
{{Change||Replaced with pose (presumably?)}}
 
 
 
=== Spellcaster Illager ===
 
 
 
Extends [[#Abstract Illager|Abstract Illlager]].
 
  
 
{| class="wikitable"
 
{| class="wikitable"
! Index
+
|-
! Type
+
! ID
!style="width: 250px;" colspan="2"| Meaning
+
! Name
! Default
+
! bounding box x and z
|-
+
! bounding box y
| {{change|13|15}}
+
|-  
| Byte
+
| 1
| colspan="2"| Spell (0: none, 1: summon vex, 2: attack, 3: wololo, 4: disappear, 5: blindness)
+
| Boat
| 0
+
| 1.375
|}
+
| 0.5625
 
+
|-
=== {{change|EvocationIllager|Evoker}} ===
+
| 2
 
+
| Item Stack ([[Slot]])
Extends [[#Spellcaster Illager|Spellcaster Illager]].
+
| 0.25
 
+
| 0.25
=== {{change|IllusionIllager|Illusioner}} ===
+
|-
 
+
| 3
Extends [[#Spellcaster Illager|Spellcaster Illager]].
+
| Area Effect Cloud
 
+
| 2.0 * Radius
=== Pillager ===
+
| 0.5
 
+
|-
Extends [[#Abstract Illager|Abstract Illlager]].
+
| 10
 
+
| Minecart
{| class="wikitable" {{added}}
+
| 0.98
! Index
+
| 0.7
! Type
+
|-
!style="width: 250px;" colspan="2"| Meaning
+
| 50
! Default
+
| Primed TNT
|-
+
| 0.98
| 15
+
| 0.98
| Boolean
+
|-
| colspan="2"| Using crossbow
+
| 51
| false
+
| End Crystal
|}
+
| 2.0
 
+
| 2.0
=== {{change|VindicationIllager|Vindicator}} ===
+
|-  
 
+
| 60
Extends [[#Abstract Illager|Abstract Illager]].
+
| Tipped arrow (projectile; also used for regular arrows)
 
+
| 0.5
=== Ravager ===
+
| 0.5
 
+
|-
Extends [[#Raid Participant|Raid Participant]]
+
| 61
 
+
| Snowball (projectile)
No additional metadata.
+
| 0.25
 
+
| 0.25
{| class="wikitable" {{added}}
+
|-
! Status
+
| 62
!colspan="2"| Description
+
| Egg (projectile)
|-
+
| 0.25
| 4
+
| 0.25
|colspan="2"| Starts the attack animation.
+
|-  
|-
+
| 63
| 39
+
| Fireball (Ghast projectile)
|colspan="2"| Starts the stun animation.
+
| 1.0
|}
+
| 1.0
 
+
|-
=== Witch ===
+
| 64
 
+
| Small Fireball (Blaze projectile)
Extends {{change|[[#Monster|Monster]]|[[#Raid Participant|Raid Participant]]}}.
+
| 0.3125
 
+
| 0.3125
{| class="wikitable"
+
|-
! Index
+
| 65
! Type
+
| Thrown Ender Pearl
!style="width: 250px;" colspan="2"| Meaning
+
| 0.25
! Default
+
| 0.25
|-
+
|-
| {{change|12|15}}
+
| 66
| Boolean
+
| Wither Skull (Wither projectile)
|colspan="2"| Is drinking potion
+
| 0.3125
| false
+
| 0.3125
|}
+
|-
 
+
| 67
=== AbstractSkeleton ===
+
| Shulker Bullet
 
+
| 0.3125
Extends [[#Monster|Monster]].
+
| 0.3125
 
+
|-  
{| class="wikitable" {{removed}}
+
| 68
! Index
+
| Llama spit
! Type
+
| 0.25
!style="width: 250px;" colspan="2"| Meaning
+
| 0.25
! Default
+
|-  
|-
+
| 70
| {{change|12|14}}
+
| Falling Block
| Boolean
+
| 0.98
|colspan="2"| Is swinging arms
+
| 0.98
| false
+
|-  
|}
+
| 71
 
+
| Item Frame
{{Change||Replaced with pose (presumably?)}}
+
| 0.75 or 0.0625
 
+
| 0.75
=== Zombie ===
+
|-  
 
+
| 72
Extends [[#Monster|Monster]].
+
| Eye of Ender
 
+
| 0.25
{| class="wikitable"
+
| 0.25
! Index
+
|-
! Type
+
| 73
!style="width: 250px;" colspan="2"| Meaning
+
| Thrown Potion
! Default
+
| 0.25
|-
+
| 0.25
| {{change|12|14}}
+
|-
| Boolean
+
| 75
|colspan="2"| Is baby
+
| Thrown Exp Bottle
| false
+
| 0.25
|-
+
| 0.25
| {{change|13|15}}
+
|-  
| VarInt
+
| 76
|colspan="2"| Unused (previously type)
+
| Firework Rocket Entity
| 0
+
| 0.25
|- {{removed}}
+
| 0.25
| 14
+
|-  
| Boolean
+
| 77
|colspan="2"| Are hands held up
+
| Leash Knot
| false
+
| 0.375
|-
+
| 0.5
| {{change|15|16}}
+
|-
| Boolean
+
| 78
|colspan="2"| Is becoming a drowned
+
| Armor Stand
| false
+
| normal: 0.5 marker: 0.0 small: 0.25
|}
+
| normal: 1.975 marker: 0.0 small: 0.9875
 
+
|-
{{Change||Replaced with pose (presumably?)}}
+
| 79
 
+
| Evoker Fangs Fangs
=== Zombie Villager ===
+
| 0.5
 
+
| 0.8
Extends [[#Zombie|Zombie]].
+
|-
 
+
| 90
{| class="wikitable"
+
| Fishing Hook
! Index
+
| 0.25
! Type
+
| 0.25
!style="width: 250px;" colspan="2"| Meaning
+
|-
! Default
+
| 91
|-
+
| Spectral Arrow
| {{change|16|17}}
+
| 0.5
| Boolean
+
| 0.5
|colspan="2"| Is converting
+
|-  
| false
+
| 93
|-  
+
| Dragon Fireball
| {{change|17|18}}
+
| 1.0
| {{Change|VarInt|Villager Data}}
+
| 1.0
|colspan="2"| {{Change|Profession|Villager Data}}
+
|-
| {{change|0|Plains/None/1}}
+
| 94
|}
+
| Trident
 
+
| 0.5
 
+
| 0.5
=== Ocelot ===
+
|}
 
 
Extends {{change|[[#TameableAnimal|TameableAnimal]]|[[#Ageable|Ageable]]}}.
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|- {{removed}}
 
| 15
 
| VarInt
 
|colspan="2"| Type (0 = untamed, 1 = tuxedo, 2 = tabby, 3 = siamese).  Used to render regardless as to whether it is tamed or not.
 
| 0
 
|- {{added}}
 
| 15
 
| Boolean
 
|colspan="2"| Is trusting
 
| false
 
|}
 
  
{| class="wikitable" {{added}}
+
Since release {{Minecraft Wiki|1.6}}, all minecarts are spawned with object type 10 and their functionality is then specified in the [[Object Data#Minecarts (id 10)|Data field]] within the packet. Also, their visual appearance may be sent via the [[Protocol#Entity Metadata|Entity Metadata]] packet.
! Status
 
!colspan="2"| Description
 
|-
 
| 40
 
|colspan="2"| Spawn smoke particles (trust gaining failed)
 
|-
 
| 41
 
|colspan="2"| Spawn heart particles (trust gaining succeeded)
 
|}
 
  
=== Cat ===
+
== Entity Metadata Format ==
  
Extends [[#TameableAnimal|TameableAnimal]].
+
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.
  
{| class="wikitable" {{added}}
+
Entity Metadata is an array of entries, each of which looks like the following:
  ! Index
+
 
 +
{| class="wikitable"
 +
  ! Name
 
  ! Type
 
  ! Type
  !style="width: 250px;" colspan="2"| Meaning
+
  ! Meaning
! Default
 
 
  |-
 
  |-
  | 17
+
  | Index
  | VarInt
+
  | Unsigned Byte
  |colspan="2"| Type (0 = tabby, 1 = black, 2 = red, 3 = siamese, 4 = british_shorthair, 5 = calico, 6 = persian, 7 = ragdoll, 8 = white, 9 = all_black)
+
  | Unique index key determining the meaning of the following value, see the table below. If this is <code>0xff</code> then the it is the end of the Entity Metadata array and no more is read.
| 1
 
 
  |-
 
  |-
  | 18
+
  | Type
  | Boolean
+
  | Optional VarInt Enum
  |colspan="2"| Unknown
+
  | Only if Index is not <code>0xff</code>; the type of the index, see the table below
| false
 
 
  |-
 
  |-
  | 19
+
  | Value
  | Boolean
+
  | Optional ''value of Type''
  |colspan="2"| Unknown
+
  | Only if Index is not <code>0xff</code>: the value of the metadata field
| false
 
|-
 
| 20
 
| VarInt
 
|colspan="2"| Collar color (values are those {{Minecraft Wiki|Data_values#Dyes|used with dyes}})
 
| 14 (Red)
 
 
  |}
 
  |}
  
=== Horse ===
+
{| class="wikitable"
 
+
  ! Value of Type field
Extends [[#AbstractHorse|AbstractHorse]].
+
  ! [[Data types|Type]] of Value field
 
+
  ! Notes
{| class="wikitable"  
 
  ! Index
 
! Type
 
  !style="width: 250px;" colspan="2"| Meaning
 
  ! Default
 
 
  |-
 
  |-
| {{change|15|17}}
 
| VarInt
 
|colspan="2"| Variant (Color & Style)
 
 
  | 0
 
  | 0
  |- {{removed}}
+
| Byte
  | 16
+
|
 +
  |-
 +
  | 1
 
  | VarInt
 
  | VarInt
  |colspan="2"| Armor (0: none, 1: iron, 2: gold, 3: diamond)
+
  |
| 0 (none)
 
|- {{removed}}
 
| 17
 
| [[Slot]]
 
|colspan="2"| Armor Item (Forge only)
 
| Empty
 
|}
 
 
 
{{change||Replaced with [[#Entity Equipment|Entity Equipment]] packet. (Uses chestplate slot)}}
 
 
 
=== Trader Llama ===
 
 
 
Extends [[#Llama|Llama]].
 
 
 
No additional metadata.
 
 
 
=== Abstract Merchant ===
 
 
 
Extends [[#Ageable|Ageable]].
 
 
 
{| class="wikitable" {{added}}
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
 
  |-
 
  |-
  | 15
+
  | 2
| VarInt
+
  | Float
|colspan="2"| Head shake timer (starts at 40, decrements each tick)
+
  |
| 0
 
  |}
 
 
 
=== Villager ===
 
 
 
Extends {{change|[[#Ageable|Ageable]]|[[#Abstract Merchant|Abstract Merchant]]}}.
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
  !style="width: 250px;" colspan="2"| Meaning
 
! Default
 
 
  |-
 
  |-
  | {{change|13|16}}
+
  | 3
| {{change|VarInt|Villager Data}}
+
  | String
|colspan="2"| {{Change|Profession (Farmer = 0, Librarian = 1, Priest = 2, Blacksmith = 3, Butcher = 4, Nitwit = 5)|Villager Data}}
+
  |
  | {{change|0|Plains/None/1}}
 
  |}
 
 
 
=== Wandering Trader ===
 
 
 
Extends [[#Abstract Merchant|Abstract Merchant]].
 
 
 
No additional metadata.
 
 
 
=== Bee ===
 
 
 
Extends [[#Animal|Animal]].
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
 
  |-
 
  |-
  | 16
+
  | 4
  | Byte
+
  | [[Chat]]
  | colspan="2"| BitMask
+
  |
  | 0
+
|-
 +
| 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
 
  |-
 
  |-
  | 17
+
  | 9
  | VarInt
+
| [[Data Types#Position|Position]]
  | colspan="2"| Anger time in ticks
+
  |
  | 0 (Not angry)
+
  |-
  |}
+
| 10
 
+
  | OptPosition (Boolean + Optional Position)
</div>
+
  | Position is present if the Boolean is set to true
 
+
|-
== Mobs ==
+
| 11
 
+
| Direction (VarInt)
Mobs are spawned via [[Protocol#Spawn_Mob|Spawn Mob]].
+
| (Down = 0, Up = 1, North = 2, South = 3, West = 4, East = 5)
 
+
|-
{{Warning2|Some entities (marked in yellow) should only be spawned using [[Protocol#Spawn_Object|Spawn Object]] and their [[#Objects|Object ID]]. While they also have an entity ID, this ID is only used internally. Servers should not attempt to spawn these entities using [[Protocol#Spawn Mob|Spawn Mob]] with that entity ID, although clients should accept such packets if they appear.
+
| 12
 
+
| OptUUID (Boolean + Optional UUID)
Additionally, a few other entities (marked in blue) must be spawned in their own special ways:
+
| UUID is present if the Boolean is set to true
* {{Minecraft Wiki|Painting}}s should be spawned using [[Protocol#Spawn_Painting|Spawn Painting]]
+
|-
* XP orbs should be spawned using [[Protocol#Spawn_Experience_Orb|Spawn Experience Orb]].}}
+
  | 13
 
+
  | OptBlockID (VarInt)
{| class="wikitable"
+
| 0 for absent (implies air); otherwise, a block state ID as per the global palette
|-  
+
|-
! Type
+
| 14
! Name
+
| [[NBT]]
! bounding box x and z
+
|
! bounding box y
+
|-
! ID
+
| 15
|- style="background: #ffff88;"
+
| [[Data Types#Particle|Particle]]
| 0
+
|
| AreaEffectCloud
+
|-
| 2.0 * Radius
+
| 16
| 0.5
+
| Villager Data
| <code>minecraft:area_effect_cloud</code>
+
| 3 VarInts: villager type, villager profession, level
|- style="background: #ffff88;"
+
|-
| 1
+
| 17
| ArmorStand
+
| OptVarInt
| normal: 0.5 marker: 0.0 small: 0.25
+
| 0 for absent; 1 + actual value otherwise.  Used for entity IDs.
| normal: 1.975 marker: 0.0 small: 0.9875
+
|-
| <code>minecraft:armor_stand</code>
+
| 18
|- style="background: #ffff88;"
+
| Pose
| 2
+
| A VarInt enum: 0: STANDING, 1: FALL_FLYING, 2: SLEEPING, 3: SWIMMING, 4: SPIN_ATTACK, 5: SNEAKING, 6: DYING
| Arrow
+
|}
| 0.5
+
 
| 0.5
+
Villager type (<code>minecraft:villager_type</code> registry):
| <code>minecraft:arrow</code>
+
 
|-
+
{| class="wikitable"
| 3
+
! Name !! ID
| Bat
+
|-
| 0.5
+
| <code>minecraft:desert</code> || 0
| 0.9
+
|-
| <code>minecraft:bat</code>
+
| <code>minecraft:jungle</code> || 1
|-
+
|-
| 4
+
| <code>minecraft:plains</code> || 2
| Blaze
+
|-
| 0.6
+
| <code>minecraft:savanna</code> || 3
| 1.8
+
|-
| <code>minecraft:blaze</code>
+
| <code>minecraft:snow</code> || 4
|- style="background: #ffff88;"
+
|-
| 5
+
| <code>minecraft:swamp</code> || 5
| Boat
+
|-
| 1.375
+
| <code>minecraft:taiga</code> || 6
| 0.5625
+
|}
| <code>minecraft:boat</code>
+
 
|-
+
Villager professions (<code>minecraft:villager_profession</code> registry):
| 6
+
 
| CaveSpider
+
{| class="wikitable"
| 0.7
+
! Name !! ID
| 0.5
+
|-
| <code>minecraft:cave_spider</code>
+
| <code>minecraft:none</code> || 0
|-
+
|-
| 7
+
| <code>minecraft:armorer</code> || 1
| Chicken
+
|-
| 0.4
+
| <code>minecraft:butcher</code> || 2
| 0.7
+
|-
| <code>minecraft:chicken</code>
+
| <code>minecraft:cartographer</code> || 3
|-
+
|-
| 8
+
| <code>minecraft:cleric</code> || 4
| Cod
+
|-
| 0.9
+
| <code>minecraft:farmer</code> || 5
| 1.4
+
|-
| <code>minecraft:cod</code>
+
| <code>minecraft:fisherman</code> || 6
|-
+
|-
| 9
+
| <code>minecraft:fletcher</code> || 7
| Cow
+
|-
| 0.9
+
| <code>minecraft:leatherworker</code> || 8
| 1.4
+
|-
| <code>minecraft:cow</code>
+
| <code>minecraft:librarian</code> || 9
|-
+
|-
| 10
+
| <code>minecraft:mason</code> || 10
| Creeper
+
|-
| 0.6
+
| <code>minecraft:nitwit</code> || 11
| 1.7
+
|-
| <code>minecraft:creeper</code>
+
| <code>minecraft:shepherd</code> || 12
|-
+
|-
| 11
+
| <code>minecraft:toolsmith</code> || 13
| Donkey
+
|-
| 1.3964844
+
| <code>minecraft:weaponsmith</code> || 14
| 1.6
+
|}
| <code>minecraft:donkey</code>
+
 
|-
+
Entity classes also recursively inherit fields from classes they extend.
| 12
+
 
| Dolphin
+
=== Entity ===
| 0.9
+
 
| 0.6
+
{{metadata inherit|Entity}}
| <code>minecraft:dolphin</code>
+
 
|- style="background: #ffff88;"
+
{| class="wikitable"
| 13
+
! Index
| DragonFireball
+
! Type
| 1.0
+
!style="width: 250px;" colspan="2"| Meaning
| 1.0
+
! Default
| <code>minecraft:dragon_fireball</code>
+
|-
|-
+
|rowspan="9"| {{Metadata id|}}
| 14
+
|rowspan="9"| Byte
| Drowned
+
! Bit mask
| ?
+
! Meaning
| ?
+
|rowspan="9"| 0
| <code>minecraft:drowned</code>
+
|-
|-
+
| 0x01
| 15
+
| Is on fire
| ElderGuardian
+
|-
| 1.9975 (2.35 * guardian)
+
| 0x02
| 1.9975 (2.35 * guardian)
+
| Is crouching
| <code>minecraft:elder_guardian</code>
+
|-
|- style="background: #ffff88;"
+
| 0x04
| 16
+
| Unused (previously riding)
| EnderCrystal
+
|-
| 2.0
+
| 0x08
| 2.0
+
| Is sprinting
| <code>minecraft:end_crystal</code>
+
|-
|-
+
| 0x10
| 17
+
| Is swimming
| EnderDragon
+
|-
| 16.0
+
| 0x20
| 8.0
+
| Is invisible
| <code>minecraft:ender_dragon</code>
+
|-
|-
+
| 0x40
| 18
+
| has glowing effect
| Enderman
+
|-
| 0.6
+
| 0x80
| 2.9
+
| Is flying with an {{Minecraft Wiki|elytra}}
| <code>minecraft:enderman</code>
+
|-
|-
+
| {{Metadata id|}}
| 19
+
| VarInt
| Endermite
+
|colspan="2"| Air ticks
| 0.4
+
| 300
| 0.3
+
|-
| <code>minecraft:endermite</code>
+
| {{Metadata id|}}
|- style="background: #ffff88;"
+
| OptChat
| 20
+
|colspan="2"| Custom name
| EvocationFangs
+
| empty
| 0.5
+
|-
| 0.8
+
| {{Metadata id|}}
| <code>minecraft:evoker_fangs</code>
+
| Boolean
|-
+
|colspan="2"| Is custom name visible
| 21
+
| false
| EvocationIllager
+
|-
| 0.6
+
| {{Metadata id|}}
| 1.95
+
| Boolean
| <code>minecraft:evoker</code>
+
|colspan="2"| Is silent
|- style="background: #aaaaff;"
+
| false
| 22
+
|-
| XPOrb
+
| {{Metadata id|}}
| 0.5
+
| Boolean
| 0.5
+
|colspan="2"| Has no gravity
| <code>minecraft:experience_orb</code>
+
| false
|- style="background: #ffff88;"
+
|-
| 23
+
| {{Metadata id|}}
| EyeOfEnderSignal
+
| Pose
| 0.25
+
|colspan="2"| Pose
| 0.25
+
| STANDING
| <code>minecraft:eye_of_ender</code>
+
|}
|- style="background: #ffff88;"
+
 
| 24
+
=== Thrown Egg ===
| FallingSand
+
 
| 0.98
+
{{Metadata inherit|Thrown Egg|inherits=Entity}}
| 0.98
+
 
| <code>minecraft:falling_block</code>
+
{| class="wikitable"
|- style="background: #ffff88;"
+
! Index
| 25
+
! Type
| FireworksRocketEntity
+
!style="width: 250px;" colspan="2"| Meaning
| 0.25
+
! Default
| 0.25
+
|-
| <code>minecraft:fireworks_rocket</code>
+
| {{Metadata id|}}
|-
+
| [[Slot]]
| 26
+
|colspan="2"| Item
| Ghast
+
| Empty (which behaves as if it were a <code>minecraft:egg</code>)
| 4
+
|}
| 4
+
 
| <code>minecraft:ghast</code>
+
=== Thrown Ender Pearl ===
|-
+
 
| 27
+
{{Metadata inherit|Thrown Ender Pearl|inherits=Entity}}
| Giant
+
 
| 3.6
+
{| class="wikitable"
| 10.8
+
! Index
| <code>minecraft:giant</code>
+
! Type
|-
+
!style="width: 250px;" colspan="2"| Meaning
| 28
+
! Default
| Guardian
+
|-
| 0.85
+
| {{Metadata id|}}
| 0.85
+
| [[Slot]]
| <code>minecraft:guardian</code>
+
|colspan="2"| Item
|-
+
| Empty (which behaves as if it were a <code>minecraft:ender_pearl</code>)
| 29
+
|}
| Horse (EntityHorse until 1.11)
+
 
| 1.3964844
+
=== Thrown Experience Bottle===
| 1.6
+
 
| <code>minecraft:horse</code>
+
{{Metadata inherit|Thrown Experience Bottle|inherits=Entity}}
|-
+
 
| 30
+
{| class="wikitable"
| Husk
+
! Index
| 0.6
+
! Type
| 1.95
+
!style="width: 250px;" colspan="2"| Meaning
| <code>minecraft:husk</code>
+
! Default
|-
+
|-
| 31
+
| {{Metadata id|}}
| IllusionIllager
+
| [[Slot]]
| 0.6
+
|colspan="2"| Item
| 1.95
+
| Empty (which behaves as if it were a <code>minecraft:experience_bottle</code>)
| <code>minecraft:illusioner</code>
+
|}
|- style="background: #ffff88;"
+
 
| 32
+
=== Thrown Potion ===
| Item
+
 
| 0.25
+
{{Metadata inherit|Thrown Potion|inherits=Entity}}
| 0.25
+
 
| <code>minecraft:item</code>
+
{| class="wikitable"
|- style="background: #ffff88;"
+
! Index
| 33
+
! Type
| ItemFrame
+
!style="width: 250px;" colspan="2"| Meaning
| 0.75 or 0.0625 (depth)
+
! Default
| 0.75
+
|-
| <code>minecraft:item_frame</code>
+
| {{Metadata id|}}
|- style="background: #ffff88;"
+
| [[Slot]]
| 34
+
|colspan="2"| Potion which is thrown
| Fireball (ghast)
+
| Empty
| 1.0
+
|}
| 1.0
+
 
| <code>minecraft:fireball</code>
+
=== Snowball ===
|- style="background: #ffff88;"
+
 
| 35
+
{{Metadata inherit|Snowball|inherits=Entity}}
| LeashKnot
+
 
| 0.375
+
{| class="wikitable"
| 0.5
+
! Index
| <code>minecraft:leash_knot</code>
+
! Type
|-
+
!style="width: 250px;" colspan="2"| Meaning
| 36
+
! Default
| Llama
+
|-
| 0.9
+
| {{Metadata id|}}
| 1.87
+
| [[Slot]]
| <code>minecraft:llama</code>
+
|colspan="2"| Item
|- style="background: #ffff88;"
+
| Empty (which behaves as if it were a <code>minecraft:snowball</code>)
| 37
+
|}
| LlamaSpit
+
 
| 0.25
+
=== Eye of Ender ===
| 0.25
+
 
| <code>minecraft:llama_spit</code>
+
{{Metadata inherit|Eye of Ender|inherits=Entity}}
|-  
+
 
| 38
+
{| class="wikitable"
| LavaSlime (Magma Cube)
+
! Index
| 0.51000005 * size
+
! Type
| 0.51000005 * size
+
!style="width: 250px;" colspan="2"| Meaning
| <code>minecraft:magma_cube</code>
+
! Default
|- style="background: #ffff88;"
+
|-
| 39
+
| {{Metadata id|}}
| MinecartRideable
+
| [[Slot]]
| 0.98
+
|colspan="2"| Item
| 0.7
+
| Empty (which behaves as if it were a <code>minecraft:ender_eye</code>)
| <code>minecraft:minecart</code>
+
|}
|- style="background: #ffff88;"
+
 
| 40
+
=== Falling Block ===
| MinecartChest
+
 
| 0.98
+
{{Metadata inherit|Falling Block|inherits=Entity}}
| 0.7
+
 
| <code>minecraft:chest_minecart</code>
+
{| class="wikitable"
|- style="background: #ffff88;"
+
! Index
| 41
+
! Type
| MinecartCommandBlock
+
!style="width: 250px;" colspan="2"| Meaning
| 0.98
+
! Default
| 0.7
+
|-
| <code>minecraft:commandblock_minecart</code>
+
| {{Metadata id|}}
|- style="background: #ffff88;"
+
| [[Data Types#Position|BlockPos]]
| 42
+
|colspan="2"| spawn position
| MinecartFurnace
+
| (0, 0, 0)
| 0.98
+
|}
| 0.7
+
 
| <code>minecraft:furnace_minecart</code>
+
=== Area Effect Cloud ===
|- style="background: #ffff88;"
+
 
| 43
+
{{Metadata inherit|Area Effect Cloud|inherits=Entity}}
| MinecartHopper
+
 
| 0.98
+
{| class="wikitable"
| 0.7
+
! Index
| <code>minecraft:hopper_minecart</code>
+
! Type
|- style="background: #ffff88;"
+
!style="width: 250px;" colspan="2"| Meaning
| 44
+
! Default
| MinecartSpawner
+
|-
| 0.98
+
| {{Metadata id|}}
| 0.7
+
| Float
| <code>minecraft:spawner_minecart</code>
+
|colspan="2"| Radius
|- style="background: #ffff88;"
+
| 0.5
| 45
+
|-
| MinecartTNT
+
| {{Metadata id|}}
| 0.98
+
| VarInt
| 0.7
+
|colspan="2"| Color (only for mob spell particle)
| <code>minecraft:tnt_minecart</code>
+
| 0
|-
+
|-
| 46
+
| {{Metadata id|}}
| Mule
+
| Boolean
| 1.3964844
+
|colspan="2"| Ignore radius and show effect as single point, not area
| 1.6
+
| false
| <code>minecraft:mule</code>
+
|-
|-
+
| {{Metadata id|}}
| 47
+
| Particle
| MushroomCow (Mooshroom)
+
| colspan="2"| The [[#Particle]]
| 0.9
+
| <code>effect</code>
| 1.4
+
|}
| <code>minecraft:mooshroom</code>
+
 
|-
+
=== Fishing Hook ===
| 48
+
 
| Ozelot (Ocelot)
+
{{Metadata inherit|Fishing Hook|inherits=Entity}}
| 0.6
+
 
| 0.7
+
{| class="wikitable"
| <code>minecraft:ocelot</code>
+
! Index
|- style="background: #aaaaff;"
+
! Type
| 49
+
!style="width: 250px;" colspan="2"| Meaning
| Painting
+
! Default
| type width or 0.0625 (depth)
+
|-
| type height
+
| {{Metadata id|}}
| <code>minecraft:painting</code>
+
| VarInt
|-
+
|colspan="2"| Hooked entity id + 1, or 0 if there is no hooked entity
| 50
+
| 0
| Parrot
+
  |-
| 0.5
+
| {{Metadata id|}}
| 0.9
+
| Boolean
| <code>minecraft:parrot</code>
+
|colspan="2"| Is catchable
|-  
+
| False
| 51
+
|}
| Pig
+
 
| 0.9
+
=== Abstract Arrow ===
| 0.9
+
 
| <code>minecraft:pig</code>
+
{{Metadata inherit|Abstract Arrow|inherits=Entity}}
|-
+
 
| 52
+
{| class="wikitable"
| Pufferfish
+
! Index
| ?
+
! Type
| ?
+
!style="width: 250px;" colspan="2"| Meaning
| <code>minecraft:pufferfish</code>
+
! Default
|-
+
|-
| 53
+
| rowspan="3" | {{Metadata id|}}
| PigZombie
+
| rowspan="3" | Byte
| 0.6
+
! Bit mask
| 1.95
+
! Meaning
| <code>minecraft:zombie_pigman</code>
+
| rowspan="3" | 0
|-
+
|-
| 54
+
| 0x01
| PolarBear
+
| Is critical
| 1.3
+
|-
| 1.4
+
| 0x02
| <code>minecraft:polar_bear</code>
+
| Is noclip (used by loyalty tridents when returning)
|- style="background: #ffff88;"
+
|-
| 55
+
| {{Metadata id|}}
| PrimedTnt
+
| Byte
| 0.98
+
|colspan="2"| Piercing level
| 0.98
+
| 0
| <code>minecraft:tnt</code>
+
|}
|-
+
 
| 56
+
=== Arrow ===
| Rabbit
+
 
| 0.4
+
{{Metadata inherit|Arrow|inherits=Abstract Arrow}}
| 0.5
+
 
| <code>minecraft:rabbit</code>
+
Used for both tipped and regular arrows. If not tipped, then color is set to -1 and no tipped arrow particles are used.
|-
+
 
| 57
+
{| class="wikitable"
| Salmon
+
! Index
| ?
+
! Type
| ?
+
!style="width: 250px;" colspan="2"| Meaning
| <code>minecraft:salmon</code>
+
! Default
|-
+
|-
| 58
+
| {{Metadata id|}}
| Sheep
+
| VarInt
| 0.9
+
|colspan="2"| Color (-1 for no particles)
| 1.3
+
| -1
| <code>minecraft:sheep</code>
+
|}
|-
+
 
| 59
+
=== Spectral Arrow ===
| Shulker
+
 
| 1.0
+
{{Metadata inherit|Spectral Arrow|inherits=Abstract Arrow}}
| 1.0-2.0 (depending on peek)
+
 
| <code>minecraft:shulker</code>
+
No additional metadata.
|- style="background: #ffff88;"
+
 
| 60
+
=== Thrown Trident ===
| ShulkerBullet
+
 
| 0.3125
+
{{Metadata inherit|Thrown Trident|inherits=Abstract Arrow}}
| 0.3125
+
 
| <code>minecraft:shulker_bullet</code>
+
{| class="wikitable"
|-
+
! Index
| 61
+
! Type
| Silverfish
+
!style="width: 250px;" colspan="2"| Meaning
| 0.4
+
! Default
| 0.3
+
|-
| <code>minecraft:silverfish</code>
+
| {{Metadata id|}}
|-
+
| VarInt
| 62
+
|colspan="2"| Loyalty level (enchantment)
| Skeleton
+
| 0
| 0.6
+
|-
| 1.99
+
| {{Metadata id|}}
| <code>minecraft:skeleton</code>
+
| Boolean
|-
+
|colspan="2"| Has enchantment glint
| 63
+
| False
| SkeletonHorse
+
|}
| 1.3964844
+
 
| 1.6
+
=== Boat ===
| <code>minecraft:skeleton_horse</code>
+
 
|-
+
{{Metadata inherit|Boat|inherits=Entity}}
| 64 (67: 1.14)
+
 
| Slime
+
{| class="wikitable"
| 0.51000005 * size
+
! Index
| 0.51000005 * size
+
! Type
| <code>minecraft:slime</code>
+
!style="width: 250px;" colspan="2"| Meaning
|- style="background: #ffff88;"
+
! Default
| 65
+
|-
| SmallFireball (blaze)
+
| {{Metadata id|}}
| 0.3125
+
| VarInt
| 0.3125
+
|colspan="2"| Time since last hit
| <code>minecraft:small_fireball</code>
+
| 0
|-
+
|-
| 66
+
| {{Metadata id|}}
| SnowMan
+
| VarInt
| 0.7
+
|colspan="2"| Forward direction
| 1.9
+
| 1
| <code>minecraft:snow_golem</code>
+
|-
|- style="background: #ffff88;"
+
| {{Metadata id|}}
| 67
+
| Float
| Snowball
+
|colspan="2"| Damage taken
| 0.25
+
| 0.0
| 0.25
+
|-
| <code>minecraft:snowball</code>
+
| {{Metadata id|}}
|- style="background: #ffff88;"
+
| VarInt
| 68
+
|colspan="2"| Type (0=oak, 1=spruce, 2=birch, 3=jungle, 4=acacia, 5=dark oak)
| SpectralArrow
+
| 0
| 0.5
+
|-
| 0.5
+
| {{Metadata id|}}
| <code>minecraft:spectral_arrow</code>
+
| Boolean
|-
+
|colspan="2"| Is left paddle turning
| 69
+
| false
| Spider
+
|-
| 1.4
+
| {{Metadata id|}}
| 0.9
+
| Boolean
| <code>minecraft:spider</code>
+
|colspan="2"| Is right paddle turning
|-
+
| false
| 70
+
|-
| Squid
+
| {{Metadata id|}}
| 0.8
+
| VarInt
| 0.8
+
|colspan="2"| Splash timer
| <code>minecraft:squid</code>
+
| 0
|-
+
|}
| 71
+
 
| Stray
+
=== End Crystal ===
| 0.6
+
 
| 1.99
+
{{Metadata inherit|End Crystal|inherits=Entity}}
| <code>minecraft:stray</code>
+
 
|-
+
{| class="wikitable"
| 72
+
! Index
| Tropical Fish
+
! Type
| 0.5
+
!style="width: 250px;" colspan="2"| Meaning
| 0.4
+
! Default
| <code>minecraft:tropical_fish</code>
+
|-
|-
+
| {{Metadata id|}}
| 73
+
| OptBlockPos
| Turtle
+
|colspan="2"| Beam target
| 1.2
+
| Empty
| 0.4
+
|-
| <code>minecraft:turtle</code>
+
| {{Metadata id|}}
|- style="background: #ffff88;"
+
| Boolean
| 74
+
|colspan="2"| Show bottom
| ThrownEgg
+
| true
| 0.25
+
|}
| 0.25
+
 
| <code>minecraft:egg</code>
+
=== Dragon Fireball ===
|- style="background: #ffff88;"
+
 
| 75
+
{{Metadata inherit|Dragon Fireball|inherits=Entity}}
| ThrownEnderpearl
+
 
| 0.25
+
No additional metadata.
| 0.25
+
 
| <code>minecraft:ender_pearl</code>
+
=== Small Fireball ===
|- style="background: #ffff88;"
+
 
| 76
+
{{Metadata inherit|Small Fireball|inherits=Entity}}
| ThrownExpBottle
+
 
| 0.25
+
This is the fireball shot by blazes and dispensers with fire charges.
| 0.25
+
 
| <code>minecraft:experience_bottle</code>
+
{| class="wikitable"
|- style="background: #ffff88;"
+
! Index
| 77
+
! Type
| ThrownPotion
+
!style="width: 250px;" colspan="2"| Meaning
| 0.25
+
! Default
| 0.25
+
|-
| <code>minecraft:potion</code>
+
| {{Metadata id|}}
|-
+
| [[Slot]]
| 78
+
|colspan="2"| Item
| Vex
+
| Empty (which behaves as if it were a <code>minecraft:fire_charge</code>)
| 0.4
+
|}
| 0.8
+
 
| <code>minecraft:vex</code>
+
=== Fireball ===
|-
+
 
| 79
+
{{Metadata inherit|Fireball|inherits=Entity}}
| Villager
+
 
| 0.6
+
This is the large fireball shot by ghasts.
| 1.95
+
 
| <code>minecraft:villager</code>
+
{| class="wikitable"
|-
+
! Index
| 80
+
! Type
| VillagerGolem (Iron Golem)
+
!style="width: 250px;" colspan="2"| Meaning
| 1.4
+
! Default
| 2.7
+
|-
| <code>minecraft:iron_golem}</code>
+
| {{Metadata id|}}
|-
+
| [[Slot]]
| 81
+
|colspan="2"| Item
| VindicationIllager
+
| Empty
| 0.6
+
|}
| 1.95
+
 
| <code>minecraft:vindicator</code>
+
=== Wither Skull ===
|-
+
 
| 82
+
{{Metadata inherit|Wither Skull|inherits=Entity}}
| Witch
+
 
| 0.6
+
{| class="wikitable"
| 1.95
+
! Index
| <code>minecraft:witch</code>
+
! Type
|-
+
!style="width: 250px;" colspan="2"| Meaning
| 83
+
! Default
| WitherBoss
+
|-
| 0.9
+
| {{Metadata id|}}
| 3.5
+
| Boolean
| <code>minecraft:wither</code>
+
|colspan="2"| Is invulnerable
|-
+
| false
| 84
+
|}
| WitherSkeleton
+
 
| 0.7
+
=== Firework Rocket Entity ===
| 2.4
+
 
| <code>minecraft:wither_skeleton</code>
+
{{Metadata inherit|Firework Rocket Entity|inherits=Entity}}
|- style="background: #ffff88;"
+
 
| 85
+
{| class="wikitable"
| WitherSkull
+
! Index
| 0.3125
+
! Type
| 0.3125
+
!style="width: 250px;" colspan="2"| Meaning
| <code>minecraft:wither_skull</code>
+
! Default
|-
+
|-
| 86
+
| {{Metadata id|}}
| Wolf
+
| [[Slot]]
| 0.6
+
|colspan="2"| Firework info
| 0.85
+
| Empty
| <code>minecraft:wolf</code>
+
|-
|-
+
| {{Metadata id|}}
| 87
+
| OptVarInt
| Zombie
+
|colspan="2"| Entity ID of entity which used firework (for elytra boosting)
| 0.6
+
| Empty
| 1.95
+
|-
| <code>minecraft:zombie</code>
+
| {{Metadata id|}}
|-
+
| Boolean
| 88
+
|colspan="2"| Is shot at angle (from a crossbow)
| ZombieHorse
+
| false
| 1.3964844
+
|}
| 1.6
+
 
| <code>minecraft:zombie_horse</code>
+
=== Item Frame ===
|-
+
 
| 89
+
{{Metadata inherit|Item Frame|inherits=Entity}}
| ZombieVillager
+
 
| 0.6
+
{| class="wikitable"
| 1.95
+
! Index
| <code>minecraft:zombie_villager</code>
+
! Type
|-
+
!style="width: 250px;" colspan="2"| Meaning
| 90
+
! Default
| Phantom
+
|-
| 0.9
+
| {{Metadata id|}}
| 0.5
+
| [[Slot]]
| <code>minecraft:phantom</code>
+
|colspan="2"| Item
|- style="background: #aaaaff;"
+
| Empty
| 91
+
|-
| Lightning Bolt
+
| {{Metadata id|}}
| -
+
| VarInt
| -
+
|colspan="2"| Rotation
| <code>minecraft:lightning_bolt</code>
+
| 0
|- style="background: #aaaaff;"
+
|}
| 92
+
 
| Player
+
=== Item Entity ===
| 0.8
+
 
| 1.8
+
{{Metadata inherit|Item Entity|inherits=Entity}}
| <code>minecraft:player</code>
+
 
|- style="background: #ffff88;"
+
{| class="wikitable"
| 93
+
! Index
| Fishing bobber
+
! Type
| ?
+
!style="width: 250px;" colspan="2"| Meaning
| ?
+
! Default
| <code>minecraft:fishing_bobber</code>
+
|-
|- style="background: #ffff88;"
+
| {{Metadata id|}}
| 94
+
| [[Slot]]
| Trident
+
|colspan="2"| Item
| ?
+
| Empty
| ?
+
|}
| <code>minecraft:trident</code>
+
 
|}
+
=== Living Entity ===
 +
 
 +
{{Metadata inherit|Living Entity|inherits=Entity}}
 +
 
 +
{| class="wikitable"
 +
! Index
 +
! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
! Default
 +
|-
 +
|rowspan="5"| {{Metadata id|}}
 +
|rowspan="5"| Byte
 +
|colspan="2"| Hand states, used to trigger blocking/eating/drinking animation.
 +
|rowspan="5"| 0
 +
|-
 +
! Bit mask
 +
! Meaning
 +
|-
 +
| 0x01
 +
| Is hand active
 +
|-
 +
| 0x02
 +
| Active hand (0 = main hand, 1 = offhand)
 +
|-
 +
| 0x04
 +
| Is in riptide spin attack
 +
|-
 +
| {{Metadata id|}}
 +
| Float
 +
|colspan="2"| Health
 +
| 1.0
 +
|-
 +
| {{Metadata id|}}
 +
| VarInt
 +
|colspan="2"| Potion effect color (or 0 if there is no effect)
 +
| 0
 +
|-
 +
| {{Metadata id|}}
 +
| Boolean
 +
|colspan="2"| Is potion effect ambient: reduces the number of particles generated by potions to 1/5 the normal amount
 +
| false
 +
|-
 +
| {{Metadata id|}}
 +
| VarInt
 +
|colspan="2"| Number of arrows in entity
 +
| 0
 +
|-
 +
| {{Metadata id|}}
 +
| VarInt
 +
|colspan="2"| Health added by absorption (based on the AbsorptionAmount tag)
 +
| 0
 +
|-
 +
| {{Metadata id|}}
 +
| OptBlockPos
 +
|colspan="2"| Location of the bed that the entity is currently sleeping in (Empty if it isn't sleeping)
 +
| Empty
 +
|}
  
== Objects ==
+
=== Player ===
  
Objects are spawned via [[Protocol#Spawn_Object|Spawn Object]]. See [[Object Data]] for more details.
+
{{Metadata inherit|Player|inherits=Living Entity}}
 
 
{{Note|Object IDs and Entity IDs are different.  Most objects also have an entity ID, but should only ever be spawned via [[Protocol#Spawn_Object|Spawn Object]].}}
 
  
 
{| class="wikitable"
 
{| class="wikitable"
|-
+
! Index
! ID
+
! Type
! Name
+
!style="width: 250px;" colspan="2"| Meaning
! bounding box x and z
+
! Default
! bounding box y
+
|-
|-  
+
| {{Metadata id|}}
| 1
+
| Float
| Boat
+
|colspan="2"| Additional Hearts
| 1.375
+
| 0.0
| 0.6
+
|-
|-  
+
| {{Metadata id|}}
| 2
+
| VarInt
| Item Stack ([[Slot]])
+
|colspan="2"| Score
| 0.25
+
| 0
| 0.25
+
|-
|-  
+
|rowspan="10"| {{Metadata id|}}
| 3
+
|rowspan="10"| Byte
| Area Effect Cloud
+
|colspan="2"| The Displayed Skin Parts bit mask that is sent in [[Protocol#Client Settings|Client Settings]]
| 2.0 * Radius
+
|rowspan="10"| 0
| 0.5
+
|-
|-  
+
! Bit mask !! Meaning
| 10
+
|-
| Minecart
+
| 0x01 || Cape enabled
| 0.98
+
|-
| 0.7
+
| 0x02 || Jacket enabled
|-  
+
|-
| 50
+
| 0x04 || Left sleeve enabled
| Activated TNT
+
|-
| 0.98
+
| 0x08 || Right sleeve enabled
| 0.98
+
|-
|-  
+
| 0x10 || Left pants leg enabled
| 51
+
|-
| EnderCrystal
+
| 0x20 || Right pants leg enabled
| 2.0
+
|-
| 2.0
+
| 0x40 || Hat enabled
|-  
+
|-
| 60
+
| 0x80 || ''Unused''
| Tipped arrow (projectile; also used for regular arrows)
+
|-
| 0.5
+
| {{Metadata id|}}
| 0.5
+
| Byte
|-  
+
|colspan="2"| Main hand (0 : Left, 1 : Right)
| 61
+
| 1
| Snowball (projectile)
+
|-
| 0.25
+
| {{Metadata id|}}
| 0.25
+
| [[NBT]]
|-
+
|colspan="2"| Left shoulder entity data (for occupying parrot)
| 62
+
| Empty
| Egg (projectile)
+
|-
| 0.25
+
| {{Metadata id|}}
| 0.25
+
| [[NBT]]
|-
+
|colspan="2"| Right shoulder entity data (for occupying parrot)
| 63
+
| Empty
| FireBall (ghast projectile)
+
|}
| 1.0
+
 
| 1.0
+
=== Armor Stand ===
|-
+
 
| 64
+
{{Metadata inherit|Armor Stand|inherits=Living Entity}}
| FireCharge (blaze projectile)
+
 
| 0.3125
+
{| class="wikitable"
| 0.3125
+
! Index
|-
+
! Type
| 65
+
!style="width: 250px;" colspan="2"| Meaning
| Thrown Enderpearl
+
! Default
| 0.25
+
|-
| 0.25
+
|rowspan="5"| {{Metadata id|}}
|-  
+
|rowspan="5"| Byte
| 66
+
! Bit mask
| Wither Skull (projectile)
+
! Meaning
| 0.3125
+
|rowspan="5"| 0
| 0.3125
+
|-
|-  
+
| 0x01
| 67
+
| Is Small
| Shulker Bullet
+
|-
| 0.3125
+
| 0x04
| 0.3125
+
| Has Arms
|-
+
|-
| 68
+
| 0x08
| Llama spit
+
| Has no BasePlate
| 0.25
+
|-
| 0.25
+
| 0x10
|-
+
| Is Marker
| 70
+
|-
| Falling Objects
+
| {{Metadata id|}}
| 0.98
+
| Rotations
| 0.98
+
|colspan="2"| Head rotation
|-
+
| (0.0, 0.0, 0.0)
| 71
+
|-
| Item frames
+
| {{Metadata id|}}
| 0.75 or 0.0625
+
| Rotations
| 0.75
+
|colspan="2"| Body rotation
|-  
+
| (0.0, 0.0, 0.0)
| 72
+
|-
| Eye of Ender
+
| {{Metadata id|}}
| 0.25
+
| Rotations
| 0.25
+
|colspan="2"| Left arm rotation
|-  
+
| (-10.0, 0.0, -10.0)
| 73
+
|-
| Thrown Potion
+
| {{Metadata id|}}
| 0.25
+
| Rotations
| 0.25
+
|colspan="2"| Right arm rotation
|-  
+
| (-15.0, 0.0, 10.0)
| 75
+
|-
| Thrown Exp Bottle
+
| {{Metadata id|}}
| 0.25
+
| Rotations
| 0.25
+
|colspan="2"| Left leg rotation
|-  
+
| (-1.0, 0.0, -1.0)
| 76
+
|-
| Firework Rocket
+
| {{Metadata id|}}
| 0.25
+
| Rotations
| 0.25
+
|colspan="2"| Right leg rotation
|-  
+
| (1.0, 0.0, 1.0)
| 77
+
|}
| Leash Knot
+
 
| 0.375
+
Note that armor stands with the [[#Entity|invisible flag from the base entity class]] set also cannot be attacked or damaged, except for by the void.
| 0.5
+
 
|-
+
=== Mob ===
| 78
+
 
| ArmorStand
+
{{Metadata inherit|Mob|inherits=Living Entity}}
| normal: 0.5 marker: 0.0 small: 0.25
+
 
| normal: 1.975 marker: 0.0 small: 0.9875
+
{| class="wikitable"
|-
+
! Index
| 79
+
! Type
| Evocation Fangs
+
!style="width: 250px;" colspan="2"| Meaning
| 0.5
+
! Default
| 0.8
+
|-
|-  
+
|rowspan="4"| {{Metadata id|}}
| 90
+
|rowspan="4"| Byte
| Fishing Hook
+
! Bit mask
| 0.25
+
! Meaning
| 0.25
+
|rowspan="4"| 0
|-
+
|-
| 91
+
| 0x01
| Spectral Arrow
+
| NoAI
| 0.5
+
|-
| 0.5
+
| 0x02
|-  
+
| Is left handed
| 93
+
|-
| Dragon Fireball
+
| 0x04
| 1.0
+
| Is agressive
| 1.0
+
|-
|-
+
|}
| 94
 
| Trident
 
| ?
 
| ?
 
|}
 
  
Since release {{Minecraft Wiki|1.6}}, all minecarts are spawned with object type 10 and their functionality is then specified in the [[Object Data#Minecarts (id 10)|Data field]] within the packet. Also, their visual appearance may be sent via the [[Protocol#Entity Metadata|Entity Metadata]] packet.
+
=== Ambient Creature ===
  
== Entity Metadata Format ==
+
{{Metadata inherit|Ambient Creature|inherits=Mob}}
  
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.
+
No additional metadata.
  
Entity Metadata is an array of entries, each of which looks like the following:
+
=== Bat ===
 +
 
 +
{{Metadata inherit|Bat|inherits=Ambient Creature}}
  
 
{| class="wikitable"
 
{| class="wikitable"
  ! Name
+
  ! Index
 
  ! Type
 
  ! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
! Default
 +
|-
 +
| rowspan="2"| {{Metadata id|}}
 +
| rowspan="2"| Byte
 +
! Bit mask
 
  ! Meaning
 
  ! Meaning
 +
| rowspan="2"| 0
 
  |-
 
  |-
  | Index
+
  | 0x01
  | Unsigned Byte
+
  | Is hanging
| Unique index key determining the meaning of the following value, see the table below. If this is <code>0xff</code> 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 <code>0xff</code>; the type of the index, see the table below
 
|-
 
| Value
 
| Optional ''value of Type''
 
| Only if Index is not <code>0xff</code>: the value of the metadata field
 
 
  |}
 
  |}
  
{| class="wikitable"
+
=== Pathfinder Mob ===
  ! Value of Type field
+
 
  ! [[Data types|Type]] of Value field
+
{{Metadata inherit|Pathfinder Mob|inherits=Mob}}
  ! Notes
+
 
|-
+
No additional metadata.
  | 0
+
 
| Byte
+
=== Water Animal ===
|
+
 
 +
{{Metadata inherit|Water Animal|inherits=Pathfinder Mob}}
 +
 
 +
No additional metadata.
 +
 
 +
=== Squid ===
 +
 
 +
{{Metadata inherit|Squid|inherits=Water Animal}}
 +
 
 +
No additional metadata.
 +
 
 +
=== Dolphin ===
 +
 
 +
{{Metadata inherit|Dolphin|inherits=Water Animal}}
 +
 
 +
{| class="wikitable"
 +
  ! Index
 +
  ! Type
 +
  !style="width: 250px;" colspan="2"| Meaning
 +
  ! Default
 
  |-
 
  |-
  | 1
+
  | {{Metadata id|}}
  | VarInt
+
  | Position
  |
+
|colspan="2"| Treasure position
 +
  | (0, 0, 0)
 
  |-
 
  |-
  | 2
+
  | {{Metadata id|}}
  | Float
+
| Boolean
  |
+
  |colspan="2"| Can find treasure
 +
  | false
 
  |-
 
  |-
  | 3
+
  | {{Metadata id|}}
  | String
+
| Boolean
  |
+
  |colspan="2"| Has fish
 +
| false
 +
|}
 +
 
 +
=== Abstract fish ===
 +
 
 +
{{Metadata inherit|Abstract fish|inherits=Water Animal}}
 +
 
 +
{| class="wikitable"
 +
  ! Index
 +
! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
! Default
 
  |-
 
  |-
  | 4
+
  | {{Metadata id|}}
| [[Chat]]
 
|
 
|-
 
| 5
 
| OptChat (Boolean + Optional [[Chat]])
 
| [[Chat]] is present if the Boolean is set to true
 
|-
 
| 6
 
| [[Slot]]
 
|
 
|-
 
| 7
 
 
  | Boolean
 
  | Boolean
  |
+
  |colspan="2"| From bucket
|-
+
  | False
  | 8
+
  |}
  | Rotation
+
 
| 3 floats: rotation on x, rotation on y, rotation on z
+
=== Cod ===
|-
+
 
| 9
+
{{Metadata inherit|Cod|inherits=Abstract fish}}
| [[Data Types#Position|Position]]
+
 
|
+
No additional metadata.
|-
+
 
| 10
+
=== Puffer fish ===
| 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
 
| [[Data Types#Particle|Particle]]
 
|
 
|}
 
 
 
Entity classes also recursively inherit fields from classes they extend.
 
 
 
=== Entity ===
 
  
The base class.
+
{{Metadata inherit|Puffer fish|inherits=Abstract fish}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 1,810: Line 1,797:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  |rowspan="9"| 0
+
  | {{Metadata id|}}
  |rowspan="9"| Byte
+
| VarInt
  ! Bit mask
+
|colspan="2"| PuffState (varies from 0 to 2)
  ! Meaning
+
| 0
  |rowspan="9"| 0
+
  |}
 +
 
 +
=== Salmon ===
 +
 
 +
{{Metadata inherit|Salmon|inherits=Abstract fish}}
 +
 
 +
No additional metadata.
 +
 
 +
=== Tropical fish ===
 +
 
 +
{{Metadata inherit|Tropical fish|inherits=Abstract fish}}
 +
 
 +
{| class="wikitable"
 +
  ! Index
 +
  ! Type
 +
  !style="width: 250px;" colspan="2"| Meaning
 +
! Default
 
  |-
 
  |-
  | 0x01
+
  | {{Metadata id|}}
| On Fire
 
|-
 
| 0x02
 
| Crouched
 
|-
 
| 0x04
 
| Unused (previously riding)
 
|-
 
| 0x08
 
| Sprinting
 
|-
 
| 0x10
 
| Swimming
 
|-
 
| 0x20
 
| Invisible
 
|-
 
| 0x40
 
| Glowing effect
 
|-
 
| 0x80
 
| Flying with {{Minecraft Wiki|elytra}}
 
|-
 
| 1
 
 
  | VarInt
 
  | VarInt
  |colspan="2"| Air
+
  |colspan="2"| Variant
  | 300
+
  | 0
 +
|}
 +
 
 +
=== Ageable Mob ===
 +
 
 +
{{Metadata inherit|Ageable Mob|inherits=Pathfinder Mob}}
 +
 
 +
{| class="wikitable"
 +
! Index
 +
! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
! Default
 
  |-
 
  |-
  | 2
+
  | {{Metadata id|}}
| OptChat
 
|colspan="2"| Custom name
 
| empty
 
|-
 
| 3
 
 
  | Boolean
 
  | Boolean
  |colspan="2"| Is custom name visible
+
  |colspan="2"| Is baby
| false
 
|-
 
| 4
 
| Boolean
 
|colspan="2"| Is silent
 
| false
 
|-
 
| 5
 
| Boolean
 
|colspan="2"| No gravity
 
 
  | false
 
  | false
 
  |}
 
  |}
  
=== Throwable ===
+
=== Animal ===
 
 
Extends [[#Entity|Entity]].
 
 
 
No additional metadata.
 
 
 
=== Egg ===
 
 
 
Extends [[#Throwable|Throwable]].
 
 
 
No additional metadata.
 
 
 
=== Ender Pearl ===
 
  
Extends [[#Throwable|Throwable]].
+
{{Metadata inherit|Animal|inherits=Ageable Mob}}
  
 
No additional metadata.
 
No additional metadata.
  
=== Experience Bottle ===
+
=== Abstract Horse ===
 
 
Extends [[#Throwable|Throwable]].
 
  
No additional metadata.
+
{{Metadata inherit|Abstract Horse|inherits=Animal}}
 
 
=== Snowball ===
 
 
 
Extends [[#Throwable|Throwable]].
 
 
 
No additional metadata.
 
 
 
=== Potion ===
 
 
 
Extends [[#Throwable|Throwable]].
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 1,906: Line 1,857:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  |rowspan="9"| {{Metadata id|}}
  | [[Slot]]
+
  |rowspan="9"| Byte
  |colspan="2"| Potion which is thrown
+
! Bit mask
  | Empty
+
! Meaning
  |}
+
  |rowspan="9"| 0
 
+
|-
=== Eye of Ender ===
+
| 0x01
 
+
  | ''Unused''
Extends [[#Entity|Entity]].
+
  |-
 +
| 0x02
 +
| Is Tame
 +
|-
 +
| 0x04
 +
| Is saddled
 +
|-
 +
| 0x08
 +
| Has bred
 +
|-
 +
| 0x10
 +
| Is eating
 +
|-
 +
| 0x20
 +
| Is rearing (on hind legs)
 +
|-
 +
| 0x40
 +
| Is mouth open
 +
|-
 +
| 0x80
 +
| ''Unused''
 +
|-
 +
| {{Metadata id|}}
 +
| OptUUID
 +
|colspan="2"| Owner
 +
| Absent
 +
|}
  
No additional metadata.
+
=== Horse ===
  
=== FallingBlock ===
+
{{Metadata inherit|Horse|inherits=Abstract Horse}}
  
Extends [[#Entity|Entity]].
+
{| class="wikitable"  
 
 
{| class="wikitable"
 
 
  ! Index
 
  ! Index
 
  ! Type
 
  ! Type
Line 1,928: Line 1,903:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  | {{Metadata id|}}
  | [[Data Types#Position|Position]]
+
  | VarInt
  |colspan="2"| spawn position
+
  |colspan="2"| Variant (Color & Style)
  | (0, 0, 0)
+
  | 0
 
  |}
 
  |}
  
=== AreaEffectCloud ===
+
=== Zombie Horse ===
  
Extends [[#Entity|Entity]].
+
{{Metadata inherit|Zombie Horse|inherits=Abstract Horse}}
  
{| class="wikitable"
+
=== Skeleton Horse ===
 +
 
 +
{{Metadata inherit|Skeleton Horse|inherits=Abstract Horse}}
 +
 
 +
=== Chested Horse ===
 +
 
 +
{{Metadata inherit|Chested Horse|inherits=Abstract Horse}}
 +
 
 +
{| class="wikitable"  
 
  ! Index
 
  ! Index
 
  ! Type
 
  ! Type
Line 1,944: Line 1,927:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  | {{Metadata id|}}
| Float
 
|colspan="2"| Radius
 
| 0.5
 
|-
 
| 7
 
| VarInt
 
|colspan="2"| Color (only for mob spell particle)
 
| 0
 
|-
 
| 8
 
 
  | Boolean
 
  | Boolean
  |colspan="2"| Ignore radius and show effect as single point, not area
+
  |colspan="2"| Has Chest
 
  | false
 
  | false
|-
 
| 9
 
| Particle
 
| colspan="2"| The [[#Particle]]
 
| <code>effect</code>
 
 
  |}
 
  |}
  
=== FishingHook ===
+
=== Donkey ===
  
Extends [[#Entity|Entity]].
+
{{Metadata inherit|Donkey|inherits=Chested Horse}}
 +
 
 +
=== Llama ===
 +
 
 +
{{Metadata inherit|Llama|inherits=Chested Horse}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 1,975: Line 1,947:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  | {{Metadata id|}}
 
  | VarInt
 
  | VarInt
  |colspan="2"| Hooked entity id + 1, or 0 if there is no hooked entity
+
  | colspan="2"| Strength (number of columns of 3 slots in the llama's inventory once a chest is equipped)
 
  | 0
 
  | 0
  |}
+
  |-
 +
| {{Metadata id|}}
 +
| VarInt
 +
| colspan="2"| Carpet color (a dye color, or -1 if no carpet equipped)
 +
| -1
 +
|-
 +
| {{Metadata id|}}
 +
| VarInt
 +
| colspan="2"| Variant (0: <code>llama_creamy.png</code>, 1: <code>llama_white.png</code>, 2: <code>llama_brown.png</code>, 3: <code>llama_gray.png</code>)
 +
| 0
 +
|}
 +
 
 +
=== Trader Llama ===
 +
 
 +
{{Metadata inherit|Trader Llama|Llama}}
  
=== Arrow ===
+
No additional metadata.
 +
 
 +
=== Mule ===
 +
 
 +
{{Metadata inherit|Mule|inherits=Chested Horse}}
  
Extends [[#Entity|Entity]].
+
=== Bee ===
  
Abstract base class for [[#TippedArrow|TippedArrow]] (which is used for regular arrows as well as tipped ones) and Spectral Arrow.
+
{{Metadata inherit|Bee|inherits=Animal}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 1,993: Line 1,983:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | rowspan="3" | 6
+
  |rowspan="5"| {{Metadata id|}}
  | rowspan="3" | Byte
+
  |rowspan="5"| Byte
  ! Bit mask
+
  |colspan="2"| Flags
! Meaning
+
  |rowspan="5"| 0
  | rowspan="3" | 0
+
|-
 +
| 0x01 || ''Unused''
 +
|-
 +
| 0x02 || Is angry
 
  |-
 
  |-
  | 0x01
+
  | 0x04 || Has stung
| Is critical
 
 
  |-
 
  |-
  | 0x02
+
  | 0x08 || Has nectar
| Is noclip (used by loyalty tridents when returning)
 
 
  |-
 
  |-
  | 7
+
  | {{Metadata id|}}
  | OptUUID
+
  | VarInt
  |colspan="2"| Shooter UUID
+
  | colspan="2"| Anger time in ticks
  | Empty
+
  | 0 (Not angry)
 
  |}
 
  |}
  
=== TippedArrow ===
+
=== Fox ===
  
Extends [[#Arrow|Arrow]].
+
{{Metadata inherit|Fox|inherits=Animal}}
 
 
Used for both tipped and regular arrows.  If not tipped, then color is set to -1 and no tipped arrow particles are used.
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,023: Line 2,012:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 8
+
  | {{Metadata id|}}
 
  | VarInt
 
  | VarInt
  |colspan="2"| Color (-1 for no particles)
+
  | colspan="2" | Type (0: red, 1: snow)
  | -1
+
| 0 (red)
 +
|-
 +
| rowspan="9" | {{Metadata id|}}
 +
| rowspan="9" | Byte
 +
! Bit mask
 +
! Meaning
 +
| rowspan="9" | 0
 +
|-
 +
| 0x01 || Is sitting
 +
|-
 +
| 0x02 || ''Unused''
 +
|-
 +
| 0x04 || Is crouching
 +
|-
 +
| 0x08 || Is interested
 +
|-
 +
| 0x10 || Is pouncing
 +
|-
 +
| 0x20 || Is sleeping
 +
|-
 +
| 0x40 || Is faceplanted
 +
|-
 +
| 0x80 || Is defending
 +
|-
 +
| {{Metadata id|}}
 +
| OptUUID
 +
| colspan="2" | First UUID (in <code>UUIDs</code> NBT)?
 +
| Absent
 +
  |-
 +
| {{Metadata id|}}
 +
| OptUUID
 +
| colspan="2" | Second UUID (in <code>UUIDs</code> NBT)?
 +
| Absent
 
  |}
 
  |}
  
=== Trident ===
+
=== Ocelot ===
  
Extends [[#Arrow|Arrow]].
+
{{Metadata inherit|Ocelot|inherits=Animal}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,039: Line 2,060:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 8
+
  | {{Metadata id|}}
  | VarInt
+
  | Boolean
  |colspan="2"| Loyalty level (enchantment)
+
  |colspan="2"| Is trusting
  | 0
+
  | false
  |}
+
  |}
  
=== Boat ===
+
=== Panda ===
  
Extends [[#Entity|Entity]].
+
{{Metadata inherit|Panda|inherits=Animal}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,055: Line 2,076:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  | {{Metadata id|}}
  | VarInt
+
  | Integer
  |colspan="2"| Time since last hit
+
  |colspan="2"| 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 <code>entity.panda.cant_breed</code> sound event.
 
  | 0
 
  | 0
 
  |-
 
  |-
  | 7
+
  | {{Metadata id|}}
  | VarInt
+
  | Integer
  |colspan="2"| Forward direction
+
  |colspan="2"| Sneeze timer.  Counts up from 0; when it hits 1 the <code>entity.panda.pre_sneeze</code> event plays and when it hits 21 the <code>entity.panda.sneeze</code> event plays (and it is set back to 0 and the sneeze flag is cleared).
  | 1
+
  | 0
 
  |-
 
  |-
  | 8
+
  | {{Metadata id|}}
  | Float
+
  | Integer
  |colspan="2"| Damage taken
+
  |colspan="2"| Eat timer.  If nonzero, counts upwards.
  | 0.0
+
  | 0
 
  |-
 
  |-
  | 9
+
  | {{Metadata id|}}
  | VarInt
+
  | Byte
  |colspan="2"| Type (0=oak, 1=spruce, 2=birch, 3=jungle, 4=acacia, 5=dark oak)
+
  |colspan="2"| Main Gene
 
  | 0
 
  | 0
 
  |-
 
  |-
  | 10
+
  | {{Metadata id|}}
  | Boolean
+
  | Byte
  |colspan="2"| Left paddle turning
+
  |colspan="2"| Hidden Gene
  | false
+
  | 0
 
  |-
 
  |-
  | 11
+
  |rowspan="6"| {{Metadata id|}}
  | Boolean
+
  |rowspan="6"| Byte
  |colspan="2"| Right paddle turning
+
! Bit mask
  | false
+
! Meaning
 +
  |rowspan="6"| 0
 +
|-
 +
| 0x01
 +
| Unused
 +
|-
 +
| 0x02
 +
| Is sneezing
 +
|-
 +
| 0x04
 +
| Is rolling
 +
|-
 +
| 0x08
 +
  | Is sitting
 
  |-
 
  |-
  | 12
+
  | 0x10
  | VarInt
+
  | Is on back
|colspan="2"| Splash timer
 
| 0
 
 
  |}
 
  |}
  
=== EnderCrystal ===
+
=== Pig ===
  
Extends [[#Entity|Entity]].
+
{{Metadata inherit|Pig|inherits=Animal}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,101: Line 2,133:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  | {{Metadata id|}}
  | OptPosition
+
  | Boolean
  |colspan="2"| Beam target
+
  |colspan="2"| Has saddle
  | Absent
+
  | false
 
  |-
 
  |-
  | 7
+
  | {{Metadata id|}}
  | Boolean
+
  | VarInt
  |colspan="2"| Show bottom
+
  |colspan="2"| Total time to "boost" with a carrot on a stick for
  | true
+
  | 0
 
  |}
 
  |}
  
=== Abstract Fireball ===
+
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.
  
Extends [[#Entity|Entity]].
+
=== Rabbit ===
 
 
No additional metadata.
 
 
 
=== Dragon Fireball ===
 
 
 
Extends [[#Abstract Fireball|Abstract Fireball]].
 
  
No additional metadata.
+
{{Metadata inherit|Rabbit|inherits=Animal}}
 
 
=== Fireball ===
 
 
 
Extends [[#Abstract Fireball|Abstract Fireball]].  This is the large fireball shot by ghasts.
 
 
 
No additional metadata.
 
 
 
=== Small Fireball ===
 
 
 
Extends [[#Abstract Fireball|Abstract Fireball]].  This is the fireball shot by blazes and dispensers with fire charges.
 
 
 
No additional metadata.
 
 
 
=== WitherSkull ===
 
 
 
Extends [[#Abstract Fireball|Abstract Fireball]].
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,146: Line 2,156:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  | {{Metadata id|}}
  | Boolean
+
  | VarInt
  |colspan="2"| Invulnerable
+
  |colspan="2"| Type
  | false
+
  | 0
 
  |}
 
  |}
  
=== Fireworks ===
+
=== Turtle ===
  
Extends [[#Entity|Entity]].
+
{{Metadata inherit|Turtle|inherits=Animal}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,162: Line 2,172:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  | {{Metadata id|}}
  | [[Slot]]
+
| BlockPos
  |colspan="2"| Firework info
+
|colspan="2"| Home pos
  | empty
+
| (0, 0, 0)
 +
|-
 +
| {{Metadata id|}}
 +
| Boolean
 +
|colspan="2"| Has egg
 +
| false
 +
|-
 +
| {{Metadata id|}}
 +
| Boolean
 +
|colspan="2"| Is laying egg
 +
| false
 +
|-
 +
| {{Metadata id|}}
 +
| BlockPos
 +
|colspan="2"| Travel pos
 +
| (0, 0, 0)
 +
|-
 +
| {{Metadata id|}}
 +
  | Boolean
 +
  |colspan="2"| Is going home
 +
  | false
 
  |-
 
  |-
  | 7
+
  | {{Metadata id|}}
  | VarInt
+
  | Boolean
  |colspan="2"| Entity ID of entity which used firework (for elytra boosting)
+
  |colspan="2"| Is traveling
  | 0
+
  | false
 
  |}
 
  |}
  
=== Hanging ===
+
=== Polar Bear ===
  
Extends [[#Entity|Entity]].
+
{{Metadata inherit|Polar Bear|inherits=Animal}}
 
 
No additional metadata.
 
 
 
=== ItemFrame ===
 
 
 
Extends [[#Hanging|Hanging]].
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,189: Line 2,213:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  | {{Metadata id|}}
  | [[Slot]]
+
  | Boolean
  |colspan="2"| Item
+
  |colspan="2"| Is standing up
  | Empty
+
| false
 +
|}
 +
 
 +
=== Chicken ===
 +
 
 +
{{Metadata inherit|Chicken|inherits=Animal}}
 +
 
 +
No additional metadata.
 +
 
 +
=== Cow ===
 +
 
 +
{{Metadata inherit|Cow|inherits=Animal}}
 +
 
 +
No additional metadata.
 +
 
 +
=== Hoglin ===
 +
 
 +
{{Metadata inherit|Hoglin|inherits=Animal}}
 +
 
 +
{| class="wikitable"
 +
  ! Index
 +
! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
! Default
 
  |-
 
  |-
  | 7
+
  | {{Metadata id|}}
  | VarInt
+
  | Boolean
  |colspan="2"| Rotation
+
  |colspan="2"| Is immune to zombification
  | 0
+
  | false
 
  |}
 
  |}
 +
 +
=== Mooshroom ===
  
=== Item ===
+
{{Metadata inherit|Mooshroom|inherits=Cow}}
 
 
Extends [[#Entity|Entity]].
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,210: Line 2,257:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  | {{Metadata id|}}
  | [[Slot]]
+
  | String
  |colspan="2"| Item
+
  | colspan="2"| Variant ("red" or "brown")
  | Empty
+
  | red
 
  |}
 
  |}
  
=== Living ===
+
=== Sheep ===
  
Extends [[#Entity|Entity]].
+
{{Metadata inherit|Sheep|inherits=Animal}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,226: Line 2,273:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  |rowspan="5"| 6
+
  |rowspan="3"| {{Metadata id|}}
  |rowspan="5"| Byte
+
  |rowspan="3"| Byte
|colspan="2"| Hand states, used to trigger blocking/eating/drinking animation.
 
|rowspan="5"| 0
 
|-
 
 
  ! Bit mask
 
  ! Bit mask
 
  ! Meaning
 
  ! Meaning
 +
|rowspan="3"| 0
 
  |-
 
  |-
  | 0x01
+
  | 0x0F
  | Is hand active
+
  | Color ID
 
  |-
 
  |-
  | 0x02
+
  | 0x10
  | Active hand (0 = main hand, 1 = offhand)
+
  | Is sheared
|-
 
| 0x04
 
| In riptide spin attack
 
|-
 
| 7
 
| Float
 
|colspan="2"| Health
 
| 1.0
 
|-
 
| 8
 
| VarInt
 
|colspan="2"| Potion effect color (or 0 if there is no effect)
 
| 0
 
|-
 
| 9
 
| Boolean
 
|colspan="2"| Is potion effect ambient: reduces the number of particles generated by potions to 1/5 the normal amount
 
| false
 
|-
 
| 10
 
| VarInt
 
|colspan="2"| Number of arrows in entity
 
| 0
 
 
  |}
 
  |}
 +
 +
=== Strider ===
  
=== Player ===
+
{{Metadata inherit|Strider|inherits=Animal}}
 
 
Extends [[#Living|Living]].
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,274: Line 2,296:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 11
+
  | {{Metadata id|}}
| Float
 
|colspan="2"| Additional Hearts
 
| 0.0
 
|-
 
| 12
 
 
  | VarInt
 
  | VarInt
  |colspan="2"| Score
+
  |colspan="2"| Total time to "boost" with warped fungus on a stick for
 
  | 0
 
  | 0
 
  |-
 
  |-
  |rowspan="10"| 13
+
  | {{Metadata id|}}
  |rowspan="10"| Byte
+
  | Boolean
  |colspan="2"| The Displayed Skin Parts bit mask that is sent in [[Protocol#Client Settings|Client Settings]]
+
  |colspan="2"| Is shaking (true unless riding a vehicle or on or in a block tagged with strider_warm_blocks (default: lava))
  |rowspan="10"| 0
+
  | false
 
  |-
 
  |-
  ! Bit mask !! Meaning
+
| {{Metadata id|}}
 +
| Boolean
 +
|colspan="2"| Has saddle
 +
| false
 +
|}
 +
 
 +
=== Tameable Animal ===
 +
 
 +
{{Metadata inherit|Tameable Animal|inherits=Animal}}
 +
 
 +
{| class="wikitable"
 +
  ! Index
 +
! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
! Default
 
  |-
 
  |-
  | 0x01 || Cape enabled
+
  |rowspan="4"| {{Metadata id|}}
 +
|rowspan="4"| Byte
 +
! Bit mask
 +
! Meaning
 +
|rowspan="4"| 0
 
  |-
 
  |-
  | 0x02 || Jacket enabled
+
  | 0x01
 +
| Is sitting
 
  |-
 
  |-
  | 0x04 || Left sleeve enabled
+
  | 0x02
 +
| ''Unused''
 
  |-
 
  |-
  | 0x08 || Right sleeve enabled
+
  | 0x04
 +
| Is tamed
 
  |-
 
  |-
  | 0x10 || Left pants leg enabled
+
  | {{Metadata id|}}
|-
+
  | OptUUID
| 0x20 || Right pants leg enabled
+
  |colspan="2"| Owner
|-
+
  | Absent
| 0x40 || Hat enabled
 
|-
 
| 0x80 || ''Unused''
 
|-
 
| 14
 
| Byte
 
|colspan="2"| Main hand (0 : Left, 1 : Right)
 
| 1
 
|-
 
| 15
 
| [[NBT]]
 
|colspan="2"| Left shoulder entity data (for occupying parrot)
 
| Empty
 
|-
 
| 16
 
  | [[NBT]]
 
  |colspan="2"| Right shoulder entity data (for occupying parrot)
 
  | Empty
 
 
  |}
 
  |}
  
=== ArmorStand ===
+
=== Cat ===
  
Extends [[#Living|Living]].
+
{{Metadata inherit|Cat|inherits=Tameable Animal}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,333: Line 2,353:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  |rowspan="5"| 11
+
  | {{Metadata id|}}
  |rowspan="5"| Byte
+
| VarInt
  ! Bit mask
+
|colspan="2"| Type (0 = tabby, 1 = black, 2 = red, 3 = siamese, 4 = british_shorthair, 5 = calico, 6 = persian, 7 = ragdoll, 8 = white, 9 = jellie, 10 = all_black)
  ! Meaning
+
  | 1
  |rowspan="5"| 0
+
|-
 +
  | {{Metadata id|}}
 +
  | Boolean
 +
  |colspan="2"| Is lying
 +
| false
 
  |-
 
  |-
  | 0x01
+
  | {{Metadata id|}}
  | is Small
+
| Boolean
 +
|colspan="2"| Is relaxed? (This makes their head go slightly upwards, unknown when used)
 +
  | false
 
  |-
 
  |-
  | 0x04
+
  | {{Metadata id|}}
  | has Arms
+
| VarInt
 +
|colspan="2"| Collar color (values are those {{Minecraft Wiki|Data_values#Dyes|used with dyes}})
 +
| 14 (Red)
 +
  |}
 +
 
 +
=== Wolf ===
 +
 
 +
{{Metadata inherit|Wolf|inherits=Tameable Animal}}
 +
 
 +
{| class="wikitable"
 +
! Index
 +
! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
! Default
 
  |-
 
  |-
  | 0x08
+
  | {{Metadata id|}}
  | no BasePlate
+
| Boolean
 +
|colspan="2"| Is begging
 +
  | false
 
  |-
 
  |-
  | 0x10
+
  | {{Metadata id|}}
  | set Marker
+
| VarInt
 +
|colspan="2"| Collar color (values are those {{Minecraft Wiki|Data_values#Dyes|used with dyes}})
 +
  | 14 (Red)
 
  |-
 
  |-
  | 12
+
  | {{Metadata id|}}
| Rotation
+
  | VarInt
|colspan="2"| Head rotation
+
  |colspan="2"| Anger time
| (0.0, 0.0, 0.0)
+
  | 0
|-
+
  |}
| 13
 
| Rotation
 
|colspan="2"| Body rotation
 
  | (0.0, 0.0, 0.0)
 
|-
 
| 14
 
| Rotation
 
  |colspan="2"| Left arm rotation
 
| (-10.0, 0.0, -10.0)
 
|-
 
| 15
 
  | Rotation
 
|colspan="2"| Right arm rotation
 
| (-15.0, 0.0, 10.0)
 
|-
 
| 16
 
| Rotation
 
|colspan="2"| Left leg rotation
 
| (-1.0, 0.0, -1.0)
 
|-
 
| 17
 
| Rotation
 
|colspan="2"| Right leg rotation
 
| (1.0, 0.0, 1.0)
 
  |}
 
  
Note that armor stands with the [[#Entity|invisible flag from the base entity class]] set also cannot be attacked or damaged, except for by the void.
+
=== Parrot ===
 
 
=== Insentient ===
 
  
Extends [[#Living|Living]].
+
{{Metadata inherit|Parrot|inherits=Tameable Animal}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,394: Line 2,410:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  |rowspan="3"| 11
+
  | {{Metadata id|}}
  |rowspan="3"| Byte
+
  | VarInt
! Bit mask
+
  |colspan="2"| Variant (0: red/blue, 1: blue, 2: green, 3: yellow/blue, 4: grey)
! Meaning
+
  | 0
  |rowspan="3"| 0
 
  |-
 
| 0x01
 
| NoAI
 
|-
 
| 0x02
 
| Left handed
 
 
  |}
 
  |}
  
=== Ambient ===
+
=== Abstract Villager ===
  
Extends [[#Insentient|Insentient]].
+
{{Metadata inherit|Abstract Villager|inherits=Ageable Mob}}
  
No additional metadata.
+
{| class="wikitable"
 +
! Index
 +
! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
! Default
 +
|-
 +
| {{Metadata id|}}
 +
| VarInt
 +
|colspan="2"| Head shake timer (starts at 40, decrements each tick)
 +
| 0
 +
|}
  
=== Bat ===
+
=== Villager ===
  
Extends [[#Ambient|Ambient]].
+
{{Metadata inherit|Villager|inherits=Abstract Villager}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,423: Line 2,442:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | rowspan="2"| 12
+
  | {{Metadata id|}}
  | rowspan="2"| Byte
+
  | Villager Data
! Bit mask
+
  |colspan="2"| Villager Data
! Meaning
+
  | Plains/None/1
  | rowspan="2"| 0
 
|-
 
| 0x01
 
  | Is hanging
 
 
  |}
 
  |}
  
=== Creature ===
+
=== Wandering Trader ===
 
 
Extends [[#Insentient|Insentient]].
 
 
 
No additional metadata.
 
 
 
=== WaterMob ===
 
  
Extends [[#Creature|Creature]].
+
{{Metadata inherit|Wandering Trader|inherits=Abstract Villager}}
  
 
No additional metadata.
 
No additional metadata.
  
=== Squid ===
+
=== Abstract Golem ===
  
Extends [[#WaterMob|WaterMob]]
+
{{Metadata inherit|Abstract Golem|inherits=Pathfinder Mob}}
  
 
No additional metadata.
 
No additional metadata.
  
=== Dolphin ===
+
=== Iron Golem ===
  
Extends [[#WaterMob|WaterMob]].
+
{{Metadata inherit|Iron Golem|inherits=Abstract Golem}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,461: Line 2,470:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 12
+
  |rowspan="2"| {{Metadata id|}}
| Position
+
  |rowspan="2"| Byte
  |colspan="2"| Treasure position
+
! Bit mask
  | (0, 0, 0)
+
! Meaning
 +
  |rowspan="2"| 0
 
  |-
 
  |-
  | 13
+
  | 0x01
| Boolean
+
  | Is player-created
|colspan="2"| Can find treasure
 
| false
 
  |-
 
| 14
 
| Boolean
 
|colspan="2"| Has fish
 
| false
 
 
  |}
 
  |}
  
=== Abstract fish ===
+
=== Snow Golem ===
  
Extends [[#WaterMob|WaterMob]].
+
{{Metadata inherit|Snow Golem|inherits=Abstract Golem}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,487: Line 2,490:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 12
+
  |rowspan="3"| {{Metadata id|}}
  | Boolean
+
  |rowspan="3"| Byte
  |colspan="2"| From bucket
+
! Bit mask
  | False
+
! Meaning
 +
  |rowspan="3"| 0x10
 +
|-
 +
| 0x00
 +
| Has no pumpkin hat
 +
|-
 +
| 0x10
 +
  | Has pumpkin hat
 
  |}
 
  |}
  
=== Cod ===
+
=== Shulker ===
  
Extends [[#AbstractFish|AbstractFish]].
+
{{Metadata inherit|Shulker|inherits=Abstract Golem}}
  
No additional metadata.
+
{| class="wikitable"
 
 
=== Puffer fish ===
 
 
 
Extends [[#AbstractFish|AbstractFish]].
 
 
 
{| class="wikitable"
 
 
  ! Index
 
  ! Index
 
  ! Type
 
  ! Type
Line 2,509: Line 2,513:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 13
+
  | {{Metadata id|}}
  | VarInt
+
  | Direction
  |colspan="2"| PuffState (varies from 0 to 2)
+
  |colspan="2"| Attach face
 +
| Down (0)
 +
|-
 +
| {{Metadata id|}}
 +
| OptPosition
 +
|colspan="2"| Attachment position
 +
| Absent
 +
|-
 +
| {{Metadata id|}}
 +
| Byte
 +
|colspan="2"| Shield height
 
  | 0
 
  | 0
 +
|-
 +
| {{Metadata id|}}
 +
| Byte
 +
| colspan="2"| Color (dye color)
 +
| 10 (purple)
 
  |}
 
  |}
  
=== Salmon ===
+
=== Monster ===
  
Extends [[#AbstractFish|AbstractFish]].
+
{{Metadata inherit|Monster|inherits=Pathfinder Mob}}
  
 
No additional metadata.
 
No additional metadata.
  
=== Tropical fish ===
+
=== Base Piglin ===
  
Extends [[#AbstractFish|AbstractFish]].
+
{{Metadata inherit|Base Piglin|inherits=Monster}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,531: Line 2,550:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 13
+
  | {{Metadata id|}}
  | VarInt
+
  | Boolean
  |colspan="2"| Variant
+
  |colspan="2"| Is immune to zombification
  | 0
+
  | false
 
  |}
 
  |}
 +
 +
=== Piglin ===
  
 
+
{{Metadata inherit|Piglin|inherits=Base Piglin}}
=== Ageable ===
 
 
 
Extends [[#Creature|Creature]].
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,548: Line 2,566:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 12
+
  | {{Metadata id|}}
 
  | Boolean
 
  | Boolean
 
  |colspan="2"| Is baby
 
  |colspan="2"| Is baby
 +
| false
 +
|-
 +
| {{Metadata id|}}
 +
| Boolean
 +
|colspan="2"| Is charging crossbow
 +
| false
 +
|-
 +
| {{Metadata id|}}
 +
| Boolean
 +
|colspan="2"| Is dancing
 
  | false
 
  | false
 
  |}
 
  |}
 +
 +
=== Piglin Brute ===
  
=== Animal ===
+
{{Metadata inherit|Piglin Brute|inherits=Base Piglin}}
 
 
Extends [[#Ageable|Ageable]].
 
  
 
No additional metadata.
 
No additional metadata.
  
=== AbstractHorse ===
 
  
Extends [[#Animal|Animal]].
+
=== Blaze ===
 +
 
 +
{{Metadata inherit|Blaze|inherits=Monster}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,570: Line 2,599:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  |rowspan="9"| 13
+
  |rowspan="2"| {{Metadata id|}}
  |rowspan="9"| Byte
+
  |rowspan="2"| Byte
 
  ! Bit mask
 
  ! Bit mask
 
  ! Meaning
 
  ! Meaning
  |rowspan="9"| 0
+
  |rowspan="2"| 0
 
  |-
 
  |-
 
  | 0x01
 
  | 0x01
  | ''Unused''
+
  | Is on fire
 +
|}
 +
 
 +
=== Creeper ===
 +
 
 +
{{Metadata inherit|Creeper|inherits=Monster}}
 +
 
 +
{| class="wikitable"
 +
! Index
 +
! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
! Default
 
  |-
 
  |-
  | 0x02
+
  | {{Metadata id|}}
  | Is Tame
+
| VarInt
 +
|colspan="2"| State (-1 = idle, 1 = fuse)
 +
  | -1
 
  |-
 
  |-
  | 0x04
+
  | {{Metadata id|}}
  | Is saddled
+
  | Boolean
 +
|colspan="2"| Is {{Minecraft Wiki|Creeper#Charged Creeper|charged}}
 +
| false
 
  |-
 
  |-
  | 0x08
+
  | {{Metadata id|}}
| Has bred
+
  | Boolean
|-
+
  |colspan="2"| Is ignited
| 0x10
+
  | false
| Is eating
 
|-
 
| 0x20
 
| Is rearing (on hind legs)
 
|-
 
| 0x40
 
| Is mouth open
 
|-
 
| 0x80
 
| ''Unused''
 
|-
 
| 14
 
  | OptUUID
 
  |colspan="2"| Owner
 
  | Absent
 
 
  |}
 
  |}
  
=== Horse ===
+
=== Endermite ===
 +
 
 +
{{Metadata inherit|Endermite|inherits=Monster}}
 +
 
 +
No additional metadata.
 +
 
 +
=== Giant ===
  
Extends [[#AbstractHorse|AbstractHorse]].
+
{{Metadata inherit|Giant|inherits=Monster}}
  
{| class="wikitable"  
+
No additional metadata.
  ! Index
+
 
  ! Type
+
=== Guardian ===
  !style="width: 250px;" colspan="2"| Meaning
+
 
  ! Default
+
{{Metadata inherit|Guardian|inherits=Monster}}
 +
 
 +
{| class="wikitable"
 +
  ! Index
 +
  ! Type
 +
  !style="width: 250px;" colspan="2"| Meaning
 +
  ! Default
 +
|-
 +
| {{Metadata id|}}
 +
| Boolean
 +
|colspan="2"| Is retracting spikes
 +
| false
 
  |-
 
  |-
  | 15
+
  | {{Metadata id|}}
 
  | VarInt
 
  | VarInt
  |colspan="2"| Variant (Color & Style)
+
  |colspan="2"| Target EID
 
  | 0
 
  | 0
|-
 
| 16
 
| VarInt
 
|colspan="2"| Armor (0: none, 1: iron, 2: gold, 3: diamond)
 
| 0 (none)
 
|-
 
| 17
 
| [[Slot]]
 
|colspan="2"| Armor Item (Forge only)
 
| Empty
 
 
  |}
 
  |}
  
=== ZombieHorse ===
+
=== Elder Guardian ===
  
Extends [[#AbstractHorse|AbstractHorse]].
+
{{Metadata inherit|Elder Guardian|inherits=Guardian}}
  
=== SkeletonHorse ===
+
=== Silverfish ===
 +
 
 +
{{Metadata inherit|Silverfish|inherits=Monster}}
  
Extends [[#AbstractHorse|AbstractHorse]].
+
No additional metadata.
  
=== ChestedHorse ===
+
=== Raider ===
  
Extends [[#AbstractHorse|AbstractHorse]].
+
{{Metadata inherit|Raider|inherits=Monster}}
  
{| class="wikitable"  
+
{| class="wikitable"
 
  ! Index
 
  ! Index
 
  ! Type
 
  ! Type
Line 2,650: Line 2,688:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 15
+
  | {{Metadata id|}}
  | Boolean
+
  | boolean
  |colspan="2"| Has Chest
+
  | colspan="2"| Is celebrating
 
  | false
 
  | false
 
  |}
 
  |}
  
=== Donkey ===
+
"Is celebrating" appears to control the pose for vindicators and does not appear to be used by other types.
  
Extends [[#ChestedHorse|ChestedHorse]].
+
=== Abstract Illager ===
 +
 
 +
{{Metadata inherit|Abstract Illager|inherits=Raider}}
 +
 
 +
No additional metadata.
 +
 
 +
=== Vindicator ===
 +
 
 +
{{Metadata inherit|Vindicator|inherits=Abstract Illager}}
 +
 
 +
=== Pillager ===
 +
 
 +
{{Metadata inherit|Pillager|inherits=Abstract Illager}}
  
=== Llama ===
+
=== Spellcaster Illager ===
  
Extends [[#ChestedHorse|ChestedHorse]].
+
{{Metadata inherit|Spellcaster Illager|inherits=Abstract Illager}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,670: Line 2,720:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 16
+
  | {{Metadata id|}}
| VarInt
+
  | Byte
| colspan="2"| Strength (number of columns of 3 slots in the llama's inventory once a chest is equipped)
+
  | colspan="2"| Spell (0: none, 1: summon vex, 2: attack, 3: wololo, 4: disappear, 5: blindness)
| 0
 
|-
 
| 17
 
| VarInt
 
| colspan="2"| Carpet color (a dye color, or -1 if no carpet equipped)
 
| -1
 
  |-
 
| 18
 
| VarInt
 
  | colspan="2"| Variant (0: <code>llama_creamy.png</code>, 1: <code>llama_white.png</code>, 2: <code>llama_brown.png</code>, 3: <code>llama_gray.png</code>)
 
 
  | 0
 
  | 0
 
  |}
 
  |}
  
=== Mule ===
+
=== Evoker ===
 +
 
 +
{{Metadata inherit|Evoker|inherits=Spellcaster Illager}}
 +
 
 +
=== Illusioner ===
  
Extends [[#ChestedHorse|ChestedHorse]].
+
{{Metadata inherit|Illusioner|inherits=Spellcaster Illager}}
  
=== Pig ===
+
=== Ravager ===
  
Extends [[#Animal|Animal]].
+
{{Metadata inherit|Ravager|inherits=Raider}}
  
{| class="wikitable"
+
No additional metadata.
  ! Index
+
 
  ! Type
+
=== Witch ===
 +
 
 +
{{Metadata inherit|Witch|inherits=Raider}}
 +
 
 +
{| class="wikitable"
 +
  ! Index
 +
  ! Type
 
  !style="width: 250px;" colspan="2"| Meaning
 
  !style="width: 250px;" colspan="2"| Meaning
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 13
+
  | {{Metadata id|}}
 
  | Boolean
 
  | Boolean
  |colspan="2"| Has saddle
+
  |colspan="2"| Is drinking potion
 
  | false
 
  | false
|-
 
| 14
 
| VarInt
 
|colspan="2"| 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.
+
=== Evoker Fangs ===
 +
 
 +
{{Metadata inherit|Evoker Fangs|inherits=Entity}}
 +
 
 +
No additional metadata.
  
=== Rabbit ===
+
=== Vex ===
  
Extends [[#Animal|Animal]].
+
{{Metadata inherit|Vex|inherits=Monster}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,723: Line 2,772:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 13
+
  |rowspan="2"| {{Metadata id|}}
  | VarInt
+
  |rowspan="2"| Byte
  |colspan="2"| Type
+
! Bit mask
  | 0
+
! Meaning
 +
  |rowspan="2"| 0
 +
  |-
 +
| 0x01
 +
| Is attacking
 
  |}
 
  |}
  
=== Turtle ===
+
=== Abstract Skeleton ===
 +
 
 +
{{Metadata inherit|Abstract Skeleton|inherits=Monster}}
  
Extends [[#Animal|Animal]].
+
No additional metadata.
  
{| class="wikitable"
+
=== Skeleton ===
 +
 
 +
{{Metadata inherit|Skeleton|inherits=Abstract Skeleton}}
 +
 
 +
=== Wither Skeleton ===
 +
 
 +
{{Metadata inherit|Wither Skeleton|inherits=Abstract Skeleton}}
 +
 
 +
=== Stray ===
 +
 
 +
{{Metadata inherit|Stray|inherits=Abstract Skeleton}}
 +
 
 +
=== Spider ===
 +
 
 +
{{Metadata inherit|Spider|inherits=Monster}}
 +
 
 +
{| class="wikitable"
 
  ! Index
 
  ! Index
 
  ! Type
 
  ! Type
Line 2,739: Line 2,810:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 13
+
  |rowspan="2"| {{Metadata id|}}
| BlockPos
+
  |rowspan="2"| Byte
  |colspan="2"| Home pos
+
! Bit mask
  | (0, 0, 0)
+
! Meaning
 +
  |rowspan="2"| 0
 
  |-
 
  |-
  | 14
+
  | 0x01
  | Boolean
+
  | Is climbing
  |colspan="2"| Has egg
+
  |}
  | false
+
 
  |-
+
=== Wither ===
  | 15
+
 
  | Boolean
+
{{Metadata inherit|Wither|inherits=Monster}}
  |colspan="2"| Laying egg
+
 
  | false
+
{| class="wikitable"
 +
! Index
 +
! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
  ! Default
 +
  |-
 +
  | {{Metadata id|}}
 +
  | VarInt
 +
  |colspan="2"| Center head's target (entity ID, or 0 if no target)
 +
  | 0
 
  |-
 
  |-
  | 16
+
  | {{Metadata id|}}
  | BlockPos
+
  | VarInt
  |colspan="2"| Travel pos
+
  |colspan="2"| Left head's target (entity ID, or 0 if no target)
  | (0, 0, 0)
+
  | 0
 
  |-
 
  |-
  | 17
+
  | {{Metadata id|}}
  | Boolean
+
  | VarInt
  |colspan="2"| Going home
+
  |colspan="2"| Right head's target (entity ID, or 0 if no target)
  | false
+
  | 0
 
  |-
 
  |-
  | 18
+
  | {{Metadata id|}}
  | Boolean
+
  | VarInt
  |colspan="2"| Traveling
+
  |colspan="2"| Invulnerable time
  | false
+
  | 0
 
  |}
 
  |}
  
=== Polar Bear ===
+
=== Zoglin ===
  
Extends [[#Animal|Animal]].
+
{{Metadata inherit|Hoglin|inherits=Monster}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,780: Line 2,861:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 13
+
  | {{Metadata id|}}
 
  | Boolean
 
  | Boolean
  |colspan="2"| Standing up
+
  |colspan="2"| Is baby
 
  | false
 
  | false
 
  |}
 
  |}
  
=== Chicken ===
+
=== Zombie ===
  
Extends [[#Animal|Animal]].
+
{{Metadata inherit|Zombie|inherits=Monster}}
  
No additional metadata.
+
{| class="wikitable"
 
 
=== Cow ===
 
 
 
Extends [[#Animal|Animal]].
 
 
 
No additional metadata.
 
 
 
=== Mooshroom ===
 
 
 
Extends [[#Cow|Cow]].
 
 
 
No additional metadata.
 
 
 
=== Sheep ===
 
 
 
Extends [[#Animal|Animal]].
 
 
 
{| class="wikitable"
 
 
  ! Index
 
  ! Index
 
  ! Type
 
  ! Type
Line 2,814: Line 2,877:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  |rowspan="3"| 13
+
  | {{Metadata id|}}
  |rowspan="3"| Byte
+
| Boolean
! Bit mask
+
  |colspan="2"| Is baby
! Meaning
+
  | false
  |rowspan="3"| 0
 
 
  |-
 
  |-
  | 0x0F
+
  | {{Metadata id|}}
  | Color (matches {{Minecraft Wiki|Data_values#Dyes|dye damage values}})
+
  | VarInt
 +
|colspan="2"| Unused (previously type)
 +
| 0
 
  |-
 
  |-
  | 0x10
+
  | {{Metadata id|}}
  | Is sheared
+
| Boolean
 +
  |colspan="2"| Is becoming a drowned
 +
| false
 
  |}
 
  |}
  
=== TameableAnimal ===
+
=== Zombie Villager ===
  
Extends [[#Animal|Animal]].
+
{{Metadata inherit|Zombie Villager|inherits=Zombie}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,837: Line 2,903:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  |rowspan="4"| 13
+
  | {{Metadata id|}}
  |rowspan="4"| Byte
+
  | Boolean
! Bit mask
+
  |colspan="2"| Is converting
! Meaning
+
  | false
  |rowspan="4"| 0
+
  |-  
|-
+
  | {{Metadata id|}}
| 0x01
+
  | Villager Data
| Is sitting
+
  |colspan="2"| Villager Data
|-
+
  | Plains/None/1
  | 0x02
 
| Is angry (only used with wolves)
 
  |-
 
  | 0x04
 
| Is tamed
 
|-
 
| 14
 
  | OptUUID
 
  |colspan="2"| Owner
 
  | Absent
 
 
  |}
 
  |}
  
=== Ocelot ===
+
=== Husk ===
  
Extends [[#TameableAnimal|TameableAnimal]].
+
{{Metadata inherit|Husk|inherits=Zombie}}
  
{| class="wikitable"
+
No additional metadata.
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
| 15
 
| VarInt
 
|colspan="2"| Type (0 = untamed, 1 = tuxedo, 2 = tabby, 3 = siamese). Used to render regardless as to whether it is tamed or not.
 
| 0
 
|}
 
  
=== Wolf ===
+
=== Drowned ===
  
Extends [[#TameableAnimal|TameableAnimal]].
+
{{Metadata inherit|Drowned|inherits=Zombie}}
 +
 
 +
No additional metadata.
 +
 
 +
=== Zombified Piglin ===
 +
 
 +
{{Metadata inherit|Zombified Piglinn|inherits=Zombie}}
 +
 
 +
No additional metadata.
 +
 
 +
=== Enderman ===
 +
 
 +
{{Metadata inherit|Enderman|inherits=Monster}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,884: Line 2,942:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 15
+
  | {{Metadata id|}}
  | Float
+
  | Opt BlockID
  |colspan="2"| Damage taken (used for tail rotation)
+
  |colspan="2"| Carried block
  | Value of health field (1.0)
+
  | Absent
 
  |-
 
  |-
  | 16
+
  | {{Metadata id|}}
 
  | Boolean
 
  | Boolean
  |colspan="2"| Is begging
+
  |colspan="2"| Is screaming
 
  | false
 
  | false
 
  |-
 
  |-
  | 17
+
  | {{Metadata id|}}
  | VarInt
+
  | Boolean
  |colspan="2"| Collar color (values are those {{Minecraft Wiki|Data_values#Dyes|used with dyes}})
+
  |colspan="2"| Is staring
  | 14 (Red)
+
  | false
 
  |}
 
  |}
  
=== Parrot ===
+
=== Ender Dragon ===
  
Extends [[#TameableAnimal|TameableAnimal]].
+
{{Metadata inherit|Ender Dragon|inherits=Mob}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,910: Line 2,968:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 15
+
  | {{Metadata id|}}
 
  | VarInt
 
  | VarInt
  |colspan="2"| Variant (0: red/blue, 1: blue, 2: green, 3: yellow/blue, 4: grey)
+
  |colspan="2"| Dragon phase
  | 0
+
  | 10 (hover)
 
  |}
 
  |}
  
=== Villager ===
+
Phases (according to {{Minecraft Wiki|Ender Dragon#Data_values|the wiki page on dragon data values}}) are:
  
Extends [[#Ageable|Ageable]].
+
* 0: circling
 
+
* 1: strafing (preparing to shoot a fireball)
{| class="wikitable"
+
* 2: flying to the portal to land (part of transition to landed state)
! Index
+
* 3: landing on the portal (part of transition to landed state)
! Type
+
* 4: taking off from the portal (part of transition out of landed state)
!style="width: 250px;" colspan="2"| Meaning
+
* 5: landed, performing breath attack
! Default
+
* 6: landed, looking for a player for breath attack
|-
+
* 7: landed, roar before beginning breath attack
| 13
+
* 8: charging player
| VarInt
+
* 9: flying to portal to die
|colspan="2"| Profession (Farmer = 0, Librarian = 1, Priest = 2, Blacksmith = 3, Butcher = 4, Nitwit = 5)
+
* 10: hovering with no AI (default when using the /summon command).
| 0
 
|}
 
  
=== Golem ===
+
=== Flying ===
  
Extends [[#Creature|Creature]].
+
{{Metadata inherit|Flying|inherits=Mob}}
  
 
No additional metadata.
 
No additional metadata.
  
=== IronGolem ===
+
=== Ghast ===
  
Extends [[#Golem|Golem]].
+
{{Metadata inherit|Ghast|inherits=Flying}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,948: Line 3,004:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  |rowspan="2"| 12
+
  | {{Metadata id|}}
  |rowspan="2"| Byte
+
  | Boolean
! Bit mask
+
  |colspan="2"| Is attacking
! Meaning
+
  | false
  |rowspan="2"| 0
 
|-
 
  | 0x01
 
| Is player-created
 
 
  |}
 
  |}
  
=== Snowman ===
+
=== Phantom ===
  
Extends [[#Golem|Golem]].
+
{{Metadata inherit|Phantom|inherits=Flying}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,968: Line 3,020:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  |rowspan="3"| 12
+
  | {{Metadata id|}}
  |rowspan="3"| Byte
+
  | VarInt
! Bit mask
+
  |colspan="2"| Size
! Meaning
+
  | 0
  |rowspan="3"| 0x10
 
|-
 
| 0x10
 
| has pumpkin hat
 
|-
 
| 0x00
 
  | has no pumpkin hat
 
 
  |}
 
  |}
  
=== Shulker ===
+
Hitbox size is determined by horizontal=0.9 + 0.2*size and vertical=0.5 + 0.1 * i
 +
 
 +
=== Slime ===
  
Extends [[#Golem|Golem]].
+
{{Metadata inherit|Slime|inherits=Mob}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,991: Line 3,038:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 12
+
  | {{Metadata id|}}
| Direction
+
  | VarInt
|colspan="2"| Attach face
+
  |colspan="2"| Size
| Down (0)
+
  | 1
|-
 
| 13
 
| OptPosition
 
|colspan="2"| Attachment position
 
| Absent
 
|-
 
| 14
 
| Byte
 
|colspan="2"| Shield height
 
| 0
 
|-
 
| 15
 
  | Byte
 
  | colspan="2"| Color (dye color)
 
  | 10 (purple)
 
 
  |}
 
  |}
  
=== Monster ===
+
=== Llama Spit ===
  
Extends [[#Creature|Creature]].
+
{{Metadata inherit|Llama Spit|inherits=Entity}}
  
No additional metadata.
+
=== Abstract Minecart===
  
=== Blaze ===
+
{{Metadata inherit|Abstract Minecart|inherits=Entity}}
 
 
Extends [[#Monster|Monster]].
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 3,028: Line 3,058:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  |rowspan="2"|12
+
  | {{Metadata id|}}
  |rowspan="2"|Byte
+
| VarInt
  ! Bit mask
+
|colspan="2"| Shaking power
  ! Meaning
+
  | 0
  |rowspan="2"|0
+
|-
 +
  | {{Metadata id|}}
 +
  | VarInt
 +
  |colspan="2"| Shaking direction
 +
| 1
 
  |-
 
  |-
  | 0x01
+
  | {{Metadata id|}}
  | Is on fire
+
  | Float
  |}
+
  |colspan="2"| Shaking multiplier
 
+
  | 0.0
=== Creeper ===
 
 
 
Extends [[#Monster|Monster]].
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
  ! Default
 
 
  |-
 
  |-
  | 12
+
  | {{Metadata id|}}
 
  | VarInt
 
  | VarInt
  |colspan="2"| State (-1 = idle, 1 = fuse)
+
  |colspan="2"| Custom block ID and damage
  | -1
+
  | 0
 
  |-
 
  |-
  | 13
+
  | {{Metadata id|}}
  | Boolean
+
  | VarInt
  |colspan="2"| Is {{Minecraft Wiki|Creeper#Charged Creeper|charged}}
+
  |colspan="2"| Custom block Y position (in 16ths of a block)
  | false
+
  | 6
 
  |-
 
  |-
  | 14
+
  | {{Metadata id|}}
 
  | Boolean
 
  | Boolean
  |colspan="2"| Is ignited
+
  |colspan="2"| Show custom block
 
  | false
 
  | false
 
  |}
 
  |}
  
=== Endermite ===
+
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.
  
Extends [[#Monster|Monster]].
+
* 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
No additional metadata.
+
* 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
=== Giant Zombie ===
+
* 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
Extends [[#Monster|Monster]].
+
* Spawner Minecarts contain a spawner (52:0) and have a y position of 6
 
 
No additional metadata.
 
 
 
=== Guardian ===
 
 
 
Extends [[#Monster|Monster]].
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
| 12
 
| Boolean
 
|colspan="2"| Is retracting spikes
 
| false
 
|-
 
| 13
 
| VarInt
 
|colspan="2"| Target EID
 
| 0
 
|}
 
 
 
=== ElderGuardian ===
 
 
 
Extends [[#Guardian|Guardian]].
 
 
 
=== Silverfish ===
 
 
 
Extends [[#Monster|Monster]].
 
 
 
No additional metadata.
 
 
 
=== Abstract Illager ===
 
 
 
Extends [[#Monster|Monster]].
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
|rowspan="2"| 12
 
|rowspan="2"| Byte
 
! Bit mask
 
! Meaning
 
|rowspan="2"| 0
 
|-
 
| 0x01
 
| Has target (aggressive state)
 
|}
 
 
 
=== VindicationIllager ===
 
 
 
Extends [[#Abstract Illager|Abstract Illager]].
 
 
 
=== Spellcaster Illager ===
 
 
 
Extends [[#Abstract Illager|Abstract Illlager]].
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
| 13
 
| Byte
 
| colspan="2"| Spell (0: none, 1: summon vex, 2: attack, 3: wololo, 4: disappear, 5: blindness)
 
| 0
 
|}
 
 
 
=== EvocationIllager ===
 
 
 
Extends [[#Spellcaster Illager|Spellcaster Illager]].
 
 
 
=== IllusionIllager ===
 
 
 
Extends [[#Spellcaster Illager|Spellcaster Illager]].
 
 
 
=== Vex ===
 
 
 
Extends [[#Monster|Monster]].
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
|rowspan="2"| 12
 
|rowspan="2"| Byte
 
! Bit mask
 
! Meaning
 
|rowspan="2"| 0
 
|-
 
| 0x01
 
| Is in attack mode
 
|}
 
 
 
=== EvocationFangs ===
 
 
 
Extends [[#Entity|Entity]].
 
 
 
No additional metadata.
 
 
 
=== AbstractSkeleton ===
 
 
 
Extends [[#Monster|Monster]].
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
| 12
 
| Boolean
 
|colspan="2"| Is swinging arms
 
| false
 
|}
 
 
 
=== Skeleton ===
 
 
 
Extends [[#AbstractSkeleton|AbstractSkeleton]].
 
 
 
=== Wither Skeleton ===
 
 
 
Extends [[#AbstractSkeleton|AbstractSkeleton]].
 
 
 
=== Stray ===
 
 
 
Extends [[#AbstractSkeleton|AbstractSkeleton]].
 
 
 
=== Spider ===
 
 
 
Extends [[#Monster|Monster]].
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
|rowspan="2"| 12
 
|rowspan="2"| Byte
 
! Bit mask
 
! Meaning
 
|rowspan="2"| 0
 
|-
 
| 0x01
 
| Is climbing
 
|}
 
 
 
=== Witch ===
 
 
 
Extends [[#Monster|Monster]].
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
| 12
 
| Boolean
 
|colspan="2"| Is drinking potion
 
| false
 
|}
 
 
 
=== Wither ===
 
 
 
Extends [[#Monster|Monster]].
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
| 12
 
| VarInt
 
|colspan="2"| Center head's target (entity ID, or 0 if no target)
 
| 0
 
|-
 
| 13
 
| VarInt
 
|colspan="2"| Left head's target (entity ID, or 0 if no target)
 
| 0
 
|-
 
| 14
 
| VarInt
 
|colspan="2"| Right head's target (entity ID, or 0 if no target)
 
| 0
 
|-
 
| 15
 
| VarInt
 
|colspan="2"| Invulnerable time
 
| 0
 
|}
 
 
 
=== Zombie ===
 
 
 
Extends [[#Monster|Monster]].
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
| 12
 
| Boolean
 
|colspan="2"| Is baby
 
| false
 
|-
 
| 13
 
| VarInt
 
|colspan="2"| Unused (previously type)
 
| 0
 
|-
 
| 14
 
| Boolean
 
|colspan="2"| Are hands held up
 
| false
 
|-
 
| 15
 
| Boolean
 
|colspan="2"| Is becoming a drowned
 
| false
 
|}
 
 
 
=== Zombie Villager ===
 
 
 
Extends [[#Zombie|Zombie]].
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
| 16
 
| Boolean
 
|colspan="2"| Is converting
 
| false
 
|-
 
| 17
 
| VarInt
 
|colspan="2"| Profession
 
| 0
 
|}
 
 
 
=== Husk ===
 
 
 
Extends [[#Zombie|Zombie]].
 
 
 
No additional metadata.
 
 
 
=== Drowned ===
 
 
 
Extends [[#Zombie|Zombie]].
 
 
 
No additional metadata.
 
 
 
=== Enderman ===
 
 
 
Extends [[#Monster|Monster]].
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
| 12
 
| Opt BlockID
 
|colspan="2"| Carried block
 
| Absent
 
|-
 
| 13
 
| Boolean
 
|colspan="2"| Is screaming
 
| false
 
|}
 
 
 
=== EnderDragon ===
 
 
 
Extends [[#Insentient|Insentient]].
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
| 12
 
| VarInt
 
|colspan="2"| Dragon phase
 
| 10 (hover)
 
|}
 
 
 
Phases (according to {{Minecraft Wiki|Ender Dragon#Data_values|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|Insentient]].
 
 
 
No additional metadata.
 
 
 
=== Ghast ===
 
 
 
Extends [[#Flying|Flying]].
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
| 12
 
| Boolean
 
|colspan="2"| Is attacking
 
| false
 
|}
 
 
 
=== Phantom ===
 
 
 
Extends [[#Flying|Flying]].
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
| 12
 
| VarInt
 
|colspan="2"| Size
 
| 0
 
|}
 
 
 
Hitbox size is determined by horizontal=0.9 + 0.2*size and vertical=0.5 + 0.1 * i
 
 
 
=== Slime ===
 
 
 
Extends [[#Insentient|Insentient]].
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
| 12
 
| VarInt
 
|colspan="2"| Size
 
| 1
 
|}
 
 
 
=== LlamaSpit ===
 
 
 
Extends [[#Entity|Entity]].
 
  
 
=== Minecart ===
 
=== Minecart ===
  
Extends [[#Entity|Entity]].
+
{{Metadata inherit|Minecart|inherits=Abstract Minecart}}
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
| 6
 
| VarInt
 
|colspan="2"| Shaking power
 
| 0
 
|-
 
| 7
 
| VarInt
 
|colspan="2"| Shaking direction
 
| 1
 
|-
 
| 8
 
| Float
 
|colspan="2"| Shaking multiplier
 
| 0.0
 
|-
 
| 9
 
| VarInt
 
|colspan="2"| Custom block ID and damage
 
| 0
 
|-
 
| 10
 
| VarInt
 
|colspan="2"| Custom block Y position (in 16ths of a block)
 
| 6
 
|-
 
| 11
 
| Boolean
 
|colspan="2"| 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|Minecart]].
 
  
 
No additional metadata.
 
No additional metadata.
  
=== MinecartContainer ===
+
=== Abstract Minecart Container ===
  
Extends [[#Minecart|Minecart]].
+
{{Metadata inherit|Abstract Minecart Container|inherits=Abstract Minecart}}
  
 
No additional metadata.
 
No additional metadata.
  
=== MinecartHopper ===
+
=== Minecart Hopper ===
  
Extends [[#MinecartContainer|MinecartContainer]].
+
{{Metadata inherit|Minecart Hopper|inherits=Abstract Minecart Container }}
  
 
No additional metadata.
 
No additional metadata.
  
=== MinecartChest ===
+
=== Minecart Chest ===
  
Extends [[#MinecartContainer|MinecartContainer]].
+
{{Metadata inherit|Minecart Chest|inherits=Abstract Minecart Container }}
  
 
No additional metadata.
 
No additional metadata.
  
=== MinecartFurnace ===
+
=== Minecart Furnace ===
  
Extends [[#Minecart|Minecart]].
+
{{Metadata inherit|Minecart Furnace|inherits=Abstract Minecart}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 3,536: Line 3,133:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 12
+
  | {{Metadata id|}}
 
  | Boolean
 
  | Boolean
 
  |colspan="2"| Has fuel
 
  |colspan="2"| Has fuel
Line 3,542: Line 3,139:
 
  |}
 
  |}
  
=== MinecartTNT ===
+
=== Minecart TNT ===
  
Extends [[#Minecart|Minecart]].
+
{{Metadata inherit|Minecart TNT|inherits=Abstract Minecart}}
  
 
No additional metadata.
 
No additional metadata.
  
=== MinecartSpawner ===
+
=== Minecart Spawner ===
  
Extends [[#Minecart|Minecart]].
+
{{Metadata inherit|Minecart Spawner|inherits=Abstract Minecart}}
  
 
No additional metadata.
 
No additional metadata.
  
=== MinecartCommandBlock ===
+
=== Minecart Command Block ===
  
Extends [[#Minecart|Minecart]].
+
{{Metadata inherit|Minecart Command Block|inherits=Abstract Minecart}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 3,564: Line 3,161:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 12
+
  | {{Metadata id|}}
 
  | String
 
  | String
 
  |colspan="2"| Command
 
  |colspan="2"| Command
 
  | <code></code>
 
  | <code></code>
 
  |-
 
  |-
  | 13
+
  | {{Metadata id|}}
 
  | [[Chat]]
 
  | [[Chat]]
 
  |colspan="2"| Last output
 
  |colspan="2"| Last output
Line 3,575: Line 3,172:
 
  |}
 
  |}
  
=== TNTPrimed ===
+
=== Primed Tnt ===
  
Extends [[#Entity|Entity]].
+
{{Metadata inherit|Primed Tnt|inherits=Entity}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 3,585: Line 3,182:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  | {{Metadata id|}}
 
  | VarInt
 
  | VarInt
 
  |colspan="2"| Fuse time
 
  |colspan="2"| Fuse time

Revision as of 20:49, 20 February 2021

Various Entities have different metadata fields and status codes.

These are the valid codes for Minecraft Java Edition 1.16.5; for upcoming changes for 1.17 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 a generator and wrote the mappings for 1.8.9 by hand. See Mappings Generator. Also burger might help.

Contents

Mobs

Mobs are spawned via Spawn Mob.

Warning.png 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:

Warning.png These entity IDs are up to date for 1.16.5. Use Data Generators or Burger to get older IDs. If using Burger just replace the version number to what you want to see.

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 Entity 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 Item Frame 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 Chest 0.98 0.7 minecraft:chest_minecart
47 Minecart Command Block 0.98 0.7 minecraft:commandblock_minecart
48 Minecart Furnace 0.98 0.7 minecraft:furnace_minecart
49 Minecart Hopper 0.98 0.7 minecraft:hopper_minecart
50 Minecart Spawner 0.98 0.7 minecraft:spawner_minecart
51 Minecart TNT 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 Piglin Brute 0.6 1.95 minecraft:piglin_brute
62 Pillager 0.6 1.95 minecraft:pillager
63 Polar Bear 1.4 1.4 minecraft:polar_bear
64 Primed TNT 0.98 0.98 minecraft:tnt
65 Pufferfish 0.7 0.7 minecraft:pufferfish
66 Rabbit 0.4 0.5 minecraft:rabbit
67 Ravager 1.95 2.2 minecraft:ravager
68 Salmon 0.7 0.4 minecraft:salmon
69 Sheep 0.9 1.3 minecraft:sheep
70 Shulker 1.0 1.0-2.0 (depending on peek) minecraft:shulker
71 Shulker Bullet 0.3125 0.3125 minecraft:shulker_bullet
72 Silverfish 0.4 0.3 minecraft:silverfish
73 Skeleton 0.6 1.99 minecraft:skeleton
74 Skeleton Horse 1.39648 1.6 minecraft:skeleton_horse
75 Slime 0.51000005 * size 0.51000005 * size minecraft:slime
76 Small Fireball 0.3125 0.3125 minecraft:small_fireball
77 Snow Golem 0.7 1.9 minecraft:snow_golem
78 Snowball 0.25 0.25 minecraft:snowball
79 Spectral Arrow 0.5 0.5 minecraft:spectral_arrow
80 Spider 1.4 0.9 minecraft:spider
81 Squid 0.8 0.8 minecraft:squid
82 Stray 0.6 1.99 minecraft:stray
83 Strider 0.9 1.7 minecraft:strider
84 Thrown Egg 0.25 0.25 minecraft:egg
85 Thrown Ender Pearl 0.25 0.25 minecraft:ender_pearl
86 Thrown Expierience Bottle 0.25 0.25 minecraft:experience_bottle
87 Thrown Potion 0.25 0.25 minecraft:potion
88 Thrown Trident 0.5 0.5 minecraft:trident
89 Trader Llama 0.9 1.87 minecraft:trader_llama
90 Tropical Fish 0.5 0.4 minecraft:tropical_fish
91 Turtle 1.2 0.4 minecraft:turtle
92 Vex 0.4 0.8 minecraft:vex
93 Villager 0.6 1.95 minecraft:villager
94 Vindicator 0.6 1.95 minecraft:vindicator
95 Wandering Trader 0.6 1.95 minecraft:wandering_trader
96 Witch 0.6 1.95 minecraft:witch
97 Wither 0.9 3.5 minecraft:wither
98 Wither Skeleton 0.7 2.4 minecraft:wither_skeleton
99 Wither Skull 0.3125 0.3125 minecraft:wither_skull
100 Wolf 0.6 0.85 minecraft:wolf
101 Zoglin 1.39648 1.4 minecraft:zoglin
102 Zombie 0.6 1.95 minecraft:zombie
103 Zombie Horse 1.39648 1.6 minecraft:zombie_horse
104 Zombie Villager 0.6 1.95 minecraft:zombie_villager
105 Zombified Piglin 0.6 1.95 minecraft:zombified_piglin
106 Player 0.6 1.8 minecraft:player
107 Fishing Hook 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 Entity 0.25 0.25
77 Leash Knot 0.375 0.5
78 Armor Stand 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