Difference between revisions of "Pre-release protocol"

From wiki.vg
Jump to navigation Jump to search
Line 120: Line 120:
 
! class="col0" | Total Size:
 
! class="col0" | Total Size:
 
| class="col1 rightalign" colspan="4" | 5 bytes + length of string + length of key
 
| class="col1 rightalign" colspan="4" | 5 bytes + length of string + length of key
 +
|}
 +
 +
=== Named Sound Effect (0x3E) ===
 +
 +
''Server to client''
 +
 +
Used to play a sound effect on the client.
 +
 +
{| class="wikitable"
 +
|- class="row0"
 +
! class="col0" | Packet ID
 +
! class="col1" | Field Name
 +
! class="col2" | Field Type
 +
! class="col3" | Example
 +
! class="col4" | Notes
 +
|- class="row1"
 +
| class="col0 centeralign" rowspan="6" | 0x3E
 +
| class="col1 centeralign" | Sound name
 +
| class="col2 centeralign" | string
 +
| class="col3 centeralign" | step.grass
 +
| class="col4 centeralign" | 250
 +
|- class="row2"
 +
| class="col1 centeralign" | Effect position X
 +
| class="col2 centeralign" | int
 +
| class="col3 centeralign" | 250
 +
| class="col4 centeralign" | effect X multiplied by 8
 +
|- class="row3"
 +
| class="col1 centeralign" | Effect position Y
 +
| class="col2 centeralign" | int
 +
| class="col3 centeralign" | 250
 +
| class="col4 centeralign" | effect Y multiplied with 8
 +
|- class="row4"
 +
| class="col1 centeralign" | Effect position Z
 +
| class="col2 centeralign" | int
 +
| class="col3 centeralign" | 250
 +
| class="col4 centeralign" | effect Z multiplied with 8
 +
|- class="row5"
 +
| class="col1 centeralign" | Unknown
 +
| class="col2 centeralign" | byte
 +
| class="col3 centeralign" | 9
 +
| class="col4 centeralign" |
 +
|- class="row6"
 +
| class="col1 centeralign" | Unknown
 +
| class="col2 centeralign" | byte
 +
| class="col3 centeralign" | 63
 +
| class="col4 centeralign" |
 +
|- class="row7"
 +
! class="col0" | Total Size:
 +
| class="col1 rightalign" colspan="4" | 17 bytes + length of string
 
|}
 
|}
  

Revision as of 01:10, 4 May 2012

This page documents the changes from the last stable Minecraft release (currently 1.2.5) to the current pre-release (or weekly release).

New packets

Tab-complete (0xCB)

Two-way

Sent C->S when the user presses [tab] while writing text. The payload contains all text behind the cursor.

The server responds with an auto-completion of the last word sent to it. In the case of regular chat, this is a player username. Command names and parameters are also supported.

In the event of more than one possible completion, the server responds with the options packed into the single string field, separated by a null character. Note that as strings are UTF-16, this is two bytes wide.

Packet ID Field Name Field Type Example Notes
0xCB Text string
Total Size: 3 bytes + length of string

Locale and View Distance (0xCC)

Client to server

Sent when the player connects, or when settings are changed.

Packet ID Field Name Field Type Example Notes
0xCC Locale string en_GB
View distance int 0 0-3 for 'far', 'normal', 'short', 'tiny'.
Chat info byte Bits: 0: chat enabled, 2: colors enabled
Total Size: 7 bytes + length of string

Encryption Key Response (0xFC)

Two-Way

Sent by the client after receiving 0xFD. The server responds with 0xFC, too (but with an empty Shared key).

The shared key is a client-generated, 16 bytes long key for RC4 encryption. The key is encrypted with RSA with the public key from the Encryption Key Request packet.

Packet ID Field Name Field Type Example Notes
0xFC Shared key length short
Shared key byte array
Total Size: 3 bytes + length of key

Encryption Key Request (0xFD)

Server to client

Sent after handshakes.

Public key encryption: RSA.

Packet ID Field Name Field Type Example Notes
0xFD Server id string
Public key length short
Public key byte array
Total Size: 5 bytes + length of string + length of key

Named Sound Effect (0x3E)

Server to client

Used to play a sound effect on the client.

Packet ID Field Name Field Type Example Notes
0x3E Sound name string step.grass 250
Effect position X int 250 effect X multiplied by 8
Effect position Y int 250 effect Y multiplied with 8
Effect position Z int 250 effect Z multiplied with 8
Unknown byte 9
Unknown byte 63
Total Size: 17 bytes + length of string

Changed packets

Login Request (0x01)

Two-Way

Just a guess: stripped unused string field.

Client to Server

Packet ID Field Name Field Type Example Notes
0x01 Protocol Version int 20 1.2.5's protocol version is 29 - since version 31 always 0
Username string TkTech The name of the user attempting to login, max length of 16 - since version 31 empty string
Not used int 0
Not used int 0
Not used byte 0
Not used unsigned byte 0
Not used unsigned byte 0
Total Size: 20 bytes + length of strings

Server to Client

Packet ID Field Name Field Type Example Notes
0x01 Entity ID int 1298 The Players Entity ID
Level Type string default default or SUPERFLAT; level-type in server.properties
Server mode int 0 0 for survival, 1 for creative
Dimension int 0 -1: The Nether, 0: The Overworld, 1: The End
Difficulty byte 1 0 thru 3 for Peaceful, Easy, Normal, Hard
Not used unsigned byte 0 Only 0 observed from vanilla server, was previously world height
Max players unsigned byte 8 Used by the client to draw the player list
Total Size: 20 bytes + length of strings

Hanshake (0x02)

Client to server only - before encryption, not sure what happens thereafter, may still be a server reply --Ceiru 23:12, 27 April 2012 (MST)

Packet ID Field Name Field Type Example Notes
0x02 Protocol Version byte 31
Username and Host string TkTech The username of the player attempting to connect, and the host he is connecting to, seperated by a semicolon.
Total Size: 4 bytes + length of string

Protocol History

2012-04-26

  • 12w17a
  • Protocol version is now 31
  • RC4 based encryption, described in Protocol_Encryption
  • Changed packet: 0x01 Login Request
  • Changed packet: 0x02 Handshake
  • Changed packet: 0xCC Locale and View Distance
  • New packet: 0xFC Encryption Key Response
  • New packet: 0xFD Encryption Key Request
  • New Item: Book & Quills (0x182) is enchantable
  • New Item: Written Book (0x183) is enchantable

2012-04-19

  • 12w16a
  • Protocol version is now 30
  • New packet: 0xCB Tab-complete
  • New packet: 0xCC Locale and View Distance