Event Leaderboards

Read more about the Event Leaderboards system in Hiro here.

Listing Event Leaderboards #

You can list all the available event leaderboards to the player by not specifying any categories in the request.

1
2
3
4

var request = EventLeaderboardList();

var event_leaderboards = await hiro.eventLeaderboardList(session!, request);
print(event_leaderboards);

You can filter down the event leaderboards to only include those that belong to at least one of the given categories.

1
2
3
4
5
6

var request = EventLeaderboardList();
request.categories.append("level_complete");
request.categories.append("race");

var event_leaderboards = await hiro.eventLeaderboardList(session!, request);
print(event_leaderboard);

By default, the response doesn’t include the scores of the event leaderboards. To have the response returning with the scores, set the boolean with_scores on the request to true.

1
2
3
4
5

var request = EventLeaderboardList();
request.with_scores = true;

var event_leaderboards = await hiro.eventLeaderboardList(session!, request);
print(event_leaderboards);

Get an event leaderboard #

Get a specified event leaderboard defined for the game.

1
2
3
4
5

var request = EventLeaderboardGet();
request.id = "leaderboard_1";

var event_leaderboard = await hiro.eventLeaderboardGet(session!, request);
print(event_leaderboard);

Update event leaderboard record #

Update an event leaderboard record for a user.

1
2
3
4
5
6
7

var request = EventLeaderboardUpdate();
request.id = "leaderboard_1";
request.score = 100;
request.subscore = 10;

var event_leaderboard = await hiro.eventLeaderboardUpdate(session!, request);
print(event_leaderboard);

Claim event leaderboard reward #

Claim an event leaderboard reward for a user.

1
2
3
4
5

var request = EventLeaderboardClaim();
request.id = "leaderboard_1";

var event_leaderboard = await hiro.eventLeaderboardClaim(session!, request);
print(event_leaderboard);

Roll a new cohort #

Roll a new cohort for the specified event leaderboard.

1
2
3
4
5

var request = EventLeaderboardRoll();
request.id = "leaderboard_1";

var event_leaderboard = await hiro.eventLeaderboardRoll(session!, request);
print(event_leaderboard);

Debugging an event leaderboard #

You can fill an event leaderboard with dummy users and assign random scores to them for testing purposes.

This is intended for debugging use only.
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

var fill_request = EventLeaderboardDebugFillRequest();
fill_request.id = "leaderboard_1";
fill_request.target_count = 50;  // Optional target cohort size to fill to, otherwise fill to the max cohort size.

var scores_request = EventLeaderboardDebugRandomScoresRequest()
scores_request.id = "leaderboard_1";
scores_request.min = "1";
scores_request.max = "100";
scores_request.subscore_min = "1";
scores_request.subscore_max = "100";

// Fills cohort with debug players
var fill_leaderboard = await hiro.eventLeaderboardDebugFill(session!, fill_request);
print(fill_leaderboard);

// Sets randomly generated scores between a range for other players (does not change the user's score)
var scores_leaderboard = await hiro.eventLeaderboardDebugRandomScores(session!, scores_request);
print(scores_leaderboard);

// Removes user from their current cohort, allowing re-enrollment
var unenroll_request = EventLeaderboardDebugUnenrollRequest();
unenroll_request.id = "leaderboard_1";

var unenroll_leaderboard = await hiro.eventLeaderboardDebugUnenroll(session!, unenroll_request);
print(unenroll_leaderboard);