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.

/setup is a step-by-step wizard. Every step has Back and Skip, so nothing is forced and a misclick is recoverable:

1. Language - the default is English. Pick another one, or just press Continue.
2. Roles - EloLink checks which of the ten FACEIT Level 1-FACEIT Level 10 roles and the Faceit Connected! role actually exist, and offers to create whatever is missing. If this server had roles before and they are gone now, it says so. Roles it creates are handed straight back to everyone already linked.
3. Link button channel - pick a text channel. EloLink posts the verification embed there and locks it read-only for regular members.
4. Log channel - optional. Compact entries when members link, unlink or change level.
5. LFG voice - optional. Category, trigger voice channel and status text channel. Any of the three can be created on the spot if nothing existing fits.
6. Leaderboard - optional. Channel plus top size. Self-updates every 10 minutes.

Roles are tracked by ID, not by name - rename them in Discord freely. Everything set here can be changed later with /settings.

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.