Pre-release protocol

This page documents the changes from the last stable Minecraft release (currently 1.20.2, protocol 764) to the current pre-release (currently 23w45a, protocol Snapshot {{#expr: 1073741986 - 1073741824}}). 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

NBT

The NBT specification was changed so that the root tag is no longer required to be a Compound Tag when sent over the network.

Presently in the pre-release, only Compound Tag and String Tag types are used as root, but the Notchian server/client implementation is able to handle NBT Tags of any type.

Chat

The Chat type is now serialized as a NBT Tag instead of a JSON String, unless explicitly stated otherwise.

Name	Size (bytes)	Encodes	Notes
Chat	≥ 1 ≤ (262144×4) + 3	See Chat	Encoded as a String with max length of 262144.
Chat	Varies	See Chat	Encoded as a NBT Tag, with the type of tag used depending on the case: As a String Tag: For components only containing text (no styling, no events etc.). As a Compound Tag: Every other case.

This affects the following packets and data types containing Chat fields:

• Disconnect (configuration)
• Resource Pack (configuration)
• Boss Bar
• Command Suggestions Response
• Disconnect (play)
• Disguised Chat Message
• Map Data
• Open Screen
• Player Chat Message
• Combat Death
• Player Info Update
• Resource Pack (play)
• Server Data
• Set Action Bar Text
• Update Objectives
• Update Teams
• Set Subtitle Text
• Set Title Text
• System Chat Message
• Set Tab List Header And Footer
• Update Advancements

• Slot data type (values in the item NBT field)
• Chat entity metadata type
• OptChat entity metadata type

However, the following are NOT affected, as to maintain backwards compatibility with older versions:

• Disconnect (login)
• Server List status response (the description field)

Particle

Particle Name	Particle ID	Data
minecraft:ambient_entity_effect	0	None
minecraft:angry_villager	1	None
minecraft:block	2	Field Name Field Type Meaning BlockState VarInt The ID of the block state.
minecraft:block_marker	3	Field Name Field Type Meaning BlockState VarInt The ID of the block state.
minecraft:bubble	4	None
minecraft:cloud	5	None
minecraft:crit	6	None
minecraft:damage_indicator	7	None
minecraft:dragon_breath	8	None
minecraft:dripping_lava	9	None
minecraft:falling_lava	10	None
minecraft:landing_lava	11	None
minecraft:dripping_water	12	None
minecraft:falling_water	13	None
minecraft:dust	14	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. Scale Float The scale, will be clamped between 0.01 and 4.
minecraft:dust_color_transition	15	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. Scale Float The scale, will be clamped between 0.01 and 4. 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.
minecraft:effect	16	None
minecraft:elder_guardian	17	None
minecraft:enchanted_hit	18	None
minecraft:enchant	19	None
minecraft:end_rod	20	None
minecraft:entity_effect	21	None
minecraft:explosion_emitter	22	None
minecraft:explosion	23	None
minecraft:gust	24	None
minecraft:gust_emitter	25	None
minecraft:sonic_boom	24}}{{#if:26|{{#if:24| }}26}}	None
minecraft:falling_dust	25}}{{#if:27|{{#if:25| }}27}}	Field Name Field Type Meaning BlockState VarInt The ID of the block state.
minecraft:firework	26}}{{#if:28|{{#if:26| }}28}}	None
minecraft:fishing	27}}{{#if:29|{{#if:27| }}29}}	None
minecraft:flame	28}}{{#if:30|{{#if:28| }}30}}	None
minecraft:cherry_leaves	29}}{{#if:31|{{#if:29| }}31}}	None
minecraft:sculk_soul	30}}{{#if:32|{{#if:30| }}32}}	None
minecraft:sculk_charge	31}}{{#if:33|{{#if:31| }}33}}	Field Name Field Type Meaning Roll Float How much the particle will be rotated when displayed.
minecraft:sculk_charge_pop	32}}{{#if:34|{{#if:32| }}34}}	None
minecraft:soul_fire_flame	33}}{{#if:35|{{#if:33| }}35}}	None
minecraft:soul	34}}{{#if:36|{{#if:34| }}36}}	None
minecraft:flash	35}}{{#if:37|{{#if:35| }}37}}	None
minecraft:happy_villager	36}}{{#if:38|{{#if:36| }}38}}	None
minecraft:composter	37}}{{#if:39|{{#if:37| }}39}}	None
minecraft:heart	38}}{{#if:40|{{#if:38| }}40}}	None
minecraft:instant_effect	39}}{{#if:41|{{#if:39| }}41}}	None
minecraft:item	40}}{{#if:42|{{#if:40| }}42}}	Field Name Field Type Meaning Item Slot The item that will be used.
minecraft:vibration	41}}{{#if:43|{{#if:41| }}43}}	Field Name Field Type Meaning Position Source Type Identifier The type of the vibration source Block Position Position The position of the block the vibration originated from. Only present if Position Type is minecraft:block. Entity ID VarInt The ID of the entity the vibration originated from. Only present if Position Type is minecraft:entity. Entity eye height Float The height of the entity's eye relative to the entity. Only present if Position Type is minecraft:entity. Ticks VarInt The amount of ticks it takes for the vibration to travel from its source to its destination.
minecraft:item_slime	42}}{{#if:44|{{#if:42| }}44}}	None
minecraft:item_snowball	43}}{{#if:45|{{#if:43| }}45}}	None
minecraft:large_smoke	44}}{{#if:46|{{#if:44| }}46}}	None
minecraft:lava	45}}{{#if:47|{{#if:45| }}47}}	None
minecraft:mycelium	46}}{{#if:48|{{#if:46| }}48}}	None
minecraft:note	47}}{{#if:49|{{#if:47| }}49}}	None
minecraft:poof	48}}{{#if:50|{{#if:48| }}50}}	None
minecraft:portal	49}}{{#if:51|{{#if:49| }}51}}	None
minecraft:rain	50}}{{#if:52|{{#if:50| }}52}}	None
minecraft:smoke	51}}{{#if:53|{{#if:51| }}53}}	None
minecraft:white_smoke	54	None
minecraft:sneeze	52}}{{#if:55|{{#if:52| }}55}}	None
minecraft:spit	53}}{{#if:56|{{#if:53| }}56}}	None
minecraft:squid_ink	54}}{{#if:57|{{#if:54| }}57}}	None
minecraft:sweep_attack	55}}{{#if:58|{{#if:55| }}58}}	None
minecraft:totem_of_undying	56}}{{#if:59|{{#if:56| }}59}}	None
minecraft:underwater	57}}{{#if:60|{{#if:57| }}60}}	None
minecraft:splash	58}}{{#if:61|{{#if:58| }}61}}	None
minecraft:witch	59}}{{#if:62|{{#if:59| }}62}}	None
minecraft:bubble_pop	60}}{{#if:63|{{#if:60| }}63}}	None
minecraft:current_down	61}}{{#if:64|{{#if:61| }}64}}	None
minecraft:bubble_column_up	62}}{{#if:65|{{#if:62| }}65}}	None
minecraft:nautilus	63}}{{#if:66|{{#if:63| }}66}}	None
minecraft:dolphin	64}}{{#if:67|{{#if:64| }}67}}	None
minecraft:campfire_cosy_smoke	65}}{{#if:68|{{#if:65| }}68}}	None
minecraft:campfire_signal_smoke	66}}{{#if:69|{{#if:66| }}69}}	None
minecraft:dripping_honey	67}}{{#if:70|{{#if:67| }}70}}	None
minecraft:falling_honey	68}}{{#if:71|{{#if:68| }}71}}	None
minecraft:landing_honey	69}}{{#if:72|{{#if:69| }}72}}	None
minecraft:falling_nectar	70}}{{#if:73|{{#if:70| }}73}}	None
minecraft:falling_spore_blossom	71}}{{#if:74|{{#if:71| }}74}}	None
minecraft:ash	72}}{{#if:75|{{#if:72| }}75}}	None
minecraft:crimson_spore	73}}{{#if:76|{{#if:73| }}76}}	None
minecraft:warped_spore	74}}{{#if:77|{{#if:74| }}77}}	None
minecraft:spore_blossom_air	75}}{{#if:78|{{#if:75| }}78}}	None
minecraft:dripping_obsidian_tear	76}}{{#if:79|{{#if:76| }}79}}	None
minecraft:falling_obsidian_tear	77}}{{#if:80|{{#if:77| }}80}}	None
minecraft:landing_obsidian_tear	78}}{{#if:81|{{#if:78| }}81}}	None
minecraft:reverse_portal	79}}{{#if:82|{{#if:79| }}82}}	None
minecraft:white_ash	80}}{{#if:83|{{#if:80| }}83}}	None
minecraft:small_flame	81}}{{#if:84|{{#if:81| }}84}}	None
minecraft:snowflake	82}}{{#if:85|{{#if:82| }}85}}	None
minecraft:dripping_dripstone_lava	83}}{{#if:86|{{#if:83| }}86}}	None
minecraft:falling_dripstone_lava	84}}{{#if:87|{{#if:84| }}87}}	None
minecraft:dripping_dripstone_water	85}}{{#if:88|{{#if:85| }}88}}	None
minecraft:falling_dripstone_water	86}}{{#if:89|{{#if:86| }}89}}	None
minecraft:glow_squid_ink	87}}{{#if:90|{{#if:87| }}90}}	None
minecraft:glow	88}}{{#if:91|{{#if:88| }}91}}	None
minecraft:wax_on	89}}{{#if:92|{{#if:89| }}92}}	None
minecraft:wax_off	90}}{{#if:93|{{#if:90| }}93}}	None
minecraft:electric_spark	91}}{{#if:94|{{#if:91| }}94}}	None
minecraft:scrape	92}}{{#if:95|{{#if:92| }}95}}	None
minecraft:shriek	93}}{{#if:96|{{#if:93| }}96}}	Field Name Field Type Meaning Delay VarInt The time in ticks before the particle is displayed
minecraft:egg_crack	94}}{{#if:97|{{#if:94| }}97}}	None
minecraft:dust_plume	98	None
minecraft:gust_dust	99	None
minecraft:trial_spawner_detection	100	None

Packets

ID	Packet name	Documentation
Configuration clientbound
0x07	Feature Flags	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
Play clientbound
0x1E	Explosion	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x20	Game Event	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x6C	Set Ticking State	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x6D	Step Tick	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x6C}}{{#if:0x6E|{{#if:0x6C| }}0x6E}}	Update Advancements	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x6D}}{{#if:0x6F|{{#if:0x6D| }}0x6F}}	Update Attributes	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x6E}}{{#if:0x70|{{#if:0x6E| }}0x70}}	Entity Effect	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x6F}}{{#if:0x71|{{#if:0x6F| }}0x71}}	Update Recipes	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x70}}{{#if:0x72|{{#if:0x70| }}0x72}}	Update Tags	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
Play serverbound
0x0F	Change Container Slot State	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x0F}}{{#if:0x10|{{#if:0x0F| }}0x10}}	Serverbound Plugin Message (play)	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x10}}{{#if:0x11|{{#if:0x10| }}0x11}}	Edit Book	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x11}}{{#if:0x12|{{#if:0x11| }}0x12}}	Query Entity Tag	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x12}}{{#if:0x13|{{#if:0x12| }}0x13}}	Interact	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x13}}{{#if:0x14|{{#if:0x13| }}0x14}}	Jigsaw Generate	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x14}}{{#if:0x15|{{#if:0x14| }}0x15}}	Serverbound Keep Alive (play)	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x15}}{{#if:0x16|{{#if:0x15| }}0x16}}	Lock Difficulty	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x16}}{{#if:0x17|{{#if:0x16| }}0x17}}	Set Player Position	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x17}}{{#if:0x18|{{#if:0x17| }}0x18}}	Set Player Position and Rotation	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x18}}{{#if:0x19|{{#if:0x18| }}0x19}}	Set Player Rotation	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x19}}{{#if:0x1A|{{#if:0x19| }}0x1A}}	Set Player On Ground	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x1A}}{{#if:0x1B|{{#if:0x1A| }}0x1B}}	Move Vehicle	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x1B}}{{#if:0x1C|{{#if:0x1B| }}0x1C}}	Paddle Boat	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x1C}}{{#if:0x1D|{{#if:0x1C| }}0x1D}}	Pick Item	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x1D}}{{#if:0x1E|{{#if:0x1D| }}0x1E}}	Ping Request (play)	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x1E}}{{#if:0x1F|{{#if:0x1E| }}0x1F}}	Place Recipe	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x1F}}{{#if:0x20|{{#if:0x1F| }}0x20}}	Player Abilities	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x20}}{{#if:0x21|{{#if:0x20| }}0x21}}	Player Action	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x21}}{{#if:0x22|{{#if:0x21| }}0x22}}	Player Command	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x22}}{{#if:0x23|{{#if:0x22| }}0x23}}	Player Input	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x23}}{{#if:0x24|{{#if:0x23| }}0x24}}	Pong (play)	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x24}}{{#if:0x25|{{#if:0x24| }}0x25}}	Change Recipe Book Settings	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x25}}{{#if:0x26|{{#if:0x25| }}0x26}}	Set Seen Recipe	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x26}}{{#if:0x27|{{#if:0x26| }}0x27}}	Rename Item	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x27}}{{#if:0x28|{{#if:0x27| }}0x28}}	Resource Pack Response (play)	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x28}}{{#if:0x29|{{#if:0x28| }}0x29}}	Seen Advancements	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x29}}{{#if:0x2A|{{#if:0x29| }}0x2A}}	Select Trade	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x2A}}{{#if:0x2B|{{#if:0x2A| }}0x2B}}	Set Beacon Effect	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x2B}}{{#if:0x2C|{{#if:0x2B| }}0x2C}}	Set Held Item	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x2C}}{{#if:0x2D|{{#if:0x2C| }}0x2D}}	Program Command Block	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x2D}}{{#if:0x2E|{{#if:0x2D| }}0x2E}}	Program Command Block Minecart	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x2E}}{{#if:0x2F|{{#if:0x2E| }}0x2F}}	Set Creative Mode Slot	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x2F}}{{#if:0x30|{{#if:0x2F| }}0x30}}	Program Jigsaw Block	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x30}}{{#if:0x31|{{#if:0x30| }}0x31}}	Program Structure Block	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x31}}{{#if:0x32|{{#if:0x31| }}0x32}}	Update Sign	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x32}}{{#if:0x33|{{#if:0x32| }}0x33}}	Swing Arm	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x33}}{{#if:0x34|{{#if:0x33| }}0x34}}	Teleport To Entity	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x34}}{{#if:0x35|{{#if:0x34| }}0x35}}	Use Item On	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}
0x35}}{{#if:0x36|{{#if:0x35| }}0x36}}	Use Item	added	Current }}	removed	unchanged | (unchanged) | Pre }} }}

New/modified data types

No changes so far.

Entity Metadata

Type (VarInt Enum)	Value (Varies)	Notes
0	Byte
1	VarInt
2	VarLong
3	Float
4	String
5	Chat
6	OptChat (Boolean + Chat)	Chat is present if the Boolean is set to true
7	Slot
8	Boolean
9	Rotation	3 Floats: rotation on x, rotation on y, rotation on z
10	Position
11	OptPosition (Boolean + Position)	Position is present if the Boolean is set to true
12	Direction (VarInt)	(Down = 0, Up = 1, North = 2, South = 3, West = 4, East = 5)
13	OptUUID (Boolean + UUID)	UUID is present if the Boolean is set to true
14	BlockID (VarInt)
15	OptBlockID (VarInt)	0 for absent (implies air); otherwise, a block state ID as per the global palette
16	NBT
17	Particle
18	Villager Data	3 VarInts: villager type, villager profession, level
19	OptVarInt	0 for absent; 1 + actual value otherwise. Used for entity IDs.
20	Pose	A VarInt enum: 0: STANDING, 1: FALL_FLYING, 2: SLEEPING, 3: SWIMMING, 4: SPIN_ATTACK, 5: SNEAKING, 6: LONG_JUMPING, 7: DYING, 8: CROAKING, 9: USING_TONGUE, 10: SITTING, 11: ROARING, 12: SNIFFING, 13: EMERGING, 14: DIGGING{{#if:|}}{{#if:, 15: SLIDING, 16: SHOOTING, 17: INHALING|{{#if:| }}, 15: SLIDING, 16: SHOOTING, 17: INHALING}}
21	Cat Variant	A VarInt that points towards the CAT_VARIANT registry.
22	Frog Variant	A VarInt that points towards the FROG_VARIANT registry.
23	OptGlobalPos (Boolean + GlobalPos)	GlobalPos consists of a dimension identifier and Position.
24	Painting Variant	A VarInt that points towards the PAINTING_VARIANT registry.
25	Sniffer State	A VarInt enum: IDLING = 0, FEELING_HAPPY = 1, SCENTING = 2, SNIFFING = 3, SEARCHING = 4, DIGGING = 5, RISING = 6
26	Vector3	3 Floats: x, y, z
27	Quaternion	4 Floats: x, y, z, w

Abstract Vehicle

{{#if:Abstract Vehicle||}} {{#vardefine:meta_current_entity|Abstract Vehicle}}

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

   {{#if:Entity
       | {{#if:
           | Extends {{#if:[[{{#varexists:meta_Entity|Entity metadata}}#Entity|Entity]]|[[{{#varexists:meta_Entity|Entity metadata}}#Entity|Entity]]}}{{#if:[[{{#varexists:meta_{{{pre_inherits}}}|Entity metadata}}#{{{pre_inherits}}}|{{{pre_inherits}}}]]|{{#if:[[{{#varexists:meta_Entity|Entity metadata}}#Entity|Entity]]| }}[[{{#varexists:meta_{{{pre_inherits}}}|Entity metadata}}#{{{pre_inherits}}}|{{{pre_inherits}}}]]}}.
           | Extends [[{{#varexists:meta_Entity|Entity metadata}}#Entity|Entity]].
       }}{{#if:8
           | {{#vardefine:meta_Abstract Vehicle|8}}
           {{#if:{{#varexists:meta_Entity}}|start_at in use when inherited entity Entity exists}}
           | {{#vardefine:meta_Abstract Vehicle|{{#var:meta_Entity|0}}}}
           {{#if:{{#varexists:meta_Entity}}||}}
       }}{{#if:8
           | {{#vardefine:meta_pre_Abstract Vehicle|8}}
           {{#if:{{#varexists:meta_Entity}}|start_at in use when inherited entity Entity exists}}
           | {{#vardefine:meta_pre_Abstract Vehicle|{{#var:meta_pre_Entity|0}}}}
           {{#if:{{#varexists:meta_Entity}}||}}
       }}
       | The base class.
       {{#vardefine:meta_Abstract Vehicle|8}}
       {{#vardefine:meta_pre_Abstract Vehicle|8}}
   }}

|

   {{#if:Entity
       | Extends Entity.
       {{#if:8
           | {{#vardefine:meta_Abstract Vehicle|8}}
           {{#if:{{#varexists:meta_Entity}}|start_at in use when inherited entity Entity exists}}
           | {{#vardefine:meta_Abstract Vehicle|{{#var:meta_Entity|0}}}}
           {{#if:{{#varexists:meta_Entity}}||}}
       }}
       | The base class.
       {{#vardefine:meta_Abstract Vehicle|8}}
   }}

}}

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 = }}	{{#vardefineecho:cur_meta|{{#var:meta_{{#var:meta_current_entity}}}}}} {{#vardefine:meta_{{#var:meta_current_entity}}|{{#expr:{{#var:cur_meta}}+1}}}} {{#ifeq: |||}} }}	VarInt	Shaking power		0
{{#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 = }}	{{#vardefineecho:cur_meta|{{#var:meta_{{#var:meta_current_entity}}}}}} {{#vardefine:meta_{{#var:meta_current_entity}}|{{#expr:{{#var:cur_meta}}+1}}}} {{#ifeq: |||}} }}	VarInt	Shaking direction		1
{{#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 = }}	{{#vardefineecho:cur_meta|{{#var:meta_{{#var:meta_current_entity}}}}}} {{#vardefine:meta_{{#var:meta_current_entity}}|{{#expr:{{#var:cur_meta}}+1}}}} {{#ifeq: |||}} }}	Float	Shaking multiplier		0.0

Abstract Minecart

{{#if:Abstract Minecart||}} {{#vardefine:meta_current_entity|Abstract Minecart}}

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

   {{#if:Abstract Vehicle
       | {{#if:
           | Extends {{#if:[[{{#varexists:meta_Abstract Vehicle|Entity metadata}}#Abstract Vehicle|Abstract Vehicle]]|[[{{#varexists:meta_Abstract Vehicle|Entity metadata}}#Abstract Vehicle|Abstract Vehicle]]}}{{#if:[[{{#varexists:meta_{{{pre_inherits}}}|Entity metadata}}#{{{pre_inherits}}}|{{{pre_inherits}}}]]|{{#if:[[{{#varexists:meta_Abstract Vehicle|Entity metadata}}#Abstract Vehicle|Abstract Vehicle]]| }}[[{{#varexists:meta_{{{pre_inherits}}}|Entity metadata}}#{{{pre_inherits}}}|{{{pre_inherits}}}]]}}.
           | Extends [[{{#varexists:meta_Abstract Vehicle|Entity metadata}}#Abstract Vehicle|Abstract Vehicle]].
       }}{{#if:
           | {{#vardefine:meta_Abstract Minecart|{{{start_at}}}}}
           {{#if:{{#varexists:meta_Abstract Vehicle}}|start_at in use when inherited entity Abstract Vehicle exists}}
           | {{#vardefine:meta_Abstract Minecart|{{#var:meta_Abstract Vehicle|0}}}}
           {{#if:{{#varexists:meta_Abstract Vehicle}}||}}
       }}{{#if:
           | {{#vardefine:meta_pre_Abstract Minecart|}}
           {{#if:{{#varexists:meta_Abstract Vehicle}}|start_at in use when inherited entity Abstract Vehicle exists}}
           | {{#vardefine:meta_pre_Abstract Minecart|{{#var:meta_pre_Abstract Vehicle|0}}}}
           {{#if:{{#varexists:meta_Abstract Vehicle}}||}}
       }}
       | The base class.
       {{#vardefine:meta_Abstract Minecart|0}}
       {{#vardefine:meta_pre_Abstract Minecart|0}}
   }}

|

   {{#if:Abstract Vehicle
       | Extends Abstract Vehicle.
       {{#if:
           | {{#vardefine:meta_Abstract Minecart|{{{start_at}}}}}
           {{#if:{{#varexists:meta_Abstract Vehicle}}|start_at in use when inherited entity Abstract Vehicle exists}}
           | {{#vardefine:meta_Abstract Minecart|{{#var:meta_Abstract Vehicle|0}}}}
           {{#if:{{#varexists:meta_Abstract Vehicle}}||}}
       }}
       | The base class.
       {{#vardefine:meta_Abstract Minecart|0}}
   }}

}}

Index	Type	Meaning		Default
8	VarInt	Shaking power		0
9	VarInt	Shaking direction		1
10	Float	Shaking multiplier		0.0
11	VarInt	Custom block ID and damage		0
12	VarInt	Custom block Y position (in 16ths of a block)		6
13	Boolean	Show custom block		false

Boat

{{#if:Boat||}} {{#vardefine:meta_current_entity|Boat}}

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

   {{#if:Abstract Vehicle
       | {{#if:
           | Extends {{#if:[[{{#varexists:meta_Abstract Vehicle|Entity metadata}}#Abstract Vehicle|Abstract Vehicle]]|[[{{#varexists:meta_Abstract Vehicle|Entity metadata}}#Abstract Vehicle|Abstract Vehicle]]}}{{#if:[[{{#varexists:meta_{{{pre_inherits}}}|Entity metadata}}#{{{pre_inherits}}}|{{{pre_inherits}}}]]|{{#if:[[{{#varexists:meta_Abstract Vehicle|Entity metadata}}#Abstract Vehicle|Abstract Vehicle]]| }}[[{{#varexists:meta_{{{pre_inherits}}}|Entity metadata}}#{{{pre_inherits}}}|{{{pre_inherits}}}]]}}.
           | Extends [[{{#varexists:meta_Abstract Vehicle|Entity metadata}}#Abstract Vehicle|Abstract Vehicle]].
       }}{{#if:
           | {{#vardefine:meta_Boat|{{{start_at}}}}}
           {{#if:{{#varexists:meta_Abstract Vehicle}}|start_at in use when inherited entity Abstract Vehicle exists}}
           | {{#vardefine:meta_Boat|{{#var:meta_Abstract Vehicle|0}}}}
           {{#if:{{#varexists:meta_Abstract Vehicle}}||}}
       }}{{#if:
           | {{#vardefine:meta_pre_Boat|}}
           {{#if:{{#varexists:meta_Abstract Vehicle}}|start_at in use when inherited entity Abstract Vehicle exists}}
           | {{#vardefine:meta_pre_Boat|{{#var:meta_pre_Abstract Vehicle|0}}}}
           {{#if:{{#varexists:meta_Abstract Vehicle}}||}}
       }}
       | The base class.
       {{#vardefine:meta_Boat|0}}
       {{#vardefine:meta_pre_Boat|0}}
   }}

|

   {{#if:Abstract Vehicle
       | Extends Abstract Vehicle.
       {{#if:
           | {{#vardefine:meta_Boat|{{{start_at}}}}}
           {{#if:{{#varexists:meta_Abstract Vehicle}}|start_at in use when inherited entity Abstract Vehicle exists}}
           | {{#vardefine:meta_Boat|{{#var:meta_Abstract Vehicle|0}}}}
           {{#if:{{#varexists:meta_Abstract Vehicle}}||}}
       }}
       | The base class.
       {{#vardefine:meta_Boat|0}}
   }}

}}

Index	Type	Meaning		Default
8	VarInt	Time since last hit		0
9	VarInt	Forward direction		1
10	Float	Damage taken		0.0
11	VarInt	Type (0=oak, 1=spruce, 2=birch, 3=jungle, 4=acacia, 5=dark oak)		0
12	Boolean	Is left paddle turning		false
13	Boolean	Is right paddle turning		false
14	VarInt	Splash timer		0

Block Actions

No changes so far.

Inventories

No changes so far.

Plugin Channels

No changes so far.

Status

Clientbound

No changes so far.

Serverbound

No changes so far.

Login

Clientbound

No changes so far.

Serverbound

No changes so far.

Configuration

Clientbound

Feature Flags

Used to enable and disable features, generally experimental ones, on the client.

Packet ID	State	Bound To	Field Name	Field Type	Notes
0x07	Configuration	Client	Total Features	VarInt	Number of features that appear in the array below.
			Feature Flags	Identifier Array

As of {{#if:1.20.2|1.20.2}}{{#if:1.20.3|{{#if:1.20.2| }}1.20.3}}, the following feature flags are available:

• minecraft:vanilla - enables vanilla features
• minecraft:bundle - enables support for the bundle
• minecraft:trade_rebalance - enables support for the rebalanced villager trades
• {{#if:|}}{{#if:minecraft:update_1_21 - enables support for 1.21 features|{{#if:| }}minecraft:update_1_21 - enables support for 1.21 features}}

Serverbound

No changes so far.

Play

Clientbound

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

There is currently a disparity in the Notchian implementation between the data that is read from and written to the network. The write logic only serializes the particle id for the fields Small explosion particle and Large explosion particle, while the read logic expects the particle id and extra required data. See MC-266537 for more information.

Packet ID	State	Bound To	Field Name		Field Type	Notes
0x1E	Play	Client	X		Double
			Y		Double
			Z		Double
			Strength		Float	A strength greater than or equal to 2.0 spawns a minecraft:explosion_emitter particle, while a lesser strength spawns a minecraft:explosion particle.}}{{#if:|{{#if:A strength greater than or equal to 2.0 spawns a minecraft:explosion_emitter particle, while a lesser strength spawns a minecraft:explosion particle.| }}{{{2}}}}} {{#if:|}}{{#if: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.|{{#if:| }}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.
			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.
			Block interaction		VarInt Enum	0 = keep, 1 = destroy, 2 = destroy_with_decay, 3 = trigger_block.
			Small explosion particle		VarInt	The particle ID listed in the particle data type.
			Large explosion particle		VarInt	The particle ID listed in the particle data type.
			Explosion sound	Sound Name	Identifier	The name of the sound played.
				Has Fixed Range	Optional Boolean	Whether is has fixed range.
				Range	Optional Float	The fixed range of the sound. Only present if previous boolean is true.

Game Event

Used for a wide variety of game events, from weather to bed use to game mode to demo messages.

Packet ID	State	Bound To	Field Name	Field Type	Notes
0x20	Play	Client	Event	Unsigned Byte	See below.
			Value	Float	Depends on Event.

Events:

Event	Effect	Value
0	No respawn block available	Note: Displays message 'block.minecraft.spawn.not_valid' (You have no home bed or charged respawn anchor, or it was obstructed) to the player.
1	Begin raining
2	End raining
3	Change game mode	0: Survival, 1: Creative, 2: Adventure, 3: Spectator.
4	Win game	0: Just respawn player. 1: Roll the credits and respawn player. Note that 1 is only sent by notchian server when player has not yet achieved advancement "The end?", else 0 is sent.
5	Demo event	0: Show welcome to demo screen. 101: Tell movement controls. 102: Tell jump control. 103: Tell inventory control. 104: Tell that the demo is over and print a message about how to take a screenshot.
6	Arrow hit player	Note: Sent when any player is struck by an arrow.
7	Rain level change	Note: Seems to change both sky color and lighting. Rain level ranging from 0 to 1.
8	Thunder level change	Note: Seems to change both sky color and lighting (same as Rain level change, but doesn't start rain). It also requires rain to render by notchian client. Thunder level ranging from 0 to 1.
9	Play pufferfish sting sound
10	Play elder guardian mob appearance (effect and sound)
11	Enable respawn screen	0: Enable respawn screen. 1: Immediately respawn (sent when the doImmediateRespawn gamerule changes).
12	Limited crafting	0: Disable limited crafting. 1: Enable limited crafting (sent when the doLimitedCrafting gamerule changes).
13	Start waiting for level chunks	Instructs the client to begin the waiting process for the level chunks. Sent by the server after the level is cleared on the client and is being re-sent (either during the first, or subsequent reconfigurations).

Set Ticking State

Used to adjust the ticking rate of the client, and whether it's frozen.

Packet ID	State	Bound To	Field Name	Field Type	Notes
0x6C	Play	Server	Tick rate	Float
			Is frozen	Boolean

Step Tick

Advances the client processing by the specified number of ticks. Has no effect is the client ticking is not frozen.

Packet ID	State	Bound To	Field Name	Field Type	Notes
0x6D	Play	Client	Tick steps	VarInt

Update Recipes

Packet ID	State	Bound To	Field Name		Field Type		Notes
{{#if:0x6F|0x6F}}{{#if:0x71|{{#if:0x6F| }}0x71}}	Play	Client	Num Recipes		VarInt		Number of elements in the following array.
			Recipe	Type	Array	Identifier	The recipe type, see below.
				Recipe ID		Identifier
				Data		Varies	Additional data for the recipe.

Recipe types:

Type	Description	Data
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
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 Width VarInt Height VarInt 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.
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
minecraft:crafting_special_bookcloning	Recipe for copying contents of written books
minecraft:crafting_special_mapcloning	Recipe for copying maps
minecraft:crafting_special_mapextending	Recipe for adding paper to maps
minecraft:crafting_special_firework_rocket	Recipe for making firework rockets
minecraft:crafting_special_firework_star	Recipe for making firework stars
minecraft:crafting_special_firework_star_fade	Recipe for making firework stars fade between multiple colors
minecraft:crafting_special_repairitem	Recipe for repairing items via crafting
minecraft:crafting_special_tippedarrow	Recipe for crafting tipped arrows
minecraft:crafting_special_bannerduplicate	Recipe for copying banner patterns
minecraft:crafting_special_shielddecoration	Recipe for applying a banner's pattern to a shield
minecraft:crafting_special_shulkerboxcoloring	Recipe for recoloring a shulker box
minecraft:crafting_special_suspiciousstew	Recipe for crafting suspicious stews
minecraft:crafting_decorated_pot	Recipe for crafting decorated pots
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
minecraft:blasting	Blast furnace recipe
minecraft:smoking	Smoker recipe
minecraft:campfire_cooking	Campfire recipe
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
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
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

Change Container Slot State

This packet is sent by the client when toggling the state of a Crafter.

Packet ID	State	Bound To	Field Name	Field Type	Notes
0x0F	Play	Server	Slot ID	VarInt	This is the ID of the slot that was changed.
			Window ID	VarInt	This is the ID of the window that was changed.
			State	Boolean	The new state of the slot. True for enabled, false for disabled.

Program Jigsaw Block

Sent when Done is pressed on the Jigsaw Block interface.

Packet ID	State	Bound To	Field Name	Field Type	Notes
0x2F	Play	Server	Location	Position	Block entity location
			Name	Identifier
			Target	Identifier
			Pool	Identifier
			Final state	String (32767)	"Turns into" on the GUI, final_state in NBT.
			Joint type	String (32767)	rollable if the attached piece can be rotated, else aligned.
			Selection priority	VarInt
			Placement priority	VarInt