> For the complete documentation index, see [llms.txt](https://docs.inhousequeue.xyz/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.inhousequeue.xyz/docs/commands/challenges-command.md).

# Challenge 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: **Set up challenges for the server**

```
/challenges setup [game]
```

Enable challenges for your server. This creates an `#achievements` channel and starts tracking progress for all future games. Challenges are evaluated automatically after every match -- no manual refresh needed.

Find out more information about challenges [here](/docs/features/inhousequeue-challenges.md)

***

## :crown: **Pause or unpause challenges**

```
/challenges pause
```

Toggle challenge tracking on or off. While paused, no progress is recorded. Games played during the pause period are excluded when challenges resume. Run the command again to resume tracking.

***

## :crown: **Set the announcement channel**

```
/challenges channel [#channel]
```

Override the announcement channel for challenge completions. By default, an `#achievements` channel is created during setup.

***

## :crown: **Toggle a specific challenge**

```
/challenges toggle [challenge_name]
```

Enable or disable a specific challenge for your server. Disabled challenges won't appear in `/challenges all` and won't be evaluated.

***

***

## :crown: **Edit a challenge (Premium)**

```
/challenges edit [challenge_name]
```

Customize a specific challenge for your server. Opens a modal where you can change:

* **Threshold** -- override the default requirement (e.g., change games required from 15 to 25)
* **Role name** -- override the default `IHQ - {name}` role name
* **Role color** -- set a hex color for the role (e.g., `#FF5733`)
* **Existing role ID** -- map the challenge to an existing Discord role instead of auto-creating one

Only available on Premium servers.

***

## :crown: **Restore a challenge to defaults (Premium)**

```
/challenges restore [challenge_name]
```

Restore all customizations for a challenge back to its built-in defaults. This reverts any changes made with `/challenges edit`, including threshold overrides, role name, role color, and existing role mappings.

Only available on Premium servers.

***

## :bulb: View all available challenges

```
/challenges all
```

View all available challenges for your server, including difficulty, tier (Free/Premium), and whether specific features are required.

***

## :bulb: View challenge progress

```
/challenges progress {user}
```

View your challenge progress. Optionally mention another player to see theirs. Shows completion status and current progress for each active challenge.

***

## :bulb: Challenge leaderboard (Premium)

```
/challenges leaderboard
```

View the top 15 players ranked by total challenges completed. Only available on Premium servers.