Leaderboard Configuration Reference
Detailed documentation for all leaderboard configuration parameters
Core Elo Settings
Fundamental parameters that control how Elo ratings are calculated
elo_default_rating
1200
The starting Elo rating assigned to new players. This is the baseline rating from which all players begin their competitive journey.
elo_k_factor
32
Controls how much ratings change after each match. Higher values cause larger rating changes, making the system more responsive but potentially more volatile. Lower values create smaller, more stable rating adjustments.
elo_precision
rounded
Determines how Elo ratings are displayed and stored. 'rounded' shows whole numbers, '2_decimal' shows ratings with two decimal places, and 'full' maintains the precise calculation values.
Options:
matches_required_for_ranking
0
The minimum number of matches a player must complete before being considered 'ranked' and appearing on the leaderboard rankings.
Rating Difference Impact
Settings that control how rating differences between players affect outcomes
elo_influence_range
400
Controls how much rating difference affects expected win probability in the Elo formula. Higher values (e.g. 500) mean rating differences have less impact on expected outcomes. Lower values (e.g. 200) mean rating differences have more impact on expected outcomes.
elo_curve_factor
10
Adjusts the steepness of the probability curve in the Elo calculation. Higher values create a steeper curve, making small rating differences more significant in determining expected outcomes.
elo_max_advantage
Infinity
Sets a maximum limit on how much rating advantage a player can have while still gaining points from a win. Once a player's rating exceeds their opponent's by this amount, they will no longer gain points from beating that opponent. Set to Infinity to disable this limit.
Elo Capping Controls
Advanced settings for limiting the impact of large rating differences
elo_cap_range
matches elo_influence_range
Sets the specific limit for capping rating differences when any capping option is enabled. Can be set differently from elo_influence_range to separate capping from probability calculations. Lower values create tighter bounds on rating changes. Higher values allow for larger rating changes before capping takes effect.
elo_cap_favorite_win_impact
true
Controls whether to limit how much rating difference affects the calculation when a higher-rated player beats a lower-rated player. When true: Ensures favorites still gain a meaningful minimum amount of points when beating much lower-rated opponents. When false: The full rating difference is considered, allowing gains to diminish to virtually zero when beating much lower-rated opponents (great for preventing high-rated players from 'farming').
elo_cap_favorite_loss_impact
true
Controls whether to limit how much rating difference affects the calculation when a higher-rated player loses to a lower-rated player. When true: Limits the maximum rating loss for favorites when losing to much lower-rated opponents. When false: The full rating difference is considered, potentially causing very large rating drops when favorites lose to much lower-rated opponents.
elo_cap_underdog_win_impact
true
Controls whether to limit how much rating difference affects the calculation when a lower-rated player beats a higher-rated player. When true: Limits the maximum rating gain for underdogs when beating much higher-rated opponents. When false: The full rating difference is considered, potentially allowing massive rating boosts when underdogs beat much higher-rated opponents.
elo_cap_underdog_loss_impact
true
Controls whether to limit how much rating difference affects the calculation when a lower-rated player loses to a higher-rated player. When true: Ensures underdogs still lose a meaningful amount of rating when losing to much higher-rated opponents. When false: The full rating difference is considered, allowing underdogs to lose extremely minimal points when losing to much higher-rated opponents.
Multi-player Settings
Settings that affect how ratings are calculated in games with more than two players
elo_ffa_distribution
true
Controls whether to distribute rating changes in free-for-all (FFA) matches. When true, a player's rating change is divided by the number of opponents, preventing excessive rating changes in large matches. When false, each matchup is calculated independently, potentially leading to larger rating swings.
elo_loss_dampen
0
Reduces the rating loss for players by the specified percentage. A value of 20 means players lose 20% less rating on defeats. This can be used to make the system more forgiving for losses, encouraging continued participation.
Tier Systems
Settings for creating ranking tiers based on player ratings
player_global_all_tiers
[]
Defines rating tiers for global player rankings across all match types. Each tier specifies a name, required Elo rating, color, and optional Discord role to assign.
player_global_even_tiers
[]
Defines rating tiers for player rankings in evenly balanced matches (where all teams have the same size).
player_global_uneven_tiers
[]
Defines rating tiers for player rankings in unevenly balanced matches (where teams have different sizes).
player_broad_tiers
[]
Defines rating tiers for player rankings grouped by team size (e.g., all 1v1 matches, all 2v2 matches).
player_specific_tiers
[]
Defines rating tiers for player rankings in specific match formats (e.g., 1v1, 2v2, 3v3).
team_broad_tiers
[]
Defines rating tiers for team rankings grouped by team size.
team_specific_tiers
[]
Defines rating tiers for team rankings in specific match formats.
Display Settings
Customization options for leaderboard appearance
display_name
None
The name displayed for the leaderboard in the UI and on Discord.
description
None
A short description explaining the purpose or rules of the leaderboard.
icon
None
URL to an image used as the leaderboard icon in the UI and on Discord.
banner
None
URL to an image used as the leaderboard banner in the UI.
primary_color
#c81e1e
The main color used for highlighting and branding the leaderboard.
secondary_color
#1e2534
The secondary color used for accents and complementary elements.
How to set configurations
These configuration options can be set using the /profile_manager
leaderboard
and /leaderboard_config set
commands
in Discord or by using the API endpoint POST /set_leaderboard_profile
.
To update multiple configurations at once, you can include multiple parameters in a single command or API call.
How does the Elo rating system work?
The Elo rating system is a method for calculating the relative skill levels of players. After each game, points are transferred from the loser to the winner. Try our interactive Elo Calculator to see how different match outcomes affect ratings.