Getting started with Lunar
Lunar has two halves that share the same data: a Discord bot with slash commands, and a web dashboard. This guide walks through setting up both.
1. Log in to the dashboard
Open the dashboard and choose Log in with Discord. Discord asks you to approve two permissions:
- identify lets Lunar see your Discord username, display name and avatar.
- guilds lets Lunar see the list of servers you're in, so it can show the ones that use Lunar.
Lunar can't read your messages, see your email address or post as you. Your login lasts 30 days, and you can log out at any time from the sidebar.
2. Link your game account
In any server that has the Lunar bot, run /link with your in-game name or numeric UID. Names can differ only by capital letters (two different players can be called "tylen" and "Tylen"), so the UID is the safest choice.
Linking proves the account is yours. The quickest way is to link Discord inside the game first: press Esc, open Community → Discord and choose Go. When the Discord account bound in game matches yours, /link links you straight away.
If you haven't linked Discord in game (or you play on a console that uses an invite code), the bot names a hero and asks you to set it as your profile showcase hero, then press Verify. Once it sees the change, the link is saved. You only verify once, and you can change your showcase back straight away.
After linking, player commands default to your own account, so /session or /heropool work without typing your name. /unlink removes the link.
3. Add Lunar to your server (optional)
Server admins can add the bot to their community. Then:
/trackerchooses which players the server's match feed follows. Members can add themselves after linking./announcements channel:#channelpicks where release notes are posted. Each server gets each release once.- The Server view of the dashboard shows the tracked players, leaderboards and recent matches.
4. Find your way around the dashboard
| View | What it shows |
|---|---|
| Overview | Your rank, recent form, most-played heroes and latest matches. |
| Match | A single match: scoreboard, bans, and the analysis findings for each player or team. |
| Server | Your server's tracked players, leaderboards and match feed. |
| Scrims | Your scrim teams, invites, the scrim board and the rating ladder. |
| Session | Your current or most recent play session and its tilt check. |
5. Useful commands to try first
/career: your top heroes, most-played heroes and current rank./session: a recap of your latest play session./progress timeframe:Week: a chart of rank points gained and lost over the last seven days./improvement hero:<hero>: your newest games on a hero against the games before them./help: every command with examples. Only you can see the reply.
Free, Pro and Guild Pro
Every part of Lunar is free to use. Ads keep the servers running. Lunar Pro removes ads for you on the dashboard. Guild Pro applies to a whole server and raises limits such as the number of tracked players and weekly scrim posts. Payments are handled by Whop. /tier shows your current plan and limits.