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

***

## :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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.inhousequeue.xyz/docs/commands/challenges-command.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
