Difference between revisions of "Pre-release protocol"

From wiki.vg
Jump to navigation Jump to search
(1.12)
m (→‎Join Game: Remove burger note; burger has been fixed and the current documentation seems right)
 
(528 intermediate revisions by 28 users not shown)
Line 1: Line 1:
This page documents the changes from the [[Protocol|last stable Minecraft release]] (currently [[Protocol version numbers|1.11.2, protocol 316]]) to the current pre-release (currently [[Protocol version numbers|1.12, protocol 335]]). Note that this page contains bleeding-edge information that may not be completely or correctly documented.
+
This page documents the changes from the [[Protocol|last stable Minecraft release]] (currently [[Protocol version numbers|1.15.2, protocol 578]]) to the current pre-release (currently [[Protocol version numbers|20w21a, protocol 718]]). Note that this page contains bleeding-edge information that may not be completely or correctly documented.
  
 
One who wishes to commandeer the merging of this into [[Protocol]] when an update is made must be sure to respect any changes that may have occurred to the respective packets there.
 
One who wishes to commandeer the merging of this into [[Protocol]] when an update is made must be sure to respect any changes that may have occurred to the respective packets there.
Line 9: Line 9:
 
=== Data types ===
 
=== Data types ===
  
No changes so far.
+
The UUID type is now also sometimes encoded by the Notchian server as an array of four 32-bit integers, from most significant to least significant (matching the new format used on entity NBT).  This representation is identical to using 16 bytes, two 64-bit integers, or one 128-bit integers.
  
 
=== Packets ===
 
=== Packets ===
Line 18: Line 18:
 
  !colspan="2"| Documentation
 
  !colspan="2"| Documentation
 
  |-
 
  |-
!colspan="4"| Handshaking serverbound
+
!colspan="4"| Handshaking serverbound
{{PacketList|0x00|Handshake}}
+
{{PacketList|0x00|Handshake}}
 
  |-
 
  |-
!colspan="4"| Play clientbound
+
!colspan="4"| Play clientbound
{{PacketList|{{Change|0x28|0x25}}|Entity|pre=unchanged}}
+
{{PacketList|0x0F|Chat Message (clientbound)}}
{{PacketList|{{Change|0x25|0x26}}|Entity Relative Move|pre=unchanged}}
+
{{PacketList|0x22|Chunk Data}}
{{PacketList|{{Change|0x26|0x27}}|Entity Look And Relative Move|pre=unchanged}}
+
{{PacketList|0x26|Join Game}}
{{PacketList|{{Change|0x27|0x28}}|Entity Look|pre=unchanged}}
+
{{PacketList|0x3B|Respawn}}
{{PacketList|0x30|Unlock Recipes|rel=added}}
+
{{PacketList|{{Change|0x4E|0x43}}|Spawn Position|pre=unchanged}}
{{PacketList|{{Change|0x30|0x31}}|Destroy Entities|pre=unchanged}}
+
{{PacketList|{{Change|0x43|0x44}}|Display Scoreboard|pre=unchanged}}
{{PacketList|{{Change|0x31|0x32}}|Remove Entity Effect|pre=unchanged}}
+
{{PacketList|{{Change|0x44|0x45}}|Entity Metadata|pre=unchanged}}
{{PacketList|{{Change|0x32|0x33}}|Resource Pack Send|pre=unchanged}}
+
{{PacketList|{{Change|0x45|0x46}}|Attach Entity|pre=unchanged}}
{{PacketList|{{Change|0x33|0x34}}|Respawn|pre=unchanged}}
+
{{PacketList|{{Change|0x46|0x47}}|Entity Velocity|pre=unchanged}}
{{PacketList|{{Change|0x34|0x35}}|Entity Head Look|pre=unchanged}}
+
{{PacketList|{{Change|0x47|0x48}}|Entity Equipment|pre=unchanged}}
{{PacketList|0x36|Advancement Progress|rel=added}}
+
{{PacketList|{{Change|0x48|0x49}}|Set Experience|pre=unchanged}}
{{PacketList|{{Change|0x35|0x37}}|World Border|pre=unchanged}}
+
{{PacketList|{{Change|0x49|0x4A}}|Update Health|pre=unchanged}}
{{PacketList|{{Change|0x36|0x38}}|Camera|pre=unchanged}}
+
{{PacketList|{{Change|0x4A|0x4B}}|Scoreboard Objective|pre=unchanged}}
{{PacketList|{{Change|0x37|0x39}}|Held Item Change (clientbound)|pre=unchanged}}
+
{{PacketList|{{Change|0x4B|0x4C}}|Set Passengers|pre=unchanged}}
{{PacketList|{{Change|0x38|0x3A}}|Display Scoreboard|pre=unchanged}}
+
{{PacketList|{{Change|0x4C|0x4D}}|Teams|pre=unchanged}}
{{PacketList|{{Change|0x39|0x3B}}|Entity Metadata|pre=unchanged}}
+
{{PacketList|{{Change|0x4D|0x4E}}|Update Score|pre=unchanged}}
{{PacketList|{{Change|0x3A|0x3C}}|Attach Entity|pre=unchanged}}
+
{{PacketList|0x59|Entity Properties}}
{{PacketList|{{Change|0x3B|0x3D}}|Entity Velocity|pre=unchanged}}
 
{{PacketList|{{Change|0x3C|0x3E}}|Entity Equipment|pre=unchanged}}
 
{{PacketList|{{Change|0x3D|0x3F}}|Set Experience|pre=unchanged}}
 
{{PacketList|{{Change|0x3E|0x40}}|Update Health|pre=unchanged}}
 
{{PacketList|{{Change|0x3F|0x41}}|Scoreboard Objective|pre=unchanged}}
 
{{PacketList|{{Change|0x40|0x42}}|Set Passengers|pre=unchanged}}
 
{{PacketList|{{Change|0x41|0x43}}|Teams|pre=unchanged}}
 
{{PacketList|{{Change|0x42|0x44}}|Update Score|pre=unchanged}}
 
{{PacketList|{{Change|0x43|0x45}}|Spawn Position|pre=unchanged}}
 
{{PacketList|{{Change|0x44|0x46}}|Time Update|pre=unchanged}}
 
{{PacketList|{{Change|0x45|0x47}}|Title|pre=unchanged}}
 
{{PacketList|{{Change|0x46|0x48}}|Sound Effect|pre=unchanged}}
 
{{PacketList|{{Change|0x47|0x49}}|Player List Header And Footer|pre=unchanged}}
 
{{PacketList|{{Change|0x48|0x4A}}|Collect Item|pre=unchanged}}
 
{{PacketList|{{Change|0x49|0x4B}}|Entity Teleport|pre=unchanged}}
 
{{PacketList|0x4C|Advancements|rel=added}}
 
{{PacketList|{{Change|0x4A|0x4D}}|Entity Properties|pre=unchanged}}
 
{{PacketList|{{Change|0x4B|0x4E}}|Entity Effect|pre=unchanged}}
 
 
  |-
 
  |-
!colspan="4"| Play serverbound
+
!colspan="4"| Play serverbound
{{PacketList|0x01|Prepare Crafting Grid|rel=added}}
+
{{PacketList|0x0F|Generate Structure|rel=added}}
{{PacketList|{{Change|0x01|0x02}}|Tab-Complete (serverbound)|pre=unchanged}}
+
{{PacketList|{{change|0x0F|0x10}}|Keep Alive (serverbound)|pre=unchanged}}
{{PacketList|{{Change|0x02|0x03}}|Chat Message (serverbound)|pre=unchanged}}
+
{{PacketList|{{change|0x10|0x11}}|Lock Difficulty|pre=unchanged}}
{{PacketList|{{Change|0x03|0x04}}|Client Status|pre=unchanged}}
+
{{PacketList|{{change|0x11|0x12}}|Player Position|pre=unchanged}}
{{PacketList|{{Change|0x04|0x05}}|Client Settings}}
+
{{PacketList|{{change|0x12|0x13}}|Player Position And Rotation (serverbound)|pre=unchanged}}
{{PacketList|{{Change|0x05|0x06}}|Confirm Transaction (serverbound)|pre=unchanged}}
+
{{PacketList|{{change|0x13|0x14}}|Player Rotation|pre=unchanged}}
{{PacketList|{{Change|0x06|0x07}}|Enchant Item|pre=unchanged}}
+
{{PacketList|{{change|0x14|0x15}}|Player Movement|pre=unchanged}}
{{PacketList|{{Change|0x07|0x08}}|Click Window|pre=unchanged}}
+
{{PacketList|{{change|0x15|0x16}}|Vehicle Move (serverbound)|pre=unchanged}}
{{PacketList|{{Change|0x08|0x09}}|Close Window (serverbound)|pre=unchanged}}
+
{{PacketList|{{change|0x16|0x17}}|Steer Boat|pre=unchanged}}
{{PacketList|{{Change|0x09|0x0A}}|Plugin Message (serverbound)|pre=unchanged}}
+
{{PacketList|{{change|0x17|0x18}}|Pick Item|pre=unchanged}}
{{PacketList|{{Change|0x0A|0x0B}}|Use Entity|pre=unchanged}}
+
{{PacketList|{{change|0x18|0x19}}|Craft Recipe Request|pre=unchanged}}
{{PacketList|{{Change|0x0B|0x0C}}|Keep Alive (serverbound)|pre=unchanged}}
+
{{PacketList|{{change|0x19|0x1A}}|Player Abilities (serverbound)|pre=unchanged}}
{{PacketList|{{Change|0x0F|0x0D}}|Player|pre=unchanged}}
+
{{PacketList|{{change|0x1A|0x1B}}|Player Digging|pre=unchanged}}
{{PacketList|{{Change|0x0C|0x0E}}|Player Position|pre=unchanged}}
+
{{PacketList|{{change|0x1B|0x1C}}|Entity Action|pre=unchanged}}
{{PacketList|{{Change|0x0D|0x0F}}|Player Position And Look (serverbound)|pre=unchanged}}
+
{{PacketList|{{change|0x1C|0x1D}}|Steer Vehicle|pre=unchanged}}
{{PacketList|{{Change|0x0E|0x10}}|Player Look|pre=unchanged}}
+
{{PacketList|{{change|0x1D|0x1E}}|Recipe Book Data|pre=unchanged}}
{{PacketList|{{Change|0x10|0x11}}|Vehicle Move (serverbound)|pre=unchanged}}
+
{{PacketList|{{change|0x1E|0x1F}}|Name Item|pre=unchanged}}
{{PacketList|{{Change|0x11|0x12}}|Steer Boat|pre=unchanged}}
+
{{PacketList|{{change|0x1F|0x20}}|Resource Pack Status|pre=unchanged}}
{{PacketList|{{Change|0x12|0x13}}|Player Abilities (serverbound)|pre=unchanged}}
+
{{PacketList|{{change|0x20|0x21}}|Advancement Tab|pre=unchanged}}
{{PacketList|{{Change|0x13|0x14}}|Player Digging|pre=unchanged}}
+
{{PacketList|{{change|0x21|0x22}}|Select Trade|pre=unchanged}}
{{PacketList|{{Change|0x14|0x15}}|Entity Action|pre=unchanged}}
+
{{PacketList|{{change|0x22|0x23}}|Set Beacon Effect|pre=unchanged}}
{{PacketList|{{Change|0x15|0x16}}|Steer Vehicle|pre=unchanged}}
+
{{PacketList|{{change|0x23|0x24}}|Held Item Change (serverbound)|pre=unchanged}}
{{PacketList|0x17|Crafting Book Data|rel=added}}
+
{{PacketList|{{change|0x24|0x25}}|Update Command Block|pre=unchanged}}
{{PacketList|{{Change|0x16|0x18}}|Resource Pack Status|pre=unchanged}}
+
{{PacketList|{{change|0x25|0x26}}|Update Command Block Minecart|pre=unchanged}}
{{PacketList|0x19|Advancement Tab|rel=added}}
+
{{PacketList|{{change|0x26|0x27}}|Creative Inventory Action|pre=unchanged}}
{{PacketList|{{Change|0x17|0x1A}}|Held Item Change (serverbound)|pre=unchanged}}
+
{{PacketList|{{change|0x27|0x28}}|Update Jigsaw Block}}
{{PacketList|{{Change|0x18|0x1B}}|Creative Inventory Action|pre=unchanged}}
+
{{PacketList|{{change|0x28|0x29}}|Update Structure Block|pre=unchanged}}
{{PacketList|{{Change|0x19|0x1C}}|Update Sign|pre=unchanged}}
+
{{PacketList|{{change|0x29|0x2A}}|Update Sign|pre=unchanged}}
{{PacketList|{{Change|0x1A|0x1D}}|Animation (serverbound)|pre=unchanged}}
+
{{PacketList|{{change|0x2A|0x2B}}|Animation (serverbound)|pre=unchanged}}
{{PacketList|{{Change|0x1B|0x1E}}|Spectate|pre=unchanged}}
+
{{PacketList|{{change|0x2B|0x2C}}|Spectate|pre=unchanged}}
{{PacketList|{{Change|0x1C|0x1F}}|Player Block Placement|pre=unchanged}}
+
{{PacketList|{{change|0x2C|0x2D}}|Player Block Placement|pre=unchanged}}
{{PacketList|{{Change|0x1D|0x20}}|Use Item|pre=unchanged}}
+
{{PacketList|{{change|0x2D|0x2E}}|Use Item|pre=unchanged}}
 
  |-
 
  |-
|}
+
!colspan="4"| Login clientbound
 +
{{PacketList|0x02|Login Success}}
 +
|}
  
 
== New/modified data types ==
 
== New/modified data types ==
  
=== Entity Metadata ===
+
No changes so far.
 +
 
 +
== Entity Metadata ==
  
Note that entity metadata is a totally distinct concept from block metadata.  It is not required to send all metadata fields, or even any metadata fields, so long as the terminating entry is correctly sent.
+
{{#vardefine:meta_prerelease|1}}
  
Entity Metadata is an array of entries, each of which looks like the following:
+
=== FishingHook ===
 +
 
 +
{{Metadata inherit|FishingHook|inherits=Entity|start_at=7}}
  
 
{| class="wikitable"
 
{| class="wikitable"
  ! Name
+
  ! Index
 
  ! Type
 
  ! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
! Default
 +
|-
 +
| {{Metadata id|}}
 +
| VarInt
 +
|colspan="2"| Hooked entity id + 1, or 0 if there is no hooked entity
 +
| 0
 +
|- {{Added}}
 +
| {{Metadata id|added}}
 +
| Boolean
 +
|colspan="2"| Is catchable
 +
| False
 +
|}
 +
 +
=== Abstract Arrow ===
 +
 +
{{Metadata inherit|Abstract Arrow|inherits=Entity|start_at=7}}
 +
 +
Abstract base class for [[#Tipped Arrow|Tipped Arrow]] (which is used for regular arrows as well as tipped ones) and [[#Spectral Arrow|Spectral Arrow]].
 +
 +
{| class="wikitable"
 +
! Index
 +
! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
! Default
 +
|-
 +
| rowspan="3" | {{Metadata id|}}
 +
| rowspan="3" | Byte
 +
! Bit mask
 
  ! Meaning
 
  ! Meaning
 +
| rowspan="3" | 0
 
  |-
 
  |-
  | Index
+
  | 0x01
  | Unsigned Byte
+
  | Is critical
| Unique index key determining the meaning of the following value, see the table below. If this is <code>0xff</code> then the it is the end of the Entity Metadata array and no more is read.
 
 
  |-
 
  |-
  | Type
+
  | 0x02
  | Optional Byte Enum
+
  | Is noclip (used by loyalty tridents when returning)
  | Only if Index is not <code>0xff</code>; the type of the index, see the table below
+
  |- {{removed}}
 +
| {{Metadata id|removed}}
 +
| OptUUID
 +
|colspan="2"| Unused
 +
| Empty
 
  |-
 
  |-
  | Value
+
  | {{Metadata id|}}
  | Optional ''value of Type''
+
  | Byte
  | Only if Index is not <code>0xff</code>: the value of the metadata field
+
|colspan="2"| Peircing level
 +
  | 0
 
  |}
 
  |}
 +
 +
=== Tipped Arrow ===
 +
 +
{{Metadata inherit|Tipped Arrow|inherits=Abstract Arrow}}
 +
 +
Used for both tipped and regular arrows.  If not tipped, then color is set to -1 and no tipped arrow particles are used.
  
 
{| class="wikitable"
 
{| class="wikitable"
  ! Value of Type field
+
  ! Index
  ! [[Data types|Type]] of Value field
+
! Type
  ! Notes
+
  !style="width: 250px;" colspan="2"| Meaning
 +
  ! Default
 
  |-
 
  |-
  | 0
+
  | {{Metadata id|}}
| Byte
 
|
 
|-
 
| 1
 
 
  | VarInt
 
  | VarInt
  |  
+
  |colspan="2"| Color (-1 for no particles)
|-
+
  | -1
| 2
 
| Float
 
|
 
|-
 
| 3
 
| String
 
|
 
|-
 
| 4
 
| [[Chat]]
 
|
 
|-
 
| 5
 
| [[Slot]]
 
|
 
|-
 
| 6
 
| Boolean
 
|
 
|-
 
| 7
 
| Rotation
 
| 3 floats: rotation on x, rotation on y, rotation on z
 
|-
 
| 8
 
| [[Data Types#Position|Position]]
 
|
 
|-
 
| 9
 
| OptPosition (Boolean + Optional Position)
 
| Position is present if the Boolean is set to true
 
|-
 
| 10
 
| Direction (VarInt)
 
| (Down = 0, Up = 1, North = 2, South = 3, West = 4, East = 5)
 
  |-
 
| 11
 
| OptUUID (Boolean + Optional UUID)
 
| UUID is present if the Boolean is set to true
 
|-
 
| 12
 
| OptBlockID (VarInt)
 
| 0 for absent otherwise, <code><nowiki>id &lt;&lt; 4 | data</nowiki></code>
 
|-style="background-color: #d9ead3;"
 
| 13
 
| [[NBT|NBT Tag]]
 
|
 
 
  |}
 
  |}
  
Entity classes also recursively inherit fields from classes they extend.
+
=== Spectral Arrow ===
  
=== IllusionIllager ===
+
{{Metadata inherit|Spectral Arrow|inherits=Abstract Arrow}}
  
Extends [[#EvocationIllager|EvocationIllager]].
+
No additional metadata.
  
* ''Entity ID: '''37'''.''
+
=== Trident ===
  
=== Parrot ===
+
{{Metadata inherit|Trident|inherits=Abstract Arrow}}
  
Extends [[#TameableAnimal|TameableAnimal]].
+
{| class="wikitable"
 
 
{| class="wikitable" style="background-color: #d9ead3;"
 
 
  ! Index
 
  ! Index
 
  ! Type
 
  ! Type
Line 200: Line 176:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 15
+
  | {{Metadata id|}}
 
  | VarInt
 
  | VarInt
  |colspan="2"| Variant (0: red/blue, 1: blue, 2: green, 3: yellow/blue, 4: silver)
+
  |colspan="2"| Loyalty level (enchantment)
 
  | 0
 
  | 0
 +
|-
 +
| {{Metadata id|}}
 +
| Boolean
 +
|colspan="2"| Has enchantment glint
 +
| False
 
  |}
 
  |}
  
* ''Entity ID: '''105'''.''
+
=== Strider ===
  
=== Player ===
+
{{Metadata inherit|Strider|inherits=Animal|start_at=16}}
  
Extends [[#Living|Living]].
+
{| class="wikitable" {{added}}
 
 
{| class="wikitable"
 
 
  ! Index
 
  ! Index
 
  ! Type
 
  ! Type
Line 218: Line 197:
 
  ! Default
 
  ! Default
 
  |-
 
  |-
  | 11
+
  | {{Metadata id|}}
| Float
 
|colspan="2"| Additional Hearts
 
| 0.0
 
|-
 
| 12
 
 
  | VarInt
 
  | VarInt
  |colspan="2"| Score
+
  |colspan="2"| Total time to "boost" with warped fungus on a stick for
 
  | 0
 
  | 0
 
  |-
 
  |-
  |rowspan="10"| 13
+
  | {{Metadata id|}}
  |rowspan="10"| Byte
+
  | Boolean
  |colspan="2"| The Displayed Skin Parts bit mask that is sent in [[Protocol#Client Settings|Client Settings]]
+
  |colspan="2"| Should display name tag (true unless riding a vehicle or on or in a block tagged with strider_warm_blocks (default: lava))
  |rowspan="10"| 0
+
  | false
 
  |-
 
  |-
  ! Bit mask !! Meaning
+
| {{Metadata id|}}
 +
| Boolean
 +
|colspan="2"| Has saddle
 +
| false
 +
|}
 +
 
 +
=== Hoglin ===
 +
 
 +
{{Metadata inherit|Hoglin|inherits=Animal|start_at=16}}
 +
 
 +
{| class="wikitable" {{added}}
 +
  ! Index
 +
! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
! Default
 
  |-
 
  |-
  | 0x01 || Cape enabled
+
  | {{Metadata id|}}
|-
+
  | Boolean
| 0x02 || Jacket enabled
+
  |colspan="2"| Is immune to zombification
|-
+
  | false
| 0x04 || Left sleeve enabled
 
|-
 
| 0x08 || Right sleeve enabled
 
|-
 
| 0x10 || Left pants leg enabled
 
|-
 
| 0x20 || Right pants leg enabled
 
|-
 
| 0x40 || Hat enabled
 
|-
 
| 0x80 || ''Unused''
 
|-
 
| 14
 
| Byte
 
|colspan="2"| Main hand (0 : Left, 1 : Right)
 
| 1
 
|- style="background-color: #d9ead3;"
 
| 15
 
| NBT Tag
 
|colspan="2"|Left shoulder entity data
 
|
 
|- style="background-color: #d9ead3;"
 
| 16
 
  | NBT Tag
 
  |colspan="2"|Right shoulder entity data
 
  |  
 
 
  |}
 
  |}
  
== Block Actions ==
+
=== Zoglin ===
  
== Note Block ==
+
{{Metadata inherit|Hoglin|inherits=Monster|start_at=15}}
  
Displays a colored note particle and plays the appropriate note sound effect.
+
{| class="wikitable" {{added}}
 +
! Index
 +
! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
! Default
 +
|-
 +
| {{Metadata id|}}
 +
| Boolean
 +
|colspan="2"| Is baby
 +
| false
 +
|}
  
=== Action IDs ===
+
=== Piglin ===
  
The action ID is used to determine the instrument to play.
+
{{Metadata inherit|Piglin|inherits=Monster|start_at=15}}
  
{| class="wikitable"
+
{| class="wikitable" {{added}}
 +
! Index
 +
! Type
 +
!style="width: 250px;" colspan="2"| Meaning
 +
! Default
 
  |-
 
  |-
  ! Type ID
+
  | {{Metadata id|}}
  ! Instrument
+
  | Boolean
  ! Material/block
+
  |colspan="2"| Is baby
  ! Sound
+
  | false
 
  |-
 
  |-
  | 0
+
  | {{Metadata id|}}
  | Harp
+
  | Boolean
  | Any other material
+
  |colspan="2"| Is immune to zombification
  | <code>block.note.harp</code>
+
  | false
 
  |-
 
  |-
  | 1
+
  | {{Metadata id|}}
| Bass Drum
+
  | Boolean
| Stone
+
  |colspan="2"| Is charging crossbow
| <code>block.note.harp</code>
+
  | false
|-
 
| 2
 
| Snare Drum
 
| Sand
 
| <code>block.note.snare</code>
 
|-
 
| 3
 
| Clicks/Sticks
 
  | Glass
 
  | <code>block.note.hat</code>
 
|-
 
| 4
 
| Bass guitar
 
| Wood
 
| <code>block.note.bass</code>
 
|- style="background-color: #d9ead3;"
 
| 5
 
| Flute
 
| Clay
 
| <code>block.note.flute</code>
 
|- style="background-color: #d9ead3;"
 
| 6
 
| Bell
 
| Gold block
 
| <code>block.note.bell</code>
 
|- style="background-color: #d9ead3;"
 
| 7
 
| Guitar
 
| Wool
 
| <code>block.note.guitar</code>
 
|- style="background-color: #d9ead3;"
 
| 8
 
| Chime
 
| Packed ice
 
| <code>block.note.chime</code>
 
|- style="background-color: #d9ead3;"
 
| 9
 
| Xylophone
 
| Bone block
 
  | <code>block.note.xylophone</code>
 
 
  |}
 
  |}
  
Any unknown ID is treated as if it were <code>0</code>.
+
=== {{Change|Zombie Pigman|Zombified Piglin}} ===
  
The sound event <code>block.note.pling</code> is unassigned and unused.
+
{{Metadata inherit|{{Change|Zombie Pigman|Zombified Piglin}}|inherits=Zombie|start_at=18}}
  
=== Action param ===
+
No additional metadata.
  
The pitch of the note (between 0–24 inclusive where 0 is the lowest and 24 is the highest). More information about how the pitch values correspond to notes in real life and how they correspond to pitch scaling on the sound effects can be found in the {{Minecraft Wiki|Note Block}} article on the Minecraft wiki.
+
== Block Actions ==
  
== Chat components ==
+
No changes so far.
  
==== Translation component ====
+
== Inventories ==
  
{{Need Info|Is using this with an invalid key intended or deprecated?  Also, what exactly happens on invalid formats?}}
+
No changes so far.
 
 
Translates text into the current language. If the JSON contains a <code>translate</code> key, then the component is a translation component.
 
 
 
Translation supports <code>%s</code> and <code>%%</code> format tokens.  <code>%%</code> is just an escaped percent symbol.  <code>%s</code> marks text to replace using content from the optional <code>with</code> tag.  <code>with</code> is an array of components.
 
 
 
{{Change||As a special case, if the translation key is <code>chat.type.text</code>, it will be changed to <code>chat.type.text.narrate</code> when passed to narrator (although it will remain as <code>chat.type.text</code> in chat).}}
 
 
 
==== Keybind component ====
 
 
 
{{change||Displays the client's current keybind for the specified key.  If the component contains a <code>keybind</code> key, then it is a keybind component.  The value is named after the keys in {{Minecraft Wiki|options.txt}} (for instance, for <code>key_key.forward</code> in options.txt, <code>key.forward</code> would be used in the component and <kbd>W</kbd> would be displayed).  For keys that are not known, the value provided should be displayed instead (for instance <code>key.invalid</code> would remain as <code>key.invalid</code>).}}
 
  
 
== Plugin Channels ==
 
== Plugin Channels ==
Line 367: Line 293:
 
=== Clientbound ===
 
=== Clientbound ===
  
==== Update Block Entity ====
+
==== Chat Message (clientbound) ====  
 +
 
 +
Identifying the difference between Chat/System Message is important as it helps respect the user's chat visibility options.  See [[Chat#Processing chat|processing chat]] for more info about these positions.
  
Sets tile entity associated with the block at the given location.
+
{{warning2|Game info accepts json formatting but does not display it, although the deprecated §-based formatting works.  This is not an issue when using the [[#Title|Title]] packet, so prefer that packet for displaying information in that slot.  See [https://bugs.mojang.com/browse/MC-119145 MC-119145] for more information.}}
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 379: Line 307:
 
  ! Notes
 
  ! Notes
 
  |-
 
  |-
  |rowspan="3"| 0x09
+
  |rowspan="3"| 0x0F
 
  |rowspan="3"| Play
 
  |rowspan="3"| Play
 
  |rowspan="3"| Client
 
  |rowspan="3"| Client
  | Location
+
  | JSON Data
 +
| [[Chat]]
 +
| Limited to 32767 bytes
 +
|-
 
  | Position
 
  | Position
  |  
+
  | Byte
|-
+
  | 0: chat (chat box), 1: system message (chat box), 2: game info (above hotbar).
| Action
+
  |- {{added}}
| Unsigned Byte
+
  | Sender
  | The type of update to perform, see below
+
  | UUID
  |-
+
  | Used by the Notchian client for the disableChat launch option. Setting both longs to 0 will always display the message regardless of the setting.
  | NBT Data
 
  | [[NBT|NBT Tag]]
 
  | Data to set.  May be a TAG_END (0), in which case the block entity at the given location is removed (though this is not required since the client will remove the block entity automatically on chunk unload or block removal)
 
 
  |}
 
  |}
  
''Action'' field:
+
==== Chunk Data ====
 +
{{Main|Chunk Format}}
 +
{{See also|#Unload Chunk}}
  
* '''1''': Set data of a mob spawner (everything except for SpawnPotentials: current delay, min/max delay, mob to be spawned, spawn count, spawn range, etc.)
+
{{Need Info|How do biomes work now?  The biome change happened at the same time as the seed change, but it's not clear how/if biomes could be computed given that it's not the actual seed...  ([https://www.reddit.com/r/Mojira/comments/e5at6i/a_discussion_for_the_changes_to_how_biomes_are/ /r/mojira discussion] which notes that it seems to be some kind of interpolation, and 3D biomes are only used in the nether)}}
* '''2''': Set command block text (command and last execution status)
 
* '''3''': Set the level, primary, and secondary powers of a beacon
 
* '''4''': Set rotation and skin of mob head
 
* '''5''': Set type of flower in flower pot
 
* '''6''': Set base color and patterns on a banner
 
* '''7''': Set the data for a Structure tile entity
 
* '''8''': Set the destination for a end gateway
 
* '''9''': Set the text on a sign
 
* '''10''': Declare a shulker box (unclear if there is any actual data)
 
* {{Change||'''11''': Set the color of a bed}}
 
  
==== Unlock Recipes ====
+
The server only sends skylight information for chunk pillars in the {{Minecraft Wiki|Overworld}}, it's up to the client to know in which dimenison the player is currently located. You can also infer this information from the primary bitmask and the amount of uncompressed bytes sent.  This packet also sends all block entities in the chunk (though sending them is not required; it is still legal to send them with [[#Update Block Entity|Update Block Entity]] later).
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 419: Line 339:
 
  ! Notes
 
  ! Notes
 
  |-
 
  |-
  |rowspan="8"| 0x30
+
  |rowspan="10"| 0x22
  |rowspan="8"| Play
+
  |rowspan="10"| Play
  |rowspan="8"| Client
+
  |rowspan="10"| Client
 +
| Chunk X
 +
| Int
 +
| Chunk coordinate (block coordinate divided by 16, rounded down)
 
  |-
 
  |-
  | Action
+
  | Chunk Z
  | VarInt
+
  | Int
  | 0: init, 1: add, 2: remove
+
  | Chunk coordinate (block coordinate divided by 16, rounded down)
 
  |-
 
  |-
  | Crafting Book Open
+
  | Full chunk
 
  | Boolean
 
  | Boolean
  | If true, then the crafting book will be open when the player opens its inventory.
+
  | See [[Chunk Format#Full chunk|Chunk Format]]
 +
|-
 +
| Primary Bit Mask
 +
| VarInt
 +
| Bitmask with bits set to 1 for every 16×16×16 chunk section whose data is included in Data. The least significant bit represents the chunk section at the bottom of the chunk column (from y=0 to y=15).
 
  |-
 
  |-
  | Filtering Craftable
+
  | Heightmaps
  | Boolean
+
  | [[NBT]]
  | If true, then the filtering option is active when the players opens its inventory.
+
  | Compound containing one long array named <code>MOTION_BLOCKING</code>, which is a heightmap for the highest solid block at each position in the chunk (as a compacted long array with 256 entries at 9 bits per entry totaling 36 longs). The Notchian server also adds a <code>WORLD_SURFACE</code> long array, the purpose of which is unknown, but it's not required for the chunk to be accepted.
 
  |-
 
  |-
  | Array size 1
+
  | Biomes
 +
| Optional array of Integer
 +
| 1024 biome IDs, ordered by x then z then y, in 4&times;4&times;4 blocks.  Not present if full chunk is false.
 +
|-
 +
| Size
 
  | VarInt
 
  | VarInt
  | Number of elements in the following array
+
  | Size of Data in bytes
 
  |-
 
  |-
  | Recipe IDs
+
  | Data
  | Array of VarInt
+
  | Byte array
  |
+
  | See [[Chunk Format#Data structure|data structure]] in Chunk Format
 
  |-
 
  |-
  | Array size 2
+
  | Number of block entities
  | Optional VarInt
+
  | VarInt
  | Number of elements in the following array, only present if mode is 0 (init)
+
  | Number of elements in the following array
 
  |-
 
  |-
  | Recipe IDs
+
  | Block entities
  | Optional Array of VarInt, only present if mode is 0 (init)
+
  | Array of [[NBT|NBT Tag]]
  |
+
  | All block entities in the chunk.  Use the x, y, and z tags in the NBT to determine their positions.
 
  |}
 
  |}
Action:
 
* 0 (init) = All the recipes in the list 2 will added to the recipe book. All the recipes in list 1 will be tagged as displayed, recipes that aren't tagged will be shown in the notification. VERIFY LIST ORDER?
 
* 1 (add) = All the recipes in the list are added and their icon will be shown in the notification.
 
* 2 (remove) = Remove all the recipes in the list. This allows them to re-displayed when they are readded.
 
  
Recipe ID:
+
Note that the Notchian client requires an [[#Update View Position|Update View Position]] packet when it crosses a chunk border, otherwise it'll only display render distance + 2 chunks around the chunk it spawned in.
These are hardcoded values in the client and server, all the recipe json files will be loaded in a specific order (alphabetical, like sounds) and internal ids will be assigned in that order. There are also inbuilt recipes like fireworks, banners, etc., these are the first recipes to have their id assigned. Due the fact that the recipes are loaded in a specific order will the ids very likely change when recipes get added. [https://twitter.com/dinnerbone/status/856505341479145472 Custom recipes are scheduled for Minecraft 1.13], so most likely will things change a bit in that version.
 
  
==== Advancement Progress ====
+
{{Change||The compacted array format has been adjusted so that individual entries no longer span across multiple longs, affecting the main data array and heightmaps.}}
 +
 
 +
==== Join Game ====
 +
 
 +
See [[Protocol Encryption]] for information on logging in.
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 469: Line 399:
 
  ! Notes
 
  ! Notes
 
  |-
 
  |-
  |rowspan="2"| 0x36
+
  |rowspan="12"| 0x26
  |rowspan="2"| Play
+
  |rowspan="12"| Play
  |rowspan="2"| Client
+
  |rowspan="12"| Client
  | Has id
+
| Entity ID
 +
| Int
 +
| The player's Entity ID (EID)
 +
|-
 +
| Gamemode
 +
| Unsigned Byte
 +
| 0: Survival, 1: Creative, 2: Adventure, 3: Spectator. Bit 3 (0x8) is the hardcore flag.
 +
|- {{Added}}
 +
| Dimension Codec
 +
| [[NBT|NBT Tag Compound]]
 +
| This CompoundTag contains a ListTag named "dimension". The ListTag should contain CompoundTags with named StringTags "key" and "element". The full extent of these is still unknown, but the tag represents a dimension registry. See below for the vanilla default.
 +
|-
 +
| Dimension
 +
| {{change|Int Enum|Identifier}}
 +
| {{change|-1: The Nether, 0: The Overworld, 1: The End|Valid dimensions are defined per dimension registry sent before this}}
 +
|-
 +
| Hashed seed
 +
| Long
 +
| First 8 bytes of the SHA-256 hash of the world's seed.
 +
|-
 +
| Max Players
 +
| Unsigned Byte
 +
| Was once used by the client to draw the player list, but now is ignored
 +
|- {{Removed}}
 +
| Level Type
 +
| String Enum (16)
 +
| default, flat, largeBiomes, amplified, customized, buffet, default_1_1
 +
|-
 +
| View Distance
 +
| VarInt
 +
| Render distance (2-32)
 +
|-
 +
  | Reduced Debug Info
 
  | Boolean
 
  | Boolean
  | Indicates if the next field is present
+
  | If true, a Notchian client shows reduced information on the {{Minecraft Wiki|debug screen}}.  For servers in development, this should almost always be false.
 
  |-
 
  |-
  | ID
+
  | Enable respawn screen
  | Optional Identifier
+
  | Boolean
  |
+
  | Set to false when the doImmediateRespawn gamerule is true
 +
|- {{Added}}
 +
| Is Debug
 +
| Boolean
 +
| True if the world is a {{Minecraft Wiki|debug mode}} world; debug mode worlds cannot be modified and have predefined blocks
 +
|- {{Added}}
 +
| Is Flat
 +
| 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
 
  |}
 
  |}
 +
Example of Dimension codec CompoundTag sent by the server:
 +
    ListTag (Type: CompoundTag) "dimension":
 +
        CompoundTag:
 +
            StringTag "key" value: 'minecraft:overworld'
 +
            StringTag "element" value: 'minecraft:overworld'
 +
        CompoundTag:
 +
            StringTag "key" value: 'minecraft:the_nether'
 +
            StringTag "element" value: 'minecraft:the_nether'
 +
        CompoundTag:
 +
            StringTag "key" value: 'minecraft:the_end'
 +
            StringTag "element" value: 'minecraft:the_end'
  
==== Advancements ====
+
==== Respawn ====
 +
 
 +
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"
 
{| class="wikitable"
Line 487: Line 470:
 
  ! State
 
  ! State
 
  ! Bound To
 
  ! Bound To
  !colspan="2"| Field Name
+
  ! Field Name
  !colspan="2"| Field Type
+
  ! Field Type
 
  ! Notes
 
  ! Notes
 
  |-
 
  |-
  |rowspan="9"| 0x4C
+
  |rowspan="7"| 0x3B
  |rowspan="9"| Play
+
  |rowspan="7"| Play
  |rowspan="9"| Client
+
  |rowspan="7"| Client
  |colspan="2"| Reset/Clear
+
  | Dimension
  |colspan="2"| Boolean
+
  | {{change|Int Enum|Identifier}}
  | Whether to reset/clear the current advancements
+
  | {{change|-1: The Nether, 0: The Overworld, 1: The End|Valid dimensions are defined per dimension registry sent in [[#Join Game|Join Game]]}}
 
  |-
 
  |-
  |colspan="2"| Mapping size
+
  | Hashed seed
  |colspan="2"| VarInt
+
  | Long
  | Size of the following array
+
  | First 8 bytes of the SHA-256 hash of the world's seed.
 
  |-
 
  |-
  |rowspan="2"| Advancement mapping
+
  | Gamemode
  | Key
+
  | Unsigned Byte
  |rowspan="2"| Array
+
  | 0: survival, 1: creative, 2: adventure, 3: spectator. The hardcore flag is not included
| Identifier
+
  |- {{Removed}}
| The identifier of the advancement
+
  | Level Type
  |-
+
  | String (16)
  | Value
+
  | Same as [[#Join Game|Join Game]]
  | Advancement
+
  |- {{Added}}
  | See below
+
  | Is Debug
  |-
+
  | Boolean
  |colspan="2"| List size
+
  | True if the world is a {{Minecraft Wiki|debug mode}} world; debug mode worlds cannot be modified and have predefined blocks
  |colspan="2"| VarInt
+
  |- {{Added}}
  | Size of the following array
+
  | Is Flat
  |-
+
  | Boolean
  |colspan="2"| Identifiers
+
  | 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
  |colspan="2"| Array of Identifier
+
  |- {{added}}
  | The identifiers of the advancements that should be removed
+
  | Copy metadata
|-
+
  | Boolean
|colspan="2"| Progress size
+
  | If false, metadata is reset on the respawned player entity. Set to true for dimension changes (including the dimension change triggered by sending client status perform respawn to exit the end poem/credits), and false for normal respawns.
|colspan="2"| VarInt
 
| Size of the following array
 
  |-
 
  |rowspan="2"| Progress mapping
 
  | Key
 
  |rowspan="2"| Array
 
  | Identifier
 
| The identifier of the advancement
 
|-
 
| Value
 
| Advancement progress
 
| See below
 
 
  |}
 
  |}
  
Advancement structure:
+
{{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).
 +
 
 +
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.}}
 +
 
 +
==== Entity Properties ====
 +
 
 +
Sets {{Minecraft Wiki|Attribute|attributes}} on the given entity.
  
 
{| class="wikitable"
 
{| class="wikitable"
 +
! Packet ID
 +
! State
 +
! Bound To
 
  !colspan="2"| Field Name
 
  !colspan="2"| Field Name
 
  !colspan="2"| Field Type
 
  !colspan="2"| Field Type
 
  ! Notes
 
  ! Notes
 
  |-
 
  |-
  |colspan="2"| Has parent
+
|rowspan="6"| 0x59
  |colspan="2"| Boolean
+
|rowspan="6"| Play
  | Indicates whether the next field exists.
+
|rowspan="6"| Client
 +
  |colspan="2"| Entity ID
 +
  |colspan="2"| VarInt
 +
  |  
 
  |-
 
  |-
  |colspan="2"| Parent id
+
  |colspan="2"| Number Of Properties
  |colspan="2"| Optional Identifier
+
  |colspan="2"| Int
  | The identifier of the parent advancement.
+
  | Number of elements in the following array
|-
 
|colspan="2"| Has display
 
|colspan="2"| Boolean
 
| Indicates whether the next field exists
 
 
  |-
 
  |-
|colspan="2"| Display data
+
  |rowspan="4"| Property
|colspan="2"| Optional advancement display
 
| See below.
 
|-
 
|colspan="2"| Number of criteria
 
|colspan="2"| VarInt
 
| Size of the following array
 
|-
 
  |rowspan="2"| Criteria
 
 
  | Key
 
  | Key
  |rowspan="2"| Array
+
  |rowspan="4"| Array
  | Identifier
+
  | {{Change|String (64)|Identifier}}
  | The identifier of the criterion
+
  | See below
 
  |-
 
  |-
 
  | Value
 
  | Value
  | '''Void'''
+
  | Double
  | There is ''no'' content written here.  Perhaps this will be expanded in the future?
+
  | See below
 
  |-
 
  |-
|colspan="2"| Array length
+
  | Number Of Modifiers
|colspan="2"| VarInt
 
  | Number of arrays in the following array
 
|-
 
|rowspan="2"| Requirements
 
| Array length 2
 
|rowspan="2"| Array
 
 
  | VarInt
 
  | VarInt
 
  | Number of elements in the following array
 
  | Number of elements in the following array
 
  |-
 
  |-
  | Requirement
+
  | Modifiers
  | Array of String
+
  | Array of Modifier Data
  | Array of required criteria
+
  | See {{Minecraft Wiki|Attribute#Modifiers}}. Modifier Data defined below.
 
  |}
 
  |}
  
Advancement display:
+
Known Key values (see also {{Minecraft Wiki|Attribute#Modifiers}}):
  
 
{| class="wikitable"
 
{| class="wikitable"
! Field Name
 
! Field Type
 
! Notes
 
 
  |-
 
  |-
  | Title
+
  ! Key
  | Chat
+
  ! Default
  |
+
  ! Min
 +
! Max
 +
! Label
 
  |-
 
  |-
  | Description
+
  | {{change|generic.maxHealth|generic.max_health}}
  | Chat
+
| 20.0
  |
+
| 0.0
 +
  | 1024.0
 +
  | Max Health
 
  |-
 
  |-
  | Icon
+
  | {{change|generic.followRange|generic.follow_range}}
  | [[Slot]]
+
| 32.0
  |
+
| 0.0
 +
  | 2048.0
 +
  | Follow Range
 
  |-
 
  |-
  | Frame type
+
  | {{change|generic.knockbackResistance|generic.knockback_resistance}}
  | VarInt enum
+
  | 0.0
  | 0 = <code>task</code>, 1 = <code>challenge</code>, 2 = <code>goal</code>
+
  | 0.0
 +
| 1.0
 +
| Knockback Resistance
 
  |-
 
  |-
  | Flags
+
  | {{change|generic.movementSpeed|generic.movement_speed}}
  | Integer
+
| 0.7
  | 0x1: has background texture; 0x2: <code>show_toast</code>; 0x4: <code>hidden</code>
+
| 0.0
 +
  | 1024.0
 +
  | Movement Speed
 
  |-
 
  |-
  | Background texture
+
  | {{change|generic.attackDamage|generic.attack_damage}}
  | Optional Identifier
+
  | 2.0
  | Background texture locationOnly if flags indicates it.
+
  | 0.0
 +
  | 2048.0
 +
| Attack Damage
 
  |-
 
  |-
  | X coord
+
  | {{change|generic.attackSpeed|generic.attack_speed}}
  | Float
+
| 4.0
  |  
+
| 0.0
 +
  | 1024.0
 +
  | Attack Speed
 
  |-
 
  |-
  | Y coord
+
  | {{change|generic.flyingSpeed|generic.flying_speed}}
| Float
+
  | 0.4
  |  
+
  | 0.0
  |}
+
  | 1024.0
 
+
  | Flying Speed
Advancement progress:
 
 
 
{| class="wikitable"
 
  !colspan="2"| Field Name
 
  !colspan="2"| Field Type
 
! Notes
 
 
  |-
 
  |-
  |colspan="2"| Size
+
  | generic.armor
  |colspan="2"| VarInt
+
| 0.0
  | Size of the following array
+
  | 0.0
 +
| 30.0
 +
  | Armor
 
  |-
 
  |-
  |rowspan="2"| Criteria
+
  | {{change|generic.armorToughness|generic.armor_toughness}}
  | Criterion identifier
+
  | 0.0
  |rowspan="2"| Array
+
  | 0.0
  | Identifier
+
  | 20.0
  | The identifier of the criterion.
+
  | Armor Toughness
 
  |-
 
  |-
  | Criterion progress
+
  | {{change|generic.attackKnockback|generic.attack_knockback}}
  | Criterion progress
+
  | 0.0
  |
+
  | 0.0
  |}
+
  | 5.0
 
+
| &mdash;
Criterion progress:
 
 
 
{| class="wikitable"
 
! Field Name
 
! Field Type
 
! Notes
 
 
  |-
 
  |-
  | Achieved
+
  | generic.luck
  | Boolean
+
  | 0.0
  | If true, next field is present
+
  | -1024.0
 +
| 1024.0
 +
| Luck
 
  |-
 
  |-
  | Date of achieving
+
  | {{change|horse.jumpStrength|horse.jump_strength}}
| Optional Long
+
  | 0.7
  | As returned by [https://docs.oracle.com/javase/6/docs/api/java/util/Date.html#getTime() <code>Date.getTime</code>]
+
  | 0.0
  |}
+
  | 2.0
 
+
  | Jump Strength
 
 
   
 
=== Serverbound ===
 
 
 
==== Prepare Crafting Grid ====
 
 
 
{| class="wikitable"
 
! Packet ID
 
! State
 
! Bound To
 
!colspan="2"| Field Name
 
  !colspan="2"| Field Type
 
! Notes
 
 
  |-
 
  |-
  |rowspan="12"| 0x01
+
  | {{change|zombie.spawnReinforcements|zombie.spawn_reinforcements}}
|rowspan="12"| Play
+
  | 0.0
  |rowspan="12"| Server
+
  | 0.0
  |colspan="2"| Window ID
+
  | 1.0
  |colspan="2"| Byte
+
  | Spawn Reinforcements Chance
  | The window id.
 
 
  |-
 
  |-
  |colspan="2"| Action number
+
  | generic.reachDistance
  |colspan="2"| Short
+
| 5.0
  | The transaction number. Will be send to the client in a Confirm Transaction packet.
+
  | 0.0
 +
| 1024.0
 +
  | Player Reach Distance (Forge only)
 
  |-
 
  |-
  |colspan="2"| Array size
+
  | forge.swimSpeed
|colspan="2"| Short
+
  | 1.0
| Number of elements in the following array
+
  | 0.0
|-
+
  | 1024.0
|rowspan="3"| Return Entry
+
  | Swimming Speed (Forge only)
| Item
 
|rowspan="3"| Array
 
| Slot
 
| The item stack that will be put in the inventory slot
 
|-
 
| Crafting Slot
 
| Byte
 
| The crafting slot index in the active container
 
|-
 
| Player Slot
 
| Byte
 
| The player slot index in the player inventory
 
|-
 
|colspan="2"| Array Size
 
|colspan="2"| Short
 
| Number of elements in the following array
 
|-
 
|rowspan="3"| Prepare Entry
 
| Item
 
|rowspan="3"| Array
 
| Slot
 
| The item stack that will be put in the crafting slot
 
|-
 
| Crafting Slot
 
| Byte
 
| The crafting slot index in the active container
 
  |-
 
  | Player Slot
 
  | Byte
 
  | The player slot index in the player inventory
 
 
  |}
 
  |}
  
This packet is send when a player clicks a recipe in the crafting book that is craftable (white border).
+
Unknown attributes will cause a game crash ([https://bugs.mojang.com/browse/MC-150405 MC-150405]) due to the default minimum being larger than the default value.
 
 
1. Return Entries:
 
* All the items on the crafting slot are set to null/empty.
 
* Every entry item stack will be added to the player inventory, to the specific player slot.
 
 
 
2. Prepare Entries:
 
* All the items on the player inventory slots their quantity is decreased by 1.
 
* Every entry item stack will be put in the proper crafting grid slot.
 
 
 
The server will send a Confirm Transaction packet back to the client with the provided transaction id.
 
 
 
==== Client Status ====
 
  
Sent when the client is ready to complete login and when the client is ready to respawn after death.
+
''Modifier Data'' structure:
  
 
{| class="wikitable"
 
{| class="wikitable"
  ! Packet ID
+
  |-
! State
 
! Bound To
 
 
  ! Field Name
 
  ! Field Name
 
  ! Field Type
 
  ! Field Type
 
  ! Notes
 
  ! Notes
 
  |-
 
  |-
  |rowspan="1"| 0x04
+
  | UUID
|rowspan="1"| Play
+
  | UUID
|rowspan="1"| Server
+
  |  
| Action ID
 
| VarInt Enum
 
  | See below
 
  |}
 
 
 
''Action ID'' values:
 
 
 
{| class="wikitable"
 
 
  |-
 
  |-
  ! Action ID
+
  | Amount
  ! Action
+
  | Double
 +
| May be positive or negative
 
  |-
 
  |-
  | 0
+
  | Operation
  | Perform respawn
+
  | Byte
  |-
+
  | See below
| 1
 
| Request stats
 
|-
 
| {{Change|2|}}
 
| {{Change|Open inventory|}}
 
 
  |}
 
  |}
  
==== Client Settings ====
+
The operation controls how the base value of the modifier is changed.
  
Sent when the player connects, or when settings are changed.
+
* 0: Add/subtract amount
 
+
* 1: Add/subtract amount percent of the current value
{| class="wikitable"
+
* 2: Multiply by amount percent
! Packet ID
 
! State
 
! Bound To
 
! Field Name
 
! Field Type
 
! Notes
 
|-
 
|rowspan="6"| 0x05
 
|rowspan="6"| Play
 
|rowspan="6"| Server
 
| Locale
 
| String ({{Change|7|16}})
 
| e.g. en_GB.
 
|-
 
| View Distance
 
| Byte
 
| Client-side render distance, in chunks
 
|-
 
| Chat Mode
 
| VarInt Enum
 
| 0: enabled, 1: commands only, 2: hidden.  See [[Chat#Processing chat|processing chat]] for more information.
 
|-
 
| Chat Colors
 
| Boolean
 
| “Colors” multiplayer setting
 
|-
 
| Displayed Skin Parts
 
| Unsigned Byte
 
| Bit mask, see below
 
|-
 
| Main Hand
 
| VarInt Enum
 
| 0: Left, 1: Right
 
|}
 
  
''Displayed Skin Parts'' flags:
+
All of the 0's are applied first, and then the 1's, and then the 2's.
  
* Bit 0 (0x01): Cape enabled
+
=== Serverbound ===
* Bit 1 (0x02): Jacket enabled
 
* Bit 2 (0x04): Left Sleeve enabled
 
* Bit 3 (0x08): Right Sleeve enabled
 
* Bit 4 (0x10): Left Pants Leg enabled
 
* Bit 5 (0x20): Right Pants Leg enabled
 
* Bit 6 (0x40): Hat enabled
 
  
The most significant bit (bit 7, 0x80) is unused.
+
==== Generate Structure ====
  
==== Crafting Book Data ====
+
Sent when Generate is pressed on the {{Minecraft Wiki|Jigsaw Block}} interface.
  
{| class="wikitable"
+
{| class="wikitable" {{added}}
 
  ! Packet ID
 
  ! Packet ID
 
  ! State
 
  ! State
 
  ! Bound To
 
  ! Bound To
  !colspan="2"| Field Name
+
  ! Field Name
 
  ! Field Type
 
  ! Field Type
 
  ! Notes
 
  ! Notes
 
  |-
 
  |-
  |rowspan="5"| 0x17
+
  |rowspan="2"| 0x0F
  |rowspan="5"| Play
+
  |rowspan="2"| Play
  |rowspan="5"| Server
+
  |rowspan="2"| Server
  |colspan="2"| Type
+
  | Location
 +
| Position
 +
| Block entity location
 +
|-
 +
| Levels
 
  | VarInt
 
  | VarInt
  | Determines the format of the rest of the packet
+
  | Value of the levels slider/max depth to generate
|-
 
! Type
 
! Field Name
 
!
 
!
 
|-
 
| 0: Displayed Recipe
 
| Recipe ID
 
| Int
 
| The internal id of the displayed recipe.
 
|-
 
|rowspan="2"| 1: Crafting Book Status
 
| Crafting Book Open
 
| Boolean
 
| Whether the player has the crafting book currently openened/active.
 
|-
 
| Crafting Filter
 
| Boolean
 
| Whether the player has the crafting filter option currently active.
 
 
  |}
 
  |}
  
The Crafting Book Status type is send when the player closes its inventory.
+
==== Update Jigsaw Block ====
  
==== Advancement Tab ====
+
Sent when Done is pressed on the {{Minecraft Wiki|Jigsaw Block}} interface.
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 877: Line 722:
 
  ! Notes
 
  ! Notes
 
  |-
 
  |-
  |rowspan="2"| 0x19
+
  |rowspan="7"| {{Change|0x27|0x28}}
  |rowspan="2"| Play
+
  |rowspan="7"| Play
  |rowspan="2"| Server
+
  |rowspan="7"| Server
  | Action
+
  | Location
  | VarInt enum
+
| Position
  | 0: Opened tab, 1: Closed screen
+
| Block entity location
 +
|- {{Removed}}
 +
| Attachment type
 +
| Identifier
 +
|
 +
|- {{Added}}
 +
| Name
 +
| Identifier
 +
|
 +
|- {{Added}}
 +
| Target
 +
| Identifier
 +
|
 +
|-
 +
| {{Change|Target pool|Pool}}
 +
  | Identifier
 +
  |  
 
  |-
 
  |-
  | Tab ID
+
  | Final state
  | Optional identifier
+
  | String
  | Only present if action is Opened tab
+
  | "Turns into" on the GUI, <code>final_state</code> in NBT
 +
|- {{Added}}
 +
| Joint type
 +
| String
 +
| <code>rollable</code> if the attached piece can be rotated, else <code>aligned</code>
 
  |}
 
  |}
  
Line 893: Line 758:
 
=== Clientbound ===
 
=== Clientbound ===
  
No changes so far.
+
There are no clientbound packets in the Handshaking state, since the protocol immediately switches to a different state after the client sends the first packet.  
  
 
=== Serverbound ===
 
=== Serverbound ===
 
No changes so far.
 
  
 
==== Handshake ====
 
==== Handshake ====
Line 916: Line 779:
 
  | Protocol Version
 
  | Protocol Version
 
  | VarInt
 
  | VarInt
  | See [[protocol version numbers]] (currently {{change|316|335}})
+
  | See [[protocol version numbers]] (currently {{change|578|718}})
 
  |-
 
  |-
 
  | Server Address
 
  | Server Address
 
  | String
 
  | String
  | Hostname or IP, e.g. localhost or 127.0.0.1, that was used to connect. The Notchian server does not use this information.
+
  | Hostname or IP, e.g. localhost or 127.0.0.1, that was used to connect. The Notchian server does not use this information. Note that SRV records are a complete redirect, e.g. if _minecraft._tcp.example.com points to mc.example.org, users connecting to example.com will provide mc.example.org as server address in addition to connecting to it.
 
  |-  
 
  |-  
 
  | Server Port
 
  | Server Port
Line 945: Line 808:
 
=== Clientbound ===
 
=== Clientbound ===
  
No changes so far.
+
==== Login Success ====
 +
 
 +
{| class="wikitable"
 +
! Packet ID
 +
! State
 +
! Bound To
 +
! Field Name
 +
! Field Type
 +
! Notes
 +
|-
 +
|rowspan="2"| 0x02
 +
|rowspan="2"| Login
 +
|rowspan="2"| Client
 +
| UUID
 +
| {{Change|String (36)|UUID}}
 +
| {{Change|Unlike in other packets, this field contains the UUID as a string with hyphens}}.
 +
|-
 +
| Username
 +
| String (16)
 +
|
 +
|}
 +
 
 +
This packet switches the connection state to [[#Play|play]].
  
 
=== Serverbound ===
 
=== Serverbound ===
  
 
No changes so far.
 
No changes so far.
 +
  
 
[[Category:Minecraft Modern]]
 
[[Category:Minecraft Modern]]

Latest revision as of 04:52, 23 May 2020

This page documents the changes from the last stable Minecraft release (currently 1.15.2, protocol 578) to the current pre-release (currently 20w21a, protocol 718). Note that this page contains bleeding-edge information that may not be completely or correctly documented.

One who wishes to commandeer the merging of this into Protocol when an update is made must be sure to respect any changes that may have occurred to the respective packets there.

Contents

Data types

The UUID type is now also sometimes encoded by the Notchian server as an array of four 32-bit integers, from most significant to least significant (matching the new format used on entity NBT). This representation is identical to using 16 bytes, two 64-bit integers, or one 128-bit integers.

Packets

ID Packet name Documentation
Handshaking serverbound
0x00 Handshake Current Pre
Play clientbound
0x0F Chat Message (clientbound) Current Pre
0x22 Chunk Data Current Pre
0x26 Join Game Current Pre
0x3B Respawn Current Pre
0x4E 0x43 Spawn Position Current (unchanged)
0x43 0x44 Display Scoreboard Current (unchanged)
0x44 0x45 Entity Metadata Current (unchanged)
0x45 0x46 Attach Entity Current (unchanged)
0x46 0x47 Entity Velocity Current (unchanged)
0x47 0x48 Entity Equipment Current (unchanged)
0x48 0x49 Set Experience Current (unchanged)
0x49 0x4A Update Health Current (unchanged)
0x4A 0x4B Scoreboard Objective Current (unchanged)
0x4B 0x4C Set Passengers Current (unchanged)
0x4C 0x4D Teams Current (unchanged)
0x4D 0x4E Update Score Current (unchanged)
0x59 Entity Properties Current Pre
Play serverbound
0x0F Generate Structure Pre
0x0F 0x10 Keep Alive (serverbound) Current (unchanged)
0x10 0x11 Lock Difficulty Current (unchanged)
0x11 0x12 Player Position Current (unchanged)
0x12 0x13 Player Position And Rotation (serverbound) Current (unchanged)
0x13 0x14 Player Rotation Current (unchanged)
0x14 0x15 Player Movement Current (unchanged)
0x15 0x16 Vehicle Move (serverbound) Current (unchanged)
0x16 0x17 Steer Boat Current (unchanged)
0x17 0x18 Pick Item Current (unchanged)
0x18 0x19 Craft Recipe Request Current (unchanged)
0x19 0x1A Player Abilities (serverbound) Current (unchanged)
0x1A 0x1B Player Digging Current (unchanged)
0x1B 0x1C Entity Action Current (unchanged)
0x1C 0x1D Steer Vehicle Current (unchanged)
0x1D 0x1E Recipe Book Data Current (unchanged)
0x1E 0x1F Name Item Current (unchanged)
0x1F 0x20 Resource Pack Status Current (unchanged)
0x20 0x21 Advancement Tab Current (unchanged)
0x21 0x22 Select Trade Current (unchanged)
0x22 0x23 Set Beacon Effect Current (unchanged)
0x23 0x24 Held Item Change (serverbound) Current (unchanged)
0x24 0x25 Update Command Block Current (unchanged)
0x25 0x26 Update Command Block Minecart Current (unchanged)
0x26 0x27 Creative Inventory Action Current (unchanged)
0x27 0x28 Update Jigsaw Block Current Pre
0x28 0x29 Update Structure Block Current (unchanged)
0x29 0x2A Update Sign Current (unchanged)
0x2A 0x2B Animation (serverbound) Current (unchanged)
0x2B 0x2C Spectate Current (unchanged)
0x2C 0x2D Player Block Placement Current (unchanged)
0x2D 0x2E Use Item Current (unchanged)
Login clientbound
0x02 Login Success Current Pre

New/modified data types

No changes so far.

Entity Metadata

FishingHook

Extends Entity.

Index Type Meaning Default
7 VarInt Hooked entity id + 1, or 0 if there is no hooked entity 0
8 Boolean Is catchable False

Abstract Arrow

Extends Entity.

Abstract base class for Tipped Arrow (which is used for regular arrows as well as tipped ones) and Spectral Arrow.

Index Type Meaning Default
7 Byte Bit mask Meaning 0
0x01 Is critical
0x02 Is noclip (used by loyalty tridents when returning)
8 OptUUID Unused Empty
9 8 Byte Peircing level 0

Tipped Arrow

Extends Abstract Arrow.

Used for both tipped and regular arrows. If not tipped, then color is set to -1 and no tipped arrow particles are used.

Index Type Meaning Default
10 9 VarInt Color (-1 for no particles) -1

Spectral Arrow

Extends Abstract Arrow.

No additional metadata.

Trident

Extends Abstract Arrow.

Index Type Meaning Default
10 9 VarInt Loyalty level (enchantment) 0
11 10 Boolean Has enchantment glint False

Strider

Extends Animal.

Index Type Meaning Default
16 VarInt Total time to "boost" with warped fungus on a stick for 0
17 Boolean Should display name tag (true unless riding a vehicle or on or in a block tagged with strider_warm_blocks (default: lava)) false
18 Boolean Has saddle false

Hoglin

Extends Animal.

Index Type Meaning Default
16 Boolean Is immune to zombification false

Zoglin

Extends Monster.

Index Type Meaning Default
15 Boolean Is baby false

Piglin

Extends Monster.

Index Type Meaning Default
15 Boolean Is baby false
16 Boolean Is immune to zombification false
17 Boolean Is charging crossbow false

Zombie Pigman Zombified Piglin

Extends Zombie.

No additional metadata.

Block Actions

No changes so far.

Inventories

No changes so far.

Plugin Channels

No changes so far.

Play

Clientbound

Chat Message (clientbound)

Identifying the difference between Chat/System Message is important as it helps respect the user's chat visibility options. See processing chat for more info about these positions.

Warning.png Game info accepts json formatting but does not display it, although the deprecated §-based formatting works. This is not an issue when using the Title packet, so prefer that packet for displaying information in that slot. See MC-119145 for more information.

Packet ID State Bound To Field Name Field Type Notes
0x0F Play Client JSON Data Chat Limited to 32767 bytes
Position Byte 0: chat (chat box), 1: system message (chat box), 2: game info (above hotbar).
Sender UUID Used by the Notchian client for the disableChat launch option. Setting both longs to 0 will always display the message regardless of the setting.

Chunk Data

Main article: Chunk Format
See also: #Unload Chunk
Huh.png The following information needs to be added to this page:
How do biomes work now? The biome change happened at the same time as the seed change, but it's not clear how/if biomes could be computed given that it's not the actual seed... (/r/mojira discussion which notes that it seems to be some kind of interpolation, and 3D biomes are only used in the nether)

The server only sends skylight information for chunk pillars in the Overworld, it's up to the client to know in which dimenison the player is currently located. You can also infer this information from the primary bitmask and the amount of uncompressed bytes sent. This packet also sends all block entities in the chunk (though sending them is not required; it is still legal to send them with Update Block Entity later).

Packet ID State Bound To Field Name Field Type Notes
0x22 Play Client Chunk X Int Chunk coordinate (block coordinate divided by 16, rounded down)
Chunk Z Int Chunk coordinate (block coordinate divided by 16, rounded down)
Full chunk Boolean See Chunk Format
Primary Bit Mask VarInt Bitmask with bits set to 1 for every 16×16×16 chunk section whose data is included in Data. The least significant bit represents the chunk section at the bottom of the chunk column (from y=0 to y=15).
Heightmaps NBT Compound containing one long array named MOTION_BLOCKING, which is a heightmap for the highest solid block at each position in the chunk (as a compacted long array with 256 entries at 9 bits per entry totaling 36 longs). The Notchian server also adds a WORLD_SURFACE long array, the purpose of which is unknown, but it's not required for the chunk to be accepted.
Biomes Optional array of Integer 1024 biome IDs, ordered by x then z then y, in 4×4×4 blocks. Not present if full chunk is false.
Size VarInt Size of Data in bytes
Data Byte array See data structure in Chunk Format
Number of block entities VarInt Number of elements in the following array
Block entities Array of NBT Tag All block entities in the chunk. Use the x, y, and z tags in the NBT to determine their positions.

Note that the Notchian client requires an Update View Position packet when it crosses a chunk border, otherwise it'll only display render distance + 2 chunks around the chunk it spawned in.

The compacted array format has been adjusted so that individual entries no longer span across multiple longs, affecting the main data array and heightmaps.

Join Game

See Protocol Encryption for information on logging in.

Packet ID State Bound To Field Name Field Type Notes
0x26 Play Client Entity ID Int The player's Entity ID (EID)
Gamemode Unsigned Byte 0: Survival, 1: Creative, 2: Adventure, 3: Spectator. Bit 3 (0x8) is the hardcore flag.
Dimension Codec NBT Tag Compound This CompoundTag contains a ListTag named "dimension". The ListTag should contain CompoundTags with named StringTags "key" and "element". The full extent of these is still unknown, but the tag represents a dimension registry. See below for the vanilla default.
Dimension Int Enum Identifier -1: The Nether, 0: The Overworld, 1: The End Valid dimensions are defined per dimension registry sent before this
Hashed seed Long First 8 bytes of the SHA-256 hash of the world's seed.
Max Players Unsigned Byte Was once used by the client to draw the player list, but now is ignored
Level Type String Enum (16) default, flat, largeBiomes, amplified, customized, buffet, default_1_1
View Distance VarInt Render distance (2-32)
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
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

Example of Dimension codec CompoundTag sent by the server:

   ListTag (Type: CompoundTag) "dimension":
       CompoundTag: 
           StringTag "key" value: 'minecraft:overworld'
           StringTag "element" value: 'minecraft:overworld'
       CompoundTag: 
           StringTag "key" value: 'minecraft:the_nether'
           StringTag "element" value: 'minecraft:the_nether'
       CompoundTag: 
           StringTag "key" value: 'minecraft:the_end'
           StringTag "element" value: 'minecraft:the_end'

Respawn

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
0x3B Play Client Dimension Int Enum Identifier -1: The Nether, 0: The Overworld, 1: The End Valid dimensions are defined per dimension registry sent in Join Game
Hashed seed Long First 8 bytes of the SHA-256 hash of the world's seed.
Gamemode Unsigned Byte 0: survival, 1: creative, 2: adventure, 3: spectator. The hardcore flag is not included
Level Type String (16) Same as Join Game
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
Copy metadata Boolean If false, metadata is reset on the respawned player entity. Set to true for dimension changes (including the dimension change triggered by sending client status perform respawn to exit the end poem/credits), and false for normal respawns.

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).

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.

Entity Properties

Sets attributes on the given entity.

Packet ID State Bound To Field Name Field Type Notes
0x59 Play Client Entity ID VarInt
Number Of Properties Int Number of elements in the following array
Property Key Array String (64) Identifier See below
Value Double See below
Number Of Modifiers VarInt Number of elements in the following array
Modifiers Array of Modifier Data See Attribute#Modifiers. Modifier Data defined below.

Known Key values (see also Attribute#Modifiers):

Key Default Min Max Label
generic.maxHealth generic.max_health 20.0 0.0 1024.0 Max Health
generic.followRange generic.follow_range 32.0 0.0 2048.0 Follow Range
generic.knockbackResistance generic.knockback_resistance 0.0 0.0 1.0 Knockback Resistance
generic.movementSpeed generic.movement_speed 0.7 0.0 1024.0 Movement Speed
generic.attackDamage generic.attack_damage 2.0 0.0 2048.0 Attack Damage
generic.attackSpeed generic.attack_speed 4.0 0.0 1024.0 Attack Speed
generic.flyingSpeed generic.flying_speed 0.4 0.0 1024.0 Flying Speed
generic.armor 0.0 0.0 30.0 Armor
generic.armorToughness generic.armor_toughness 0.0 0.0 20.0 Armor Toughness
generic.attackKnockback generic.attack_knockback 0.0 0.0 5.0
generic.luck 0.0 -1024.0 1024.0 Luck
horse.jumpStrength horse.jump_strength 0.7 0.0 2.0 Jump Strength
zombie.spawnReinforcements zombie.spawn_reinforcements 0.0 0.0 1.0 Spawn Reinforcements Chance
generic.reachDistance 5.0 0.0 1024.0 Player Reach Distance (Forge only)
forge.swimSpeed 1.0 0.0 1024.0 Swimming Speed (Forge only)

Unknown attributes will cause a game crash (MC-150405) due to the default minimum being larger than the default value.

Modifier Data structure:

Field Name Field Type Notes
UUID UUID
Amount Double May be positive or negative
Operation Byte See below

The operation controls how the base value of the modifier is changed.

  • 0: Add/subtract amount
  • 1: Add/subtract amount percent of the current value
  • 2: Multiply by amount percent

All of the 0's are applied first, and then the 1's, and then the 2's.

Serverbound

Generate Structure

Sent when Generate is pressed on the Jigsaw Block interface.

Packet ID State Bound To Field Name Field Type Notes
0x0F Play Server Location Position Block entity location
Levels VarInt Value of the levels slider/max depth to generate

Update Jigsaw Block

Sent when Done is pressed on the Jigsaw Block interface.

Packet ID State Bound To Field Name Field Type Notes
0x27 0x28 Play Server Location Position Block entity location
Attachment type Identifier
Name Identifier
Target Identifier
Target pool Pool Identifier
Final state String "Turns into" on the GUI, final_state in NBT
Joint type String rollable if the attached piece can be rotated, else aligned

Handshaking

Clientbound

There are no clientbound packets in the Handshaking state, since the protocol immediately switches to a different state after the client sends the first packet.

Serverbound

Handshake

This causes the server to switch into the target state.

Packet ID State Bound To Field Name Field Type Notes
0x00 Handshaking Server Protocol Version VarInt See protocol version numbers (currently 578 718)
Server Address String Hostname or IP, e.g. localhost or 127.0.0.1, that was used to connect. The Notchian server does not use this information. Note that SRV records are a complete redirect, e.g. if _minecraft._tcp.example.com points to mc.example.org, users connecting to example.com will provide mc.example.org as server address in addition to connecting to it.
Server Port Unsigned Short Default is 25565. The Notchian server does not use this information.
Next State VarInt Enum 1 for status, 2 for login

Status

Clientbound

No changes so far.

Serverbound

No changes so far.

Login

Clientbound

Login Success

Packet ID State Bound To Field Name Field Type Notes
0x02 Login Client UUID String (36) UUID Unlike in other packets, this field contains the UUID as a string with hyphens.
Username String (16)

This packet switches the connection state to play.

Serverbound

No changes so far.