# Server 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: Server logs

```
/server logs [channel]
```

Designate a channel for all <mark style="color:red;">InHouseQueue</mark> logs. Important events will be logged here to give server owners and moderators a clear overview of activities on the server. For security reasons, we recommend making this channel private and accessible only to trusted members.

An admin log channel is automatically created during [`/setup`](/docs/quick-start.md).

Please note that not every action is logged — we’ve carefully selected actions we think are most useful. If you feel something important is missing, let us know in the support channel!

Here is the full list of actions/commands that will appear in your Log channel:

* When a queue is started
* When the server's language is changed
* When an admin forces a winner for a match
* When an admin changes the winner for a match
* When an admin voids/cancels a match
* When an admin resets all Wins, Losses, and MVPs on the leaderboard
* When an admin resets a queue and removes all members from it
* When an admin resets a member's Wins, Losses, and MVPs
* When an admin resets the MMR for everyone
* When an admin resets the MMR for a specific member
* When an admin adds a Win for a member
* When an admin removes a Win for a member
* When an admin removes a Loss for a member
* When an admin removes a user from all queues
* When an admin adds MMR to a player
* When an admin removes MMR from a player
* When an admin updates a player's IGN
* When an admin force starts a game
* When an admin subs out a player for another player in a game
* When a player sets or updates their IGN
* When a game is abandoned by starting an abandon vote
* When a game has ended and a team wins
* When a member starts spectating a game
* When players are in a duo for a game
* When a captain select game mode starts
* When a match starts
* When a queue times out because not all players are ready. Includes a list of users who did not ready
* When a user readies up for a game
* When a user gets a decay message warning
* When a user's MMR is decayed due to inactivity
* When a user clicks 'Not Ready' during ready up phase
* When an admin adds loss reduction to a match

{% hint style="info" %}
When selecting an existing channel, make sure <mark style="color:red;">InHouseQueue</mark> has access to it!
{% endhint %}

<div align="left"><figure><img src="/files/aVRYwRFEfmmssCW4k6Iy" alt="" width="404"><figcaption></figcaption></figure></div>

***

## :crown: View server Settings

```
/server settings
```

Get a complete overview of every setting configured on your server. The command opens an **ephemeral** (only visible to you) dropdown menu with four categories:

### Categories

**1. Global Toggles** Shows which server-wide toggles are enabled or disabled, including:

* MMR Enabled, Ranked Mode, Casual Mode, Roster Mode
* Duo Queue, Display MMR, Fill Mode, Multi-Queue
* IGN Required, Flat MMR, Challenges, Test Mode

**2. Feature Preferences** Displays the on/off state of every feature you can control with [`/defaults`](#crown-turn-features-on-and-off):

* MVP Voting, OP.GG Links, Draft Link, Voice Channels
* Lobby Visibility, Queue Role, Match Info, Spectators Can Speak
* DM Ready Up, Delete Queue, Nickname → IGN, Allow Spectators, Not Ready Button

**3. Queue Configuration** Lists every queue channel on the server with its key details:

* Game & Region
* Game Mode (Ranked, Casual, Rosters, Captain)
* Leaderboard type (Global or Unique)
* MMR status, Locked to Mode, and Labels

**4. Server Info** A summary of general server configuration:

* Language & Premium tier
* Admin Log Channel
* Leaderboard sort orders
* Queue Roles & Role Restrictions
* Notification opt-outs
* Custom permission grants (number of roles with granted commands)

Select a category from the dropdown to view its settings. You can switch between categories freely.

***

## :crown: View server Statistics

```
/server stats
```

View detailed server statistics across **5 paginated pages**. Use the navigation buttons to move between pages.

### Page 1 — Overview

A high-level snapshot of your server’s activity:

* Total matches played
* Date of first and last game
* Total unique players
* Games broken down by game type (e.g. League of Legends, Valorant)

### Page 2 — Activity & Trends

Temporal stats showing how active your server is:

* Games played this week and this month
* Average games per day
* Games by day of the week (visual bar chart)
* Active players in the last 7 days

### Page 3 — Top Performers

Leaderboards for the best players on the server:

* **Top 5 by Wins** — with win rate percentage
* **Top 5 by MVP Votes** — total votes received
* **Top 5 by MMR** — highest current MMR

### Page 4 — Game Analytics

Deeper analysis of game outcomes:

* **Blue vs Red win rates** — overall win rate for each team side
* **Most Active Players** — top 5 players by total games played

### Page 5 — Streaks & Records

Current streak records and server totals:

* **Top 5 Win Streaks** — players on the longest current win streaks
* **Top 5 Loss Streaks** — players on the longest current loss streaks
* **Server Totals** — total games, total players, and average games per player

***

## :crown: **Turn features on and off**

```
/defaults [feature] [condition]
```

Enable or disable various features of the <mark style="color:red;">InHouseQueue</mark> system. These are all default settings of <mark style="color:red;">InHouseQueue</mark>. If you do not want some of these features enabled, you can turn them off using this command.

Available <mark style="color:green;">features</mark>:

1. **mvp\_voting**
   1. Toggle the Direct message sent by <mark style="color:red;">InHouseQueue</mark> at the end of a game
2. **opgg**
   1. Toggle the creation of Multi team op.gg links [(League of legends only)](/docs/preset-games.md#league-of-legends)
3. **lol\_Draft**
   1. Toggle the creation of a LOL Draft link [(League of legends only)](/docs/preset-games.md#league-of-legends)
4. **create\_vc**
   1. Toggle the automatic creation of voice channels
5. **show\_lobby**
   1. Toggle Hiding the Lobby from the rest of the server or keeping it visible for the whole server.
6. **queue\_role**
   1. Toggle the requirement for a [queue role](/docs/commands/queue-commands.md#crown-set-a-discord-role-for-inhouses)
7. **match\_info**
   1. Toggle the embed that contains Match details and Win probability.
8. **mute\_spectators**
   1. Toggle Spectators being able to speak when they join the Team voice lobbies
9. **send\_ready\_up\_dm**
   1. Specify if <mark style="color:red;">InHouseQueue</mark> will DM players when a game is found
10. clean\_up\_queue
    1. Specify if to delete Queues when a game has ended automatically
11. set\_nickname\_to\_ign
    1. When a user runs `/ign` their Discord nickname is automatically updated to the IGN they've set.
12. allow\_spectators
    1. Toggle whether spectators are allowed. Spectators are muted members who can join Blue or Red team voice channel. A player of the game can [share their screen](https://support.discord.com/hc/en-us/articles/360040816151-Go-Live-and-Screen-Share) to allow them to watch along.
13. not\_ready\_button
    1. Toggle whether the `Not Ready!` button appears during ready up phase. This allows user to leave the queue early.

***

## :crown: **Check InHouseQueues permissions**

```
/check_permissions
```

Review <mark style="color:red;">InHouseQueue</mark>'s permissions within the server.

Use this to check what permissions <mark style="color:red;">InHouseQueue</mark> is missing.

### Global Permissions:

* These are permissions <mark style="color:red;">InHouseQueue</mark> has across your server. By default, when you use the correct invite link, <mark style="color:red;">InHouseQueue</mark> will join with all its default global permissions. However, in some cases, due to certain Discord server setups, this can be overwritten by complex permissions. Use this command to check if there's anything wrong.

### Channel / Category Permissions:

* These are permissions <mark style="color:red;">InHouseQueue</mark> requires within each text channel or category channel it [manages](/docs/quick-start.md#channels-and-categories-explained). <mark style="color:red;">InHouseQueue</mark> needs "Manage Channel" and "Send Messages" permissions for all text and category channels.

<div align="left"><figure><img src="/files/cOeY7iOK8oZpUZJwhugT" alt=""><figcaption><p>Missing permissions for some text channels</p></figcaption></figure></div>

<div align="left"><figure><img src="/files/nlbKVYa0tko7ryGStkJM" alt=""><figcaption><p>Everything working!</p></figcaption></figure></div>

This command should help you pinpoint any permission problems you're having

{% hint style="info" %}
If you're still having problems, please see our bot permissions [guide](/docs/quick-start/trouble-shooting-ihq.md).
{% endhint %}

***

## :crown: Grant Admin commands to Moderators / Helpers

```
/permissions grant

/permissions revoke
```

Permit your moderators or helpers to run Admin commands. This gives you fine-grained control and delegates permissions perfectly.

**Grant:** This will give a Discord role permissions to run a command.

**Revoke:** This will remove the permissions.

You can give every Admin related command to any amount of Discord roles.

### How it works

For this example we will assume I am an Admin of an InHouse Server and I want to grant my Moderators permissions for all [Queue commands](/docs/commands/queue-commands.md), and some [Game commands](/docs/commands/game-commands.md).

### Granting permissions to ALL commands in a Category

<div align="left"><figure><img src="/files/nFmFh3KwDJG6bVPe93H4" alt=""><figcaption></figcaption></figure></div>

1. Run the `/permissions grant` command. This opens up the <mark style="color:green;">**Grant Menu**</mark>.

<div align="left"><figure><img src="/files/SkRdQPzNySGP0Yb9SC78" alt=""><figcaption></figcaption></figure></div>

2. All commands for <mark style="color:red;">InHouseQueue</mark> are categorised. Please select a command category you would like to navigate. If you're unsure which command is in what category, you can find them all here: <https://docs.inhousequeue.xyz/docs/commands>.
3. Since we want Moderators to be able to run <mark style="color:green;">**ALL**</mark> [Queue commands](/docs/commands/queue-commands.md), we will select <mark style="color:green;">**Queue**</mark>.

<div align="left"><figure><img src="/files/t6SXehrMaFIPXlxbw0tz" alt=""><figcaption></figcaption></figure></div>

4. Once selected, this menu will show every single individual command within the selected category. Here, you can select <mark style="color:green;">**up to 5**</mark> individual commands at once. But for this example, we want them all. (If you need to select more than 5 commands, simply repeat this process after completing it once.)

<div align="left"><figure><img src="/files/jizEywMNV7KDaO6h1gm8" alt=""><figcaption></figcaption></figure></div>

5. Once you've selected the commands, you must click <mark style="color:green;">**outside**</mark> of the embed menu to confirm your selection.

<div align="left"><figure><img src="/files/z7YpNnkrz6cprRne5YaX" alt=""><figcaption></figcaption></figure></div>

6. On the next menu, you will be able to select <mark style="color:green;">up to 5</mark> Discord roles to grant permissions for these admin commands. (If you need to assign permissions to more than 5 roles, simply repeat this process after completing it once.)

<div align="left"><figure><img src="/files/tvuqB53OFP7A3GjB30fq" alt=""><figcaption></figcaption></figure></div>

7. You will get a list of commands enabled for the selected Discord roles.

<div align="left"><figure><img src="/files/QaDp3sS9CwJH7AygOBbp" alt=""><figcaption></figcaption></figure></div>

8. To confirm everything has worked, run `/permissions grant` once more and select the same command category. You'll now see that the Moderator Discord role is allowed to use every command within the <mark style="color:green;">**Queue**</mark> command category.

### Granting Permissions to some Commands in a Category

The process is exactly the same as granting permissions to all commands, but instead of selecting **ALL**, you will pick specific commands.

<div align="left"><figure><img src="/files/UoOtq8bXKQvutp7mJTxL" alt=""><figcaption></figcaption></figure></div>

1. As mentioned earlier, we only want our moderators to have permissions to <mark style="color:green;">**some**</mark> [Game commands](/docs/commands/game-commands.md). Select the Game command category.

<div align="left"><figure><img src="/files/6G7BtmwEuRPmpLFHaKr2" alt=""><figcaption></figcaption></figure></div>

2. Here is a list of all the commands within the Games category.

<div align="left"><figure><img src="/files/OoavSJHrdVmMEaJtNUSZ" alt=""><figcaption></figcaption></figure></div>

3. Select the commands you want to allow. You can select <mark style="color:green;">**up to 5 commands at once**</mark>. Click outside the menu to confirm your selection.

<div align="left"><figure><img src="/files/IrNItRUEPLIpjlFvR4Oe" alt=""><figcaption></figcaption></figure></div>

4. Before proceeding, you'll see a list of your selected commands. If you're happy, proceed with selecting the Discord roles you want to grant access to these commands. Otherwise, you can go back with the `Previous` button.

<div align="left"><figure><img src="/files/l94nH6o2PG4ZsTmxzzpw" alt=""><figcaption></figcaption></figure></div>

5. Select the Discord roles you want to assign. You can select <mark style="color:green;">**up to 5 Discord roles**</mark>.

<div align="left"><figure><img src="/files/tvSxoQG2kt6RnZ48htFJ" alt=""><figcaption></figcaption></figure></div>

6. Your selection has now been confirmed.

<div align="left"><figure><img src="/files/7qSUpN9dYeTMVldtMmT6" alt=""><figcaption></figcaption></figure></div>

7. The menu will now update to show your selections. You can use this menu later as a reference or reminder of the current permissions.

## Revoke

The revoke process is identical to granting. Instead, you will just be removing the access from selected Discord roles.

1. Run the `permissions revoke` to begin the process.

***

## :crown: Unsubscribe from notifications

```
/unsubscribe [feature]
```

<mark style="color:red;">InHouseQueue</mark> will sometimes send notifications to your queue channels. These can be reminders, useful tips or Patch notes notifications. You may opt out of receiving notifications at any point. Please note, that this is a one-time decision, you cannot resubscribe.

***

## :crown: Change the language

```
/language [language]
```

Change the language <mark style="color:red;">InHouseQueue</mark> uses.

**Available Languages:**

* English
* Spanish
* Portuguese
* Italian


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.inhousequeue.xyz/docs/commands/server-commands.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.