Leaderboard type · ELO

Discord ELO Bot for Ranked Leaderboards

Competitive, skill-based rankings that adjust after every match — with configurable K-factor, decay, tier roles, and a live web leaderboard.

ScoreboardsAPP
Discord ELO leaderboard with ratings, matches, wins, draws and losses, and the Submit result, Queue, My rank and Web buttons under it
Submit resultQueueMy rankWeb

Scoreboards is the Discord ELO bot built for competitive communities. Run a ranked ladder, seed a tournament bracket, or give your PvP server the kind of skill-based ranking system that keeps players chasing the next rating tier — all without leaving Discord, and with a web leaderboard your members can share outside it.

The basics

What is an ELO leaderboard?

ELO is a rating system originally developed by Arpad Elo for chess in the 1960s. Today it's the gold standard for competitive rankings — used by chess federations, fighting-game tournaments, StarCraft ladders, League of Legends, and most serious PvP communities, for 1v1 duels and team games alike.

The idea is simple: every match is a rating exchange. Beat a higher-rated opponent and gain a lot of points. Lose to a lower-rated opponent and lose a lot. Over time ratings self-correct and settle around each player's true skill level.

That's why ELO is the format of choice when you want a leaderboard that means something — not just a tally of who played the most.

Try the ELO maths

Move the ratings and pick a result. This is the formula the bot settles every match with.

K-factor

Result

Your chance to win30%

Your rating

15001523

+23

Their rating

16501627

−23

Features

How Scoreboards does ELO

Configurable K-factor

Pick how fast ratings move. A low K (10–16) keeps an established ladder stable. A high K (40+) suits short events where you want fast rank shifts. The default K=32 is a balanced start.

Custom starting rating

Players start at 1200 by default, but you can set any base rating that fits your community.

Match reporting from the leaderboard

Hit Submit result on the leaderboard, choose both sides, declare a winner (or a draw). The bot handles expected-score math and updates every participant's rating instantly.

Verification & approval flow

Submitted matches land in a log channel for moderator review before ratings move. Auto-approve after a configurable delay (default 24h for ELO).

Built-in matchmaking queue

Players click the queue button to join a pool of opponents. An expanding-window algorithm pairs players of similar ELO — no manual opponent-hunting required.

Free-for-all matches

Not every game has two sides. An ELO board can run free-for-alls of 3 to 8 players instead: report the finishing order (or an all-draw) and everyone is rated against everyone else, with the K-factor split across the lobby so one game is worth about one match of movement. Exactly zero-sum, and the queue can form full lobbies with a shared voice room.

Optional ELO decay

Inactive players gradually drop rating on a daily, weekly, or monthly schedule — keeping your ladder reflective of current skill.

Automated tier roles

Assign Discord roles automatically based on rating bands (Bronze, Silver, Gold, Diamond, …). Players see their tier update the moment their rating crosses a threshold.

Live web leaderboard

Every ELO board gets a shareable web leaderboard with full match history, win/draw/loss stats, and last-played timestamps — so players can follow the ladder outside Discord too.

Want the full mechanics and best-practice tips? Read the complete ELO guide →

Matchmaking · Beta

Built-in matchmaking, from 1v1 to 8v8

Most ELO Discord bots stop at reporting matches. Scoreboards also makes them — so players don't have to hunt for evenly-rated opponents in chat, or organise a full team by hand.

  1. 01

    Join the queue

    Players click the queue button on the leaderboard to enter the matchmaking pool.

  2. 02

    Expanding window

    The system looks for players within a narrow ELO band first, then widens the window until it has enough for a match — two players on a 1v1 board, six on a 3v3.

  3. 03

    Balanced teams

    On a team board the lobby is split so the two sides' average ratings land as close together as possible, keeping the strongest and weakest players apart.

  4. 04

    Match thread

    Everyone in the match gets a dedicated Discord thread with community voting buttons built in.

  5. 05

    Result + rating update

    The community confirms the winner via the voting buttons, and every participant's rating updates automatically.

Skill-matched lobbies

The expanding-window search takes the closest-rated players available, so every match carries meaningful ELO weight.

Configurable timeout

Queue entries expire automatically after a set duration (5 minutes by default, customizable per leaderboard) so nobody sits in an endless queue.

A voice channel per team

Optionally spin up voice automatically — one shared room for a 1v1, or a private room per side on a team board so mates can talk tactics without the opposition listening. Cleaned up when the match ends.

Votes both teams agree on

A result is locked in once a majority of each team picks it, so one side can never declare its own win. Anything else raises a dispute for a validator to settle.

Fixed teams

Turn on fixed teams and persistent named squads sign up once, get their own team ELO on the board, and queue as a unit — any member's click queues the whole roster, and up to two reserves can tag along, with the first to ready up making the lineup.

The matchmaking queue is currently in beta. Toggle it per-leaderboard in your dashboard settings.

In Discord

Every match gets its own card

When the queue makes a match, the bot posts who is playing and what is at stake, so the match thread starts with context instead of questions.

Discord match card for a 1v1 ELO match: both players, their ratings, their last five results and a 3–1–2 head-to-head record
1v1: both ratings, recent form and the head-to-head record.
Discord team match card for a 2v2: two balanced teams with their average ratings, and the rating the winners gain and the losers drop
Teams: balanced sides, their averages, and what the result is worth.

Use cases

When to use an ELO leaderboard

Competitive 1v1 games

Fighting games, chess, card games, racing duels — any head-to-head format where you want ranks to actually reflect skill.

Team games, 2v2 to 8v8

Set the leaderboard to a fixed team size and every player still gets their own rating. Expected scores come from each team's average, so beating a stronger squad pays the whole team.

Ranked ladders

Persistent seasons that evolve as players compete. Pair with decay if you want ratings to track current form.

Tournament seeding

Use live ELO ratings to seed brackets so the strongest players don't eliminate each other in round one.

Fair matchmaking

Pair players of similar rating for more competitive, enjoyable matches — the ratings do the matchmaking work for you.

Economy · Beta

Make every result pay

Switch on the economy and every approved result on this board pays your members a currency you name. They spend it in your server's shop on roles, board emojis and name colours, so there is always a reason to play one more.

See how the economy works

Quick start

Set up an ELO leaderboard in two minutes

  1. 1

    Add Scoreboards to your server

    Invite the bot to your Discord server. It takes a few seconds.

    Add to Discord
  2. 2

    Run /leaderboard create

    Name the board and pick ELO. Press More options afterwards for team matches up to 8v8, a free-for-all or fixed teams.

  3. 3

    Play the first match

    Press Submit result on the leaderboard, choose both sides and the winner, or press Queue and let the bot find an opponent.

  4. 4

    Fine-tune it in the dashboard

    Auto-approval, roles for the top ranks, seasons, colours and a web page for every board are all in the dashboard.

    Open the dashboard

FAQ

ELO leaderboard FAQ

What K-factor should I use?

Keep the default of 32 if you are unsure. Lower it to 16 for a long-running ladder that should move slowly, or raise it to 40 or more for a short event where ranks should shift quickly. You can change it in the dashboard at any time.

What rating do new players start at?

1200 by default. You can set any starting rating in the dashboard, and every new player on that board starts there.

Does ELO work for team games?

Yes. Set a team size from 2v2 to 8v8 and every player keeps their own rating. The expected result comes from each team's average, so beating a stronger team pays every player on yours. Fixed teams can also have one rating per team.

Can a match end in a draw?

Yes. A draw moves ratings too: the higher-rated player loses a little and the lower-rated one gains the same amount.

What if a result was reported wrong?

Cancel or edit it and the ratings it moved are put back. With a log channel, results can also wait for a moderator before they count.

Do inactive players keep their rating?

Unless you turn on decay. Then players who stop playing lose rating on a daily, weekly or monthly schedule, so the top of the ladder reflects who is playing now.

Climb the ladder. Defend your rating.

A live ELO leaderboard turns every match into something to fight for — and gives the whole community a shared scoreboard to rally around.

Add to Discord