Skip to content

Configuration

/leaderboard_config

admins only 23 subcommands 57 options

Configure Elo rating settings for leaderboards

Who can run it

Server administrators only, until you say otherwise. Discord hides this command from everyone else, so members will not see it in the command picker at all. To open it up, go to Server Settings → Integrations → Team Up and add a role or member override for /leaderboard_config. Command permission overrides are desktop-only — they cannot be configured from the Discord mobile app.

Command permissions guide →

Subcommands

/leaderboard_config basics set

Set basic Elo configuration values

OptionTypeWhat it does
leaderboard text Name of the leaderboard (defaults to channel default)
lock text Lock or unlock a leaderboard for match recording
Choices: lock, unlock
default_rating integer Default Elo rating for new players (default: 1200)
k_factor integer
min 1
K-factor for Elo calculations (default: 32)
precision text Precision for Elo ratings
Choices: rounded, 2_decimal, full
loss_dampen integer
0–100
Percentage to reduce Elo losses (0-100, default: 0)
min_rating integer Minimum rating floor - ratings cannot drop below this value (default: disabled)

* required

/leaderboard_config basics view

View basic Elo configuration settings

OptionTypeWhat it does
leaderboard text Name of the leaderboard (defaults to channel default)

* required

/leaderboard_config basics reset

Reset a basic Elo setting to its default value

OptionTypeWhat it does
setting *text The setting to reset
Choices: lock, elo_default_rating, elo_k_factor, elo_precision, elo_loss_dampen, elo_min_rating
leaderboard text Name of the leaderboard (defaults to channel default)

* required

/leaderboard_config curve set

Set advanced curve configuration values

OptionTypeWhat it does
leaderboard text Name of the leaderboard (defaults to channel default)
max_advantage integer
min 1
Max rating difference that affects Elo calculation
influence_range integer
min 1
Rating difference range for probability calculation (default: 400)
curve_factor integer
min 1
Base of the exponent in Elo formula (default: 10)
ffa_distribution true/false Distribute Elo changes in free-for-all matches

* required

/leaderboard_config curve view

View advanced curve configuration settings

OptionTypeWhat it does
leaderboard text Name of the leaderboard (defaults to channel default)

* required

/leaderboard_config curve reset

Reset an advanced curve setting to its default value

OptionTypeWhat it does
setting *text The setting to reset
Choices: elo_max_advantage, elo_influence_range, elo_curve_factor, elo_ffa_distribution
leaderboard text Name of the leaderboard (defaults to channel default)

* required

/leaderboard_config ranking set

Set ranking display configuration values

OptionTypeWhat it does
leaderboard text Name of the leaderboard (defaults to channel default)
matches_required integer
min 0
Number of matches required before ranking is displayed
inactive_days integer
min 0
Hide players/teams inactive for this many days (0 = never hide)

* required

/leaderboard_config ranking view

View ranking display configuration settings

OptionTypeWhat it does
leaderboard text Name of the leaderboard (defaults to channel default)

* required

/leaderboard_config ranking reset

Reset a ranking display setting to its default value

OptionTypeWhat it does
setting *text The setting to reset
Choices: matches_required_for_ranking, inactive_days_threshold
leaderboard text Name of the leaderboard (defaults to channel default)

* required

/leaderboard_config caps set

Set Elo cap configuration values

OptionTypeWhat it does
leaderboard text Name of the leaderboard (defaults to channel default)
cap_range integer
min 1
Rating difference limit for capping calculations (default: 400)
cap_favorite_win true/false Whether to cap rating gains when favorites win (default: true)
cap_favorite_loss true/false Whether to cap rating losses when favorites lose (default: true)
cap_underdog_win true/false Whether to cap rating gains when underdogs win (default: true)
cap_underdog_loss true/false Whether to cap rating losses when underdogs lose (default: true)

* required

/leaderboard_config caps view

View Elo cap configuration settings

OptionTypeWhat it does
leaderboard text Name of the leaderboard (defaults to channel default)

* required

/leaderboard_config caps reset

Reset an Elo cap setting to its default value

OptionTypeWhat it does
setting *text The setting to reset
Choices: elo_cap_range, elo_cap_favorite_win_impact, elo_cap_favorite_loss_impact, elo_cap_underdog_win_impact, elo_cap_underdog_loss_impact
leaderboard text Name of the leaderboard (defaults to channel default)

* required

/leaderboard_config farming set

Set farming detection configuration values

OptionTypeWhat it does
leaderboard text Name of the leaderboard (defaults to channel default)
farming_detection true/false Enable/disable Elo farming detection alerts
farming_threshold integer
2–10
Consecutive wins against same player to trigger alert (default: 2)
farming_channel channel Channel to send farming alerts to
farming_role role Role to ping when farming is detected

* required

/leaderboard_config farming view

View farming detection configuration settings

OptionTypeWhat it does
leaderboard text Name of the leaderboard (defaults to channel default)

* required

/leaderboard_config farming reset

Reset a farming detection setting to its default value

OptionTypeWhat it does
setting *text The setting to reset
Choices: farming_detection_enabled, farming_streak_threshold, farming_notification_channel, farming_notification_role
leaderboard text Name of the leaderboard (defaults to channel default)

* required

/leaderboard_config casual_policy set

Set casual policy controls for this leaderboard

OptionTypeWhat it does
leaderboard text Name of the leaderboard (defaults to channel default)
update_elo true/false Update Elo ratings for casual matches (default: false)
update_win_loss true/false Update win/loss/draw records (default: false)
update_match_count true/false Increment match count (default: true)
update_head_to_head true/false Update head-to-head records (default: false)
collect_custom_stats true/false Store per-player custom stats (default: true)
aggregate_custom_stats true/false Update running stat aggregates used for rankings (default: false)

* required

/leaderboard_config casual_policy view

View the casual policy for this leaderboard

OptionTypeWhat it does
leaderboard text Name of the leaderboard (defaults to channel default)

* required

/leaderboard_config casual_policy reset

Reset leaderboard casual policy (inherit from server)

OptionTypeWhat it does
leaderboard text Name of the leaderboard (defaults to channel default)

* required

/leaderboard_config screenshot_instructions set

Set scoreboard-reading instructions for a leaderboard

OptionTypeWhat it does
instructions *text How to read this game's scoreboard (columns, separators, winner)
leaderboard text Name of the leaderboard (defaults to channel default)

* required

/leaderboard_config screenshot_instructions view

View the scoreboard-reading instructions in effect for a leaderboard

OptionTypeWhat it does
leaderboard text Name of the leaderboard (defaults to channel default)

* required

/leaderboard_config screenshot_instructions reset

Clear a leaderboard's instructions (falls back to server default)

OptionTypeWhat it does
leaderboard text Name of the leaderboard (defaults to channel default)

* required

/leaderboard_config all view

View all Elo configuration settings

OptionTypeWhat it does
leaderboard text Name of the leaderboard (defaults to channel default)

* required

/leaderboard_config all copy

Generate commands to copy settings from one leaderboard to another

OptionTypeWhat it does
from *text Source leaderboard to copy settings from
to *text Destination leaderboard to copy settings to

* required