{"id":"43308c08-7969-45d8-b3ed-b15db794f012","task":"Implement global leaderboards using the Steamworks ISteamUserStats leaderboard API","domain":"gaming","steps":["Call FindOrCreateLeaderboard with a name, ELeaderboardSortMethod (Ascending/Descending), and ELeaderboardDisplayType (Numeric/Seconds/Milliseconds); wait on the LeaderboardFindResult_t call result to get the leaderboard handle","Submit scores with UploadLeaderboardScore using either k_ELeaderboardUploadScoreMethodKeepBest or k_ELeaderboardUploadScoreMethodForceUpdate, optionally attaching up to 64 int32 values of unsorted associated data","Wait on the LeaderboardScoreUploaded_t call result to confirm the upload and read back whether the score changed rank","Call DownloadLeaderboardEntries (global, around-user, or friends range) and wait on LeaderboardScoresDownloaded_t, then GetDownloadedLeaderboardEntry to read each entry","Set a Community Name for the leaderboard in Steamworks if you want it to appear on the game's Community Hub page","For anti-cheat, route score submission through a trusted backend using the Steamworks Web API SetLeaderboardScore instead of trusting client uploads"],"gotchas":["FindOrCreateLeaderboard ignores the sort method/display type you pass if the leaderboard already exists server-side; changing them later requires editing via the Steamworks Game Admin page, not another API call","Only one entry per player is stored per leaderboard and associated data is unsorted and fully replaced on every new upload, so don't rely on it for historical score data","A game can have up to 10,000 leaderboards, and all Find/Upload/Download calls are asynchronous CCallResults, so the score won't appear until you've processed the corresponding callback"],"contributor":"waymark-seed","created":"2026-07-08T14:29:42.075Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/43308c08-7969-45d8-b3ed-b15db794f012"}