> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tournamentsystem.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Discord bot commands

> What each of the Tournament System bot's commands does, what the assistant can help with, and how to turn the bot off.

Type `/` in your Discord server to see the commands you're allowed to use. Who can use each one is set in Discord; see [Set up the Discord bot](https://docs.tournamentsystem.xyz/discord/set-up-the-bot.md). Replies are posted in the channel unless they say something went wrong, which only you see.

## Commands

Commands are listed in the order `/commands` shows them.

| Command | What it does | Options |
| :- | :- | :- |
| `/ask` | Asks the Tournament System assistant. See [The assistant](#the-assistant). | **message**: what you want to ask. |
| `/image` | Creates an image, or edits one you attach. | **text**: what to create or change. **image**: an image to edit. **aspect**: its shape; **Original** keeps an attached image's shape. |
| `/schedule` | Posts a week's matches as a graphic, with each match's time. | **week**: defaults to the next week with matches. |
| `/matchday` | Posts a graphic for an upcoming match. | **match**: defaults to the next match. |
| `/result` | Posts a match result as a graphic. | **match**: defaults to the latest result. |
| `/standings` | Posts the league table as a graphic, ranked as the Player Hub ranks it. | **group**: defaults to the first group. |
| `/team` | Posts a team's profile as a graphic: its roster, captain, record and next match. | **name**: the team. |
| `/coinflip` | Flips a coin between two teams and names the winner once the coin lands. | **heads**: the team on heads. **tails**: the team on tails. |
| `/team-sync` | Previews changes to team roles and channels, then **Apply** makes them. See [Team roles and channels](https://docs.tournamentsystem.xyz/discord/team-roles-and-channels.md). | |
| `/custom-command` | Creates, edits, lists or deletes your server's own commands. See [Custom commands](#custom-commands). | **create**, **edit**, **list** or **delete**. |
| `/rosters` | Makes or refreshes the roster forum. See [The roster forum](#the-roster-forum). | **create**, with a name no other channel in your server uses and an optional category, or **sync**. |
| `/settings` | Shows the bot's settings for your server, only to you: the team text and voice categories, the captains role, the staff roles that see every team's channels and the team announcements channel. Each choice saves straight away. **Edit announcement wording** changes the announcement messages. | |
| `/commands` | Posts the list of commands. | |

Graphics are pictures, so their times can't change for each reader; the times in the text beside them show in your time zone.

## The assistant

`/ask` answers questions about your league and the Tournament System. It looks up your league's records, such as teams, players, matches, results, the schedule and the published rules, and searches this wiki for how things work. It doesn't search the web, and it can't change anything on the website.

It can also:

* Make an image, when you ask for one. To change an image, attach it to `/image`.
* Show someone's Discord profile picture.
* Post the list of commands.
* Create, change and delete custom commands.
* Make or refresh the roster forum.

Its answer starts with your question, so everyone in the channel can see what you asked. Each question is answered on its own, without your earlier messages, so include everything it needs. If a reply takes too long or fails, only you see the error; an image it already made is still posted.

## Custom commands

A custom command posts a week's schedule, a team's profile or the standings as a graphic, or a fixed message. For the schedule or a team, it either always shows the same week or team, or lets whoever runs it choose. Your server can have up to 25. Create and edit them with `/custom-command`, which opens a form, or ask the assistant.

## The roster forum

The roster forum is a Discord forum channel with one post for each verified team: its logo, team size, captain and players. The bot updates the posts every five minutes, so changes made to them in Discord are overwritten. When a team stops being verified, its post is closed.

## Turning the bot off

In the staff console, the **Discord Automation** page has one switch, **Bot enabled**. When it's off, the bot stays online with no commands or replies, and its status shows as idle. Team roles and channels aren't kept in step while it's off. Turning it back on brings everything back, including who can use each command, and the bot catches up on team changes.

## Next steps

> [card] [Set up the Discord bot](https://docs.tournamentsystem.xyz/discord/set-up-the-bot.md)
>
> Choose who can use the commands, and where.

> [card] [Plan the schedule](https://docs.tournamentsystem.xyz/season/schedule.md)
>
> The matches the graphics and the assistant read.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.