Pre-release protocol
This page documents the changes from the last stable Minecraft release (currently 1.13.2, protocol 404) to the current pre-release (currently 1.14.4, protocol 498). Note that this page contains bleeding-edge information that may not be completely or correctly documented.
One who wishes to commandeer the merging of this into Protocol when an update is made must be sure to respect any changes that may have occurred to the respective packets there.
Contents
Contents
- 1 Contents
- 2 New/modified data types
- 3 Entity Metadata
- 3.1 Entity Metadata Format
- 3.2 Mobs
- 3.3 Entity
- 3.4 Itemed Throwable
- 3.5 Egg
- 3.6 Ender Pearl
- 3.7 Experience Bottle
- 3.8 Snowball
- 3.9 Eye of Ender
- 3.10 Arrow
- 3.11 TippedArrow
- 3.12 Trident
- 3.13 Itemed Fireball
- 3.14 Fireball
- 3.15 Small Fireball
- 3.16 Fireworks
- 3.17 Living
- 3.18 Panda
- 3.19 Fox
- 3.20 Mooshroom
- 3.21 Raid Participent
- 3.22 Abstract Illager
- 3.23 Spellcaster Illager
- 3.24 EvocationIllager Evoker
- 3.25 IllusionIllager Illusioner
- 3.26 Pillager
- 3.27 VindicationIllager Vindicator
- 3.28 Ravager
- 3.29 Witch
- 3.30 AbstractSkeleton
- 3.31 Zombie
- 3.32 Zombie Villager
- 3.33 Ocelot
- 3.34 Cat
- 3.35 Horse
- 3.36 Trader Llama
- 3.37 Abstract Merchant
- 3.38 Villager
- 3.39 Wandering Trader
- 4 Block Actions
- 5 Inventories
- 6 Plugin Channels
- 7 Play
- 8 Handshaking
- 9 Status
- 10 Login
Data types
Merged
Packets
| ID | Packet name | Documentation | |
|---|---|---|---|
| Handshaking serverbound | |||
| 0x00 | Handshake | Current | Pre |
New/modified data types
No changes so far.
Entity Metadata
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.
Entity Metadata Format
Note that entity metadata is a totally distinct concept from block metadata. It is not required to send all metadata fields, or even any metadata fields, so long as the terminating entry is correctly sent.
Entity Metadata is an array of entries, each of which looks like the following:
| Name | Type | Meaning |
|---|---|---|
| Index | Unsigned Byte | Unique index key determining the meaning of the following value, see the table below. If this is 0xff then the it is the end of the Entity Metadata array and no more is read.
|
| Type | Optional VarInt Enum | Only if Index is not 0xff; the type of the index, see the table below
|
| Value | Optional value of Type | Only if Index is not 0xff: the value of the metadata field
|
| Value of Type field | Type of Value field | Notes |
|---|---|---|
| 0 | Byte | |
| 1 | VarInt | |
| 2 | Float | |
| 3 | String | |
| 4 | Chat | |
| 5 | OptChat (Boolean + Optional Chat) | Chat is present if the Boolean is set to true |
| 6 | Slot | |
| 7 | Boolean | |
| 8 | Rotation | 3 floats: rotation on x, rotation on y, rotation on z |
| 9 | Position | |
| 10 | OptPosition (Boolean + Optional Position) | Position is present if the Boolean is set to true |
| 11 | Direction (VarInt) | (Down = 0, Up = 1, North = 2, South = 3, West = 4, East = 5) |
| 12 | OptUUID (Boolean + Optional UUID) | UUID is present if the Boolean is set to true |
| 13 | OptBlockID (VarInt) | 0 for absent otherwise, id << 4 | data
|
| 14 | NBT | |
| 15 | Particle | |
| 16 | Villager Data | 3 VarInts: villager type, villager profession, level |
| 17 | OptVarInt | 0 for absent; 1 + actual value otherwise. Used for entity IDs. |
| 18 | Pose | A VarInt enum: 0: STANDING, 1: FALL_FLYING, 2: SLEEPING, 3: SWIMMING, 4: SPIN_ATTACK, 5: SNEAKING, 6: DYING |
Villager type (minecraft:villager_type registry):
| Name | ID |
|---|---|
minecraft:desert |
0 |
minecraft:jungle |
1 |
minecraft:plains |
2 |
minecraft:savanna |
3 |
minecraft:snow |
4 |
minecraft:swamp |
5 |
minecraft:taiga |
6 |
Villager professions (minecraft:villager_profession registry):
| Name | ID |
|---|---|
minecraft:none |
0 |
minecraft:armorer |
1 |
minecraft:butcher |
2 |
minecraft:cartographer |
3 |
minecraft:cleric |
4 |
minecraft:farmer |
5 |
minecraft:fisherman |
6 |
minecraft:fletcher |
7 |
minecraft:leatherworker |
8 |
minecraft:librarian |
9 |
minecraft:mason |
10 |
minecraft:nitwit |
11 |
minecraft:shepherd |
12 |
minecraft:toolsmith |
13 |
minecraft:weaponsmith |
14 |
Mobs
Entity IDs have shifted with the addition of some new mobs.
Entity
The base class.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| 0 | Byte | Bit mask | Meaning | 0 |
| 0x01 | On Fire | |||
| 0x02 | Crouched | |||
| 0x04 | Unused (previously riding) | |||
| 0x08 | Sprinting | |||
| 0x10 | Swimming | |||
| 0x20 | Invisible | |||
| 0x40 | Glowing effect | |||
| 0x80 | Flying with elytra | |||
| 1 | VarInt | Air | 300 | |
| 2 | OptChat | Custom name | empty | |
| 3 | Boolean | Is custom name visible | false | |
| 4 | Boolean | Is silent | false | |
| 5 | Boolean | No gravity | false | |
| 6 | Pose | Pose | STANDING | |
Itemed Throwable
Extends Throwable.
Used for all things that previously extended throwable other than potions, which already had an item.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| 7 | Slot | Item | empty (which behaves as if it were a specific item, depending on the subclass) | |
Egg
Extends Itemed Throwable.
No additional metadata.
An empty item behaves as if the item were a minecraft:egg.
Ender Pearl
Extends Itemed Throwable.
No additional metadata.
An empty item behaves as if the item were a minecraft:ender_pearl.
Experience Bottle
Extends Itemed Throwable.
No additional metadata.
minecraft:experience_bottle
Snowball
Extends Itemed Throwable.
No additional metadata.
minecraft:snowball
Eye of Ender
Extends Entity.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| 7 | Slot | Item | empty (which behaves as if it were a minecraft:ender_eye)
| |
Arrow
Extends Entity.
Abstract base class for TippedArrow (which is used for regular arrows as well as tipped ones) and Spectral Arrow.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| Byte | Bit mask | Meaning | 0 | |
| 0x01 | Is critical | |||
| 0x02 | Is noclip (used by loyalty tridents when returning) | |||
| OptUUID | Shooter UUID | Empty | ||
| 9 | Byte | Piercing level | 0 | |
TippedArrow
Extends Arrow.
Used for both tipped and regular arrows. If not tipped, then color is set to -1 and no tipped arrow particles are used.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| VarInt | Color (-1 for no particles) | -1 | ||
Trident
Extends Arrow.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| VarInt | Loyalty level (enchantment) | 0 | ||
Itemed Fireball
Extends Entity.
Used for regular and small fireballs. Not used for dragon fireballs and wither skulls. Interestingly, regular fireballs do not come from an item.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| 7 | Slot | Item | empty (which behaves as if it were a minecraft:fire_charge)
| |
Fireball
Extends Abstract Fireball Itemed Fireball. This is the large fireball shot by ghasts.
No additional metadata.
Small Fireball
Extends Abstract Fireball Itemed Fireball. This is the fireball shot by blazes and dispensers with fire charges.
No additional metadata.
Fireworks
Extends Entity.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| Slot | Firework info | empty | ||
| Entity ID of entity which used firework (for elytra boosting) | 0 | |||
| 9 | Boolean | Shot at angle (from a crossbow) | false | |
Living
Extends Entity.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| Byte | Hand states, used to trigger blocking/eating/drinking animation. | 0 | ||
| Bit mask | Meaning | |||
| 0x01 | Is hand active | |||
| 0x02 | Active hand (0 = main hand, 1 = offhand) | |||
| 0x04 | In riptide spin attack | |||
| Float | Health | 1.0 | ||
| VarInt | Potion effect color (or 0 if there is no effect) | 0 | ||
| Boolean | Is potion effect ambient: reduces the number of particles generated by potions to 1/5 the normal amount | false | ||
| VarInt | Number of arrows in entity | 0 | ||
| 12 | OptBlockPos | Unknown (Bed location?) | Absent | |
Panda
Extends Animal.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| 15 | Integer | Breed timer? Set to 32 when something happens, and then counts down to 0 again. At 29 and 14 (before counting down), will play the entity.panda.cant_breed sound event.
|
0 | |
| 16 | Integer | Sneeze timer. Counts up from 0; when it hits 1 the entity.panda.pre_sneeze event plays and when it hits 21 the entity.panda.sneeze event plays (and it is set back to 0 and the sneeze flag is cleared).
|
0 | |
| 17 | Integer | Eat timer. If nonzero, counts upwards. | 0 | |
| 18 | Byte | Main Gene | 0 | |
| 19 | Byte | Hidden Gene | 0 | |
| 20 | Byte | Bit mask | Meaning | 0 |
| 0x01 | Unused | |||
| 0x02 | Is sneezing | |||
| 0x04 | Is eating | |||
| 0x08 | Unknown | |||
| 0x10 | Unknown | |||
Fox
Extends Animal.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| 15 | VarInt | Type (0: red, 1: snow) | 0 (red) | |
| 16 | Byte | Bit mask | Meaning | 0 |
| 0x01 | Sitting | |||
| 0x02 | Unused | |||
| 0x04 | Crouching | |||
| 0x08 | Unknown | |||
| 0x10 | Unknown | |||
| 0x20 | Sleeping | |||
| 0x40 | Unknown | |||
| 0x80 | Unknown | |||
| 17 | OptUUID | First UUID (in UUIDs NBT)?
|
Absent | |
| 18 | OptUUID | Second UUID (in UUIDs NBT)?
|
Absent | |
Mooshroom
Extends Cow.
No additional metadata.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| 15 | String | Variant ("red" or "brown") | red | |
Raid Participent
Extends Monster.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| 14 | boolean | Is celebrating | false | |
"Is celebrating" appears to control the pose for vindicators and does not appear to be used by other types.
Abstract Illager
Extends Monster Raid Participent.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| 12 | Byte | Bit mask | Meaning | 0 |
| 0x01 | Has target (aggressive state) | |||
Replaced with pose (presumably?)
Spellcaster Illager
Extends Abstract Illlager.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| Byte | Spell (0: none, 1: summon vex, 2: attack, 3: wololo, 4: disappear, 5: blindness) | 0 | ||
EvocationIllager Evoker
Extends Spellcaster Illager.
IllusionIllager Illusioner
Extends Spellcaster Illager.
Pillager
Extends Abstract Illlager.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| 15 | Boolean | Using crossbow | false | |
VindicationIllager Vindicator
Extends Abstract Illager.
Ravager
Extends Raid Participent
No additional metadata.
| Status | Description | |
|---|---|---|
| 4 | Starts the attack animation. | |
| 39 | Starts the stun animation. | |
Witch
Extends Monster Raid Participent.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| Boolean | Is drinking potion | false | ||
AbstractSkeleton
Extends Monster.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| Boolean | Is swinging arms | false | ||
Replaced with pose (presumably?)
Zombie
Extends Monster.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| Boolean | Is baby | false | ||
| VarInt | Unused (previously type) | 0 | ||
| 14 | Boolean | Are hands held up | false | |
| Boolean | Is becoming a drowned | false | ||
Replaced with pose (presumably?)
Zombie Villager
Extends Zombie.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| Boolean | Is converting | false | ||
Ocelot
Extends TameableAnimal Ageable.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| 15 | VarInt | Type (0 = untamed, 1 = tuxedo, 2 = tabby, 3 = siamese). Used to render regardless as to whether it is tamed or not. | 0 | |
| 15 | Boolean | Is trusting | false | |
| Status | Description | |
|---|---|---|
| 40 | Spawn smoke particles (trust gaining failed) | |
| 41 | Spawn heart particles (trust gaining succeeded) | |
Cat
Extends TameableAnimal.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| 17 | VarInt | Type (0 = tabby, 1 = black, 2 = red, 3 = siamese, 4 = british_shorthair, 5 = calico, 6 = persian, 7 = ragdoll, 8 = white, 9 = all_black) | 1 | |
| 18 | Boolean | Unknown | false | |
| 19 | Boolean | Unknown | false | |
| 20 | VarInt | Collar color (values are those used with dyes) | 14 (Red) | |
Horse
Extends AbstractHorse.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| VarInt | Variant (Color & Style) | 0 | ||
| 16 | VarInt | Armor (0: none, 1: iron, 2: gold, 3: diamond) | 0 (none) | |
| 17 | Slot | Armor Item (Forge only) | Empty | |
Replaced with Entity Equipment packet. (Uses chestplate slot)
Trader Llama
Extends Llama.
No additional metadata.
Abstract Merchant
Extends Ageable.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
| 15 | VarInt | Head shake timer (starts at 40, decrements each tick) | 0 | |
Villager
Extends Ageable Abstract Merchant.
| Index | Type | Meaning | Default | |
|---|---|---|---|---|
Wandering Trader
Extends Abstract Merchant.
No additional metadata.
Block Actions
No changes so far.
Inventories
Merged
Plugin Channels
Merged
Play
Clientbound
Merged
Serverbound
Merged
Handshaking
Clientbound
There are no clientbound packets in the Handshaking state, since the protocol immediately switches to a different state after the client sends the first packet.
Serverbound
Status
Clientbound
No changes so far.
Serverbound
No changes so far.
Login
Clientbound
No changes so far.
Serverbound
No changes so far.
