1. Set up the EloLink bot on your Discord server

EloLink ships with sensible defaults - installation is a click, configuration is one slash command and a visual panel. No JSON, no copy-pasting tokens. Two minutes from invite to working roles.

Step 1 - Invite the bot

Click Add to Discord in the navbar, or use the direct invite link from your dashboard. Discord asks you to pick a server and confirm the requested permissions:

• Manage Roles - required to create the 10 level roles and assign them.
• Manage Nicknames - optional, only used if you turn on nickname sync.
• Manage Channels - used when EloLink auto-creates a leaderboard or LFG voice category.
• Send Messages, Embed Links - used to post the verify embed and log entries.

If you decline a permission, that feature simply won’t activate - the rest of the bot keeps working.

Step 2 - Run /setup

In your server, type /setup. The command is admin-only (Server Owner or anyone with the Administrator permission) and opens a visual panel as an ephemeral message - only you see it.

The panel has five buttons. Click each in order:

1. Create roles - generates ten Discord roles named FACEIT Level 1 through FACEIT Level 10, plus a Faceit Connected! verification role. Roles are color-coded by level. You can rename them in Discord - the bot tracks roles by ID, not by name.
2. Link button channel - pick (or create) a text channel. EloLink posts a verification embed with the Link FACEIT button there and locks the channel for regular users (read-only).
3. Log channel - optional. Receives compact log entries when users link, unlink or change FACEIT level.
4. Leaderboard - optional. Auto-creates a #faceit-top-N channel with the top-N players by ELO. Self-updates every 10 minutes.
5. LFG voice - optional. Three-step setup for Join-to-Create voice channels with FACEIT-level tagging.

You can re-open the panel at any time with /settings to change anything.

Step 3 - Tell your members

After /setup finishes you have a verify channel with a single embed and a Link FACEIT button. Direct your members to that channel. From their side it’s one click → FACEIT login → role appears.

For full details on what happens when a player links - see the next page: Link FACEIT.

Troubleshooting

“Manage Roles permission missing”

The bot needs Manage Roles to create the ten level roles. Re-invite the bot or grant the permission manually in Server Settings → Roles → EloLink.

“Bot can’t reach role positions”

Discord lets a bot only manage roles below its own. Move the EloLink role above the level roles in Server Settings → Roles.

Embed didn’t post in the verify channel

EloLink needs Send Messages and Embed Links in that channel specifically. Channel-level permissions override server-level ones - check the channel’s permission overwrites.

What’s next

Once setup is complete:

• Watch the first members link and roles appear automatically.
• Tune things later with /settings.
• Open the dashboard for an at-a-glance view of every server you manage.