TOURNEY Bot™ Discord Commands

Tournament Kings TK logo

Learn How Our Free Tourney Bot Works

Your feedback makes this page better! Tell us what you think of Tourney Bot.

General Commands
These are commands that any player can type and does not require special permissions to use.

/transfer <amount> @playerType this command in a public channel to send funds to another user.
example: /transfer 5 @Dan#123 will send user @Dan234 $5.
Channel: any public channel

/support Returns a link to the Tourney Bot support Discord server.
Channel: any public channel

/feedback Returns a link to our Google feedback survey.
Channel: any public channel

/team kick <team_ID> @mention This allows the a team creator or admin to remove a player from a team.
Channel: any public channel

/roster <team_size> Displays a roster of any teams you are on of that size.
example: /roster 5 will show you the members of the team of 5 you are on.
Channel: private match channel

/leave This will remove you from the event you are registered for.
Channel: #chat channel of the event you want to leave



Global Admin Commands

These commands can be typed in any channel that Tourney Bot can see and requires either admin perms or the Tournament Admin role.


/createtournament (/ct for short) Starts the tournament creation process in DMs.
Channel: any channel

/lobby create Starts the lobby creation process in DMs.
Channel: any channel

/scrims Triggers the scrims setup.
Channel: any channel

/team setup Creates the team management category and associated channels.
Channel: any channel

/registration create Creates an embed for players to use to create a Tournament Kings account. This will also allow your members to compete in events for prizes.
Channel: any channel

/role embed Creates an embed for players to receive the TK Verified Role.
Channel: any channel

/language Creates an embed allowing you to change Tourney Bot's language settings.
Channel: any channel

/lobby help Creates a help embed specific to lobby commands.
Channel: any channel

/helpCreates a help embed for admin commands.
Channel: any channel



Tournament Commands
These are commands that Tournament Admins can use to run Tournaments.


/createtournament(/ct for short) Starts the tournament creation process in DMs.
Channel: any channel

/start Starts the tournament.
Channel: admin channel

/readyup Creates an embed in #chat for players to react to ready-up. Players that don't ready-up will be kicked. You can also set your own timer if you don't want to use the default 3 minute one.
Channel: admin channel

/readyup <timer> This will override the default 3 minute ready-up timer to be whatever you put in seconds.
example: /readyup 120 will change the default timer to 120 seconds.
Channel: admin channel

/bracket private Hides the #bracket channel.
Channel: admin channel

/bracket public Unhides the #bracket channel.
Channel: admin channel

/log privateHides the #log channel.
Channel: admin channel

/log public Unhides the log channel
Channel: admin channel

/playercap <number> Sets the player cap of the tournament.
example: /playercap 10 will set the max participants to 10.
Channel: admin channel

/kick @player Kicks the specified player from the tournament.
Channel: admin channel

/ban @player Bans the specified player from the tournament.
Channel: admin channel

/score <match#> <top_seed_score> <bottom_seed_score> Overwrites the score in the match specified.
example: /score 1 3-0 would force the top seed of match 1 to win with a score of 3-0.
Channel: admin channel

/refreshReloads the bracket image in the #bracket channel.
Channel: bracket channel

/end Ends the tournament after the last match has been completed.
Channel: admin channel

/delete Deletes the category, channels and role associated with the tournament.
Channel: admin channel

/showprize false Hides the prize pools for events with an entry fee.
Channel: admin channel

/showprize true Unhides the prize pools for events with an entry fee.
Channel: private match channel

/help Shows tournament specific commands.
Channel: admin or chat channel



Lobby Commands

These are commands that Admins can use to run lobbies.


/lobby readyup Sends a ready check to the lobby #chat channel. Users who do not react to this are kicked from the lobby.
Channel: admin channel

/lobby start pickup <#_of_participants> <team_size> Creates pickup games with your choice of players and team sizes.
example: /lobby start pickup 4 2 will start pickup games with a total of 4 players, it will then put these players into 2 person teams so there is 1 match of 2v2's.
Channel: any channel within the lobby

/lobby score pickup <match#> <top_seed_score> <bottom_seed_score> Overrides the score of a pickup match. Top and bottom seed players found in the results channel.
example: /lobby score pickup 3 0-1 will change the score for match 3 to 0-1.
Channel: any channel within the lobby

/lobby start ffa <players> <group_size> <winners_per_group> Creates random FFA matches made up from the people in the lobby.
example: /lobby start ffa 10 5 1 will create a game with 10 players in the lobby, splitting them up in groups of 5 and each game will only have 1 winner.
Channel: admin channel

/lobby score ffa <group_id> @player <position> This will override the score for a FFA game and place the mentioned player in the <position> entered in the group.
example: /lobby score ffa 1 @PartyPete 3 will position PartyPete in 3rd place for ffa group 1.
Channel: lobby admin channel

/lobby score ffa <group_id> <@_player(s)> This will override the score for a FFA game and place the players mentioned in descending order.
example: /lobby score ffa 1 @PartyPete @JollyJones @FeralFreddie @SadSam will put Pete in 1st, and Sam in last.
Channel: lobby admin channel

/lobby start group <players> <group_size> Creates round robin style matches from the players in the lobby.
example: /lobby start group 8 4, will create 2 groups of 4, and everyone plays each other in that group one time.
Channel: lobby admin channel

/lobby score group <match> <team_1_score>-<team_2_score> This will override the score of a group match.
example: /lobby score group 1234 2-0 will override the score for group match 1 to 2-0.
Channel: lobby admin channel

/lobby auto pickup <on:off> <team_size>Automatically runs pickup games every minute, can be stopped at any time.
example: /lobby auto pickup on 6, will run pickups with team sizes of 6 each time.
Channel: lobby admin channel

/lobby cancel <event>Cancels ongoing events of that type.
example: /lobby cancel pickup. To delete a specific match, do /lobby cancel pickup <match#>.
example 2: /lobby cancel pickup 12345.
Channel: lobby admin channel

/lobby next <event> This will start the next events if the event can have multiple rounds. FFA will start the next event with the winners and Groups would start the next event with new opponents for each player.
Channel: any public channel

/lobby clear Removes all players from a lobby.
Channel: lobby admin channel

/lobby playercap <number> Change the number of max players allowed in the lobby.
Channel: lobby admin channel

/lobby kick @player Lets you kick a player from the lobby.
Channel: lobby admin or chat channel

/lobby waitlist <on:off> Enables or disables the waitlist for the current lobby. Waitlists allow the players to join the lobby over the max player cap. If a player who is in the lobby leaves or is kicked, a player from the waitlist will then be added.
Channel: lobby admin channel

/lobby registrations Displays everyone who is registered for the lobby.
Channel: lobby admin channel

/lobby help Sends an embed with all the available lobby commands and information.
Channel: lobby admin channel



Scrims Commands

These are commands that Tournament Admins and players can use to run scrims.


/scrims Triggers setup (admin only).
Channel: any public channel

/scrims score Allows players to report the score of a round. Must be done after every game in a best of series.
Channel: private match channel

/scrims score help Provides more information about how to report scores.
Channel: private match channel

/scrims dispute Alerts the event admins that a score needs to be corrected in your match.
Channel: private match channel

/scrims dispute help Provides additional information on how to edit and correct scores.
Channel: private match channel

/scrims leave Allows players to leave their current scrim.
Channel: private match channel

/scrims delete Deletes the scrim match.
Channel: private match channel

/scrims help Returns a list of commands you have access to.
Channel: private match channel



Direct Message Commands

These commands are sent in Direct Messages to Tourney Bot.


/account Allows users to view their account information, such as playable balance, cash balance, and TK gold balance.
Channel: DMs

/deposit Allows the user to deposit money to their account. A link to the Tournament Kings website will direct you to a page where you can securely transfer money with PayPal.
Channel: DMs

/cashout Sends the user to the Tournament Kings website to withdraw money from their account. This is then sent securely via PayPal to you.
Channel: DMs

/help Returns a list of DM commands.
Channel: DMs

How To Get Tourney Bot For Discord

Step 1:
Click here to add Tourney Bot to your Discord Server.

Step 2:
Select which of your servers you’d like to add Tourney Bot to.

Step 3:
Give Tourney Bot the proper permissions (as shown in the photo)

Recommended Setup
Too many messages in a channel will cause tournament cards to be pushed out of immediate visibility, so it is recommended that a designated #TournamentSignup channel be created with permission settings to restrict anyone other than the bot or tournament admins from typing in it.

The same goes for the Registration card, made with the '/registration create' command. A designated channel for only this card is recommended to allow quick and easy access.

Event Registration

Step 1:
Create a Registration card with the /registration create command in a discord channel that the bot has permissions to type in and edit.

From there click the reaction icon below the card to create your TK account.

Before being able to use the bot, users will first have to register their Discord account and accept the Terms of Service.

Step 2:
TK Bot will DM you with the following card. Click “Please click here to signup” to create your official TK account.

Please be aware, you’ll need to have your DM’s turned on so the bot can message you.

Step 3:
When taken to the site, click “Accept and Login” and authorize when prompted by Discord.

Important!
Your server members only need to register for a TK account when competing for cash prizes or adding funds to their TK Account.

starting A Tournament

In a public channel, type: /createtournament
This will begin the tournament creation process with the Bot in DMs.
MAKE SURE YOUR DM'S ARE ON

Tourney Bot will ask you the following questions:
1. Tournament Name
2. Team Size (all teams will be required to have this many members)
3. Game being played
4. Bracket Type
5. Price (free or entry fee?)
6. Number of rounds per match.
7. Number of Teams or participants (depending on bracket type)
8. Game Platform
9. Rules & Information

Tournament Channel Breakdown

The following channels will be created automatically once your tournament is launched:

#Log
This is where all action messages are sent:

  • When a player joins
  • When a player leaves
  • When a tournament ends
  • Whenever a player is kicked or banned
  • When the tournament starts

Tournament commands will not work in the #log channel
Non-Tournament admins are automatically restricted from typing in this channel

#Chat

  • This is the General chat channel for the specified tournament
  • All users who enter the tournament have permission to type here
  • Messages will also be sent here when starting the tournament and ending it


#Bracket

  • This is where the embed showing the tournament bracket will be created
  • The embed will automatically update after each match
  • After the tournament is completed, the embed will change to show the winners and payouts
  • Messages will also be sent here when starting the tournament and ending it.


#Score-Matches

  • Match scoring embeds are sent to this channel.
  • Both team captains are able to score matches

Score is reported by reacting first with the score of the first team, and then the score of the second team. Score is then confirmed by reacting to the appropriate emote.

#Match-Results

  • Match results are shown here after being confirmed in the #score-matches channel
  • Users can react with the given 'X' to dispute matches


#Admin

  • This is where admins will use all of their commands to manage the tournament.
  • Start embeds and ready up embeds will show here as well
  • Disputes are also shown here

Tournament Entry Fee & pAYOUT

Paying The Entry Fee
Players registering for your event will have the entry fee automatically deducted from their Tournament Kings account.

The entry fee is set by the organizer and can range between $.25 and $50,000

Distributing Cash Prizes
Payout options include: 
Winner takes all, Top 2, Top 3, & Top 8

Funds are distributed via Paypal.

What Are Scrims?

Scrims are the best way for community members to create custom matches and compete against one another for cash or bragging rights - without the need of an admin!

How To Enable Scrims with Tourney Bot

Step 1:
type /scrims in any public Discord channel. Tourney Bot will reply with a message (admins only)

Step 2:
React to Tourney Bot's message with the shown emote to trigger setup.

tOURNEY bOT sCRIM cOMMANDS

Setup Command (ADMIN):

/scrims Triggers setup (admin only).
Channel: any public channel

Player Commands

/scrims score Allows players to report the score of a round. Must be done after every game in a best of series.
Channel: private match channel

/scrims score help Provides more information about how to report scores.
Channel: private match channel

/scrims dispute Alerts the event admins that a score needs to be corrected in your match.
Channel: private match channel

/scrims dispute help Provides additional information on how to edit and correct scores.
Channel: private match channel

/scrims leave Allows players to leave their current scrim.
Channel: private match channel

/scrims delete Deletes the scrim match.
Channel: private match channel

/scrims help Returns a list of commands you have access to.
Channel: private match channel

Admin Commands
/scrims score <team(a)_score> - <team(b)_score> Overrides a score on A disputed scrims match before it has ended.
example: /scrims score 2-3 would update the score to TEAM(a): 2 & TEAM(b): 3
Channel: private match channel

/scrims delete Deletes the match of the channel you're in.
Channel: private match channel

/scrims help Displays a list of admin only commands
Channel: private match channel

Team Setup

In a public channel, type: /team setup
Tourney Bot will instantly create the Team Management category (must have admin perms).

How To Create A New Team

Step 1:
Head to the #create-team channel created by an admin.

Step 2:
Locate the Team Creator card and react to the emote shown.

Step 3:
Tourney Bot will DM and walk you through the setup process.

How to Join A Team

Step 1:
Head to the #join-team channel created by an admin.

Step 2:
Locate your team's card and react to the emote shown.

Step 3:
The team creator will receive a DM letting them know you are trying to join. From there it is up to them to let you in.

How To Create A Discord Lobby

Step 1:
type /lobby create in any public channel Tourney Bot has access to.

Step 2:
Tourney Bot will DM you directly to walk you through the lobby setup

Step 3:
After the setup has been completed, Tourney Bot will automatically create a category with your Lobby's name and fill it with the following channels:

#log:
All notifications of players joining/leaving will be sent here.

#leaderboards
This is where pickup game ranks will be shown. It will automatically update after each scored pickup game.

#results
This is where match results from pickups in the lobby will be posted.

#chat
A locked channel that only members of the lobby can participate in

#admin
This is the intended place for tournament admins to put their commands.

Step 4:
Tourney Bot will create a players registration card in the channel you initiated setup in. Make sure players react to this card so they can access your lobby.

Free-For-All Setup

Step 1:
in admin channel of your lobby type /lobby start ffa (#_participants) (group_size) (winners_per_group)
example: /lobby start ffa 10 5 1 will create a game with 10 players in the lobby, splitting them up in groups of 5 and each game will only have 1 winner.

Step 2:
Tourney Bot will create the following channel based on your input:

#ffa-results
FFA group results will be posted in this channel in the form of embeds showing all winners of each group.

#ffa-groups
Embeds with all participating players in the group will be sent here, and players will be given the opportunity to score their matches here as well.

Step 3:
Participants play their games and log their placement via the #scores channel. The game will not progress until the scores are confirmed by an admin.

Step 4:
Once all scores have been confirmed type /lobby next ffa in the admin channel to progress the event until you no longer wish to.

FAQ

-+
Do I need to Register my TK account to compete in events?

You only need a TK account to participate in events with cash prizes or to deposit funds into your TK wallet.

If an event does require you to have an account, the bot will automatically bring you through the account registration process when you attempt to join the event.

-+
How do I get started after inviting the bot?

All you need to do to get started after inviting the bot is type '/help' in a public channel, and then choose what command you want to run! Create a tournament, Quick Match, Lobby, you name it!

-+
What kind of permissions does the bot need?

The bot does a lot of different things, so to ensure it's always working properly, it needs administrator rights.

-+
What's the best way to get users registered?

We recommend a special channel called "registration" where you create a registration card for users to react to. Make sure you set permissions to stop people from typing in that channel, or else the registration card will get lost in the messages.

-+
What's the best way to organize my server?

We recommend having designated #registration & #tournament-singup channels, where only tournament admins can send messages. That way, you can make sure the registration & tournaments cards are easily accessible and never get pushed up by messages in the channel.

-+
What games can I run tournaments for?

We designed the bot to be agnostic to game, meaning if you have a discord community, you can use it for whatever game you want... even Ping-Pong!

-+
How do I get people to join my events?

Once you have the tournament created, users can join by reacting to the tournament card in the channel you made the tournament in. Make sure users can see the channel, otherwise they won't be able to join!

-+
How can I allow other members of my discord to run tournaments & events?

All you have to do is give them the 'tournament admin' role, which the bot will have already created. Once you do that, they will be able to use the bot to run their own events!

-+
How do I add money to my account to join paid events?

In order to join a paid event, you will need to first deposit funds into your Tournament Kings account. You can do this via Paypal by sending a DM to the bot saying /deposit

-+
How do I know my money is secure?

All transactions are securely done through our Paypal integration. As one of the best known payment systems in the world, we chose Paypal so provide security and peace of mind to our users.

-+
How do I know how much money I have in my account?

Simply DM the bot /account to see all of your account information!