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) — you are already filled in as player 1. The bot handles the expected-score maths and updates every participant's rating as soon as the match counts.

The opponent confirms

The opponent is pinged in a private match thread to Confirm or Disagree. Nobody answers? The match counts on its own after 3 hours. A disagreement goes to your admins, who have 48 hours to decide.

Built-in matchmaking queue

Players click the queue button to join a pool of opponents. An expanding-window algorithm pairs players of similar ELO, the button shows how many are waiting, and members can ask to be pinged when someone queues.

Challenge and rematch

Want a specific opponent? Press Challenge and pick a player: an accepted challenge becomes a match thread, just like a queue match. When a 1v1 is settled, its thread offers a Rematch button.

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.

Automatic rank roles

A new ELO board creates Bronze, Silver, Gold, Platinum and Diamond roles at its first match and moves players between them as their rating changes, telling each player by DM when they move up. Prefer your own bands? Edit them like any tier roles.

A result line after every match

When a match counts, the bot posts one line in the match thread: who won, the rating change and the new rank, such as “now #3 (↑2)”. Nobody is pinged.

Tournaments that count

Run a knockout or group tournament in the server, seeded from the board's ratings, and let its matches count on the ELO leaderboard.

Live web leaderboard

Every ELO board gets a shareable web leaderboard with full match history, win/draw/loss stats, rank history and a stats page per player — 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

    Once everyone clicks Ready, the match gets a dedicated Discord thread with voting buttons built in.

  5. 05

    Result + rating update

    The players vote on the winner and every participant's rating updates automatically. After 3 hours the match is settled from the votes cast, and nobody can queue again before voting.

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 an admin or 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

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 — the opponent confirms it — 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

Is there a Discord ELO bot?

Yes. Scoreboards is a Discord ELO bot: it keeps an ELO leaderboard in your server, with a matchmaking queue, opponent confirmation, challenges, team and free-for-all matches, rank roles and a web page for every board.

How do I add ELO rankings to my Discord server?

Add Scoreboards to your server, run /leaderboard create and pick ELO. The leaderboard is posted in the channel straight away. Players press Submit result to report a match, or Queue to find an opponent, and ratings move from the first result.

Can players challenge each other?

Yes, on a 1v1 ELO or League board with the queue on. Press Challenge and pick a player: they get Accept and Decline by DM for 30 minutes, and an accepted challenge becomes a match thread like a queue match. After a 1v1, Rematch in the match thread sends the same challenge again.

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?

The opponent presses Disagree and an admin decides; if nobody does within 48 hours, the result doesn't count. A result that already counted can be cancelled or edited, and the ratings it moved are put back.

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