Leaderboard Scheduled Triggers¶

Leaderboard triggers automatically distribute rewards to players based on their ranking in a leaderboard snapshot.

Configuration¶

To set up a leaderboard trigger, you need to define:

• Leaderboard Configuration: Select a pre-existing leaderboard.
• Max Rewards Per Player: A cap on how many times a single player can be rewarded by this specific trigger across a single execution cycle.

Reward Tiers¶

You map leaderboard positions to specific rewards.

Positions use inclusive bounds. In the example above, both the 6th and 20th place players receive the Silver Package.

Reallocation Strategy¶

Sometimes a player in a winning position cannot receive the reward (e.g., they have already 2 bets in the same leaderboard snapshot). You can choose how the system handles this:

Process Flow¶

flowchart TD
    Start[Trigger Fires] --> Fetch[Fetch Leaderboard Snapshot]
    Fetch --> Mapping[Apply Position to Reward Tier Mapping]
    Mapping --> CheckMax[Check Max Rewards Per Player]
    CheckMax --> Reallocate{Player Eligible?}
    Reallocate -- Yes --> Enroll[Create Enrollment]
    Reallocate -- No --> Strategy{Reallocation Strategy?}
    Strategy -- Skip --> Done[Next Position]
    Strategy -- BumpUp --> Move[Move Next Player Up]
    Move --> Reallocate
    Enroll --> Done

Example Scenario: Daily Payouts¶

A daily leaderboard trigger runs every 24 hours.

• Top 3 get Gold rewards.
• Positions 4-10 get Silver rewards.
• Strategy: Bump Up.

If Player X finishes #1 and #2, they are skipped during the 2nd enrollment. The player at #3 moves into the #2 slot, and the player at #11 moves into the #10 slot to ensure all 10 reward packages are distributed.