TourneyBot Command Reference

Tourney Director Commands

Commands for people who run tourneys.


add moderator

Syntax

tell TourneyBot add moderator

Description

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.

Access

Everyone Everyone

Example

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

Note

The requirements for moderators are always subject to change.

appoint moderator

Syntax

tell TourneyBot appoint moderator <name> tourney <tourney>

Description

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.

Access

Moderator Moderators

Example

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

Note

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

Syntax

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

Description

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

Access

Moderator Moderators

Example

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).

Note

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

Syntax

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

Description

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.

Access

Moderator Moderators

Examples

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.

Note

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

Syntax

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

Description

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).

Access

Moderator Moderators

Example

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


create

Syntax

tell TourneyBot create <tourney_type>

Description

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

Access

Moderator Moderators

Example

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


demote moderator

Syntax

tell TourneyBot demote moderator <name> tourney <tourney>

Description

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.

Access

Admin Admin

Example

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

Note

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

Syntax

tell TourneyBot describe <tourney> <description>

Description

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

Access

Moderator Moderators

Example

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

Syntax

tell TourneyBot drop <tourney>

Description

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

Access

Moderator Moderators

Example

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

Syntax

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

Description

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

Access

Moderator Moderators

Examples

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

Syntax

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

Description

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.

Access

Moderator Moderators

Example

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


matchreport

Syntax

tell TourneyBot matchreport <number> email <email-address>;

tell TourneyBot matchreport <number> post <url> <username> <password>

tell TourneyBot matchreport <number> league <name> open | closed <Join Text and url of league>

Description

EMAIL - Sends a log of the tourney shouts and tells as an email when the tourney is over.

POST - Match results will be posted using a web form to the url specified and the user/password pair is used for authentication. League Head TDs ask for details if interested.

LEAGUE - When using a POST form you can require players to be members of the league. This join text will tell them how and where to join. If the league is defined as closed them the player must be a member before they can join the tourney. The <name> is used in the Post form when checking membership.

Access

Moderator Moderators

Example

You: tell TourneyBot matchreport 2224 email tom@moulton.us
TourneyBot: Tourney Report email will be sent to: tom@moulton.us

You: tell TourneyBot matchreport 2224 post http://moulton.us/notvalid/fibs.php tourneybot nouseme
TourneyBot: Match Report URL: http://moulton.us/notvalid/fibs.php

You: tell TourneyBot matchreport 2224 league droppers closed Free form text allowed including a url http://fibs.com/not_valid to join the league!
TourneyBot: Join Text: Free form text allowed including a url http://fibs.com/not_valid to join the league!


maxplayers

Syntax

tell TourneyBot maxplayers <number_of_players> tourney <tourney>

Description

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

Access

Moderator Moderators

Example

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


minplayers

Syntax

tell TourneyBot minplayers <number_of_players> tourney <tourney>

Description

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

Access

Moderator Moderators

Example

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


nolimit

Syntax

tell TourneyBot nolimit <tourney>

Description

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

Access

Moderator Moderators

Example

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


open

Syntax

tell TourneyBot open <tourney>

Description

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.

Access

Moderator Moderators

Example

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


remove moderator

Syntax

tell TourneyBot remove moderator

Description

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

Access

Moderator Moderators

Example

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


rename

Syntax

tell TourneyBot rename <tourney> <new_name>

Description

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.

Access

Moderator Moderators

Example

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

Syntax

tell TourneyBot reset <tourney>

Description

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

Access

Moderator Moderators

Example

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


resetstandings

Syntax

tell TourneyBot resetstandings <tourney type>

Description

Resets the standings of the specified tourney type.

Access

Moderator Moderators

Example

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

Note

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


start

Syntax

tell TourneyBot start <tourney>

Description

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

Access

Moderator Moderators

Example

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


timeout

Syntax

tell TourneyBot timeout <tourney> <minutes>

Description

Sets the player timeout for automatic player clocking. TourneyBot can maintain player clocks when a player is not playing their match or they leave a match to logoff.

Access

Moderator Moderators

Example

You: tell TourneyBot timeout 2224 15
TourneyBot: Timeout set to 15 minutes for Tourney #2224.


unban

Syntax

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

Description

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.

Access

Moderator Moderators

Examples

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

See more examples at ban.

Note

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.


Back to the top
Back to the Reference main page
Last update: 21 Jan 2008