Difference between revisions of "Entity metadata"

From wiki.vg
Jump to navigation Jump to search
(Added Bee index 16 Bitmask)
m (Added missing cat type (jellie), and fixed mislabeled all_black type)
(34 intermediate revisions by 7 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
 
 
  |-
 
  |-
  | rowspan="5" | 16
+
  | 4
  | rowspan="5" | Byte
+
  | [[Chat]]
! Bit mask
+
  |
  ! Meaning
 
| rowspan="5" | 0
 
 
  |-
 
  |-
  | 0x01 || ''Unused''
+
  | 5
 +
| OptChat (Boolean + Optional [[Chat]])
 +
| [[Chat]] is present if the Boolean is set to true
 +
|-
 +
| 6
 +
| [[Slot]]
 +
|
 
  |-
 
  |-
  | 0x02 || Looping
+
  | 7
 +
| Boolean
 +
|
 
  |-
 
  |-
  | 0x04 || Has lost stung
+
  | 8
 +
| Rotation
 +
| 3 floats: rotation on x, rotation on y, rotation on z
 
  |-
 
  |-
  | 0x08 || Has nectar
+
  | 9
 +
| [[Data Types#Position|Position]]
 +
|
 +
|-
 +
| 10
 +
| OptPosition (Boolean + Optional Position)
 +
| Position is present if the Boolean is set to true
 
  |-
 
  |-
  | 17
+
  | 11
  | VarInt
+
  | Direction (VarInt)
  | colspan="2"| Anger time in ticks
+
  | (Down = 0, Up = 1, North = 2, South = 3, West = 4, East = 5)
  | 0 (Not angry)
+
|-
  |}
+
| 12
 
+
| OptUUID (Boolean + Optional UUID)
</div>
+
| UUID is present if the Boolean is set to true
 
+
|-
== Mobs ==
+
| 13
 
+
| OptBlockID (VarInt)
Mobs are spawned via [[Protocol#Spawn_Mob|Spawn Mob]].
+
  | 0 for absent (implies air); otherwise, a block state ID as per the global palette
 +
  |-
 +
| 14
 +
| [[NBT]]
 +
|
 +
|-
 +
| 15
 +
| [[Data Types#Particle|Particle]]
 +
|
 +
|-
 +
| 16
 +
| Villager Data
 +
| 3 VarInts: villager type, villager profession, level
 +
|-
 +
| 17
 +
| OptVarInt
 +
| 0 for absent; 1 + actual value otherwise. Used for entity IDs.
 +
|-
 +
| 18
 +
| Pose
 +
| A VarInt enum: 0: STANDING, 1: FALL_FLYING, 2: SLEEPING, 3: SWIMMING, 4: SPIN_ATTACK, 5: SNEAKING, 6: DYING
 +
|}
  
{{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.
+
Villager type (<code>minecraft:villager_type</code> registry):
 
 
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"
 
{| class="wikitable"
|-
+
! Name !! ID
! Type
+
|-
! Name
+
| <code>minecraft:desert</code> || 0
! bounding box x and z
+
|-
! bounding box y
+
| <code>minecraft:jungle</code> || 1
! ID
+
|-
|- style="background: #ffff88;"
+
| <code>minecraft:plains</code> || 2
| 0
+
|-
| AreaEffectCloud
+
| <code>minecraft:savanna</code> || 3
| 2.0 * Radius
+
|-
| 0.5
+
| <code>minecraft:snow</code> || 4
| <code>minecraft:area_effect_cloud</code>
+
|-
|- style="background: #ffff88;"
+
| <code>minecraft:swamp</code> || 5
| 1
+
|-
| ArmorStand
+
| <code>minecraft:taiga</code> || 6
| normal: 0.5 marker: 0.0 small: 0.25
+
|}
| normal: 1.975 marker: 0.0 small: 0.9875
+
 
| <code>minecraft:armor_stand</code>
+
Villager professions (<code>minecraft:villager_profession</code> registry):
|- style="background: #ffff88;"
+
 
| 2
+
{| class="wikitable"
| Arrow
+
! Name !! ID
| 0.5
+
|-
| 0.5
+
| <code>minecraft:none</code> || 0
| <code>minecraft:arrow</code>
+
|-
|-
+
| <code>minecraft:armorer</code> || 1
| 3
+
|-
| Bat
+
| <code>minecraft:butcher</code> || 2
| 0.5
+
|-
| 0.9
+
| <code>minecraft:cartographer</code> || 3
| <code>minecraft:bat</code>
+
|-
|-
+
| <code>minecraft:cleric</code> || 4
| 4
+
|-
| Blaze
+
| <code>minecraft:farmer</code> || 5
| 0.6
+
|-
| 1.8
+
| <code>minecraft:fisherman</code> || 6
| <code>minecraft:blaze</code>
+
|-
|- style="background: #ffff88;"
+
| <code>minecraft:fletcher</code> || 7
| 5
+
|-
| Boat
+
| <code>minecraft:leatherworker</code> || 8
| 1.375
+
|-
| 0.5625
+
| <code>minecraft:librarian</code> || 9
| <code>minecraft:boat</code>
+
|-
|-
+
| <code>minecraft:mason</code> || 10
| 6
+
|-
| CaveSpider
+
| <code>minecraft:nitwit</code> || 11
| 0.7
+
|-
| 0.5
+
| <code>minecraft:shepherd</code> || 12
| <code>minecraft:cave_spider</code>
+
|-
|-
+
| <code>minecraft:toolsmith</code> || 13
| 7
+
|-
| Chicken
+
| <code>minecraft:weaponsmith</code> || 14
| 0.4
+
|}
| 0.7
+
 
| <code>minecraft:chicken</code>
+
Entity classes also recursively inherit fields from classes they extend.
|-
+
 
| 8
+
=== Entity ===
| Cod
+
 
| 0.9
+
{{metadata inherit|Entity}}
| 1.4
+
 
| <code>minecraft:cod</code>
+
{| class="wikitable"
|-
+
! Index
| 9
+
! Type
| Cow
+
!style="width: 250px;" colspan="2"| Meaning
| 0.9
+
! Default
| 1.4
+
|-
| <code>minecraft:cow</code>
+
|rowspan="9"| {{Metadata id|}}
|-
+
|rowspan="9"| Byte
| 10
+
! Bit mask
| Creeper
+
! Meaning
| 0.6
+
|rowspan="9"| 0
| 1.7
+
|-
| <code>minecraft:creeper</code>
+
| 0x01
|-
+
| Is on fire
| 11
+
|-
| Donkey
+
| 0x02
| 1.3964844
+
| Is crouching
| 1.6
+
|-
| <code>minecraft:donkey</code>
+
| 0x04
|-
+
| Unused (previously riding)
| 12
+
|-
| Dolphin
+
| 0x08
| 0.9
+
| Is sprinting
| 0.6
+
|-
| <code>minecraft:dolphin</code>
+
| 0x10
|- style="background: #ffff88;"
+
| Is swimming
| 13
+
|-
| DragonFireball
+
| 0x20
| 1.0
+
| Is invisible
| 1.0
+
|-
| <code>minecraft:dragon_fireball</code>
+
| 0x40
|-
+
| has glowing effect
| 14
+
|-
| Drowned
+
| 0x80
| ?
+
| Is flying with an {{Minecraft Wiki|elytra}}
| ?
+
|-
| <code>minecraft:drowned</code>
+
| {{Metadata id|}}
|-
+
| VarInt
| 15
+
|colspan="2"| Air ticks
| ElderGuardian
+
| 300
| 1.9975 (2.35 * guardian)
+
|-
| 1.9975 (2.35 * guardian)
+
| {{Metadata id|}}
| <code>minecraft:elder_guardian</code>
+
| OptChat
|- style="background: #ffff88;"
+
|colspan="2"| Custom name
| 16
+
| empty
| EnderCrystal
+
|-
| 2.0
+
| {{Metadata id|}}
| 2.0
+
| Boolean
| <code>minecraft:end_crystal</code>
+
|colspan="2"| Is custom name visible
|-
+
| false
| 17
+
|-
| EnderDragon
+
| {{Metadata id|}}
| 16.0
+
| Boolean
| 8.0
+
|colspan="2"| Is silent
| <code>minecraft:ender_dragon</code>
+
| false
|-
+
|-
| 18
+
| {{Metadata id|}}
| Enderman
+
| Boolean
| 0.6
+
|colspan="2"| Has no gravity
| 2.9
+
| false
| <code>minecraft:enderman</code>
+
|-
|-
+
| {{Metadata id|}}
| 19
+
| Pose
| Endermite
+
|colspan="2"| Pose
| 0.4
+
| STANDING
| 0.3
+
|}
| <code>minecraft:endermite</code>
+
 
|- style="background: #ffff88;"
+
=== Thrown Egg ===
| 20
+
 
| EvocationFangs
+
{{Metadata inherit|Thrown Egg|inherits=Entity}}
| 0.5
+
 
| 0.8
+
{| class="wikitable"
| <code>minecraft:evoker_fangs</code>
+
! Index
|-
+
! Type
| 21
+
!style="width: 250px;" colspan="2"| Meaning
| EvocationIllager
+
! Default
| 0.6
+
|-
| 1.95
+
| {{Metadata id|}}
| <code>minecraft:evoker</code>
+
| [[Slot]]
|- style="background: #aaaaff;"
+
|colspan="2"| Item
| 22
+
| Empty (which behaves as if it were a <code>minecraft:egg</code>)
| XPOrb
+
|}
| 0.5
+
 
| 0.5
+
=== Thrown Ender Pearl ===
| <code>minecraft:experience_orb</code>
+
 
|- style="background: #ffff88;"
+
{{Metadata inherit|Thrown Ender Pearl|inherits=Entity}}
| 23
+
 
| EyeOfEnderSignal
+
{| class="wikitable"
| 0.25
+
! Index
| 0.25
+
! Type
| <code>minecraft:eye_of_ender</code>
+
!style="width: 250px;" colspan="2"| Meaning
|- style="background: #ffff88;"
+
! Default
| 24
+
|-
| FallingSand
+
| {{Metadata id|}}
| 0.98
+
| [[Slot]]
| 0.98
+
|colspan="2"| Item
| <code>minecraft:falling_block</code>
+
| Empty (which behaves as if it were a <code>minecraft:ender_pearl</code>)
|- style="background: #ffff88;"
+
|}
| 25
+
 
| FireworksRocketEntity
+
=== Thrown Experience Bottle===
| 0.25
+
 
| 0.25
+
{{Metadata inherit|Thrown Experience Bottle|inherits=Entity}}
| <code>minecraft:fireworks_rocket</code>
+
 
|-
+
{| class="wikitable"
| 26
+
! Index
| Ghast
+
! Type
| 4
+
!style="width: 250px;" colspan="2"| Meaning
| 4
+
! Default
| <code>minecraft:ghast</code>
+
|-
|-
+
| {{Metadata id|}}
| 27
+
| [[Slot]]
| Giant
+
|colspan="2"| Item
| 3.6
+
| Empty (which behaves as if it were a <code>minecraft:experience_bottle</code>)
| 10.8
+
|}
| <code>minecraft:giant</code>
+
 
|-
+
=== Thrown Potion ===
| 28
+
 
| Guardian
+
{{Metadata inherit|Thrown Potion|inherits=Entity}}
| 0.85
+
 
| 0.85
+
{| class="wikitable"
| <code>minecraft:guardian</code>
+
! Index
|-
+
! Type
| 29
+
!style="width: 250px;" colspan="2"| Meaning
| Horse (EntityHorse until 1.11)
+
! Default
| 1.3964844
+
|-
| 1.6
+
| {{Metadata id|}}
| <code>minecraft:horse</code>
+
| [[Slot]]
|-
+
|colspan="2"| Potion which is thrown
| 30
+
| Empty
| Husk
+
|}
| 0.6
+
 
| 1.95
+
=== Snowball ===
| <code>minecraft:husk</code>
+
 
|-
+
{{Metadata inherit|Snowball|inherits=Entity}}
| 31
+
 
| IllusionIllager
+
{| class="wikitable"
| 0.6
+
! Index
| 1.95
+
! Type
| <code>minecraft:illusioner</code>
+
!style="width: 250px;" colspan="2"| Meaning
|- style="background: #ffff88;"
+
! Default
| 32
+
|-
| Item
+
| {{Metadata id|}}
| 0.25
+
| [[Slot]]
| 0.25
+
|colspan="2"| Item
| <code>minecraft:item</code>
+
| Empty (which behaves as if it were a <code>minecraft:snowball</code>)
|- style="background: #ffff88;"
+
|}
| 33
+
 
| ItemFrame
+
=== Eye of Ender ===
| 0.75 or 0.0625 (depth)
+
 
| 0.75
+
{{Metadata inherit|Eye of Ender|inherits=Entity}}
| <code>minecraft:item_frame</code>
+
 
|- style="background: #ffff88;"
+
{| class="wikitable"
| 34
+
! Index
| Fireball (ghast)
+
! Type
| 1.0
+
!style="width: 250px;" colspan="2"| Meaning
| 1.0
+
! Default
| <code>minecraft:fireball</code>
+
|-
|- style="background: #ffff88;"
+
| {{Metadata id|}}
| 35
+
| [[Slot]]
| LeashKnot
+
|colspan="2"| Item
| 0.375
+
| Empty (which behaves as if it were a <code>minecraft:ender_eye</code>)
| 0.5
+
|}
| <code>minecraft:leash_knot</code>
+
 
|-
+
=== Falling Block ===
| 36
+
 
| Llama
+
{{Metadata inherit|Falling Block|inherits=Entity}}
| 0.9
+
 
| 1.87
+
{| class="wikitable"
| <code>minecraft:llama</code>
+
! Index
|- style="background: #ffff88;"
+
! Type
| 37
+
!style="width: 250px;" colspan="2"| Meaning
| LlamaSpit
+
! Default
| 0.25
+
|-
| 0.25
+
| {{Metadata id|}}
| <code>minecraft:llama_spit</code>
+
| [[Data Types#Position|BlockPos]]
|-  
+
|colspan="2"| spawn position
| 38
+
| (0, 0, 0)
| LavaSlime (Magma Cube)
+
|}
| 0.51000005 * size
+
 
| 0.51000005 * size
+
=== Area Effect Cloud ===
| <code>minecraft:magma_cube</code>
+
 
|- style="background: #ffff88;"
+
{{Metadata inherit|Area Effect Cloud|inherits=Entity}}
| 39
+
 
| MinecartRideable
+
{| class="wikitable"
| 0.98
+
! Index
| 0.7
+
! Type
| <code>minecraft:minecart</code>
+
!style="width: 250px;" colspan="2"| Meaning
|- style="background: #ffff88;"
+
! Default
| 40
+
|-
| MinecartChest
+
| {{Metadata id|}}
| 0.98
+
| Float
| 0.7
+
|colspan="2"| Radius
| <code>minecraft:chest_minecart</code>
+
| 0.5
|- style="background: #ffff88;"
+
|-
| 41
+
| {{Metadata id|}}
| MinecartCommandBlock
+
| VarInt
| 0.98
+
|colspan="2"| Color (only for mob spell particle)
| 0.7
+
| 0
| <code>minecraft:commandblock_minecart</code>
+
|-
|- style="background: #ffff88;"
+
| {{Metadata id|}}
| 42
+
| Boolean
| MinecartFurnace
+
|colspan="2"| Ignore radius and show effect as single point, not area
| 0.98
+
| false
| 0.7
+
|-
| <code>minecraft:furnace_minecart</code>
+
| {{Metadata id|}}
|- style="background: #ffff88;"
+
| Particle
| 43
+
| colspan="2"| The [[#Particle]]
| MinecartHopper
+
| <code>effect</code>
| 0.98
+
|}
| 0.7
+
 
| <code>minecraft:hopper_minecart</code>
+
=== Fishing Hook ===
|- style="background: #ffff88;"
+
 
| 44
+
{{Metadata inherit|Fishing Hook|inherits=Entity}}
| MinecartSpawner
+
 
| 0.98
+
{| class="wikitable"
| 0.7
+
! Index
| <code>minecraft:spawner_minecart</code>
+
! Type
|- style="background: #ffff88;"
+
!style="width: 250px;" colspan="2"| Meaning
| 45
+
! Default
| MinecartTNT
+
|-
| 0.98
+
| {{Metadata id|}}
| 0.7
+
| VarInt
| <code>minecraft:tnt_minecart</code>
+
|colspan="2"| Hooked entity id + 1, or 0 if there is no hooked entity
|-
+
| 0
| 46
+
  |-
| Mule
+
| {{Metadata id|}}
| 1.3964844
+
| Boolean
| 1.6
+
|colspan="2"| Is catchable
| <code>minecraft:mule</code>
+
| False
|-
+
|}
| 47
+
 
| MushroomCow (Mooshroom)
+
=== Abstract Arrow ===
| 0.9
+
 
| 1.4
+
{{Metadata inherit|Abstract Arrow|inherits=Entity}}
| <code>minecraft:mooshroom</code>
+
 
|-
+
{| class="wikitable"
| 48
+
! Index
| Ozelot (Ocelot)
+
! Type
| 0.6
+
!style="width: 250px;" colspan="2"| Meaning
| 0.7
+
! Default
| <code>minecraft:ocelot</code>
+
|-
|- style="background: #aaaaff;"
+
| rowspan="3" | {{Metadata id|}}
| 49
+
| rowspan="3" | Byte
| Painting
+
! Bit mask
| type width or 0.0625 (depth)
+
! Meaning
| type height
+
| rowspan="3" | 0
| <code>minecraft:painting</code>
+
|-
|-
+
| 0x01
| 50
+
| Is critical
| Parrot
+
|-
| 0.5
+
| 0x02
| 0.9
+
| Is noclip (used by loyalty tridents when returning)
| <code>minecraft:parrot</code>
+
|-
|-  
+
| {{Metadata id|}}
| 51
+
| Byte
| Pig
+
|colspan="2"| Piercing level
| 0.9
+
| 0
| 0.9
+
|}
| <code>minecraft:pig</code>
+
 
|-
+
=== Arrow ===
| 52
+
 
| Pufferfish
+
{{Metadata inherit|Arrow|inherits=Abstract Arrow}}
| ?
+
 
| ?
+
Used for both tipped and regular arrows.  If not tipped, then color is set to -1 and no tipped arrow particles are used.
| <code>minecraft:pufferfish</code>
+
 
|-
+
{| class="wikitable"
| 53
+
! Index
| PigZombie
+
! Type
| 0.6
+
!style="width: 250px;" colspan="2"| Meaning
| 1.95
+
! Default
| <code>minecraft:zombie_pigman</code>
+
|-
|-
+
| {{Metadata id|}}
| 54
+
| VarInt
| PolarBear
+
|colspan="2"| Color (-1 for no particles)
| 1.3
+
| -1
| 1.4
+
|}
| <code>minecraft:polar_bear</code>
+
 
|- style="background: #ffff88;"
+
=== Spectral Arrow ===
| 55
+
 
| PrimedTnt
+
{{Metadata inherit|Spectral Arrow|inherits=Abstract Arrow}}
| 0.98
+
 
| 0.98
+
No additional metadata.
| <code>minecraft:tnt</code>
+
 
|-
+
=== Thrown Trident ===
| 56
+
 
| Rabbit
+
{{Metadata inherit|Thrown Trident|inherits=Abstract Arrow}}
| 0.4
+
 
| 0.5
+
{| class="wikitable"
| <code>minecraft:rabbit</code>
+
! Index
|-
+
! Type
| 57
+
!style="width: 250px;" colspan="2"| Meaning
| Salmon
+
! Default
| ?
+
|-
| ?
+
| {{Metadata id|}}
| <code>minecraft:salmon</code>
+
| VarInt
|-
+
|colspan="2"| Loyalty level (enchantment)
| 58
+
| 0
| Sheep
+
|-
| 0.9
+
| {{Metadata id|}}
| 1.3
+
| Boolean
| <code>minecraft:sheep</code>
+
|colspan="2"| Has enchantment glint
|-
+
| False
| 59
+
|}
| Shulker
+
 
| 1.0
+
=== Boat ===
| 1.0-2.0 (depending on peek)
+
 
| <code>minecraft:shulker</code>
+
{{Metadata inherit|Boat|inherits=Entity}}
|- style="background: #ffff88;"
+
 
| 60
+
{| class="wikitable"
| ShulkerBullet
+
! Index
| 0.3125
+
! Type
| 0.3125
+
!style="width: 250px;" colspan="2"| Meaning
| <code>minecraft:shulker_bullet</code>
+
! Default
|-
+
|-
| 61
+
| {{Metadata id|}}
| Silverfish
+
| VarInt
| 0.4
+
|colspan="2"| Time since last hit
| 0.3
+
| 0
| <code>minecraft:silverfish</code>
+
|-
|-
+
| {{Metadata id|}}
| 62
+
| VarInt
| Skeleton
+
|colspan="2"| Forward direction
| 0.6
+
| 1
| 1.99
+
|-
| <code>minecraft:skeleton</code>
+
| {{Metadata id|}}
|-
+
| Float
| 63
+
|colspan="2"| Damage taken
| SkeletonHorse
+
| 0.0
| 1.3964844
+
|-
| 1.6
+
| {{Metadata id|}}
| <code>minecraft:skeleton_horse</code>
+
| VarInt
|-
+
|colspan="2"| Type (0=oak, 1=spruce, 2=birch, 3=jungle, 4=acacia, 5=dark oak)
| 64 (67: 1.14)
+
| 0
| Slime
+
|-
| 0.51000005 * size
+
| {{Metadata id|}}
| 0.51000005 * size
+
| Boolean
| <code>minecraft:slime</code>
+
|colspan="2"| Is left paddle turning
|- style="background: #ffff88;"
+
| false
| 65
+
|-
| SmallFireball (blaze)
+
| {{Metadata id|}}
| 0.3125
+
| Boolean
| 0.3125
+
|colspan="2"| Is right paddle turning
| <code>minecraft:small_fireball</code>
+
| false
|-
+
|-
| 66
+
| {{Metadata id|}}
| SnowMan
+
| VarInt
| 0.7
+
|colspan="2"| Splash timer
| 1.9
+
| 0
| <code>minecraft:snow_golem</code>
+
|}
|- style="background: #ffff88;"
+
 
| 67
+
=== End Crystal ===
| Snowball
+
 
| 0.25
+
{{Metadata inherit|End Crystal|inherits=Entity}}
| 0.25
+
 
| <code>minecraft:snowball</code>
+
{| class="wikitable"
|- style="background: #ffff88;"
+
! Index
| 68
+
! Type
| SpectralArrow
+
!style="width: 250px;" colspan="2"| Meaning
| 0.5
+
! Default
| 0.5
+
|-
| <code>minecraft:spectral_arrow</code>
+
| {{Metadata id|}}
|-
+
| OptBlockPos
| 69
+
|colspan="2"| Beam target
| Spider
+
| Empty
| 1.4
+
|-
| 0.9
+
| {{Metadata id|}}
| <code>minecraft:spider</code>
+
| Boolean
|-
+
|colspan="2"| Show bottom
| 70
+
| true
| Squid
+
|}
| 0.8
+
 
| 0.8
+
=== Dragon Fireball ===
| <code>minecraft:squid</code>
+
 
|-
+
{{Metadata inherit|Dragon Fireball|inherits=Entity}}
| 71
+
 
| Stray
+
No additional metadata.
| 0.6
+
 
| 1.99
+
=== Small Fireball ===
| <code>minecraft:stray</code>
+
 
|-
+
{{Metadata inherit|Small Fireball|inherits=Entity}}
| 72
+
 
| Tropical Fish
+
This is the fireball shot by blazes and dispensers with fire charges.
| 0.5
+
 
| 0.4
+
{| class="wikitable"
| <code>minecraft:tropical_fish</code>
+
! Index
|-
+
! Type
| 73
+
!style="width: 250px;" colspan="2"| Meaning
| Turtle
+
! Default
| 1.2
+
|-
| 0.4
+
| {{Metadata id|}}
| <code>minecraft:turtle</code>
+
| [[Slot]]
|- style="background: #ffff88;"
+
|colspan="2"| Item
| 74
+
| Empty (which behaves as if it were a <code>minecraft:fire_charge</code>)
| ThrownEgg
+
|}
| 0.25
+
 
| 0.25
+
=== Fireball ===
| <code>minecraft:egg</code>
+
 
|- style="background: #ffff88;"
+
{{Metadata inherit|Fireball|inherits=Entity}}
| 75
+
 
| ThrownEnderpearl
+
This is the large fireball shot by ghasts.
| 0.25
+
 
| 0.25
+
{| class="wikitable"
| <code>minecraft:ender_pearl</code>
+
! Index
|- style="background: #ffff88;"
+
! Type
| 76
+
!style="width: 250px;" colspan="2"| Meaning
| ThrownExpBottle
+
! Default
| 0.25
+
|-
| 0.25
+
| {{Metadata id|}}
| <code>minecraft:experience_bottle</code>
+
| [[Slot]]
|- style="background: #ffff88;"
+
|colspan="2"| Item
| 77
+
| Empty
| ThrownPotion
+
|}
| 0.25
+
 
| 0.25
+
=== Wither Skull ===
| <code>minecraft:potion</code>
+
 
|-
+
{{Metadata inherit|Wither Skull|inherits=Entity}}
| 78
+
 
| Vex
+
{| class="wikitable"
| 0.4
+
! Index
| 0.8
+
! Type
| <code>minecraft:vex</code>
+
!style="width: 250px;" colspan="2"| Meaning
|-
+
! Default
| 79
+
|-
| Villager
+
| {{Metadata id|}}
| 0.6
+
| Boolean
| 1.95
+
|colspan="2"| Is invulnerable
| <code>minecraft:villager</code>
+
| false
|-
+
|}
| 80
+
 
| VillagerGolem (Iron Golem)
+
=== Firework Rocket Entity ===
| 1.4
+
 
| 2.7
+
{{Metadata inherit|Firework Rocket Entity|inherits=Entity}}
| <code>minecraft:iron_golem}</code>
+
 
|-
+
{| class="wikitable"
| 81
+
! Index
| VindicationIllager
+
! Type
| 0.6
+
!style="width: 250px;" colspan="2"| Meaning
| 1.95
+
! Default
| <code>minecraft:vindicator</code>
+
|-
|-
+
| {{Metadata id|}}
| 82
+
| [[Slot]]
| Witch
+
|colspan="2"| Firework info
| 0.6
+
| Empty
| 1.95
+
|-
| <code>minecraft:witch</code>
+
| {{Metadata id|}}
|-
+
| OptVarInt
| 83
+
|colspan="2"| Entity ID of entity which used firework (for elytra boosting)
| WitherBoss
+
| Empty
| 0.9
+
|-
| 3.5
+
| {{Metadata id|}}
| <code>minecraft:wither</code>
+
| Boolean
|-
+
|colspan="2"| Is shot at angle (from a crossbow)
| 84
+
| false
| WitherSkeleton
+
|}
| 0.7
+
 
| 2.4
+
=== Item Frame ===
| <code>minecraft:wither_skeleton</code>
+
 
|- style="background: #ffff88;"
+
{{Metadata inherit|Item Frame|inherits=Entity}}
| 85
+
 
| WitherSkull
+
{| class="wikitable"
| 0.3125
+
! Index
| 0.3125
+
! Type
| <code>minecraft:wither_skull</code>
+
!style="width: 250px;" colspan="2"| Meaning
|-
+
! Default
| 86
+
|-
| Wolf
+
| {{Metadata id|}}
| 0.6
+
| [[Slot]]
| 0.85
+
|colspan="2"| Item
| <code>minecraft:wolf</code>
+
| Empty
|-
+
|-
| 87
+
| {{Metadata id|}}
| Zombie
+
| VarInt
| 0.6
+
|colspan="2"| Rotation
| 1.95
+
| 0
| <code>minecraft:zombie</code>
+
|}
|-
+
 
| 88
+
=== Item Entity ===
| ZombieHorse
+
 
| 1.3964844
+
{{Metadata inherit|Item Entity|inherits=Entity}}
| 1.6
+
 
| <code>minecraft:zombie_horse</code>
+
{| class="wikitable"
|-
+
! Index
| 89
+
! Type
| ZombieVillager
+
!style="width: 250px;" colspan="2"| Meaning
| 0.6
+
! Default
| 1.95
+
|-
| <code>minecraft:zombie_villager</code>
+
| {{Metadata id|}}
|-
+
| [[Slot]]
| 90
+
|colspan="2"| Item
| Phantom
+
| Empty
| 0.9
+
|}
| 0.5
+
 
| <code>minecraft:phantom</code>
+
=== Living Entity ===
|- style="background: #aaaaff;"
+
 
| 91
+
{{Metadata inherit|Living Entity|inherits=Entity}}
| Lightning Bolt
+
 
| -
+
{| class="wikitable"
| -
+
! Index
| <code>minecraft:lightning_bolt</code>
+
! Type
|- style="background: #aaaaff;"
+
!style="width: 250px;" colspan="2"| Meaning
| 92
+
! Default
| Player
+
|-
| 0.8
+
|rowspan="5"| {{Metadata id|}}
| 1.8
+
|rowspan="5"| Byte
| <code>minecraft:player</code>
+
|colspan="2"| Hand states, used to trigger blocking/eating/drinking animation.
|- style="background: #ffff88;"
+
|rowspan="5"| 0
| 93
+
|-
| Fishing bobber
+
! Bit mask
| ?
+
! Meaning
| ?
+
|-
| <code>minecraft:fishing_bobber</code>
+
| 0x01
|- style="background: #ffff88;"
+
| Is hand active
| 94
+
|-
| Trident
+
| 0x02
| ?
+
| Active hand (0 = main hand, 1 = offhand)
| ?
+
|-
| <code>minecraft:trident</code>
+
| 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
 +
|}
 +
 
 +
=== Player ===
 +
 
 +
{{Metadata inherit|Player|inherits=Living Entity}}
 +
 
 +
{| class="wikitable"
 +
! Index
 +
! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
! Default
 +
|-
 +
| {{Metadata id|}}
 +
| Float
 +
|colspan="2"| Additional Hearts
 +
| 0.0
 +
|-
 +
| {{Metadata id|}}
 +
| VarInt
 +
|colspan="2"| Score
 +
| 0
 +
|-
 +
|rowspan="10"| {{Metadata id|}}
 +
|rowspan="10"| Byte
 +
|colspan="2"| The Displayed Skin Parts bit mask that is sent in [[Protocol#Client Settings|Client Settings]]
 +
|rowspan="10"| 0
 +
|-
 +
! Bit mask !! Meaning
 +
|-
 +
| 0x01 || Cape enabled
 +
|-
 +
| 0x02 || Jacket enabled
 +
|-
 +
| 0x04 || Left sleeve enabled
 +
|-
 +
| 0x08 || Right sleeve enabled
 +
|-
 +
| 0x10 || Left pants leg enabled
 +
|-
 +
| 0x20 || Right pants leg enabled
 +
|-
 +
| 0x40 || Hat enabled
 +
|-
 +
| 0x80 || ''Unused''
 +
|-
 +
| {{Metadata id|}}
 +
| Byte
 +
|colspan="2"| Main hand (0 : Left, 1 : Right)
 +
| 1
 +
|-
 +
| {{Metadata id|}}
 +
| [[NBT]]
 +
|colspan="2"| Left shoulder entity data (for occupying parrot)
 +
| Empty
 +
|-
 +
| {{Metadata id|}}
 +
| [[NBT]]
 +
|colspan="2"| Right shoulder entity data (for occupying parrot)
 +
| Empty
 +
|}
  
== Objects ==
+
=== Armor Stand ===
  
Objects are spawned via [[Protocol#Spawn_Object|Spawn Object]]. See [[Object Data]] for more details.
+
{{Metadata inherit|Armor Stand|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
+
|-
|-  
+
|rowspan="5"| {{Metadata id|}}
| 1
+
|rowspan="5"| Byte
| Boat
+
! Bit mask
| 1.375
+
! Meaning
| 0.6
+
|rowspan="5"| 0
|-  
+
|-
| 2
+
| 0x01
| Item Stack ([[Slot]])
+
| Is Small
| 0.25
+
|-
| 0.25
+
| 0x04
|-
+
| Has Arms
| 3
+
|-
| Area Effect Cloud
+
| 0x08
| 2.0 * Radius
+
| Has no BasePlate
| 0.5
+
|-
|-  
+
| 0x10
| 10
+
| Is Marker
| Minecart
+
|-
| 0.98
+
| {{Metadata id|}}
| 0.7
+
| Rotations
|-
+
|colspan="2"| Head rotation
| 50
+
| (0.0, 0.0, 0.0)
| Activated TNT
+
|-
| 0.98
+
| {{Metadata id|}}
| 0.98
+
| Rotations
|-  
+
|colspan="2"| Body rotation
| 51
+
| (0.0, 0.0, 0.0)
| EnderCrystal
+
|-
| 2.0
+
| {{Metadata id|}}
| 2.0
+
| Rotations
|-  
+
|colspan="2"| Left arm rotation
| 60
+
| (-10.0, 0.0, -10.0)
| Tipped arrow (projectile; also used for regular arrows)
+
|-
| 0.5
+
| {{Metadata id|}}
| 0.5
+
| Rotations
|-  
+
|colspan="2"| Right arm rotation
| 61
+
| (-15.0, 0.0, 10.0)
| Snowball (projectile)
+
|-
| 0.25
+
| {{Metadata id|}}
| 0.25
+
| Rotations
|-  
+
|colspan="2"| Left leg rotation
| 62
+
| (-1.0, 0.0, -1.0)
| Egg (projectile)
+
|-
| 0.25
+
| {{Metadata id|}}
| 0.25
+
| Rotations
|-  
+
|colspan="2"| Right leg rotation
| 63
+
| (1.0, 0.0, 1.0)
| FireBall (ghast projectile)
+
|}
| 1.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.
|-
+
 
| 64
+
=== Mob ===
| FireCharge (blaze projectile)
+
 
| 0.3125
+
{{Metadata inherit|Mob|inherits=Living Entity}}
| 0.3125
+
 
|-  
+
{| class="wikitable"
| 65
+
! Index
| Thrown Enderpearl
+
! Type
| 0.25
+
!style="width: 250px;" colspan="2"| Meaning
| 0.25
+
! Default
|-
+
|-
| 66
+
|rowspan="4"| {{Metadata id|}}
| Wither Skull (projectile)
+
|rowspan="4"| Byte
| 0.3125
+
! Bit mask
| 0.3125
+
! Meaning
|-  
+
|rowspan="4"| 0
| 67
+
|-
| Shulker Bullet
+
| 0x01
| 0.3125
+
| NoAI
| 0.3125
+
|-
|-
+
| 0x02
| 68
+
| Is left handed
| Llama spit
+
|-
| 0.25
+
| 0x04
| 0.25
+
| Is agressive
|-
+
|-
| 70
+
|}
| Falling Objects
+
 
| 0.98
+
=== Ambient Creature ===
| 0.98
+
 
|-  
+
{{Metadata inherit|Ambient Creature|inherits=Mob}}
| 71
+
 
| Item frames
+
No additional metadata.
| 0.75 or 0.0625
+
 
| 0.75
+
=== Bat ===
|-  
+
 
| 72
+
{{Metadata inherit|Bat|inherits=Ambient Creature}}
| 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
+
| rowspan="2"| {{Metadata id|}}
|-
+
| rowspan="2"| Byte
| 75
+
! Bit mask
| Thrown Exp Bottle
+
! Meaning
| 0.25
+
| rowspan="2"| 0
| 0.25
+
|-
|-
+
| 0x01
| 76
+
| Is hanging
| Firework Rocket
+
|}
| 0.25
+
 
| 0.25
+
=== Pathfinder Mob ===
|-
+
 
| 77
+
{{Metadata inherit|Pathfinder Mob|inherits=Mob}}
| Leash Knot
+
 
| 0.375
+
No additional metadata.
| 0.5
+
 
|-
+
=== Water Animal ===
| 78
+
 
| ArmorStand
+
{{Metadata inherit|Water Animal|inherits=Pathfinder Mob}}
| normal: 0.5 marker: 0.0 small: 0.25
+
 
| normal: 1.975 marker: 0.0 small: 0.9875
+
No additional metadata.
|-
+
 
| 79
+
=== Squid ===
| Evocation Fangs
+
 
| 0.5
+
{{Metadata inherit|Squid|inherits=Water Animal}}
| 0.8
+
 
|-  
+
No additional metadata.
| 90
+
 
| Fishing Hook
+
=== Dolphin ===
| 0.25
+
 
| 0.25
+
{{Metadata inherit|Dolphin|inherits=Water Animal}}
|-
+
 
| 91
+
{| class="wikitable"
| Spectral Arrow
+
! Index
| 0.5
+
! Type
| 0.5
+
!style="width: 250px;" colspan="2"| Meaning
|-
+
! Default
| 93
+
|-
| Dragon Fireball
+
| {{Metadata id|}}
| 1.0
+
| Position
| 1.0
+
|colspan="2"| Treasure position
|-
+
| (0, 0, 0)
| 94
+
|-
| Trident
+
| {{Metadata id|}}
| ?
+
| Boolean
| ?
+
|colspan="2"| Can find treasure
|}
+
| false
 +
|-
 +
| {{Metadata id|}}
 +
| 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
 +
|-
 +
| {{Metadata id|}}
 +
| Boolean
 +
|colspan="2"| From bucket
 +
| False
 +
|}
 +
 
 +
=== Cod ===
  
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.
+
{{Metadata inherit|Cod|inherits=Abstract fish}}
  
== Entity Metadata Format ==
+
No additional metadata.
  
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.
+
=== Puffer fish ===
  
Entity Metadata is an array of entries, each of which looks like the following:
+
{{Metadata inherit|Puffer fish|inherits=Abstract fish}}
  
 
{| class="wikitable"
 
{| class="wikitable"
  ! Name
+
  ! Index
 
  ! Type
 
  ! Type
  ! Meaning
+
  !style="width: 250px;" colspan="2"| Meaning
 +
! Default
 
  |-
 
  |-
  | Index
+
  | {{Metadata id|}}
| Unsigned Byte
+
  | VarInt
| 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.
+
  |colspan="2"| PuffState (varies from 0 to 2)
|-
+
  | 0
  | 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
 
 
  |}
 
  |}
 +
 +
=== Salmon ===
 +
 +
{{Metadata inherit|Salmon|inherits=Abstract fish}}
 +
 +
No additional metadata.
 +
 +
=== Tropical fish ===
 +
 +
{{Metadata inherit|Tropical fish|inherits=Abstract fish}}
  
 
{| class="wikitable"
 
{| class="wikitable"
  ! Value of Type field
+
  ! Index
  ! [[Data types|Type]] of Value field
+
! Type
  ! Notes
+
  !style="width: 250px;" colspan="2"| Meaning
 +
  ! Default
 
  |-
 
  |-
 +
| {{Metadata id|}}
 +
| VarInt
 +
|colspan="2"| Variant
 
  | 0
 
  | 0
  | Byte
+
  |}
|
+
 
  |-
+
=== Ageable Mob ===
  | 1
+
 
  | VarInt
+
{{Metadata inherit|Ageable Mob|inherits=Pathfinder Mob}}
  |
+
 
 +
{| class="wikitable"
 +
  ! Index
 +
  ! Type
 +
  !style="width: 250px;" colspan="2"| Meaning
 +
  ! Default
 
  |-
 
  |-
  | 2
+
  | {{Metadata id|}}
  | Float
+
  | Boolean
  |
+
  |colspan="2"| Is baby
  |-
+
  | false
  | 3
+
  |}
  | String
+
 
  |
+
=== Animal ===
 +
 
 +
{{Metadata inherit|Animal|inherits=Ageable Mob}}
 +
 
 +
No additional metadata.
 +
 
 +
=== Abstract Horse ===
 +
 
 +
{{Metadata inherit|Abstract Horse|inherits=Animal}}
 +
 
 +
{| class="wikitable"
 +
  ! Index
 +
! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
  ! Default
 
  |-
 
  |-
  | 4
+
  |rowspan="9"| {{Metadata id|}}
  | [[Chat]]
+
  |rowspan="9"| Byte
  |
+
! Bit mask
 +
! Meaning
 +
  |rowspan="9"| 0
 
  |-
 
  |-
  | 5
+
  | 0x01
  | OptChat (Boolean + Optional [[Chat]])
+
  | ''Unused''
| [[Chat]] is present if the Boolean is set to true
 
 
  |-
 
  |-
  | 6
+
  | 0x02
| [[Slot]]
+
  | Is Tame
  |
 
 
  |-
 
  |-
  | 7
+
  | 0x04
| Boolean
+
  | Is saddled
  |
 
 
  |-
 
  |-
  | 8
+
  | 0x08
  | Rotation
+
  | Has bred
| 3 floats: rotation on x, rotation on y, rotation on z
 
 
  |-
 
  |-
  | 9
+
  | 0x10
| [[Data Types#Position|Position]]
+
  | Is eating
  |
 
 
  |-
 
  |-
  | 10
+
  | 0x20
  | OptPosition (Boolean + Optional Position)
+
  | Is rearing (on hind legs)
| Position is present if the Boolean is set to true
 
 
  |-
 
  |-
  | 11
+
  | 0x40
  | Direction (VarInt)
+
  | Is mouth open
| (Down = 0, Up = 1, North = 2, South = 3, West = 4, East = 5)
 
 
  |-
 
  |-
  | 12
+
  | 0x80
  | OptUUID (Boolean + Optional UUID)
+
  | ''Unused''
| UUID is present if the Boolean is set to true
 
 
  |-
 
  |-
  | 13
+
  | {{Metadata id|}}
| OptBlockID (VarInt)
+
  | OptUUID
| 0 for absent (implies air); otherwise, a block state ID as per the global palette
+
  |colspan="2"| Owner
|-
+
  | Absent
| 14
 
| [[NBT]]
 
|
 
|-
 
  | 15
 
  | [[Data Types#Particle|Particle]]
 
  |
 
 
  |}
 
  |}
  
Entity classes also recursively inherit fields from classes they extend.
+
=== Horse ===
  
=== Entity ===
+
{{Metadata inherit|Horse|inherits=Abstract Horse}}
  
The base class.
+
{| class="wikitable"  
 
 
{| class="wikitable"
 
 
  ! Index
 
  ! Index
 
  ! Type
 
  ! Type
Line 1,819: Line 1,903:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  |rowspan="9"| 0
+
  | {{Metadata id|}}
  |rowspan="9"| Byte
+
| VarInt
  ! Bit mask
+
|colspan="2"| Variant (Color & Style)
  ! Meaning
+
| 0
  |rowspan="9"| 0
+
  |}
 +
 
 +
=== Zombie Horse ===
 +
 
 +
{{Metadata inherit|Zombie Horse|inherits=Abstract Horse}}
 +
 
 +
=== Skeleton Horse ===
 +
 
 +
{{Metadata inherit|Skeleton Horse|inherits=Abstract Horse}}
 +
 
 +
=== Chested Horse ===
 +
 
 +
{{Metadata inherit|Chested Horse|inherits=Abstract Horse}}
 +
 
 +
{| class="wikitable"  
 +
  ! Index
 +
  ! Type
 +
  !style="width: 250px;" colspan="2"| Meaning
 +
! Default
 
  |-
 
  |-
  | 0x01
+
  | {{Metadata id|}}
  | On Fire
+
| Boolean
 +
|colspan="2"| Has Chest
 +
| false
 +
  |}
 +
 
 +
=== Donkey ===
 +
 
 +
{{Metadata inherit|Donkey|inherits=Chested Horse}}
 +
 
 +
=== Llama ===
 +
 
 +
{{Metadata inherit|Llama|inherits=Chested Horse}}
 +
 
 +
{| class="wikitable"
 +
! Index
 +
! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
! Default
 
  |-
 
  |-
  | 0x02
+
  | {{Metadata id|}}
  | Crouched
+
| VarInt
 +
| colspan="2"| Strength (number of columns of 3 slots in the llama's inventory once a chest is equipped)
 +
  | 0
 
  |-
 
  |-
  | 0x04
+
  | {{Metadata id|}}
  | Unused (previously riding)
+
| VarInt
 +
  | colspan="2"| Carpet color (a dye color, or -1 if no carpet equipped)
 +
| -1
 
  |-
 
  |-
  | 0x08
+
  | {{Metadata id|}}
  | Sprinting
+
| 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}}
 +
 
 +
No additional metadata.
 +
 
 +
=== Mule ===
 +
 
 +
{{Metadata inherit|Mule|inherits=Chested Horse}}
 +
 
 +
=== Bee ===
 +
 
 +
{{Metadata inherit|Bee|inherits=Animal}}
 +
 
 +
{| class="wikitable"
 +
! Index
 +
! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
! Default
 
  |-
 
  |-
  | 0x10
+
  |rowspan="5"| {{Metadata id|}}
  | Swimming
+
|rowspan="5"| Byte
 +
  |colspan="2"| Flags
 +
|rowspan="5"| 0
 
  |-
 
  |-
  | 0x20
+
  | 0x01 || ''Unused''
| Invisible
 
 
  |-
 
  |-
  | 0x40
+
  | 0x02 || Is angry
  | Glowing effect
+
  |-
 +
| 0x04 || Has stung
 
  |-
 
  |-
  | 0x80
+
  | 0x08 || Has nectar
| Flying with {{Minecraft Wiki|elytra}}
 
 
  |-
 
  |-
  | 1
+
  | {{Metadata id|}}
 
  | VarInt
 
  | VarInt
  |colspan="2"| Air
+
  | colspan="2"| Anger time in ticks
  | 300
+
  | 0 (Not angry)
|-
 
| 2
 
| OptChat
 
|colspan="2"| Custom name
 
| empty
 
|-
 
| 3
 
| Boolean
 
|colspan="2"| Is custom name visible
 
| false
 
|-
 
| 4
 
| Boolean
 
|colspan="2"| Is silent
 
| false
 
|-
 
| 5
 
| Boolean
 
|colspan="2"| No gravity
 
| false
 
 
  |}
 
  |}
  
=== Throwable ===
+
=== Fox ===
  
Extends [[#Entity|Entity]].
+
{{Metadata inherit|Fox|inherits=Animal}}
  
No additional metadata.
+
{| class="wikitable"
 
+
! Index
=== Egg ===
+
! Type
 
+
!style="width: 250px;" colspan="2"| Meaning
Extends [[#Throwable|Throwable]].
+
! Default
 +
|-
 +
| {{Metadata id|}}
 +
| VarInt
 +
| colspan="2" | Type (0: red, 1: snow)
 +
| 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
 +
|}
  
No additional metadata.
+
=== Ocelot ===
  
=== Ender Pearl ===
+
{{Metadata inherit|Ocelot|inherits=Animal}}
  
Extends [[#Throwable|Throwable]].
+
{| class="wikitable"
 
+
  ! Index
No additional metadata.
+
  ! Type
 
 
=== Experience Bottle ===
 
 
 
Extends [[#Throwable|Throwable]].
 
 
 
No additional metadata.
 
 
 
=== Snowball ===
 
 
 
Extends [[#Throwable|Throwable]].
 
 
 
No additional metadata.
 
 
 
=== Potion ===
 
 
 
Extends [[#Throwable|Throwable]].
 
 
 
{| class="wikitable"
 
  ! Index
 
  ! Type
 
 
  !style="width: 250px;" colspan="2"| Meaning
 
  !style="width: 250px;" colspan="2"| Meaning
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  | {{Metadata id|}}
  | [[Slot]]
+
  | Boolean
  |colspan="2"| Potion which is thrown
+
  |colspan="2"| Is trusting
  | Empty
+
  | false
 
  |}
 
  |}
  
=== Eye of Ender ===
+
=== Panda ===
  
Extends [[#Entity|Entity]].
+
{{Metadata inherit|Panda|inherits=Animal}}
 
 
No additional metadata.
 
 
 
=== FallingBlock ===
 
 
 
Extends [[#Entity|Entity]].
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 1,937: Line 2,076:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  | {{Metadata id|}}
  | [[Data Types#Position|Position]]
+
| Integer
  |colspan="2"| spawn position
+
|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, 0)
+
| 0
 +
|-
 +
  | {{Metadata id|}}
 +
| Integer
 +
  |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).
 +
  | 0
 +
|-
 +
| {{Metadata id|}}
 +
| Integer
 +
|colspan="2"| Eat timer.  If nonzero, counts upwards.
 +
| 0
 +
|-
 +
| {{Metadata id|}}
 +
| Byte
 +
|colspan="2"| Main Gene
 +
| 0
 +
|-
 +
| {{Metadata id|}}
 +
| Byte
 +
|colspan="2"| Hidden Gene
 +
| 0
 +
|-
 +
|rowspan="6"| {{Metadata id|}}
 +
|rowspan="6"| Byte
 +
! Bit mask
 +
! Meaning
 +
|rowspan="6"| 0
 +
|-
 +
| 0x01
 +
| Unused
 +
|-
 +
| 0x02
 +
| Is sneezing
 +
|-
 +
| 0x04
 +
| Is rolling
 +
|-
 +
| 0x08
 +
| Is sitting
 +
|-
 +
| 0x10
 +
| Is on back
 
  |}
 
  |}
  
=== AreaEffectCloud ===
+
=== Pig ===
  
Extends [[#Entity|Entity]].
+
{{Metadata inherit|Pig|inherits=Animal}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 1,953: Line 2,133:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  | {{Metadata id|}}
  | Float
+
  | Boolean
  |colspan="2"| Radius
+
  |colspan="2"| Has saddle
  | 0.5
+
  | false
 
  |-
 
  |-
  | 7
+
  | {{Metadata id|}}
 
  | VarInt
 
  | VarInt
  |colspan="2"| Color (only for mob spell particle)
+
  |colspan="2"| Total time to "boost" with a carrot on a stick for
 
  | 0
 
  | 0
|-
 
| 8
 
| Boolean
 
|colspan="2"| Ignore radius and show effect as single point, not area
 
| false
 
|-
 
| 9
 
| Particle
 
| colspan="2"| The [[#Particle]]
 
| <code>effect</code>
 
 
  |}
 
  |}
  
=== FishingHook ===
+
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 ===
 +
 
 +
{{Metadata inherit|Rabbit|inherits=Animal}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 1,984: Line 2,156:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  | {{Metadata id|}}
 
  | VarInt
 
  | VarInt
  |colspan="2"| Hooked entity id + 1, or 0 if there is no hooked entity
+
  |colspan="2"| Type
 
  | 0
 
  | 0
 
  |}
 
  |}
  
=== Arrow ===
+
=== Turtle ===
  
Extends [[#Entity|Entity]].
+
{{Metadata inherit|Turtle|inherits=Animal}}
 
 
Abstract base class for [[#TippedArrow|TippedArrow]] (which is used for regular arrows as well as tipped ones) and Spectral Arrow.
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,002: Line 2,172:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | rowspan="3" | 6
+
  | {{Metadata id|}}
  | rowspan="3" | Byte
+
| BlockPos
! Bit mask
+
  |colspan="2"| Home pos
! Meaning
+
  | (0, 0, 0)
  | rowspan="3" | 0
 
 
  |-
 
  |-
  | 0x01
+
  | {{Metadata id|}}
  | Is critical
+
| 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)
 
  |-
 
  |-
  | 0x02
+
  | {{Metadata id|}}
  | Is noclip (used by loyalty tridents when returning)
+
| Boolean
 +
  |colspan="2"| Is going home
 +
| false
 
  |-
 
  |-
  | 7
+
  | {{Metadata id|}}
  | OptUUID
+
  | Boolean
  |colspan="2"| Shooter UUID
+
  |colspan="2"| Is traveling
  | Empty
+
  | false
 
  |}
 
  |}
  
=== TippedArrow ===
+
=== Polar Bear ===
  
Extends [[#Arrow|Arrow]].
+
{{Metadata inherit|Polar Bear|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,032: Line 2,213:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 8
+
  | {{Metadata id|}}
  | VarInt
+
  | Boolean
  |colspan="2"| Color (-1 for no particles)
+
  |colspan="2"| Is standing up
  | -1
+
  | false
 
  |}
 
  |}
  
=== Trident ===
+
=== Chicken ===
 +
 
 +
{{Metadata inherit|Chicken|inherits=Animal}}
  
Extends [[#Arrow|Arrow]].
+
No additional metadata.
  
{| class="wikitable"
+
=== Cow ===
  ! Index
+
 
 +
{{Metadata inherit|Cow|inherits=Animal}}
 +
 
 +
No additional metadata.
 +
 
 +
=== Hoglin ===
 +
 
 +
{{Metadata inherit|Hoglin|inherits=Animal}}
 +
 
 +
{| class="wikitable"
 +
  ! Index
 
  ! Type
 
  ! Type
 
  !style="width: 250px;" colspan="2"| Meaning
 
  !style="width: 250px;" colspan="2"| Meaning
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 8
+
  | {{Metadata id|}}
  | VarInt
+
  | Boolean
  |colspan="2"| Loyalty level (enchantment)
+
  |colspan="2"| Is immune to zombification
  | 0
+
| false
 +
|}
 +
 +
=== Mooshroom ===
 +
 
 +
{{Metadata inherit|Mooshroom|inherits=Cow}}
 +
 
 +
{| class="wikitable"
 +
! Index
 +
! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
! Default
 +
|-
 +
| {{Metadata id|}}
 +
| String
 +
| colspan="2"| Variant ("red" or "brown")
 +
  | red
 
  |}
 
  |}
  
=== Boat ===
+
=== Sheep ===
  
Extends [[#Entity|Entity]].
+
{{Metadata inherit|Sheep|inherits=Animal}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,064: Line 2,273:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  |rowspan="3"| {{Metadata id|}}
| VarInt
+
  |rowspan="3"| Byte
  |colspan="2"| Time since last hit
+
! Bit mask
  | 0
+
! Meaning
 +
  |rowspan="3"| 0
 
  |-
 
  |-
  | 7
+
  | 0x0F
  | VarInt
+
  | Color ID
|colspan="2"| Forward direction
 
| 1
 
 
  |-
 
  |-
  | 8
+
  | 0x10
  | Float
+
  | Is sheared
  |colspan="2"| Damage taken
+
  |}
  | 0.0
+
 +
=== Strider ===
 +
 
 +
{{Metadata inherit|Strider|inherits=Animal}}
 +
 
 +
{| class="wikitable"
 +
! Index
 +
! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
  ! Default
 
  |-
 
  |-
  | 9
+
  | {{Metadata id|}}
 
  | VarInt
 
  | VarInt
  |colspan="2"| Type (0=oak, 1=spruce, 2=birch, 3=jungle, 4=acacia, 5=dark oak)
+
  |colspan="2"| Total time to "boost" with warped fungus on a stick for
 
  | 0
 
  | 0
 
  |-
 
  |-
  | 10
+
  | {{Metadata id|}}
 
  | Boolean
 
  | Boolean
  |colspan="2"| Left paddle turning
+
  |colspan="2"| Is shaking (true unless riding a vehicle or on or in a block tagged with strider_warm_blocks (default: lava))
 
  | false
 
  | false
 
  |-
 
  |-
  | 11
+
  | {{Metadata id|}}
 
  | Boolean
 
  | Boolean
  |colspan="2"| Right paddle turning
+
  |colspan="2"| Has saddle
 
  | false
 
  | false
|-
 
| 12
 
| VarInt
 
|colspan="2"| Splash timer
 
| 0
 
 
  |}
 
  |}
  
=== EnderCrystal ===
+
=== Tameable Animal ===
  
Extends [[#Entity|Entity]].
+
{{Metadata inherit|Tameable Animal|inherits=Animal}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,110: Line 2,322:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  |rowspan="4"| {{Metadata id|}}
  | OptPosition
+
|rowspan="4"| Byte
  |colspan="2"| Beam target
+
! Bit mask
 +
! Meaning
 +
|rowspan="4"| 0
 +
|-
 +
| 0x01
 +
| Is sitting
 +
|-
 +
| 0x02
 +
| ''Unused''
 +
|-
 +
| 0x04
 +
| Is tamed
 +
|-
 +
| {{Metadata id|}}
 +
  | OptUUID
 +
  |colspan="2"| Owner
 
  | Absent
 
  | Absent
|-
 
| 7
 
| Boolean
 
|colspan="2"| Show bottom
 
| true
 
 
  |}
 
  |}
  
=== Abstract Fireball ===
+
=== Cat ===
  
Extends [[#Entity|Entity]].
+
{{Metadata inherit|Cat|inherits=Tameable Animal}}
  
No additional metadata.
+
{| class="wikitable"
 
+
! Index
=== Dragon Fireball ===
+
! Type
 
+
!style="width: 250px;" colspan="2"| Meaning
Extends [[#Abstract Fireball|Abstract Fireball]].
+
! Default
 
+
|-
No additional metadata.
+
| {{Metadata id|}}
 +
| VarInt
 +
|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)
 +
| 1
 +
|-
 +
| {{Metadata id|}}
 +
| Boolean
 +
|colspan="2"| Is lying
 +
| false
 +
|-
 +
| {{Metadata id|}}
 +
| Boolean
 +
|colspan="2"| Is relaxed? (This makes their head go slightly upwards, unknown when used)
 +
| false
 +
|-
 +
| {{Metadata id|}}
 +
| VarInt
 +
|colspan="2"| Collar color (values are those {{Minecraft Wiki|Data_values#Dyes|used with dyes}})
 +
| 14 (Red)
 +
|}
  
=== Fireball ===
+
=== Wolf ===
  
Extends [[#Abstract Fireball|Abstract Fireball]].  This is the large fireball shot by ghasts.
+
{{Metadata inherit|Wolf|inherits=Tameable Animal}}
 
 
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,155: Line 2,384:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  | {{Metadata id|}}
 
  | Boolean
 
  | Boolean
  |colspan="2"| Invulnerable
+
  |colspan="2"| Is begging
 
  | false
 
  | false
 +
|-
 +
| {{Metadata id|}}
 +
| VarInt
 +
|colspan="2"| Collar color (values are those {{Minecraft Wiki|Data_values#Dyes|used with dyes}})
 +
| 14 (Red)
 +
|-
 +
| {{Metadata id|}}
 +
| VarInt
 +
|colspan="2"| Anger time
 +
| 0
 
  |}
 
  |}
  
=== Fireworks ===
+
=== Parrot ===
  
Extends [[#Entity|Entity]].
+
{{Metadata inherit|Parrot|inherits=Tameable Animal}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,171: Line 2,410:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  | {{Metadata id|}}
| [[Slot]]
+
  | VarInt
|colspan="2"| Firework info
+
  |colspan="2"| Variant (0: red/blue, 1: blue, 2: green, 3: yellow/blue, 4: grey)
| empty
 
|-
 
| 7
 
  | VarInt
 
  |colspan="2"| Entity ID of entity which used firework (for elytra boosting)
 
 
  | 0
 
  | 0
 
  |}
 
  |}
  
=== Hanging ===
+
=== Abstract Villager ===
 
 
Extends [[#Entity|Entity]].
 
 
 
No additional metadata.
 
  
=== ItemFrame ===
+
{{Metadata inherit|Abstract Villager|inherits=Ageable Mob}}
 
 
Extends [[#Hanging|Hanging]].
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,198: Line 2,426:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  | {{Metadata id|}}
| [[Slot]]
 
|colspan="2"| Item
 
| Empty
 
|-
 
| 7
 
 
  | VarInt
 
  | VarInt
  |colspan="2"| Rotation
+
  |colspan="2"| Head shake timer (starts at 40, decrements each tick)
 
  | 0
 
  | 0
 
  |}
 
  |}
  
=== Item ===
+
=== Villager ===
  
Extends [[#Entity|Entity]].
+
{{Metadata inherit|Villager|inherits=Abstract Villager}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,219: Line 2,442:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 6
+
  | {{Metadata id|}}
  | [[Slot]]
+
  | Villager Data
  |colspan="2"| Item
+
  |colspan="2"| Villager Data
  | Empty
+
  | Plains/None/1
 
  |}
 
  |}
  
=== Living ===
+
=== Wandering Trader ===
  
Extends [[#Entity|Entity]].
+
{{Metadata inherit|Wandering Trader|inherits=Abstract Villager}}
 +
 
 +
No additional metadata.
 +
 
 +
=== Abstract Golem ===
 +
 
 +
{{Metadata inherit|Abstract Golem|inherits=Pathfinder Mob}}
 +
 
 +
No additional metadata.
 +
 
 +
=== Iron Golem ===
 +
 
 +
{{Metadata inherit|Iron Golem|inherits=Abstract Golem}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,235: Line 2,470:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  |rowspan="5"| 6
+
  |rowspan="2"| {{Metadata id|}}
  |rowspan="5"| Byte
+
  |rowspan="2"| Byte
|colspan="2"| Hand states, used to trigger blocking/eating/drinking animation.
 
|rowspan="5"| 0
 
|-
 
 
  ! Bit mask
 
  ! Bit mask
 
  ! Meaning
 
  ! Meaning
 +
|rowspan="2"| 0
 
  |-
 
  |-
 
  | 0x01
 
  | 0x01
  | Is hand active
+
  | Is player-created
|-
 
| 0x02
 
| Active hand (0 = main hand, 1 = offhand)
 
|-
 
| 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
 
 
  |}
 
  |}
  
=== Player ===
+
=== Snow Golem ===
  
Extends [[#Living|Living]].
+
{{Metadata inherit|Snow Golem|inherits=Abstract Golem}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,283: Line 2,490:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 11
+
  |rowspan="3"| {{Metadata id|}}
| Float
+
  |rowspan="3"| Byte
  |colspan="2"| Additional Hearts
+
! Bit mask
  | 0.0
+
! Meaning
 +
  |rowspan="3"| 0x10
 
  |-
 
  |-
  | 12
+
  | 0x00
  | VarInt
+
  | Has no pumpkin hat
|colspan="2"| Score
 
| 0
 
 
  |-
 
  |-
  |rowspan="10"| 13
+
  | 0x10
|rowspan="10"| Byte
+
| Has pumpkin hat
  |colspan="2"| The Displayed Skin Parts bit mask that is sent in [[Protocol#Client Settings|Client Settings]]
+
|}
  |rowspan="10"| 0
+
 
 +
=== Shulker ===
 +
 
 +
{{Metadata inherit|Shulker|inherits=Abstract Golem}}
 +
 
 +
{| class="wikitable"
 +
  ! Index
 +
! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
  ! Default
 
  |-
 
  |-
  ! Bit mask !! Meaning
+
  | {{Metadata id|}}
 +
| Direction
 +
|colspan="2"| Attach face
 +
| Down (0)
 
  |-
 
  |-
  | 0x01 || Cape enabled
+
  | {{Metadata id|}}
 +
| OptPosition
 +
|colspan="2"| Attachment position
 +
| Absent
 
  |-
 
  |-
  | 0x02 || Jacket enabled
+
  | {{Metadata id|}}
|-
+
  | Byte
| 0x04 || Left sleeve enabled
+
  |colspan="2"| Shield height
|-
+
  | 0
| 0x08 || Right sleeve enabled
+
  |-  
|-
+
  | {{Metadata id|}}
  | 0x10 || Left pants leg enabled
 
  |-
 
| 0x20 || Right pants leg enabled
 
|-
 
  | 0x40 || Hat enabled
 
  |-
 
  | 0x80 || ''Unused''
 
|-
 
| 14
 
 
  | Byte
 
  | Byte
  |colspan="2"| Main hand (0 : Left, 1 : Right)
+
  | colspan="2"| Color (dye color)
  | 1
+
  | 10 (purple)
|-
 
| 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 ===
+
=== Monster ===
  
Extends [[#Living|Living]].
+
{{Metadata inherit|Monster|inherits=Pathfinder Mob}}
  
{| class="wikitable"
+
No additional metadata.
 +
 
 +
=== Base Piglin ===
 +
 
 +
{{Metadata inherit|Base Piglin|inherits=Monster}}
 +
 
 +
{| class="wikitable"
 
  ! Index
 
  ! Index
 
  ! Type
 
  ! Type
Line 2,342: Line 2,550:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  |rowspan="5"| 11
+
  | {{Metadata id|}}
  |rowspan="5"| Byte
+
| Boolean
  ! Bit mask
+
|colspan="2"| Is immune to zombification
  ! Meaning
+
  | false
  |rowspan="5"| 0
+
|}
 +
 +
=== Piglin ===
 +
 
 +
{{Metadata inherit|Piglin|inherits=Base Piglin}}
 +
 
 +
{| class="wikitable"
 +
  ! Index
 +
  ! Type
 +
  !style="width: 250px;" colspan="2"| Meaning
 +
! Default
 
  |-
 
  |-
  | 0x01
+
  | {{Metadata id|}}
  | is Small
+
| Boolean
 +
|colspan="2"| Is baby
 +
  | false
 
  |-
 
  |-
  | 0x04
+
  | {{Metadata id|}}
  | has Arms
+
| Boolean
 +
|colspan="2"| Is charging crossbow
 +
  | false
 
  |-
 
  |-
  | 0x08
+
  | {{Metadata id|}}
| no BasePlate
+
  | Boolean
|-
+
  |colspan="2"| Is dancing
| 0x10
+
  | false
| set Marker
+
  |}
|-
+
   
| 12
+
=== Piglin Brute ===
  | Rotation
+
 
  |colspan="2"| Head rotation
+
{{Metadata inherit|Piglin Brute|inherits=Base Piglin}}
  | (0.0, 0.0, 0.0)
+
 
  |-
+
No additional metadata.
  | 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.
 
  
=== Insentient ===
+
=== Blaze ===
  
Extends [[#Living|Living]].
+
{{Metadata inherit|Blaze|inherits=Monster}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,403: Line 2,599:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  |rowspan="3"| 11
+
  |rowspan="2"| {{Metadata id|}}
  |rowspan="3"| Byte
+
  |rowspan="2"| Byte
 
  ! Bit mask
 
  ! Bit mask
 
  ! Meaning
 
  ! Meaning
  |rowspan="3"| 0
+
  |rowspan="2"| 0
 
  |-
 
  |-
 
  | 0x01
 
  | 0x01
  | NoAI
+
  | Is on fire
|-
 
| 0x02
 
| Left handed
 
 
  |}
 
  |}
  
=== Ambient ===
+
=== Creeper ===
 
 
Extends [[#Insentient|Insentient]].
 
 
 
No additional metadata.
 
 
 
=== Bat ===
 
  
Extends [[#Ambient|Ambient]].
+
{{Metadata inherit|Creeper|inherits=Monster}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,432: Line 2,619:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | rowspan="2"| 12
+
  | {{Metadata id|}}
  | rowspan="2"| Byte
+
| VarInt
  ! Bit mask
+
|colspan="2"| State (-1 = idle, 1 = fuse)
  ! Meaning
+
  | -1
  | rowspan="2"| 0
+
|-
 +
  | {{Metadata id|}}
 +
  | Boolean
 +
  |colspan="2"| Is {{Minecraft Wiki|Creeper#Charged Creeper|charged}}
 +
| false
 
  |-
 
  |-
  | 0x01
+
  | {{Metadata id|}}
  | Is hanging
+
| Boolean
 +
  |colspan="2"| Is ignited
 +
| false
 
  |}
 
  |}
  
=== Creature ===
+
=== Endermite ===
  
Extends [[#Insentient|Insentient]].
+
{{Metadata inherit|Endermite|inherits=Monster}}
  
 
No additional metadata.
 
No additional metadata.
  
=== WaterMob ===
+
=== Giant ===
  
Extends [[#Creature|Creature]].
+
{{Metadata inherit|Giant|inherits=Monster}}
  
 
No additional metadata.
 
No additional metadata.
  
=== Squid ===
+
=== Guardian ===
 
 
Extends [[#WaterMob|WaterMob]]
 
 
 
No additional metadata.
 
 
 
=== Dolphin ===
 
  
Extends [[#WaterMob|WaterMob]].
+
{{Metadata inherit|Guardian|inherits=Monster}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,469: Line 2,656:
 
  !style="width: 250px;" colspan="2"| Meaning
 
  !style="width: 250px;" colspan="2"| Meaning
 
  ! Default
 
  ! Default
  |-
+
  |-  
  | 12
+
  | {{Metadata id|}}
| Position
 
|colspan="2"| Treasure position
 
| (0, 0, 0)
 
|-
 
| 13
 
 
  | Boolean
 
  | Boolean
  |colspan="2"| Can find treasure
+
  |colspan="2"| Is retracting spikes
 
  | false
 
  | false
 
  |-
 
  |-
  | 14
+
  | {{Metadata id|}}
  | Boolean
+
  | VarInt
  |colspan="2"| Has fish
+
  |colspan="2"| Target EID
  | false
+
  | 0
 
  |}
 
  |}
  
=== Abstract fish ===
+
=== Elder Guardian ===
  
Extends [[#WaterMob|WaterMob]].
+
{{Metadata inherit|Elder Guardian|inherits=Guardian}}
  
{| class="wikitable"
+
=== Silverfish ===
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
| 12
 
| Boolean
 
|colspan="2"| From bucket
 
| False
 
|}
 
 
 
=== Cod ===
 
  
Extends [[#AbstractFish|AbstractFish]].
+
{{Metadata inherit|Silverfish|inherits=Monster}}
  
 
No additional metadata.
 
No additional metadata.
  
=== Puffer fish ===
+
=== Raider ===
  
Extends [[#AbstractFish|AbstractFish]].
+
{{Metadata inherit|Raider|inherits=Monster}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,518: Line 2,688:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 13
+
  | {{Metadata id|}}
  | VarInt
+
  | boolean
  |colspan="2"| PuffState (varies from 0 to 2)
+
  | colspan="2"| Is celebrating
  | 0
+
  | false
 
  |}
 
  |}
  
=== Salmon ===
+
"Is celebrating" appears to control the pose for vindicators and does not appear to be used by other types.
 +
 
 +
=== Abstract Illager ===
  
Extends [[#AbstractFish|AbstractFish]].
+
{{Metadata inherit|Abstract Illager|inherits=Raider}}
  
 
No additional metadata.
 
No additional metadata.
  
=== Tropical fish ===
+
=== Vindicator ===
 +
 
 +
{{Metadata inherit|Vindicator|inherits=Abstract Illager}}
 +
 
 +
=== Pillager ===
 +
 
 +
{{Metadata inherit|Pillager|inherits=Abstract Illager}}
 +
 
 +
=== Spellcaster Illager ===
  
Extends [[#AbstractFish|AbstractFish]].
+
{{Metadata inherit|Spellcaster Illager|inherits=Abstract Illager}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,540: Line 2,720:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 13
+
  | {{Metadata id|}}
  | VarInt
+
  | Byte
  |colspan="2"| Variant
+
  | colspan="2"| Spell (0: none, 1: summon vex, 2: attack, 3: wololo, 4: disappear, 5: blindness)
 
  | 0
 
  | 0
 
  |}
 
  |}
  
 +
=== Evoker ===
  
=== Ageable ===
+
{{Metadata inherit|Evoker|inherits=Spellcaster Illager}}
  
Extends [[#Creature|Creature]].
+
=== Illusioner ===
 +
 
 +
{{Metadata inherit|Illusioner|inherits=Spellcaster Illager}}
 +
 
 +
=== Ravager ===
 +
 
 +
{{Metadata inherit|Ravager|inherits=Raider}}
 +
 
 +
No additional metadata.
 +
 
 +
=== Witch ===
 +
 
 +
{{Metadata inherit|Witch|inherits=Raider}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,557: Line 2,750:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 12
+
  | {{Metadata id|}}
 
  | Boolean
 
  | Boolean
  |colspan="2"| Is baby
+
  |colspan="2"| Is drinking potion
 
  | false
 
  | false
 
  |}
 
  |}
  
=== Animal ===
+
=== Evoker Fangs ===
  
Extends [[#Ageable|Ageable]].
+
{{Metadata inherit|Evoker Fangs|inherits=Entity}}
  
 
No additional metadata.
 
No additional metadata.
  
=== AbstractHorse ===
+
=== Vex ===
  
Extends [[#Animal|Animal]].
+
{{Metadata inherit|Vex|inherits=Monster}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,579: Line 2,772:
 
  ! 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 attacking
|-
 
| 0x02
 
  | Is Tame
 
|-
 
| 0x04
 
| Is saddled
 
|-
 
| 0x08
 
| Has bred
 
|-
 
| 0x10
 
| Is eating
 
|-
 
| 0x20
 
| Is rearing (on hind legs)
 
|-
 
| 0x40
 
| Is mouth open
 
|-
 
| 0x80
 
| ''Unused''
 
|-
 
| 14
 
| OptUUID
 
|colspan="2"| Owner
 
| Absent
 
 
  |}
 
  |}
  
=== Horse ===
+
=== Abstract Skeleton ===
 +
 
 +
{{Metadata inherit|Abstract Skeleton|inherits=Monster}}
  
Extends [[#AbstractHorse|AbstractHorse]].
+
No additional metadata.
  
{| class="wikitable"
+
=== Skeleton ===
! Index
+
 
! Type
+
{{Metadata inherit|Skeleton|inherits=Abstract Skeleton}}
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
| 15
 
| VarInt
 
|colspan="2"| Variant (Color & Style)
 
| 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 ===
+
=== Wither Skeleton ===
  
Extends [[#AbstractHorse|AbstractHorse]].
+
{{Metadata inherit|Wither Skeleton|inherits=Abstract Skeleton}}
  
=== SkeletonHorse ===
+
=== Stray ===
  
Extends [[#AbstractHorse|AbstractHorse]].
+
{{Metadata inherit|Stray|inherits=Abstract Skeleton}}
  
=== ChestedHorse ===
+
=== Spider ===
  
Extends [[#AbstractHorse|AbstractHorse]].
+
{{Metadata inherit|Spider|inherits=Monster}}
  
{| class="wikitable"  
+
{| class="wikitable"
 
  ! Index
 
  ! Index
 
  ! Type
 
  ! Type
Line 2,659: Line 2,810:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 15
+
  |rowspan="2"| {{Metadata id|}}
  | Boolean
+
  |rowspan="2"| Byte
  |colspan="2"| Has Chest
+
! Bit mask
  | false
+
! Meaning
 +
  |rowspan="2"| 0
 +
|-
 +
| 0x01
 +
  | Is climbing
 
  |}
 
  |}
  
=== Donkey ===
+
=== Wither ===
  
Extends [[#ChestedHorse|ChestedHorse]].
+
{{Metadata inherit|Wither|inherits=Monster}}
 
 
=== Llama ===
 
 
 
Extends [[#ChestedHorse|ChestedHorse]].
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,679: Line 2,830:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 16
+
  | {{Metadata id|}}
 +
| VarInt
 +
|colspan="2"| Center head's target (entity ID, or 0 if no target)
 +
| 0
 +
|-
 +
| {{Metadata id|}}
 
  | VarInt
 
  | VarInt
  | colspan="2"| Strength (number of columns of 3 slots in the llama's inventory once a chest is equipped)
+
  |colspan="2"| Left head's target (entity ID, or 0 if no target)
 
  | 0
 
  | 0
 
  |-
 
  |-
  | 17
+
  | {{Metadata id|}}
 
  | VarInt
 
  | VarInt
  | colspan="2"| Carpet color (a dye color, or -1 if no carpet equipped)
+
  |colspan="2"| Right head's target (entity ID, or 0 if no target)
  | -1
+
  | 0
 
  |-
 
  |-
  | 18
+
  | {{Metadata id|}}
 
  | VarInt
 
  | 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>)
+
  |colspan="2"| Invulnerable time
 
  | 0
 
  | 0
 
  |}
 
  |}
  
=== Mule ===
+
=== Zoglin ===
  
Extends [[#ChestedHorse|ChestedHorse]].
+
{{Metadata inherit|Hoglin|inherits=Monster}}
 
 
=== Pig ===
 
 
 
Extends [[#Animal|Animal]].
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,709: Line 2,861:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 13
+
  | {{Metadata id|}}
 
  | Boolean
 
  | Boolean
  |colspan="2"| Has saddle
+
  |colspan="2"| Is baby
 
  | 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.
+
=== Zombie ===
  
=== Rabbit ===
+
{{Metadata inherit|Zombie|inherits=Monster}}
 
 
Extends [[#Animal|Animal]].
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,732: Line 2,877:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 13
+
  | {{Metadata id|}}
 +
| Boolean
 +
|colspan="2"| Is baby
 +
| false
 +
|-
 +
| {{Metadata id|}}
 
  | VarInt
 
  | VarInt
  |colspan="2"| Type
+
  |colspan="2"| Unused (previously type)
 
  | 0
 
  | 0
 +
|-
 +
| {{Metadata id|}}
 +
| Boolean
 +
|colspan="2"| Is becoming a drowned
 +
| false
 
  |}
 
  |}
  
=== Turtle ===
+
=== Zombie Villager ===
  
Extends [[#Animal|Animal]].
+
{{Metadata inherit|Zombie Villager|inherits=Zombie}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,748: Line 2,903:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 13
+
  | {{Metadata id|}}
| BlockPos
 
|colspan="2"| Home pos
 
| (0, 0, 0)
 
|-
 
| 14
 
 
  | Boolean
 
  | Boolean
  |colspan="2"| Has egg
+
  |colspan="2"| Is converting
 
  | false
 
  | false
  |-
+
  |-  
  | 15
+
  | {{Metadata id|}}
| Boolean
+
  | Villager Data
|colspan="2"| Laying egg
+
  |colspan="2"| Villager Data
| false
+
  | Plains/None/1
|-
+
  |}
| 16
+
 
| BlockPos
+
=== Husk ===
|colspan="2"| Travel pos
+
 
| (0, 0, 0)
+
{{Metadata inherit|Husk|inherits=Zombie}}
|-
+
 
| 17
 
| Boolean
 
|colspan="2"| Going home
 
| false
 
|-
 
| 18
 
  | Boolean
 
  |colspan="2"| Traveling
 
  | false
 
  |}
 
 
 
=== Polar Bear ===
 
 
 
Extends [[#Animal|Animal]].
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
| 13
 
| Boolean
 
|colspan="2"| Standing up
 
| false
 
|}
 
 
 
=== Chicken ===
 
 
 
Extends [[#Animal|Animal]].
 
 
 
 
No additional metadata.
 
No additional metadata.
  
=== Cow ===
+
=== Drowned ===
  
Extends [[#Animal|Animal]].
+
{{Metadata inherit|Drowned|inherits=Zombie}}
  
 
No additional metadata.
 
No additional metadata.
  
=== Mooshroom ===
+
=== Zombified Piglin ===
  
Extends [[#Cow|Cow]].
+
{{Metadata inherit|Zombified Piglinn|inherits=Zombie}}
  
 
No additional metadata.
 
No additional metadata.
  
=== Sheep ===
+
=== Enderman ===
  
Extends [[#Animal|Animal]].
+
{{Metadata inherit|Enderman|inherits=Monster}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,823: Line 2,942:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  |rowspan="3"| 13
+
  | {{Metadata id|}}
  |rowspan="3"| Byte
+
| Opt BlockID
! Bit mask
+
  |colspan="2"| Carried block
! Meaning
+
  | Absent
  |rowspan="3"| 0
 
 
  |-
 
  |-
  | 0x0F
+
  | {{Metadata id|}}
  | Color (matches {{Minecraft Wiki|Data_values#Dyes|dye damage values}})
+
| Boolean
 +
  |colspan="2"| Is screaming
 +
| false
 
  |-
 
  |-
  | 0x10
+
  | {{Metadata id|}}
  | Is sheared
+
| Boolean
 +
  |colspan="2"| Is staring
 +
| false
 
  |}
 
  |}
  
=== TameableAnimal ===
+
=== Ender Dragon ===
  
Extends [[#Animal|Animal]].
+
{{Metadata inherit|Ender Dragon|inherits=Mob}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,846: Line 2,968:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  |rowspan="4"| 13
+
  | {{Metadata id|}}
  |rowspan="4"| Byte
+
  | VarInt
! Bit mask
+
  |colspan="2"| Dragon phase
! Meaning
+
  | 10 (hover)
  |rowspan="4"| 0
 
  |-
 
| 0x01
 
| Is sitting
 
|-
 
| 0x02
 
| Is angry (only used with wolves)
 
|-
 
| 0x04
 
| Is tamed
 
|-
 
| 14
 
| OptUUID
 
|colspan="2"| Owner
 
| Absent
 
 
  |}
 
  |}
  
=== Ocelot ===
+
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 ===
 +
 
 +
{{Metadata inherit|Flying|inherits=Mob}}
 +
 
 +
No additional metadata.
 +
 
 +
=== Ghast ===
  
Extends [[#TameableAnimal|TameableAnimal]].
+
{{Metadata inherit|Ghast|inherits=Flying}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,877: Line 3,004:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 15
+
  | {{Metadata id|}}
  | VarInt
+
  | Boolean
  |colspan="2"| Type (0 = untamed, 1 = tuxedo, 2 = tabby, 3 = siamese).  Used to render regardless as to whether it is tamed or not.
+
  |colspan="2"| Is attacking
  | 0
+
  | false
 
  |}
 
  |}
  
=== Wolf ===
+
=== Phantom ===
  
Extends [[#TameableAnimal|TameableAnimal]].
+
{{Metadata inherit|Phantom|inherits=Flying}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,893: Line 3,020:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 15
+
  | {{Metadata id|}}
| Float
+
  | VarInt
|colspan="2"| Damage taken (used for tail rotation)
+
  |colspan="2"| Size
| Value of health field (1.0)
+
  | 0
|-
 
| 16
 
| Boolean
 
|colspan="2"| Is begging
 
| false
 
|-
 
| 17
 
  | VarInt
 
  |colspan="2"| Collar color (values are those {{Minecraft Wiki|Data_values#Dyes|used with dyes}})
 
  | 14 (Red)
 
 
  |}
 
  |}
  
=== Parrot ===
+
Hitbox size is determined by horizontal=0.9 + 0.2*size and vertical=0.5 + 0.1 * i
  
Extends [[#TameableAnimal|TameableAnimal]].
+
=== Slime ===
  
{| class="wikitable"
+
{{Metadata inherit|Slime|inherits=Mob}}
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
| 15
 
| VarInt
 
|colspan="2"| Variant (0: red/blue, 1: blue, 2: green, 3: yellow/blue, 4: grey)
 
| 0
 
|}
 
 
 
=== Villager ===
 
 
 
Extends [[#Ageable|Ageable]].
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,935: Line 3,038:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 13
+
  | {{Metadata id|}}
 
  | VarInt
 
  | VarInt
  |colspan="2"| Profession (Farmer = 0, Librarian = 1, Priest = 2, Blacksmith = 3, Butcher = 4, Nitwit = 5)
+
  |colspan="2"| Size
  | 0
+
  | 1
 
  |}
 
  |}
  
=== Golem ===
+
=== Llama Spit ===
 
 
Extends [[#Creature|Creature]].
 
  
No additional metadata.
+
{{Metadata inherit|Llama Spit|inherits=Entity}}
  
=== IronGolem ===
+
=== Abstract Minecart===
  
Extends [[#Golem|Golem]].
+
{{Metadata inherit|Abstract Minecart|inherits=Entity}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 2,957: 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
 +
|-
 +
  | {{Metadata id|}}
 +
  | Float
 +
  |colspan="2"| Shaking multiplier
 +
| 0.0
 +
|-
 +
| {{Metadata id|}}
 +
| VarInt
 +
|colspan="2"| Custom block ID and damage
 +
| 0
 +
|-
 +
| {{Metadata id|}}
 +
| VarInt
 +
|colspan="2"| Custom block Y position (in 16ths of a block)
 +
| 6
 
  |-
 
  |-
  | 0x01
+
  | {{Metadata id|}}
  | Is player-created
+
| Boolean
 +
|colspan="2"| Show custom block
 +
  | false
 
  |}
 
  |}
  
=== Snowman ===
+
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 [[#Golem|Golem]].
+
* 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
{| class="wikitable"
+
* 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
! Index
+
* Hopper Minecarts contain a hopper (154:0) and have a y position of 1
! Type
+
* TNT Minecarts contain TNT (46:0) and have a y position of 6
!style="width: 250px;" colspan="2"| Meaning
+
* Command block minecarts contain a Command Block (137:0) and have a y position of 6
! Default
+
* Spawner Minecarts contain a spawner (52:0) and have a y position of 6
|-
 
|rowspan="3"| 12
 
|rowspan="3"| Byte
 
! Bit mask
 
! Meaning
 
|rowspan="3"| 0x10
 
|-
 
| 0x10
 
| has pumpkin hat
 
|-
 
| 0x00
 
| has no pumpkin hat
 
|}
 
 
 
=== Shulker ===
 
 
 
Extends [[#Golem|Golem]].
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
| 12
 
| Direction
 
|colspan="2"| Attach face
 
| Down (0)
 
|-
 
| 13
 
| OptPosition
 
|colspan="2"| Attachment position
 
| Absent
 
|-
 
| 14
 
| Byte
 
|colspan="2"| Shield height
 
| 0
 
|-
 
| 15
 
| Byte
 
| colspan="2"| Color (dye color)
 
| 10 (purple)
 
|}
 
 
 
=== Monster ===
 
 
 
Extends [[#Creature|Creature]].
 
 
 
No additional metadata.
 
 
 
=== Blaze ===
 
 
 
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 on fire
 
|}
 
 
 
=== Creeper ===
 
 
 
Extends [[#Monster|Monster]].
 
 
 
{| class="wikitable"
 
! Index
 
! Type
 
!style="width: 250px;" colspan="2"| Meaning
 
! Default
 
|-
 
| 12
 
| VarInt
 
|colspan="2"| State (-1 = idle, 1 = fuse)
 
| -1
 
|-
 
| 13
 
| Boolean
 
|colspan="2"| Is {{Minecraft Wiki|Creeper#Charged Creeper|charged}}
 
| false
 
|-
 
| 14
 
| Boolean
 
|colspan="2"| Is ignited
 
| false
 
|}
 
 
 
=== Endermite ===
 
 
 
Extends [[#Monster|Monster]].
 
 
 
No additional metadata.
 
 
 
=== Giant Zombie ===
 
 
 
Extends [[#Monster|Monster]].
 
 
 
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,545: Line 3,133:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 12
+
  | {{Metadata id|}}
 
  | Boolean
 
  | Boolean
 
  |colspan="2"| Has fuel
 
  |colspan="2"| Has fuel
Line 3,551: 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,573: 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,584: Line 3,172:
 
  |}
 
  |}
  
=== TNTPrimed ===
+
=== Primed Tnt ===
  
Extends [[#Entity|Entity]].
+
{{Metadata inherit|Primed Tnt|inherits=Entity}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 3,594: 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 </