Pre-release protocol

From wiki.vg
Revision as of 18:46, 14 February 2020 by imported>Pokechu22 (→‎Entity Metadata: Document. (Note: in 20w06a, hoglin extended monster without additional metadata and piglin did not exist))
Jump to navigation Jump to search

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

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

Contents

Data types

No changes so far.

Packets

ID Packet name Documentation
Handshaking serverbound
0x00 Handshake added Current }} removed unchanged | (unchanged) | Pre }} }}

New/modified data types

No changes so far.

Entity Metadata

{{#vardefine:meta_prerelease|1}}No changes so far.

Hoglin

{{#if:Pig||Must specify the current entity ID for Template:Metadata inherit}} {{#vardefine:meta_current_entity|Pig}}

{{#if:{{#var:meta_prerelease}}|

   {{#if:Animal
       | {{#if:
           | Extends {{#if:[[{{#varexists:meta_Animal|Entity metadata}}#Animal|Animal]]|[[{{#varexists:meta_Animal|Entity metadata}}#Animal|Animal]]}}{{#if:[[{{#varexists:meta_{{{pre_inherits}}}|Entity metadata}}#{{{pre_inherits}}}|{{{pre_inherits}}}]]|{{#if:[[{{#varexists:meta_Animal|Entity metadata}}#Animal|Animal]]| }}[[{{#varexists:meta_{{{pre_inherits}}}|Entity metadata}}#{{{pre_inherits}}}|{{{pre_inherits}}}]]}}.
           | Extends [[{{#varexists:meta_Animal|Entity metadata}}#Animal|Animal]].
       }}{{#if:16
           | {{#vardefine:meta_Pig|16}}
           {{#if:{{#varexists:meta_Animal}}|start_at in use when inherited entity Animal exists}}
           | {{#vardefine:meta_Pig|{{#var:meta_Animal|0}}}}
           {{#if:{{#varexists:meta_Animal}}||Inherited entity Animal does not exist}}
       }}{{#if:16
           | {{#vardefine:meta_pre_Pig|16}}
           {{#if:{{#varexists:meta_Animal}}|start_at in use when inherited entity Animal exists}}
           | {{#vardefine:meta_pre_Pig|{{#var:meta_pre_Animal|0}}}}
           {{#if:{{#varexists:meta_Animal}}||Inherited entity Animal does not exist}}
       }}
       | The base class.
       {{#vardefine:meta_Pig|16}}
       {{#vardefine:meta_pre_Pig|16}}
   }}

|

   {{#if:Animal
       | Extends Animal.
       {{#if:16
           | {{#vardefine:meta_Pig|16}}
           {{#if:{{#varexists:meta_Animal}}|start_at in use when inherited entity Animal exists}}
           | {{#vardefine:meta_Pig|{{#var:meta_Animal|0}}}}
           {{#if:{{#varexists:meta_Animal}}||Inherited entity Animal does not exist}}
       }}
       | The base class.
       {{#vardefine:meta_Pig|16}}
   }}

}}

No additional metadata.

Piglin

{{#if:Pig||Must specify the current entity ID for Template:Metadata inherit}} {{#vardefine:meta_current_entity|Pig}}

{{#if:{{#var:meta_prerelease}}|

   {{#if:Monster
       | {{#if:
           | Extends {{#if:[[{{#varexists:meta_Monster|Entity metadata}}#Monster|Monster]]|[[{{#varexists:meta_Monster|Entity metadata}}#Monster|Monster]]}}{{#if:[[{{#varexists:meta_{{{pre_inherits}}}|Entity metadata}}#{{{pre_inherits}}}|{{{pre_inherits}}}]]|{{#if:[[{{#varexists:meta_Monster|Entity metadata}}#Monster|Monster]]| }}[[{{#varexists:meta_{{{pre_inherits}}}|Entity metadata}}#{{{pre_inherits}}}|{{{pre_inherits}}}]]}}.
           | Extends [[{{#varexists:meta_Monster|Entity metadata}}#Monster|Monster]].
       }}{{#if:15
           | {{#vardefine:meta_Pig|15}}
           {{#if:{{#varexists:meta_Monster}}|start_at in use when inherited entity Monster exists}}
           | {{#vardefine:meta_Pig|{{#var:meta_Monster|0}}}}
           {{#if:{{#varexists:meta_Monster}}||Inherited entity Monster does not exist}}
       }}{{#if:15
           | {{#vardefine:meta_pre_Pig|15}}
           {{#if:{{#varexists:meta_Monster}}|start_at in use when inherited entity Monster exists}}
           | {{#vardefine:meta_pre_Pig|{{#var:meta_pre_Monster|0}}}}
           {{#if:{{#varexists:meta_Monster}}||Inherited entity Monster does not exist}}
       }}
       | The base class.
       {{#vardefine:meta_Pig|15}}
       {{#vardefine:meta_pre_Pig|15}}
   }}

|

   {{#if:Monster
       | Extends Monster.
       {{#if:15
           | {{#vardefine:meta_Pig|15}}
           {{#if:{{#varexists:meta_Monster}}|start_at in use when inherited entity Monster exists}}
           | {{#vardefine:meta_Pig|{{#var:meta_Monster|0}}}}
           {{#if:{{#varexists:meta_Monster}}||Inherited entity Monster does not exist}}
       }}
       | The base class.
       {{#vardefine:meta_Pig|15}}
   }}

}}

Index Type Meaning Default
   {{#vardefine:cur_meta|{{#var:meta_{{#var:meta_current_entity}}}}}}
   {{#vardefine:pre_meta|{{#var:meta_pre_{{#var:meta_current_entity}}}}}}
   {{#switch: 
added =
       {{#if:|}}{{#if:{{#var:pre_meta}}|{{#if:| }}{{#var:pre_meta}}}}
       {{#vardefine:meta_pre_{{#var:meta_current_entity}}|{{#expr:{{#var:pre_meta}}+1}}}}
removed =
       {{#if:{{#var:cur_meta}}|{{#var:cur_meta}}}}{{#if:|{{#if:{{#var:cur_meta}}| }}}}
       {{#vardefine:meta_{{#var:meta_current_entity}}|{{#expr:{{#var:cur_meta}}+1}}}}
=
       {{#ifeq: {{#var:cur_meta}}|{{#var:pre_meta}} | {{#var:cur_meta}} | {{#if:{{#var:cur_meta}}|{{#var:cur_meta}}}}{{#if:{{#var:pre_meta}}|{{#if:{{#var:cur_meta}}| }}{{#var:pre_meta}}}} }}
       {{#vardefine:meta_{{#var:meta_current_entity}}|{{#expr:{{#var:cur_meta}}+1}}}}
       {{#vardefine:meta_pre_{{#var:meta_current_entity}}|{{#expr:{{#var:pre_meta}}+1}}}}
#default =
       Invalid parameter to Template:Metadata id 
   }}
   {{#vardefineecho:cur_meta|{{#var:meta_{{#var:meta_current_entity}}}}}}
   {{#vardefine:meta_{{#var:meta_current_entity}}|{{#expr:{{#var:cur_meta}}+1}}}}
   {{#ifeq: |||Template:Metadata id must be used as {{Metadata id|}} (with an empty first parameter) for technical reasons}}

}}

Boolean Is baby false
   {{#vardefine:cur_meta|{{#var:meta_{{#var:meta_current_entity}}}}}}
   {{#vardefine:pre_meta|{{#var:meta_pre_{{#var:meta_current_entity}}}}}}
   {{#switch: 
added =
       {{#if:|}}{{#if:{{#var:pre_meta}}|{{#if:| }}{{#var:pre_meta}}}}
       {{#vardefine:meta_pre_{{#var:meta_current_entity}}|{{#expr:{{#var:pre_meta}}+1}}}}
removed =
       {{#if:{{#var:cur_meta}}|{{#var:cur_meta}}}}{{#if:|{{#if:{{#var:cur_meta}}| }}}}
       {{#vardefine:meta_{{#var:meta_current_entity}}|{{#expr:{{#var:cur_meta}}+1}}}}
=
       {{#ifeq: {{#var:cur_meta}}|{{#var:pre_meta}} | {{#var:cur_meta}} | {{#if:{{#var:cur_meta}}|{{#var:cur_meta}}}}{{#if:{{#var:pre_meta}}|{{#if:{{#var:cur_meta}}| }}{{#var:pre_meta}}}} }}
       {{#vardefine:meta_{{#var:meta_current_entity}}|{{#expr:{{#var:cur_meta}}+1}}}}
       {{#vardefine:meta_pre_{{#var:meta_current_entity}}|{{#expr:{{#var:pre_meta}}+1}}}}
#default =
       Invalid parameter to Template:Metadata id 
   }}
   {{#vardefineecho:cur_meta|{{#var:meta_{{#var:meta_current_entity}}}}}}
   {{#vardefine:meta_{{#var:meta_current_entity}}|{{#expr:{{#var:cur_meta}}+1}}}}
   {{#ifeq: |||Template:Metadata id must be used as {{Metadata id|}} (with an empty first parameter) for technical reasons}}

}}

Boolean Is charging crossbow false

Block Actions

No changes so far.

Inventories

No changes so far.

Plugin Channels

No changes so far.

Play

Clientbound

No changes so far.

Serverbound

No changes so far.

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 {{#if:578|578}}{{#if:702|{{#if:578| }}702}})
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

No changes so far.

Serverbound

No changes so far.