Skip to content

Download Steam Leaderboard Entries (Users)

Blueprint node screenshot

Asynchronously fetches leaderboard rows for a specific list of Steam users (by SteamID64). Returns a compact Entries Data handle and an Entry Count. Use Get Downloaded Leaderboard Entry to read individual rows.

Inputs

Pin Type Description
Leaderboard Handle FSAL_LeaderboardHandle Handle from Find or Create (must be valid).
SteamIDs String[] Array of SteamID64 strings (e.g., 7656119...). Invalid IDs are skipped. Internally clamped to a maximum number of users per call.

Outputs

Pin Type Description
On Success Exec Fired when rows are downloaded successfully.
On Failure Exec Fired on I/O failure, invalid handle, empty/invalid user list, or other errors.
Entries Data (On Success) FSAL_LeaderboardEntriesData Container holding all downloaded rows and request metadata. Pass this into Get Downloaded Leaderboard Entry.
Entry Count (On Success) int32 Number of rows that were actually downloaded. Use as the max index when iterating.

Usage

  • Prepare a list of SteamID64 strings for the users you care about (party members, friends, rivals, etc.).
  • Call Download Steam Leaderboard Entries (Users) with a valid Leaderboard Handle and your SteamIDs array.
  • On Success, store the returned Entries Data and Entry Count.
  • Loop from Index = 0 .. EntryCount - 1 and call Get Downloaded Leaderboard Entry to retrieve each row struct (SteamID, PlayerName, GlobalRank, Score, Details[], UGC data, etc.).

Notes

  • Only users with an existing score on the leaderboard will return a row.
  • Large lists are clamped internally (roughly up to 100 users per request). For larger sets, batch multiple calls.
  • Provide SteamID64 as strings; malformed or invalid IDs are ignored.
  • If no valid IDs remain after parsing, the node will fire On Failure with a clear error message.