## 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 के लिए वोट कर रहे हैं

क्या आप हमारी सहायता करना चाहते हैं?