Difference between revisions of "Pre-release protocol"

From wiki.vg
Jump to navigation Jump to search
(12w16a changes: two new packets)
 
(5 intermediate revisions by the same user not shown)
Line 45: Line 45:
 
! class="col4" | Notes
 
! class="col4" | Notes
 
|- class="row1"
 
|- class="row1"
−
| class="col0 centeralign" rowspan="2" | 0xCC
+
| class="col0 centeralign" rowspan="3" | 0xCC
 
| class="col1 centeralign" | Locale
 
| class="col1 centeralign" | Locale
 
| class="col2 centeralign" | string
 
| class="col2 centeralign" | string
 
| class="col3 centeralign" | en_GB
 
| class="col3 centeralign" | en_GB
 
|- class="row2"
 
|- class="row2"
 +
| class="col1 centeralign" | unknown
 +
| class="col2 centeralign" | byte
 +
| class="col3 centeralign" |
 +
|- class="row3"
 
| class="col1 centeralign" | View distance
 
| class="col1 centeralign" | View distance
 
| class="col2 centeralign" | int
 
| class="col2 centeralign" | int
 
| class="col3 centeralign" | 0
 
| class="col3 centeralign" | 0
 
| class="col4" | 0-3 for 'far', 'normal', 'short', 'tiny'.
 
| class="col4" | 0-3 for 'far', 'normal', 'short', 'tiny'.
 +
|- class="row4"
 +
! class="col0" | Total Size:
 +
| class="col1 rightalign" colspan="4" | 7 bytes + length of string
 +
|}
 +
 +
=== Encryption Key Response (0xFC) ===
 +
 +
''Client to server''
 +
 +
Sent after receiving 0xFD.
 +
 +
{| 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="2" | 0xFC
 +
| class="col1 centeralign" | Shared key length
 +
| class="col2 centeralign" | short
 +
| class="col3 centeralign" |
 +
|- class="row2"
 +
| class="col1 centeralign" | Shared key
 +
| class="col2 centeralign" | byte array
 +
| class="col3 centeralign" |
 +
|- class="row3"
 +
! class="col0" | Total Size:
 +
| class="col1 rightalign" colspan="4" | 3 bytes + length of key
 +
|}
 +
 +
=== Encryption Key Request (0xFD) ===
 +
 +
''Server to client''
 +
 +
Sent after handshakes.
 +
 +
{| 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="3" | 0xFD
 +
| class="col1 centeralign" | Server id
 +
| class="col2 centeralign" | string
 +
|- class="row2"
 +
| class="col1 centeralign" | Public key length
 +
| class="col2 centeralign" | short
 
|- class="row3"
 
|- class="row3"
 +
| class="col1 centeralign" | Public key
 +
| class="col2 centeralign" | byte array
 +
|- class="row4"
 
! class="col0" | Total Size:
 
! class="col0" | Total Size:
−
| class="col1 rightalign" colspan="4" | 7 bytes + length of string
+
| class="col1 rightalign" colspan="4" | 5 bytes + length of string + length of key
 
|}
 
|}
  
 
== Changed packets ==
 
== Changed packets ==
  
−
''none''
+
=== Hanshake (0x02) ===
 +
 
 +
''Client to server only''
 +
 
 +
{| 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="2" | 0x02
 +
| class="col1 centeralign" | Protocol Version
 +
| class="col2 centeralign" | byte
 +
| class="col3 centeralign" | <code>31</code>
 +
| class="col4" |
 +
|- class="row2"
 +
| class="col1 centeralign" | Username <del>and Host</del>
 +
| class="col2 centeralign" | string
 +
| class="col3 centeralign" | <code>TkTech</code>
 +
| class="col4" | The username of the player attempting to connect<del>, and the host he is connecting to, seperated by a semicolon.</del>
 +
|- class="row3"
 +
! class="col0" | Total Size:
 +
| class="col1 rightalign" colspan="4" | 4 bytes + length of string
 +
|}
  
 
== Protocol History ==
 
== Protocol History ==
  
 +
=== 2012-04-26 ===
 +
* 12w17a
 +
* Protocol version is now 31
 +
* After exchanging handshakes, RC4 based encryption is initiated. The server sends 0xFD, which is replied by the client using 0xFC.
 +
* 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
 
=== 2012-04-19 ===
 
=== 2012-04-19 ===
 
* 12w16a
 
* 12w16a

Revision as of 06:47, 26 April 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
unknown byte
View distance int 0 0-3 for 'far', 'normal', 'short', 'tiny'.
Total Size: 7 bytes + length of string

Encryption Key Response (0xFC)

Client to server

Sent after receiving 0xFD.

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.

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

Changed packets

Hanshake (0x02)

Client to server only

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
  • After exchanging handshakes, RC4 based encryption is initiated. The server sends 0xFD, which is replied by the client using 0xFC.
  • 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

2012-04-19

  • 12w16a
  • Protocol version is now 30
  • New packet: 0xCB Tab-complete
  • New packet: 0xCC Locale and View Distance
Retrieved from "https://wiki.vg/index.php?title=Pre-release_protocol&oldid=2773"