FAQ
Everything you wanted to ask.
Quick answers on linking, roles, multi-server sync, privacy and the more obscure corners of the bot. If you don't find what you need here — the support server is one click away.
Pricing and trust
Yes — all functionality is free. No feature gates, no usage caps, no paid commands. Optional cosmetic add-ons (custom display styles for embeds, leaderboards, panels) may be paid in the future. The donate link in the dashboard footer is voluntary and unlocks nothing.
Only cosmetic / display-layer extras: custom embed themes, leaderboard skins, animated panels, and similar visual customization. Every functional capability — linking, role assignment, level updates, leaderboards, LFG voice, /stats, /update, the dashboard — stays free forever.
EloLink uses the official FACEIT OAuth flow (no scraping) and the official Discord API. We only ask for the permissions strictly required to assign roles. The codebase is small, self-hosted, and the bot has been running across many CS2 communities. The support server is public — ask anyone using it.
On a private VPS we operate. The bot is a Node.js process; the dashboard is a Next.js app on the same host. Data lives in a single SQLite file. We collect first-party operational analytics (usage counts, errors, performance) for both the bot and the site — no third-party trackers, no ad networks. Details on the Privacy page.
Linking and roles
The player clicks Link FACEIT and is sent through FACEIT’s official OAuth flow. After consent, FACEIT returns a token to EloLink which fetches the public profile (player ID, nickname, level, ELO, country). The link is stored by Discord user ID.
Yes. EloLink runs an hourly refresh of every linked player. Players can also force an instant refresh with /update. New servers detect existing links on join.
Yes — the "Faceit Connected!" role. It is created during setup and assigned to anyone with a linked FACEIT account. Rename, disable or remove it from the dashboard.
No. EloLink creates roles with sensible defaults ("FACEIT Level 1" etc.) but tracks them by ID. Rename them in Discord to whatever you want — country flag emojis, regional names, anything.
Run /settings → Create roles. EloLink will recreate any missing FACEIT level roles. Existing roles are not touched.
Multi-server
No. You link once. Every Discord server with EloLink installed will assign your level role automatically — including servers you join later.
Yes. Each server maps its own custom Discord role to each FACEIT level. The mapping is per-guild — your role IDs are not shared.
It still works — EloLink tracks by Discord role ID, not by name. Names can collide harmlessly.
Privacy and data
Discord user ID; FACEIT player ID, nickname, current level, ELO, country; an encrypted Discord OAuth token for Linked Roles metadata; last 10 CS2 match stats (rolling cache). Plus aggregated usage/analytics events (anonymized counts of command runs, page views, errors). No emails, no payment data, no FACEIT password, no third-party ad trackers.
Yes. Run /unlink in any server or DM. The bot deletes your link record and removes your FACEIT roles everywhere. To re-link, run /link.
No. EloLink only reads public profile data and the last 10 matches via the public FACEIT API — exactly what anyone can see on faceit.com.
Features
Yes. Optional, configurable (top-5/10/20/50). Auto-created channel that refreshes every 10 minutes with rank-change arrows. See the leaderboard guide.
Yes. Join-to-Create rooms with FACEIT-level tags, owner controls and auto-cleanup. See the voice-LFG guide.
Linking and roles work everywhere because they use the public FACEIT API. Some hub-specific automations (private match polling, automatic club voice creation) are on the roadmap.
Yes, via /stats. Shows the last 10 matches (W/L, score, K/D, HS%, ELO change) for any FACEIT nickname or any linked Discord user.
Troubleshooting
Two common causes: (1) the EloLink bot role is below the FACEIT level roles in your Server Settings → Roles list — move EloLink above them; (2) the player has Discord-side restrictions (account muted, server suspended). Re-run /update on the user.
The OAuth state token is valid for 10 minutes. Press the Link FACEIT button again — a new state is generated each time.
Same FACEIT player cannot be linked to two Discord accounts. Run /unlink on the other Discord account first (or contact us if you’ve lost access to it).
It refreshes every 10 minutes. To force-refresh, /settings → Leaderboard → Refresh now.
Support
Join the support server (link below) or email [email protected]. We read every message.
Same channels. We keep a public roadmap in the support server.
Please email [email protected] with details. We respond within 24h.