Support player ping in game telemetry

2026-10-06 21:10:25 -04:00
parent 2520735850
commit 675d9b1576
6 changed files with 61 additions and 4 deletions
@@ -33,6 +33,14 @@ there are no players. Names and GUIDs are strings; keep GUIDs as strings to
 preserve their precision. Round and stat values are nonnegative JSON integers.
 Each GUID must appear only once within a report's player array.

+Every event also accepts an optional per-player `ping`: the game server's current
+latency measurement in milliseconds, as a nonnegative JSON integer (for example,
+`"ping": 42`). Send `null` or omit the field when unavailable; do not substitute
+zero for a missing measurement. Older reporters without this field remain valid.
+Fleet displays ping from the same telemetry snapshot as the player roster and
+scores, with `—` for unknown values. Ping is retained and streamed with the latest
+report; it does not contribute to leaderboard statistics.
+
 ### Game start

 Send when the game starts. Round and stats are not required.