Minecraft:Java Edition protocol/Packets - Revision history

SyncBot: Sync: updated from Minecraft

2026-10-19T11:16:42Z

Sync: updated from Minecraft

@@ Line 3,122: / Line 3,122: @@
 | {{Type|VarInt}} {{Type|Enum}}
-  | Determines how the following position path data is encoded; see below.
+  | Determines how the following position path data is encoded, values are:
   |-
   | rowspan="3" | Path type = 0 (Linear)
@@ Line 3,157: / Line 3,159: @@
+  |
 |}
 ==== Explosion ====

SyncBot: Sync: updated from Minecraft

2026-10-18T11:13:03Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:13, 18 October 2026
Line 1,302:		Line 1,302:
	\|-		\|-
	\| 0		\| 0
	\| Successfully ~~downloaded~~		\| Successfully loaded
	\|-		\|-
	\| 1		\| 1

SyncBot: Sync: updated from Minecraft

2026-10-15T11:11:49Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:11, 15 October 2026
Line 3,114:		Line 3,114:
	! Notes		! Notes
	\|-		\|-
	\| Always		\| rowspan="2" \| Always
	\| Entity ID		\| Entity ID
	\| {{Type\|VarInt}}		\| {{Type\|VarInt}}
	\|		\|
	\|-		\|-
	~~\| Always~~		\| Position Path Type
	\| Position Path Type
	\| {{Type\|VarInt}} {{Type\|Enum}}		\| {{Type\|VarInt}} {{Type\|Enum}}
	\| Determines how the following position path data is encoded; see below.		\| Determines how the following position path data is encoded; see below.
	\|-		\|-
	\| Path type = 0 (Linear)		\| rowspan="3" \| Path type = 0 (Linear)
	\| X		\| X
	\| {{Type\|Double}}		\| {{Type\|Double}}
	\| rowspan="3"\| Absolute end position.		\| rowspan="3"\| Absolute end position.
	\|-		\|-
	\| ~~Path type = 0 (Linear)~~		\| Y
	~~\| Y~~
	\| {{Type\|Double}}		\| {{Type\|Double}}
	\|-		\|-
	\| ~~Path type = 0 (Linear)~~		\| Z
	~~\| Z~~
	\| {{Type\|Double}}		\| {{Type\|Double}}
	\|-		\|-
	\| Path type = 1 (Stepped)		\| Path type = 1 (Stepped)
	\| Steps		\| Steps
	\| {{Type\|Prefixed Array}} of Position Step		\| {{Type\|Prefixed Array}} of {{Type\|Position Step}}
	\| Sequence of absolute position steps; see below.		\| Sequence of absolute position steps; see below.
	\|-		\|-
	\| Always		\| rowspan="3" \| Always
	\| Yaw		\| Yaw
	\| {{Type\|Float}}		\| {{Type\|Float}}
	\| Rotation around the vertical axis, in degrees.		\| Rotation around the vertical axis, in degrees.
	\|-		\|-
	\| ~~Always~~		\| Pitch
	~~\| Pitch~~
	\| {{Type\|Float}}		\| {{Type\|Float}}
	\| Rotation around the horizontal axis, in degrees.		\| Rotation around the horizontal axis, in degrees.
	\|-		\|-
	~~\| Always~~		\| On Ground
	\| On Ground
	\| {{Type\|Boolean}}		\| {{Type\|Boolean}}
	\|		\|
	\|}		\|}

SyncBot: Sync: updated from Minecraft

2026-10-08T11:08:08Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:08, 8 October 2026
Line 5,579:		Line 5,579:
	==== Update Section Blocks ====		==== Update Section Blocks ====

	Fired whenever 2 or more blocks are changed within the same chunk on the same tick.		Fired whenever 2 or more blocks are changed within the same chunk section on the same tick.

	{\| class="wikitable"		{\| class="wikitable"

SyncBot: Sync: updated from Minecraft

2026-10-02T11:09:28Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:09, 2 October 2026
Line 5,478:		Line 5,478:

	==== Respawn ====		==== Respawn ====

	{{missing info\|section\|Although the number of portal cooldown ticks is included in this packet, the whole portal usage process is still dictated entirely by the server. What kind of effect does this value have on the client, if any?}}

	To change the player's dimension (overworld/nether/end), send them a respawn packet with the appropriate dimension, followed by prechunks/chunks for the new dimension, and finally a position and look packet. You do not need to unload chunks; the client will do it automatically.		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.
Line 5,534:		Line 5,532:
	\| Portal cooldown		\| Portal cooldown
	\| {{Type\|VarInt}}		\| {{Type\|VarInt}}
	\| The number of ticks until the player can use the portal again.		\| The number of ticks until the player can use the portal again. Unused by the client.
	\|-		\|-
	\| Sea level		\| Sea level
Line 7,093:		Line 7,091:
	\| Bit field, see below.		\| Bit field, see below.
	\|}		\|}

	~~{{missing info\|section\|What exact effect does the blend bit flag have on the client? What happens if it is used on effects besides DARKNESS?}}~~

	Within flags:		Within flags:
Line 7,101:		Line 7,097:
	* 0x02: Show particles - should all particles from this effect be hidden? Effects with particles hidden are not included in the calculation of the effect color, and are not rendered on the HUD (but are still rendered within the inventory). Usually should be enabled.		* 0x02: Show particles - should all particles from this effect be hidden? Effects with particles hidden are not included in the calculation of the effect color, and are not rendered on the HUD (but are still rendered within the inventory). Usually should be enabled.
	* 0x04: Show icon - should the icon be displayed on the client? Usually should be enabled.		* 0x04: Show icon - should the icon be displayed on the client? Usually should be enabled.
	* 0x08: Blend - should the effect's hard-coded ~~blending~~ be applied? ~~Currently only used~~ in the ~~DARKNESS~~ effect ~~to apply~~ extra void fog and ~~adjust~~ the gamma value for lighting.		* 0x08: Blend - should the effect's hard-coded blend-in be applied?
			** Blend in and out durations are set by the effect type's registry definition.
			** This does not control the blending-out that occurs before the effect time is over.
			** Changing this will result in no visual difference for effects that don't use blending.
			** Used in the following effects:
			*** minecraft:darkness - blend in the initial extra void fog and adjustment of the gamma value for lighting.
			*** minecraft:nausea - blend in the initial warping of the screen.

	==== Update Recipes ====		==== Update Recipes ====

SyncBot: Sync: updated from Minecraft

2026-09-28T11:17:43Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:17, 28 September 2026
Line 4,517:		Line 4,517:

	{\| class="wikitable"		{\| class="wikitable"
			! colspan="7"\| {{packet header\|clientbound\|Update Entity Position}}
			\|-
	! Condition		! Condition
	! Field Name		! Field Name
			! colspan="2"\| Field Type
	! colspan="2" \|Field Type		! Notes
	! Notes
	\|-		\|-
	\| rowspan="2" \| Always		\| rowspan="2"\| Always
	\| Entity ID		\| Entity ID
			\| colspan="2"\| {{Type\|VarInt}}
	\| colspan="2" \|{{Type\|VarInt}}		\|
	\|
	\|-		\|-
	\| Properties		\| Properties
			\| colspan="2"\| {{Type\|VarInt}}
	\| colspan="2" \|{{Type\|VarInt}}		\| Bit 0 is On Ground. Bits 1 and above encode the step count (<code>properties >>> 1</code>).
	\| Bit 0 is On Ground. Bits 1 and above encode the step count (<code>properties >>> 1</code>).
	\|-		\|-
	\| rowspan="3" \| Step count = 0		\| rowspan="3"\| Step count = 0
	\| Delta X		\| Delta X
			\| colspan="2"\| {{Type\|Short}}
	\| colspan="2" \|{{Type\|Short}}		\| Fixed-point X delta with 12 fractional bits.
	\| Fixed-point X delta with 12 fractional bits.
	\|-		\|-
	\| Delta Y		\| Delta Y
			\| colspan="2"\| {{Type\|Short}}
	\| colspan="2" \|{{Type\|Short}}		\| Fixed-point Y delta with 12 fractional bits.
	\| Fixed-point Y delta with 12 fractional bits.
	\|-		\|-
	\| Delta Z		\| Delta Z
			\| colspan="2"\| {{Type\|Short}}
	\| colspan="2" \|{{Type\|Short}}		\| Fixed-point Z delta with 12 fractional bits.
	\| Fixed-point Z delta with 12 fractional bits.
	\|-		\|-
	\| rowspan="4"\| Step count > 0		\| rowspan="4"\| Step count > 0
	(the length of the array is Step count)		(the length of the array is Step count)
	\| Tick Offset		\| Tick Offset
			\| rowspan="4"\| {{Type\|Array}}
	\| rowspan="4" \|{{Type\|Array}}		\| {{Type\|VarInt}}
	\| {{Type\|VarInt}}
	\| Tick offset of this movement step.		\| Tick offset of this movement step.
	\|-		\|-
Line 4,576:		Line 4,571:

	{\| class="wikitable"		{\| class="wikitable"
			! colspan="7"\| {{packet header\|clientbound\|Update Entity Position and Rotation}}
			\|-
	! Condition		! Condition
	! Field Name		! Field Name
			! colspan="2"\| Field Type
	! colspan="2" \|Field Type		! Notes
	! Notes
	\|-		\|-
	\| rowspan="2" \| Always		\| rowspan="2"\| Always
	\| Entity ID		\| Entity ID
			\| colspan="2"\| {{Type\|VarInt}}
	\| colspan="2" \|{{Type\|VarInt}}		\|
	\|
	\|-		\|-
	\| Properties		\| Properties
			\| colspan="2"\| {{Type\|VarInt}}
	\| colspan="2" \|{{Type\|VarInt}}		\| Bit 0 is On Ground. Bits 1 and above encode the step count (<code>properties >>> 1</code>).
	\| Bit 0 is On Ground. Bits 1 and above encode the step count (<code>properties >>> 1</code>).
	\|-		\|-
	\| rowspan="3" \| Step count = 0		\| rowspan="3"\| Step count = 0
	\| Delta X		\| Delta X
			\| colspan="2"\| {{Type\|Short}}
	\| colspan="2" \|{{Type\|Short}}		\| Fixed-point X delta with 12 fractional bits.
	\| Fixed-point X delta with 12 fractional bits.
	\|-		\|-
	\| Delta Y		\| Delta Y
			\| colspan="2"\| {{Type\|Short}}
	\| colspan="2" \|{{Type\|Short}}		\| Fixed-point Y delta with 12 fractional bits.
	\| Fixed-point Y delta with 12 fractional bits.
	\|-		\|-
	\| Delta Z		\| Delta Z
			\| colspan="2"\| {{Type\|Short}}
	\| colspan="2" \|{{Type\|Short}}		\| Fixed-point Z delta with 12 fractional bits.
	\| Fixed-point Z delta with 12 fractional bits.
	\|-		\|-
	\| rowspan="4"\| Step count > 0		\| rowspan="4"\| Step count > 0
	(the length of the array is Step count)		(the length of the array is Step count)
	\| Tick Offset		\| Tick Offset
			\| rowspan="4"\| {{Type\|Array}}
	\| rowspan="4" \|{{Type\|Array}}		\| {{Type\|VarInt}}
	\| {{Type\|VarInt}}
	\| Tick offset of this movement step.		\| Tick offset of this movement step.
	\|-		\|-
Line 4,629:		Line 4,619:
	\| Fixed-point Z delta for this step.		\| Fixed-point Z delta for this step.
	\|-		\|-
	\| rowspan="2" \| Always, after position data		\| rowspan="2"\| Always, after position data
	\| Yaw		\| Yaw
			\| colspan="2"\| {{Type\|Angle}}
	\| colspan="2" \|{{Type\|Angle}}		\| New angle, not a delta. For entities that have a separately rotating head and body, this sets the rotation of the body while the entity is moving. To rotate the head, and the body while the entity is stationary, use {{packet\|Set Head Rotation}}.
	\| New angle, not a delta. For entities that have a separately rotating head and body, this sets the rotation of the body while the entity is moving. To rotate the head, and the body while the entity is stationary, use {{packet\|Set Head Rotation}}.
	\|-		\|-
	\| Pitch		\| Pitch
			\| colspan="2"\| {{Type\|Angle}}
	\| colspan="2" \|{{Type\|Angle}}		\| New angle, not a delta.
	\| New angle, not a delta.
	\|}		\|}

SyncBot: Sync: updated from Minecraft

2026-09-24T11:11:27Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:11, 24 September 2026
Line 4,519:		Line 4,519:
	! Condition		! Condition
	! Field Name		! Field Name
	! Field Type
	! Notes		! colspan="2" \|Field Type
			! Notes
	\|-		\|-
	\| Always		\| rowspan="2" \| Always
	\| Entity ID		\| Entity ID
	\| {{Type\|VarInt}}
	\|		\| colspan="2" \|{{Type\|VarInt}}
			\|
	\|-		\|-
	\| ~~Always~~		\| Properties
	\| ~~Properties~~
	\| {{Type\|VarInt}}		\| colspan="2" \|{{Type\|VarInt}}
	\| Bit 0 is On Ground. Bits 1 and above encode the step count (<code>properties >>> 1</code>).		\| Bit 0 is On Ground. Bits 1 and above encode the step count (<code>properties >>> 1</code>).
	\|-		\|-
	\| Step count = 0		\| rowspan="3" \| Step count = 0
	\| Delta X		\| Delta X
	\| {{Type\|Short}}
	\| Fixed-point X delta with 12 fractional bits.		\| colspan="2" \|{{Type\|Short}}
			\| Fixed-point X delta with 12 fractional bits.
	\|-		\|-
	~~\| Step count = 0~~		\| Delta Y
	\| Delta Y
	\| {{Type\|Short}}		\| colspan="2" \|{{Type\|Short}}
	\| Fixed-point Y delta with 12 fractional bits.		\| Fixed-point Y delta with 12 fractional bits.
	\|-		\|-
	~~\| Step count = 0~~		\| Delta Z
	\| Delta Z
	\| {{Type\|Short}}		\| colspan="2" \|{{Type\|Short}}
	\| Fixed-point Z delta with 12 fractional bits.		\| Fixed-point Z delta with 12 fractional bits.
	\|-		\|-
	\| rowspan="4"\| ~~Repeated step count times when step~~ count > 0		\| rowspan="4"\| Step count > 0
			(the length of the array is Step count)
	\| Tick Offset		\| Tick Offset
	\| {{Type\|VarInt}}
			\| rowspan="4" \|{{Type\|Array}}
			\| {{Type\|VarInt}}
	\| Tick offset of this movement step.		\| Tick offset of this movement step.
	\|-		\|-
Line 4,572:		Line 4,578:
	! Condition		! Condition
	! Field Name		! Field Name
	! Field Type
	! Notes		! colspan="2" \|Field Type
			! Notes
	\|-		\|-
	\| Always		\| rowspan="2" \| Always
	\| Entity ID		\| Entity ID
	\| {{Type\|VarInt}}
	\|		\| colspan="2" \|{{Type\|VarInt}}
			\|
	\|-		\|-
	\| ~~Always~~		\| Properties
	\| ~~Properties~~
	\| {{Type\|VarInt}}		\| colspan="2" \|{{Type\|VarInt}}
	\| Bit 0 is On Ground. Bits 1 and above encode the step count (<code>properties >>> 1</code>).		\| Bit 0 is On Ground. Bits 1 and above encode the step count (<code>properties >>> 1</code>).
	\|-		\|-
	\| Step count = 0		\| rowspan="3" \| Step count = 0
	\| Delta X		\| Delta X
	\| {{Type\|Short}}
	\| Fixed-point X delta with 12 fractional bits.		\| colspan="2" \|{{Type\|Short}}
			\| Fixed-point X delta with 12 fractional bits.
	\|-		\|-
	~~\| Step count = 0~~		\| Delta Y
	\| Delta Y
	\| {{Type\|Short}}		\| colspan="2" \|{{Type\|Short}}
	\| Fixed-point Y delta with 12 fractional bits.		\| Fixed-point Y delta with 12 fractional bits.
	\|-		\|-
	~~\| Step count = 0~~		\| Delta Z
	\| Delta Z
	\| {{Type\|Short}}		\| colspan="2" \|{{Type\|Short}}
	\| Fixed-point Z delta with 12 fractional bits.		\| Fixed-point Z delta with 12 fractional bits.
	\|-		\|-
	\| rowspan="4"\| ~~Repeated step count times when step~~ count > 0		\| rowspan="4"\| Step count > 0
			(the length of the array is Step count)
	\| Tick Offset		\| Tick Offset
	\| {{Type\|VarInt}}
			\| rowspan="4" \|{{Type\|Array}}
			\| {{Type\|VarInt}}
	\| Tick offset of this movement step.		\| Tick offset of this movement step.
	\|-		\|-
Line 4,617:		Line 4,629:
	\| Fixed-point Z delta for this step.		\| Fixed-point Z delta for this step.
	\|-		\|-
	\| Always, after position data		\| rowspan="2" \| Always, after position data
	\| Yaw		\| Yaw
	\| {{Type\|Angle}}
	\| New angle, not a delta. For entities that have a separately rotating head and body, this sets the rotation of the body while the entity is moving. To rotate the head, and the body while the entity is stationary, use {{packet\|Set Head Rotation}}.		\| colspan="2" \|{{Type\|Angle}}
			\| New angle, not a delta. For entities that have a separately rotating head and body, this sets the rotation of the body while the entity is moving. To rotate the head, and the body while the entity is stationary, use {{packet\|Set Head Rotation}}.
	\|-		\|-
	\| ~~Always, after position data~~		\| Pitch
	\| ~~Pitch~~
	\| {{Type\|Angle}}		\| colspan="2" \|{{Type\|Angle}}
	\| New angle, not a delta.		\| New angle, not a delta.
	\|}		\|}

Line 5,167:		Line 5,180:
	\| colspan="2" \| Display Name		\| colspan="2" \| Display Name
	\| colspan="2" \| {{Type\|Prefixed Optional}} {{Type\|Text Component}}		\| colspan="2" \| {{Type\|Prefixed Optional}} {{Type\|Text Component}}
	~~\| Only sent if Has Display Name is true.~~
	\|-		\|-
	\| Update List Priority		\| Update List Priority

SyncBot: Sync: updated from Minecraft

2026-09-23T11:21:27Z

Sync: updated from Minecraft

Show changes

SyncBot: Sync: updated from Minecraft

2026-09-21T11:11:44Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:11, 21 September 2026
Line 6:		Line 6:
	{{TOC\|right}}		{{TOC\|right}}

	This article presents a dissection of the current {{JE}} '''protocol''' for [[Minecraft:Minecraft Wiki:Projects/wiki.vg merge/Protocol version numbers\|26.3, protocol ~~777~~]].		This article presents a dissection of the current {{JE}} '''protocol''' for [[Minecraft:Minecraft Wiki:Projects/wiki.vg merge/Protocol version numbers\|26.2, protocol 776]].<!-- DO NOT UPDATE BEFORE THE PAGE CONTENTS ARE UP TO DATE -->

	The changes between versions may be viewed at [[Minecraft:Minecraft Wiki:Projects/wiki.vg merge/Protocol History\|Protocol History]].		The changes between versions may be viewed at [[Minecraft:Minecraft Wiki:Projects/wiki.vg merge/Protocol History\|Protocol History]].
Line 142:		Line 142:
	== List of packets ==		== List of packets ==

	'''Note:''' The packet IDs listed here are valid only for the protocol version documented on this page, currently ~~777~~. The IDs tend to move around as packets are added and removed, so hardcoding them is highly discouraged. A list of packet IDs and corresponding official names for any version since 1.21 (protocol 767) can be obtained from the built-in [[Minecraft:Minecraft Wiki:Projects/wiki.vg merge/Data Generators\|data generators]].		'''Note:''' The packet IDs listed here are valid only for the protocol version documented on this page, currently 776.<!-- DO NOT UPDATE BEFORE THE PAGE CONTENTS ARE UP TO DATE --> The IDs tend to move around as packets are added and removed, so hardcoding them is highly discouraged. A list of packet IDs and corresponding official names for any version since 1.21 (protocol 767) can be obtained from the built-in [[Minecraft:Minecraft Wiki:Projects/wiki.vg merge/Data Generators\|data generators]].

	=== Handshaking ===		=== Handshaking ===
Line 469:		Line 469:
	\| Protocol Version		\| Protocol Version
	\| {{Type\|VarInt}}		\| {{Type\|VarInt}}
	\| See [[Minecraft:Minecraft Wiki:Projects/wiki.vg merge/Protocol version numbers\|protocol version numbers]] (currently ~~777~~ in Minecraft 26.3).		\| See [[Minecraft:Minecraft Wiki:Projects/wiki.vg merge/Protocol version numbers\|protocol version numbers]] (currently 776 in Minecraft 26.2).<!-- DO NOT UPDATE BEFORE THE PAGE CONTENTS ARE UP TO DATE -->
	\|-		\|-
	\| Server Address		\| Server Address

SyncBot: Sync: updated from Minecraft

2026-09-20T11:14:48Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:14, 20 September 2026
Line 6:		Line 6:
	{{TOC\|right}}		{{TOC\|right}}

	This article presents a dissection of the current {{JE}} '''protocol''' for [[Minecraft:Minecraft Wiki:Projects/wiki.vg merge/Protocol version numbers\|26.2, protocol ~~776~~]].		This article presents a dissection of the current {{JE}} '''protocol''' for [[Minecraft:Minecraft Wiki:Projects/wiki.vg merge/Protocol version numbers\|26.3, protocol 777]].

	The changes between versions may be viewed at [[Minecraft:Minecraft Wiki:Projects/wiki.vg merge/Protocol History\|Protocol History]].		The changes between versions may be viewed at [[Minecraft:Minecraft Wiki:Projects/wiki.vg merge/Protocol History\|Protocol History]].
Line 142:		Line 142:
	== List of packets ==		== List of packets ==

	'''Note:''' The packet IDs listed here are valid only for the protocol version documented on this page, currently ~~776~~. The IDs tend to move around as packets are added and removed, so hardcoding them is highly discouraged. A list of packet IDs and corresponding official names for any version since 1.21 (protocol 767) can be obtained from the built-in [[Minecraft:Minecraft Wiki:Projects/wiki.vg merge/Data Generators\|data generators]].		'''Note:''' The packet IDs listed here are valid only for the protocol version documented on this page, currently 777. The IDs tend to move around as packets are added and removed, so hardcoding them is highly discouraged. A list of packet IDs and corresponding official names for any version since 1.21 (protocol 767) can be obtained from the built-in [[Minecraft:Minecraft Wiki:Projects/wiki.vg merge/Data Generators\|data generators]].

	=== Handshaking ===		=== Handshaking ===
Line 469:		Line 469:
	\| Protocol Version		\| Protocol Version
	\| {{Type\|VarInt}}		\| {{Type\|VarInt}}
	\| See [[Minecraft:Minecraft Wiki:Projects/wiki.vg merge/Protocol version numbers\|protocol version numbers]] (currently ~~776~~ in Minecraft 26.2).		\| See [[Minecraft:Minecraft Wiki:Projects/wiki.vg merge/Protocol version numbers\|protocol version numbers]] (currently 777 in Minecraft 26.3).
	\|-		\|-
	\| Server Address		\| Server Address