Ping Protocol - Revision history

Goldeye: Added link to PHP_ping_client

2007-12-26T13:03:00Z

Added link to PHP_ping_client

BaK: This -> The

2006-10-05T19:52:55Z

This -> The

BaK: wiktext'd

2006-09-28T11:11:33Z

wiktext'd

BaK: reorganized

2006-09-28T11:11:15Z

reorganized

BaK: small s? weird

2006-09-28T11:10:46Z

small s? weird

BaK: intro shouldn't only mention the new ping protocol

2006-09-28T11:09:53Z

intro shouldn't only mention the new ping protocol

66.211.206.160: added a direct link to asss' home page

2005-01-11T15:17:05Z

added a direct link to asss' home page

Smong: initial page with content

2005-01-11T14:37:07Z

initial page with content

New page

This new ping protocol can be used by clients to retrieve specific information on the distribution of the players in an ASSS zone. It can be used for statistics purposes to gauge how popular an arena is, etc.

The following is from doc/ping.txt which you can find inside the ASSS distro.

<pre>
ping/information protocol
version 1.0
grelminar@yahoo.com

-------------------------

all communication happens over udp on the port one higher than the game
protocol port. byte order is little-endian. no packet will be larger
than 512 bytes. everything is stateless.

option one (the old ping protocol):

client sends a 4 byte packet to the server's ping port. typically the 4
bytes will be a timestamp, but the server doesn't interpret them.

struct C2SSimplePing {
u32 timestamp;
};

the server replies with 8 bytes:

struct S2CSimplePing {
u32 total;
u32 timestamp;
};

where total is the current number of fully-connected clients (including
bots but not including server-internal fake players). timestamp is a
copy of the client's timestamp.

for asss virtual zones, the total will be the number of fully-connected
clients in all the arenas belonging to that virtual zone.

option two (new asss ping protocol):

client sends an 8 byte packet to the server's ping port.

struct C2SNewPing {
u32 timestamp;
u32 options;
};

again, the timestamp isn't interpreted by the server.

options is a bitfield where each bit indicates a request for a certain
type of information to be returned.

the current defined bits are:

PING_GLOBAL_SUMMARY = 0x01 - global player count information
PING_ARENA_SUMMARY = 0x02 - by-arena player count information

the server responds with a variable-length packet.

the first 8 bytes are always the following:

struct S2CNewPingHeader {
u32 timestamp;
u32 options;
};

the timestamp is copied from the client. the options bitfield indicates
what data is present, and how the following bytes should be interpreted.

note that the options returned might not be the same as the options
requested, although typically they will be.

if PING_GLOBAL_SUMMARY is included, the next 8 bytes will be:

struct S2CNewPingGlobalSummary {
u32 total;
u32 playing;
};

where total is the number of fully-connected clients, and playing is the
number of clients that are actually flying around in ships.

if PING_ARENA_SUMMARY is included, the next variable-length sequence of
bytes will be a series of blocks of this format:

struct S2CNewPingArenaSummaryChunk {
char name[]; // variable-length and null-terminated
u16 total;
u16 playing;
};

arena names that consist of only digits are considered "public arenas"
and should probably be displayed as "(Public %d)".

a one-byte chunk with a zero-length name (that is, a single nul byte)
indicates the end of the series.

note that the sums of the data in the arena chunks may not add up to the
values in the global summary because of the presence of hidden arenas.
</pre>

[[Category: Protocol]]

@@ Line 1: / Line 1: @@
 There are two ping protocols currently in use. The old ping protocol, supported by [[ASSS]], [[Subgame]], [[Continuum]], and [[Directory server]]s, allows one to receive information about the number of players in a [[zone]]. The new ping protocol, supported by ASSS, can be used to retrieve specific information on the distribution of the players in each [[arena]] within a zone.
 The following is from doc/ping.txt which you can find inside the ASSS distro.
 However, the latest version can always be found at http://www.sscx.net/asss/ping.txt
 <pre>

← Older revision		Revision as of 19:52, 5 October 2006
Line 1:		Line 1:
−	There are two ping protocols currently in use. The old ping protocol, supported by [[ASSS]], [[Subgame]], [[Continuum]], and [[Directory server]]s, allows one to receive information about the number of players in a [[zone]]. ~~This~~ new ping protocol, supported by ASSS, can be used to retrieve specific information on the distribution of the players in each [[arena]] within a zone.	+	There are two ping protocols currently in use. The old ping protocol, supported by [[ASSS]], [[Subgame]], [[Continuum]], and [[Directory server]]s, allows one to receive information about the number of players in a [[zone]]. The new ping protocol, supported by ASSS, can be used to retrieve specific information on the distribution of the players in each [[arena]] within a zone.

	The following is from doc/ping.txt which you can find inside the ASSS distro.		The following is from doc/ping.txt which you can find inside the ASSS distro.

← Older revision		Revision as of 11:11, 28 September 2006
Line 1:		Line 1:
−	There are two ping protocols currently in use. The old ping protocol, supported by [[ASSS]], [[Subgame]], [[Continuum]], and [[Directory server]]s, allows one to receive information about the number of players in a [zone]. This new ping protocol, supported by ASSS, can be used to retrieve specific information on the distribution of the players in each [arena] within a zone.	+	There are two ping protocols currently in use. The old ping protocol, supported by [[ASSS]], [[Subgame]], [[Continuum]], and [[Directory server]]s, allows one to receive information about the number of players in a [[zone]]. This new ping protocol, supported by ASSS, can be used to retrieve specific information on the distribution of the players in each [[arena]] within a zone.

	The following is from doc/ping.txt which you can find inside the ASSS distro.		The following is from doc/ping.txt which you can find inside the ASSS distro.

← Older revision		Revision as of 11:11, 28 September 2006
Line 1:		Line 1:
−	There are two ping protocols in use ~~in [[Continuum]] today~~. The old ping protocol, supported by [[ASSS]], [[Subgame]], [[Continuum]], and [[Directory server]]s, allows one to receive information about the number of players in a [zone]. This new ping protocol, supported by ASSS, can be used to retrieve specific information on the distribution of the players in each [arena] within a zone.	+	There are two ping protocols currently in use. The old ping protocol, supported by [[ASSS]], [[Subgame]], [[Continuum]], and [[Directory server]]s, allows one to receive information about the number of players in a [zone]. This new ping protocol, supported by ASSS, can be used to retrieve specific information on the distribution of the players in each [arena] within a zone.

	The following is from doc/ping.txt which you can find inside the ASSS distro.		The following is from doc/ping.txt which you can find inside the ASSS distro.

← Older revision		Revision as of 11:10, 28 September 2006
Line 1:		Line 1:
−	There are two ping protocols in use in [[Continuum]] today. The old ping protocol, supported by [[ASSS]], [[Subgame]], [[Continuum]], and [[Directory ~~Server~~]]s, allows one to receive information about the number of players in a [zone]. This new ping protocol, supported by ASSS, can be used to retrieve specific information on the distribution of the players in each [arena] within a zone.	+	There are two ping protocols in use in [[Continuum]] today. The old ping protocol, supported by [[ASSS]], [[Subgame]], [[Continuum]], and [[Directory server]]s, allows one to receive information about the number of players in a [zone]. This new ping protocol, supported by ASSS, can be used to retrieve specific information on the distribution of the players in each [arena] within a zone.

	The following is from doc/ping.txt which you can find inside the ASSS distro.		The following is from doc/ping.txt which you can find inside the ASSS distro.

← Older revision		Revision as of 11:09, 28 September 2006
Line 1:		Line 1:
−	This new ping protocol can be used ~~by clients~~ to retrieve specific information on the distribution of the players in ~~an ASSS~~ zone~~. It can be used for statistics purposes to gauge how popular an arena is, etc~~.	+	There are two ping protocols in use in [[Continuum]] today. The old ping protocol, supported by [[ASSS]], [[Subgame]], [[Continuum]], and [[Directory Server]]s, allows one to receive information about the number of players in a [zone]. This new ping protocol, supported by ASSS, can be used to retrieve specific information on the distribution of the players in each [arena] within a zone.

	The following is from doc/ping.txt which you can find inside the ASSS distro.		The following is from doc/ping.txt which you can find inside the ASSS distro.

← Older revision		Revision as of 15:17, 11 January 2005
Line 2:		Line 2:

	The following is from doc/ping.txt which you can find inside the ASSS distro.		The following is from doc/ping.txt which you can find inside the ASSS distro.
		+
		+	However, the latest version can always be found at http://www.sscx.net/asss/ping.txt

	<pre>		<pre>