Difference between revisions of "Pre-release protocol"

From wiki.vg
Jump to navigation Jump to search
m (→‎Place Ghost Recipe: Fix rowspan.)
 
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.
+
This page documents the changes from release 1.21.1 (protocol 767) to the current release (1.21.3, protocol 768). The stable protocol documentation is currently lagging behind, and the changes documented here will be merged soon, once they are complete. The current pre-release (snapshot 24w44a) is not yet documented.
−
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 ===
+
<div style="float:right;">__TOC__</div>
−
* Terrain fixes to help moving to 1.7, no packet changes from 1.6.2
 
  
−
=== 1.6.4 ===
+
=== Data types ===
  
−
=== 13w38a/b/c ===
+
{| class="wikitable"
 +
|-
 +
! Name
 +
! Size (bytes)
 +
! Encodes
 +
! Notes
 +
|- {{added}}
 +
! id=Type:Teleport_Flags | {{Type|Teleport Flags}}
 +
| 4
 +
| See [[#Teleport Flags]]
 +
| Bit field specifying how a teleportation is to be applied on each axis.
 +
|- {{added}}
 +
! id=Type:Recipe_Display | {{Type|Recipe Display}}
 +
| Varies
 +
| See [[Recipes#Recipe Display structure]]
 +
| Description of a recipe for use for use by the client.
 +
|- {{added}}
 +
! id=Type:Slot_Display | {{Type|Slot Display}}
 +
| Varies
 +
| See [[Recipes#Slot Display structure]]
 +
| Description of a recipe ingredient slot for use for use by the client.
 +
|}
  
−
=== 13w39a/b ===
+
==== Teleport Flags ====
−
* UUIDs added to spawn named entity
 
−
* Game state 'gamemode' byte -> float
 
  
−
=== 13w41a ===
+
A bit field represented as an {{Type|Int}}, specifying how a teleportation is to be applied on each axis.
−
* Large protocol rework
 
  
−
=== 13w41b ===
+
In the lower 8 bits of the bit field, a set bit means the teleportation on the corresponding axis is relative, and an unset bit that it is absolute.
−
* Removed 0x08, 0x09, 0x0A
 
−
* Removed unused field 'Stance' from Player Position and Look (Clientbound)
 
−
* Removed unused fields 'N/A' and 'Level Type' from Join Game
 
−
* Changed 'Gamemode' 'Difficulty' 'Max Players' types to Unsigned Byte
 
−
* Changed Handshake's Server Port VarInt -> Unsigned Short
 
−
* Removed unused fields 'World Height' 'Level Type' from Respawn
 
−
* Changed Respawn's 'Difficulty' and 'Gamemode' types to Unsigned Byte
 
−
* Changed Held Item Change's 'Slot' type to Byte
 
−
* Removed unknown byte from Use Bed
 
−
* Changed Animation's 'Animation' type to Unsigned Byte
 
−
* Changed Spawn Player's 'Entity ID' type to VarInt
 
−
* Changed Spawn Object's 'Entity ID' type to VarInt
 
−
* Changed Spawn Mob's 'Entity ID' type to VarInt
 
−
* Changed Spawn Painting's 'Entity ID' type to VarInt
 
−
* Changed Spawn Experience Orb's 'Entity ID' type to VarInt
 
  
−
== Protocol Version ==
+
{| class="wikitable"
−
13w41a/b - 0
+
|-
 +
! Hex Mask
 +
! Field
 +
|-
 +
| 0x0001
 +
| Relative X
 +
|-
 +
| 0x0002
 +
| Relative Y
 +
|-
 +
| 0x0004
 +
| Relative Z
 +
|-
 +
| 0x0008
 +
| Relative Yaw
 +
|-
 +
| 0x0010
 +
| Relative Pitch
 +
|- {{added}}
 +
| 0x0020
 +
| Relative Velocity X
 +
|- {{added}}
 +
| 0x0040
 +
| Relative Velocity Y
 +
|- {{added}}
 +
| 0x0080
 +
| Relative Velocity Z
 +
|- {{added}}
 +
| 0x0100
 +
| Rotate velocity according to the change in rotation, ''before'' applying the velocity change in this packet. Combining this with absolute rotation works as expected&mdash;the difference in rotation is still used.
 +
|}
  
−
13w39a/b - 80
+
=== Packets ===
  
−
13w38a/b/c - 79
+
{| class="wikitable"
 +
! ID
 +
! Packet name
 +
!colspan="2"| Documentation
 +
|-
 +
!colspan="4"| Play clientbound
 +
{{PacketList|0x12|Close Container}}
 +
{{PacketList|0x13|Set Container Content}}
 +
{{PacketList|0x14|Set Container Property}}
 +
{{PacketList|0x15|Set Container Slot}}
 +
{{PacketList|0x17|Set Cooldown}}
 +
{{PacketList|{{change|0x70|0x20}}|Teleport Entity}}
 +
{{PacketList|{{change|0x20|0x21}}|Explosion}}
 +
{{PacketList|{{change|0x23|0x24}}|Open Horse Screen}}
 +
{{PacketList|{{change|0x2B|0x2C}}|Login (play)}}
 +
{{PacketList|0x31|Move Minecart Along Track|rel=added}}
 +
{{PacketList|{{change|0x37|0x39}}|Place Ghost Recipe}}
 +
{{PacketList|{{change|0x3E|0x40}}|Player Info Update}}
 +
{{PacketList|{{change|0x40|0x42}}|Synchronize Player Position}}
 +
{{PacketList|0x41|Update Recipe Book|pre=removed}}
 +
{{PacketList|0x43|Player Rotation|rel=added}}
 +
{{PacketList|0x44|Recipe Book Add|rel=added}}
 +
{{PacketList|0x45|Recipe Book Remove|rel=added}}
 +
{{PacketList|0x46|Recipe Book Settings|rel=added}}
 +
{{PacketList|{{change|0x47|0x4C}}|Respawn}}
 +
{{PacketList|0x5a|Set Cursor Item|rel=added}}
 +
{{PacketList|{{change|0x53|0x63}}|Set Held Item|pre=unchanged}}
 +
{{PacketList|0x66|Set Player Inventory Slot|rel=added}}
 +
{{PacketList|{{change|0x64|0x6b}}|Update Time}}
 +
{{PacketList|0x77|Synchronize Vehicle Position|rel=added}}
 +
{{PacketList|{{change|0x77|0x7e}}|Update Recipes}}
 +
|-
 +
!colspan="4"| Play serverbound
 +
{{PacketList|0x02|Bundle Item Selected|rel=added}}
 +
{{PacketList|0x0b|Client Tick End|rel=added}}
 +
{{PacketList|{{change|0x0E|0x10}}|Click Container}}
 +
{{PacketList|{{change|0x0F|0x11}}|Close Container}}
 +
{{PacketList|{{change|0x14|0x16}}|Edit Book}}
 +
{{PacketList|{{change|0x1A|0x1C}}|Set Player Position}}
 +
{{PacketList|{{change|0x1B|0x1D}}|Set Player Position and Rotation}}
 +
{{PacketList|{{change|0x1C|0x1E}}|Set Player Rotation}}
 +
{{PacketList|0x1D|Set Player On Ground|pre=removed}}
 +
{{PacketList|0x1F|Set Player Movement Flags|rel=added}}
 +
{{PacketList|{{change|0x22|0x24}}|Place Recipe}}
 +
{{PacketList|{{change|0x26|0x28}}|Player Input}}
 +
{{PacketList|{{change|0x29|0x2B}}|Set Seen Recipe}}
 +
{{PacketList|{{change|0x38|0x3A}}|Use Item On}}
 +
|}
  
−
1.6.4 - 78
+
== Entity Metadata ==
  
−
1.6.3 - 77
+
=== Entity Metadata Format ===
  
−
13w37b - 76
+
==== Painting Variant ====
  
−
13w36a - 75
+
{{See also|Registry Data#Painting Variant}}
  
−
== Packet format ==
+
{| class="wikitable"
 +
! Name
 +
! Type
 +
! Meaning
 +
|-
 +
| Width
 +
| {{Type|Int}}
 +
| The width of the painting, in blocks.
 +
|-
 +
| Height
 +
| {{Type|Int}}
 +
| The height of the painting, in blocks.
 +
|-
 +
| Asset ID
 +
| {{Type|Identifier}}
 +
| The texture for the painting.
 +
The Notchian client uses the corresponding asset located at
 +
<code>textures/painting</code>.
 +
|- {{added}}
 +
| Has title
 +
| {{Type|Boolean}}
 +
|
 +
|- {{added}}
 +
| Title
 +
| {{Type|Optional}} {{Type|Text Component}}
 +
| The displayed title of the painting. Only present if Has title is true.
 +
|- {{added}}
 +
| Has author
 +
| {{Type|Boolean}}
 +
|
 +
|- {{added}}
 +
| Author
 +
| {{Type|Optional}} {{Type|Text Component}}
 +
| The displayed author of the painting. Only present if Has author is true.
 +
|}
  
−
{| class="wikitable"
+
== Registry Data ==
−
! Field Name !! Field Type !! Notes
 
−
|-
 
−
| Length || VarInt ||
 
−
|-
 
−
| Type || VarInt ||
 
−
|-
 
−
| Data || ||
 
−
|}
 
  
−
== Data Types ==
+
=== Painting Variant ===
  
−
VarInt - [http://developers.google.com/protocol-buffers/docs/encoding#varints Protocol Buffer 32-bit Varint]
+
The <code>minecraft:painting_variant</code> registry. It defines the textures and dimensions for the game's paintings.  
  
−
String - UTF-8 String prefixed with a VarInt
+
{| class="wikitable"
 +
! Name
 +
! Type
 +
! Meaning
 +
! Values
 +
|-
 +
| asset_id
 +
| [[NBT#Specification:string_tag|String Tag]]
 +
| The texture for the painting.
 +
The Notchian client uses the corresponding asset located at
 +
<code>textures/painting</code>.
 +
| Example: "minecraft:backyard".
 +
|-
 +
| height
 +
| [[NBT#Specification:int_tag|Int Tag]]
 +
| The height of the painting, in blocks.
 +
| Example: <code>2</code>
 +
|-
 +
| width
 +
| [[NBT#Specification:int_tag|Int Tag]]
 +
| The width of the painting, in blocks.
 +
|
 +
|- {{added}}
 +
| title
 +
| [[NBT#Specification:compound_tag|Compound Tag]] or [[NBT#Specification:string_tag|String Tag]]
 +
| The displayed title of the painting. See [[Text formatting]].
 +
| Example: <code>{"color": "gray", "translate": "painting.minecraft.skeleton.title"}</code>
 +
|- {{added}}
 +
| author
 +
| [[NBT#Specification:compound_tag|Compound Tag]] or [[NBT#Specification:string_tag|String Tag]]
 +
| The displayed author of the painting. See [[Text formatting]].
 +
| Example: <code>{"color": "gray", "translate": "painting.minecraft.skeleton.author"}</code>
 +
|}
  
−
== Handshaking ==
+
== Slot Data ==
  
−
=== Serverbound ===
+
=== Structured components ===
  
−
==== Handshake ====
 
−
This causes the server to switch into the target state.
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Type
−
|-
+
! Name
−
| rowspan=4 | 0x00
+
! Description
−
| Protocol Version || VarInt ||
+
! style="width: 50%" | Data
−
|-
+
|- {{added}}
−
| Server Address (hostname or IP) || String || localhost
+
| 6
−
|-  
+
| <code>minecraft:item_model</code>
−
| Server Port || Unsigned Short|| 25565
+
| Item's model.
−
|-
+
| As follows:
−
| Current state || VarInt || 1 for status, 2 for login
+
  {| class="wikitable" {{added}}
−
|}
+
    ! Name
 +
    ! Type
 +
    ! Description
 +
    |-
 +
    | Model
 +
    | {{Type|Identifier}}
 +
    |
 +
    |}
 +
|-
 +
| {{change|20|21}}
 +
| <code>minecraft:food</code>
 +
| Makes the item {{change|consumable|restore the player's hunger bar when consumed}}.
 +
| As follows:
 +
  {| class="wikitable"
 +
    ! colspan="2"| Name
 +
    ! colspan="2"| Type
 +
    ! Description
 +
    |-
 +
    | colspan="2"| Nutrition
 +
    | colspan="2"| {{Type|VarInt}}
 +
    | Non-negative
 +
    |-
 +
    | colspan="2"| Saturation Modifier
 +
    | colspan="2"| {{Type|Float}}
 +
    | How much saturation will be given after consuming the item.
 +
    |-
 +
    | colspan="2"| Can Always Eat
 +
    | colspan="2"| {{Type|Boolean}}
 +
    | Whether the item can always be eaten, even at full hunger.
 +
    |- {{removed}}
 +
    | colspan="2"| Seconds To Eat
 +
    | colspan="2"| {{Type|Float}}
 +
    | How long it takes to consume the item.
 +
    |- {{removed}}
 +
    | colspan="2"| Using converts to
 +
    | colspan="2"| {{Type|Slot Data}}
 +
    | This specifies the item produced after consuming the current item. In the Notchian server, this is used for stews, which turn into bowls. Set this to Air if the item should be consumed normally without leaving any other item after.
 +
    |- {{removed}}
 +
    | colspan="2"| Number of effects
 +
    | colspan="2"| {{Type|VarInt}}
 +
    | Number of elements in the following array.
 +
    |- {{removed}}
 +
    | rowspan="2"| Effect
 +
    | Type ID
 +
    | rowspan="2"| {{Type|Array}}
 +
    | [[#Potion_Effect|Potion Effect]]
 +
    | The potion effect. See [[#Potion_Effect|Potion Effect]].
 +
    |- {{removed}}
 +
    | Probability
 +
    | {{Type|Float}}
 +
    | The probability for this effect to be chosen.
 +
    |}
 +
|- {{added}}
 +
| 22
 +
| <code>minecraft:consumable</code>
 +
| Makes the item consumable.
 +
| As follows:
 +
  {| class="wikitable" {{added}}
 +
    ! Name
 +
    ! Type
 +
    ! Description
 +
    |-
 +
    | Consume seconds
 +
    | {{Type|Float}}
 +
    | How long it takes to consume the item.
 +
    |-
 +
    | Animation
 +
    | {{Type|VarInt}} {{Type|Enum}}
 +
    | 0: none, 1: eat, 2: drink, 3: block, 4: bow, 5: spear, 6: crossbow, 7: spyglass, 8: toot_horn, 9: brush
 +
    |-
 +
    | Sound
 +
    | {{Type|ID or}} {{Type|Sound Event}}
 +
    | ID in the <code>minecraft:sound_event</code> registry, or an inline definition.
 +
    |-
 +
    | Has consume particles
 +
    | {{Type|Boolean}}
 +
    |
 +
    |-
 +
    | Number of effects
 +
    | {{Type|VarInt}}
 +
    | Number of elements in the following array.
 +
    |-
 +
    | Effects
 +
    | {{Type|Array}} of [[#Consume Effect|Consume Effect]]
 +
    | Effects to apply on consumption. See [[#Consume Effect|Consume Effect]].
 +
    |}
 +
|- {{added}}
 +
| 23
 +
| <code>minecraft:use_remainder</code>
 +
| This specifies the item produced after using the current item. In the Notchian server, this is used for stews, which turn into bowls.
 +
| As follows:
 +
  {| class="wikitable" {{added}}
 +
    ! Name
 +
    ! Type
 +
    ! Description
 +
    |-
 +
    | Remainder
 +
    | {{Type|Slot}}
 +
    |
 +
    |}
 +
|- {{added}}
 +
| 24
 +
| <code>minecraft:use_cooldown</code>
 +
| Cooldown to apply on use of the item.
 +
| As follows:
 +
  {| class="wikitable" {{added}}
 +
    ! Name
 +
    ! Type
 +
    ! Description
 +
    |-
 +
    | Seconds
 +
    | {{Type|Float}}
 +
    |
 +
    |-
 +
    | Cooldown group
 +
    | {{Type|Optional}} {{Type|Identifier}}
 +
    | Group of items to apply the cooldown to. Only present if Has cooldown group is true; otherwise defaults to the item's identifier.
 +
    |}
 +
|-
 +
| {{change|21|25}}
 +
| <code>minecraft:{{change|fire|damage}}_resistant</code>
 +
| Marks this item as {{change|fire|damage}} resistant.<br>The client won't render the item as being on-fire if this component is present.
 +
| {{change|None.|As follows:}}
 +
  {| class="wikitable" {{added}}
 +
    ! Name
 +
    ! Type
 +
    ! Description
 +
    |-
 +
    | Types
 +
    | {{Type|Identifier}}
 +
    | Tag specifying damage types the item is immune to. Not prefixed by '#'!.
 +
    |}
 +
|- {{added}}
 +
| 27
 +
| <code>minecraft:enchantable</code>
 +
| Allows the item to be enchanted by an enchanting table.
 +
| As follows:
 +
  {| class="wikitable" {{added}}
 +
    ! Name
 +
    ! Type
 +
    ! Description
 +
    |-
 +
    | Value
 +
    | {{Type|VarInt}}
 +
    | Opaque internal value controlling how expensive enchantments may be offered.
 +
    |}
 +
|- {{added}}
 +
| 28
 +
| <code>minecraft:equippable</code>
 +
| Allows the item to be equipped by the player.
 +
| As follows:
 +
  {| class="wikitable" {{added}}
 +
    ! Name
 +
    ! Type
 +
    ! Description
 +
    |-
 +
    | Slot
 +
    | {{Type|VarInt}} {{Type|Enum}}
 +
    | 0: mainhand, 1: feet, 2: legs, 3: chest, 4: head, 5: offhand, 6: body
 +
    |-
 +
    | Equip sound
 +
    | {{Type|ID or}} {{Type|Sound Event}}
 +
    | ID in the <code>minecraft:sound_event</code> registry, or an inline definition.
 +
    |-
 +
    | Has model
 +
    | {{Type|Boolean}}
 +
    |
 +
    |-
 +
    | Model
 +
    | {{Type|Optional}} {{Type|Identifier}}
 +
    | Only present if Has model is true.
 +
    |-
 +
    | Has camera overlay
 +
    | {{Type|Boolean}}
 +
    |
 +
    |-
 +
    | Camera overlay
 +
    | {{Type|Optional}} {{Type|Identifier}}
 +
    | Only present if Has camera overlay is true.
 +
    |-
 +
    | Has allowed entities
 +
    | {{Type|Boolean}}
 +
    |-
 +
    | Allowed entities
 +
    | {{Type|Optional}} {{Type|ID Set}}
 +
    | IDs in the <code>minecraft:entity_type</code> registry. Only present if Has allowed entities is true.
 +
    |-
 +
    | Dispensable
 +
    | {{Type|Boolean}}
 +
    |
 +
    |-
 +
    | Swappable
 +
    | {{Type|Boolean}}
 +
    |
 +
    |-
 +
    | Damage on hurt
 +
    | {{Type|Boolean}}
 +
    |
 +
    |}
 +
|- {{added}}
 +
| 29
 +
| <code>minecraft:repairable</code>
 +
| Items that can be combined with this item in an anvil to repair it.
 +
| As follows:
 +
  {| class="wikitable" {{added}}
 +
    ! Name
 +
    ! Type
 +
    ! Description
 +
    |-
 +
    | Items
 +
    | {{Type|ID Set}}
 +
    | IDs in the <code>minecraft:item</code> registry.
 +
    |}
 +
|- {{added}}
 +
| 30
 +
| <code>minecraft:glider</code>
 +
| Makes the item function like elytra.
 +
| None.
 +
|- {{added}}
 +
| 31
 +
| <code>minecraft:tooltip_style</code>
 +
| Custom textures for the item tooltip.
 +
| As follows:
 +
  {| class="wikitable" {{added}}
 +
    ! Name
 +
    ! Type
 +
    ! Description
 +
    |-
 +
    | Style
 +
    | {{Type|Identifier}}
 +
    |
 +
    |}
 +
|- {{added}}
 +
| 32
 +
| <code>minecraft:death_protection</code>
 +
| Makes the item function like a totem of undying.
 +
| As follows:
 +
  {| class="wikitable" {{added}}
 +
    ! Name
 +
    ! Type
 +
    ! Description
 +
    |-
 +
    | Number of effects
 +
    | {{Type|VarInt}}
 +
    | Number of elements in the following array.
 +
    |-
 +
    | Effects
 +
    | {{Type|Array}} of [[#Consume Effect|Consume Effect]]
 +
    | Effects to apply on consumption. See [[#Consume Effect|Consume Effect]].
 +
    |}
 +
|-
 +
| {{change|31|41}}
 +
| <code>minecraft:potion_contents</code>
 +
| Visual and effects of a potion item.
 +
| As follows:
 +
  {| class="wikitable"
 +
    ! Name
 +
    ! Type
 +
    ! Description
 +
    |-
 +
    | Has Potion ID
 +
    | {{Type|Boolean}}
 +
    | Whether this potion has an ID in the potion registry. If true, it has the default effects associated with the potion type.
 +
    |-
 +
    | Potion ID
 +
    | {{Type|Optional}} {{Type|VarInt}}
 +
    | The ID of the potion type in the potion registry. Only present if Has Potion ID is true.
 +
    |-
 +
    | Has Custom Color
 +
    | {{Type|Boolean}}
 +
    | Whether this potion has a custom color. If false, it uses the default color associated with the potion type.
 +
    |-
 +
    | Custom Color
 +
    | {{Type|Optional}} {{Type|Int}}
 +
    | The RGB components of the color, encoded as an integer. Only present if Has Custom Color is true.
 +
    |-
 +
    | Number Of Custom Effects
 +
    | {{Type|VarInt}}
 +
    | The number of elements in the following array.
 +
    |-
 +
    | Custom Effects
 +
    | {{Type|Array}} of [[#Potion_Effect|Potion Effect]]
 +
    | Any custom effects the potion might have. See [[#Potion_Effect|Potion Effect]].
 +
    |- {{added}}
 +
    | Custom Name
 +
    | {{Type|String}}
 +
    |
 +
    |}
 +
|}
 +
 
 +
=== Other types ===
 +
 
 +
==== Consume Effect ====
  
−
== Play ==
+
WIP
  
−
=== Clientbound ===
+
==== Instrument ====
  
−
==== Keep Alive ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Name
−
|-
+
! Type
−
| rowspan=1 | 0x00
+
! Description
−
| Keep Alive ID || Int ||
+
|-
−
|}
+
| Sound Event
 +
| {{Type|Id or}} {{Type|Sound Event}}
 +
| The sound to be played.
 +
|-
 +
| Use duration
 +
| {{change|{{Type|VarInt}}|{{Type|Float}}}}
 +
| The maximum range of the sound.
 +
|-
 +
| Range
 +
| {{Type|Float}}
 +
| The range of the instrument.
 +
|- {{added}}
 +
| Description
 +
| {{Type|Text Component}}
 +
| Description shown in the item tooltip.
 +
|}
  
 +
== Particles ==
  
−
==== Join Game ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
|-
−
|-
+
! Particle Name
−
| rowspan=5 | 0x01
+
! Particle ID
−
| Entity ID || Int || The player's Entity ID
+
! Data
−
|-
+
|-
−
| Gamemode || Unsigned Byte || 0: survival, 1: creative, 2: adventure. Bit 3 (0x8) is the hardcore flag
+
| <code>minecraft:dust</code>
−
|-
+
| 13
−
| Dimension || Byte || -1: nether, 0: overworld, 1: end
+
|
−
|-
+
{| class="wikitable"
−
| Difficulty || Unsigned Byte || 0 thru 3 for Peaceful, Easy, Normal, Hard
+
  ! Field Name
−
|-
+
  ! Field Type
−
| Max Players || Unsigned Byte || Used by the client to draw the player list
+
  ! Meaning
−
|}
+
  |- {{removed}}
 +
  | Red
 +
  | {{Type|Float}}
 +
  | The red RGB value, between 0 and 1. Divide actual RGB value by 255.
 +
  |- {{removed}}
 +
  | Green
 +
  | {{Type|Float}}
 +
  | The green RGB value, between 0 and 1. Divide actual RGB value by 255.
 +
  |- {{removed}}
 +
  | Blue
 +
  | {{Type|Float}}
 +
  | The blue RGB value, between 0 and 1. Divide actual RGB value by 255.
 +
  |- {{added}}
 +
  | Color
 +
  | {{Type|Int}}
 +
  | The color, encoded as 0xRRGGBB; top bits are ignored.
 +
  |-
 +
  | Scale
 +
  | {{Type|Float}}
 +
  | The scale, will be clamped between 0.01 and 4.
 +
  |}
 +
|-
 +
| <code>minecraft:dust_color_transition</code>
 +
| 14
 +
|
 +
{| class="wikitable"
 +
  ! Field Name
 +
  ! Field Type
 +
  ! Meaning
 +
  |- {{removed}}
 +
  | From Red
 +
  | {{Type|Float}}
 +
  | The start red RGB value, between 0 and 1. Divide actual RGB value by 255.
 +
  |- {{removed}}
 +
  | From Green
 +
  | {{Type|Float}}
 +
  | The start green RGB value, between 0 and 1. Divide actual RGB value by 255.
 +
  |- {{removed}}
 +
  | From Blue
 +
  | {{Type|Float}}
 +
  | The start blue RGB value, between 0 and 1. Divide actual RGB value by 255.
 +
  |- {{added}}
 +
  | From Color
 +
  | {{Type|Int}}
 +
  | The start color, encoded as 0xRRGGBB; top bits are ignored.
 +
  |- {{removed}}
 +
  | To Red
 +
  | {{Type|Float}}
 +
  | The end red RGB value, between 0 and 1. Divide actual RGB value by 255.
 +
  |- {{removed}}
 +
  | To Green
 +
  | {{Type|Float}}
 +
  | The end green RGB value, between 0 and 1. Divide actual RGB value by 255.
 +
  |- {{removed}}
 +
  | To Blue
 +
  | {{Type|Float}}
 +
  | The end blue RGB value, between 0 and 1. Divide actual RGB value by 255.
 +
  |- {{added}}
 +
  | To Color
 +
  | {{Type|Int}}
 +
  | The end color, encoded as 0xRRGGBB; top bits are ignored.
 +
  |-
 +
  | Scale
 +
  | {{Type|Float}}
 +
  | The scale, will be clamped between 0.01 and 4.
 +
  |}
 +
|}
 +
 
 +
== Recipes ==
 +
 
 +
(this is meant to become a new page.)
  
−
==== Chat Message ====
+
=== Recipe Display structure ===
−
{| 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"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Name
−
|-
+
! Type
−
| rowspan=2 | 0x03
+
! Description
−
| Age of the world || Long || In ticks; not changed by server commands
+
|-
−
|-
+
| Recipe Display Type
−
| 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
+
| {{Type|VarInt}}
−
|}
+
| ID in the <code>minecraft:recipe_display</code> registry.
 +
|-
 +
| Data
 +
| Varies
 +
| See [[#Recipe Display types]] below.
 +
|}
  
−
==== Entity Equipment ====
+
==== Recipe Display types ====
−
{| 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"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! ID
−
|-
+
! Name
−
| rowspan=3 | 0x05
+
! Data
−
| X || Int || Spawn X in block coordinates
+
|-
−
|-
+
| 0
−
| Y || Int || Spawn Y in block coordinates
+
| <code>minecraft:crafting_shapeless</code>
−
|-
+
| [[#minecraft:crafting_shapeless|data]]
−
| Z || Int || Spawn | in block coordinates
+
|-
−
|}
+
| 1
 +
| <code>minecraft:crafting_shaped</code>
 +
| [[#minecraft:crafting_shaped|data]]
 +
|-
 +
| 2
 +
| <code>minecraft:furnace</code>
 +
| [[#minecraft:furnace|data]]
 +
|-
 +
| 3
 +
| <code>minecraft:stonecutter</code>
 +
| [[#minecraft:stonecutter|data]]
 +
|-
 +
| 4
 +
| <code>minecraft:smithing</code>
 +
| [[#minecraft:smithing|data]]
 +
|}
  
−
==== Update Health ====
+
===== <code>minecraft:crafting_shapeless</code> =====
−
{| 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"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Name
−
|-
+
! Type
−
| rowspan=3 | 0x07
+
! Description
−
| Dimension || Int || -1: The Nether, 0: The Overworld, 1: The End
+
|-
−
|-
+
| Ingredient Count
−
| Difficulty || Unsigned Byte || 0 thru 3 for Peaceful, Easy, Normal, Hard.
+
| {{Type|VarInt}}
−
|-
+
| Number of elements in the following array.
−
| Gamemode || Unsigned Byte || 0: survival, 1: creative, 2: adventure. The hardcore flag is not included
+
|-
−
|}
+
| Ingredients
 +
| {{Type|Array}} of {{Type|Slot Display}}
 +
|
 +
|-
 +
| Result
 +
| {{Type|Slot Display}}
 +
|
 +
|-
 +
| Crafting Station
 +
| {{Type|Slot Display}}
 +
| Crafting station icon to display in the recipe notification.
 +
|}
  
−
==== Player Position And Look ====  
+
===== <code>minecraft:crafting_shaped</code> =====
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=6| 0x08
 
−
| X || Double || Absolute position
 
−
|-
 
−
| Y || Double || Absolute position
 
−
|-
 
−
| 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"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Name
−
|-
+
! Type
−
| rowspan=1 | 0x09
+
! Description
−
| Slot || Byte || The slot which the player has selected (0-8)
+
|-
−
|}
+
| Width
 +
| {{Type|VarInt}}
 +
|
 +
|-
 +
| Height
 +
| {{Type|VarInt}}
 +
|
 +
|-
 +
| Ingredient Count
 +
| {{Type|VarInt}}
 +
| Number of elements in the following array. Always equal to Width * Height.
 +
|-
 +
| Ingredients
 +
| {{Type|Array}} of {{Type|Slot Display}}
 +
|
 +
|-
 +
| Result
 +
| {{Type|Slot Display}}
 +
|
 +
|-
 +
| Crafting Station
 +
| {{Type|Slot Display}}
 +
| Crafting station icon to display in the recipe notification.
 +
|}
  
−
==== Use Bed ====  
+
===== <code>minecraft:furnace</code> =====
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=5 | 0x0A
 
−
| Entity ID || Int || Player ID
 
−
|-
 
−
| 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"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Name
−
|-
+
! Type
−
| rowspan=2 | 0x0B
+
! Description
−
| Entity ID || Int || Player ID
+
|-
−
|-
+
| Ingredient
−
| Animation || Unsigned Byte || Animation ID
+
|{{Type|Slot Display}}
−
|}
+
|
 +
|-
 +
| Fuel
 +
| {{Type|Slot Display}}
 +
|
 +
|-
 +
| Result
 +
| {{Type|Slot Display}}
 +
|
 +
|-
 +
| Crafting Station
 +
| {{Type|Slot Display}}
 +
| Crafting station icon to display in the recipe notification.
 +
|-
 +
| Cooking Time
 +
| {{Type|VarInt}}
 +
| Time to smelt in a regular furnace, in ticks.
 +
|-
 +
| Experience
 +
| {{Type|Float}}
 +
|
 +
|}
  
−
Animation can be one of the following values:
+
===== <code>minecraft:stonecutter</code> =====
  
 
{| class="wikitable"
 
{| class="wikitable"
−
! ID !! Animation
+
! Name
−
|-
+
! Type
−
| 0 || No animation
+
! Description
−
|-
+
|-
−
| 1 || Swing arm
+
| Ingredient
−
|-
+
| {{Type|Slot Display}}
−
| 2 || Damage animation
+
|
−
|-
+
|-
−
| 3 || Leave bed
+
| Result
−
|-
+
| {{Type|Slot Display}}
−
| 5 || Eat food
+
|
−
|-
+
|-
−
| 6 || Critical effect
+
| Crafting Station
−
|-
+
| {{Type|Slot Display}}
−
| 7 || Magic critical effect
+
| Crafting station icon to display in the recipe notification.
−
|-
+
|}
−
| 102 || (unknown)
 
−
|-
 
−
| 104 || Crouch
 
−
|-
 
−
| 105 || Uncrouch
 
−
|}
 
  
−
==== Spawn Player ====
+
===== <code>minecraft:smithing</code> =====
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=10 | 0x0C
 
−
| Entity ID || VarInt || 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"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Name
−
|-
+
! Type
−
| rowspan=2 | 0x0D
+
! Description
−
| Collected Entity ID || Int ||
+
|-
−
|-  
+
| Template
−
| Collector Entity ID || Int ||
+
| {{Type|Slot Display}}
−
|}
+
|
 +
|-
 +
| Base
 +
| {{Type|Slot Display}}
 +
|
 +
|-
 +
| Addition
 +
| {{Type|Slot Display}}
 +
|
 +
|-
 +
| Result
 +
| {{Type|Slot Display}}
 +
|
 +
|-
 +
| Crafting Station
 +
| {{Type|Slot Display}}
 +
| Crafting station icon to display in the recipe notification.
 +
|}
  
−
==== Spawn Object ====
+
=== Slot Display structure ===
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=8| 0x0E
 
−
| Entity ID || VarInt || 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"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Name
−
|-
+
! Type
−
| rowspan=12 | 0x0F
+
! Description
−
| Entity ID || VarInt || Entity's ID
+
|-
−
|-
+
| Slot Display Type
−
| Type || Unsigned Byte || The type of mob. See [[Entities#Mobs|Mobs]]
+
| {{Type|VarInt}}
−
|-
+
| ID in the <code>minecraft:slot_display</code> registry.
−
| X || Int || X position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
+
|-
−
|-
+
| Data
−
| Y || Int || Y position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
+
| Varies
−
|-
+
| See [[#Slot Display types]] below.
−
| 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 ====
+
==== Slot Display types ====
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=6 | 0x10
 
−
| Entity ID || VarInt || 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"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! ID
−
|-
+
! Name
−
| rowspan=5 | 0x11
+
! Data
−
| Entity ID || VarInt || Entity's ID
+
|-
−
|-
+
| 0
−
| X || Int || X position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]  
+
| <code>minecraft:empty</code>
−
|-
+
| no data
−
| Y || Int || Y position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]  
+
|-
−
|-
+
| 1
−
| Z || Int || Z position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]  
+
| <code>minecraft:any_fuel</code>
−
|-
+
| no data
−
| Count || Short || The amount of experience this orb will reward once collected
+
|-
−
|}
+
| 2
 +
| <code>minecraft:item</code>
 +
| [[#minecraft:item|data]]
 +
|-
 +
| 3
 +
| <code>minecraft:item_stack</code>
 +
| [[#minecraft:item_stack|data]]
 +
|-
 +
| 4
 +
| <code>minecraft:tag</code>
 +
| [[#minecraft:tag|data]]
 +
|-
 +
| 5
 +
| <code>minecraft:smithing_trim</code>
 +
| [[#minecraft:smithing_trim|data]]
 +
|-
 +
| 6
 +
| <code>minecraft:with_remainder</code>
 +
| [[#minecraft:with_remainder|data]]
 +
|-
 +
| 7
 +
| <code>minecraft:composite</code>
 +
| [[#minecraft:composite|data]]
 +
|}
  
−
==== Entity Velocity ====
+
===== <code>minecraft:item</code> =====
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=4 | 0x12
 
−
| 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 Entities====
 
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=2 | 0x13
 
−
| Count || Byte || Length of following array
 
−
|-
 
−
| Entity IDs || Array of Int || The list of entities of destroy
 
−
|}
 
  
−
==== Entity ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Name
−
|-
+
! Type
−
| rowspan=1 | 0x14
+
! Description
−
| Entity ID || Int || Entity's ID
+
|-
−
|}
+
| Item Type
 +
| {{Type|VarInt}}
 +
| ID in the <code>minecraft:item</code> registry.
 +
|}
  
−
==== Entity Relative Move ====
+
===== <code>minecraft:item_stack</code> =====
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=4| 0x15
 
−
| 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"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Name
−
|-
+
! Type
−
| rowspan=3 | 0x16
+
! Description
−
| Entity ID || Int || Entity's ID
+
|-
−
|-
+
| Item Stack
−
| Yaw || Byte || The X Axis rotation as a fraction of 360
+
| {{Type|Slot}}
−
|-
+
|
−
| Pitch || Byte || The Y Axis rotation as a fraction of 360
+
|}
−
|}
 
  
−
==== Entity Look and Relative Move ====
+
===== <code>minecraft:tag</code> =====
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=6 | 0x17
 
−
| 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"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Name
−
|-
+
! Type
−
| rowspan=6 | 0x18
+
! Description
−
| Entity ID || Int || Entity's ID
+
|-
−
|-
+
| Tag
−
| X || Int || X position as a [[Data_Types#Fixed-point_numbers|Fixed-Point number]]
+
| {{Type|Identifier}}
−
|-
+
| Tag in the <code>minecraft:item</code> registry. Not prefixed by '#'!.
−
| 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]]
 
−
|-
 
−
| 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 ====
+
===== <code>minecraft:smithing_trim</code> =====
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=2 | 0x19
 
−
| Entity ID || Int || Entity's ID
 
−
|-
 
−
| Head Yaw || Byte || Head yaw in steps of 2p/256
 
−
|}
 
  
−
==== Entity Status ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Name
−
|-
+
! Type
−
| rowspan=2 | 0x1A
+
! Description
−
| Entity ID || Int || Entity's ID
+
|-
−
|-
+
| Base
−
| Entity Status || Byte || See below
+
| {{Type|Slot Display}}
−
|}
+
|
 +
|-
 +
| Material
 +
| {{Type|Slot Display}}
 +
|
 +
|-
 +
| Pattern
 +
| {{Type|Slot Display}}
 +
|
 +
|}
  
−
{| class="wikitable"
+
===== <code>minecraft:with_remainder</code> =====
−
|-
 
−
! 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"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Name
−
|-
+
! Type
−
| rowspan=3 | 0x1B
+
! Description
−
| Entity ID || Int || Entity's ID
+
|-
−
|-
+
| Ingredient
−
| Vehicle ID || Int || Vechicle's Entity ID
+
| {{Type|Slot Display}}
−
|-
+
|
−
| Leash || Bool || If true leashes the entity to the vehicle
+
|-
−
|}
+
| Remainder
 +
| {{Type|Slot Display}}
 +
|
 +
|}
  
−
==== Entity Metadata ====
+
===== <code>minecraft:composite</code> =====
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=2 | 0x1C
 
−
| Entity ID || Int || Entity's ID
 
−
|-
 
−
| Metadata || [[Entities#Entity_Metadata_Format|Metadata]] ||
 
−
|}
 
  
−
==== Entity Effect ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Name
−
|-
+
! Type
−
| rowspan=4 | 0x1D
+
! Description
−
| Entity ID || Int || Entity's ID
+
|-
−
|-
+
| Option Count
−
| Effect ID || Byte || See [[http://www.minecraftwiki.net/wiki/Potion_effect#Parameters]]
+
| {{Type|VarInt}}
−
|-
+
| Number of elements in the following array.
−
| Amplifier || Byte ||  
+
|-
−
|-
+
| Options
−
| Duration || Short ||
+
| {{Type|Array}} of {{Type|Slot Display}}
−
|}
+
|
 +
|}
  
−
==== Remove Entity Effect ====
+
== Handshake ==
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=2 | 0x1E
 
−
| Entity ID || Int || Entity's ID
 
−
|-
 
−
| Effect ID || Byte ||
 
−
|}
 
  
−
==== Set Experience ====
+
No changes so far.
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=3 | 0x1F
 
−
| Experience bar || Float || Between 0 and 1
 
−
|-
 
−
| Level || Short ||
 
−
|-
 
−
| Total Experience || Short ||
 
−
|}
 
  
−
==== Entity Properties ====
+
== Status ==
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=3 | 0x20
 
−
| Entity ID || Int | Entity's ID
 
−
|-
 
−
| Count || Int || Length of following array
 
−
|-
 
−
| Properties || Array of Property Data ||
 
−
|}
 
  
−
'''Property Data''' structure:
+
No changes so far.
−
{| class="wikitable"
 
−
|-
 
−
! Field Name !! Field Type !! Notes
 
−
|-
 
−
| Key || String ||
 
−
|-
 
−
| Value || Double ||
 
−
|-
 
−
| List Length || Short || Number of list elements that follow.
 
−
|-
 
−
| Modifiers || Array of Modifier Data || http://www.minecraftwiki.net/wiki/Attribute#Modifiers
 
−
|}
 
  
−
Known key values:
+
== Login ==
−
{| class="wikitable"
 
−
|-
 
−
! Key !! Default !! Min !! Max !! Label
 
−
|-
 
−
| generic.maxHealth || 20.0 || 0.0 || Double.MaxValue || Max Health
 
−
|-
 
−
| generic.followRange || 32.0 || 0.0 || 2048.0 || Follow Range
 
−
|-
 
−
| generic.knockbackResistance || 0.0 || 0.0 || 1.0 || Knockback Resistance
 
−
|-
 
−
| generic.movementSpeed || 0.699999988079071 || 0.0 || Double.MaxValue || Movement Speed
 
−
|-
 
−
| generic.attackDamage || 2.0 || 0.0 || Double.MaxValue ||
 
−
|-
 
−
| horse.jumpStrength || 0.7 || 0.0 || 2.0 || Jump Strength
 
−
|-
 
−
| zombie.spawnReinforcements || 0.0 || 0.0 || 1.0 || Spawn Reinforcements Chance
 
−
|}
 
  
−
'''Modifier Data''' structure:
+
No changes so far.
−
{| class="wikitable"
 
−
|-
 
−
! Field Name !! Field Type !! Notes
 
−
|-
 
−
| UUID || 128-bit integer ||
 
−
|-
 
−
| Amount || Double ||
 
−
|-
 
−
| Operation || Byte ||
 
−
|}
 
  
−
==== Chunk Data ====
+
== Configuration ==
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=7 | 0x21
 
−
| Chunk X || Int || Chunk X coordinate
 
−
|-
 
−
| Chunk Z || Int || Chunk Z coordinate
 
−
|-
 
−
| Ground-Up continuous || Boolean || This is True if the packet represents all sections in this vertical column, where the primary bit map specifies exactly which sections are included, and which are air
 
−
|-
 
−
| Primary bit map || Unsigned Short || Bitmask with 1 for every 16x16x16 section which data follows in the compressed data.
 
−
|-
 
−
| Add bit map || Unsigned Short || Same as above, but this is used exclusively for the 'add' portion of the payload
 
−
|-
 
−
| Compressed size || Int || Size of compressed chunk data
 
−
|-
 
−
| Compressed data || Byte array || The chunk data is compressed using Zlib Deflate
 
−
|}
 
  
−
==== Multi Block Change ====
+
No changes so far.
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=5 | 0x22
 
−
| Chunk X || VarInt || Chunk X coordinate
 
−
|-
 
−
| Chunk Z || VarInt || Chunk Z Coordinate
 
−
|-
 
−
| Record count || Short || The number of blocks affected
 
−
|-
 
−
| Data size || Int ||  The total size of the data, in bytes. Should always be 4*record count
 
−
|-
 
−
| Records || Array of Records ||
 
−
|}
 
  
−
'''Record'''
+
== Play ==
−
{| class="wikitable"
 
−
|-
 
−
! Bit mask !! Width !! Meaning
 
−
|-
 
−
| 00 00 00 0F || 4 bits || Block metadata
 
−
|-
 
−
| 00 00 FF F0 || 12 bits || Block ID
 
−
|-
 
−
| 00 FF 00 00 || 8 bits || Y co-ordinate
 
−
|-
 
−
| 0F 00 00 00 || 4 bits || Z co-ordinate, relative to chunk
 
−
|-
 
−
| F0 00 00 00 || 4 bits || X co-ordinate, relative to chunk
 
−
|}
 
  
−
==== Block Change ====
+
=== Clientbound ===
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=5 | 0x23
 
−
| X || Int || Block X Coordinate
 
−
|-
 
−
| Y || Unsigned Byte || Block Y Coordinate
 
−
|-
 
−
| Z || Int || Block Z Coordinate
 
−
|-
 
−
| Block Type || VarInt || The new block type for the block
 
−
|-
 
−
| Block Data || Unsigned Byte || The new data for the block
 
−
|}
 
  
−
==== Block Action ====
+
==== Close Container ====
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=6 | 0x24
 
−
| X || Int || Block X Coordinate
 
−
|-
 
−
| Y || Short || Block Y Coordinate
 
−
|-
 
−
| Z || Int || Block Z Coordinate
 
−
|-
 
−
| Byte 1 || Unsigned Byte || Varies depending on block - see [[Block_Actions]]
 
−
|-
 
−
| Byte 2 || Unsigned Byte || Varies depending on block - see [[Block_Actions]]
 
−
|-
 
−
| Block Type || VarInt || The block type for the block
 
−
|}
 
  
−
==== Block Break Animation ====
+
This packet is sent from the server to the client when a window is forcibly closed, such as when a chest is destroyed while it's open. The notchian client disregards the provided window ID and closes any active window.
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=5 | 0x25
 
−
| Entity ID || Int || Entity's ID
 
−
|-
 
−
| X || Int || rowspan=3 | Block Position
 
−
|-
 
−
| Y || Int
 
−
|-
 
−
| Z || Int
 
−
|-
 
−
| Destroy Stage || Byte || 0 - 9
 
−
|}
 
  
−
==== Map Chunk Bulk ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Packet ID
−
|-
+
! State
−
| rowspan=5 | 0x26
+
! Bound To
−
| Chunk column count || Short || The number of chunk in this packet
+
! Field Name
−
|-
+
! Field Type
−
| Data length || Int || The size of the data field
+
! Notes
−
|-
+
|-
−
| Sky light sent || Bool || Whether or not the chunk data contains a light nibble array. This is true in the main world, false in the end + nether
+
| ''protocol:''<br/><code>0x12</code><br/><br/>''resource:''<br/><code>container_close</code>
−
|-
+
| Play
−
| Data || Byte Array || Compressed chunk data
+
| Client
−
|-
+
| Window ID
−
| Meta information || Meta || See below
+
| {{change|{{Type|Unsigned Byte}}|{{Type|VarInt}}}}
−
|}
+
| This is the ID of the window that was closed. 0 for inventory.
 +
|}
  
−
'''Meta'''
+
==== Set Container Content ====
−
{| class="wikitable"
+
[[File:Inventory-slots.png|thumb|The inventory slots]]
−
! Field Name !! Field Type !! Notes
 
−
|-
 
−
|Chunk X || Int || The X Coordinate of the chunk
 
−
|-
 
−
|Chunk Z || Int || The Z Coordinate of the chunk
 
−
|-
 
−
|Primary bitmap || Unsigned Short || A bitmap which specifies which sections are not empty in this chunk
 
−
|-
 
−
|Add bitmap || Unsigned Short || A bitmap which specifies which sections need add information because of very high block ids. not yet used
 
−
|}
 
  
−
==== Explosion ====
+
Replaces the contents of a container window. Sent by the server upon initialization of a container window or the player's inventory, and in response to state ID mismatches (see [[#Click Container]]).
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan="9" | 0x27
 
−
| X || Double ||
 
−
|-
 
−
| Y || Double ||
 
−
|-
 
−
| Z || Double ||
 
−
|-
 
−
| Radius || Float || Currently unused in the client
 
−
|-
 
−
| Record count || Int || This is the count, not the size. The size is 3 times this value.
 
−
|-
 
−
| Records || (Byte, Byte, Byte) × count || Each record is 3 signed bytes long, each bytes are the XYZ (respectively) offsets of affected blocks.
 
−
|-
 
−
| Player Motion X || Float || X velocity of the player being pushed by the explosion
 
−
|-
 
−
| Player Motion Y || Float || Y velocity of the player being pushed by the explosion
 
−
|-
 
−
| Player Motion Z || Float || Z velocity of the player being pushed by the explosion
 
−
|}
 
  
−
==== Effect ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Packet ID
−
|-
+
! State
−
| rowspan="6" | 0x28
+
! Bound To
−
| Effect ID || Int || The ID of the effect, see below.
+
! Field Name
−
|-
+
! Field Type
−
| X || Int || The X location of the effect multiplied by 8
+
! Notes
−
|-
+
|-
−
| Y || Byte || The Y location of the effect multiplied by 8
+
| rowspan="5"| ''protocol:''<br/><code>0x13</code><br/><br/>''resource:''<br/><code>container_set_content</code>
−
|-
+
| rowspan="5"| Play
−
| Z || Int || The Z location of the effect multiplied by 8
+
| rowspan="5"| Client
−
|-
+
| Window ID
−
| Data || Int || Extra data for certain effects, see below.
+
| {{change|{{Type|Unsigned Byte}}|{{Type|VarInt}}}}
−
|-
+
| The ID of window which items are being sent for. 0 for player inventory. The client ignores any packets targeting a Window ID other than the current one. However, an exception is made for the player inventory, which may be targeted at any time. (The Notchian server does not appear to utilize this special case.)
−
| Disable relative volume || Bool || See above
+
|-
−
|}
+
| State ID
 +
| {{Type|VarInt}}
 +
| A server-managed sequence number used to avoid desynchronization; see [[#Click Container]].
 +
|-
 +
| Count
 +
| {{Type|VarInt}}
 +
| Number of elements in the following array.
 +
|-
 +
| Slot Data
 +
| {{Type|Array}} of [[Slot Data|Slot]]
 +
|-
 +
| Carried Item
 +
| {{Type|Slot}}
 +
| Item being dragged with the mouse.
 +
|}
  
−
'''Sound''':
+
See [[Inventory#Windows|inventory windows]] for further information about how slots are indexed.
 +
Use [[#Open Screen|Open Screen]] to open the container on the client.
  
−
*1000: <code>random.click</code>
+
==== Set Container Property ====
−
*1001: <code>random.click</code>
 
−
*1002: <code>random.bow</code>
 
−
*1003: <code>random.door_open</code> or <code>random.door_close</code> (50/50 chance)
 
−
*1004: <code>random.fizz</code>
 
−
*1005: Play a music disc. '''Data''': [http://www.minecraftwiki.net/wiki/Music_Discs Record ID]
 
−
*''(1006 not assigned)''
 
−
*1007: <code>mob.ghast.charge</code>
 
−
*1008: <code>mob.ghast.fireball</code>
 
−
*1009: <code>mob.ghast.fireball</code>, but with a lower volume.
 
−
*1010: <code>mob.zombie.wood</code>
 
−
*1011: <code>mob.zombie.metal</code>
 
−
*1012: <code>mob.zombie.woodbreak</code>
 
−
*1013: <code>mob.wither.spawn</code>
 
−
*1014: <code>mob.wither.shoot</code>
 
−
*1015: <code>mob.bat.takeoff</code>
 
−
*1016: <code>mob.zombie.infect</code>
 
−
*1017: <code>mob.zombie.unfect</code>
 
−
*1018: <code>mob.enderdragon.end</code>
 
−
*1020: <code>random.anvil_break</code>
 
−
*1021: <code>random.anvil_use</code>
 
−
*1022: <code>random.anvil_land</code>
 
  
−
'''Particle''':
+
This packet is used to inform the client that part of a GUI window should be updated.
  
−
*2000: Spawns 10 smoke particles, e.g. from a fire. '''Data''': direction, see below
+
{| class="wikitable"
−
*2001: Block break. '''Data''': [http://www.minecraftwiki.net/wiki/Data_values Block ID]
+
! Packet ID
−
*2002: Splash potion. Particle effect + glass break sound. '''Data''': [http://www.lb-stuff.com/Minecraft/PotionDataValues1.9pre3.txt Potion ID]
+
! State
−
*2003: Eye of ender entity break animation - particles and sound
+
! Bound To
−
*2004: Mob spawn particle effect: smoke + flames
+
! Field Name
−
*2005: Spawn "happy villager" effect (hearts).
+
! Field Type
 +
! Notes
 +
|-
 +
| rowspan="3"| ''protocol:''<br/><code>0x14</code><br/><br/>''resource:''<br/><code>container_set_data</code>
 +
| rowspan="3"| Play
 +
| rowspan="3"| Client
 +
| Window ID
 +
| {{change|{{Type|Unsigned Byte}}|{{Type|VarInt}}}}
 +
|
 +
|-
 +
| Property
 +
| {{Type|Short}}
 +
| The property to be updated, see below.
 +
|-
 +
| Value
 +
| {{Type|Short}}
 +
| The new value for the property, see below.
 +
|}
  
−
Smoke directions:
+
The meaning of the Property field depends on the type of the window. The following table shows the known combinations of window type and property, and how the value is to be interpreted.
  
 
{| class="wikitable"
 
{| class="wikitable"
−
! ID !! Direction
+
|-
−
|-
+
! Window type
−
| 0 || South - East
+
! Property
−
|-
+
! Value
−
| 1 || South
+
|-
−
|-
+
| rowspan="4"| Furnace
−
| 2 || South - West
+
| 0: Fire icon (fuel left)
−
|-
+
| counting from fuel burn time down to 0 (in-game ticks)
−
| 3 || East
+
|-
−
|-
+
| 1: Maximum fuel burn time
−
| 4 || (Up or middle ?)
+
| fuel burn time or 0 (in-game ticks)
−
|-
+
|-
−
| 5 || West
+
| 2: Progress arrow
−
|-
+
| counting from 0 to maximum progress (in-game ticks)
−
| 6 || North - East
+
|-
−
|-
+
| 3: Maximum progress
−
| 7 || North
+
| always 200 on the notchian server
−
|-
+
|-
−
| 8 || North - West
+
| rowspan="10"| Enchantment Table
−
|}
+
| 0: Level requirement for top enchantment slot
 +
| rowspan="3"| The enchantment's xp level requirement
 +
|-
 +
| 1: Level requirement for middle enchantment slot
 +
|-
 +
| 2: Level requirement for bottom enchantment slot
 +
|-
 +
| 3: The enchantment seed
 +
| Used for drawing the enchantment names (in [[Wikipedia:Standard Galactic Alphabet|SGA]]) clientside.  The same seed ''is'' used to calculate enchantments, but some of the data isn't sent to the client to prevent easily guessing the entire list (the seed value here is the regular seed bitwise and <code>0xFFFFFFF0</code>).
 +
|-
 +
| 4: Enchantment ID shown on mouse hover over top enchantment slot
 +
| rowspan="3"| The enchantment id (set to -1 to hide it), see below for values
 +
|-
 +
| 5: Enchantment ID shown on mouse hover over middle enchantment slot
 +
|-
 +
| 6: Enchantment ID shown on mouse hover over bottom enchantment slot
 +
|-
 +
| 7: Enchantment level shown on mouse hover over the top slot
 +
| rowspan="3"| The enchantment level (1 = I, 2 = II, 6 = VI, etc.), or -1 if no enchant
 +
|-
 +
| 8: Enchantment level shown on mouse hover over the middle slot
 +
|-
 +
| 9: Enchantment level shown on mouse hover over the bottom slot
 +
|-
 +
| rowspan="3"| Beacon
 +
| 0: Power level
 +
| 0-4, controls what effect buttons are enabled
 +
|-
 +
| 1: First potion effect
 +
| {{Minecraft Wiki|Data values#Status effects|Potion effect ID}} for the first effect, or -1 if no effect
 +
|-
 +
| 2: Second potion effect
 +
| {{Minecraft Wiki|Data values#Status effects|Potion effect ID}} for the second effect, or -1 if no effect
 +
|-
 +
| Anvil
 +
| 0: Repair cost
 +
| The repair's cost in xp levels
 +
|-
 +
| rowspan="2"| Brewing Stand
 +
| 0: Brew time
 +
| 0 – 400, with 400 making the arrow empty, and 0 making the arrow full
 +
|-
 +
| 1: Fuel time
 +
| 0 - 20, with 0 making the arrow empty, and 20 making the arrow full
 +
|-
 +
| Stonecutter
 +
| 0: Selected recipe
 +
| The index of the selected recipe. -1 means none is selected.
 +
|-
 +
| Loom
 +
| 0: Selected pattern
 +
| The index of the selected pattern. 0 means none is selected, 0 is also the internal id of the "base" pattern.
 +
|-
 +
| Lectern
 +
| 0: Page number
 +
| The current page number, starting from 0.
 +
|}
  
−
==== Sound Effect ====
+
For an enchanting table, the following numerical IDs are used:
  
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Numerical ID
−
|-
+
! Enchantment ID
−
| rowspan="7" | 0x29
+
! Enchantment Name
−
| Sound name || String ||  
+
|-
−
|-
+
| 0
−
| Effect position X || Int || Effect X multiplied by 8
+
| minecraft:protection
−
|-
+
| Protection
−
| Effect position Y || Int || Effect Y multiplied by 8
+
|-
−
|-
+
| 1
−
| Effect position Z || Int || Effect Z multiplied by 8
+
| minecraft:fire_protection
−
|-
+
| Fire Protection
−
| Volume || Float || 1 is 100%, can be more
+
|-
−
|-
+
| 2
−
| Pitch || Byte || 63 is 100%, can be more
+
| minecraft:feather_falling
−
|-
+
| Feather Falling
−
| Sound Category || Unsigned Byte || Possible values:
+
|-
−
MASTER: 0
+
| 3
 +
| minecraft:blast_protection
 +
| Blast Protection
 +
|-
 +
| 4
 +
| minecraft:projectile_protection
 +
| Projectile Protection
 +
|-
 +
| 5
 +
| minecraft:respiration
 +
| Respiration
 +
|-
 +
| 6
 +
| minecraft:aqua_affinity
 +
| Aqua Affinity
 +
|-
 +
| 7
 +
| minecraft:thorns
 +
| Thorns
 +
|-
 +
| 8
 +
| minecraft:depth_strider
 +
| Depth Strider
 +
|-
 +
| 9
 +
| minecraft:frost_walker
 +
| Frost Walker
 +
|-
 +
| 10
 +
| minecraft:binding_curse
 +
| Curse of Binding
 +
|-
 +
| 11
 +
| minecraft:soul_speed
 +
| Soul Speed
 +
|-
 +
| 12
 +
| minecraft:swift_sneak
 +
| Swift Sneak
 +
|-
 +
| 13
 +
| minecraft:sharpness
 +
| Sharpness
 +
|-
 +
| 14
 +
| minecraft:smite
 +
| Smite
 +
|-
 +
| 15
 +
| minecraft:bane_of_arthropods
 +
| Bane of Arthropods
 +
|-
 +
| 16
 +
| minecraft:knockback
 +
| Knockback
 +
|-
 +
| 17
 +
| minecraft:fire_aspect
 +
| Fire Aspect
 +
|-
 +
| 18
 +
| minecraft:looting
 +
| Looting
 +
|-
 +
| 19
 +
| minecraft:sweeping_edge
 +
| Sweeping Edge
 +
|-
 +
| 20
 +
| minecraft:efficiency
 +
| Efficiency
 +
|-
 +
| 21
 +
| minecraft:silk_touch
 +
| Silk Touch
 +
|-
 +
| 22
 +
| minecraft:unbreaking
 +
| Unbreaking
 +
|-
 +
| 23
 +
| minecraft:fortune
 +
| Fortune
 +
|-
 +
| 24
 +
| minecraft:power
 +
| Power
 +
|-
 +
| 25
 +
| minecraft:punch
 +
| Punch
 +
|-
 +
| 26
 +
| minecraft:flame
 +
| Flame
 +
|-
 +
| 27
 +
| minecraft:infinity
 +
| Infinity
 +
|-
 +
| 28
 +
| minecraft:luck_of_the_sea
 +
| Luck of the Sea
 +
|-
 +
| 29
 +
| minecraft:lure
 +
| Lure
 +
|-
 +
| 30
 +
| minecraft:loyalty
 +
| Loyalty
 +
|-
 +
| 31
 +
| minecraft:impaling
 +
| Impaling
 +
|-
 +
| 32
 +
| minecraft:riptide
 +
| Riptide
 +
|-
 +
| 33
 +
| minecraft:channeling
 +
| Channeling
 +
|-
 +
| 34
 +
| minecraft:multishot
 +
| Multishot
 +
|-
 +
| 35
 +
| minecraft:quick_charge
 +
| Quick Charge
 +
|-
 +
| 36
 +
| minecraft:piercing
 +
| Piercing
 +
|-
 +
| 37
 +
| minecraft:density
 +
| Density
 +
|-
 +
| 38
 +
| minecraft:breach
 +
| Breach
 +
|-
 +
| 39
 +
| minecraft:wind_burst
 +
| Wind Burst
 +
|-
 +
| 40
 +
| minecraft:mending
 +
| Mending
 +
|-
 +
| 41
 +
| minecraft:vanishing_curse
 +
| Curse of Vanishing
 +
|}
 +
 
 +
==== Set Container Slot ====
 +
 
 +
Sent by the server when an item in a slot (in a window) is added/removed.
  
−
MUSIC: 1
+
{| class="wikitable"
 +
! Packet ID
 +
! State
 +
! Bound To
 +
! Field Name
 +
! Field Type
 +
! Notes
 +
|-
 +
| rowspan="4"| ''protocol:''<br/><code>0x15</code><br/><br/>''resource:''<br/><code>container_set_slot</code>
 +
| rowspan="4"| Play
 +
| rowspan="4"| Client
 +
| Window ID
 +
| {{change|{{Type|Unsigned Byte}}|{{Type|VarInt}}}}
 +
| The window which is being updated. 0 for player inventory. The client ignores any packets targeting a Window ID other than the current one{{change|; see below for exceptions|, unless it is 0 (see below)}}.
 +
|-
 +
| State ID
 +
| {{Type|VarInt}}
 +
| A server-managed sequence number used to avoid desynchronization; see [[#Click Container]].
 +
|-
 +
| Slot
 +
| {{Type|Short}}
 +
| The slot that should be updated.
 +
|-
 +
| Slot Data
 +
| {{Type|Slot}}
 +
|
 +
|}
  
−
RECORDS: 2
+
If Window ID is 0, the hotbar and offhand slots (slots 36 through 45) may be updated even when a different container window is open. (The Notchian server does not appear to utilize this special case.) Updates are also restricted to those slots when the player is looking at a creative inventory tab other than the survival inventory. (The Notchian server does ''not'' handle this restriction in any way, leading to [https://bugs.mojang.com/browse/MC-242392 MC-242392].)
  
−
WEATHER: 3
+
{{change|If Window ID is -1, the item being dragged with the mouse is set. In this case, State ID and Slot are ignored.|}}
  
−
BLOCKS: 4
+
{{change|If Window ID is -2, any slot in the player's inventory can be updated irrespective of the current container window. In this case, State ID is ignored, and the Notchian server uses a bogus value of 0. Used by the Notchian server to implement the [[#Pick Item]] functionality.|}}
  
−
MOBS: 5
+
When a container window is open, the server never sends updates targeting Window ID 0&mdash;all of the [[Inventory|window types]] include slots for the player inventory. The client must automatically apply changes targeting the inventory portion of a container window to the main inventory; the server does not resend them for ID 0 when the window is closed. However, since the armor and offhand slots are only present on ID 0, updates to those slots occurring while a window is open must be deferred by the server until the window's closure.
  
−
ANIMALS: 6
+
==== Set Cooldown ====
  
−
PLAYERS: 7
+
Applies a cooldown period to all items with the given type.  Used by the Notchian server with enderpearls.  This packet should be sent when the cooldown starts and also when the cooldown ends (to compensate for lag), although the client will end the cooldown automatically. Can be applied to any item, note that interactions still get sent to the server with the item but the client does not play the animation nor attempt to predict results (i.e block placing).
−
|}
 
  
−
==== Particle ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Packet ID
−
|-
+
! State
−
| rowspan="9" | 0x2A
+
! Bound To
−
| Particle name || String || The name of the particle to create. A list can be found [https://gist.github.com/thinkofdeath/5110835 here]
+
! Field Name
−
|-
+
! Field Type
−
| X || Float || X position of the particle
+
! Notes
−
|-
+
|-  
−
| Y || Float || Y position of the particle
+
| rowspan="2"| ''protocol:''<br/><code>0x17</code><br/><br/>''resource:''<br/><code>cooldown</code>
−
|-
+
| rowspan="2"| Play
−
| Z || Float || Z position of the particle
+
| rowspan="2"| Client
−
|-
+
| {{change|Item ID|Cooldown Group}}
−
| Offset X || Float || This is added to the X position after being multiplied by random.nextGaussian()
+
| {{change|{{Type|VarInt}}|{{Type|Identifier}}}}
−
|-
+
| {{change|Numeric ID of the item|Group of items}} to apply a cooldown to.
−
| Offset Y || Float || This is added to the Y position after being multiplied by random.nextGaussian()
+
|-
−
|-
+
| Cooldown Ticks
−
| Offset Z || Float || This is added to the Z position after being multiplied by random.nextGaussian()
+
| {{Type|VarInt}}
−
|-
+
| Number of ticks to apply a cooldown for, or 0 to clear the cooldown.
−
| Particle speed || Float || The speed of each particle
+
|}
−
|-
+
 
−
| Number of particles || Int || The number of particles to create
+
==== Teleport Entity ====
−
|}
+
 
 +
{{Warning2|{{change||The Mojang-specified name of this packet was changed in 1.21.2 from <code>teleport_entity</code> to <code>entity_position_sync</code>. There is a new <code>teleport_entity</code>, which this document more appropriately calls [[#Synchronize Vehicle Position|Synchronize Vehicle Position]]. That packet has a different function and will lead to confusing results if used in place of this one.}}}}
 +
 
 +
This packet is sent by the server when an entity moves more than 8 blocks.
  
−
==== Change Game State ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Packet ID
−
|-
+
! State
−
| rowspan="2" | 0x2B
+
! Bound To
−
| Reason || Byte ||
+
! Field Name
−
|-
+
! Field Type
−
| Value || Float || Depends on reason
+
! Notes
 +
|-
 +
| rowspan="10"| ''protocol:''<br/><code>{{change|0x70|0x20}}</code><br/><br/>''resource:''<br/><code>{{change|teleport_entity|entity_position_sync}}</code>
 +
| rowspan="10"| Play
 +
| rowspan="10"| Client
 +
| Entity ID
 +
| {{Type|VarInt}}
 +
|
 +
|-
 +
| X
 +
| {{Type|Double}}
 +
|
 +
|-
 +
| Y
 +
| {{Type|Double}}
 +
|
 +
|-
 +
| Z
 +
| {{Type|Double}}
 +
|
 +
|- {{added}}
 +
| Velocity X
 +
| {{Type|Double}}
 +
|
 +
|- {{added}}
 +
| Velocity Y
 +
| {{Type|Double}}
 +
|
 +
|- {{added}}
 +
| Velocity Z
 +
| {{Type|Double}}
 +
|
 +
|-
 +
| Yaw
 +
| {{change|{{Type|Angle}}|{{Type|Float}}}}
 +
| Rotation on the X axis, in degrees.
 +
|-
 +
| Pitch
 +
| {{change|{{Type|Angle}}|{{Type|Float}}}}
 +
| Rotation on the Y axis, in degrees.
 +
|-
 +
| On Ground
 +
| {{Type|Boolean}}
 +
|
 
|}
 
|}
  
−
'''Reason codes'''
+
==== Explosion ====
 +
 
 +
Sent when an explosion occurs (creepers, TNT, and ghast fireballs).
 +
 
 +
{{change|Each block in Records is set to air. Coordinates for each axis in record is int(X) + record.x|}}
  
 
{| class="wikitable"
 
{| class="wikitable"
−
! Code !! Effect !! Notes
+
! Packet ID
−
|-
+
! State
−
| 0 || Invalid Bed || "tile.bed.notValid"
+
! Bound To
−
|-
+
! colspan="2" | Field Name
−
| 1 || Begin raining ||  
+
! Field Type
−
|-
+
! Notes
−
| 2 || End raining ||  
+
|-
−
|-
+
| rowspan="16"| ''protocol:''<br/><code>{{change|0x20|0x21}}</code><br/><br/>''resource:''<br/><code>explode</code>
−
| 3 || Change game mode || "gameMode.changed" 0 - Survival, 1 - Creative, 2 - Adventure
+
| rowspan="16"| Play
−
|-
+
| rowspan="16"| Client
−
| 4 || Enter credits ||
+
| X
−
|-
+
| {{Type|Double}}
−
| 5 || Demo messages || 0 - Show welcome to demo screen, 101 - Tell movement controls, 102 - Tell jump control, 103 - Tell inventory control
+
|
−
|-  
+
|-
−
| 6 | Bow hit sound ||
+
| Y
−
|-
+
| {{Type|Double}}
−
| 7 || Fade value || The current darkness value. 1 = Dark, 0 = Bright, Setting the value higher causes the game to change color and freeze
+
|
−
|-
+
|-
−
| 8 || Fade time || Time in ticks for the sky to fade
+
| Z
−
|}
+
| {{Type|Double}}
 +
|
 +
|- {{removed}}
 +
| Strength
 +
| {{Type|Float}}
 +
| If the strength is greater or equal to 2.0, or the block interaction is not 0 (keep), large explosion particles are used. Otherwise, small explosion particles are used.
 +
|- {{removed}}
 +
| Record Count
 +
| {{Type|VarInt}}
 +
| Number of elements in the following array.
 +
|- {{removed}}
 +
| Records
 +
| {{Type|Array}} of ({{Type|Byte}}, {{Type|Byte}}, {{Type|Byte}})
 +
| Each record is 3 signed bytes long; the 3 bytes are the XYZ (respectively) signed offsets of affected blocks.
 +
|- {{added}}
 +
| Has Player Motion
 +
| {{Type|Boolean}}
 +
|
 +
|-
 +
| Player Motion X
 +
| {{change|{{Type|Float}}|{{Type|Optional}} {{Type|Double}}}}
 +
| X velocity of the player being pushed by the explosion.{{change|| Only present if Has Player Motion is true.}}
 +
|-
 +
| Player Motion Y
 +
| {{change|{{Type|Float}}|{{Type|Optional}} {{Type|Double}}}}
 +
| Y velocity of the player being pushed by the explosion.{{change|| Only present if Has Player Motion is true.}}
 +
|-
 +
| Player Motion Z
 +
| {{change|{{Type|Float}}|{{Type|Optional}} {{Type|Double}}}}
 +
| Z velocity of the player being pushed by the explosion.{{change|| Only present if Has Player Motion is true.}}
 +
|- {{removed}}
 +
| Block Interaction
 +
| {{Type|VarInt}} {{Type|Enum}}
 +
| 0 = keep, 1 = destroy, 2 = destroy_with_decay, 3 = trigger_block.
 +
|-
 +
| {{change|Small |}}Explosion Particle ID
 +
| {{Type|VarInt}}
 +
| The particle ID listed in [[Particles]].
 +
|-
 +
| {{change|Small |}}Explosion Particle Data
 +
| Varies
 +
| Particle data as specified in [[Particles]].
 +
|- {{removed}}
 +
| Large Explosion Particle ID
 +
| {{Type|VarInt}}
 +
| The particle ID listed in [[Particles]].
 +
|- {{removed}}
 +
| Large Explosion Particle Data
 +
| Varies
 +
| Particle data as specified in [[Particles]].
 +
|-
 +
| Explosion Sound
 +
| {{Type|ID or}} {{Type|Sound Event}}
 +
| ID in the <code>minecraft:sound_event</code> registry, or an inline definition.
 +
|}
 +
 
 +
==== Open Horse Screen ====
 +
 
 +
This packet is used exclusively for opening the horse GUI. [[#Open Screen|Open Screen]] is used for all other GUIs.  The client will not open the inventory if the Entity ID does not point to an horse-like animal.
  
−
==== Spawn Global Entity ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Packet ID
−
|-
+
! State
−
| rowspan="5" | 0x2C
+
! Bound To
−
| Entity ID || Int || The entity ID of the thunderbolt
+
! Field Name
−
|-
+
! Field Type
−
| Type || Byte || The global entity type, currently always 1 for thunderbolt.
+
! Notes
−
|-
+
|-
−
| X || Int || Thunderbolt X a [[Data_Types#Fixed-point_numbers|fixed-point number]]
+
| rowspan="3"| ''protocol:''<br/><code>0x23</code><br/><br/>''resource:''<br/><code>horse_screen_open</code>
−
|-
+
| rowspan="3"| Play
−
| Y || Int || Thunderbolt Y a [[Data_Types#Fixed-point_numbers|fixed-point number]]
+
| rowspan="3"| Client
−
|-
+
| Window ID
−
| Z || Int || Thunderbolt Z a [[Data_Types#Fixed-point_numbers|fixed-point number]]
+
| {{change|{{Type|Unsigned Byte}}|{{Type|VarInt}}}}
−
|}
+
|
 +
|-
 +
| Slot count
 +
| {{Type|VarInt}}
 +
|
 +
|-
 +
| Entity ID
 +
| {{Type|Int}}
 +
|
 +
|}
 +
 
 +
==== Login (play) ====
 +
 
 +
{{Need Info|Although the number of portal cooldown ticks is included in this packet, the whole portal usage process is still dictated entirely by the server. What kind of effect does this value have on the client, if any?}}
 +
 
 +
See [[Protocol Encryption]] for information on logging in.
  
−
==== Open Window ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Packet ID
−
|-
+
! State
−
| rowspan="6" | 0x2D
+
! Bound To
−
| Window id || Byte || A unique id number for the window to be displayed.  Notchian server implementation is a counter, starting at 1.
+
! Field Name
−
|-
+
! Field Type
−
| Inventory Type || Byte || The window type to use for display.  Check below
+
! Notes
−
|-
+
|-
−
| Window title || String || The title of the window.
+
| rowspan="23"| ''protocol:''<br/><code>{{change|0x2B|0x2C}}</code><br/><br/>''resource:''<br/><code>login</code>
−
|-
+
| rowspan="23"| Play
−
| Number of Slots || Byte || Number of slots in the window (excluding the number of slots in the player inventory).
+
| rowspan="23"| Client
−
|-
+
| Entity ID
−
| Use provided window title || Bool || If false, the client will look up a string like "window.minecart". If true, the client uses what the server provides.
+
| {{Type|Int}}
−
|-
+
| The player's Entity ID (EID).
−
| Entity ID || Int || EntityHorse's entityId. Only sent when window type is equal to 11 (AnimalChest).
+
|-
−
|}
+
| Is hardcore
 +
| {{Type|Boolean}}
 +
|
 +
|-
 +
| Dimension Count
 +
| {{Type|VarInt}}
 +
| Size of the following array.
 +
|-
 +
| Dimension Names
 +
| {{Type|Array}} of {{Type|Identifier}}
 +
| Identifiers for all dimensions on the server.
 +
|-
 +
| Max Players
 +
| {{Type|VarInt}}
 +
| Was once used by the client to draw the player list, but now is ignored.
 +
|-
 +
| View Distance
 +
| {{Type|VarInt}}
 +
| Render distance (2-32).
 +
|-
 +
| Simulation Distance
 +
| {{Type|VarInt}}
 +
  | The distance that the client will process specific things, such as entities.
 +
|-
 +
| Reduced Debug Info
 +
| {{Type|Boolean}}
 +
| If true, a Notchian client shows reduced information on the {{Minecraft Wiki|debug screen}}.  For servers in development, this should almost always be false.
 +
|-
 +
| Enable respawn screen
 +
| {{Type|Boolean}}
 +
| Set to false when the doImmediateRespawn gamerule is true.
 +
|-
 +
| Do limited crafting
 +
  | {{Type|Boolean}}
 +
| Whether players can only craft recipes they have already unlocked. Currently unused by the client.
 +
|-
 +
| Dimension Type
 +
| {{Type|VarInt}}
 +
| The ID of the type of dimension in the <code>minecraft:dimension_type</code> registry, defined by the Registry Data packet.
 +
|-
 +
| Dimension Name
 +
| {{Type|Identifier}}
 +
| Name of the dimension being spawned into.
 +
|-
 +
| Hashed seed
 +
| {{Type|Long}}
 +
| First 8 bytes of the SHA-256 hash of the world's seed. Used client side for biome noise
 +
|-
 +
| Game mode
 +
| {{Type|Unsigned Byte}}
 +
| 0: Survival, 1: Creative, 2: Adventure, 3: Spectator.
 +
|-
 +
| Previous Game mode
 +
| {{Type|Byte}}
 +
| -1: Undefined (null), 0: Survival, 1: Creative, 2: Adventure, 3: Spectator. The previous game mode. Vanilla client uses this for the debug (F3 + N & F3 + F4) game mode switch. (More information needed)
 +
|-
 +
| Is Debug
 +
| {{Type|Boolean}}
 +
| True if the world is a {{Minecraft Wiki|debug mode}} world; debug mode worlds cannot be modified and have predefined blocks.
 +
|-
 +
| Is Flat
 +
| {{Type|Boolean}}
 +
| True if the world is a {{Minecraft Wiki|superflat}} world; flat worlds have different void fog and a horizon at y=0 instead of y=63.
 +
|-
 +
| Has death location
 +
| {{Type|Boolean}}
 +
| If true, then the next two fields are present.
 +
|-
 +
| Death dimension name
 +
| {{Type|Optional}} {{Type|Identifier}}
 +
| Name of the dimension the player died in.
 +
|-
 +
| Death location
 +
| {{Type|Optional}} {{Type|Position}}
 +
| The location that the player died at.
 +
|-
 +
| Portal cooldown
 +
| {{Type|VarInt}}
 +
| The number of ticks until the player can use the portal again.
 +
|- {{added}}
 +
| Sea level
 +
| {{Type|VarInt}}
 +
|
 +
|-
 +
| Enforces Secure Chat
 +
| {{Type|Boolean}}
 +
|
 +
|}
  
−
See [[Inventory#Windows|inventory windows]] for further information.
+
==== Move Minecart Along Track ====
  
−
==== Close Window ====
+
{| class="wikitable" {{added}}
−
{| class="wikitable"
+
! Packet ID
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! State
−
|-
+
! Bound To
−
| 0x2E
+
! colspan="2"| Field Name
−
| Window id || byte || This is the id of the window that was closed. 0 for inventory.
+
! colspan="2"| Field Type
 +
! colspan="2"| Notes
 +
|-
 +
| rowspan="11"| ''protocol:''<br/><code>0x31</code><br/><br/>''resource:''<br/><code>move_minecart_along_track</code>
 +
| rowspan="11"| Play
 +
| rowspan="11"| Client
 +
| colspan="2"| Entity ID
 +
| colspan="2"| {{Type|VarInt}}
 +
|
 +
|-
 +
| colspan="2"| Step Count
 +
| colspan="2"| {{Type|VarInt}}
 +
| Number of elements in the following array.
 +
|-
 +
| rowspan="9"| Steps
 +
| X
 +
| rowspan="9"| {{Type|Array}}
 +
| {{Type|Double}}
 +
|
 +
|-
 +
| Y
 +
| {{Type|Double}}
 +
|
 +
|-
 +
| Z
 +
| {{Type|Double}}
 +
|
 +
|-
 +
| Velocity X
 +
| {{Type|Double}}
 +
|
 +
|-
 +
| Velocity Y
 +
| {{Type|Double}}
 +
|
 +
|-
 +
| Velocity Z
 +
| {{Type|Double}}
 +
|
 +
|-
 +
| Yaw
 +
| {{Type|Angle}}
 +
|
 +
|-
 +
| Pitch
 +
| {{Type|Angle}}
 +
|
 +
|-
 +
| Weight
 +
| {{Type|Float}}
 
|}
 
|}
  
−
==== Set Slot ====
+
==== Player Info Update ====
 +
 
 +
Sent by the server to update the user list (<tab> in the client).
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Packet ID
−
|-
+
! State
−
| rowspan="3" | 0x2F
+
! Bound To
−
| Window ID || Byte
+
! colspan="2"| Field Name
−
| The window which is being updated. 0 for player inventory. Note that all known window types include the player inventory. This packet will only be sent for the currently opened window while the player is performing actions, even if it affects the player inventory. After the window is closed, a number of these packets are sent to update the player's inventory window (0).
+
! colspan="2"| Field Type
−
|-
+
! Notes
−
| Slot || Short || The slot that should be updated
+
|-
−
|-
+
| rowspan="4"| ''protocol:''<br/><code>{{change|0x3E|0x40}}</code><br/><br/>''resource:''<br/><code>player_info_update</code>
−
| Slot data || [[Slot_Data|Slot]] ||
+
| rowspan="4"| Play
−
|}
+
| rowspan="4"| Client
 +
| colspan="2"| Actions
 +
| colspan="2"| {{Type|Byte}}
 +
| Determines what actions are present.
 +
|-
 +
| colspan="2"| Number Of Players
 +
| colspan="2"| {{Type|VarInt}}
 +
| Number of elements in the following array.
 +
|-
 +
| rowspan="2" | Players
 +
| UUID
 +
| rowspan="2" | {{Type|Array}}
 +
| {{Type|UUID}}
 +
| The player UUID
 +
|-
 +
| Player Actions
 +
| {{Type|Array}} of [[#player-info:player-actions|Player&nbsp;Actions]]
 +
| The length of this array is determined by the number of [[#player-info:player-actions|Player Actions]] that give a non-zero value when applying its mask to the actions flag. For example given the decimal number 5, binary 00000101. The masks 0x01 and 0x04 would return a non-zero value, meaning the Player Actions array would include two actions: Add Player and Update Game Mode.
 +
|}
  
−
==== Window Items ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
|+ id="player-info:player-actions" | Player Actions
−
|-
+
! Action
−
| rowspan="3" | 0x30
+
! Mask
−
| Window ID || Byte || The id of window which items are being sent for. 0 for player inventory.
+
! colspan="2" | Field Name
−
|-
+
! colspan="2" | Type
−
| Count || Short || The number of slots (see below)
+
! Notes
−
|-
+
|-
−
| Slot data || Array of [[Slot_Data|Slot]]s ||
+
| rowspan="6" | Add Player
−
|}
+
| rowspan="6" | 0x01
 +
| colspan="2" | Name
 +
| colspan="2" | {{Type|String}} (16)
 +
|-
 +
| colspan="2" | Number Of Properties
 +
| colspan="2" | {{Type|VarInt}}
 +
| Number of elements in the following array.
 +
|-
 +
| rowspan="4" | Property
 +
| Name
 +
| rowspan="4"| {{Type|Array}}
 +
| {{Type|String}} (32767)
 +
|
 +
|-
 +
| Value
 +
| {{Type|String}} (32767)
 +
|
 +
|-
 +
| Is Signed
 +
| {{Type|Boolean}}
 +
|
 +
|-
 +
| Signature
 +
| {{Type|Optional}} {{Type|String}} (32767)
 +
| Only if Is Signed is true.
 +
|-
 +
| rowspan="7" | Initialize Chat
 +
| rowspan="7" | 0x02
 +
| colspan="2" | Has Signature Data
 +
| colspan="2" | {{Type|Boolean}}
 +
|-
 +
| colspan="2" | Chat session ID
 +
| colspan="2" | {{Type|UUID}}
 +
| Only sent if Has Signature Data is true.
 +
|-
 +
| colspan="2" | Public key expiry time
 +
| colspan="2" | {{Type|Long}}
 +
| Key expiry time, as a UNIX timestamp in milliseconds. Only sent if Has Signature Data is true.
 +
|-
 +
| colspan="2" | Encoded public key size
 +
| colspan="2" | {{Type|VarInt}}
 +
| Size of the following array. Only sent if Has Signature Data is true. Maximum length is 512 bytes.
 +
|-
 +
| colspan="2" | Encoded public key
 +
| colspan="2" | {{Type|Byte Array}} (512)
 +
| The player's public key, in bytes. Only sent if Has Signature Data is true.
 +
|-
 +
| colspan="2" | Public key signature size
 +
| colspan="2" | {{Type|VarInt}}
 +
| Size of the following array. Only sent if Has Signature Data is true. Maximum length is 4096 bytes.
 +
|-
 +
| colspan="2" | Public key signature
 +
| colspan="2" | {{Type|Byte Array}} (4096)
 +
| The public key's digital signature. Only sent if Has Signature Data is true.
 +
|-
 +
| Update Game Mode
 +
| 0x04
 +
| colspan="2" | Game Mode
 +
| colspan="2" | {{Type|VarInt}}
 +
|-
 +
| Update Listed
 +
| 0x08
 +
| colspan="2" | Listed
 +
| colspan="2" | {{Type|Boolean}}
 +
| Whether the player should be listed on the player list.
 +
|-
 +
| Update Latency
 +
| 0x10
 +
| colspan="2" | Ping
 +
| colspan="2" | {{Type|VarInt}}
 +
| Measured in milliseconds.
 +
|-
 +
| rowspan="2" | Update Display Name
 +
| rowspan="2" | 0x20
 +
| colspan="2" | Has Display Name
 +
| colspan="2" | {{Type|Boolean}}
 +
|-
 +
| colspan="2" | Display Name
 +
| colspan="2" | {{Type|Optional}} {{Type|Text Component}}
 +
| Only sent if Has Display Name is true.
 +
|- {{added}}
 +
| Update List Priority
 +
| 0x40
 +
| colspan="2" | Priority
 +
| colspan="2" | {{Type|VarInt}}
 +
| See below.
 +
|}
  
−
See [[Inventory#Windows|inventory windows]] for further information about how slots are indexed.
+
The properties included in this packet are the same as in [[#Login Success|Login Success]], for the current player.
  
−
==== Window Property ====
+
Ping values correspond with icons in the following way:
−
{| class="wikitable"
+
* A ping that negative (i.e. not known to the server yet) will result in the no connection icon.
−
! Packet ID !! Field Name !! Field Type !! Notes
+
* A ping under 150 milliseconds will result in 5 bars
−
|-
+
* A ping under 300 milliseconds will result in 4 bars
−
| rowspan="3" | 0x31
+
* A ping under 600 milliseconds will result in 3 bars
−
| Window ID || Byte || The id of the window.
+
* A ping under 1000 milliseconds (1 second) will result in 2 bars
−
|-
+
* A ping greater than or equal to 1 second will result in 1 bar.
−
| Property || Short || Which property should be updated.
 
−
|-
 
−
| Value || Short || The new value for the property.
 
−
|}
 
  
−
'''Furnace'''
+
The order of players in the player list is determined as follows:
 +
* {{change||Players with higher priorities are sorted before those with lower priorities.}}
 +
* {{change||Among players of equal priorities, }}spectators are sorted after non-spectators.
 +
* Within each of those groups, players are sorted into teams. The teams are ordered case-sensitively by team name in ascending order. Players with no team are listed first.
 +
* The players of each team (and non-team) are sorted case-insensitively by name in ascending order.
  
−
Properties:
+
==== Synchronize Player Position ====
  
−
* 0: Progress arrow
+
Teleports the client, e.g. during login, when using an ender pearl, in response to invalid move packets, etc.
−
* 1: Fire icon (fuel)
 
  
−
Values:
+
Due to latency, the server may receive outdated movement packets sent before the client was aware of the teleport. To account for this, the server ignores all movement packets from the client until a [[#Confirm Teleportation|Confirm Teleportation]] packet with an ID matching the one sent in the teleport packet is received.
  
−
* 0-200 for progress arrow
+
Yaw is measured in degrees, and does not follow classical trigonometry rules. The unit circle of yaw on the XZ-plane starts at (0, 1) and turns counterclockwise, with 90 at (-1, 0), 180 at (0, -1) and 270 at (1, 0). Additionally, yaw is not clamped to between 0 and 360 degrees; any number is valid, including negative numbers and numbers greater than 360 (see [https://bugs.mojang.com/browse/MC-90097 MC-90097]).
−
* 0-200 for fuel indicator
 
  
−
Ranges are presumably in in-game ticks
+
Pitch is measured in degrees, where 0 is looking straight ahead, -90 is looking straight up, and 90 is looking straight down.
  
−
'''Enchantment Table'''
+
{| class="wikitable"
 +
! Packet ID
 +
! State
 +
! Bound To
 +
! Field Name
 +
! Field Type
 +
! Notes
 +
|-
 +
| rowspan="11"| ''protocol:''<br/><code>{{change|0x40|0x42}}</code><br/><br/>''resource:''<br/><code>player_position</code>
 +
| rowspan="11"| Play
 +
| rowspan="11"| Client
 +
| {{added}} | Teleport ID
 +
| {{added}} | {{Type|VarInt}}
 +
| {{added}} | Client should confirm this packet with [[#Confirm Teleportation|Confirm Teleportation]] containing the same Teleport ID.
 +
|-
 +
| X
 +
| {{Type|Double}}
 +
| Absolute or relative position, depending on Flags.
 +
|-
 +
| Y
 +
| {{Type|Double}}
 +
| Absolute or relative position, depending on Flags.
 +
|-
 +
| Z
 +
| {{Type|Double}}
 +
| Absolute or relative position, depending on Flags.
 +
|- {{added}}
 +
| Velocity X
 +
| {{Type|Double}}
 +
|
 +
|- {{added}}
 +
| Velocity Y
 +
| {{Type|Double}}
 +
|
 +
|- {{added}}
 +
| Velocity Z
 +
| {{Type|Double}}
 +
|
 +
|-
 +
| Yaw
 +
| {{Type|Float}}
 +
| Absolute or relative rotation on the X axis, in degrees.
 +
|-
 +
| Pitch
 +
| {{Type|Float}}
 +
| Absolute or relative rotation on the Y axis, in degrees.
 +
|-
 +
| Flags
 +
| {{change|{{Type|Byte}}|{{Type|Teleport Flags}}}}
 +
| {{change|Reference the Flags table below. When the value of the this byte masked is zero the field is absolute, otherwise relative.|}}
 +
|- {{removed}}
 +
| Teleport ID
 +
| {{Type|VarInt}}
 +
| Client should confirm this packet with [[#Confirm Teleportation|Confirm Teleportation]] containing the same Teleport ID.
 +
|}
  
−
Properties: 0, 1 or 2 depending on the "enchantment slot" being given.
+
==== Player Rotation ====
  
−
Values: The enchantment's level.
+
{| class="wikitable" {{added}}
 +
! Packet ID
 +
! State
 +
! Bound To
 +
! Field Name
 +
! Field Type
 +
! Notes
 +
|-
 +
| rowspan="2"| ''protocol:''<br/><code>0x43</code><br/><br/>''resource:''<br/><code>player_rotation</code>
 +
| rowspan="2"| Play
 +
| rowspan="2"| Client
 +
| Yaw
 +
| {{Type|Float}}
 +
| Rotation on the X axis, in degrees.
 +
|-
 +
| Pitch
 +
| {{Type|Float}}
 +
| Rotation on the Y axis, in degrees.
 +
|}
  
−
==== Confirm Transaction  ====
+
==== Place Ghost Recipe ====
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan="3" | 0x32
 
−
| Window ID || Byte || The id of the window that the action occurred in.
 
−
|-
 
−
| Action number || Short || Every action that is to be accepted has a unique number. This field corresponds to that number.
 
−
|-
 
−
| Accepted || Bool || Whether the action was accepted.
 
−
|}
 
  
−
==== Update Sign ====
+
Response to the serverbound packet ([[#Place Recipe|Place Recipe]]), with the same recipe ID. Appears to be used to notify the UI.
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan="7" | 0x33
 
−
| X || Int || Block X Coordinate
 
−
|-
 
−
| Y || Short || Block Y Coordinate
 
−
|-
 
−
| Z || Int || Block Z Coordinate
 
−
|-
 
−
| Line 1 || String || First line of text in the sign
 
−
|-
 
−
| Line 2 || String || Second line of text in the sign
 
−
|-
 
−
| Line 3 || String || Third line of text in the sign
 
−
|-
 
−
| Line 4 || String || Fourth line of text in the sign
 
−
|}
 
  
−
==== Maps ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Packet ID
−
|-
+
! State
−
| rowspan="4" | 0x34
+
! Bound To
−
| Item Type || Short || Type of item being modified
+
! Field Name
−
|-
+
! Field Type
−
| Item ID || Short || The ID (damage value) of the item being modified
+
! Notes
−
|-
+
|-
−
| Text length || Short || Length of following byte array
+
| rowspan="3"| ''protocol:''<br/><code>{{change|0x37|0x39}}</code><br/><br/>''resource:''<br/><code>place_ghost_recipe</code>
−
|-
+
| rowspan="3"| Play
−
| Data || Byte Array || Array data
+
| rowspan="3"| Client
−
|}
+
| Window ID
 +
| {{change|{{Type|Byte}}|{{Type|VarInt}}}}
 +
|
 +
|- {{removed}}
 +
| Recipe
 +
| {{Type|Identifier}}
 +
| A recipe ID.
 +
|- {{added}}
 +
| Recipe Display
 +
| {{Type|Recipe Display}}
 +
|
 +
|}
  
−
If the first byte of the array is 0, the next two bytes are X start and Y start and the rest of the bytes are the colors in that column.
+
==== Recipe Book Add ====
  
−
If the first byte of the array is 1, the rest of the bytes are in groups of three: (data, x, y). The lower half of the data is the type (always 0 under vanilla) and the upper half is the direction.
+
{| class="wikitable" {{added}}
 +
! Packet ID
 +
! State
 +
! Bound To
 +
! colspan="2"| Field Name
 +
! colspan="2"| Field Type
 +
! colspan="2"| Notes
 +
|-
 +
| rowspan="10"| ''protocol:''<br/><code>0x44</code><br/><br/>''resource:''<br/><code>recipe_book_add</code>
 +
| rowspan="10"| Play
 +
| rowspan="10"| Client
 +
| colspan="2"| Recipe Count
 +
| colspan="2"| {{Type|VarInt}}
 +
| Number of elements in the following array.
 +
|-
 +
| rowspan="8"| Recipes
 +
| Recipe ID
 +
| rowspan="8"| {{Type|Array}}
 +
| {{Type|VarInt}}
 +
| ID to assign to the recipe.
 +
|-
 +
| Display
 +
| {{Type|Recipe Display}}
 +
|
 +
|-
 +
| Group ID
 +
| {{Type|VarInt}}
 +
|
 +
|-
 +
| Category ID
 +
| {{Type|VarInt}}
 +
| ID in the <code>minecraft:recipe_book_category</code> registry.
 +
|-
 +
| Has Ingredients
 +
| {{Type|Boolean}}
 +
|
 +
|-
 +
| Ingredient Count
 +
| {{Type|Optional}} {{Type|VarInt}}
 +
| Number of elements in the following array. Only present if Has Ingredients is true.
 +
|-
 +
| Ingredients
 +
| {{Type|Optional}} {{Type|Array}} of {{Type|ID Set}}
 +
| IDs in the <code>minecraft:item</code> registry, or an inline definition. Only present if Has Ingredients is true.
 +
|-
 +
| Flags
 +
| {{Type|Byte}}
 +
| 0x01: show notification; 0x02: highlight as new
 +
|-
 +
| colspan="2"| Replace
 +
| colspan="2"| {{Type|Boolean}}
 +
| Replace or Add to known recipes
 +
|}
  
−
If the first byte of the array is 2, the second byte is the map scale.
+
==== Recipe Book Remove ====
  
−
==== Update Block Entity ====
+
{| class="wikitable" {{added}}
−
{| class="wikitable"
+
! Packet ID
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! State
−
|-
+
! Bound To
−
| rowspan="6" | 0x35
+
! Field Name
−
| X || Int ||
+
! Field Type
−
|-
+
! Notes
−
| Y || Short ||
+
|-
−
|-
+
| rowspan="2"| ''protocol:''<br/><code>0x45</code><br/><br/>''resource:''<br/><code>recipe_book_remove</code>
−
| Z || Int ||
+
| rowspan="2"| Play
−
|-
+
| rowspan="2"| Client
−
| Action || Byte || The type of update to perform
+
| Recipe Count
−
|-
+
| {{Type|VarInt}}
−
| Data length || Short || Varies
+
| Number of elements in the following array.
−
|-
+
|-
−
| NBT Data || Byte Array || Present if data length > 0. Compressed with [[wikipedia:Gzip|gzip]]. Varies
+
| Recipes
−
|}
+
| {{Type|Array}} of {{Type|VarInt}}
 +
| IDs of recipes to remove.
 +
|}
  
−
'''Actions'''
+
==== Recipe Book Settings ====
  
−
* '''1''': Set mob displayed inside a mob spawner. Custom 1 contains the [[Entities#Mobs|mob type]]
+
{| class="wikitable" {{added}}
 +
! Packet ID
 +
! State
 +
! Bound To
 +
! Field Name
 +
! Field Type
 +
! Notes
 +
|-
 +
| rowspan="8"| ''protocol:''<br/><code>0x46</code><br/><br/>''resource:''<br/><code>recipe_book_settings</code>
 +
| rowspan="8"| Play
 +
| rowspan="8"| Client
 +
| Crafting Recipe Book Open
 +
| {{Type|Boolean}}
 +
| If true, then the crafting recipe book will be open when the player opens its inventory.
 +
|-
 +
| Crafting Recipe Book Filter Active
 +
| {{Type|Boolean}}
 +
| If true, then the filtering option is active when the players opens its inventory.
 +
|-
 +
| Smelting Recipe Book Open
 +
| {{Type|Boolean}}
 +
| If true, then the smelting recipe book will be open when the player opens its inventory.
 +
|-
 +
| Smelting Recipe Book Filter Active
 +
| {{Type|Boolean}}
 +
| If true, then the filtering option is active when the players opens its inventory.
 +
|-
 +
| Blast Furnace Recipe Book Open
 +
| {{Type|Boolean}}
 +
| If true, then the blast furnace recipe book will be open when the player opens its inventory.
 +
|-
 +
| Blast Furnace Recipe Book Filter Active
 +
| {{Type|Boolean}}
 +
| If true, then the filtering option is active when the players opens its inventory.
 +
|-
 +
| Smoker Recipe Book Open
 +
| {{Type|Boolean}}
 +
| If true, then the smoker recipe book will be open when the player opens its inventory.
 +
|-
 +
| Smoker Recipe Book Filter Active
 +
| {{Type|Boolean}}
 +
| If true, then the filtering option is active when the players opens its inventory.
 +
|}
  
−
==== Block Editor Open ====
+
==== Respawn ====
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan="4" | 0x36
 
−
| Tile Entity Id || Byte || Always seems to be 0 (TileEntitySign)
 
−
|-
 
−
| X || Int || X in block coordinates
 
−
|-
 
−
| Y || Int || Y in block coordinates
 
−
|-
 
−
| Z || Int || Z in block coordinates
 
−
|}
 
  
−
==== Statistics ====
+
{{Need Info|Although the number of portal cooldown ticks is included in this packet, the whole portal usage process is still dictated entirely by the server. What kind of effect does this value have on the client, if any?}}
−
{| class="wikitable"
 
−
! Packet ID
 
−
! colspan="2" | Field Name
 
−
! Field Type !! Notes
 
−
|-
 
−
| rowspan="3" | 0x37
 
−
| colspan="2" | Count || Int || Number of entrys
 
−
|-
 
−
| rowspan=2 | Entry
 
−
| Statistic's name || String ||
 
−
|-
 
−
| Amount || Int || The amount to increase by
 
−
|}
 
  
−
==== Player List Item ====
+
To change the player's dimension (overworld/nether/end), send them a respawn packet with the appropriate dimension, followed by prechunks/chunks for the new dimension, and finally a position and look packet. You do not need to unload chunks, the client will do it automatically.
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan="3" | 0x38
 
−
| Player name || String || Supports chat colouring, limited to 16 characters.
 
−
|-
 
−
| Online || byte || 1 for true, 0 for false. The client will remove the user from the list if false.
 
−
|-
 
−
| Ping || Short || Ping, presumably in ms.
 
−
|}
 
  
−
==== Player Abilities ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Packet ID
−
|-
+
! State
−
| rowspan="3" | 0x39
+
! Bound To
−
| Flags || Byte ||
+
! Field Name
−
|-
+
! Field Type
−
| Flying speed || Float|| previous integer value divided by 250
+
! Notes
−
|-
+
|-
−
| Walking speed || Float || previous integer value divided by 250
+
| rowspan="13"| ''protocol:''<br/><code>{{change|0x47|0x4C}}</code><br/><br/>''resource:''<br/><code>respawn</code>
−
|}
+
| rowspan="13"| Play
 +
| rowspan="13"| Client
 +
| Dimension Type
 +
| {{Type|VarInt}}
 +
| The ID of type of dimension in the <code>minecraft:dimension_type</code> registry, defined by the [[Protocol#Registry_Data|Registry Data]] packet.
 +
|-
 +
| Dimension Name
 +
| {{Type|Identifier}}
 +
| Name of the dimension being spawned into.
 +
|-
 +
| Hashed seed
 +
| {{Type|Long}}
 +
| First 8 bytes of the SHA-256 hash of the world's seed. Used client side for biome noise
 +
|-
 +
| Game mode
 +
| {{Type|Unsigned Byte}}
 +
| 0: Survival, 1: Creative, 2: Adventure, 3: Spectator.
 +
|-
 +
| Previous Game mode
 +
| {{Type|Byte}}
 +
| -1: Undefined (null), 0: Survival, 1: Creative, 2: Adventure, 3: Spectator. The previous game mode. Vanilla client uses this for the debug (F3 + N & F3 + F4) game mode switch. (More information needed)
 +
|-
 +
| Is Debug
 +
| {{Type|Boolean}}
 +
| True if the world is a {{Minecraft Wiki|debug mode}} world; debug mode worlds cannot be modified and have predefined blocks.
 +
|-
 +
| Is Flat
 +
| {{Type|Boolean}}
 +
| True if the world is a {{Minecraft Wiki|superflat}} world; flat worlds have different void fog and a horizon at y=0 instead of y=63.
 +
|-
 +
| Has death location
 +
| {{Type|Boolean}}
 +
| If true, then the next two fields are present.
 +
|-
 +
| Death dimension Name
 +
| {{Type|Optional}} {{Type|Identifier}}
 +
| Name of the dimension the player died in.
 +
|-
 +
| Death location
 +
| {{Type|Optional}} {{Type|Position}}
 +
| The location that the player died at.
 +
|-
 +
| Portal cooldown
 +
| {{Type|VarInt}}
 +
| The number of ticks until the player can use the portal again.
 +
|- {{added}}
 +
| Sea level
 +
| {{Type|VarInt}}
 +
|
 +
|-
 +
| Data kept
 +
| {{Type|Byte}}
 +
| Bit mask. 0x01: Keep attributes, 0x02: Keep metadata. Tells which data should be kept on the client side once the player has respawned.
 +
In the Notchian implementation, this is context dependent:
 +
* normal respawns (after death) keep no data;
 +
* exiting the end poem/credits keeps the attributes;
 +
* other dimension changes (portals or teleports) keep all data.
 +
|}
  
−
==== Tab-Complete ====
+
{{Warning2|Avoid changing player's dimension to same dimension they were already in unless they are dead. If you change the dimension to one they are already in, weird bugs can occur, such as the player being unable to attack other players in new world (until they die and respawn).
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| 0x3A
 
−
| Text || String ||
 
−
|}
 
  
−
==== Scoreboard Objective ====
+
Before 1.16, if you must respawn a player in the same dimension without killing them, send two respawn packets, one to a different world and then another to the world you want. You do not need to complete the first respawn; it only matters that you send two packets.}}
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan="3" | 0x3B
 
−
| Objective name || String || An unique name for the objective
 
−
|-
 
−
| Objective value || String || The text to be displayed for the score.
 
−
|-
 
−
| Create/Remove || Byte || 0 to create the scoreboard. 1 to remove the scoreboard. 2 to update the display text.  
 
−
|}
 
  
−
==== Update Score ====
+
==== Set Cursor Item ====
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan="4" | 0x3C
 
−
| Item Name || String || An unique name to be displayed in the list.
 
−
|-
 
−
| Update/Remove || Byte || 0 to create/update an item. 1 to remove an item.
 
−
|-
 
−
| Score Name || String || The unique name for the scoreboard to be updated. Only sent when Update/Remove does not equal 1.
 
−
|-
 
−
| Value || Int || The score to be displayed next to the entry. Only sent when Update/Remove does not equal 1.
 
−
|}
 
  
−
==== Display Scoreboard ====
+
{| class="wikitable" {{added}}
−
{| class="wikitable"
+
! Packet ID
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! State
−
|-
+
! Bound To
−
| rowspan="2" | 0x3D
+
! Field Name
−
| Position || Byte || The position of the scoreboard. 0 = list, 1 = sidebar, 2 = belowName.
+
! Field Type
−
|-
+
! Notes
−
| Score Name || String || The unique name for the scoreboard to be displayed.
+
|-
−
|}
+
| 0x5A
 +
| Play
 +
| Client
 +
| Slot Data
 +
| {{Type|Slot}}
 +
|
 +
|}
  
−
==== Teams ====
+
==== Update Time ====
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan="8" | 0x3E
 
−
| Team Name || String || A unique name for the team. (Shared with scoreboard).
 
−
|-
 
−
| Mode || Byte || If 0 then the team is created.
 
−
If 1 then the team is removed.
 
  
−
If 2 the team team information is updated.  
+
Time is based on ticks, where 20 ticks happen every second. There are 24000 ticks in a day, making Minecraft days exactly 20 minutes long.
  
−
If 3 then new players are added to the team.  
+
The time of day is based on the timestamp modulo 24000. 0 is sunrise, 6000 is noon, 12000 is sunset, and 18000 is midnight.
  
−
If 4 then players are removed from the team.
+
The default SMP server increments the time by <code>20</code> every second.
−
|-
 
−
| Team Display Name || String || Only if Mode = 0 or 2.
 
−
|-
 
−
| Team Prefix || String || Only if Mode = 0 or 2. Displayed before the players' name that are part of this team.
 
−
|-
 
−
| Team Suffix || String || Only if Mode = 0 or 2. Displayed after the players' name that are part of this team.
 
−
|-
 
−
| Friendly fire || Byte || Only if Mode = 0 or 2; 0 for off, 1 for on, 3 for seeing friendly invisibles
 
−
|-
 
−
| Player count || Short || Only if Mode = 0 or 3 or 4. Number of players in the array
 
−
|-
 
−
| Players || Array of strings || Only if Mode = 0 or 3 or 4. Players to be added/remove from the team.
 
−
|}
 
  
−
==== Plugin Message ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Packet ID
−
|-
+
! State
−
| rowspan="3" | 0x3F
+
! Bound To
−
| Channel || String || Name of the "channel" used to send the data.
+
! Field Name
−
|-
+
! Field Type
−
| Length || Short || Length of the following byte array
+
! Notes
−
|-
+
|-
−
| Data || Byte Array || Any data.
+
| rowspan="3"| ''protocol:''<br/><code>{{change|0x64|0x6B}}</code><br/><br/>''resource:''<br/><code>set_time</code>
−
|}
+
| rowspan="3"| Play
 +
| rowspan="3"| Client
 +
| World Age
 +
| {{Type|Long}}
 +
| In ticks; not changed by server commands.
 +
|-
 +
| Time of day
 +
| {{Type|Long}}
 +
| The world (or region) time, in ticks. {{change|If negative the sun will stop moving at the Math.abs of the time.|}}
 +
|- {{added}}
 +
| Time of day increasing
 +
| {{Type|Boolean}}
 +
| If true, the client should automatically advance the time of day according to its ticking rate.
 +
|}
 +
 
 +
==== Set Player Inventory Slot ====
  
−
More documentation on this: http://dinnerbone.com/blog/2012/01/13/minecraft-plugin-channels-messaging/
+
{| class="wikitable" {{added}}
 +
! Packet ID
 +
! State
 +
! Bound To
 +
! Field Name
 +
! Field Type
 +
! Notes
 +
|-
 +
| rowspan="2"| ''protocol:''<br/><code>0x66</code><br/><br/>''resource:''<br/><code>set_player_inventory</code>
 +
| rowspan="2"| Play
 +
| rowspan="2"| Client
 +
| Slot
 +
| {{Type|VarInt}}
 +
|
 +
|-
 +
| Slot Data
 +
| {{Type|Slot}}
 +
|
 +
|}
  
−
==== Disconnect ====
+
==== Synchronize Vehicle Position ====
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| 0x40
 
−
| Reason || String || Displayed to the client when the connection terminates
 
−
|}
 
  
−
=== Serverbound ===
+
Teleports the entity on the client without changing the reference point of movement deltas in future [[#Update Entity Position|Update Entity Position]] packets. Seems to be used to make relative adjustments to vehicle positions; more information needed.
  
−
==== Keep Alive ====
+
{| class="wikitable" {{added}}
−
{| class="wikitable"
+
! Packet ID
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! State
−
|-
+
! Bound To
−
| rowspan=1 | 0x00
+
! Field Name
−
| Keep Alive ID || Int ||
+
! Field Type
−
|}
+
! Notes
 +
|-
 +
| rowspan="11"| ''protocol:''<br/><code>0x77</code><br/><br/>''resource:''<br/><code>teleport_entity</code>
 +
| rowspan="11"| Play
 +
| rowspan="11"| Client
 +
| Entity ID
 +
| {{Type|VarInt}}
 +
|
 +
|-
 +
| X
 +
| {{Type|Double}}
 +
|
 +
|-
 +
| Y
 +
| {{Type|Double}}
 +
|
 +
|-
 +
| Z
 +
| {{Type|Double}}
 +
|
 +
|-
 +
| Velocity X
 +
| {{Type|Double}}
 +
|
 +
|-
 +
| Velocity Y
 +
| {{Type|Double}}
 +
|
 +
|-
 +
| Velocity Z
 +
| {{Type|Double}}
 +
|
 +
|-
 +
| Yaw
 +
| {{Type|Float}}
 +
| Rotation on the Y axis, in degrees.
 +
|-
 +
| Pitch
 +
| {{Type|Float}}
 +
| Rotation on the Y axis, in degrees.
 +
|- {{added}}
 +
| Flags
 +
| {{Type|Teleport Flags}}
 +
|
 +
|-
 +
| On Ground
 +
| {{Type|Boolean}}
 +
|
 +
|}
  
−
==== Chat Message ====  
+
==== Update Recipes ====
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=1 | 0x01
 
−
| JSON Data || String || https://gist.github.com/thinkofdeath/e882ce057ed83bac0a1c
 
−
|}
 
  
−
==== ? ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Packet ID
−
|-
+
! State
−
| rowspan=2 | 0x02
+
! Bound To
−
| || Int ||
+
! colspan="2"| Field Name
−
|-
+
! colspan="2"| Field Type
−
| || Byte ||
+
! Notes
−
|}
+
|-
 +
| rowspan="11"| ''protocol:''<br/><code>{{change|0x77|0x7e}}</code><br/><br/>''resource:''<br/><code>update_recipes</code>
 +
| rowspan="11"| Play
 +
| rowspan="11"| Client
 +
| {{removed}} colspan="2"| Num Recipes
 +
| {{removed}} colspan="2"| {{Type|VarInt}}
 +
| {{removed}}| Number of elements in the following array.
 +
|- {{removed}}
 +
| rowspan="3"| Recipe
 +
| Recipe ID
 +
| rowspan="3"| {{Type|Array}}
 +
| {{Type|Identifier}}
 +
|
 +
|- {{removed}}
 +
| Type ID
 +
| {{Type|VarInt}} {{Type|Enum}}
 +
| The recipe type, see below.
 +
|- {{removed}}
 +
| Data
 +
| Varies
 +
| Additional data for the recipe.
 +
|- {{added}}
 +
| colspan="2"| Property Set Count
 +
| colspan="2"| {{Type|VarInt}}
 +
| Number of elements in the following array.
 +
|- {{added}}
 +
| rowspan="3"| Property Sets
 +
| Property Set ID
 +
| rowspan="3"| {{Type|Array}}
 +
| {{Type|Identifier}}
 +
|
 +
|- {{added}}
 +
| Item Count
 +
| {{Type|VarInt}}
 +
| Number of elements in the following array.
 +
|- {{added}}
 +
| Items
 +
| {{Type|Array}} of {{Type|VarInt}}
 +
| IDs in the <code>minecraft:item</code> registry.
 +
|- {{added}}
 +
| colspan="2"| Stonecutter Recipe Count
 +
| colspan="2"| {{Type|VarInt}}
 +
| colspan="2"| Number of elements in the following array.
 +
|- {{added}}
 +
| rowspan="2"| Stonecutter Recipes
 +
| Ingredients
 +
| rowspan="2"| {{Type|Array}}
 +
| {{Type|ID Set}}
 +
|
 +
|- {{added}}
 +
| Slot Display
 +
| {{Type|Slot Display}}
 +
|
 +
|}
  
−
==== Player ====
+
{{change|Recipe types:|}}
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=1 | 0x03
 
−
| On Ground || Bool | True if the client is on the ground, False otherwise
 
−
|}
 
  
−
==== Player Position ====  
+
{| class="wikitable" {{removed}}
−
{| class="wikitable"
+
! ID
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Type
−
|-
+
! Description
−
| rowspan=5| 0x04
+
! Data
−
| X || Double || Absolute position
+
|-
−
|-
+
| 0
−
| Y || Double || Absolute position
+
| <code>minecraft:crafting_shaped</code>
−
|-
+
| Shaped crafting recipe. All items must be present in the same pattern (which may be flipped horizontally or translated).
−
| Stance || Double || Used to modify the players bounding box when going up stairs, crouching, etc…
+
| As follows:
−
|-
+
  {| class="wikitable" {{removed}}
−
| Z || Double || Absolute position
+
    ! Name
−
|-
+
    ! Type
−
| On Ground || Bool || True if the client is on the ground, False otherwise
+
    ! Description
−
|}
+
    |-
 +
    | Group
 +
    | {{Type|String}} (32767)
 +
    | Used to group similar recipes together in the recipe book. Tag is present in recipe JSON.
 +
    |-
 +
    |Category
 +
    |{{Type|VarInt}} {{Type|Enum}}
 +
    |Building = 0, Redstone = 1, Equipment = 2, Misc = 3
 +
    |-
 +
    | Width
 +
    | {{Type|VarInt}}
 +
    |
 +
    |-
 +
    | Height
 +
    | {{Type|VarInt}}
 +
    |
 +
    |-
 +
    | Ingredients
 +
    | {{Type|Array}} of Ingredient
 +
    | Length is <code>width * height</code>. Indexed by <code>x + (y * width)</code>.
 +
    |-
 +
    | Result
 +
    | {{Type|Slot}}
 +
    |-
 +
    | Show notification
 +
    | {{Type|Boolean}}
 +
    | Show a toast when the recipe is [[Protocol#Update_Recipe_Book|added]].
 +
    |}
 +
|-
 +
| 1
 +
| <code>minecraft:crafting_shapeless</code>
 +
| Shapeless crafting recipe. All items in the ingredient list must be present, but in any order/slot.
 +
| As follows:
 +
  {| class="wikitable" {{removed}}
 +
    ! Name
 +
    ! Type
 +
    ! Description
 +
    |-
 +
    | Group
 +
    | {{Type|String}} (32767)
 +
    | Used to group similar recipes together in the recipe book. Tag is present in recipe JSON.
 +
    |-
 +
    |Category
 +
    |{{Type|VarInt}} {{Type|Enum}}
 +
    |Building = 0, Redstone = 1, Equipment = 2, Misc = 3
 +
    |-
 +
    | Ingredient count
 +
    | {{Type|VarInt}}
 +
    | Number of elements in the following array.
 +
    |-
 +
    | Ingredients
 +
    | {{Type|Array}} of Ingredient.
 +
    |
 +
    |-
 +
    | Result
 +
    | {{Type|Slot}}
 +
    |
 +
    |}
 +
|-
 +
| 2
 +
| <code>minecraft:crafting_special_armordye</code>
 +
| Recipe for dying leather armor
 +
| rowspan="14" | As follows:
 +
  {| class="wikitable" {{removed}}
 +
    ! Name
 +
    ! Type
 +
    ! Description
 +
    |-
 +
    |Category
 +
    |{{Type|VarInt}} {{Type|Enum}}
 +
    |Building = 0, Redstone = 1, Equipment = 2, Misc = 3
 +
    |}
 +
|-
 +
| 3
 +
| <code>minecraft:crafting_special_bookcloning</code>
 +
| Recipe for copying contents of written books
 +
|-
 +
| 4
 +
| <code>minecraft:crafting_special_mapcloning</code>
 +
| Recipe for copying maps
 +
|-
 +
| 5
 +
| <code>minecraft:crafting_special_mapextending</code>
 +
| Recipe for adding paper to maps
 +
|-
 +
| 6
 +
| <code>minecraft:crafting_special_firework_rocket</code>
 +
| Recipe for making firework rockets
 +
|-
 +
| 7
 +
| <code>minecraft:crafting_special_firework_star</code>
 +
| Recipe for making firework stars
 +
|-
 +
| 8
 +
| <code>minecraft:crafting_special_firework_star_fade</code>
 +
| Recipe for making firework stars fade between multiple colors
 +
|-
 +
| 9
 +
| <code>minecraft:crafting_special_tippedarrow</code>
 +
| Recipe for crafting tipped arrows
 +
|-
 +
| 10
 +
| <code>minecraft:crafting_special_bannerduplicate</code>
 +
| Recipe for copying banner patterns
 +
|-
 +
| 11
 +
| <code>minecraft:crafting_special_shielddecoration</code>
 +
| Recipe for applying a banner's pattern to a shield
 +
|-
 +
| 12
 +
| <code>minecraft:crafting_special_shulkerboxcoloring</code>
 +
| Recipe for recoloring a shulker box
 +
|-
 +
| 13
 +
| <code>minecraft:crafting_special_suspiciousstew</code>
 +
| Recipe for crafting suspicious stews
 +
|-
 +
| 14
 +
| <code>minecraft:crafting_special_repairitem</code>
 +
| Recipe for repairing items via crafting
 +
|-
 +
| 22
 +
| <code>minecraft:crafting_decorated_pot</code>
 +
| Recipe for crafting decorated pots
 +
|-
 +
| 15
 +
| <code>minecraft:smelting</code>
 +
| Smelting recipe
 +
| rowspan="4"| As follows:
 +
  {| class="wikitable" {{removed}}
 +
    ! Name
 +
    ! Type
 +
    ! Description
 +
    |-
 +
    | Group
 +
    | {{Type|String}} (32767)
 +
    | Used to group similar recipes together in the recipe book.
 +
    |-
 +
    |Category
 +
    |{{Type|VarInt}} {{Type|Enum}}
 +
    |Food = 0, Blocks = 1, Misc = 2
 +
    |-
 +
    | Ingredient
 +
    | Ingredient
 +
    |
 +
    |-
 +
    | Result
 +
    | {{Type|Slot}}
 +
    |
 +
    |-
 +
    | Experience
 +
    | {{Type|Float}}
 +
    |
 +
    |-
 +
    | Cooking time
 +
    | {{Type|VarInt}}
 +
    |
 +
    |}
 +
|-
 +
| 16
 +
| <code>minecraft:blasting</code>
 +
| Blast furnace recipe
 +
|-
 +
| 17
 +
| <code>minecraft:smoking</code>
 +
| Smoker recipe
 +
|-
 +
| 18
 +
| <code>minecraft:campfire_cooking</code>
 +
| Campfire recipe
 +
|-
 +
| 19
 +
| <code>minecraft:stonecutting</code>
 +
| Stonecutter recipe
 +
| As follows:
 +
  {| class="wikitable" {{removed}}
 +
    ! Name
 +
    ! Type
 +
    ! Description
 +
    |-
 +
    | Group
 +
    | {{Type|String}} (32767)
 +
    | Used to group similar recipes together in the recipe book.  Tag is present in recipe JSON.
 +
    |-
 +
    | Ingredient
 +
    | Ingredient
 +
    |
 +
    |-
 +
    | Result
 +
    | {{Type|Slot}}
 +
    |
 +
    |}
 +
|-
 +
| 20
 +
| <code>minecraft:smithing_transform</code>
 +
| Recipe for smithing netherite gear
 +
| As follows:
 +
  {| class="wikitable" {{removed}}
 +
    ! Name
 +
    ! Type
 +
    ! Description
 +
    |-
 +
    | Template
 +
    | Ingredient
 +
    | The smithing template.
 +
    |-
 +
    | Base
 +
    | Ingredient
 +
    | The base item.
 +
    |-
 +
    | Addition
 +
    | Ingredient
 +
    | The additional ingredient.
 +
    |-
 +
    | Result
 +
    | {{Type|Slot}}
 +
    |
 +
    |}
 +
|-
 +
| 21
 +
| <code>minecraft:smithing_trim</code>
 +
| Recipe for applying armor trims
 +
| As follows:
 +
  {| class="wikitable" {{removed}}
 +
    ! Name
 +
    ! Type
 +
    ! Description
 +
    |-
 +
    | Template
 +
    | Ingredient
 +
    | The smithing template.
 +
    |-
 +
    | Base
 +
    | Ingredient
 +
    | The base item.
 +
    |-
 +
    | Addition
 +
    | Ingredient
 +
    | The additional ingredient.
 +
    |}
 +
|}
  
−
==== Player Look ====
+
{{change|Ingredient is defined as:|}}
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=3| 0x05
 
−
| 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" {{removed}}
−
{| class="wikitable"
+
! Name
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Type
−
|-
+
! Description
−
| rowspan=7| 0x06
+
|-
−
| X || Double || Absolute position
+
| Count
−
|-
+
| {{Type|VarInt}}
−
| Y || Double || Absolute position
+
| Number of elements in the following array.
−
|-
+
|-
−
| Stance || Double || Used to modify the players bounding box when going up stairs, crouching, etc…
+
| Items
−
|-
+
| {{Type|Array}} of {{Type|Slot}}
−
| Z || Double || Absolute position
+
| Any item in this array may be used for the recipe.  The count of each item should be 1.
−
|-
+
|}
−
| 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 Digging ====
+
=== Serverbound ===
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan="5" | 0x07
 
−
| Status || Byte || The action the player is taking against the block (see below)
 
−
|-
 
−
| X || Int || Block position
 
−
|-
 
−
| Y || Byte || Block position
 
−
|-
 
−
| Z || Int || Block position
 
−
|-
 
−
| Face || Byte || The face being hit (see below)
 
−
|}
 
  
−
Status can (currently) be one of six values:
+
==== Bundle Item Selected ====
  
−
{| class="wikitable"
+
{| class="wikitable" {{added}}
−
! Meaning !! Value
+
! Packet ID
−
|-
+
! State
−
| Started digging || <code>0</code>
+
! Bound To
−
|-
+
! Field Name
−
| Cancelled digging || <code>1</code>
+
! Field Type
−
|-
+
! Notes
−
| Finished digging || <code>2</code>
+
|-
−
|-
+
| rowspan="2"| ''protocol:''<br/><code>0x02</code><br/><br/>''resource:''<br/><code>bundle_item_selected</code>
−
| Drop item stack || <code>3</code>
+
| rowspan="2"| Play
−
|-
+
| rowspan="2"| Server
−
| Drop item || <code>4</code>
+
| Slot of Bundle
−
|-
+
| {{Type|VarInt}}
−
| Shoot arrow / finish eating || <code>5</code>
+
|
−
|}
+
|-
 +
| Slot in Bundle
 +
| {{Type|VarInt}}
 +
|
 +
|}
  
−
Notchian clients send a 0 (started digging) when they start digging and a 2 (finished digging) once they think they are finished. If digging is aborted, the client simply send a 1 (Cancel digging).
+
==== Client Tick End ====
  
−
Status code 4 (drop item) is a special case. In-game, when you use the Drop Item command (keypress 'q'), a dig packet with a status of 4, and all other values set to 0, is sent from client to server. Status code 3 is similar, but drops the entire stack.
+
{| class="wikitable" {{added}}
 +
! Packet ID
 +
! State
 +
! Bound To
 +
! Field Name
 +
! Field Type
 +
! Notes
 +
  |-
 +
| ''protocol:''<br/><code>0x0B</code><br/><br/>''resource:''<br/><code>client_tick_end</code>
 +
| Play
 +
| Server
 +
| colspan="3"| ''no fields''
 +
|}
  
−
Status code 5 (shoot arrow / finish eating) is also a special case. The x, y and z fields are all set to 0 like above, with the exception of the face field, which is set to 255.
+
==== Click Container ====
  
−
The face can be one of six values, representing the face being hit:
+
This packet is sent by the client when the player clicks on a slot in a window.
  
 
{| class="wikitable"
 
{| class="wikitable"
−
|-
+
! Packet ID
−
| Value || 0 || 1 || 2 || 3 || 4 || 5
+
! State
−
|-
+
! Bound To
−
| Offset || -Y || +Y || -Z || +Z || -X || +X
+
! colspan="2"| Field Name
−
|}
+
! colspan="2"| Field Type
 +
! Notes
 +
|-
 +
| rowspan="9"| ''protocol:''<br/><code>{{change|0x0E|0x10}}</code><br/><br/>''resource:''<br/><code>container_click</code>
 +
| rowspan="9"| Play
 +
| rowspan="9"| Server
 +
| colspan="2"| Window ID
 +
| colspan="2"| {{change|{{Type|Unsigned Byte}}|{{Type|VarInt}}}}
 +
| colspan="2"| The ID of the window which was clicked. 0 for player inventory. The server ignores any packets targeting a Window ID other than the current one, including ignoring 0 when any other window is open.
 +
|-
 +
| colspan="2"| State ID
 +
| colspan="2"| {{Type|VarInt}}
 +
| colspan="2"| The last received State ID from either a [[#Set Container Slot|Set Container Slot]] or a [[#Set Container Content|Set Container Content]] packet.
 +
|-
 +
| colspan="2"| Slot
 +
| colspan="2"| {{Type|Short}}
 +
| colspan="2"| The clicked slot number, see below.
 +
|-
 +
| colspan="2"| Button
 +
| colspan="2"| {{Type|Byte}}
 +
| colspan="2"| The button used in the click, see below.
 +
|-
 +
| colspan="2"| Mode
 +
| colspan="2"| {{Type|VarInt}} {{Type|Enum}}
 +
| colspan="2"| Inventory operation mode, see below.
 +
|-
 +
| colspan="2"| Length of the array
 +
| colspan="2"| {{Type|VarInt}}
 +
| colspan="2"| Maximum value for Notchian server is 128 slots.
 +
|-
 +
| rowspan="2"| Array of changed slots
 +
| Slot number
 +
| rowspan="2"| {{Type|Array}} (128)
 +
| {{Type|Short}}
 +
|
 +
|-
 +
| Slot data
 +
| {{Type|Slot}}
 +
| New data for this slot, in the client's opinion; see below.
 +
|-
 +
| colspan="2"| Carried item
 +
| colspan="2"| [[Slot Data|Slot]]
 +
| colspan="2"| Item carried by the cursor. Has to be empty (item ID = -1) for drop mode, otherwise nothing will happen.
 +
|}
  
−
In 1.7.3, when a player opens a door with left click the server receives Packet 0xE+start digging and opens the door.
+
See [[Inventory]] for further information about how slots are indexed.
  
−
==== Player Block Placement ====
+
After performing the action, the server compares the results to the slot change information included in the packet, as applied on top of the server's view of the container's state prior to the action. For any slots that do not match, it sends [[#Set Container Slot|Set Container Slot]] packets containing the correct results. If State ID does not match the last ID sent by the server, it will instead send a full [[#Set Container Content|Set Container Content]] to resynchronize the client.
−
{| class="wikitable"
 
−
|-
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan="8" | 0x08
 
−
| X || Int || Block position
 
−
|-
 
−
| Y || Unsigned Byte || Block position
 
−
|-
 
−
| Z || Int || Block position
 
−
|-
 
−
| Direction || Byte || The offset to use for block/item placement (see below)
 
−
|-
 
−
| Held item || [[Slot_Data|Slot]] ||
 
−
|-
 
−
| Cursor position X || Byte || The position of the crosshair on the block
 
−
|-
 
−
| Cursor position Y || Byte ||
 
−
|-
 
−
| Cursor position Z || Byte ||
 
−
|}
 
−
In normal operation (ie placing a block), this packet is sent once, with the values set normally.
 
  
−
This packet has a special case where X, Y, Z, and Direction are all -1. (Note that Y is unsigned so set to 255.) This special packet indicates that the currently held item for the player should have its state updated such as eating food, shooting bows, using buckets, etc.
+
When right-clicking on a stack of items, half the stack will be picked up and half left in the slot. If the stack is an odd number, the half left in the slot will be smaller of the amounts.
  
−
In a Notchian Beta client, the block or item ID corresponds to whatever the client is currently holding, and the client sends one of these packets any time a right-click is issued on a surface, so no assumptions can be made about the safety of the ID.  However, with the implementation of server-side inventory, a Notchian server seems to ignore the item ID, instead operating on server-side inventory information and holding selection. The client has been observed (1.2.5 and 1.3.2) to send both real item IDs and -1 in a single session.
+
The distinct type of click performed by the client is determined by the combination of the Mode and Button fields.
  
−
Special note on using buckets: When using buckets, the Notchian client might send two packets: first a normal and then a special case.  The first normal packet is sent when you're looking at a block (e.g. the water you want to scoop up).  This normal packet does not appear to do anything with a Notchian server.  The second, special case packet appears to perform the action - based on current position/orientation and with a distance check - it appears that buckets can only be used within a radius of 6 units.
+
{| class="wikitable"
 +
  ! Mode
 +
! Button
 +
! Slot
 +
! Trigger
 +
|-
 +
! rowspan="4"| 0
 +
| 0
 +
| Normal
 +
| Left mouse click
 +
|-
 +
| 1
 +
| Normal
 +
| Right mouse click
 +
|-
 +
| 0
 +
| -999
 +
| Left click outside inventory (drop cursor stack)
 +
|-
 +
| 1
 +
| -999
 +
| Right click outside inventory (drop cursor single item)
 +
|-
 +
! rowspan="2"| 1
 +
| 0
 +
| Normal
 +
| Shift + left mouse click
 +
|-
 +
| 1
 +
| Normal
 +
| Shift + right mouse click ''(identical behavior)''
 +
|-
 +
! rowspan="7"| 2
 +
| 0
 +
| Normal
 +
| Number key 1
 +
|-
 +
| 1
 +
| Normal
 +
| Number key 2
 +
|-
 +
| 2
 +
| Normal
 +
| Number key 3
 +
|-
 +
| ⋮
 +
| ⋮
 +
| ⋮
 +
|-
 +
| 8
 +
| Normal
 +
| Number key 9
 +
|-
 +
| ⋮
 +
| ⋮
 +
| Button is used as the slot index (impossible in vanilla clients)
 +
|-
 +
| 40
 +
| Normal
 +
| Offhand swap key F
 +
|-
 +
! 3
 +
| 2
 +
| Normal
 +
  | Middle click, only defined for creative players in non-player inventories.
 +
|-
 +
! rowspan="2"| 4
 +
| 0
 +
| Normal*
 +
  | Drop key (Q) (* Clicked item is always empty)
 +
|-
 +
| 1
 +
| Normal*
 +
| Control + Drop key (Q) (* Clicked item is always empty)
 +
|-
 +
! rowspan="9"| 5
 +
| 0
 +
| -999
 +
| Starting left mouse drag
 +
|-
 +
| 4
 +
| -999
 +
| Starting right mouse drag
 +
|-
 +
| 8
 +
| -999
 +
| Starting middle mouse drag, only defined for creative players in non-player inventories.
 +
|-
 +
| 1
 +
| Normal
 +
| Add slot for left-mouse drag
 +
|-
 +
  | 5
 +
| Normal
 +
| Add slot for right-mouse drag
 +
|-
 +
| 9
 +
| Normal
 +
| Add slot for middle-mouse drag, only defined for creative players in non-player inventories.
 +
|-
 +
  | 2
 +
| -999
 +
| Ending left mouse drag
 +
|-
 +
| 6
 +
| -999
 +
| Ending right mouse drag
 +
|-
 +
| 10
 +
| -999
 +
| Ending middle mouse drag, only defined for creative players in non-player inventories.
 +
|-
 +
! rowspan="2"| 6
 +
| 0
 +
| Normal
 +
| Double click
 +
|-
 +
| 1
 +
| Normal
 +
| Pickup all but check items in reverse order (impossible in vanilla clients)
 +
|}
  
−
==== Held Item Change ====
+
Starting from version 1.5, “painting mode” is available for use in inventory windows. It is done by picking up stack of something (more than 1 item), then holding mouse button (left, right or middle) and dragging held stack over empty (or same type in case of right button) slots. In that case client sends the following to server after mouse button release (omitting first pickup packet which is sent as usual):
−
{| class="wikitable"
+
 
−
! Packet ID !! Field Name !! Field Type !! Notes
+
# packet with mode 5, slot -999, button (0 for left | 4 for right);
−
|-
+
# packet for every slot painted on, mode is still 5, button (1 | 5);
−
| rowspan=1 | 0x09
+
# packet with mode 5, slot -999, button (2 | 6);
−
| Slot || Short || The slot which the player has selected (0-8)
 
−
|}
 
  
−
==== Animation ====
+
If any of the painting packets other than the “progress” ones are sent out of order (for example, a start, some slots, then another start; or a left-click in the middle) the painting status will be reset.
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=2 | 0x0A
 
−
| Entity ID || Int || Player ID
 
−
|-
 
−
| Animation || Byte || Animation ID
 
−
|}
 
  
 +
==== Close Container ====
  
−
Animation can be one of the following values:
+
This packet is sent by the client when closing a window.
  
−
{| class="wikitable"
+
Notchian clients send a Close Window packet with Window ID 0 to close their inventory even though there is never an [[#Open Screen|Open Screen]] packet for the inventory.
−
! 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
 
−
|}
 
  
−
==== Entity Action ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Packet ID
−
|-
+
! State
−
| rowspan="3" | 0x0B
+
! Bound To
−
| Entity ID || Int || Player ID
+
! Field Name
−
|-
+
! Field Type
−
| Action ID || Byte || The ID of the action, see below.
+
! Notes
−
|-
+
|-
−
| Jump Boost || Int || Horse jump boost. Ranged from 0 -> 100.
+
| ''protocol:''<br/><code>{{change|0x0F|0x11}}</code><br/><br/>''resource:''<br/><code>container_close</code>
−
|}
+
| Play
 +
| Server
 +
| Window ID
 +
| {{change|{{Type|Unsigned Byte}}|{{Type|VarInt}}}}
 +
| This is the ID of the window that was closed. 0 for player inventory.
 +
|}
  
−
Action ID can be one of the following values:
+
==== Edit Book ====
  
 
{| class="wikitable"
 
{| class="wikitable"
−
! ID !! Action
+
! Packet ID
−
|-
+
! State
−
| 1 || Crouch
+
! Bound To
−
|-
+
! Field Name
−
| 2 || Uncrouch
+
! Field Type
−
|-
+
! Notes
−
| 3 || Leave bed
+
|-
−
|-
+
| rowspan="5"| ''protocol:''<br/><code>{{change|0x14|0x16}}</code><br/><br/>''resource:''<br/><code>edit_book</code>
−
| 4 || Start sprinting
+
| rowspan="5"| Play
−
|-
+
| rowspan="5"| Server
−
| 5 || Stop sprinting
+
| Slot
−
|}
+
| {{Type|VarInt}}
 +
| The hotbar slot where the written book is located
 +
|-
 +
| Count
 +
| {{Type|VarInt}}
 +
| Number of elements in the following array. Maximum array size is {{change|200|100}}.
 +
|-
 +
| Entries
 +
| {{Type|Array}} ({{change|200|100}}) of {{Type|String}} ({{change|8192|1024}})
 +
| Text from each page. Maximum string length is {{change|8192|1024}} chars.
 +
|-
 +
| Has title
 +
| {{Type|Boolean}}
 +
| If true, the next field is present. true if book is being signed, false if book is being edited.
 +
|-
 +
| Title
 +
| {{Type|Optional}} {{Type|String}} ({{change|128|32}})
 +
| Title of book.
 +
|}
  
−
==== Steer Vehicle ====
+
==== Set Player Position ====
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan="4" | 0x0C
 
−
| Sideways || Float || Positive to the left of the player
 
−
|-
 
−
| Forward || Float || Positive forward
 
−
|-
 
−
| Jump || Bool ||
 
−
|-
 
−
| Unmount || Bool || True when leaving the vehicle
 
−
|}
 
  
−
==== Close Window ====
+
Updates the player's XYZ position on the server.
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| 0x0D
 
−
| Window id || byte || This is the id of the window that was closed. 0 for inventory.
 
−
|}
 
  
 +
If the player is in a vehicle, the position is ignored (but in case of [[#Set Player Position and Rotation|Set Player Position and Rotation]], the rotation is still used as normal). No validation steps other than value range clamping are performed in this case.
  
−
==== Click Window ====
+
If the player is sleeping, the position (or rotation) is not changed, and a [[#Synchronize Player Position|Synchronize Player Position]] is sent if the received position deviated from the server's view by more than a meter.
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan="6" | 0x0E
 
−
| Window ID || Byte || The id of the window which was clicked. 0 for player inventory.
 
−
|-
 
−
| Slot || Short || The clicked slot. See below.
 
−
|-
 
−
| Button || Byte || The button used in the click. See below.
 
−
|-
 
−
| Action number || Short || A unique number for the action, used for transaction handling (See the Transaction packet).
 
−
|-
 
−
| Mode || Byte || Inventory operation mode. See below.
 
−
|-
 
−
| Clicked item || [[Slot_Data|Slot]] ||
 
−
|}
 
  
−
See [[Inventory#Windows|inventory windows]] for further information about how slots are indexed.
+
The Notchian server silently clamps the x and z coordinates between -30,000,000 and 30,000,000, and the y coordinate between -20,000,000 and 20,000,000. A similar condition has historically caused a kick for "Illegal position"; this is no longer the case. However, infinite or NaN coordinates (or angles) still result in a kick for <code>multiplayer.disconnect.invalid_player_movement</code>.
  
−
When right-clicking on a stack of items, half the stack will be picked up and half left in the slot.  If the stack is an odd number, the half left in the slot will be smaller of the amounts.
+
As of 1.20.6, checking for moving too fast is achieved like this (sic):
  
−
The Action number is actually a counter, starting at 1. This number is used by the server as a transaction ID to send back a [[#0x6A|Transaction packet]].
+
* Each server tick, the player's current position is stored.
 +
* When the player moves, the offset from the stored position to the requested position is computed (&Delta;x, &Delta;y, &Delta;z).
 +
* The requested movement distance squared is computed as &Delta;x&sup2; + &Delta;y&sup2; + &Delta;z&sup2;.
 +
* The baseline expected movement distance squared is computed based on  the player's server-side velocity as Vx&sup2; + Vy&sup2; + Vz&sup2;. The player's server-side velocity is a somewhat ill-defined quantity that includes among other things gravity, jump velocity and knockback, but ''not'' regular horizontal movement. A proper description would bring much of Minecraft's physics engine with it. It is accessible as the <code>Motion</code> NBT tag on the player entity.
 +
* The maximum permitted movement distance squared is computed as 100 (300 if the player is using an elytra), multiplied by the number of movement packets received since the last tick, including this one, unless that value is greater than 5, in which case no multiplier is applied.
 +
* If the requested movement distance squared minus the baseline distance squared is more than the maximum squared, the player is moving too fast.
  
−
The distinct type of click performed by the client is determined by the combination of the "Mode" and "Button" fields.
+
If the player is moving too fast, it is logged that "<player> moved too quickly! " followed by the change in x, y, and z, and the player is teleported back to their current (before this packet) server-side position.
−
{| class="wikitable"
 
−
! Mode !! Button !! Slot !! Trigger
 
−
|-
 
−
! rowspan="2" | 0
 
−
| 0 || Normal || Left mouse click
 
−
|-
 
−
| 1 || Normal || Right mouse click
 
−
|-
 
−
! rowspan="2" | 1
 
−
| 0 || Normal || Shift + left mouse click
 
−
|-
 
−
| 1 || Normal || Shift + right mouse click ''(Identical behavior)''
 
−
|-
 
−
! rowspan="5" | 2
 
−
| 0 || Normal || Number key 1
 
−
|-
 
−
| 1 || Normal || Number key 2
 
−
|-
 
−
| 2 || Normal || Number key 3
 
−
|-
 
−
| ...
 
−
| ...
 
−
| ...
 
−
|-
 
−
| 8 || Normal || Number key 9
 
−
|-
 
−
! rowspan="1" | 3
 
−
| 2 || Normal || Middle click
 
−
|-
 
−
! rowspan="4" | 4
 
−
| 0 || Normal || Drop key (Q)
 
−
|-
 
−
| 1 || Normal || Ctrl + Drop key (Ctrl-Q)
 
−
|-
 
−
| 0 || -999 || Left click outside inventory holding nothing ''(No-op)''
 
−
|-
 
−
| 1 || -999 || Right click outside inventory holding nothing ''(No-op)''
 
−
|-
 
−
! rowspan="6" | 5
 
−
| 0 || -999 || Starting left mouse drag ''(Or middle mouse)''
 
−
|-
 
−
| 4 || -999 || Starting right mouse drag
 
−
|-
 
−
| 1 || Normal || Add slot for left-mouse drag
 
−
|-
 
−
| 5 || Normal || Add slot for right-mouse drag
 
−
|-
 
−
| 2 || -999 || Ending left mouse drag
 
−
|-
 
−
| 6 || -999 || Ending right mouse drag
 
−
|-
 
−
! 6
 
−
| 0 || Normal || Double click
 
−
|}
 
  
−
Starting from version 1.5, "painting mode" is available for use in inventory windows. It is done by picking up stack of something (more than 1 items), then holding mouse button (left, right or middle) and dragging holded stack over empty (or same type in case of right button ) slots. In that case client sends the following to server after mouse button release (omitting first pickup packet which is sent as usual):
+
Checking for block collisions is achieved like this:
  
−
# packet with mode 5, slot -999 , button (0 for left | 4 for right);
+
* A temporary collision-checked move of the player is attempted from its current position to the requested one.
−
# packet for every slot painted on, mode is still 5, button (1 | 5);
+
* The offset from the resulting position to the requested position is computed. If the absolute value of the offset on the y axis is less than 0.5, it (only the y component) is rounded down to 0.
−
# packet with mode 5, slot -999, button (2 | 6);
+
* If the magnitude of the offset is greater than 0.25 and the player isn't in creative or spectator mode, it is logged that "<player> moved wrongly!", and the player is teleported back to their current (before this packet) server-side position.
 +
* In addition, if the player's hitbox stationary at the requested position would intersect with a block, and they aren't in spectator mode, they are teleported back without a log message.
  
−
If any of the painting packets other than the "progress" ones are sent out of order (for example, a start, some slots, then another start; or a left-click in the middle) the painting status will be reset.
+
Checking for illegal flight is achieved like this:
  
−
==== Confirm Transaction  ====
+
* When a movement packet is received, a flag indicating whether or not the player is floating mid-air is updated. The flag is set if the move test described above detected no collision below the player ''and'' the y component of the offset from the player's current position to the requested one is greater than -0.5, unless any of various conditions permitting flight (creative mode, elytra, levitation effect, etc., but not jumping) are met.
−
{| class="wikitable"
+
* Each server tick, it is checked if the flag has been set for more than 80 consecutive ticks. If so, and the player isn't currently sleeping, dead or riding a vehicle, they are kicked for <code>multiplayer.disconnect.flying</code>.
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan="3" | 0x0F
 
−
| Window ID || Byte || The id of the window that the action occurred in.
 
−
|-
 
−
| Action number || Short || Every action that is to be accepted has a unique number. This field corresponds to that number.
 
−
|-
 
−
| Accepted || Bool || Whether the action was accepted.
 
−
|}
 
  
−
==== Creative Inventory Action ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Packet ID
−
|-
+
! State
−
| rowspan="2" | 0x10
+
! Bound To
−
| Slot || Short || Inventory slot
+
! Field Name
−
|-
+
! Field Type
−
| Clicked item || [[Slot_Data|Slot]] ||
+
! Notes
−
|}
+
|-
 +
| rowspan="5"| ''protocol:''<br/><code>{{change|0x1A|0x1C}}</code><br/><br/>''resource:''<br/><code>move_player_pos</code>
 +
| rowspan="5"| Play
 +
| rowspan="5"| Server
 +
| X
 +
| {{Type|Double}}
 +
| Absolute position.
 +
|-
 +
| Feet Y
 +
| {{Type|Double}}
 +
| Absolute feet position, normally Head Y - 1.62.
 +
|-
 +
| Z
 +
| {{Type|Double}}
 +
| Absolute position.
 +
|- {{removed}}
 +
| On Ground
 +
| {{Type|Boolean}}
 +
| True if the client is on the ground, false otherwise.
 +
|- {{added}}
 +
| Flags
 +
| {{Type|Byte}}
 +
| Bit field: 0x01: on ground, 0x02: pushing against wall.
 +
|}
  
−
==== Enchant Item ====
+
==== Set Player Position and Rotation ====
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan="2" | 0x11
 
−
| Window ID || Byte || The ID sent by [[#0x64|Open Window]]
 
−
|-
 
−
| Enchantment || Byte || The position of the enchantment on the enchantment table window, starting with 0 as the topmost one.
 
−
|}
 
  
−
==== Update Sign ====
+
A combination of [[#Set Player Rotation|Move Player Rotation]] and [[#Set Player Position|Move Player Position]].
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan="7" | 0x12
 
−
| X || Int || Block X Coordinate
 
−
|-
 
−
| Y || Short || Block Y Coordinate
 
−
|-
 
−
| Z || Int || Block Z Coordinate
 
−
|-
 
−
| Line 1 || String || First line of text in the sign
 
−
|-
 
−
| Line 2 || String || Second line of text in the sign
 
−
|-
 
−
| Line 3 || String || Third line of text in the sign
 
−
|-
 
−
| Line 4 || String || Fourth line of text in the sign
 
−
|}
 
  
−
==== Player Abilities ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Packet ID
−
|-
+
! State
−
| rowspan="3" | 0x13
+
! Bound To
−
| Flags || Byte ||
+
! Field Name
−
|-
+
! Field Type
−
| Flying speed || Float|| previous integer value divided by 250
+
! Notes
−
|-
+
|-
−
| Walking speed || Float || previous integer value divided by 250
+
| rowspan="7"| ''protocol:''<br/><code>{{change|0x1B|0x1D}}</code><br/><br/>''resource:''<br/><code>move_player_pos_rot</code>
−
|}
+
| rowspan="7"| Play
 +
| rowspan="7"| Server
 +
| X
 +
| {{Type|Double}}
 +
| Absolute position.
 +
|-
 +
| Feet Y
 +
| {{Type|Double}}
 +
| Absolute feet position, normally Head Y - 1.62.
 +
|-
 +
| Z
 +
| {{Type|Double}}
 +
| Absolute position.
 +
|-
 +
| Yaw
 +
| {{Type|Float}}
 +
| Absolute rotation on the X Axis, in degrees.
 +
|-
 +
| Pitch
 +
| {{Type|Float}}
 +
| Absolute rotation on the Y Axis, in degrees.
 +
|- {{removed}}
 +
| On Ground
 +
| {{Type|Boolean}}
 +
| True if the client is on the ground, false otherwise.
 +
|- {{added}}
 +
| Flags
 +
| {{Type|Byte}}
 +
| Bit field: 0x01: on ground, 0x02: pushing against wall.
 +
|}
  
−
==== Tab-Complete ====
+
==== Set Player Rotation ====
−
{| class="wikitable"
+
[[File:Minecraft-trig-yaw.png|thumb|The unit circle for yaw]]
−
! Packet ID !! Field Name !! Field Type !! Notes
+
[[File:Yaw.png|thumb|The unit circle of yaw, redrawn]]
−
|-
 
−
| 0x14
 
−
| Text || String ||
 
−
|}
 
  
 +
Updates the direction the player is looking in.
  
−
==== Client Settings ====
+
Yaw is measured in degrees, and does not follow classical trigonometry rules. The unit circle of yaw on the XZ-plane starts at (0, 1) and turns counterclockwise, with 90 at (-1, 0), 180 at (0,-1) and 270 at (1, 0). Additionally, yaw is not clamped to between 0 and 360 degrees; any number is valid, including negative numbers and numbers greater than 360.
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan="6" | 0x15
 
−
| Locale || String || en_GB
 
−
|-
 
−
| View distance || Byte || 0-3 for 'far', 'normal', 'short', 'tiny'.
 
−
|-
 
−
| Chat flags || Byte || Chat settings. See notes below.
 
−
|-
 
−
| ??? || Bool || ???
 
−
|-
 
−
| Difficulty || Byte || Client-side difficulty from options.txt
 
−
|-
 
−
| Show Cape || Bool || Client-side "show cape" option
 
−
|}
 
  
−
Chat flags has several values packed into one byte.
+
Pitch is measured in degrees, where 0 is looking straight ahead, -90 is looking straight up, and 90 is looking straight down.
  
−
'''Chat Enabled:''' Bits 0-1. 00: Enabled.  01: Commands only.  10: Hidden.
+
The yaw and pitch of player (in degrees), standing at point (x0, y0, z0) and looking towards point (x, y, z) can be calculated with:
  
−
'''Colors Enabled:''' Bit 3. 0: Disabled. 1: Enabled.
+
  dx = x-x0
 +
dy = y-y0
 +
dz = z-z0
 +
r = sqrt( dx*dx + dy*dy + dz*dz )
 +
yaw = -atan2(dx,dz)/PI*180
 +
if yaw < 0 then
 +
    yaw = 360 + yaw
 +
  pitch = -arcsin(dy/r)/PI*180
  
−
==== Client Status ====
+
You can get a unit vector from a given yaw/pitch via:
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=1 | 0x16
 
−
| Action ID || Byte || See below
 
−
|}
 
  
−
Action ID values:
+
x = -cos(pitch) * sin(yaw)
−
{| class="wikitable"
+
y = -sin(pitch)
−
|-
+
z =  cos(pitch) * cos(yaw)
−
! Action ID !! Name
 
−
|-
 
−
| 1 || Perform respawn
 
−
|-
 
−
| 2 || Request stats
 
−
|-
 
−
| 3 || Open inventory achievement
 
−
|}
 
  
−
==== Plugin Message ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Packet ID
−
|-
+
! State
−
| rowspan="3" | 0x17
+
! Bound To
−
| Channel || String || Name of the "channel" used to send the data.
+
! Field Name
−
|-
+
! Field Type
−
| Length || Short || Length of the following byte array
+
! Notes
−
|-
+
|-
−
| Data || Byte Array || Any data.
+
| rowspan="4"| ''protocol:''<br/><code>{{change|0x1C|0x1E}}</code><br/><br/>''resource:''<br/><code>move_player_rot</code>
−
|}
+
| rowspan="4"| Play
 +
| rowspan="4"| Server
 +
| Yaw
 +
| {{Type|Float}}
 +
| Absolute rotation on the X Axis, in degrees.
 +
|-
 +
| Pitch
 +
| {{Type|Float}}
 +
| Absolute rotation on the Y Axis, in degrees.
 +
|- {{removed}}
 +
| On Ground
 +
| {{Type|Boolean}}
 +
| True if the client is on the ground, false otherwise.
 +
|- {{added}}
 +
| Flags
 +
| {{Type|Byte}}
 +
| Bit field: 0x01: on ground, 0x02: pushing against wall.
 +
|}
 +
{{Anchor|Set Player Movement Flags}}
 +
==== Set Player {{change|On Ground|Movement Flags}} ====
  
−
More documentation on this: http://dinnerbone.com/blog/2012/01/13/minecraft-plugin-channels-messaging/
+
This packet as well as [[#Set Player Position|Set Player Position]], [[#Set Player Rotation|Set Player Rotation]], and [[#Set Player Position and Rotation|Set Player Position and Rotation]] are called the “serverbound movement packets”. Vanilla clients will send Move Player Position once every 20 ticks even for a stationary player.
  
−
== Status ==
+
This packet is used to indicate whether the player is on ground (walking/swimming), or airborne (jumping/falling).
−
The status ping works as follows.  
 
−
    C->S : Handshake State=1
 
−
    C->S : Request
 
−
    S->C : Response
 
−
    C->S : Ping
 
−
    S->C : Ping
 
  
−
=== Clientbound ===
+
When dropping from sufficient height, fall damage is applied when this state goes from false to true. The amount of damage applied is based on the point where it last changed from true to false. Note that there are several movement related packets containing this state.
  
−
==== Response ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Packet ID
−
|-
+
! State
−
| rowspan=1 | 0x00
+
! Bound To
−
| JSON Response || String || https://gist.github.com/thinkofdeath/6927216
+
! Field Name
−
|}
+
! Field Type
 +
! Notes
 +
|-
 +
| rowspan="2"| ''protocol:''<br/><code>{{change|0x1D|0x1F}}</code><br/><br/>''resource:''<br/><code>move_player_status_only</code>
 +
| rowspan="2"| Play
 +
| rowspan="2"| Server
 +
| {{removed}} | On Ground
 +
| {{removed}} | {{Type|Boolean}}
 +
| {{removed}} | True if the client is on the ground, false otherwise.
 +
|- {{added}}
 +
| Flags
 +
| {{Type|Byte}}
 +
| Bit field: 0x01: on ground, 0x02: pushing against wall.
 +
|}
 +
 
 +
==== Place Recipe ====
  
 +
This packet is sent when a player clicks a recipe in the crafting book that is craftable (white border).
  
−
==== Ping ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Packet ID
−
|-
+
! State
−
| rowspan=1 | 0x01
+
! Bound To
−
| Time || Long || Should be the same as sent by the client
+
! Field Name
−
|}
+
! Field Type
 +
! Notes
 +
|-
 +
| rowspan="3"| ''protocol:''<br/><code>{{change|0x22|0x24}}</code><br/><br/>''resource:''<br/><code>place_recipe</code>
 +
| rowspan="3"| Play
 +
| rowspan="3"| Server
 +
| Window ID
 +
| {{Type|Byte}}
 +
|
 +
|-
 +
| Recipe{{change|| ID}}
 +
| {{change|{{Type|Identifier}}|{{Type|VarInt}}}}
 +
| {{change|A recipe ID.|ID of recipe previously defined in [[#Recipe Book Add|Recipe Book Add]].}}
 +
|-
 +
| Make all
 +
| {{Type|Boolean}}
 +
| Affects the amount of items processed; true if shift is down when clicked.
 +
|}
  
−
=== Serverbound ===
+
==== Player Input ====
  
−
==== Request ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Packet ID
−
|-
+
! State
−
| rowspan=1 | 0x00 || || ||
+
! Bound To
−
|}
+
! Field Name
 +
! Field Type
 +
! Notes
 +
|-
 +
| rowspan="3"| ''protocol:''<br/><code>{{change|0x26|0x28}}</code><br/><br/>''resource:''<br/><code>player_input</code>
 +
| rowspan="3"| Play
 +
| rowspan="3"| Server
 +
| {{removed}} | Sideways
 +
| {{removed}} | {{Type|Float}}
 +
| {{removed}} | Positive to the left of the player.
 +
|- {{removed}}
 +
| Forward
 +
| {{Type|Float}}
 +
| Positive forward.
 +
|-
 +
| Flags
 +
| {{Type|Unsigned Byte}}
 +
| Bit mask{{change|. 0x1: jump, 0x2: unmount.|; see below.}}
 +
|}
  
 +
The flags are as follows:
  
−
==== Ping ====
+
{| class="wikitable" {{added}}
−
{| class="wikitable"
+
|-
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Hex Mask
−
|-
+
! Field
−
| rowspan=1 | 0x01
+
|-
−
| Time || Long ||
+
| 0x01
−
|}
+
| Forward
−
 
+
|-
−
== Login ==
+
| 0x02
 +
| Backward
 +
|-
 +
| 0x04
 +
| Left
 +
|-
 +
| 0x08
 +
| Right
 +
|-
 +
| 0x10
 +
| Jump
 +
|-
 +
| 0x20
 +
| Sneak
 +
|-
 +
| 0x40
 +
| Sprint
 +
|}
  
−
The login process is as follows:
+
==== Set Seen Recipe ====
−
    C->S : Handshake State=2
 
−
    C->S : Login Start
 
−
    S->C : Encryption Key Request
 
−
    C->S : Encryption Key Response
 
−
    (Auth & enable encryption)
 
−
    S->S : Login Success
 
  
−
=== Clientbound ===
+
Sent when recipe is first seen in recipe book. Replaces Recipe Book Data, type 0.
  
−
==== Disconnect ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
! Packet ID
−
|-
+
! State
−
| rowspan=1 | 0x00
+
! Bound To
−
| JSON Data || String ||
+
! Field Name
−
|}
+
! Field Type
 +
! Notes
 +
|-
 +
| ''protocol:''<br/><code>{{change|0x29|0x2B}}</code><br/><br/>''resource:''<br/><code>recipe_book_seen_recipe</code>
 +
| Play
 +
| Server
 +
| Recipe ID
 +
| {{change|{{Type|Identifier}}|{{Type|VarInt}}}}
 +
| ID of recipe previously defined in [[#Recipe Book Add|Recipe Book Add]].
 +
|}
  
−
==== Encryption Response ====
+
==== Use Item On ====
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=5 | 0x01
 
−
| Server ID || String ||
 
−
|-
 
−
| Length || Short || length of public key
 
−
|-
 
−
| || Byte array || public key
 
−
|-
 
−
| Length || Short || length of verify token
 
−
|-
 
−
| || Byte array || verify token
 
−
|-
 
−
|}
 
  
−
==== Login Success ====
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! Packet ID !! Field Name !! Field Type !! Notes
+
|-
−
|-
+
! Packet ID
−
| rowspan=2 | 0x02
+
! State
−
| UUID || String ||
+
! Bound To
−
| Username || String ||
+
! Field Name
−
|}
+
! Field Type
 +
! Notes
 +
|-
 +
| rowspan="9"| ''protocol:''<br/><code>{{change|0x38|0x3A}}</code><br/><br/>''resource:''<br/><code>use_item_on</code>
 +
| rowspan="9"| Play
 +
| rowspan="9"| Server
 +
| Hand
 +
| {{Type|VarInt}} {{Type|Enum}}
 +
| The hand from which the block is placed; 0: main hand, 1: off hand.
 +
|-
 +
| Location
 +
| {{Type|Position}}
 +
| Block position.
 +
|-
 +
| Face
 +
| {{Type|VarInt}} {{Type|Enum}}
 +
| The face on which the block is placed (as documented at [[#Player Action|Player Action]]).
 +
|-
 +
| Cursor Position X
 +
| {{Type|Float}}
 +
| The position of the crosshair on the block, from 0 to 1 increasing from west to east.
 +
|-
 +
| Cursor Position Y
 +
| {{Type|Float}}
 +
| The position of the crosshair on the block, from 0 to 1 increasing from bottom to top.
 +
|-
 +
| Cursor Position Z
 +
| {{Type|Float}}
 +
| The position of the crosshair on the block, from 0 to 1 increasing from north to south.
 +
|-
 +
| Inside block
 +
| {{Type|Boolean}}
 +
| True when the player's head is inside of a block.
 +
|- {{added}}
 +
| World border hit
 +
| {{Type|Boolean}}
 +
| Seems to always be false, even when interacting with blocks around or outside the world border, or while the player is outside the border.
 +
|-
 +
| Sequence
 +
| {{Type|VarInt}}
 +
| Block change sequence number (see [[#Acknowledge Block Change]]).
 +
|}
  
−
=== Serverbound ===
+
Upon placing a block, this packet is sent once.
  
−
==== Login Start  ====
+
The Cursor Position X/Y/Z fields (also known as in-block coordinates) are calculated using raytracing. The unit corresponds to sixteen pixels in the default resource pack. For example, let's say a slab is being placed against the south face of a full block. The Cursor Position X will be higher if the player was pointing near the right (east) edge of the face, lower if pointing near the left. The Cursor Position Y will be used to determine whether it will appear as a bottom slab (values 0.0–0.5) or as a top slab (values 0.5-1.0). The Cursor Position Z should be 1.0 since the player was looking at the southernmost part of the block.
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=1 | 0x00
 
−
| Name || String || unknown
 
−
|}
 
  
−
==== Encryption Request ====
+
Inside block is true when a player's head (specifically eyes) are inside of a block's collision. In 1.13 and later versions, collision is rather complicated and individual blocks can have multiple collision boxes. For instance, a ring of vines has a non-colliding hole in the middle. This value is only true when the player is directly in the box. In practice, though, this value is only used by scaffolding to place in front of the player when sneaking inside of it (other blocks will place behind when you intersect with them -- try with glass for instance).
−
{| class="wikitable"
 
−
! Packet ID !! Field Name !! Field Type !! Notes
 
−
|-
 
−
| rowspan=4 | 0x01
 
−
| Length || Short || length of public key
 
−
|-
 
−
| || Byte array || public key
 
−
|-
 
−
| Length || Short || length of verify token
 
−
|-
 
−
| || Byte array || verify token
 
−
|-  
 
−
|}
 
  
−
== Plugin Channels ==
+
[[Category:Minecraft Modern]]
−
 
 
−
=== MC|RPack ===
 
−
{| class="wikitable"
 
−
! Field Name !! Field Type !! Example !! Notes
 
−
|-
 
−
| Resource pack URL || UTF8 string || http://example.com/pack.zip ||
 
−
|}
 

Latest revision as of 09:33, 26 November 2024

This page documents the changes from release 1.21.1 (protocol 767) to the current release (1.21.3, protocol 768). The stable protocol documentation is currently lagging behind, and the changes documented here will be merged soon, once they are complete. The current pre-release (snapshot 24w44a) is not yet 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

Contents

Data types

Name Size (bytes) Encodes Notes
Teleport Flags 4 See #Teleport Flags Bit field specifying how a teleportation is to be applied on each axis.
Recipe Display Varies See Recipes#Recipe Display structure Description of a recipe for use for use by the client.
Slot Display Varies See Recipes#Slot Display structure Description of a recipe ingredient slot for use for use by the client.

Teleport Flags

A bit field represented as an Int, specifying how a teleportation is to be applied on each axis.

In the lower 8 bits of the bit field, a set bit means the teleportation on the corresponding axis is relative, and an unset bit that it is absolute.

Hex Mask Field
0x0001 Relative X
0x0002 Relative Y
0x0004 Relative Z
0x0008 Relative Yaw
0x0010 Relative Pitch
0x0020 Relative Velocity X
0x0040 Relative Velocity Y
0x0080 Relative Velocity Z
0x0100 Rotate velocity according to the change in rotation, before applying the velocity change in this packet. Combining this with absolute rotation works as expected—the difference in rotation is still used.

Packets

ID Packet name Documentation
Play clientbound
0x12 Close Container Current Pre
0x13 Set Container Content Current Pre
0x14 Set Container Property Current Pre
0x15 Set Container Slot Current Pre
0x17 Set Cooldown Current Pre
0x70 0x20 Teleport Entity Current Pre
0x20 0x21 Explosion Current Pre
0x23 0x24 Open Horse Screen Current Pre
0x2B 0x2C Login (play) Current Pre
0x31 Move Minecart Along Track Pre
0x37 0x39 Place Ghost Recipe Current Pre
0x3E 0x40 Player Info Update Current Pre
0x40 0x42 Synchronize Player Position Current Pre
0x41 Update Recipe Book Current
0x43 Player Rotation Pre
0x44 Recipe Book Add Pre
0x45 Recipe Book Remove Pre
0x46 Recipe Book Settings Pre
0x47 0x4C Respawn Current Pre
0x5a Set Cursor Item Pre
0x53 0x63 Set Held Item Current (unchanged)
0x66 Set Player Inventory Slot Pre
0x64 0x6b Update Time Current Pre
0x77 Synchronize Vehicle Position Pre
0x77 0x7e Update Recipes Current Pre
Play serverbound
0x02 Bundle Item Selected Pre
0x0b Client Tick End Pre
0x0E 0x10 Click Container Current Pre
0x0F 0x11 Close Container Current Pre
0x14 0x16 Edit Book Current Pre
0x1A 0x1C Set Player Position Current Pre
0x1B 0x1D Set Player Position and Rotation Current Pre
0x1C 0x1E Set Player Rotation Current Pre
0x1D Set Player On Ground Current
0x1F Set Player Movement Flags Pre
0x22 0x24 Place Recipe Current Pre
0x26 0x28 Player Input Current Pre
0x29 0x2B Set Seen Recipe Current Pre
0x38 0x3A Use Item On Current Pre

Entity Metadata

Entity Metadata Format

Painting Variant

See also: Registry Data#Painting Variant
Name Type Meaning
Width Int The width of the painting, in blocks.
Height Int The height of the painting, in blocks.
Asset ID Identifier The texture for the painting.

The Notchian client uses the corresponding asset located at textures/painting.

Has title Boolean
Title Optional Text Component The displayed title of the painting. Only present if Has title is true.
Has author Boolean
Author Optional Text Component The displayed author of the painting. Only present if Has author is true.

Registry Data

Painting Variant

The minecraft:painting_variant registry. It defines the textures and dimensions for the game's paintings.

Name Type Meaning Values
asset_id String Tag The texture for the painting.

The Notchian client uses the corresponding asset located at textures/painting.

Example: "minecraft:backyard".
height Int Tag The height of the painting, in blocks. Example: 2
width Int Tag The width of the painting, in blocks.
title Compound Tag or String Tag The displayed title of the painting. See Text formatting. Example: {"color": "gray", "translate": "painting.minecraft.skeleton.title"}
author Compound Tag or String Tag The displayed author of the painting. See Text formatting. Example: {"color": "gray", "translate": "painting.minecraft.skeleton.author"}

Slot Data

Structured components

Type Name Description Data
6 minecraft:item_model Item's model. As follows:
Name Type Description
Model Identifier
20 21 minecraft:food Makes the item consumable restore the player's hunger bar when consumed. As follows:
Name Type Description
Nutrition VarInt Non-negative
Saturation Modifier Float How much saturation will be given after consuming the item.
Can Always Eat Boolean Whether the item can always be eaten, even at full hunger.
Seconds To Eat Float How long it takes to consume the item.
Using converts to Slot Data This specifies the item produced after consuming the current item. In the Notchian server, this is used for stews, which turn into bowls. Set this to Air if the item should be consumed normally without leaving any other item after.
Number of effects VarInt Number of elements in the following array.
Effect Type ID Array Potion Effect The potion effect. See Potion Effect.
Probability Float The probability for this effect to be chosen.
22 minecraft:consumable Makes the item consumable. As follows:
Name Type Description
Consume seconds Float How long it takes to consume the item.
Animation VarInt Enum 0: none, 1: eat, 2: drink, 3: block, 4: bow, 5: spear, 6: crossbow, 7: spyglass, 8: toot_horn, 9: brush
Sound ID or Sound Event ID in the minecraft:sound_event registry, or an inline definition.
Has consume particles Boolean
Number of effects VarInt Number of elements in the following array.
Effects Array of Consume Effect Effects to apply on consumption. See Consume Effect.
23 minecraft:use_remainder This specifies the item produced after using the current item. In the Notchian server, this is used for stews, which turn into bowls. As follows:
Name Type Description
Remainder Slot
24 minecraft:use_cooldown Cooldown to apply on use of the item. As follows:
Name Type Description
Seconds Float
Cooldown group Optional Identifier Group of items to apply the cooldown to. Only present if Has cooldown group is true; otherwise defaults to the item's identifier.
21 25 minecraft:fire damage_resistant Marks this item as fire damage resistant.
The client won't render the item as being on-fire if this component is present. 		None. As follows:
Name Type Description
Types Identifier Tag specifying damage types the item is immune to. Not prefixed by '#'!.
27 minecraft:enchantable Allows the item to be enchanted by an enchanting table. As follows:
Name Type Description
Value VarInt Opaque internal value controlling how expensive enchantments may be offered.
28 minecraft:equippable Allows the item to be equipped by the player. As follows:
Name Type Description
Slot VarInt Enum 0: mainhand, 1: feet, 2: legs, 3: chest, 4: head, 5: offhand, 6: body
Equip sound ID or Sound Event ID in the minecraft:sound_event registry, or an inline definition.
Has model Boolean
Model Optional Identifier Only present if Has model is true.
Has camera overlay Boolean
Camera overlay Optional Identifier Only present if Has camera overlay is true.
Has allowed entities Boolean
Allowed entities Optional ID Set IDs in the minecraft:entity_type registry. Only present if Has allowed entities is true.
Dispensable Boolean
Swappable Boolean
Damage on hurt Boolean
29 minecraft:repairable Items that can be combined with this item in an anvil to repair it. As follows:
Name Type Description
Items ID Set IDs in the minecraft:item registry.
30 minecraft:glider Makes the item function like elytra. None.
31 minecraft:tooltip_style Custom textures for the item tooltip. As follows:
Name Type Description
Style Identifier
32 minecraft:death_protection Makes the item function like a totem of undying. As follows:
Name Type Description
Number of effects VarInt Number of elements in the following array.
Effects Array of Consume Effect Effects to apply on consumption. See Consume Effect.
31 41 minecraft:potion_contents Visual and effects of a potion item. As follows:
Name Type Description
Has Potion ID Boolean Whether this potion has an ID in the potion registry. If true, it has the default effects associated with the potion type.
Potion ID Optional VarInt The ID of the potion type in the potion registry. Only present if Has Potion ID is true.
Has Custom Color Boolean Whether this potion has a custom color. If false, it uses the default color associated with the potion type.
Custom Color Optional Int The RGB components of the color, encoded as an integer. Only present if Has Custom Color is true.
Number Of Custom Effects VarInt The number of elements in the following array.
Custom Effects Array of Potion Effect Any custom effects the potion might have. See Potion Effect.
Custom Name String

Other types

Consume Effect

WIP

Instrument

Name Type Description
Sound Event Id or Sound Event The sound to be played.
Use duration VarInt Float The maximum range of the sound.
Range Float The range of the instrument.
Description Text Component Description shown in the item tooltip.

Particles

Particle Name Particle ID Data
minecraft:dust 13
Field Name Field Type Meaning
Red Float The red RGB value, between 0 and 1. Divide actual RGB value by 255.
Green Float The green RGB value, between 0 and 1. Divide actual RGB value by 255.
Blue Float The blue RGB value, between 0 and 1. Divide actual RGB value by 255.
Color Int The color, encoded as 0xRRGGBB; top bits are ignored.
Scale Float The scale, will be clamped between 0.01 and 4.
minecraft:dust_color_transition 14
Field Name Field Type Meaning
From Red Float The start red RGB value, between 0 and 1. Divide actual RGB value by 255.
From Green Float The start green RGB value, between 0 and 1. Divide actual RGB value by 255.
From Blue Float The start blue RGB value, between 0 and 1. Divide actual RGB value by 255.
From Color Int The start color, encoded as 0xRRGGBB; top bits are ignored.
To Red Float The end red RGB value, between 0 and 1. Divide actual RGB value by 255.
To Green Float The end green RGB value, between 0 and 1. Divide actual RGB value by 255.
To Blue Float The end blue RGB value, between 0 and 1. Divide actual RGB value by 255.
To Color Int The end color, encoded as 0xRRGGBB; top bits are ignored.
Scale Float The scale, will be clamped between 0.01 and 4.

Recipes

(this is meant to become a new page.)

Recipe Display structure

Name Type Description
Recipe Display Type VarInt ID in the minecraft:recipe_display registry.
Data Varies See #Recipe Display types below.

Recipe Display types

ID Name Data
0 minecraft:crafting_shapeless data
1 minecraft:crafting_shaped data
2 minecraft:furnace data
3 minecraft:stonecutter data
4 minecraft:smithing data
minecraft:crafting_shapeless
Name Type Description
Ingredient Count VarInt Number of elements in the following array.
Ingredients Array of Slot Display
Result Slot Display
Crafting Station Slot Display Crafting station icon to display in the recipe notification.
minecraft:crafting_shaped
Name Type Description
Width VarInt
Height VarInt
Ingredient Count VarInt Number of elements in the following array. Always equal to Width * Height.
Ingredients Array of Slot Display
Result Slot Display
Crafting Station Slot Display Crafting station icon to display in the recipe notification.
minecraft:furnace
Name Type Description
Ingredient Slot Display
Fuel Slot Display
Result Slot Display
Crafting Station Slot Display Crafting station icon to display in the recipe notification.
Cooking Time VarInt Time to smelt in a regular furnace, in ticks.
Experience Float
minecraft:stonecutter
Name Type Description
Ingredient Slot Display
Result Slot Display
Crafting Station Slot Display Crafting station icon to display in the recipe notification.
minecraft:smithing
Name Type Description
Template Slot Display
Base Slot Display
Addition Slot Display
Result Slot Display
Crafting Station Slot Display Crafting station icon to display in the recipe notification.

Slot Display structure

Name Type Description
Slot Display Type VarInt ID in the minecraft:slot_display registry.
Data Varies See #Slot Display types below.

Slot Display types

ID Name Data
0 minecraft:empty no data
1 minecraft:any_fuel no data
2 minecraft:item data
3 minecraft:item_stack data
4 minecraft:tag data
5 minecraft:smithing_trim data
6 minecraft:with_remainder data
7 minecraft:composite data
minecraft:item
Name Type Description
Item Type VarInt ID in the minecraft:item registry.
minecraft:item_stack
Name Type Description
Item Stack Slot
minecraft:tag
Name Type Description
Tag Identifier Tag in the minecraft:item registry. Not prefixed by '#'!.
minecraft:smithing_trim
Name Type Description
Base Slot Display
Material Slot Display
Pattern Slot Display
minecraft:with_remainder
Name Type Description
Ingredient Slot Display
Remainder Slot Display
minecraft:composite
Name Type Description
Option Count VarInt Number of elements in the following array.
Options Array of Slot Display

Handshake

No changes so far.

Status

No changes so far.

Login

No changes so far.

Configuration

No changes so far.

Play

Clientbound

Close Container

This packet is sent from the server to the client when a window is forcibly closed, such as when a chest is destroyed while it's open. The notchian client disregards the provided window ID and closes any active window.

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x12

resource:
container_close 		Play Client Window ID Unsigned Byte VarInt This is the ID of the window that was closed. 0 for inventory.

Set Container Content

The inventory slots

Replaces the contents of a container window. Sent by the server upon initialization of a container window or the player's inventory, and in response to state ID mismatches (see #Click Container).

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x13

resource:
container_set_content 		Play Client Window ID Unsigned Byte VarInt The ID of window which items are being sent for. 0 for player inventory. The client ignores any packets targeting a Window ID other than the current one. However, an exception is made for the player inventory, which may be targeted at any time. (The Notchian server does not appear to utilize this special case.)
State ID VarInt A server-managed sequence number used to avoid desynchronization; see #Click Container.
Count VarInt Number of elements in the following array.
Slot Data Array of Slot
Carried Item Slot Item being dragged with the mouse.

See inventory windows for further information about how slots are indexed. Use Open Screen to open the container on the client.

Set Container Property

This packet is used to inform the client that part of a GUI window should be updated.

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x14

resource:
container_set_data 		Play Client Window ID Unsigned Byte VarInt
Property Short The property to be updated, see below.
Value Short The new value for the property, see below.

The meaning of the Property field depends on the type of the window. The following table shows the known combinations of window type and property, and how the value is to be interpreted.

Window type Property Value
Furnace 0: Fire icon (fuel left) counting from fuel burn time down to 0 (in-game ticks)
1: Maximum fuel burn time fuel burn time or 0 (in-game ticks)
2: Progress arrow counting from 0 to maximum progress (in-game ticks)
3: Maximum progress always 200 on the notchian server
Enchantment Table 0: Level requirement for top enchantment slot The enchantment's xp level requirement
1: Level requirement for middle enchantment slot
2: Level requirement for bottom enchantment slot
3: The enchantment seed Used for drawing the enchantment names (in SGA) clientside. The same seed is used to calculate enchantments, but some of the data isn't sent to the client to prevent easily guessing the entire list (the seed value here is the regular seed bitwise and 0xFFFFFFF0).
4: Enchantment ID shown on mouse hover over top enchantment slot The enchantment id (set to -1 to hide it), see below for values
5: Enchantment ID shown on mouse hover over middle enchantment slot
6: Enchantment ID shown on mouse hover over bottom enchantment slot
7: Enchantment level shown on mouse hover over the top slot The enchantment level (1 = I, 2 = II, 6 = VI, etc.), or -1 if no enchant
8: Enchantment level shown on mouse hover over the middle slot
9: Enchantment level shown on mouse hover over the bottom slot
Beacon 0: Power level 0-4, controls what effect buttons are enabled
1: First potion effect Potion effect ID for the first effect, or -1 if no effect
2: Second potion effect Potion effect ID for the second effect, or -1 if no effect
Anvil 0: Repair cost The repair's cost in xp levels
Brewing Stand 0: Brew time 0 – 400, with 400 making the arrow empty, and 0 making the arrow full
1: Fuel time 0 - 20, with 0 making the arrow empty, and 20 making the arrow full
Stonecutter 0: Selected recipe The index of the selected recipe. -1 means none is selected.
Loom 0: Selected pattern The index of the selected pattern. 0 means none is selected, 0 is also the internal id of the "base" pattern.
Lectern 0: Page number The current page number, starting from 0.

For an enchanting table, the following numerical IDs are used:

Numerical ID Enchantment ID Enchantment Name
0 minecraft:protection Protection
1 minecraft:fire_protection Fire Protection
2 minecraft:feather_falling Feather Falling
3 minecraft:blast_protection Blast Protection
4 minecraft:projectile_protection Projectile Protection
5 minecraft:respiration Respiration
6 minecraft:aqua_affinity Aqua Affinity
7 minecraft:thorns Thorns
8 minecraft:depth_strider Depth Strider
9 minecraft:frost_walker Frost Walker
10 minecraft:binding_curse Curse of Binding
11 minecraft:soul_speed Soul Speed
12 minecraft:swift_sneak Swift Sneak
13 minecraft:sharpness Sharpness
14 minecraft:smite Smite
15 minecraft:bane_of_arthropods Bane of Arthropods
16 minecraft:knockback Knockback
17 minecraft:fire_aspect Fire Aspect
18 minecraft:looting Looting
19 minecraft:sweeping_edge Sweeping Edge
20 minecraft:efficiency Efficiency
21 minecraft:silk_touch Silk Touch
22 minecraft:unbreaking Unbreaking
23 minecraft:fortune Fortune
24 minecraft:power Power
25 minecraft:punch Punch
26 minecraft:flame Flame
27 minecraft:infinity Infinity
28 minecraft:luck_of_the_sea Luck of the Sea
29 minecraft:lure Lure
30 minecraft:loyalty Loyalty
31 minecraft:impaling Impaling
32 minecraft:riptide Riptide
33 minecraft:channeling Channeling
34 minecraft:multishot Multishot
35 minecraft:quick_charge Quick Charge
36 minecraft:piercing Piercing
37 minecraft:density Density
38 minecraft:breach Breach
39 minecraft:wind_burst Wind Burst
40 minecraft:mending Mending
41 minecraft:vanishing_curse Curse of Vanishing

Set Container Slot

Sent by the server when an item in a slot (in a window) is added/removed.

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x15

resource:
container_set_slot 		Play Client Window ID Unsigned Byte VarInt The window which is being updated. 0 for player inventory. The client ignores any packets targeting a Window ID other than the current one; see below for exceptions , unless it is 0 (see below).
State ID VarInt A server-managed sequence number used to avoid desynchronization; see #Click Container.
Slot Short The slot that should be updated.
Slot Data Slot

If Window ID is 0, the hotbar and offhand slots (slots 36 through 45) may be updated even when a different container window is open. (The Notchian server does not appear to utilize this special case.) Updates are also restricted to those slots when the player is looking at a creative inventory tab other than the survival inventory. (The Notchian server does not handle this restriction in any way, leading to MC-242392.)

If Window ID is -1, the item being dragged with the mouse is set. In this case, State ID and Slot are ignored.

If Window ID is -2, any slot in the player's inventory can be updated irrespective of the current container window. In this case, State ID is ignored, and the Notchian server uses a bogus value of 0. Used by the Notchian server to implement the #Pick Item functionality.

When a container window is open, the server never sends updates targeting Window ID 0—all of the window types include slots for the player inventory. The client must automatically apply changes targeting the inventory portion of a container window to the main inventory; the server does not resend them for ID 0 when the window is closed. However, since the armor and offhand slots are only present on ID 0, updates to those slots occurring while a window is open must be deferred by the server until the window's closure.

Set Cooldown

Applies a cooldown period to all items with the given type. Used by the Notchian server with enderpearls. This packet should be sent when the cooldown starts and also when the cooldown ends (to compensate for lag), although the client will end the cooldown automatically. Can be applied to any item, note that interactions still get sent to the server with the item but the client does not play the animation nor attempt to predict results (i.e block placing).

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x17

resource:
cooldown 		Play Client Item ID Cooldown Group VarInt Identifier Numeric ID of the item Group of items to apply a cooldown to.
Cooldown Ticks VarInt Number of ticks to apply a cooldown for, or 0 to clear the cooldown.

Teleport Entity

Warning.png The Mojang-specified name of this packet was changed in 1.21.2 from teleport_entity to entity_position_sync. There is a new teleport_entity, which this document more appropriately calls Synchronize Vehicle Position. That packet has a different function and will lead to confusing results if used in place of this one.

This packet is sent by the server when an entity moves more than 8 blocks.

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x70 0x20

resource:
teleport_entity entity_position_sync 		Play Client Entity ID VarInt
X Double
Y Double
Z Double
Velocity X Double
Velocity Y Double
Velocity Z Double
Yaw Angle Float Rotation on the X axis, in degrees.
Pitch Angle Float Rotation on the Y axis, in degrees.
On Ground Boolean

Explosion

Sent when an explosion occurs (creepers, TNT, and ghast fireballs).

Each block in Records is set to air. Coordinates for each axis in record is int(X) + record.x

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x20 0x21

resource:
explode 		Play Client X Double
Y Double
Z Double
Strength Float If the strength is greater or equal to 2.0, or the block interaction is not 0 (keep), large explosion particles are used. Otherwise, small explosion particles are used.
Record Count VarInt Number of elements in the following array.
Records Array of (Byte, Byte, Byte) Each record is 3 signed bytes long; the 3 bytes are the XYZ (respectively) signed offsets of affected blocks.
Has Player Motion Boolean
Player Motion X Float Optional Double X velocity of the player being pushed by the explosion. Only present if Has Player Motion is true.
Player Motion Y Float Optional Double Y velocity of the player being pushed by the explosion. Only present if Has Player Motion is true.
Player Motion Z Float Optional Double Z velocity of the player being pushed by the explosion. Only present if Has Player Motion is true.
Block Interaction VarInt Enum 0 = keep, 1 = destroy, 2 = destroy_with_decay, 3 = trigger_block.
Small Explosion Particle ID VarInt The particle ID listed in Particles.
Small Explosion Particle Data Varies Particle data as specified in Particles.
Large Explosion Particle ID VarInt The particle ID listed in Particles.
Large Explosion Particle Data Varies Particle data as specified in Particles.
Explosion Sound ID or Sound Event ID in the minecraft:sound_event registry, or an inline definition.

Open Horse Screen

This packet is used exclusively for opening the horse GUI. Open Screen is used for all other GUIs. The client will not open the inventory if the Entity ID does not point to an horse-like animal.

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x23

resource:
horse_screen_open 		Play Client Window ID Unsigned Byte VarInt
Slot count VarInt
Entity ID Int

Login (play)

Huh.png The following information needs to be added to this page:
Although the number of portal cooldown ticks is included in this packet, the whole portal usage process is still dictated entirely by the server. What kind of effect does this value have on the client, if any?

See Protocol Encryption for information on logging in.

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x2B 0x2C

resource:
login 		Play Client Entity ID Int The player's Entity ID (EID).
Is hardcore Boolean
Dimension Count VarInt Size of the following array.
Dimension Names Array of Identifier Identifiers for all dimensions on the server.
Max Players VarInt Was once used by the client to draw the player list, but now is ignored.
View Distance VarInt Render distance (2-32).
Simulation Distance VarInt The distance that the client will process specific things, such as entities.
Reduced Debug Info Boolean If true, a Notchian client shows reduced information on the debug screen. For servers in development, this should almost always be false.
Enable respawn screen Boolean Set to false when the doImmediateRespawn gamerule is true.
Do limited crafting Boolean Whether players can only craft recipes they have already unlocked. Currently unused by the client.
Dimension Type VarInt The ID of the type of dimension in the minecraft:dimension_type registry, defined by the Registry Data packet.
Dimension Name Identifier Name of the dimension being spawned into.
Hashed seed Long First 8 bytes of the SHA-256 hash of the world's seed. Used client side for biome noise
Game mode Unsigned Byte 0: Survival, 1: Creative, 2: Adventure, 3: Spectator.
Previous Game mode Byte -1: Undefined (null), 0: Survival, 1: Creative, 2: Adventure, 3: Spectator. The previous game mode. Vanilla client uses this for the debug (F3 + N & F3 + F4) game mode switch. (More information needed)
Is Debug Boolean True if the world is a debug mode world; debug mode worlds cannot be modified and have predefined blocks.
Is Flat Boolean True if the world is a superflat world; flat worlds have different void fog and a horizon at y=0 instead of y=63.
Has death location Boolean If true, then the next two fields are present.
Death dimension name Optional Identifier Name of the dimension the player died in.
Death location Optional Position The location that the player died at.
Portal cooldown VarInt The number of ticks until the player can use the portal again.
Sea level VarInt
Enforces Secure Chat Boolean

Move Minecart Along Track

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x31

resource:
move_minecart_along_track 		Play Client Entity ID VarInt
Step Count VarInt Number of elements in the following array.
Steps X Array Double
Y Double
Z Double
Velocity X Double
Velocity Y Double
Velocity Z Double
Yaw Angle
Pitch Angle
Weight Float

Player Info Update

Sent by the server to update the user list (<tab> in the client).

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x3E 0x40

resource:
player_info_update 		Play Client Actions Byte Determines what actions are present.
Number Of Players VarInt Number of elements in the following array.
Players UUID Array UUID The player UUID
Player Actions Array of Player Actions The length of this array is determined by the number of Player Actions that give a non-zero value when applying its mask to the actions flag. For example given the decimal number 5, binary 00000101. The masks 0x01 and 0x04 would return a non-zero value, meaning the Player Actions array would include two actions: Add Player and Update Game Mode.
Player Actions
Action Mask Field Name Type Notes
Add Player 0x01 Name String (16)
Number Of Properties VarInt Number of elements in the following array.
Property Name Array String (32767)
Value String (32767)
Is Signed Boolean
Signature Optional String (32767) Only if Is Signed is true.
Initialize Chat 0x02 Has Signature Data Boolean
Chat session ID UUID Only sent if Has Signature Data is true.
Public key expiry time Long Key expiry time, as a UNIX timestamp in milliseconds. Only sent if Has Signature Data is true.
Encoded public key size VarInt Size of the following array. Only sent if Has Signature Data is true. Maximum length is 512 bytes.
Encoded public key Byte Array (512) The player's public key, in bytes. Only sent if Has Signature Data is true.
Public key signature size VarInt Size of the following array. Only sent if Has Signature Data is true. Maximum length is 4096 bytes.
Public key signature Byte Array (4096) The public key's digital signature. Only sent if Has Signature Data is true.
Update Game Mode 0x04 Game Mode VarInt
Update Listed 0x08 Listed Boolean Whether the player should be listed on the player list.
Update Latency 0x10 Ping VarInt Measured in milliseconds.
Update Display Name 0x20 Has Display Name Boolean
Display Name Optional Text Component Only sent if Has Display Name is true.
Update List Priority 0x40 Priority VarInt See below.

The properties included in this packet are the same as in Login Success, for the current player.

Ping values correspond with icons in the following way:

  • A ping that negative (i.e. not known to the server yet) will result in the no connection icon.
  • A ping under 150 milliseconds will result in 5 bars
  • A ping under 300 milliseconds will result in 4 bars
  • A ping under 600 milliseconds will result in 3 bars
  • A ping under 1000 milliseconds (1 second) will result in 2 bars
  • A ping greater than or equal to 1 second will result in 1 bar.

The order of players in the player list is determined as follows:

  • Players with higher priorities are sorted before those with lower priorities.
  • Among players of equal priorities, spectators are sorted after non-spectators.
  • Within each of those groups, players are sorted into teams. The teams are ordered case-sensitively by team name in ascending order. Players with no team are listed first.
  • The players of each team (and non-team) are sorted case-insensitively by name in ascending order.

Synchronize Player Position

Teleports the client, e.g. during login, when using an ender pearl, in response to invalid move packets, etc.

Due to latency, the server may receive outdated movement packets sent before the client was aware of the teleport. To account for this, the server ignores all movement packets from the client until a Confirm Teleportation packet with an ID matching the one sent in the teleport packet is received.

Yaw is measured in degrees, and does not follow classical trigonometry rules. The unit circle of yaw on the XZ-plane starts at (0, 1) and turns counterclockwise, with 90 at (-1, 0), 180 at (0, -1) and 270 at (1, 0). Additionally, yaw is not clamped to between 0 and 360 degrees; any number is valid, including negative numbers and numbers greater than 360 (see MC-90097).

Pitch is measured in degrees, where 0 is looking straight ahead, -90 is looking straight up, and 90 is looking straight down.

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x40 0x42

resource:
player_position 		Play Client Teleport ID VarInt Client should confirm this packet with Confirm Teleportation containing the same Teleport ID.
X Double Absolute or relative position, depending on Flags.
Y Double Absolute or relative position, depending on Flags.
Z Double Absolute or relative position, depending on Flags.
Velocity X Double
Velocity Y Double
Velocity Z Double
Yaw Float Absolute or relative rotation on the X axis, in degrees.
Pitch Float Absolute or relative rotation on the Y axis, in degrees.
Flags Byte Teleport Flags Reference the Flags table below. When the value of the this byte masked is zero the field is absolute, otherwise relative.
Teleport ID VarInt Client should confirm this packet with Confirm Teleportation containing the same Teleport ID.

Player Rotation

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x43

resource:
player_rotation 		Play Client Yaw Float Rotation on the X axis, in degrees.
Pitch Float Rotation on the Y axis, in degrees.

Place Ghost Recipe

Response to the serverbound packet (Place Recipe), with the same recipe ID. Appears to be used to notify the UI.

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x37 0x39

resource:
place_ghost_recipe 		Play Client Window ID Byte VarInt
Recipe Identifier A recipe ID.
Recipe Display Recipe Display

Recipe Book Add

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x44

resource:
recipe_book_add 		Play Client Recipe Count VarInt Number of elements in the following array.
Recipes Recipe ID Array VarInt ID to assign to the recipe.
Display Recipe Display
Group ID VarInt
Category ID VarInt ID in the minecraft:recipe_book_category registry.
Has Ingredients Boolean
Ingredient Count Optional VarInt Number of elements in the following array. Only present if Has Ingredients is true.
Ingredients Optional Array of ID Set IDs in the minecraft:item registry, or an inline definition. Only present if Has Ingredients is true.
Flags Byte 0x01: show notification; 0x02: highlight as new
Replace Boolean Replace or Add to known recipes

Recipe Book Remove

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x45

resource:
recipe_book_remove 		Play Client Recipe Count VarInt Number of elements in the following array.
Recipes Array of VarInt IDs of recipes to remove.

Recipe Book Settings

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x46

resource:
recipe_book_settings 		Play Client Crafting Recipe Book Open Boolean If true, then the crafting recipe book will be open when the player opens its inventory.
Crafting Recipe Book Filter Active Boolean If true, then the filtering option is active when the players opens its inventory.
Smelting Recipe Book Open Boolean If true, then the smelting recipe book will be open when the player opens its inventory.
Smelting Recipe Book Filter Active Boolean If true, then the filtering option is active when the players opens its inventory.
Blast Furnace Recipe Book Open Boolean If true, then the blast furnace recipe book will be open when the player opens its inventory.
Blast Furnace Recipe Book Filter Active Boolean If true, then the filtering option is active when the players opens its inventory.
Smoker Recipe Book Open Boolean If true, then the smoker recipe book will be open when the player opens its inventory.
Smoker Recipe Book Filter Active Boolean If true, then the filtering option is active when the players opens its inventory.

Respawn

Huh.png The following information needs to be added to this page:
Although the number of portal cooldown ticks is included in this packet, the whole portal usage process is still dictated entirely by the server. What kind of effect does this value have on the client, if any?

To change the player's dimension (overworld/nether/end), send them a respawn packet with the appropriate dimension, followed by prechunks/chunks for the new dimension, and finally a position and look packet. You do not need to unload chunks, the client will do it automatically.

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x47 0x4C

resource:
respawn 		Play Client Dimension Type VarInt The ID of type of dimension in the minecraft:dimension_type registry, defined by the Registry Data packet.
Dimension Name Identifier Name of the dimension being spawned into.
Hashed seed Long First 8 bytes of the SHA-256 hash of the world's seed. Used client side for biome noise
Game mode Unsigned Byte 0: Survival, 1: Creative, 2: Adventure, 3: Spectator.
Previous Game mode Byte -1: Undefined (null), 0: Survival, 1: Creative, 2: Adventure, 3: Spectator. The previous game mode. Vanilla client uses this for the debug (F3 + N & F3 + F4) game mode switch. (More information needed)
Is Debug Boolean True if the world is a debug mode world; debug mode worlds cannot be modified and have predefined blocks.
Is Flat Boolean True if the world is a superflat world; flat worlds have different void fog and a horizon at y=0 instead of y=63.
Has death location Boolean If true, then the next two fields are present.
Death dimension Name Optional Identifier Name of the dimension the player died in.
Death location Optional Position The location that the player died at.
Portal cooldown VarInt The number of ticks until the player can use the portal again.
Sea level VarInt
Data kept Byte Bit mask. 0x01: Keep attributes, 0x02: Keep metadata. Tells which data should be kept on the client side once the player has respawned.

In the Notchian implementation, this is context dependent:

  • normal respawns (after death) keep no data;
  • exiting the end poem/credits keeps the attributes;
  • other dimension changes (portals or teleports) keep all data.

Warning.png Avoid changing player's dimension to same dimension they were already in unless they are dead. If you change the dimension to one they are already in, weird bugs can occur, such as the player being unable to attack other players in new world (until they die and respawn).

Before 1.16, if you must respawn a player in the same dimension without killing them, send two respawn packets, one to a different world and then another to the world you want. You do not need to complete the first respawn; it only matters that you send two packets.

Set Cursor Item

Packet ID State Bound To Field Name Field Type Notes
0x5A Play Client Slot Data Slot

Update Time

Time is based on ticks, where 20 ticks happen every second. There are 24000 ticks in a day, making Minecraft days exactly 20 minutes long.

The time of day is based on the timestamp modulo 24000. 0 is sunrise, 6000 is noon, 12000 is sunset, and 18000 is midnight.

The default SMP server increments the time by 20 every second.

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x64 0x6B

resource:
set_time 		Play Client World Age 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.
Time of day increasing Boolean If true, the client should automatically advance the time of day according to its ticking rate.

Set Player Inventory Slot

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x66

resource:
set_player_inventory 		Play Client Slot VarInt
Slot Data Slot

Synchronize Vehicle Position

Teleports the entity on the client without changing the reference point of movement deltas in future Update Entity Position packets. Seems to be used to make relative adjustments to vehicle positions; more information needed.

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x77

resource:
teleport_entity 		Play Client Entity ID VarInt
X Double
Y Double
Z Double
Velocity X Double
Velocity Y Double
Velocity Z Double
Yaw Float Rotation on the Y axis, in degrees.
Pitch Float Rotation on the Y axis, in degrees.
Flags Teleport Flags
On Ground Boolean

Update Recipes

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x77 0x7e

resource:
update_recipes 		Play Client Num Recipes VarInt Number of elements in the following array.
Recipe Recipe ID Array Identifier
Type ID VarInt Enum The recipe type, see below.
Data Varies Additional data for the recipe.
Property Set Count VarInt Number of elements in the following array.
Property Sets Property Set ID Array Identifier
Item Count VarInt Number of elements in the following array.
Items Array of VarInt IDs in the minecraft:item registry.
Stonecutter Recipe Count VarInt Number of elements in the following array.
Stonecutter Recipes Ingredients Array ID Set
Slot Display Slot Display

Recipe types:

ID Type Description Data
0 minecraft:crafting_shaped Shaped crafting recipe. All items must be present in the same pattern (which may be flipped horizontally or translated). As follows:
Name Type Description
Group String (32767) Used to group similar recipes together in the recipe book. Tag is present in recipe JSON.
Category VarInt Enum Building = 0, Redstone = 1, Equipment = 2, Misc = 3
Width VarInt
Height VarInt
Ingredients Array of Ingredient Length is width * height. Indexed by x + (y * width).
Result Slot
Show notification Boolean Show a toast when the recipe is added.
1 minecraft:crafting_shapeless Shapeless crafting recipe. All items in the ingredient list must be present, but in any order/slot. As follows:
Name Type Description
Group String (32767) Used to group similar recipes together in the recipe book. Tag is present in recipe JSON.
Category VarInt Enum Building = 0, Redstone = 1, Equipment = 2, Misc = 3
Ingredient count VarInt Number of elements in the following array.
Ingredients Array of Ingredient.
Result Slot
2 minecraft:crafting_special_armordye Recipe for dying leather armor As follows:
Name Type Description
Category VarInt Enum Building = 0, Redstone = 1, Equipment = 2, Misc = 3
3 minecraft:crafting_special_bookcloning Recipe for copying contents of written books
4 minecraft:crafting_special_mapcloning Recipe for copying maps
5 minecraft:crafting_special_mapextending Recipe for adding paper to maps
6 minecraft:crafting_special_firework_rocket Recipe for making firework rockets
7 minecraft:crafting_special_firework_star Recipe for making firework stars
8 minecraft:crafting_special_firework_star_fade Recipe for making firework stars fade between multiple colors
9 minecraft:crafting_special_tippedarrow Recipe for crafting tipped arrows
10 minecraft:crafting_special_bannerduplicate Recipe for copying banner patterns
11 minecraft:crafting_special_shielddecoration Recipe for applying a banner's pattern to a shield
12 minecraft:crafting_special_shulkerboxcoloring Recipe for recoloring a shulker box
13 minecraft:crafting_special_suspiciousstew Recipe for crafting suspicious stews
14 minecraft:crafting_special_repairitem Recipe for repairing items via crafting
22 minecraft:crafting_decorated_pot Recipe for crafting decorated pots
15 minecraft:smelting Smelting recipe As follows:
Name Type Description
Group String (32767) Used to group similar recipes together in the recipe book.
Category VarInt Enum Food = 0, Blocks = 1, Misc = 2
Ingredient Ingredient
Result Slot
Experience Float
Cooking time VarInt
16 minecraft:blasting Blast furnace recipe
17 minecraft:smoking Smoker recipe
18 minecraft:campfire_cooking Campfire recipe
19 minecraft:stonecutting Stonecutter recipe As follows:
Name Type Description
Group String (32767) Used to group similar recipes together in the recipe book. Tag is present in recipe JSON.
Ingredient Ingredient
Result Slot
20 minecraft:smithing_transform Recipe for smithing netherite gear As follows:
Name Type Description
Template Ingredient The smithing template.
Base Ingredient The base item.
Addition Ingredient The additional ingredient.
Result Slot
21 minecraft:smithing_trim Recipe for applying armor trims As follows:
Name Type Description
Template Ingredient The smithing template.
Base Ingredient The base item.
Addition Ingredient The additional ingredient.

Ingredient is defined as:

Name Type Description
Count VarInt Number of elements in the following array.
Items Array of Slot Any item in this array may be used for the recipe. The count of each item should be 1.

Serverbound

Bundle Item Selected

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x02

resource:
bundle_item_selected 		Play Server Slot of Bundle VarInt
Slot in Bundle VarInt

Client Tick End

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x0B

resource:
client_tick_end 		Play Server no fields

Click Container

This packet is sent by the client when the player clicks on a slot in a window.

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x0E 0x10

resource:
container_click 		Play Server Window ID Unsigned Byte VarInt The ID of the window which was clicked. 0 for player inventory. The server ignores any packets targeting a Window ID other than the current one, including ignoring 0 when any other window is open.
State ID VarInt The last received State ID from either a Set Container Slot or a Set Container Content packet.
Slot Short The clicked slot number, see below.
Button Byte The button used in the click, see below.
Mode VarInt Enum Inventory operation mode, see below.
Length of the array VarInt Maximum value for Notchian server is 128 slots.
Array of changed slots Slot number Array (128) Short
Slot data Slot New data for this slot, in the client's opinion; see below.
Carried item Slot Item carried by the cursor. Has to be empty (item ID = -1) for drop mode, otherwise nothing will happen.

See Inventory for further information about how slots are indexed.

After performing the action, the server compares the results to the slot change information included in the packet, as applied on top of the server's view of the container's state prior to the action. For any slots that do not match, it sends Set Container Slot packets containing the correct results. If State ID does not match the last ID sent by the server, it will instead send a full Set Container Content to resynchronize the client.

When right-clicking on a stack of items, half the stack will be picked up and half left in the slot. If the stack is an odd number, the half left in the slot will be smaller of the amounts.

The distinct type of click performed by the client is determined by the combination of the Mode and Button fields.

Mode Button Slot Trigger
0 0 Normal Left mouse click
1 Normal Right mouse click
0 -999 Left click outside inventory (drop cursor stack)
1 -999 Right click outside inventory (drop cursor single item)
1 0 Normal Shift + left mouse click
1 Normal Shift + right mouse click (identical behavior)
2 0 Normal Number key 1
1 Normal Number key 2
2 Normal Number key 3
⋮ ⋮ ⋮
8 Normal Number key 9
⋮ ⋮ Button is used as the slot index (impossible in vanilla clients)
40 Normal Offhand swap key F
3 2 Normal Middle click, only defined for creative players in non-player inventories.
4 0 Normal* Drop key (Q) (* Clicked item is always empty)
1 Normal* Control + Drop key (Q) (* Clicked item is always empty)
5 0 -999 Starting left mouse drag
4 -999 Starting right mouse drag
8 -999 Starting middle mouse drag, only defined for creative players in non-player inventories.
1 Normal Add slot for left-mouse drag
5 Normal Add slot for right-mouse drag
9 Normal Add slot for middle-mouse drag, only defined for creative players in non-player inventories.
2 -999 Ending left mouse drag
6 -999 Ending right mouse drag
10 -999 Ending middle mouse drag, only defined for creative players in non-player inventories.
6 0 Normal Double click
1 Normal Pickup all but check items in reverse order (impossible in vanilla clients)

Starting from version 1.5, “painting mode” is available for use in inventory windows. It is done by picking up stack of something (more than 1 item), then holding mouse button (left, right or middle) and dragging held stack over empty (or same type in case of right button) slots. In that case client sends the following to server after mouse button release (omitting first pickup packet which is sent as usual):

  1. packet with mode 5, slot -999, button (0 for left | 4 for right);
  2. packet for every slot painted on, mode is still 5, button (1 | 5);
  3. packet with mode 5, slot -999, button (2 | 6);

If any of the painting packets other than the “progress” ones are sent out of order (for example, a start, some slots, then another start; or a left-click in the middle) the painting status will be reset.

Close Container

This packet is sent by the client when closing a window.

Notchian clients send a Close Window packet with Window ID 0 to close their inventory even though there is never an Open Screen packet for the inventory.

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x0F 0x11

resource:
container_close 		Play Server Window ID Unsigned Byte VarInt This is the ID of the window that was closed. 0 for player inventory.

Edit Book

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x14 0x16

resource:
edit_book 		Play Server Slot VarInt The hotbar slot where the written book is located
Count VarInt Number of elements in the following array. Maximum array size is 200 100.
Entries Array (200 100) of String (8192 1024) Text from each page. Maximum string length is 8192 1024 chars.
Has title Boolean If true, the next field is present. true if book is being signed, false if book is being edited.
Title Optional String (128 32) Title of book.

Set Player Position

Updates the player's XYZ position on the server.

If the player is in a vehicle, the position is ignored (but in case of Set Player Position and Rotation, the rotation is still used as normal). No validation steps other than value range clamping are performed in this case.

If the player is sleeping, the position (or rotation) is not changed, and a Synchronize Player Position is sent if the received position deviated from the server's view by more than a meter.

The Notchian server silently clamps the x and z coordinates between -30,000,000 and 30,000,000, and the y coordinate between -20,000,000 and 20,000,000. A similar condition has historically caused a kick for "Illegal position"; this is no longer the case. However, infinite or NaN coordinates (or angles) still result in a kick for multiplayer.disconnect.invalid_player_movement.

As of 1.20.6, checking for moving too fast is achieved like this (sic):

  • Each server tick, the player's current position is stored.
  • When the player moves, the offset from the stored position to the requested position is computed (Δx, Δy, Δz).
  • The requested movement distance squared is computed as Δx² + Δy² + Δz².
  • The baseline expected movement distance squared is computed based on the player's server-side velocity as Vx² + Vy² + Vz². The player's server-side velocity is a somewhat ill-defined quantity that includes among other things gravity, jump velocity and knockback, but not regular horizontal movement. A proper description would bring much of Minecraft's physics engine with it. It is accessible as the Motion NBT tag on the player entity.
  • The maximum permitted movement distance squared is computed as 100 (300 if the player is using an elytra), multiplied by the number of movement packets received since the last tick, including this one, unless that value is greater than 5, in which case no multiplier is applied.
  • If the requested movement distance squared minus the baseline distance squared is more than the maximum squared, the player is moving too fast.

If the player is moving too fast, it is logged that "<player> moved too quickly! " followed by the change in x, y, and z, and the player is teleported back to their current (before this packet) server-side position.

Checking for block collisions is achieved like this:

  • A temporary collision-checked move of the player is attempted from its current position to the requested one.
  • The offset from the resulting position to the requested position is computed. If the absolute value of the offset on the y axis is less than 0.5, it (only the y component) is rounded down to 0.
  • If the magnitude of the offset is greater than 0.25 and the player isn't in creative or spectator mode, it is logged that "<player> moved wrongly!", and the player is teleported back to their current (before this packet) server-side position.
  • In addition, if the player's hitbox stationary at the requested position would intersect with a block, and they aren't in spectator mode, they are teleported back without a log message.

Checking for illegal flight is achieved like this:

  • When a movement packet is received, a flag indicating whether or not the player is floating mid-air is updated. The flag is set if the move test described above detected no collision below the player and the y component of the offset from the player's current position to the requested one is greater than -0.5, unless any of various conditions permitting flight (creative mode, elytra, levitation effect, etc., but not jumping) are met.
  • Each server tick, it is checked if the flag has been set for more than 80 consecutive ticks. If so, and the player isn't currently sleeping, dead or riding a vehicle, they are kicked for multiplayer.disconnect.flying.
Packet ID State Bound To Field Name Field Type Notes
protocol:
0x1A 0x1C

resource:
move_player_pos 		Play Server X Double Absolute position.
Feet Y Double Absolute feet position, normally Head Y - 1.62.
Z Double Absolute position.
On Ground Boolean True if the client is on the ground, false otherwise.
Flags Byte Bit field: 0x01: on ground, 0x02: pushing against wall.

Set Player Position and Rotation

A combination of Move Player Rotation and Move Player Position.

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x1B 0x1D

resource:
move_player_pos_rot 		Play Server X Double Absolute position.
Feet Y Double Absolute feet position, normally Head Y - 1.62.
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 Boolean True if the client is on the ground, false otherwise.
Flags Byte Bit field: 0x01: on ground, 0x02: pushing against wall.

Set Player Rotation

The unit circle for yaw
The unit circle of yaw, redrawn

Updates the direction the player is looking in.

Yaw is measured in degrees, and does not follow classical trigonometry rules. The unit circle of yaw on the XZ-plane starts at (0, 1) and turns counterclockwise, with 90 at (-1, 0), 180 at (0,-1) and 270 at (1, 0). Additionally, yaw is not clamped to between 0 and 360 degrees; any number is valid, including negative numbers and numbers greater than 360.

Pitch is measured in degrees, where 0 is looking straight ahead, -90 is looking straight up, and 90 is looking straight down.

The yaw and pitch of player (in degrees), standing at point (x0, y0, z0) and looking towards point (x, y, z) can be calculated with: 

dx = x-x0
dy = y-y0
dz = z-z0
r = sqrt( dx*dx + dy*dy + dz*dz )
yaw = -atan2(dx,dz)/PI*180
if yaw < 0 then
    yaw = 360 + yaw
pitch = -arcsin(dy/r)/PI*180

You can get a unit vector from a given yaw/pitch via: 

x = -cos(pitch) * sin(yaw)
y = -sin(pitch)
z =  cos(pitch) * cos(yaw)
Packet ID State Bound To Field Name Field Type Notes
protocol:
0x1C 0x1E

resource:
move_player_rot 		Play Server Yaw Float Absolute rotation on the X Axis, in degrees.
Pitch Float Absolute rotation on the Y Axis, in degrees.
On Ground Boolean True if the client is on the ground, false otherwise.
Flags Byte Bit field: 0x01: on ground, 0x02: pushing against wall.

Set Player On Ground Movement Flags

This packet as well as Set Player Position, Set Player Rotation, and Set Player Position and Rotation are called the “serverbound movement packets”. Vanilla clients will send Move Player Position once every 20 ticks even for a stationary player.

This packet is used to indicate whether the player is on ground (walking/swimming), or airborne (jumping/falling).

When dropping from sufficient height, fall damage is applied when this state goes from false to true. The amount of damage applied is based on the point where it last changed from true to false. Note that there are several movement related packets containing this state.

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x1D 0x1F

resource:
move_player_status_only 		Play Server On Ground Boolean True if the client is on the ground, false otherwise.
Flags Byte Bit field: 0x01: on ground, 0x02: pushing against wall.

Place Recipe

This packet is sent when a player clicks a recipe in the crafting book that is craftable (white border).

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x22 0x24

resource:
place_recipe 		Play Server Window ID Byte
Recipe ID Identifier VarInt A recipe ID. ID of recipe previously defined in Recipe Book Add.
Make all Boolean Affects the amount of items processed; true if shift is down when clicked.

Player Input

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x26 0x28

resource:
player_input 		Play Server Sideways Float Positive to the left of the player.
Forward Float Positive forward.
Flags Unsigned Byte Bit mask. 0x1: jump, 0x2: unmount. ; see below.

The flags are as follows:

Hex Mask Field
0x01 Forward
0x02 Backward
0x04 Left
0x08 Right
0x10 Jump
0x20 Sneak
0x40 Sprint

Set Seen Recipe

Sent when recipe is first seen in recipe book. Replaces Recipe Book Data, type 0.

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x29 0x2B

resource:
recipe_book_seen_recipe 		Play Server Recipe ID Identifier VarInt ID of recipe previously defined in Recipe Book Add.

Use Item On

Packet ID State Bound To Field Name Field Type Notes
protocol:
0x38 0x3A

resource:
use_item_on 		Play Server Hand VarInt Enum The hand from which the block is placed; 0: main hand, 1: off hand.
Location Position Block position.
Face VarInt Enum The face on which the block is placed (as documented at Player Action).
Cursor Position X Float The position of the crosshair on the block, from 0 to 1 increasing from west to east.
Cursor Position Y Float The position of the crosshair on the block, from 0 to 1 increasing from bottom to top.
Cursor Position Z Float The position of the crosshair on the block, from 0 to 1 increasing from north to south.
Inside block Boolean True when the player's head is inside of a block.
World border hit Boolean Seems to always be false, even when interacting with blocks around or outside the world border, or while the player is outside the border.
Sequence VarInt Block change sequence number (see #Acknowledge Block Change).

Upon placing a block, this packet is sent once.

The Cursor Position X/Y/Z fields (also known as in-block coordinates) are calculated using raytracing. The unit corresponds to sixteen pixels in the default resource pack. For example, let's say a slab is being placed against the south face of a full block. The Cursor Position X will be higher if the player was pointing near the right (east) edge of the face, lower if pointing near the left. The Cursor Position Y will be used to determine whether it will appear as a bottom slab (values 0.0–0.5) or as a top slab (values 0.5-1.0). The Cursor Position Z should be 1.0 since the player was looking at the southernmost part of the block.

Inside block is true when a player's head (specifically eyes) are inside of a block's collision. In 1.13 and later versions, collision is rather complicated and individual blocks can have multiple collision boxes. For instance, a ring of vines has a non-colliding hole in the middle. This value is only true when the player is directly in the box. In practice, though, this value is only used by scaffolding to place in front of the player when sneaking inside of it (other blocks will place behind when you intersect with them -- try with glass for instance).

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