Difference between revisions of "Pre-release protocol"

From wiki.vg
Jump to navigation Jump to search
(Reset page)
 
Line 1: Line 1:
This page documents the changes from the [[Protocol|last stable Minecraft release]] (currently 1.6.2, protocol 74) to the current pre-release. Note that this page contains bleeding-edge information that may not be completely or correctly documented.
+
There are currently no pre-release versions available to document on this page. For the latest stable Minecraft release, see the [[Protocol|Protocol]] page. For previous pre-release pages, see the [[Protocol version numbers|Protocol version numbers]] page.
He 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 occured to the respective packets there.
 
  
== Protocol History ==
+
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.
13w36a - Added sound category byte to 0x3E
 
- Changed 0xC8 to a string:int map
 
  
13w37b -
+
== Contents ==
  
1.6.3 - Terrain fixes to help moving to 1.7, no packet changes from 1.6.2
+
<div style="float:right;">__TOC__</div>
  
1.6.4 -
+
=== Data types ===
  
13w38a/b/c -
+
No changes so far.
  
13w39a/b - UUIDs added to spawn named entity, game state 'gamemode' byte -> float
+
=== Packets ===
  
13w41a - Large protocol work
+
No changes so far.
  
== Protocol Version ==
+
[[Category:Minecraft Modern]]
13w41a -
 
 
 
13w39a/b - 80
 
 
 
13w38a/b/c - 79
 
 
 
1.6.4 - 78
 
 
 
1.6.3 - 77
 
 
 
13w37b - 76
 
 
 
13w36a - 75
 
 
 
== Packet format ==
 
 
 
{| class="wikitable"
 
! Field Name !! Field Type !! Notes
 
|-
 
| Length || VarInt ||
 
|-
 
| Type || VarInt ||
 
|-
 
| Data || ||
 
|}
 
 
 
== Data Types ==
 
 
 
VarInt - [http://developers.google.com/protocol-buffers/docs/encoding#varints Protocol Buffer 32-bit Varint]
 
 
 
String - UTF-8 String
 
 
 
== Handshaking ==
 
 
 
=== Serverbound ===
 
 
 
==== ? ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=4 | 0x00
 
| || VarInt ||
 
|-
 
| || String ||
 
|-
 
| || VarInt ||
 
|-
 
| || VarInt ||
 
|}
 
 
 
== Play ==
 
 
 
=== Clientbound ===
 
 
 
==== Keep Alive ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=1 | 0x00
 
| Keep Alive ID || Int ||
 
|}
 
 
 
 
 
==== Join Game ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=7 | 0x01
 
| Entity ID || Int || The player's Entity ID
 
|-
 
| Level type || String || level-type in server.properties
 
|-
 
| Gamemode || Byte || 0: survival, 1: creative, 2: adventure. Bit 3 (0x8) is the hardcore flag
 
|-
 
| Dimension || Byte || -1: nether, 0: overworld, 1: end
 
|-
 
| Difficulty || Unsigned Byte || 0 thru 3 for Peaceful, Easy, Normal, Hard
 
|-
 
| || Byte ||
 
|-
 
| Max Players || Byte || Used by the client to draw the player list
 
|}
 
 
 
==== Chat Message ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=1 | 0x02
 
| JSON Data || String || https://gist.github.com/thinkofdeath/e882ce057ed83bac0a1c
 
|}
 
 
 
==== Time Update ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=2 | 0x03
 
| Age of the world || Long || In ticks; not changed by server commands
 
|-
 
| Time of day || Long || The world (or region) time, in ticks. If negative the sun will stop moving at the Math.abs of the time
 
|}
 
 
 
==== Entity Equipment ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=3 | 0x04
 
| EntityID || Int || Entity's ID
 
|-
 
| Slot || Short || Equipment slot: 0=held, 1-4=armor slot (1 - boots, 2 - leggings, 3 - chestplate, 4 - helmet)
 
|-
 
| Item || [[Slot_Data|Slot]] || Item in slot format
 
|}
 
 
 
==== Spawn Position ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=3 | 0x05
 
| X || Int || Spawn X in block coordinates
 
|-
 
| Y || Int || Spawn Y in block coordinates
 
|-
 
| Z || Int || Spawn | in block coordinates
 
|}
 
 
 
==== Update Health ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=3 | 0x06
 
| Health || Float || 0 or less = dead, 20 = full HP
 
|-
 
| Food || Short || 0 - 20
 
|-
 
| Food Saturation || Float || Seems to vary from 0.0 to 5.0 in integer increments
 
|}
 
 
 
==== Respawn ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=5 | 0x07
 
| Dimension || Int || -1: The Nether, 0: The Overworld, 1: The End
 
|-
 
| Difficulty || Byte || 0 thru 3 for Peaceful, Easy, Normal, Hard.
 
|-
 
| Gamemode || Byte || 0: survival, 1: creative, 2: adventure. The hardcore flag is not included
 
|-
 
| World Height|| Short || Defaults to 256
 
|-
 
| Level Type || String ||
 
|}
 
 
 
==== Player ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=1 | 0x08
 
| On Ground || Bool | True if the client is on the ground, False otherwise
 
|}
 
 
 
==== Player Position ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=5| 0x09
 
| X || Double || Absolute position
 
|-
 
| Y || Double || Absolute position
 
|-
 
| Stance || Double || Used to modify the players bounding box when going up stairs, crouching, etc…
 
|-
 
| Z || Double || Absolute position
 
|-
 
| On Ground || Bool || True if the client is on the ground, False otherwise
 
|}
 
 
 
==== Player Look ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=3| 0x0A
 
| Yaw || Float || Absolute rotation on the X Axis, in degrees
 
|-
 
| Pitch || Float || Absolute rotation on the Y Axis, in degrees
 
|-
 
| On Ground || Bool || True if the client is on the ground, False otherwise
 
|}
 
 
 
==== Player Position And Look ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=7| 0x0B
 
| X || Double || Absolute position
 
|-
 
| Y || Double || Absolute position
 
|-
 
| Stance || Double || Used to modify the players bounding box when going up stairs, crouching, etc…
 
|-
 
| Z || Double || Absolute position
 
|-
 
| Yaw || Float || Absolute rotation on the X Axis, in degrees
 
|-
 
| Pitch || Float || Absolute rotation on the Y Axis, in degrees
 
|-
 
| On Ground || Bool || True if the client is on the ground, False otherwise
 
|}
 
 
 
==== Held Item Change ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=1 | 0x0C
 
| Slot || Short || The slot which the player has selected (0-8)
 
|}
 
 
 
==== Use Bed ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=5 | 0x0D
 
| Entity ID || Int || Player ID
 
|-
 
| || Byte ||
 
|-
 
| X || Int || Bed headboard X as block coordinate
 
|-
 
| Y || Unsigned Byte || Bed headboard Y as block coordinate
 
|-
 
| Z || Int || Bed headboard Z as block coordinate
 
|}
 
 
 
==== Animation ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=2 | 0x0E
 
| Entity ID || Int || Player ID
 
|-
 
| Animation || Byte || Animation ID
 
|}
 
 
 
Animation can be one of the following values:
 
 
 
{| class="wikitable"
 
! ID !! Animation
 
|-
 
| 0 || No animation
 
|-
 
| 1 || Swing arm
 
|-
 
| 2 || Damage animation
 
|-
 
| 3 || Leave bed
 
|-
 
| 5 || Eat food
 
|-
 
| 6 || Critical effect
 
|-
 
| 7 || Magic critical effect
 
|-
 
| 102 || (unknown)
 
|-
 
| 104 || Crouch
 
|-
 
| 105 || Uncrouch
 
|}
 
 
 
==== Spawn Player ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=10 | 0x0F
 
| Entity ID || Int || Player's Entity ID
 
|-
 
| Player UUID || String || Player's UUID
 
|-
 
| Player Name || String || Player's Name
 
|-
 
| X || Int || Player X as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|-
 
| Y || Int || Player X as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|-
 
| Z || Int || Player X as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|-
 
| Yaw || Byte || Player rotation as a packed byte
 
|-
 
| Pitch || Byte || Player rotation as a packet byte
 
|-
 
| Current Item || Short || The item the player is currently holding. Note that this should be 0 for "no item", unlike -1 used in other packets. A negative value crashes clients.
 
|-
 
| Metadata || [[Entities#Entity_Metadata_Format|Metadata]] || The client will crash if no metadata is sent
 
|}
 
 
 
==== Collect Item ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=2 | 0x10
 
| Collected Entity ID || Int ||
 
|-
 
| Collector Entity ID || Int ||
 
|}
 
 
 
==== Spawn Object ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=8| 0x11
 
| Entity ID || Int || Entity ID of the object
 
|-
 
| Type || Byte || The of object (See [[Entities#Objects|Objects]]
 
|-
 
| X || Int || X position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|-
 
| Y || Int || Y position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|-
 
| Z || Int || Z position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|-
 
| Pitch || Byte || The pitch in steps of 2p/256
 
|-
 
| Yaw || Byte || The yaw in steps of 2p/256
 
|-
 
| Data || [[Object_Data|Object Data]] ||
 
|}
 
 
 
==== Spawn Mob ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=12 | 0x12
 
| Entity ID || Int || Entity's ID
 
|-
 
| Type || Unsigned Byte || The type of mob. See [[Entities#Mobs|Mobs]]
 
|-
 
| X || Int || X position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|-
 
| Y || Int || Y position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|-
 
| Z || Int || Z position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|-
 
| Pitch || Byte || The pitch in steps of 2p/256
 
|-
 
| Head Pitch || Byte || The pitch in steps of 2p/256
 
|-
 
| Yaw || Byte || The yaw in steps of 2p/256
 
|-
 
| Velocity X || Short ||
 
|-
 
| Velocity Y || Short ||
 
|-
 
| Velocity Z || Short ||
 
|-
 
| Metadata || [[Entities#Entity_Metadata_Format|Metadata]] ||
 
|}
 
 
 
==== Spawn Painting ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=6 | 0x13
 
| Entity ID || Int || Entity's ID
 
|-
 
| Title || String || Name of the painting. Max length 13
 
|-
 
| X || Int || Center X coordinate
 
|-
 
| Y || Int || Center Y coordinate
 
|-
 
| Z || Int || Center Z coordinate
 
|-
 
| Direction || Int || Direction the painting faces (0 -z, 1 -x, 2 +z, 3 +x)
 
|}
 
 
 
==== Spawn Experience Orb ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=5 | 0x14
 
| Entity ID || Int || Entity's ID
 
|-
 
| X || Int || X position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|-
 
| Y || Int || Y position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|-
 
| Z || Int || Z position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|-
 
| Count || Short || The amount of experience this orb will reward once collected
 
|}
 
 
 
==== Entity Velocity ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=4 | 0x15
 
| Entity ID || Int || Entity's ID
 
|-
 
| Velocity X || Short || Velocity on the X axis
 
|-
 
| Velocity Y || Short || Velocity on the Y axis
 
|-
 
| Velocity Z || Short || Velocity on the Z axis
 
|}
 
 
 
==== Destroy Entitie s====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=2 | 0x16
 
| Count || Byte || Length of following array
 
|-
 
| Entity IDs || Array of Int || The list of entities of destroy
 
|}
 
 
 
==== Entity ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=1 | 0x17
 
| Entity ID || Int || Entity's ID
 
|}
 
 
 
==== Entity Relative Move ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=4| 0x18
 
| Entity ID || Int || Entity's ID
 
|-
 
| DX || Byte || Change in X position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|-
 
| DY || Byte || Change in Y position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|-
 
| DZ || Byte || Change in Z position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|}
 
 
 
==== Entity Look ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=3 | 0x19
 
| Entity ID || Int || Entity's ID
 
|-
 
| Yaw || Byte || The X Axis rotation as a fraction of 360
 
|-
 
| Pitch || Byte || The Y Axis rotation as a fraction of 360
 
|}
 
 
 
==== Entity Look and Relative Move ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=6 | 0x1A
 
| Entity ID || Int || Entity's ID
 
|-
 
| DX || Byte || Change in X position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|-
 
| DY || Byte || Change in Y position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|-
 
| DZ || Byte || Change in Z position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|-
 
| Yaw || Byte || The X Axis rotation as a fraction of 360
 
|-
 
| Pitch || Byte || The Y Axis rotation as a fraction of 360
 
|}
 
 
 
==== Entity Teleport ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=6 | 0x1B
 
| Entity ID || Int || Entity's ID
 
|-
 
| X || Byte || X position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|-
 
| Y || Byte || Y position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|-
 
| Z || Byte || Z position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
 
|-
 
| Yaw || Byte || The X Axis rotation as a fraction of 360
 
|-
 
| Pitch || Byte || The Y Axis rotation as a fraction of 360
 
|}
 
 
 
==== Entity Head Look ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=2 | 0x1C
 
| Entity ID || Int || Entity's ID
 
|-
 
| Head Yaw || Byte || Head yaw in steps of 2p/256
 
|}
 
 
 
==== Entity Status ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=2 | 0x1D
 
| Entity ID || Int || Entity's ID
 
|-
 
| Entity Status || Byte || See below
 
|}
 
 
 
{| class="wikitable"
 
|-
 
! Entity Status !! Meaning
 
|-
 
| 2 || Entity hurt
 
|-
 
| 3 || Entity dead
 
|-
 
| 6 || Wolf taming
 
|-
 
| 7 || Wolf tamed
 
|-
 
| 8 || Wolf shaking water off itself
 
|-
 
| 9 || (of self) Eating accepted by server
 
|-
 
| 10 || Sheep eating grass
 
|-
 
| 11 || Iron Golem handing over a rose
 
|-
 
| 12 || Spawn "heart" particles near a villager
 
|-
 
| 13 || Spawn particles indicating that a villager is angry and seeking revenge
 
|-
 
| 14 || Spawn happy particles near a villager
 
|-
 
| 15 || Spawn a "magic" particle near the Witch
 
|-
 
| 16 || Zombie converting into a villager by shaking violently (unused in recent update)
 
|-
 
| 17 || A firework exploding
 
|}
 
 
 
==== Attach Entity ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=3 | 0x1E
 
| Entity ID || Int || Entity's ID
 
|-
 
| Vehicle ID || Int || Vechicle's Entity ID
 
|-
 
| Leash || Bool || If true leashes the entity to the vehicle
 
|}
 
 
 
==== Attach Entity ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=2 | 0x1F
 
| Entity ID || Int || Entity's ID
 
|-
 
| Metadata || [[Entities#Entity_Metadata_Format|Metadata]] ||
 
|}
 
 
 
==== Entity Effect ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=4 | 0x20
 
| Entity ID || Int || Entity's ID
 
|-
 
| Effect ID || Byte || See [[http://www.minecraftwiki.net/wiki/Potion_effect#Parameters]]
 
|-
 
| Amplifier || Byte ||
 
|-
 
| Duration || Short ||
 
|}
 
 
 
== Status ==
 
 
 
=== Clientbound ===
 
 
 
==== ? ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=1 | 0x00
 
| || String ||
 
|}
 
 
 
 
 
==== ? ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=1 | 0x01
 
| || Long ||
 
|}
 
 
 
=== Serverbound ===
 
 
 
==== ? ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=1 | 0x00 || || ||
 
|}
 
 
 
 
 
==== ? ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=1 | 0x01
 
| || Long ||
 
|}
 
 
 
== Login ==
 
 
 
=== Clientbound ===
 
 
 
==== ? ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=1 | 0x00
 
| || String ||
 
|}
 
 
 
 
 
==== ? ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=5 | 0x01
 
| || String ||
 
|-
 
| Length || Short ||
 
|-
 
| || Byte array ||
 
|-
 
| Length || Short ||
 
|-
 
| || Byte array ||
 
|-
 
|}
 
 
 
 
 
==== ? ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=2 | 0x02
 
| UUID || String ||
 
|-
 
| Name || String ||
 
|}
 
 
 
 
 
=== Serverbound ===
 
 
 
==== ? ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=1 | 0x00
 
| Name || String ||
 
|}
 
 
 
==== ? ====
 
{| class="wikitable"
 
! Packet ID !! Field Name !! Field Type !! Notes
 
|-
 
| rowspan=4 | 0x01
 
| Length || Short ||
 
|-
 
| || Byte array ||
 
|-
 
| Length || Short ||
 
|-
 
| || Byte array ||
 
|-
 
|}
 
 
 
== Plugin Channels ==
 
 
 
=== MC|RPack ===
 
{| class="wikitable"
 
! Field Name !! Field Type !! Example !! Notes
 
|-
 
| Resource pack URL || UTF8 string || http://example.com/pack.zip ||
 
|}
 

Latest revision as of 16:42, 29 June 2024

There are currently no pre-release versions available to document on this page. For the latest stable Minecraft release, see the Protocol page. For previous pre-release pages, see the Protocol version numbers page.

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

No changes so far.