## News / Updates

<u>**September 19, 2018**</u>: New commands have been added so users can specify which roles can manage tournaments! By default, users with manage server permissions can manage tournaments.

## How it works

Manage tournaments that your Discord members can join, as well as: 

* Bulk add members to the tournament as particants.
* Declare winners and set scores
* Participate in a tournament using your Discord username/avatar.
* And much more!

Prefixes: `!`, `?`, `t!`, `t?` or `@mention` the bot (e.g. `@botname [the command]`)

This bot uses the [Challonge API](https://challonge.com/) to manage tournaments.

[View tutorial on basic usage and screenshots here.](https://github.com/stephwag/challonge-discord/blob/master/SCREENSHOTS.md)

## Commands

Commands that do not depend on a tournament to exist.

| Command | Description | Usage |
|--------------------|-------------------------------------------------------------------------------------------------|-----------------------------------|
| **!challonge email** | Associates your Challonge email for tournament participation. If not set, your Discord username is used. | `!challonge email [email]` |
| **!challonge username** | Associates your Challonge username for tournament participation. If not set, your Discord username is used. | `!challonge username [username]` |
| **!tourney create** | Creates a tournament. This also sets it as the "current" tournament on the server. | `!tourney create [name] (optional game name)` |
| **!tourney all** | Show all tournaments (by their ID) created by this server. | `!tourney all` |
| **!cantourney** | Allow users with a role to manage tournaments and participants. | `!cantourney [role]` |
| **!cannottourney** | Disallow a role from managing tournaments and participants. | `!cannottourney [role]` |
| **!whocantourney** | Show all roles who can manage tournaments and participants. Users with manage server permissions can always manage tournaments. | `!whocantourney` |

After running `!tourney create`, the below commands can be used for that tournament. Use `!current` to show its information, or to switch to another tournament as the "current" one. 
 
### Commands for the current tournament.

| Command | Description | Usage |
|--------------------|-------------------------------------------------------------------------------------------------|-----------------------------------|
| **!start** | Starts a tournament. | `!start` |
| **!current** | Shows current tournament information. Optionally can set a different tournament as the "current" one. It is also the tournament where the below commands can be applied. | `!current (optional tournament ID)` |
| **!finalize** | Finalizes the tournament, making current results permanent. | `!finalize` |
| **!reset** | Resets a tournament, clearing all of its scores and attachments. | `!reset` |
| **!winner** | Declare a user as a winner for their currently open match. Default scores are 1 (for winner) and 0 (for loser). | `!winner [@user]` |
| **!participate** | Participate in a tournament. If you are a tournament manager, you can tag a user to add them instead. | `!participate (optional @user1, @user2, ...)` |
| **!unparticipate** | Removes you from a tournament. If you are a tournament manager, you can tag a user to remove them instead. | `!unparticipate (optional @user)` |
| **!addmembers** | Adds all members from your server to the tournament. | `!addmembers` |
| **!addbots** | Adds bots to the tournament, if you want to do that for some reason. | `!addbots` |
| **!clear** | Clears a tournament of all participants. | `!clear` |
| **!seed** | Sets the seed of a participant in the tournament. Must be less or equal to the number of participants. | `!seed [@user] [number]` |
| **!swap** | Swaps the seed between two participants of the tournament. | `!swap [@user1] [@user2]` |
| **!status** | Shows your participant info (current rank, etc). Tag a user for their participant info instead. | `!status (optional @user)` |
| **!match** | Shows the next open match that you're in. Tag a user to see theirs instead. | `!match (optional @user)` |
| **!reopen** | Reopens the most recent match that was completed. Tag a user to reopen one of theirs instead. | `!reopen (optional @user)` |
| **!update** | Updates tournament settings. See [Challonge's documentation](https://api.challonge.com/v1/documents/tournaments/update) to see a list of possible fields. | `!update [field] [value]` |
| **!destroy** | Deletes the current tournament. | `!destroy` |

### Additional Notes

To update fields with `!update`, use the field shown in the docs (shown in brackets) for `[field]` and a valid value. For example, if you want to update the tournament to use double elimination, run `!update tournament_type "double elimination"`. Keep in mind that any values with spaces need to be wrapped with double quotes.

*All tournaments are viewable to the public by default*

Tournament Manager

Create tournaments that allow members on your Discord server to participate! Powered by Challonge.

التصويت لـTournament Manager

هل ترغب في دعمنا؟