josh/electric-cherry
1
0
Fork 0
Code Issues 18 Pull Requests Actions Packages Projects Releases Wiki Activity

Store cumulative player scores alongside balances
CI / checks (push) Successful in 6m27s
Details

Browse Source
This commit is contained in:
josh
2026-10-12 13:57:34 -04:00
parent 76325b99ad
commit 6059ebf2a5
12 changed files with 181 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/guides/leaderboard.md
+15
View File
@@ -96,6 +96,21 @@ of inferring one. GUIDs stay strings.
## Recorded statistics
Telemetry stat reports (`round_change`, `heartbeat`, and `game_end`) may include
`score_total`, a nonnegative integer read from the game's cumulative match score.
`score` remains the spendable balance. Updated T5/T6 reporters capture game end
at the first end signal, before stock intermission replaces the balance with the
total. `game_start` remains identity-only. Deploy the receiver before the updated
reporters so it retains the new field.
The receiver accepts older reports without `score_total`. Latest telemetry
preserves the field when supplied; match history retains the highest observed
total independently of the balance and exposes it as `scoreTotal` on each player
in the match-detail API. Missing totals and pre-upgrade history are unknown
(`null`), not zero, and are never inferred from balances. Totals are per match;
repeated snapshots are not added together. Existing score rankings continue to
use the highest reported balance.
| Statistic | Meaning |
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Highest round | Highest round reported with that player present, including players who joined mid-game. |