Difference between revisions of "Pre-release protocol"
Momothereal (talk | contribs) (16w20a metadata changes [wip]) |
Momothereal (talk | contribs) m |
||
Line 462: | Line 462: | ||
| {{change|12|13}} | | {{change|12|13}} | ||
| Boolean | | Boolean | ||
− | | colspan="2" | | + | | colspan="2" | Is swinging arms |
|- | |- | ||
| Spider <sup>extends Monster</sup> | | Spider <sup>extends Monster</sup> |
Revision as of 19:11, 22 May 2016
This page documents the changes from the last stable Minecraft release (currently 1.9.4, protocol 110) to the current pre-release (currently 16w20a, protocol 201). 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
Data types
No changes so far.
Packets
ID | Packet name | Documentation | |
---|---|---|---|
Handshaking serverbound | |||
0x00 | Handshake | Current | Pre |
Play clientbound | |||
0x19 | Named Sound Effect | Current | Pre |
0x46 | Sound Effect | Current | Pre |
New/modified data types
Entity Metadata
Format is now an array of entries, each of which looks like the following:
Name | Type | Meaning |
---|---|---|
Index | Unsigned Byte | Unique index key determining the meaning of the following value, see the table below. If this is 0xff then the it is the end of the Entity Metadata array and no more is read.
|
Type | Optional Byte Enum | Only if Index is not 0xff ; the type of the index, see the table below
|
Value | Optional value of Type | Only if Index is not 0xff : the value of the metadata field
|
Value of Type field | Type of Value field | Notes |
---|---|---|
0 | Byte | |
1 | VarInt | |
2 | Float | |
3 | String | |
4 | Chat | |
5 | Slot | |
6 | Boolean | |
7 | Rotation | 3 floats: rotation on x, rotation on y, rotation on z |
8 | Position | |
9 | OptPosition (Boolean + Optional Position) | Position is present if the Boolean is set to true |
10 | Direction (VarInt) | (Down = 0, Up = 1, North = 2, South = 3, West = 4, East = 5) |
11 | OptUUID (Boolean + Optional UUID) | UUID is present if the Boolean is set to true |
12 | BlockID (VarInt) | id << 4 | data
|
Entity classes also recursively use fields from classes they extend.
Entity class | Index | Type | Meaning | |
---|---|---|---|---|
Entity | 0 | Byte | Bit Mask | Meaning |
0x01 | On Fire | |||
0x02 | Crouched | |||
0x08 | Sprinting | |||
0x10 | Eating/Drinking/Blocking | |||
0x20 | Invisible | |||
0x40 | Glowing Effect | |||
0x80 | Flying with Elytra | |||
1 | VarInt | Air | ||
2 | String | Custom Name | ||
3 | Boolean | Is Custom Name Visible | ||
4 | Boolean | Is Silent | ||
5 | Boolean | No Gravity | ||
Potion extends Entity | Slot | Potion which is thrown | ||
FallingBlock extends Entity | Position | Spawn Position | ||
AreaEffectButt extends Entity | Float | Radius | ||
VarInt | Color (only for mob spell particle) | |||
Boolean | Ignore radius and show effect as single point, not area | |||
VarInt | Particle ID | |||
Arrow extends Entity | Byte | Is Critical | ||
TippedArrow extends Arrow | VarInt | Color | ||
Boat extends Entity | VarInt | Time Since Last Hit | ||
VarInt | Forward Direction | |||
Float | Damage Taken | |||
VarInt | Type | |||
Boolean | Right paddle turning | |||
Boolean | Left paddle turning | |||
EnderCrystal extends Entity | OptPosition | Beam Target | ||
Boolean | Show Bottom | |||
Fireball extends Entity | no additional metadata | |||
WitherSkull extends Fireball | Boolean | Invulnerable | ||
Fireworks extends Entity | Slot | Firework Info | ||
Hanging extends Entity | no additional metadata | |||
ItemFrame extends Hanging | Slot | Item | ||
VarInt | Rotation | |||
Item extends Entity | Slot | Item | ||
Living extends Entity | Byte | Likely used to limit placing blocks from both hands at the same time. | ||
Float | Health | |||
VarInt | Potion Effect Color | |||
Boolean | Is Potion Effect Ambient | |||
VarInt | Number of Arrows in Entity | |||
ArmorStand extends Living | ||||
Byte | Status bit mask | |||
Vector3F | Head rotation | |||
Vector3F | Body rotation | |||
Vector3F | Left arm rotation | |||
Vector3F | Right arm rotation | |||
Vector3F | Left leg rotation | |||
Vector3F | Right leg rotation | |||
Insentient extends Living | Byte | Status bit mask (NoAI, Left handed) | ||
Ambient extends Insentient | no additional metadata | |||
Bat extends Ambient | Byte | Is Hanging | ||
Creature extends Insentient | no additional metadata | |||
Ageable extends Creature | Boolean | Is Baby | ||
PolarBear extends Ageable | 13 | Boolean | Is Standing | |
Animal extends Ageable | no additional metadata | |||
Horse extends Animal | Byte | Status bit mask | ||
VarInt | Type | |||
VarInt | Variant | |||
OptUUID | Owner's UUID | |||
VarInt | Armor | |||
Pig extends Animal | Boolean | Has Saddle | ||
Rabbit extends Animal | VarInt | Type | ||
Sheep extends Animal | Byte | Status bit mask | ||
TameableAnimal extends Animal | Byte | Status bit mask (sitting, tamed) | ||
OptUUID | Owner's UUID | |||
Ocelot extends TameableAnimal | VarInt | Type | ||
Wolf extends TameableAnimal | Float | Damage Taken (used for tail rotation) | ||
Boolean | Is Begging | |||
VarInt | Collar Color | |||
Villager extends Ageable | VarInt | Profession (Farmer = 0, Librarian = 1, Priest = 2, Blacksmith = 3, Butcher = 4) | ||
Golem extends Creature | no additional metadata | |||
IronGolem extends Golem | Byte | Is Player Created | ||
Shulker extends Golem | Direction | Facing Direction | ||
OptPosition | Attachment Position | |||
Byte | Shield Height | |||
Monster extends Creature | no additional metadata | |||
Blaze extends Monster | Byte | Is On Fire | ||
Creeper extends Monster | VarInt | State (-1 = Idle, 1 = Fuse) | ||
Boolean | Is Powered | |||
Boolean | Is Ignited | |||
Guardian extends Monster | Byte | Status bit mask (elderly, retracting spikes) | ||
VarInt | Target EID | |||
Skeleton extends Monster | VarInt | Type | ||
Boolean | Is swinging arms | |||
Spider extends Monster | Byte | Is Climbing | ||
Witch extends Monster | Boolean | Is Aggresive | ||
Wither extends Monster | VarInt | First Head's Target | ||
VarInt | Second Head's Target | |||
VarInt | Third Head's Target | |||
VarInt | Invulnerable Time | |||
Zombie extends Monster | Boolean | Is Baby | ||
VarInt | Is Villager (profession) | |||
Boolean | Is Converting | |||
Boolean | Are Hands Rised Up | |||
Enderman extends Monster | Block ID | Carried Block | ||
Boolean | Is Screaming | |||
EnderDragon extends Insentient | VarInt | Dragon Phase | ||
Flying extends Insentient | no additional metadata | |||
Ghast extends Flying | Boolean | Is Attacking | ||
Slime extends Insentient | VarInt | Size | ||
Minecart extends Entity | VarInt | Shaking Power | ||
VarInt | Shaking Direction | |||
Float | Shaking Multiplier | |||
VarInt | Block ID and Meta | |||
VarInt | Block Y Position | |||
Boolean | Show Block | |||
MinecartCommandBlock extends Minecart | String | Command | ||
Chat | Last Output | |||
MinecartFurnace extends Minecart | Boolean | Is Powered | ||
TNTPrimed extends Entity | VarInt | Fuse Time |
Entity classes also recursively use fields from classes they extend.
Handshaking
Clientbound
No changes so far.
Serverbound
No changes so far.
Handshake
This causes the server to switch into the target state.
Packet ID | State | Bound To | Field Name | Field Type | Notes |
---|---|---|---|---|---|
0x00 | Handshaking | Server | Protocol Version | VarInt | See protocol version numbers (currently |
Server Address | String | Hostname or IP, e.g. localhost or 127.0.0.1, that was used to connect. The Notchian server does not use this information. | |||
Server Port | Unsigned Short | Default is 25565. The Notchian server does not use this information. | |||
Next State | VarInt Enum | 1 for status, 2 for login |
Play
Clientbound
Named Sound Effect
- See also: #Sound Effect
Used to play a sound effect on the client. Custom sounds may be added by resource packs.
Packet ID | State | Bound To | Field Name | Field Type | Notes |
---|---|---|---|---|---|
0x19 | Play | Client | Sound Name | String | All known sound effect names can be seen here. |
Sound Category | VarInt Enum | The category that this sound will be played from (current categories) | |||
Effect Position X | Int | Effect X multiplied by 8 (fixed-point number with only 3 bits dedicated to the fractional part) | |||
Effect Position Y | Int | Effect Y multiplied by 8 (fixed-point number with only 3 bits dedicated to the fractional part) | |||
Effect Position Z | Int | Effect Z multiplied by 8 (fixed-point number with only 3 bits dedicated to the fractional part) | |||
Volume | Float | 1 is 100%, can be more | |||
Pitch | 63 is 100%, can be more |
Sound Effect
This packet is used to play a number of hardcoded sound events. For custom sounds, use Named Sound Effect (Play, 0x19, clientbound).
Numeric sound effect IDs are liable to change between versions
Packet ID | State | Bound To | Field Name | Field Type | Notes |
---|---|---|---|---|---|
0x46 | Play | Client | Sound ID | VarInt | ID of hardcoded sound event (events) |
Sound Category | VarInt Enum | The category that this sound will be played from (current categories) | |||
Effect Position X | Int | Effect X multiplied by 8 (fixed-point number with only 3 bits dedicated to the fractional part) | |||
Effect Position Y | Int | Effect Y multiplied by 8 (fixed-point number with only 3 bits dedicated to the fractional part) | |||
Effect Position Z | Int | Effect Z multiplied by 8 (fixed-point number with only 3 bits dedicated to the fractional part) | |||
Volume | Float | 1.0 is 100%, capped between 0.0 and 1.0 by Notchian clients | |||
Pitch | Float multiplied by 63.5, capped between 0.5 and 2.0 by Notchian clients |
Serverbound
No changes so far.
Status
Clientbound
No changes so far.
Serverbound
No changes so far.
Login
Clientbound
No changes so far.
Serverbound
No changes so far.