Pre-release protocol

Under construction In light of the recent release of Minecraft 1.9, this article still contains some changes between 1.8.9 and 1.9, which are currently being merged into Protocol. If you want to contribute, please coordinate with us in #mcdevs, and ping Fenhl before making any edits.

This page documents the changes from the last stable Minecraft release (currently 1.9, protocol 107) to the current pre-release (currently 1.9.1-pre2, protocol 108). 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	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
Play clientbound
0x23	Join Game	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x25	Entity Relative Move	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x26	Entity Look And Relative Move	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x3A	Attach Entity	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
Play serverbound
0x00	Teleport Confirm	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x01	Tab-Complete	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x03	Client Status	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x04	Client Settings	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x0A	Use Entity	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x10	Vehicle Move (serverbound)	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x11	Steer Boat	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x13	Player Digging	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x14	Entity Action	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x19	Update Sign	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x1A	Animation	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x1C	Player Block Placement	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x1D	Use Item	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}

New/modified data types

None so far.

Handshaking

Clientbound

No changes so far.

Serverbound

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 {{#if:107|107}}{{#if:108|{{#if:107| }}108}})
			Server Address	String	hostname or IP, e.g. localhost or 127.0.0.1 (does this support IPv6?)
			Server Port	Unsigned Short	default is 25565
			Next State	VarInt Enum	1 for status, 2 for login

Play

Clientbound

Join Game

See Protocol Encryption for information on logging in.

Packet ID	State	Bound To	Field Name	Field Type	Notes
0x23	Play	Client	Entity ID	Int	The player's Entity ID (EID)
			Gamemode	Unsigned Byte	0: Survival, 1: Creative, 2: Adventure, 3: Spectator. Bit 3 (0x8) is the hardcore flag.
			Dimension	Byte}}{{#if:Int|{{#if:Byte| }}Int}} Enum	-1: Nether, 0: Overworld, 1: End
			Difficulty	Unsigned Byte	0: peaceful, 1: easy, 2: normal, 3: hard
			Max Players	Unsigned Byte	Used by the client to draw the player list
			Level Type	String	default, flat, largeBiomes, amplified, default_1_1
			Reduced Debug Info	Boolean	If true, a Notchian client shows reduced information on the debug screen.

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.