Server List Ping - Revision history

imported>Mudkipdev at 06:02, 23 October 2024

2024-10-23T06:02:50Z

← Older revision		Revision as of 06:02, 23 October 2024
Line 71:		Line 71:
	{		{
	"version": {		"version": {
	"name": "1.19.4",		"name": "1.21.2",
	"protocol": ~~762~~		"protocol": 768
	},		},
	"players": {		"players": {

imported>Dusterthefirst: This was tested and found out through testing with the server.properties file of a vanilla server.

2024-08-05T18:00:11Z

This was tested and found out through testing with the server.properties file of a vanilla server.

← Older revision		Revision as of 18:00, 5 August 2024
Line 99:		Line 99:

	The ''players'' field is optional. If omitted, "???" will be displayed in dark grey in place of the player count.		The ''players'' field is optional. If omitted, "???" will be displayed in dark grey in place of the player count.

			The numbers ''max'' and ''online'' in the players field have a maximum supported value of 2<sup>31</sup>-1 (2,147,483,647) by the vanilla Minecraft server. Larger values were observed to be set to the default value of 20.

	If the ''sample'' field of the ''players'' object is present, the player names (but not their UUIDs) will be shown in order in the tooltip when hovering over the player count (or version name if incompatible). If empty, missing, or the wrong type, no tooltip will appear. Notchian servers will omit this field if there are no players on the server or if <code>hide-online-players</code> is false. There doesn't appear to be a hard limit on how many players may be specified.		If the ''sample'' field of the ''players'' object is present, the player names (but not their UUIDs) will be shown in order in the tooltip when hovering over the player count (or version name if incompatible). If empty, missing, or the wrong type, no tooltip will appear. Notchian servers will omit this field if there are no players on the server or if <code>hide-online-players</code> is false. There doesn't appear to be a hard limit on how many players may be specified.

imported>Oq: /* Status Response */ fix

2024-07-27T23:46:34Z

Status Response: fix

← Older revision		Revision as of 23:46, 27 July 2024
Line 88:		Line 88:
	},		},
	"favicon": "data:image/png;base64,<data>",		"favicon": "data:image/png;base64,<data>",
	"enforcesSecureChat~~": false,~~		"enforcesSecureChat": false
	~~"previewsChat~~": false
	}		}
	</syntaxhighlight>		</syntaxhighlight>

imported>Compscitwilight: removed the ambiguity of redirecting to a disambiguation page

2024-06-28T10:38:12Z

removed the ambiguity of redirecting to a disambiguation page

← Older revision		Revision as of 10:38, 28 June 2024
Line 1:		Line 1:
	'''Server List Ping''' ('''SLP''') is an interface provided by Minecraft servers which supports querying the MOTD, player count, max players and server version via the usual port. SLP is part of the [[Protocol]], but it can be disabled. The Notchian client uses this interface to display the multiplayer server list, hence the name. The SLP process changed in {{Minecraft Wiki\|1.7}} in a non-backwards compatible way, but modern clients and servers still support both the [[#Current\|new]] and [[#1.6\|old]] process.		'''Server List Ping''' ('''SLP''') is an interface provided by Minecraft servers which supports querying the MOTD, player count, max players and server version via the usual port. SLP is part of the [[Protocol]], but it can be disabled. The Notchian client uses this interface to display the multiplayer server list, hence the name. The SLP process changed in {{Minecraft Wiki\|Java Edition 1.7}} in a non-backwards compatible way, but modern clients and servers still support both the [[#Current\|new]] and [[#1.6\|old]] process.

	== Current (1.7+) ==		== Current (1.7+) ==

imported>WithAnimeException at 06:51, 4 May 2024

2024-05-04T06:51:43Z

← Older revision		Revision as of 06:51, 4 May 2024
Line 101:		Line 101:
	The ''players'' field is optional. If omitted, "???" will be displayed in dark grey in place of the player count.		The ''players'' field is optional. If omitted, "???" will be displayed in dark grey in place of the player count.

	If the ''sample'' field is present, the player names (but not their UUIDs) will be shown in order in the tooltip when hovering over the player count (or version name if incompatible). If empty, missing, or the wrong type, no tooltip will appear. Notchian servers will omit this field if there are no players on the server or if <code>hide-online-players</code> is false.		If the ''sample'' field of the ''players'' object is present, the player names (but not their UUIDs) will be shown in order in the tooltip when hovering over the player count (or version name if incompatible). If empty, missing, or the wrong type, no tooltip will appear. Notchian servers will omit this field if there are no players on the server or if <code>hide-online-players</code> is false. There doesn't appear to be a hard limit on how many players may be specified.

	If a ~~player~~ has "Allow Server Listings" set to "OFF", Notchian servers will report their name as "Anonymous Player" and UUID as "00000000-0000-0000-0000-000000000000". This is not reliable; making a request before the player has fully joined may cause their choice to not be respected.		If a client [[Protocol#Client_Information_.28configuration.29\|has "Allow Server Listings" set to "OFF"]], Notchian servers will report their name as "Anonymous Player" and UUID as "00000000-0000-0000-0000-000000000000". This is not reliable; making a request before the player has fully joined may cause their choice to not be respected.

	~~There doesn't appear to be a hard limit on how many objects may be in the ''sample'' array.~~ UUIDs are mandatory ~~on most client versions~~ and must be well formed even though it is unused by Notchian clients. Newer ~~clients~~ (1.20+?) will tolerate malformed or missing UUIDs and act as though ''sample'' was omitted if so.		On most Notchian client versions, UUIDs are mandatory and must be well formed even though it is unused by Notchian clients. Newer versions (1.20+?) will tolerate malformed or missing UUIDs and act as though ''sample'' was omitted if so.

	If the server has No Chat Reports installed and hasn't disabled this feature, an additional field ''preventsChatReports'' will be added to the end with a value of true causing clients with No Chat Reports to display an icon indicating the server is a "Safe Server".		If the server has No Chat Reports installed and hasn't disabled this feature, an additional field ''preventsChatReports'' will be added to the end with a value of true causing clients with No Chat Reports to display an icon indicating the server is a "Safe Server".
Line 111:		Line 111:
	After receiving the Response packet, the client may send the next packet to help calculate the server's latency, or if it is only interested in the above information it can disconnect here.		After receiving the Response packet, the client may send the next packet to help calculate the server's latency, or if it is only interested in the above information it can disconnect here.

	If the client does not receive a properly formatted response (e.g. a field is missing or the wrong type, it will close the socket and instead attempt a [[Server_List_Ping#1.6\|legacy ping]].		If the client does not receive a properly formatted response (e.g. a field is missing or the wrong type), it will close the socket and instead attempt a [[Server_List_Ping#1.6\|legacy ping]].

	=== Ping Request ===		=== Ping Request ===

imported>WithAnimeException: additional information (players and players.sample can be omitted; allow server listings; preventsChatReports; "Old" name)

2024-05-04T06:42:22Z

additional information (players and players.sample can be omitted; allow server listings; preventsChatReports; "Old" name)

← Older revision		Revision as of 06:42, 4 May 2024
Line 85:		Line 85:
	},		},
	"description": {		"description": {
	"text": "Hello world"		"text": "Hello, world!"
	},		},
	"favicon": "data:image/png;base64,<data>",		"favicon": "data:image/png;base64,<data>",
	"enforcesSecureChat": ~~true~~,		"enforcesSecureChat": false,
	"previewsChat": ~~true~~		"previewsChat": false
	}		}
	</syntaxhighlight>		</syntaxhighlight>

	An ''id'' of a ''~~sample~~'' ~~needs to~~ be ~~a valid UUID format~~, ~~else~~ the ~~connection will abort~~.		The ''name'' field of the ''version'' object should be considered mandatory. On newer Notchian client versions (1.20+?), it may be omitted and will be treated as though it were the string "Old" if so.

	The ''description'' field is a [[Text formatting#Text components\|text component]]. Note that the Notchian server has no way of providing actual text component data; instead section sign-based codes are embedded within the text of the object. However, third-party servers such as Spigot and Paper will return full components, so make sure you can handle both.		The ''description'' field is optional. If specified, it should be a [[Text formatting#Text components\|text component]]. Note that the Notchian server has no way of providing actual text component data; instead section sign-based codes are embedded within the text of the object. However, third-party servers such as Spigot and Paper will return full components, so make sure you can handle both.

	The ''favicon'' field is optional. ~~The ''sample'' field may~~ be ~~missing if~~ the ~~server has no online players~~.		The ''favicon'' field is optional. If specified, it should be a [[wikipedia:Portable Network Graphics\|PNG]] image that is [[wikipedia:Base64\|Base64]] encoded (without newlines: <code>\n</code>, new lines no longer work since 1.13) and prepended with <code>data:image/png;base64,</code>. It should also be noted that the source image must be exactly 64x64 pixels, otherwise the Notchian client will not render the image.

	The ''~~favicon~~'' ~~should~~ be ~~a [[wikipedia:Portable Network Graphics\|PNG]] image that~~ is ~~[[wikipedia:Base64\|Base64]] encoded~~ (~~without newlines:~~ <code>\n</code>, ~~new lines no longer work since 1~~.~~13) and prepended with <code>data:image/png~~;~~base64,</code>~~. ~~It should also~~ be ~~noted that~~ the ~~source image~~ must be ~~exactly 64x64 pixels~~, ~~otherwise~~ the ~~Notchian client will not render~~ the ~~image~~.		The ''players'' field is optional. If omitted, "???" will be displayed in dark grey in place of the player count.

			If the ''sample'' field is present, the player names (but not their UUIDs) will be shown in order in the tooltip when hovering over the player count (or version name if incompatible). If empty, missing, or the wrong type, no tooltip will appear. Notchian servers will omit this field if there are no players on the server or if <code>hide-online-players</code> is false.

			If a player has "Allow Server Listings" set to "OFF", Notchian servers will report their name as "Anonymous Player" and UUID as "00000000-0000-0000-0000-000000000000". This is not reliable; making a request before the player has fully joined may cause their choice to not be respected.

			There doesn't appear to be a hard limit on how many objects may be in the ''sample'' array. UUIDs are mandatory on most client versions and must be well formed even though it is unused by Notchian clients. Newer clients (1.20+?) will tolerate malformed or missing UUIDs and act as though ''sample'' was omitted if so.

			If the server has No Chat Reports installed and hasn't disabled this feature, an additional field ''preventsChatReports'' will be added to the end with a value of true causing clients with No Chat Reports to display an icon indicating the server is a "Safe Server".

	After receiving the Response packet, the client may send the next packet to help calculate the server's latency, or if it is only interested in the above information it can disconnect here.		After receiving the Response packet, the client may send the next packet to help calculate the server's latency, or if it is only interested in the above information it can disconnect here.

	If the client does not receive a properly formatted response, ~~then~~ it will instead attempt a [[Server_List_Ping#1.6\|legacy ping]].		If the client does not receive a properly formatted response (e.g. a field is missing or the wrong type, it will close the socket and instead attempt a [[Server_List_Ping#1.6\|legacy ping]].

	=== Ping Request ===		=== Ping Request ===

imported>Duckulus: add link to legacy ping implementation in rust

2024-04-14T11:43:35Z

add link to legacy ping implementation in rust

← Older revision		Revision as of 11:43, 14 April 2024
Line 220:		Line 220:
	* [https://gist.github.com/6281388 Ruby]		* [https://gist.github.com/6281388 Ruby]
	* [https://github.com/winny-/mcstat PHP]		* [https://github.com/winny-/mcstat PHP]
			* [https://github.com/Duckulus/mc-honeypot/blob/1514807e8af7f7cbfd13111fec334b9f4883b605/src/server/legacy.rs Rust (Server)]
	* [https://github.com/dreamscached/minequery Go]		* [https://github.com/dreamscached/minequery Go]
	* [https://github.com/mcstatus-io/mcutil Go]		* [https://github.com/mcstatus-io/mcutil Go]

imported>Duckulus: Add link to example implementation in Rust

2024-04-12T20:45:48Z

Add link to example implementation in Rust

← Older revision		Revision as of 20:45, 12 April 2024
Line 148:		Line 148:
	* [https://gist.github.com/zh32/7190955 Java]		* [https://gist.github.com/zh32/7190955 Java]
	* [https://gist.github.com/1209061 Python]		* [https://gist.github.com/1209061 Python]
			* [https://github.com/Duckulus/mc-honeypot Rust (Server)]
	* [https://github.com/Sch8ill/MCClient-lib MCClient-lib (Python3)]		* [https://github.com/Sch8ill/MCClient-lib MCClient-lib (Python3)]
	* [https://gist.github.com/ewized/97814f57ac85af7128bf Python3]		* [https://gist.github.com/ewized/97814f57ac85af7128bf Python3]

imported>Starlk: Add my repo :3

2024-04-08T04:01:15Z

Add my repo :3

← Older revision		Revision as of 04:01, 8 April 2024
Line 145:		Line 145:
	=== Examples ===		=== Examples ===

	* [https://gist.github.com/csh/2480d14fbbb33b4bbae3 C#]		* [https://gist.github.com/csh/2480d14fbbb33b4bbae3 C#], [https://github.com/TheVeryStarlk/Pingo C#]
	* [https://gist.github.com/zh32/7190955 Java]		* [https://gist.github.com/zh32/7190955 Java]
	* [https://gist.github.com/1209061 Python]		* [https://gist.github.com/1209061 Python]

imported>Sch8ill: /* Examples */

2024-04-03T16:34:59Z

Examples

← Older revision		Revision as of 16:34, 3 April 2024
Line 155:		Line 155:
	* [https://github.com/stackotter/delta-client/blob/main/Sources/Core/Sources/Network/LANServerEnumerator.swift Swift]		* [https://github.com/stackotter/delta-client/blob/main/Sources/Core/Sources/Network/LANServerEnumerator.swift Swift]
	* [https://github.com/dreamscached/minequery Go]		* [https://github.com/dreamscached/minequery Go]
			* [https://github.com/Sch8ill/mclib Go]
	* [https://github.com/PauldeKoning/minecraft-server-handshake Node.js]		* [https://github.com/PauldeKoning/minecraft-server-handshake Node.js]
	* [https://github.com/LhAlant/MinecraftSLP/ C]		* [https://github.com/LhAlant/MinecraftSLP/ C]