Minecraft:Mojang API - Revision history

SyncBot: Sync: updated from Minecraft

2026-09-18T11:23:15Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:23, 18 September 2026
Line 733:		Line 733:
	<div class="treeview">		<div class="treeview">
	* {{Nbt\|compound}} Root tag		* {{Nbt\|compound}} Root tag
	** {{Nbt\|list\|profilePropertyKeys}}: A list of public keys used for verifying player properties (such as skin and cape textures), from e.g. <code><nowiki>https://sessionserver.mojang.com/session/minecraft/profile/</nowiki><''UUID''>?unsigned=false</code>. A player property is considered valid by the client ~~iff~~ signed by any of these keys.		** {{Nbt\|list\|profilePropertyKeys}}: A list of public keys used for verifying player properties (such as skin and cape textures), from e.g. <code><nowiki>https://sessionserver.mojang.com/session/minecraft/profile/</nowiki><''UUID''>?unsigned=false</code>. A player property is considered valid by the client if signed by any of these keys.
	*** {{Nbt\|string}}: Base64-encoded DER public key.		*** {{Nbt\|string}}: Base64-encoded DER public key.
	** {{Nbt\|list\|playerCertificateKeys}}: A list of public keys used for verifying player public keys, e.g. from <code><nowiki>https://api.minecraftservices.com/player/certificates</nowiki></code>. A player certificate is considered valid by the client ~~iff~~ signed by any of these keys.		** {{Nbt\|list\|playerCertificateKeys}}: A list of public keys used for verifying player public keys, e.g. from <code><nowiki>https://api.minecraftservices.com/player/certificates</nowiki></code>. A player certificate is considered valid by the client if signed by any of these keys.
	*** {{Nbt\|string}}: Base64-encoded DER public key.		*** {{Nbt\|string}}: Base64-encoded DER public key.
	** {{Nbt\|list\|authenticationKeys}}: A list of public keys used for verifying authentication tokens, like the JWT access token used in the <code>Authorization</code> Header in most requests to the Minecraft API.		** {{Nbt\|list\|authenticationKeys}}: A list of public keys used for verifying authentication tokens, like the JWT access token used in the <code>Authorization</code> Header in most requests to the Minecraft API.

SyncBot: Sync: updated from Minecraft

2026-09-12T11:11:09Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:11, 12 September 2026
Line 228:		Line 228:
	****** {{Nbt\|compound\|CAPE}}: [[Minecraft:Cape]] texture. If the player does not have a cape, this does not exist.		****** {{Nbt\|compound\|CAPE}}: [[Minecraft:Cape]] texture. If the player does not have a cape, this does not exist.
	******* {{Nbt\|string\|url}}: URL to the cape texture.		******* {{Nbt\|string\|url}}: URL to the cape texture.
			** {{Nbt\|list\|profileActions}} A list (possibly empty) of moderation actions taken against an account:
	</div>		</div>

			; Profile Actions
			* <code><nowiki>"FORCED_NAME_CHANGE"</nowiki></code> appears if the player must change their name before playing multiplayer.
			* <code><nowiki>"USING_BANNED_SKIN"</nowiki></code> appears if the player is using a banned skin.

	; Example		; Example
Line 241:		Line 246:
	"value": "ewogICJ0aW1lc3R..."		"value": "ewogICJ0aW1lc3R..."
	}		}
	]		],
			"profileActions": []
	}		}
	</syntaxhighlight>		</syntaxhighlight>

SyncBot: Sync: updated from Minecraft

2026-09-07T11:10:54Z

Sync: updated from Minecraft

Show changes

SyncBot: Sync: updated from Minecraft

2026-09-03T11:10:54Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:10, 3 September 2026
Line 2:		Line 2:

	Most of the API has a per-IP ratelimit of 200 requests per 2 minutes. For IPv6, the ratelimits are bucketed by /56 subnet. Some endpoints have different ratelimits.		Most of the API has a per-IP ratelimit of 200 requests per 2 minutes. For IPv6, the ratelimits are bucketed by /56 subnet. Some endpoints have different ratelimits.

	~~Secret: Go to your profile and edit "id="MSA" to "Mojang"~~

	== Request and response ==		== Request and response ==

SyncBot: Sync: updated from Minecraft

2026-09-02T11:15:31Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:15, 2 September 2026
Line 2:		Line 2:

	Most of the API has a per-IP ratelimit of 200 requests per 2 minutes. For IPv6, the ratelimits are bucketed by /56 subnet. Some endpoints have different ratelimits.		Most of the API has a per-IP ratelimit of 200 requests per 2 minutes. For IPv6, the ratelimits are bucketed by /56 subnet. Some endpoints have different ratelimits.

			Secret: Go to your profile and edit "id="MSA" to "Mojang"

	== Request and response ==		== Request and response ==

SyncBot: Sync: updated from Minecraft

2026-07-21T12:29:40Z

Sync: updated from Minecraft

← Older revision		Revision as of 12:29, 21 July 2026
Line 1,505:		Line 1,505:
	#* Waits for player approval before accepting or rejecting the join request.		#* Waits for player approval before accepting or rejecting the join request.
	# On acceptance, B records (A's <code>PMID</code> and <code>sessionId</code>), and sends <code>JOIN_ACCEPTED</code> with the same <code>sessionId</code>.		# On acceptance, B records (A's <code>PMID</code> and <code>sessionId</code>), and sends <code>JOIN_ACCEPTED</code> with the same <code>sessionId</code>.
	# A receives <code>JOIN_ACCEPTED</code>, builds the peer connection, creates a data channel ~~labelled~~ <code>"minecraft"</code>, and sends the SDP as <code>OFFER</code>. A also starts a 10-second handshake timer.		# A receives <code>JOIN_ACCEPTED</code>, builds the peer connection, creates a data channel labeled <code>"minecraft"</code>, and sends the SDP as <code>OFFER</code>. A also starts a 10-second handshake timer.
	# As local ICE candidates appear on A, each is sent as <code>ICE_CANDIDATE</code> with the same <code>sessionId</code>.		# As local ICE candidates appear on A, each is sent as <code>ICE_CANDIDATE</code> with the same <code>sessionId</code>.
	# B receives <code>OFFER</code>, validates that <code>(from, sessionId)</code> matches, builds its own peer connection, generates the SDP answer, and sends it as <code>ANSWER</code>. B starts its own 10-second timer and sends its ICE candidates back as <code>ICE_CANDIDATE</code>.		# B receives <code>OFFER</code>, validates that <code>(from, sessionId)</code> matches, builds its own peer connection, generates the SDP answer, and sends it as <code>ANSWER</code>. B starts its own 10-second timer and sends its ICE candidates back as <code>ICE_CANDIDATE</code>.

SyncBot: Sync: updated from Minecraft

2026-06-23T11:12:21Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:12, 23 June 2026
Line 456:		Line 456:

	; Payload		; Payload
	A JSON array containing the desired keys to update, right now, only ~~orofanityFilterPreferences~~ and friendsPreferences can be updated<div class="treeview">		A JSON array containing the desired keys to update, right now, only profanityFilterPreferences and friendsPreferences can be updated<div class="treeview">
	* '''Example'''		* '''Example'''
	* {{Nbt\|compound}} Root tag		* {{Nbt\|compound}} Root tag

SyncBot: Sync: updated from Minecraft

2026-06-01T11:11:15Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:11, 1 June 2026
Line 1,597:		Line 1,597:
	[[Minecraft:lzh:魔贊卯口]]		[[Minecraft:lzh:魔贊卯口]]
	[[Minecraft:zh:Mojang API]]		[[Minecraft:zh:Mojang API]]
	~~[[Minecraft:ko:Mojang API]]~~

SyncBot: Sync: updated from Minecraft

2026-05-31T11:11:45Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:11, 31 May 2026
Line 1,597:		Line 1,597:
	[[Minecraft:lzh:魔贊卯口]]		[[Minecraft:lzh:魔贊卯口]]
	[[Minecraft:zh:Mojang API]]		[[Minecraft:zh:Mojang API]]
			[[Minecraft:ko:Mojang API]]

SyncBot: Sync: updated from Minecraft

2026-05-27T11:12:35Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:12, 27 May 2026
Line 1,021:		Line 1,021:

	== Peer-to-peer multiplayer networking ==		== Peer-to-peer multiplayer networking ==
			{{outdated\|section=y\|edition=java\|never=y\|This feature was present only in development versions and the related API endpoints are no longer available.}}

	Peer-to-peer (P2P) multiplayer networking was introduced in [[Minecraft:Java Edition 26.2 Snapshot 7\|Minecraft Java Edition 26.2 ~~Snapshot 7~~]]. It allows a host's singleplayer world to be joinable by friends over Peer-to-Peer [https://wikipedia.org/wiki/WebRTC WebRTC] data channels. A Mojang-hosted ''signaling service'' handles the handshake, gameplay traffic flows peer-to-peer (using [[Minecraft:w:Interactive_Connectivity_Establishment\|ICE]]). The protocol described below is unstable and likely to change.		Peer-to-peer (P2P) multiplayer networking was introduced in [[Minecraft:Java Edition 26.2 Snapshot 7]] and removed in [[Minecraft:Java Edition 26.2 Pre-Release 1]]. It allows a host's singleplayer world to be joinable by friends over Peer-to-Peer [https://wikipedia.org/wiki/WebRTC WebRTC] data channels. A Mojang-hosted ''signaling service'' handles the handshake, gameplay traffic flows peer-to-peer (using [[Minecraft:w:Interactive_Connectivity_Establishment\|ICE]]). The protocol described below is unstable and likely to change.

	General Properties:		General Properties:

← Older revision		Revision as of 11:23, 18 September 2026
Line 733:		Line 733:
	<div class="treeview">		<div class="treeview">
	* {{Nbt\|compound}} Root tag		* {{Nbt\|compound}} Root tag
	** {{Nbt\|list\|profilePropertyKeys}}: A list of public keys used for verifying player properties (such as skin and cape textures), from e.g. <code><nowiki>https://sessionserver.mojang.com/session/minecraft/profile/</nowiki><''UUID''>?unsigned=false</code>. A player property is considered valid by the client ~~iff~~ signed by any of these keys.		** {{Nbt\|list\|profilePropertyKeys}}: A list of public keys used for verifying player properties (such as skin and cape textures), from e.g. <code><nowiki>https://sessionserver.mojang.com/session/minecraft/profile/</nowiki><''UUID''>?unsigned=false</code>. A player property is considered valid by the client if signed by any of these keys.
	*** {{Nbt\|string}}: Base64-encoded DER public key.		*** {{Nbt\|string}}: Base64-encoded DER public key.
	** {{Nbt\|list\|playerCertificateKeys}}: A list of public keys used for verifying player public keys, e.g. from <code><nowiki>https://api.minecraftservices.com/player/certificates</nowiki></code>. A player certificate is considered valid by the client ~~iff~~ signed by any of these keys.		** {{Nbt\|list\|playerCertificateKeys}}: A list of public keys used for verifying player public keys, e.g. from <code><nowiki>https://api.minecraftservices.com/player/certificates</nowiki></code>. A player certificate is considered valid by the client if signed by any of these keys.
	*** {{Nbt\|string}}: Base64-encoded DER public key.		*** {{Nbt\|string}}: Base64-encoded DER public key.
	** {{Nbt\|list\|authenticationKeys}}: A list of public keys used for verifying authentication tokens, like the JWT access token used in the <code>Authorization</code> Header in most requests to the Minecraft API.		** {{Nbt\|list\|authenticationKeys}}: A list of public keys used for verifying authentication tokens, like the JWT access token used in the <code>Authorization</code> Header in most requests to the Minecraft API.