# Leaderboard commands

#### :crown: **Admin only commands**

#### :bulb: **General command for everyone**

<mark style="color:red;">**Required**</mark> parameters will be in \[Square brackets]

<mark style="color:green;">**Optional**</mark> parameters will be in (Curly brackets)

***

## :crown: **Create a dynamic leaderboard**:

```
/create_leaderboard [channel] [game]
```

Generates a live, updating leaderboard based on current player standings. This leaderboard is limited to 20 players and defaults to ranking by <mark style="color:green;">**most wins**</mark>. If you’ve already set up a leaderboard using [`/setup`](https://docs.inhousequeue.xyz/docs/quick-start), this command will override the existing one.

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2Fgit-blob-e9cf8cadf7b0f91141877d98ed455e1891f6573e%2Ftop_ten_wins.png?alt=media" alt=""><figcaption></figcaption></figure></div>

***

## :bulb: View leaderboards:

```
/leaderboard view [game] (type) (queue_channel)
```

View the server leaderboard based on the available options. Omit <mark style="color:green;">**type**</mark> to default to Wins.

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2Fgit-blob-6775603ebfde97c5a2f513bd96653a7347ae33a7%2Fleaderboard_view.png?alt=media" alt=""><figcaption></figcaption></figure></div>

If you have set up a [unique leaderboard](https://docs.inhousequeue.xyz/docs/quick-start/leaderboards-explained#creating-a-unique-leaderboard), you must view the leaderboard by specifying the `(queue_channel)` by selecting it in the options.

### Download Leaderboard as CSV

* You can download the current leaderboard **as you see it** as a CSV file. Simply click the button and give it a few moments.

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2Fgit-blob-26797d2cb694ccac125736d05d56987f4720dc81%2Fleaderboard_csv.png?alt=media" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Only \*\*Administrators and members with **Manage Channels** permissions can download CSVs.
{% endhint %}

***

## :bulb: View Player MMR and Winrate stats:

```
/rank view [game] (member) (queue_channel)
```

View your statistics, or select a player to view theirs.

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2Fgit-blob-d373ab1e729beef11b6c7f906f9315532aad37e5%2Frank_view.png?alt=media" alt=""><figcaption></figcaption></figure></div>

If you have set up a [unique leaderboard](https://docs.inhousequeue.xyz/docs/quick-start/leaderboards-explained#creating-a-unique-leaderboard), you <mark style="color:green;">**must**</mark> view the leaderboard by specifying the `(queue_channel)` by selecting it in the options.

***

## :bulb: View a player's Match History

```
/match_history [game] [member]
```

View a players match history. This is limited to the last 30 matches.

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2F69Rz0umwzlGMdtxKfpex%2Fmatch_history.png?alt=media&#x26;token=28942cfa-d695-4d20-a6c3-46b20d806d7c" alt=""><figcaption></figcaption></figure></div>

***

## :bulb: View a player's Stats

```
/stats [game] (member)
```

A detailed, multi-page breakdown of a player's performance. Use `(member)` to view someone else's stats — admins can look up any player and still navigate the embed themselves.

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2Fgit-blob-d09c4d5d18b1488f1bf90d42da1adb7528e284d0%2Fstats_image_new1.png?alt=media" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2Fgit-blob-4e1feae723628c7326318db7f44361da602a9985%2Fstats_image_new2.png?alt=media" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2Fgit-blob-2fb9ac7c5d1e42dfd6e28bc712243d358a07924f%2Fstats_image_new3.png?alt=media" alt=""><figcaption></figcaption></figure></div>

The stats command has **6 pages**, navigated with the Previous / Next buttons.

**Page 1 — Overview:** A snapshot of the player's overall standing: IGN, Rank, MMR, Peak MMR, W/L, Lifetime total games, best/worst streaks, Current streak, MVPs, and First match date.

**Page 2 — Performance (Win Rate):** A line chart showing daily win rate (%) over the last 7 days. Only days the player actually played are plotted.

**Page 3 — Performance (MMR):** A line chart showing MMR progression over the last 7 days, based on the post-game MMR recorded after each match.

**Page 4 — Rivalries:** Arch Nemesis (opponent lost to the most, with H2H record), Best Synergy (teammate won with the most), and Most Duo'd With.

**Page 5 — Role Stats:** The player's most frequently played roles.

**Page 6 — Performance Insights:** Recent Form (last 10 games as 🟢/🔴), Side Win Rates (🔵 Blue / 🔴 Red), Best & Worst Day of the week, and Underdog Wins (wins where your team had lower average MMR).

***

## :crown: Set an All-Time leaderboard

```
/all_time_leaderboard [channel] [game]
```

Displays the all-time top 10 players in your server based on <mark style="color:green;">**total wins**</mark>. This leaderboard provides a historical view of your most victorious players and does <mark style="color:green;">**NOT**</mark> reset, even when other leaderboards are reset.

This leaderboard updates automatically after each match and focuses exclusively on <mark style="color:green;">**total wins**</mark>. MMR is not used for this leaderboard because it is dynamic and constantly changing, making it unsuitable for long-term ranking.

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2FYneZ4liXLTrG1mA0e3XD%2Flifetime_leaderboard.png?alt=media&#x26;token=30ca08e4-41ec-4d7e-bda2-750ad94e2eab" alt=""><figcaption></figcaption></figure></div>

***

## :bulb: View the Leaderboard per role

```
/leaderboard role [game] [based_on] (time)
```

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2Fgit-blob-74fd36a774e0f2330404454597a2dc6553ac4ac9%2Fleaderboard_role.png?alt=media" alt=""><figcaption></figcaption></figure></div>

Ever wanted to see who the best Support is? Now you can! This command displays the leaderboard for a specific role within a chosen time frame. The leaderboard can be ranked by either MMR or total wins.

If you omit the **time** parameter, it will default to the last 30 days.

This leaderboard shows how many wins or how much MMR has been gained during the selected time period. Keep in mind that this may not align with a player's current total wins or MMR, as it is limited to the specified time frame.

{% hint style="warning" %}
This command has a long server cooldown. Around 1 minute.
{% endhint %}

***

## Change the order of leaderboard :crown:

```
/leaderboard_order [preference]
```

Use this command to determine how your leaderboard will be organized.

### Currently Available Options:

* **MMR**: The player with the highest MMR will be in the No. 1 spot, and so on.
* **WINS**: The player with the most wins will be in the No. 1 spot, and so on.

***

### **Suggestions**

In most cases, we recommend sticking to the default behavior and using **WINS**. This ensures that the player who plays and wins the most games will top the leaderboard.

While using **MMR** is also a great option, keep in mind that InHouseQueue's MMR system requires time to adjust accurately to players' performance. The MMR value may not be perfect immediately as it takes a few games to stabilize. To avoid confusion early on, we suggest starting with **WINS** and transitioning to **MMR** later.

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2Fgit-blob-e9cf8cadf7b0f91141877d98ed455e1891f6573e%2Ftop_ten_wins.png?alt=media" alt=""><figcaption></figcaption></figure></div>

***

## :crown: Remove a user from the leaderboards

```
/purge user
```

Sometimes a user may leave the server but remain in the leaderboards as "Unknown Member." If you know the user's ID, you can completely remove them from the leaderboards to keep them up to date.

This is how you can find a [Users ID](https://support.discord.com/hc/en-us/articles/206346498-Where-can-I-find-my-User-Server-Message-ID#h_01HRSTXPS5H5D7JBY2QKKPVKNA)

***

## :crown: Clean up multiple inactive members

```
/purge inactives
```

If you have [reset leaderboards](https://docs.inhousequeue.xyz/docs/reset-commands#crown-reset-full-leaderboard), some players may remain on the leaderboards with 0 wins and 0 losses. This can clutter the leaderboards with inactive players.

You can use this command to remove all inactive players. Please note that this will **only** remove players with 0 wins and 0 losses.