# 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.

***

## :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.


---

# 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/challenges-command.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.
