> For the complete documentation index, see [llms.txt](https://docs.rivalryze.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rivalryze.com/for-guild-admins/bot-commands-reference.md). # Bot Commands Reference The RivalRyze bot answers **slash commands**. Type `/` in a server that has the bot, or in a direct message with the bot, and pick a command from Discord's list. ## Quick reference | Command | What it does | Who can use it | Reply | | -------------------------- | --------------------------------------------------------------------- | -------------------------------------------------------------- | -------- | | `/help` | Lists every available command. | Anyone | Only you | | `/invite` | Gives you the link to add the bot to a server. | Anyone | Only you | | `/me` | Shows your own RivalRyze profile card. | Anyone with a RivalRyze account | Channel | | `/profile user` | Shows another member's RivalRyze profile card. | Anyone | Channel | | `/balance` | Shows your Gem balance. | Anyone with a RivalRyze account | Only you | | `/gem-leaderboard` | Shows the players holding the most Gems. | Anyone | Channel | | `/leaderboard [guild]` | Shows the RivalRyze leaderboards, global or for one guild. | Anyone | Channel | | `/game game` | Shows a game's card. | Anyone | Channel | | `/game-achievements game` | Lists a game's achievements, page by page. | Anyone | Channel | | `/game-stats game` | Shows your stats in one game. | Anyone with a RivalRyze account | Channel | | `/completion game` | Generates your completion card for a game you completed. | Anyone with a RivalRyze account | Channel | | `/dota-profiles [user]` | Shows a Dota 2 profile. | Anyone | Channel | | `/guild guild` | Shows a RivalRyze guild's info card. | Anyone | Channel | | `/set-active-guild` | Picks which of your guilds is your active guild. | Anyone with a RivalRyze account | Only you | | `/guild-stats` | Posts your guild's community stats card. | Depends on the guild's privacy setting | Channel | | `/guild-history [month]` | Posts your guild's Month in Review card. | Depends on the guild's privacy setting | Channel | | `/create-challenge [game]` | Links you to the website to create a Battle for this server. | Anyone | Only you | | `/setup` | Shows the setup guide for this server. | Anyone before the server is registered; owner and admins after | Only you | | `/guild-settings` | Shows and changes this guild's bot settings. | Guild owner and admins | Only you | | `/guild-permissions` | Checks the bot's access to this guild's channels and Contest threads. | Guild owner and admins | Only you | "Guild owner and admins" means the guild's **Owner** or **Admin** on RivalRyze, which is not the same as a Discord server role. See [Managing Members & Roles](/for-guild-admins/managing-members.md). {% hint style="info" %} Commands that look you up need a RivalRyze account with Discord connected. If the bot can't find one, it replies with a link to sign up. See [Connecting Discord](/connecting-gaming-platforms/discord.md). {% endhint %} ## Profile and Gems ### `/me` Shows your RivalRyze profile card. Buttons on the card switch between your overall stats and each platform or game you have connected (Steam, PlayStation, Battle.net, Dota 2, Teamfight Tactics, League of Legends, Valorant). **View Full Profile** opens your profile on the website. ### `/profile user` The same card as `/me`, for the member you tag. `user` is required. If that person has no RivalRyze account, the bot tells you privately. ### `/balance` Shows your current Gem balance. Only you see the reply. ### `/gem-leaderboard` Shows the **Gems Leaderboard**: players ranked by the Gems they hold, five per page, with buttons to page through the top 25. It covers all of RivalRyze, not only your server. ## Leaderboards ### `/leaderboard [guild]` Posts a leaderboard you browse with buttons and menus: * **Game:** **RivalRyze** (achievement boards), **LoL**, **TFT**, **Valorant** (greyed out while unavailable) and **Dota 2**. * **Metric:** on the RivalRyze board, **Points**, **Achievements**, **Completions** and **Earnings**. The game boards have their own metrics, for example **Rank** and **LP Δ** for League of Legends. * **Period:** **Daily**, **Weekly**, **Monthly** or **All Time**, plus a history menu to open a past day, week or month. * **Pages:** previous and next buttons. `guild` is optional. Start typing a guild name and pick it from the suggestions to see that guild's board. Leave it empty for the global board. See [Global Leaderboards](/points-and-leaderboards/global-leaderboards.md) and [Guild Leaderboards](/points-and-leaderboards/guild-leaderboards.md). ## Games `game` options autocomplete: start typing and pick a game from the suggestions. ### `/game game` Shows the game's card from the RivalRyze catalog. ### `/game-achievements game` Lists the game's achievements with their rarity, points and description, with buttons to page through the list. ### `/game-stats game` Shows your own stats in that game: playtime, achievements, progress and when you last played, per platform. ### `/completion game` Generates your shareable **completion card**, the same card the website makes. The suggestions come from your own library, and the card is only available for games you have completed. The card is posted in the channel. ### `/dota-profiles [user]` Shows a Dota 2 profile: rank, wins, losses and recent matches. With no `user`, it shows yours. The player needs a connected Steam account with a Dota 2 profile on RivalRyze. See [Connecting Steam](/connecting-gaming-platforms/steam.md). ## Guilds ### `/guild guild` Shows a guild's info card: owner, whether the bot is active, global and weekly guild ranking, members, total points, achievements and completions, and the connected channels. The card has a **Join Guild** button and a **Go to Guild Page** link. `guild` is required and autocompletes from guild names. ### `/set-active-guild` Shows your current active guild and a menu of the guilds you belong to. Pick one to make it your active guild. See [Finding and Joining a Guild](/guilds/finding-a-guild.md#your-active-guild). ### `/guild-stats` Posts the guild's all-time **community stats card** in the channel, with a **View Stats** link to the guild's Stats tab. ### `/guild-history [month]` Posts the guild's **Month in Review** card, with a **View History** link. `month` is optional and uses the `YYYY-MM` format, for example `2026-08`. Without it, you get the current month. See [Guild Month in Review](/guilds/month-in-review.md). `/guild-stats` and `/guild-history` follow the guild's **Who Can See Server & Member Activity** setting. When it is **Members only** or **Admins only**, people outside that group get a short refusal instead of the card. See [Guild Settings & Activity Feed](/for-guild-admins/guild-settings.md#privacy). ### `/create-challenge [game]` Battles are created on the website. This command replies with a **Create a Battle** button that opens the Contest creator, already set to this server and to the `game` if you picked one. See [Hosting Guild Contests](/for-guild-admins/hosting-guild-contests.md). ## Guild management ### `/setup` Shows the setup guide for the server, with buttons to the website, the setup video and the RivalRyze support Discord. * Before the server is registered on RivalRyze, anyone can run it. The guide has a **Create Your Guild** button. * After registration, only the guild's owner and admins can run it. The guide lists the connected channels and has an **Open Guild Settings** button. The bot also sends this guide by direct message to the Discord server owner when it joins a server. See [Initial Setup](/for-guild-admins/initial-setup.md). ### `/guild-settings` Replies with a link to the full settings page on the website, then the bot's settings as switches you can flip in Discord: * **Achievement Unlock Notifications**, with a rarity menu: **2% Legendary**, **10% Mythic**, **25% Rare**, **50% Uncommon**, **100% All** * **Game Purchased Notifications**, **Game Completed Notifications**, **NSFW Game Notifications** * **Member Joined Notifications**, **Account Connected Notifications** * **Dota 2 Activity Notifications**, **League of Legends Activity Notifications**, **Teamfight Tactics Activity Notifications**, **Valorant Activity Notifications** * **Allow User Battles**, **Receive Featured Battles** * **Admin Role Access** and **Activity Feed Roles** menus Only the guild owner and admins can run it or change anything. Some settings exist only on the website, such as the minimum game difficulty and the privacy settings. See [Guild Settings & Activity Feed](/for-guild-admins/guild-settings.md). ### `/guild-permissions` Checks the bot's access to the guild's Contests forum, info channel and Activity Feed channel, and to the Contest threads it has created, then lists what's missing and how to fix it. See [Bot Permissions Checklist](/for-guild-admins/bot-permissions.md). ## Using commands in direct messages Every command also works in a direct message with the bot. Commands that act on a guild (`/setup`, `/guild-settings`, `/guild-permissions`, `/guild-stats`, `/guild-history`) work out which one you mean: * With one candidate guild, the command runs for it. * With several, the bot asks **Which server do you want to run this for?** and shows a menu, 25 servers per page. For `/setup`, `/guild-settings` and `/guild-permissions`, the candidates are the guilds you own or administrate. For `/guild-stats` and `/guild-history`, they are all the guilds you belong to. ## Buttons on bot posts | Button | Where | What it does | | --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | **Join Guild** | Guild info cards, including the one in your `#info` channel | Joins that guild on RivalRyze. You must be in its Discord server. | | **Join Battle**, **Request Access**, **Boost Battle**, **View Leaderboard**, **Update Stats** | Contest posts in the Contests forum | Join, ask the host for an invite, donate Gems, open the leaderboard or refresh the Contest's stats. | | **Tip 50 Gems** and other amounts | Contest winner announcements, game completion posts, Dota 2 match posts | Sends that many of your Gems to the player. Tips start at 50 Gems, and you can't tip yourself. | | **View Commands** | The bot's message in `#info` | Lists the bot's commands. | ## Command not working? * **The command isn't in Discord's list:** check that the bot is in the server, and that the command isn't hidden under **Server Settings → Integrations** (a Discord setting). * **"We could not find a RivalRyze account":** sign up on [rivalryze.com](https://rivalryze.com) and connect Discord. * **"Only guild owners or admins can access this command":** your membership in this guild isn't Owner or Admin. See [Managing Members & Roles](/for-guild-admins/managing-members.md). * **"This server is not linked to RivalRyze yet":** the server hasn't been registered. See [Initial Setup](/for-guild-admins/initial-setup.md). * **The bot doesn't post where it should:** run `/guild-permissions` and follow the [Bot Permissions Checklist](/for-guild-admins/bot-permissions.md). Still stuck? [Contact support](/help-and-faq/contact-support.md).