Pocket Minecraft Protocol - Revision history

imported>FG6: Fix UpdateBlockPacket table

2023-05-12T23:48:02Z

Fix UpdateBlockPacket table

← Older revision		Revision as of 23:48, 12 May 2023
Line 1,636:		Line 1,636:
	\| Notes		\| Notes
	\|-		\|-
	\| rowspan="5" \| 0x97		\| rowspan="6" \| 0x97
	\| Entiy ID		\| Entiy ID
	\| int		\| int

imported>Soupy: /* ID_OPEN_CONNECTION_REQUEST_2 (0x07) */

2022-06-19T00:37:36Z

ID_OPEN_CONNECTION_REQUEST_2 (0x07)

← Older revision		Revision as of 00:37, 19 June 2022
Line 256:		Line 256:
	\| class="col1 centeralign" \| 1 + 4 bytes		\| class="col1 centeralign" \| 1 + 4 bytes
	\| class="col2 centeralign" \| <code>0x043f57fefd</code>		\| class="col2 centeralign" \| <code>0x043f57fefd</code>
	\| class="col3" \| ~~An XOR~~ of the ~~server IPv4~~ address		\| class="col3" \| 0x4 for IPv4 and the twos complement of each byte of the servers ip address,
	\|- class="row3"		\|- class="row3"
	\| class="col0 centeralign" \| Server UDP Port		\| class="col0 centeralign" \| Server UDP Port
Line 280:		Line 280:

	{{anchor\|0x08}}		{{anchor\|0x08}}

	=== ID_OPEN_CONNECTION_REPLY_2 (0x08) ===		=== ID_OPEN_CONNECTION_REPLY_2 (0x08) ===

imported>Soupy: The number they did not know the purpose of is actually an XOR of the server ip.

2021-12-22T22:56:49Z

The number they did not know the purpose of is actually an XOR of the server ip.

← Older revision		Revision as of 22:56, 22 December 2021
Line 253:		Line 253:
	\| class="col4" \|		\| class="col4" \|
	\|- class="row2"		\|- class="row2"
	\| class="col0 centeralign" \| ~~Security + Cookie~~		\| class="col0 centeralign" \| Server Address
	\| class="col1 centeralign" \| 1 + 4 bytes		\| class="col1 centeralign" \| 1 + 4 bytes
	\| class="col2 centeralign" \| <code>0x043f57fefd</code>		\| class="col2 centeralign" \| <code>0x043f57fefd</code>
	\| class="col3" \| ~~Unused, '''not''' constant value*, but usually similar to <code>0x043f57fefd</code>~~		\| class="col3" \| An XOR of the server IPv4 address
	\|- class="row3"		\|- class="row3"
	\| class="col0 centeralign" \| Server UDP Port		\| class="col0 centeralign" \| Server UDP Port
Line 279:		Line 279:
	Sent from client in response to packet 0x06.		Sent from client in response to packet 0x06.

	* Instances have been observed where the value <code>0x043f57fefd</code> is not always present, but similar values are sent.
	{{anchor\|0x08}}		{{anchor\|0x08}}
	=== ID_OPEN_CONNECTION_REPLY_2 (0x08) ===		=== ID_OPEN_CONNECTION_REPLY_2 (0x08) ===

imported>Orladog: Remove colon

2020-06-08T11:03:58Z

Remove colon

← Older revision		Revision as of 11:03, 8 June 2020
Line 6:		Line 6:
	\|HEADING = Heads up!		\|HEADING = Heads up!
	\|CONTENT = This is outdated information for Minecraft Pocket Edition.'''. For the latest Bedrock Edition protocol documentation see [[Bedrock Protocol]].		\|CONTENT = This is outdated information for Minecraft Pocket Edition.'''. For the latest Bedrock Edition protocol documentation see [[Bedrock Protocol]].
	}}:		}}

	Unlike the Minecraft protocol, this protocol uses UDP with (so far observed, at least) one message per packet. This makes the protocol easier to work with when it comes to packet serialization, and might offer latency improvements, but will inevitably have the usual UDP issues (packets lost, truncated, duplicated, out-of-order, etc.).		Unlike the Minecraft protocol, this protocol uses UDP with (so far observed, at least) one message per packet. This makes the protocol easier to work with when it comes to packet serialization, and might offer latency improvements, but will inevitably have the usual UDP issues (packets lost, truncated, duplicated, out-of-order, etc.).

imported>Orladog: Add info about Bedrock Protocol

2020-06-08T11:03:27Z

Add info about Bedrock Protocol

← Older revision		Revision as of 11:03, 8 June 2020
Line 1:		Line 1:
			{{Box
			\|BORDER = #9999FF
			\|BACKGROUND = #99CCFF
			\|WIDTH = 100%
			\|ICON =
			\|HEADING = Heads up!
			\|CONTENT = This is outdated information for Minecraft Pocket Edition.'''. For the latest Bedrock Edition protocol documentation see [[Bedrock Protocol]].
			}}:

	Unlike the Minecraft protocol, this protocol uses UDP with (so far observed, at least) one message per packet. This makes the protocol easier to work with when it comes to packet serialization, and might offer latency improvements, but will inevitably have the usual UDP issues (packets lost, truncated, duplicated, out-of-order, etc.).		Unlike the Minecraft protocol, this protocol uses UDP with (so far observed, at least) one message per packet. This makes the protocol easier to work with when it comes to packet serialization, and might offer latency improvements, but will inevitably have the usual UDP issues (packets lost, truncated, duplicated, out-of-order, etc.).

imported>JacobTDC: /* ID_UNCONNECTED_PING_OPEN_CONNECTIONS (0x1C) */

2017-12-24T18:57:21Z

ID_UNCONNECTED_PING_OPEN_CONNECTIONS (0x1C)

← Older revision		Revision as of 18:57, 24 December 2017
Line 394:		Line 394:
	\| class="col1 centeralign" \| string		\| class="col1 centeralign" \| string
	\| class="col2 centeralign" \| "MCPE;Steve;2 7;0.11.0;0;20"		\| class="col2 centeralign" \| "MCPE;Steve;2 7;0.11.0;0;20"
	\| class="col3" \|		\| class="col3" \| Used to send the username, format: <code>MCPE;<Server name>;<Protocol version>;<MCPE Version>;<Players>;<Max Players></code>
	\|- class="row6"		\|- class="row6"
	\| class="col0" \| Total Size:		\| class="col0" \| Total Size:

imported>Ishitatsuyuki: Change the ACK and NAK description.

2016-05-22T02:35:32Z

Change the ACK and NAK description.

← Older revision		Revision as of 02:35, 22 May 2016
Line 102:		Line 102:

	'''NOTE: THIS PACKET APPEARS TO BE UNUSED. Use a 0x01 packet instead'''		'''NOTE: THIS PACKET APPEARS TO BE UNUSED. Use a 0x01 packet instead'''

	'''RakNet Packet'''		'''RakNet Packet'''

Line 485:		Line 486:
	{{anchor\|0xA0}}		{{anchor\|0xA0}}

	=== ~~NACK~~ (0xA0) ===		=== NAK (0xA0) ===

	''Two-Way''		''Two-Way''

	'''~~This packet is part of the real Minecraft PE implementation. The structure can change anytime.~~'''		'''RakNet Packet'''

	{\| class="wikitable"		{\| class="wikitable"
Line 500:		Line 501:
	\|- class="row1"		\|- class="row1"
	\| class="col0 centeralign" rowspan="4" \| 0xA0		\| class="col0 centeralign" rowspan="4" \| 0xA0
	\| class="col1 centeralign" \| ~~Unknown~~		\| class="col1 centeralign" \| Count
	\| class="col2 centeralign" \| short		\| class="col2 centeralign" \| short
	\| class="col3 centeralign" \| <code>1</code>		\| class="col3 centeralign" \| <code>1</code>
	\| class="col4" \|		\| class="col4" \|
	\|- class="row2"		\|- class="row2"
	\| class="col1 centeralign" \| ~~Additional Packet~~		\| class="col1 centeralign" \| MinEqualsMax
	\| class="col2 centeralign" \| boolean		\| class="col2 centeralign" \| boolean
	\| class="col3 centeralign" \| <code>''true''</code>		\| class="col3 centeralign" \| <code>''true''</code>
	\| class="col4" \| ''true'' ~~when there is~~ only one ~~packet received~~		\| class="col4" \| ''true'' if the following range contains only one number
	\|- class="row3"		\|- class="row3"
	\| class="col1 centeralign" \| Packet Number		\| class="col1 centeralign" \| Packet Number (Min)
	\| class="col2 centeralign" \| 3 bytes		\| class="col2 centeralign" \| 3 bytes
	\| class="col3 centeralign" \| <code>0x000000</code>		\| class="col3 centeralign" \| <code>0x000000</code>
	\| class="col4" \| ~~Packet~~ to resend		\| class="col4" \| Range of packet to resend
	\|- class="row4"		\|- class="row4"
	\| class="col1 centeralign" \| Packet Number #2		\| class="col1 centeralign" \| Packet Number (Max)
	\| class="col2 centeralign" \| 3 bytes		\| class="col2 centeralign" \| 3 bytes
	\| class="col3 centeralign" \| <code>0x000004</code>		\| class="col3 centeralign" \| <code>0x000004</code>
	\| class="col4" \| ~~Aditional~~ packet to resend (only ~~when~~ ''false'')		\| class="col4" \| Range of packet to resend (only if ''false'')
	\|- class="row5"		\|- class="row5"
	\| class="col0" \| Total Size:		\| class="col0" \| Total Size:
Line 530:		Line 531:
	''Two-Way''		''Two-Way''

	'''~~This packet is part of the real Minecraft PE implementation. The structure can change anytime.~~'''		'''RakNet Packet'''

	{\| class="wikitable"		{\| class="wikitable"
Line 541:		Line 542:
	\|- class="row1"		\|- class="row1"
	\| class="col0 centeralign" rowspan="4" \| 0xC0		\| class="col0 centeralign" rowspan="4" \| 0xC0
	\| class="col1 centeralign" \| ~~Unknown~~		\| class="col1 centeralign" \| Count
	\| class="col2 centeralign" \| short		\| class="col2 centeralign" \| short
	\| class="col3 centeralign" \| <code>1</code>		\| class="col3 centeralign" \| <code>1</code>
	\| class="col4" \|		\| class="col4" \|
	\|- class="row2"		\|- class="row2"
	\| class="col1 centeralign" \| ~~Additional Packet~~		\| class="col1 centeralign" \| MinEqualsMax
	\| class="col2 centeralign" \| boolean		\| class="col2 centeralign" \| boolean
	\| class="col3 centeralign" \| <code>''true''</code>		\| class="col3 centeralign" \| <code>''true''</code>
	\| class="col4" \| ''true'' ~~when there is~~ only one ~~packet received~~		\| class="col4" \| ''true'' if the following range contains only one number
	\|- class="row3"		\|- class="row3"
	\| class="col1 centeralign" \| Packet Number		\| class="col1 centeralign" \| Packet Number (Min)
	\| class="col2 centeralign" \| 3 bytes		\| class="col2 centeralign" \| 3 bytes
	\| class="col3 centeralign" \| <code>0x000000</code>		\| class="col3 centeralign" \| <code>0x000000</code>
	\| class="col4" \| Received packet number from field Count in 0x84 and 0x8C		\| class="col4" \| Received packet number from field Count in 0x84 and 0x8C
	\|- class="row4"		\|- class="row4"
	\| class="col1 centeralign" \| Packet Number #2		\| class="col1 centeralign" \| Packet Number (Max)
	\| class="col2 centeralign" \| 3 bytes		\| class="col2 centeralign" \| 3 bytes
	\| class="col3 centeralign" \| <code>0x000004</code>		\| class="col3 centeralign" \| <code>0x000004</code>
	\| class="col4" \| ~~Last received packet number~~ (only when ''false'')		\| class="col4" \| Received Packet Number (only when ''false'')
	\|- class="row5"		\|- class="row5"
	\| class="col0" \| Total Size:		\| class="col0" \| Total Size:

imported>MarfGamer: Fixed Typo. Not only was the ID wrong, but hexadecimal can not go up to "N". Maximum is "F"

2016-05-02T00:12:26Z

Fixed Typo. Not only was the ID wrong, but hexadecimal can not go up to "N". Maximum is "F"

← Older revision		Revision as of 00:12, 2 May 2016
Line 499:		Line 499:
	\| class="col4" \| Notes		\| class="col4" \| Notes
	\|- class="row1"		\|- class="row1"
	\| class="col0 centeralign" rowspan="4" \| ~~0xN0~~		\| class="col0 centeralign" rowspan="4" \| 0xA0
	\| class="col1 centeralign" \| Unknown		\| class="col1 centeralign" \| Unknown
	\| class="col2 centeralign" \| short		\| class="col2 centeralign" \| short

imported>SopaXorzTaker: Updated ping protocol.

2015-07-13T13:37:06Z

Updated ping protocol.

← Older revision		Revision as of 13:37, 13 July 2015
Line 392:		Line 392:
	\| class="col0 centeralign" \| Identifier		\| class="col0 centeralign" \| Identifier
	\| class="col1 centeralign" \| string		\| class="col1 centeralign" \| string
	\| class="col2 centeralign" \| ~~MCCPP~~;~~Demo~~;~~Steve~~		\| class="col2 centeralign" \| "MCPE;Steve;2 7;0.11.0;0;20"
	\| class="col3" \|		\| class="col3" \|
	\|- class="row6"		\|- class="row6"
Line 402:		Line 402:
	If the Server is invisible, this packet will be sent without username		If the Server is invisible, this packet will be sent without username

	In order for the server to show up in the world list, the server name must have "MCCPP;MINECON;" in front of it.		<s>In order for the server to show up in the world list, the server name must have "MCCPP;MINECON;" in front of it.</s>
			<b>Since MCPE 0.11.0, the server name has a different format.</b>

	{{anchor\|0x1D}}		{{anchor\|0x1D}}
Line 441:		Line 442:
	\| class="col0 centeralign" \| Data		\| class="col0 centeralign" \| Data
	\| class="col1 centeralign" \| string		\| class="col1 centeralign" \| string
	\| class="col2 centeralign" \| <code>~~MCCPP~~;~~Demo~~;~~Steve~~</code>		\| class="col2 centeralign" \| <code>MCPE;Steve;2 7;0.11.0;0;20</code>
	\| class="col3" \| Used to send the username ~~(MCCPP~~;~~Demo~~; ~~+ username)~~		\| class="col3" \| Used to send the username, format: MCPE;<Server name>;<Protocol version>;<MCPE Version>;<Players>;<Max Players>
	\|- class="row3"		\|- class="row3"
	\| class="col0" \| Total Size:		\| class="col0" \| Total Size:

imported>ExpandingDev: 0x07 packet has been observed to not have the constant 0x043f57fefd value, changing "constant" to "not constant"

2015-06-15T00:20:38Z

0x07 packet has been observed to not have the constant 0x043f57fefd value, changing "constant" to "not constant"

← Older revision		Revision as of 00:20, 15 June 2015
Line 246:		Line 246:
	\| class="col1 centeralign" \| 1 + 4 bytes		\| class="col1 centeralign" \| 1 + 4 bytes
	\| class="col2 centeralign" \| <code>0x043f57fefd</code>		\| class="col2 centeralign" \| <code>0x043f57fefd</code>
	\| class="col3" \| Unused, constant value		\| class="col3" \| Unused, '''not''' constant value*, but usually similar to <code>0x043f57fefd</code>
	\|- class="row3"		\|- class="row3"
	\| class="col0 centeralign" \| Server UDP Port		\| class="col0 centeralign" \| Server UDP Port
Line 269:		Line 269:
	Sent from client in response to packet 0x06.		Sent from client in response to packet 0x06.

			* Instances have been observed where the value <code>0x043f57fefd</code> is not always present, but similar values are sent.
	{{anchor\|0x08}}		{{anchor\|0x08}}
	=== ID_OPEN_CONNECTION_REPLY_2 (0x08) ===		=== ID_OPEN_CONNECTION_REPLY_2 (0x08) ===

← Older revision		Revision as of 18:57, 24 December 2017
Line 394:		Line 394:
	\| class="col1 centeralign" \| string		\| class="col1 centeralign" \| string
	\| class="col2 centeralign" \| "MCPE;Steve;2 7;0.11.0;0;20"		\| class="col2 centeralign" \| "MCPE;Steve;2 7;0.11.0;0;20"
	\| class="col3" \|		\| class="col3" \| Used to send the username, format: <code>MCPE;<Server name>;<Protocol version>;<MCPE Version>;<Players>;<Max Players></code>
	\|- class="row6"		\|- class="row6"
	\| class="col0" \| Total Size:		\| class="col0" \| Total Size:

← Older revision		Revision as of 02:35, 22 May 2016
Line 102:		Line 102:

	'''NOTE: THIS PACKET APPEARS TO BE UNUSED. Use a 0x01 packet instead'''		'''NOTE: THIS PACKET APPEARS TO BE UNUSED. Use a 0x01 packet instead'''

	'''RakNet Packet'''		'''RakNet Packet'''

Line 485:		Line 486:
	{{anchor\|0xA0}}		{{anchor\|0xA0}}

	=== ~~NACK~~ (0xA0) ===		=== NAK (0xA0) ===

	''Two-Way''		''Two-Way''

	'''~~This packet is part of the real Minecraft PE implementation. The structure can change anytime.~~'''		'''RakNet Packet'''

	{\| class="wikitable"		{\| class="wikitable"
Line 500:		Line 501:
	\|- class="row1"		\|- class="row1"
	\| class="col0 centeralign" rowspan="4" \| 0xA0		\| class="col0 centeralign" rowspan="4" \| 0xA0
	\| class="col1 centeralign" \| ~~Unknown~~		\| class="col1 centeralign" \| Count
	\| class="col2 centeralign" \| short		\| class="col2 centeralign" \| short
	\| class="col3 centeralign" \| <code>1</code>		\| class="col3 centeralign" \| <code>1</code>
	\| class="col4" \|		\| class="col4" \|
	\|- class="row2"		\|- class="row2"
	\| class="col1 centeralign" \| ~~Additional Packet~~		\| class="col1 centeralign" \| MinEqualsMax
	\| class="col2 centeralign" \| boolean		\| class="col2 centeralign" \| boolean
	\| class="col3 centeralign" \| <code>''true''</code>		\| class="col3 centeralign" \| <code>''true''</code>
	\| class="col4" \| ''true'' ~~when there is~~ only one ~~packet received~~		\| class="col4" \| ''true'' if the following range contains only one number
	\|- class="row3"		\|- class="row3"
	\| class="col1 centeralign" \| Packet Number		\| class="col1 centeralign" \| Packet Number (Min)
	\| class="col2 centeralign" \| 3 bytes		\| class="col2 centeralign" \| 3 bytes
	\| class="col3 centeralign" \| <code>0x000000</code>		\| class="col3 centeralign" \| <code>0x000000</code>
	\| class="col4" \| ~~Packet~~ to resend		\| class="col4" \| Range of packet to resend
	\|- class="row4"		\|- class="row4"
	\| class="col1 centeralign" \| Packet Number #2		\| class="col1 centeralign" \| Packet Number (Max)
	\| class="col2 centeralign" \| 3 bytes		\| class="col2 centeralign" \| 3 bytes
	\| class="col3 centeralign" \| <code>0x000004</code>		\| class="col3 centeralign" \| <code>0x000004</code>
	\| class="col4" \| ~~Aditional~~ packet to resend (only ~~when~~ ''false'')		\| class="col4" \| Range of packet to resend (only if ''false'')
	\|- class="row5"		\|- class="row5"
	\| class="col0" \| Total Size:		\| class="col0" \| Total Size:
Line 530:		Line 531:
	''Two-Way''		''Two-Way''

	'''~~This packet is part of the real Minecraft PE implementation. The structure can change anytime.~~'''		'''RakNet Packet'''

	{\| class="wikitable"		{\| class="wikitable"
Line 541:		Line 542:
	\|- class="row1"		\|- class="row1"
	\| class="col0 centeralign" rowspan="4" \| 0xC0		\| class="col0 centeralign" rowspan="4" \| 0xC0
	\| class="col1 centeralign" \| ~~Unknown~~		\| class="col1 centeralign" \| Count
	\| class="col2 centeralign" \| short		\| class="col2 centeralign" \| short
	\| class="col3 centeralign" \| <code>1</code>		\| class="col3 centeralign" \| <code>1</code>
	\| class="col4" \|		\| class="col4" \|
	\|- class="row2"		\|- class="row2"
	\| class="col1 centeralign" \| ~~Additional Packet~~		\| class="col1 centeralign" \| MinEqualsMax
	\| class="col2 centeralign" \| boolean		\| class="col2 centeralign" \| boolean
	\| class="col3 centeralign" \| <code>''true''</code>		\| class="col3 centeralign" \| <code>''true''</code>
	\| class="col4" \| ''true'' ~~when there is~~ only one ~~packet received~~		\| class="col4" \| ''true'' if the following range contains only one number
	\|- class="row3"		\|- class="row3"
	\| class="col1 centeralign" \| Packet Number		\| class="col1 centeralign" \| Packet Number (Min)
	\| class="col2 centeralign" \| 3 bytes		\| class="col2 centeralign" \| 3 bytes
	\| class="col3 centeralign" \| <code>0x000000</code>		\| class="col3 centeralign" \| <code>0x000000</code>
	\| class="col4" \| Received packet number from field Count in 0x84 and 0x8C		\| class="col4" \| Received packet number from field Count in 0x84 and 0x8C
	\|- class="row4"		\|- class="row4"
	\| class="col1 centeralign" \| Packet Number #2		\| class="col1 centeralign" \| Packet Number (Max)
	\| class="col2 centeralign" \| 3 bytes		\| class="col2 centeralign" \| 3 bytes
	\| class="col3 centeralign" \| <code>0x000004</code>		\| class="col3 centeralign" \| <code>0x000004</code>
	\| class="col4" \| ~~Last received packet number~~ (only when ''false'')		\| class="col4" \| Received Packet Number (only when ''false'')
	\|- class="row5"		\|- class="row5"
	\| class="col0" \| Total Size:		\| class="col0" \| Total Size:

← Older revision		Revision as of 00:12, 2 May 2016
Line 499:		Line 499:
	\| class="col4" \| Notes		\| class="col4" \| Notes
	\|- class="row1"		\|- class="row1"
	\| class="col0 centeralign" rowspan="4" \| ~~0xN0~~		\| class="col0 centeralign" rowspan="4" \| 0xA0
	\| class="col1 centeralign" \| Unknown		\| class="col1 centeralign" \| Unknown
	\| class="col2 centeralign" \| short		\| class="col2 centeralign" \| short

← Older revision		Revision as of 13:37, 13 July 2015
Line 392:		Line 392:
	\| class="col0 centeralign" \| Identifier		\| class="col0 centeralign" \| Identifier
	\| class="col1 centeralign" \| string		\| class="col1 centeralign" \| string
	\| class="col2 centeralign" \| ~~MCCPP~~;~~Demo~~;~~Steve~~		\| class="col2 centeralign" \| "MCPE;Steve;2 7;0.11.0;0;20"
	\| class="col3" \|		\| class="col3" \|
	\|- class="row6"		\|- class="row6"
Line 402:		Line 402:
	If the Server is invisible, this packet will be sent without username		If the Server is invisible, this packet will be sent without username

	In order for the server to show up in the world list, the server name must have "MCCPP;MINECON;" in front of it.		<s>In order for the server to show up in the world list, the server name must have "MCCPP;MINECON;" in front of it.</s>
			<b>Since MCPE 0.11.0, the server name has a different format.</b>

	{{anchor\|0x1D}}		{{anchor\|0x1D}}
Line 441:		Line 442:
	\| class="col0 centeralign" \| Data		\| class="col0 centeralign" \| Data
	\| class="col1 centeralign" \| string		\| class="col1 centeralign" \| string
	\| class="col2 centeralign" \| <code>~~MCCPP~~;~~Demo~~;~~Steve~~</code>		\| class="col2 centeralign" \| <code>MCPE;Steve;2 7;0.11.0;0;20</code>
	\| class="col3" \| Used to send the username ~~(MCCPP~~;~~Demo~~; ~~+ username)~~		\| class="col3" \| Used to send the username, format: MCPE;<Server name>;<Protocol version>;<MCPE Version>;<Players>;<Max Players>
	\|- class="row3"		\|- class="row3"
	\| class="col0" \| Total Size:		\| class="col0" \| Total Size: