Documentation

Everything you need to set up and run ranked custom games with Elobby.

What is Elobby?

Elobby is a Discord bot for running ranked custom games. It hosts lobbies, auto-balances teams using a Glicko-2 skill rating, moves players into team voice channels, and tracks a full ranked ladder — leaderboard, profiles, and match history. This website is the admin dashboard for configuring it.

Getting started

1. Add the bot. Use the Add to Discord button and invite Elobby to your server (you need Manage Server permission).

2. Configure it. Log in to the dashboard, pick your server, and set the category, channel names, host roles, and tiers. Changes apply to the bot live.

3. Play. Run /custom start in Discord to open your first lobby.

Configuring from the dashboard

On a server's config page you can set:

  • Host roles — roles allowed to run and manage customs (besides Manage Server admins).
  • Category & channel names — where the bot creates voice channels, and what the Lobby / Team 1 / Team 2 channels are called.
  • Rank tiers— add as many tiers as you like, each with a minimum rating, a name, and an emoji or a custom image (square, ≤128×128 px, ≤256 KB).

Running a custom

/custom start posts a lobby card. Players use the buttons to Join / Leave, and the host can Lock the lobby and Make Teams — either Fair (balanced by rating) or Shuffle (random). Report the result to update the ladder, then /custom finish cleans up the voice channels.

Ranks & tiers

Every player has a hidden rating (Glicko-2) that goes up on wins and down on losses, adjusted for how strong the opponents were. Their rating maps to a tier (the named ranks you design in the dashboard), shown on the leaderboard, profiles, and match result cards.

Command reference

/custom startOpen a new lobby. Players join with the buttons; the bot auto-balances teams.
/custom finishEnd the session and delete the Lobby / Team voice channels the bot created.
/custom helpShow the one-time guide explaining how the lobby buttons work.
/leaderboardTop players on this server's ranked ladder.
/profile [user]A player's rank, rating, record, streak and MVPs.
/historyThe most recent finished custom results.

Still stuck?

Open a ticket and the Elobby team will help.

Get support