TourneyBot Command Reference

Tourney Director Commands

Commands for people who run tourneys.

• add moderator - Appoint yourself a Tourney Director
• appoint moderator - Appoint a moderator as your Tourney Co-Director
• award win - Award victory to a tourney player
• ban - Ban a player from a tourney
• banned - List banned players
• create  - Make a new tourney
• demote moderator - Removes a moderator as your Tourney Co-Director
• describe - Change a tourney's description
• drop - Delete a tourney
• limit - Limit participation based on rating, experience and/or RepBot reputation
• matchlen - Set the tourney match length
• maxplayers - Set the maximum number of players in a tourney
• minplayers - Set the minimum number of players in a tourney
• nolimit - Remove all rating, experience and reputation limits from a tourney
• open - Open a tourney for sign-ups
• remove moderator - Remove yourself from the list of Tourney Directors
• rename - Rename a tourney
• reset - Reset a tourney to its initial state
• resetstandings - Reset standings for a tourney type
• start - Start a tourney
• unban - Remove a player from the banned list

add moderator

tell TourneyBot add moderator

Adds yourself to the list of moderators (people who host tourneys). Note that you need to have a FIBS experience of 1000 to be eligible.

Everyone

You: tell TourneyBot add moderator
TourneyBot: Congratulations, you are now a tourney moderator.

The requirements for moderators are always subject to change.

appoint moderator

tell TourneyBot appoint moderator <name> tourney <tourney>

Appoints <name> as a Co-Director of the specified tourney. The one sending this command has to be a Director of the tourney and <name> has to be on the global moderators list.

Moderators

You: tell TourneyBot appoint moderator diane tourney 92
TourneyBot: diane added as moderator of Tourney #92.

Make sure to use the proper capitalization of the name in the command - ie. MadMatt is correct, while madmatt or Madmatt isn't. As a general rule-of-thumb, it's usually best to use all-lowercase letters with commands and arguments and the proper capitalization when referring to player names.

award win

tell TourneyBot award win <name> <higher_score>-<lower_score> round <round> tourney <tourney>

Award the win to the specified player in the specified round of the specified tourney.

Moderators

You: tell TourneyBot award win mookie 1-0 round 1 tourney 78
TourneyBot: You awarded victory to mookie in Round 1 of Single Elimination Bracket Tourney #78 (Tourney #78).

Make sure to use the proper capitalization of the name in the command - ie. MadMatt is correct, while madmatt or Madmatt isn't. As a general rule-of-thumb, it's usually best to use all-lowercase letters with commands and arguments and the proper capitalization when referring to player names.

ban

tell TourneyBot ban <player> <tourney_number>|<tourney_type>|globally

Bans the specified player from participating in a tourney (if the tourney number is specified), all tourneys of a kind (if a tourney type is specified) or all TourneyBot tourneys (if globally is specified.). This should be used with caution, especially the global bans. Note that you cannot ban a player from a specific tourney if it's already been started. Also, if the player has signed up for a specific tourney, banning him will remove him from that tourney and prevent him reentering. Only the administrator can ban globally, and only the players able to create tourneys of a specific type can ban from that tourney type.

Moderators

You: tell TourneyBot ban danolo globally
TourneyBot: danolo has been banned from every TourneyBot tourney and notified of it.

You: tell TourneyBot ban DropperJoe fridays3
TourneyBot: DropperJoe has been banned from fridays3 tourneys and notified of it.

You: tell TourneyBot ban DropperJoe 87
TourneyBot: DropperJoe has been banned from Tourney #87 and notified of it.

Make sure to use the proper capitalization of the name in the command - ie. MadMatt is correct, while madmatt or Madmatt isn't. As a general rule-of-thumb, it's usually best to use all-lowercase letters with commands and arguments and the proper capitalization when referring to player names.

banned

tell TourneyBot banned <tourney_number>|<tourney_type>|globally

Lists players banned from a specific tourney (if you specify the tourney numer), all tourneys of a kind (if you specify the type) or all TourneyBot tourneys (if globally is specified).

Moderators

You: tell TourneyBot banned globally
TourneyBot: Listing globally banned players:
TourneyBot: DropperJoe, DropperJim
TourneyBot: Done listing globally banned players.

create

tell TourneyBot create <tourney_type>

Create a new tourney of the specified type, with default properties. The available tourney types are: bracket, double, bagolympic and fridays3.

Moderators

You: tell TourneyBot create bracket
TourneyBot: Tourney 94: Single Elimination Bracket Tourney #94 created.

demote moderator

tell TourneyBot demote moderator <name> tourney <tourney>

Removes <name> from the list of the Directors of the specified tourney. Note that every tourney has to have at least one Director, so if you try to remove the last one, it won't work.

Admin

You: tell TourneyBot demote moderator MadMatt tourney 92
TourneyBot: MadMatt has been removed as a moderator of Tourney #92.

Make sure to use the proper capitalization of the name in the command - ie. MadMatt is correct, while madmatt or Madmatt isn't. As a general rule-of-thumb, it's usually best to use all-lowercase letters with commands and arguments and the proper capitalization when referring to player names.

describe

tell TourneyBot describe <tourney> <description>

Changes the description of the specified tourney. The description should be between 20 and 1000 characters long.

Moderators

You: describe 51 Mad Blitz: 1-pt matches with 3-pt final. Starts at 17:20 UTC. Standard single elimination format.
TourneyBot: Displaying information about Tourney 51:
TourneyBot: |51: [bracket] Mad Blitz| |Unknown| |Directors: MadMatt| |Status: Being created|
TourneyBot: Match length: 1 Match length finals: 3
TourneyBot: Limits: (no limits)
TourneyBot: Description: Mad Blitz: 1-pt matches with 3-pt final. Starts at 17:20 UTC. Standard single elimination format.
TourneyBot: Done displaying information on Tourney 51.

drop

tell TourneyBot drop <tourney>

Sends a request to remove the specified tourney. You will have to confirm your request by sending a yes command when prompted.

Moderators

You: tell TourneyBot drop 52
TourneyBot: Are you sure you want to delete Single Elimination Bracket Tourney #52 (Tourney #52)? (Send 'yes' in less than 10 seconds)
You: tell TourneyBot yes
TourneyBot: Tourney #52 deleted.

limit

tell TourneyBot limit rating|exp|rep <min> <max> tourney <tourney>

Limits who can sign up for the specified tourney based on either rating, experience and/or RepBot reputation. Use -1 to specify no limit.

Moderators

You: tell TourneyBot limit exp 400 -1 tourney 94
TourneyBot: Tourney #94 limits: Rating -- minimum: (no limit), maximum: (no limit) Experience -- minimum: 400, maximum: (no limit) Reputation -- minimum: (no limit), maximum: (no limit)

You: tell TourneyBot limit rep -1000 100000 tourney 94
TourneyBot: Tourney #94 limits: Rating -- minimum: (no limit), maximum: (no limit) Experience -- minimum: 400, maximum: (no limit) Reputation -- minimum: -1000, maximum: 100000

You: tell TourneyBot limit rating -1 1500 tourney 94
TourneyBot: Tourney #94 limits: Rating -- minimum: (no limit), maximum: 1500 Experience -- minimum: 400, maximum: (no limit) Reputation -- minimum: -1000, maximum: 100000

matchlen

tell TourneyBot matchlen normal|finals <length> tourney <number>

Sets the match length for the specified tourney. normal indicates all rounds except for the final one, where as finals indicate the final round. <len> should be between 1 and 99.

Moderators

You: tell TourneyBot matchlen normal 7 tourney 94
TourneyBot: Tourney #94 match length - normal: 7 finals: 3

maxplayers

tell TourneyBot maxplayers <number_of_players> tourney <tourney>

Set the maximum number of players in the specified tourney. The number has to be between 2 and 128. See also minplayers.

Moderators

You: tell TourneyBot maxplayers 64 tourney 94
TourneyBot: The maximum number of players for Tourney #94 has been set to 64.

minplayers

tell TourneyBot minplayers <number_of_players> tourney <tourney>

Set the minimum number of players in the specified tourney. The number has to be between 2 and 128. See also maxplayers.

Moderators

You: tell TourneyBot minplayers 16 tourney 94
TourneyBot: The minimum number of players for Tourney #94 has been set to 16.

nolimit

tell TourneyBot nolimit <tourney>

Eliminates all experience and rating limits from the specified tourney. (They're all set to -1).

Moderators

You: tell TourneyBot nolimit 94
TourneyBot: Tourney #94 no longer has any limits.

open

tell TourneyBot open <tourney>

Opens a tourney so that players can begin signing up for participation. Remember to set up tourney properties beforehand, as most of the set-up commands won't work after the tourney's been open.

Moderators

You: tell TourneyBot open 94
TourneyBot: Single Elimination Bracket Tourney #94 (Tourney #94) open for sign-ups.

remove moderator

tell TourneyBot remove moderator

Removes yourself from the list of moderators (people who can hold tourneys).

Moderators

You: tell TourneyBot remove moderator
TourneyBot: You have been removed from the moderators list.

rename

tell TourneyBot rename <tourney> <new_name>

Renames the specified tourney. Note that the new name should be between 3 and 100 characters long, or else you'll get the syntax error message.

Moderators

You: tell TourneyBot rename 63 Mad Blitz
TourneyBot: |63: [bracket] Mad Blitz| |Sun, 07 Mar 04 14:28 UTC| |Directors: MadMatt| |Status: Being created|

reset

tell TourneyBot reset <tourney>

Reset the specified tourney to its initial state (just as if it was created anew). You can only do that before the tourney starts.

Moderators

You: tell TourneyBot reset 63
TourneyBot: Reset Mad Blitz (Tourney #63).
(Followed by the tourney info.)

resetstandings

tell TourneyBot resetstandings <tourney type>

Resets the standings of the specified tourney type.

Moderators

You: tell TourneyBot resetstandings fridays3
TourneyBot: Standings for  fridays3 tourneys have been reset.

You can only reset standings of tourney types that you own.

start

tell TourneyBot start <tourney>

Starts the specified tourney. Will only work if the tourney's open and enough players have signed up for it.

Moderators

You: tell TourneyBot start 73
TourneyBot: Single Elimination Bracket Tourney #73 (Tourney #73) started.

unban

tell TourneyBot unban <player> <tourney_number>|<tourney_type>|globally

Remove the ban on the specified player. This is the reverse command of ban and works the same way. If you specify a number, player will be unbanned from that tourney only, if you specify the type, he will be unbanned from all (future) tourneys of that type and if you specify globally, he will be removed from the global ban list. Only the administrator can globally unban and only those allowed to create tourneys of a type are allowed to unban from that type.

Moderators

You: tell TourneyBot unban DropperJoe 93
TourneyBot: DropperJoe will be able to sign up for Tourney #92.

See more examples at ban.

Make sure to use the proper capitalization of the name in the command - ie. MadMatt is correct, while madmatt or Madmatt isn't. As a general rule-of-thumb, it's usually best to use all-lowercase letters with commands and arguments and the proper capitalization when referring to player names.