Difference between revisions of "Pre-release protocol"

From wiki.vg
Jump to navigation Jump to search
(Remove merged content)
(16w20a protocol changes)
Line 1: Line 1:
−
This page documents the changes from the [[Protocol|last stable Minecraft release]] (currently [[Protocol version numbers|1.9.4, protocol 110]]) to the current pre-release (currently [[Protocol version numbers|1.9.4, protocol 110]]). Note that this page contains bleeding-edge information that may not be completely or correctly documented.
+
This page documents the changes from the [[Protocol|last stable Minecraft release]] (currently [[Protocol version numbers|1.9.4, protocol 110]]) to the current pre-release (currently [[Protocol version numbers|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.
 
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.
Line 13: Line 13:
 
=== Packets ===
 
=== Packets ===
  
−
No changes so far.
+
=== Packets ===
 +
 
 +
{| class="wikitable"
 +
! ID
 +
! Packet name
 +
!colspan="2"| Documentation
 +
|-
 +
!colspan="4"| Handshaking serverbound
 +
{{PacketList|0x00|Handshake}}
 +
|-
 +
!colspan="4"| Play clientbound
 +
{{PacketList|0x19|Named Sound Effect}}
 +
{{PacketList|0x46|Sound Effect}}
 +
|}
 +
 
  
 
<!--  
 
<!--  
Line 39: Line 53:
  
 
No changes so far.
 
No changes so far.
−
 
−
<!-- Version number will change meaning that this needs to be uncommented
 
  
 
==== Handshake ====
 
==== Handshake ====
Line 59: Line 71:
 
  | Protocol Version
 
  | Protocol Version
 
  | VarInt
 
  | VarInt
−
  | See [[protocol version numbers]] (currently {{change|110|111}})
+
  | See [[protocol version numbers]] (currently {{change|110|201}})
 
  |-
 
  |-
 
  | Server Address
 
  | Server Address
Line 73: Line 85:
 
  | 1 for [[#Status|status]], 2 for [[#Login|login]]
 
  | 1 for [[#Status|status]], 2 for [[#Login|login]]
 
  |}
 
  |}
−
-->
+
 
  
 
== Play ==
 
== Play ==
Line 79: Line 91:
 
=== Clientbound ===
 
=== Clientbound ===
  
−
No changes so far.
+
==== Named Sound Effect ====
 +
{{See also|#Sound Effect}}
 +
 
 +
Used to play a sound effect on the client. Custom sounds may be added by resource packs.
 +
 
 +
{| class="wikitable"
 +
! Packet ID
 +
! State
 +
! Bound To
 +
! Field Name
 +
! Field Type
 +
! Notes
 +
|-
 +
|rowspan="7"| 0x19
 +
|rowspan="7"| Play
 +
|rowspan="7"| Client
 +
| Sound Name
 +
| String
 +
| All known sound effect names can be seen [http://pokechu22.github.io/Burger/1.9.html#sounds here].
 +
|-
 +
| Sound Category
 +
| VarInt Enum
 +
| The category that this sound will be played from ([https://gist.github.com/konwboj/7c0c380d3923443e9d55 current categories])
 +
|-
 +
| Effect Position X
 +
| Int
 +
| Effect X multiplied by 8 ([[Data types#Fixed-point numbers|fixed-point number]] with only 3 bits dedicated to the fractional part)
 +
|-
 +
| Effect Position Y
 +
| Int
 +
| Effect Y multiplied by 8 ([[Data types#Fixed-point numbers|fixed-point number]] with only 3 bits dedicated to the fractional part)
 +
|-
 +
| Effect Position Z
 +
| Int
 +
| Effect Z multiplied by 8 ([[Data types#Fixed-point numbers|fixed-point number]] with only 3 bits dedicated to the fractional part)
 +
|-
 +
| Volume
 +
| Float
 +
| 1 is 100%, can be more
 +
|-
 +
| Pitch
 +
| {{change|Unsigned Byte|Float}}
 +
| 63 is 100%, can be more
 +
|}
 +
 
 +
==== Sound Effect ====
 +
 
 +
This packet is used to play a number of [http://pokechu22.github.io/Burger/1.9.html#sounds hardcoded sound events]. For custom sounds, use [[#Named Sound Effect|Named Sound Effect]] ([[#Play|Play]], 0x19, clientbound).
 +
 
 +
{{Warning|Numeric sound effect IDs are liable to change between versions}}
 +
 
 +
{| class="wikitable"
 +
! Packet ID
 +
! State
 +
! Bound To
 +
! Field Name
 +
! Field Type
 +
! Notes
 +
|-
 +
|rowspan="7"| 0x46
 +
|rowspan="7"| Play
 +
|rowspan="7"| Client
 +
| Sound ID
 +
| VarInt
 +
| ID of hardcoded sound event ([http://pokechu22.github.io/Burger/1.9.html#sounds events])
 +
|-
 +
| Sound Category
 +
| VarInt Enum
 +
| The category that this sound will be played from ([https://gist.github.com/konwboj/7c0c380d3923443e9d55 current categories])
 +
|-
 +
| Effect Position X
 +
| Int
 +
| Effect X multiplied by 8 ([[Data types#Fixed-point numbers|fixed-point number]] with only 3 bits dedicated to the fractional part)
 +
|-
 +
| Effect Position Y
 +
| Int
 +
| Effect Y multiplied by 8 ([[Data types#Fixed-point numbers|fixed-point number]] with only 3 bits dedicated to the fractional part)
 +
|-
 +
| Effect Position Z
 +
| Int
 +
| Effect Z multiplied by 8 ([[Data types#Fixed-point numbers|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
 +
| {{change|Unsigned Byte|Float}}
 +
| Float multiplied by 63.5, capped between 0.5 and 2.0 by Notchian clients
 +
|}
  
 
=== Serverbound ===
 
=== Serverbound ===

Revision as of 18:14, 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

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

None so far.

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 110 201)
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 Unsigned Byte Float 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).

Warning.png 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 Unsigned Byte Float 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.

Retrieved from "https://wiki.vg/index.php?title=Pre-release_protocol&oldid=7849"