This manual contains all commands available to users. Note that not all commands may be available to all users on all servers. The guild tier and permission requirements give more detail on this (having any of the required resource groups will grant you access to a command). Please also note that people or roles with server admin permissions are considered bot admins by default and have access to every command available on the server. All interactions with the bot have to make use of slash commands. Further guidance on the bot's usage can be found using the /howto-command or on the League Utils Support Server
The app-module is the integrated solution to manage applications to your tournaments. It has commands for applicants to apply to a tournament, view and manage their team and preliminary roster. The module also comes with commands for tournament staff to review the applications, making the transition from applicant to participant seamless
app accept
Accept a team into the tournament. Once accepted, the application can no longer be edited and all further changes need to be made with the equivalent team commands. The team code parameter chosen with this command will be used for all actions concerning the team for the duration of the entire tournament. Team codes must be alphanumeric and at most 8 characters long. If the application channel is omitted, the current channel will be used
Usage
/app accept team_code:"team code" application_channel:"optional: application channel" add_reproles:"optional: give out rep roles as well?"
Example
/app accept team_code:OSD application_channel:#some-channel
Permission Requirements
MANAGE_APPLICATIONS, TOURNAMENT_ADMIN, LEAGUE_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
app addlogo
Save a team logo. The logo must be a .jpg, .jpeg or .png file
Usage
/app addlogo logo:"attached logo file"
Permission Requirements
NONE
Guild Tier Requirements
TOURNAMENT_SERVER
app addplayers
Add one or multiple (separated by whitespaces) players to your preliminary roster. This command can only be executed from inside an application channel
Usage
/app addplayers player_tags:"playertag1 playertag2 ..."
Example
/app addplayers player_tags:#2PVPRC2L8 #2PP
Permission Requirements
NONE
Guild Tier Requirements
TOURNAMENT_SERVER
app clone
Clone team metadata and roster from a team in another (active) tournament. Caution: this command will overwrite all team information except for the name and reps
Usage
/app clone tournament_name:"tournament name" team_code:"team code"
Example
/app clone tournament_name:Demot team_code:GD
Permission Requirements
NONE
Guild Tier Requirements
TOURNAMENT_SERVER
app complete
Mark your application as finished and ready for staff review
Usage
/app complete
Permission Requirements
NONE
Guild Tier Requirements
TOURNAMENT_SERVER
app deletechannels
Delete a set of processed application channels. The application status can be "accepted", "rejected" or "all". Note that pending applications will not be deleted even with status "all". If the application status is omitted, "all" is the default
Usage
/app deletechannels tournament_name:"tournament name" status:"optional: application status"
Example
/app deletechannels tournament_name:Demot status:accepted
Permission Requirements
MANAGE_APPLICATIONS, TOURNAMENT_ADMIN, LEAGUE_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
app loadroster
Load an application roster from a clan's member list. After running the command, the bot will present you with a selection menu filled with all players currently in the clan. From there, you can choose the ones you want to add to the roster
Usage
/app loadroster clan_tag:"clan tag"
Example
/app loadroster clan_tag:#2PP
Permission Requirements
NONE
Guild Tier Requirements
TOURNAMENT_SERVER
app open
Open an application to a tournament. This will open a channel with you and tournament staff. Further instructions on the application process will await you there. The team name provided here will be the one used for your team throughout the tournament, so choose carefully. You can also provide a preferred team code, but it is up to staff to decide whether they want to assign that code to your team
Usage
/app open tournament_name:"tournament name" team_name:"team name" preferred_team_code:"optional: preferred team code"
Example
/app open tournament_name:Demot team_name:"one strange dev" preferred_team_code:OSD
Permission Requirements
NONE
Guild Tier Requirements
TOURNAMENT_SERVER
app overview
Show a status overview of all currently open applications for a tournament
Usage
/app overview tournament_name:"tournament name" incomplete_only:"optional: show only incomplete applications?"
Example
/app overview tournament_name:Demot
Permission Requirements
MANAGE_APPLICATIONS, TOURNAMENT_ADMIN, LEAGUE_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
app preferredcode
Set your preferred team code. This will let staff know of your preference, but it is up to them whether they want to assign your team your chosen code
Usage
/app preferredcode preferred_team_code:"preferred team code"
Example
/app preferredcode preferred_team_code:OSD
Permission Requirements
NONE
Guild Tier Requirements
TOURNAMENT_SERVER
app reject
Reject a team from the tournament. This will delete the application, but not the application channel. If the application channel is omitted, the current channel will be used
Usage
/app reject application_channel:"optional: application channel"
Example
/app reject application_channel:#some-channel
Permission Requirements
MANAGE_APPLICATIONS, TOURNAMENT_ADMIN, LEAGUE_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
app rmplayers
Remove one or multiple (separated by whitespaces) players from your preliminary roster. This command can only be executed from inside an application channel
Usage
/app rmplayers player_tags:"playertag1 playertag2 ..."
Example
/app rmplayers player_tags:#2PVPRC2L8 #2PP
Permission Requirements
NONE
Guild Tier Requirements
TOURNAMENT_SERVER
app scan
Scan an applicant roster for fairplay infractions. The ban list(s) used to check against will be determined by the parent league's
fp_check_method parameter (check
/howto topic:league options
for more details). If the application channel is omitted, the current channel will be used
Usage
/app scan application_channel:"optional: application channel"
Example
/app scan application_channel:#some-channel
Permission Requirements
MANAGE_APPLICATIONS, TOURNAMENT_ADMIN, LEAGUE_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
app setclan
Set the clans your team will be warring from. The clan type must be one of "main" or "secondary". Secondary clans may not be allowed for all tournaments. This command can only be executed from inside an application channel
Usage
/app setclan clan_type:"clan type" clan_tag:"clan tag"
Example
/app setclan clan_type:main clan_tag:#98VJU0RQ
Permission Requirements
NONE
Guild Tier Requirements
TOURNAMENT_SERVER
app setlanguage
Set the main language your team speaks. The language must be a valid IANA language code
Usage
/app setlanguage language:"language code"
Example
/app setlanguage language:en
Permission Requirements
NONE
Guild Tier Requirements
TOURNAMENT_SERVER
app setrep
Set a representative for your team. This command can only be executed from inside an application channel
Usage
/app setrep rep:"which rep to set" user:"@User"
Example
/app setrep rep:rep2 user:@strange.dev
Permission Requirements
NONE
Guild Tier Requirements
TOURNAMENT_SERVER
app settimezone
Set the time zone your team is based in. Time zones must be from
/tz list
Usage
/app settimezone timezone:"time zone"
Example
/app settimezone timezone:Europe/Berlin
Permission Requirements
NONE
Guild Tier Requirements
TOURNAMENT_SERVER
app show
Show your application's current status. This will print all team infos you submitted, including your preliminary roster. This command can only be executed from inside an application channel by the general public, but staff can supply a valid application channel to the optional argument from anywhere
Usage
/app show application_channel:"optional: application channel (staff only)"
Permission Requirements
NONE
Guild Tier Requirements
TOURNAMENT_SERVER
app withdraw
Withdraw your team's application. This command can only be executed from inside an application channel
Usage
/app withdraw
Permission Requirements
NONE
Guild Tier Requirements
TOURNAMENT_SERVER
The
automation-module is home to the commands to manage automated tasks for tournament admins. Automated tasks are only available to premium servers. Consider supporting us on
Patreon to unlock premium status
automation cancel
Stop the automatic repetition of a command in this channel
Usage
/automation cancel command:"command name"
Example
/automation cancel command:"ping"
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
automation list
List all currently active automation tasks
Usage
/automation list
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
automation repeat
Automatically repeat a command execution. You need to supply the full slash command invocation string including arguments and the number of hours between invocations. Arguments in the invocation string are matched case sensitively
Usage
/automation repeat command:"command invocation string" interval:"hours between repetitions"
Example
/automation repeat command:"/match standings tournament_name:Demot" interval:2
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
automation schedule
Schedule a command for execution at a given date and time. You need to supply the full slash command invocation string including arguments and a time for invocation. Arguments in the invocation string are matched case sensitively
Usage
/automation schedule command:"command invocation strint" date:"execution date in "yyyy-mm-ddThh:mm" format"
Example
/automation schedule command:"/match standings tournament_name:Demot" date:"2022-12-31T20:30"
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
automation start
Schedule a task for automated execution. Available task types are "blacklist-update", "mr-update" (as provided by
/mr update), "fp-check" (
/fp rc), "standings-update" (
/match update), "blist-sync" (
/banlist sync) and "mr-sync" (
/mr sync). Note that the identifier has to correspond to an existing ban list or master roster for the automation to work. Only available to premium guilds. Consider supporting us on
Patreon to unlock premium status
Usage
/automation start task_type:"task type" name:"identifier" output_channel:"output channel"
Example
/automation start task_type:mr-update name:Demot output_channel:#some-channel
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
automation stop
Unlist a task from automated execution. See
/help automation start
for a list of available task types
Usage
/automation stop task_type:"task type" name:"identifier"
Example
/automation stop task_type:mr-update name:Demot
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
The banlist-module provides league staff with the infrastructure to load and maintain a ban list - all the things you need to drop the hammer on the bad guys
banlist load
Load a league's ban list from a google sheet. The ban list google sheet has to be set up for this command to work. More details can be found using
/howto topic:gsheet blist
Usage
/banlist load league_name:"league name"
Example
/banlist load league_name:DEMOL
Permission Requirements
LEAGUE_ADMIN, MANAGE_BANLIST
Guild Tier Requirements
LEAGUE_SERVER
banlist reload
Reload a league's ban list from a google sheet. The ban list google sheet has to be set up for this command to work. More details can be found using
/howto topic:gsheet blist
Usage
/banlist reload league_name:"league name"
Example
/banlist reload league_name:DEMOL
Permission Requirements
LEAGUE_ADMIN, MANAGE_BANLIST
Guild Tier Requirements
LEAGUE_SERVER
banlist rm
Remove an existing ban list and it's specs from the bot. This does not delete the ban list sheet itself
Usage
/banlist rm league_name:"league name"
Example
/banlist rm league_name:DEMOL
Permission Requirements
LEAGUE_ADMIN, MANAGE_BANLIST
Guild Tier Requirements
LEAGUE_SERVER
banlist show
Show a league's ban list. A bot admin can
/subscribe
to additional leagues to make their ban lists available on the server
Usage
/banlist show league_name:"league name" ban_type:"ban type"
Example
/banlist show league_name:DEMOL ban_type:player
Permission Requirements
NONE, LEAGUE_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
banlist sync
Synchronize a ban list to Google Sheets. After this command has terminated, the google sheet will reflect the database status. The ban list Google Sheet has to be set up for this command to work. More details can be found using
/howto topic:gsheet blist
Usage
/banlist sync league_name:"league name"
Example
/banlist sync league_name:DEMOL
Cooldown
24.0 hours for each league
Permission Requirements
LEAGUE_ADMIN, MANAGE_BANLIST
Guild Tier Requirements
LEAGUE_SERVER
banlist update-blacklist
Update the blacklist for a ban list. This checks the current clans for all level 3 banned players and stores their tags for future checks against a player's clan history
Usage
/banlist update-blacklist league_name:"league name"
Example
/banlist update-blacklist league_name:DEMOL
Cooldown
24.0 hours for each league
Permission Requirements
LEAGUE_ADMIN, MANAGE_BANLIST
Guild Tier Requirements
LEAGUE_SERVER
The botstats-module offers insights into bot usage statistics and more
botstats active-servers
List the most active guilds (by commands used). The time horizon has to be of the form integer + unit, e.g. "14d" or "1y" and defaults to 7d. The limit of how many servers to return defaults to 10 if omitted
Usage
/botstats active-servers time_horizon:"time horizon" limit:"optional: limit"
Example
/botstats active-servers time_horizon:7d
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
botstats botinfo
Print general bot statistics
Usage
/botstats botinfo
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
botstats popular-commands
List the most popular commands. The time horizon has to be of the form integer + unit, e.g. "14d" or "1y". The limit of how many servers to return defaults to 10 if omitted
Usage
/botstats popular-commands time_horizon:"time horizon" limit:"optional limit"
Example
/botstats popular-commands time_horizon:7d
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
botstats usage-cmd
Plot usage stats by command. Granularities are "h" (hour, the default), "d" (day), "w" (week), "m" (month). You can optionally submit one or more command names to view usage statistics for those commands only
Usage
/botstats usage-cmd granularity:"optional: granularity" commands:"optional: command name(s)"
Example
/botstats usage-cmd granularity:d
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
The claims module allows you to connect your CoC accounts to your Discord account, unlocking additional features and statistics
claims add
Usage
/claims add player_tag:"player tag" api_token:"API token"
Example
/claims add player_tag:#2PVPRC2L8 api_token:asdfghjkl
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
claims history-tag
View all historic claims for a player
Usage
/claims history-tag player_tag:"player tag"
Example
/claims history-tag player_tag:#2PVPRC2L8
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
claims history-user
View all accounts a user has claimed at one point in time
Usage
/claims history-user user:"optional: @User"
Example
/claims history-user user:@strange.dev
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
claims request
Request a Discord user to claim an ingame account. For privacy reasons, the bot will prompt you to enter the user id in a modal dialog and then DM the user asking for confirmation, eventually linking the account to the user. This command can only be run by team reps for accounts in their team(s)
Usage
/claims request tournament_name:"tournament name" player_tag:"player tag"
Example
/claims request tournament_name:Demot player_tag:#2PP
Permission Requirements
REPRESENTATIVE, MANAGE_OWN_ROSTER
Guild Tier Requirements
PUBLIC_SERVER
claims rm
Undo the link between your Discord user and a coc account
Usage
/claims rm player_tag:"player tag"
Example
/claims rm player_tag:#2PVPRC2L8
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
claims view-tag
Display the Discord user one or more coc accounts are tied to (accounts can be claimed using
/claims add
and unclaimed using
/claims rm
)
Usage
/claims view-tag player_tags:"playertag1 playertag2 ..."
Example
/claims view-tag player_tags:#2PVPRC2L8
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
claims view-user
Display all accounts tied to a Discord user (accounts can be claimed using
/claims add
and unclaimed using
/claims rm
). If no user is provided, the user invoking the command will be used
Usage
/claims view-user user:"optional: @User"
Example
/claims view-user user:@strange.dev
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
The export-module allows you to take all of your tournament's data home or anywhere else you'd like
export applications
Export all pending tournament applications to a .csv-file to download and explore
Usage
/export applications tournament_name:"tournament name"
Example
/export applications tournament_name:Demot
Cooldown
24.0 hours for each tournament
Permission Requirements
MANAGE_APPLICATIONS, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
export attacks
Export a tournament's attacks to a .csv-file to download and explore. Optionally, you can provide a schedule name to only export attacks from matches in that week and a team code to only export attacks from matches involving that team
Usage
/export attacks tournament_name:"tournament name" schedue_name:"optional: schedule name" team_code:"optional: team short code"
Example
/export attacks tournament_name:Demot schedue_name:w1 team_code:OSD
Cooldown
24.0 hours for each tournament
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
export hr
Export the full hit rate statistics to a .csv-file to download and explore
Usage
/export hr tournament_name:"tournament name"
Example
/export hr tournament_name:Demot
Cooldown
24.0 hours for each tournament
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
export match-results
Export match results to a .csv file to download and explore. Optionally, specify a schedule name to export results for that schedule only
Usage
/export match-results tournament_name:"tournament name" schedue_name:"optional: schedule name"
Example
/export match-results tournament_name:Demot
Cooldown
24.0 hours for each tournament
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
export roster
Export a tournament's master roster to a .csv file. Optionally, you can specify a team code to export only that team's roster
Usage
/export roster tournament_name:"tournament name" team_code:"optional: team code"
Example
/export roster tournament_name:Demot
Cooldown
24.0 hours for each tournament
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
export schedule
Export the matches for a tournament to a .csv file. Optionally, specify a schedule to only export that weeks's matches
Usage
/export schedule tournament_name:"tournament name" "optional: schedule name"
Example
/export schedule tournament_name:Demot schedue_name:w1
Cooldown
24.0 hours for each tournament
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
export standings
Export a tournament's standings to a .csv-file to download and explore. Optionally, specify a group to export standings for that group only
Usage
/export standings tournament_name:"tournament name" group_name:"optional: group"
Example
/export standings tournament_name:Demot
Cooldown
24.0 hours for each tournament
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
export tournament-participants
Export all participants for a tournament to a .csv file
Usage
/export tournament-participants tournament_name:"tournament name"
Example
/export tournament-participants tournament_name:Demot
Cooldown
24.0 hours for each tournament
Permission Requirements
MANAGE_TEAMS, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
The feed-module allows you to manage live feeds to stay up to date with any tournament or league you are subscribed to. You can choose between war feeds informing you when a tournament match starts ("wars"), result feeds that will tell you the result as soon as a match is over ("results"), stream feeds that will announce whenever a content creator starts broadcasting a tournament match ("streams") and a fairplay feed that informs you about clan/player (un)bans ("fpit"). Tournament servers also have access to the "admin" and "reps" feeds to log various types of important bits of information that may require staff attention
feed add
Add a live feed to the server to stay up to date with a tournament/league to the channel this is called from (or another channel, if the optional channel argument is supplied). Available feed types are "admin", "reps" (available only to tournament servers), "fpit", "matchups", "wars", "results" and "streams". "fpit" feeds need to be used in combination with a league, the other feeds relate to tournaments. If no channel is provided, the channel this command was used from will be set up as a live feed. Use
/howto topic:livefeeds
for more information
Usage
/feed add tournament_or_league:"tournament/league name" feed_type:"feed type" output_channel:"optional: channel"
Example
/feed add tournament_or_league:Demot feed_type:results
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
feed add-error-feed
Add an error feed to the channel this is called from (or another channel, if the optional channel argument is supplied). The bot will notify you about all command crashes on your server
Usage
/feed add-error-feed output_channel:"optional: channel"
Example
/feed add-error-feed output_channel:#some-channel
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
feed list
List all currently active live feeds. If a feed type is provided, only feeds of that type will be shown. Available feed types are "admin", "reps" (available only to tournament servers), "fpit", "wars", "results" and "streams"
Usage
/feed list feed_type:"optional: feed type"
Example
/feed list feed_type:results
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
feed rm
Remove a tournament/league live feed from the server. Available feed types are "admin", "reps" (available only to tournament servers), "fpit", "wars", "results" and "streams"
Usage
/feed rm tournament_or_league:"tournament/league name" feed_type:"feed type"
Example
/feed rm tournament_or_league:Demot feed_type:results
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
feed rm-error-feed
Remove an error feed from the server
Usage
/feed rm-error-feed
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
The
fp-module allows you to check any player or clan for foul play. It offers public commands to check players and clans against one or multiple ban lists, view a player's clan history or contacts (i.e. times when two players have stayed in the same clan) between two players (powered by
clashofstats)
fp cc
Check a clan for bans/suspensions in a league. If available, historic data will be incorporated in the check. Optionally, specify the "extended" argument to run an extended check. This also runs a player check on all clan members (as
/fp pc
would do)
Usage
/fp cc league_name:"league name" clan_tag:"clan tag" extended:"optional: extended check?"
Example
/fp cc league_name:DEMOL clan_tag:#2PP
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
fp contacts
Check recent joint stays in clans for two players recorded by
clashofstats. Optionally, specify the "extended" argument to get a full list of joint stays
Usage
/fp contacts player_tag1:"player tag 1" player_tag2:"player tag 2" extended:"optional: extended check?"
Example
/fp contacts player_tag1:#2PVPRC2L8 #2PP
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
fp cscan
Check one or more (separated by whitespaces) clans against all ban lists available on this server. A bot admin can
/subscribe
to additional leagues to use their ban lists in this check
Usage
/fp cscan tags:"clantag1 clantag2 ..."
Example
/fp cscan tags:#2PP #2PPP
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
fp pc
Check one or multiple (separated by whitespaces) players for bans/suspensions in a league. If available, historic data will be incorporated in the check. Optionally, specify the "extended" argument to run an extended check
Usage
/fp pc league_name:"league name" player_tags:"playertag1 playertag2 ..." extended:"optional: extended check?"
Example
/fp pc league_name:DEMOL player_tags:#2PPRC2L8 #2PP
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
fp pch
Print a player's recent clan history as available from
clashofstats. Optionally, specify the "extended" argument to show the full clan history
Usage
/fp pch player_tag:"player tag" extended:"optional: extended check?"
Example
/fp pch player_tag:#2PPRC2L8
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
fp pscan
Check one or more (separated by whitespaces) players against all ban lists available on this server. A bot admin can
/subscribe
to additional leagues to use their ban lists in this check. This does not take the players' clan history into account
Usage
/fp pscan tags:"playertag1 playertag2 ..."
Example
/fp pscan tags:#2PVPRC2L8 #2PP
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
fp rc
Check a tournament's master roster for bans/suspensions. The ban list(s) used to check against will be determined by the parent league's
fp_check_method parameter (check
/howto topic:league options
for more details). Optionally specify a team code to only check a specific team's master roster
Usage
/fp rc tournament_name:"tournament name" team_code:"optional: team code"
Example
/fp rc tournament_name:DEMOL team_code:GD
Cooldown
24.0 hours for each tournament
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_BANLIST, MANAGE_ROSTER
Guild Tier Requirements
TOURNAMENT_SERVER
fp scan-form
Scan a signup form response for fairplay infractions. The ban list(s) used to check against will be determined by the parent league's
fp_check_method parameter (check
/howto topic:league options
for more details)
Usage
/fp scan-form tournament_name:"tournament name" response_id:"Google form response id or full URL"
Example
/fp scan-form tournament_name:Demot: response_id:https://docs.google.com/forms/d/abcdefg/edit#response=thisistheresponseid
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_BANLIST, MANAGE_ROSTER
Guild Tier Requirements
TOURNAMENT_SERVER
fp scan-pmr
Scan a preliminary roster for fairplay infractions. The ban list(s) used to check against will be determined by the parent league's
fp_check_method parameter (check
/howto topic:league options
for more details)
Usage
/fp scan-pmr tournament_name:"tournament name" sheet_id:"Google sheet id or full URL"
Example
/fp scan-pmr tournament_name:Demot sheet_id:https://docs.google.com/spreadsheets/d/thisistheactualid/view
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_BANLIST, MANAGE_ROSTER
Guild Tier Requirements
TOURNAMENT_SERVER
fp uscan
Check a Discord user against all ban lists available on this server. A bot admin can
/subscribe
to additional leagues to use their ban lists in this check. If the optional "include_accounts" parameter is set to true,
/fp pscan
will be run on all accounts claimed by the user as well
Usage
/fp uscan user:"Discord user" include_accounts:"optional: also scan claimed accounts?"
Example
/fp uscan user:strange.dev include_accounts:True
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
The gfx-module is the bot's toolbox to automatically create all sorts of fancy graphics for your tournament
gfx copy
Copy a graphics template from one tournament to another. Both tournaments must be from the server this command is executed in
Usage
/gfx copy template_type:"template type" source_tournament:"source tournament name" target_tournament:"target tournament name"
Example
/gfx copy template_type:result source_tournament:Demot target_tournament:Demot2
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
gfx edit
Update the configuration of an existing graphics template by reconfiguring the regions
Usage
/gfx edit tournament_name:"tournament name" template_type:"template type"
Example
/gfx edit tournament_name:Demot template_type:thumbnail
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
gfx font
Set the font that will be used for all bot graphics in the tournament. The font has to be provided as a .otf or .ttf file. If you don't provide a font file with this command, your previous font will be deleted and reset to the default font. You are responsible to ensure you have the necessary rights to use the font. We disclaim any liablity for unauthorized usage of fonts
Usage
/gfx font tournament_name:"tournament name" font:"optional: attached font file"
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
gfx hr
Create hitrate-related graphics. Graphics creation is only available to premium servers. Consider supporting us on
Patreon to unlock premium status
Usage
/gfx hr graphic_type:"graphic type" tournament_name:"tournament name" town_hall:"town hall level"
Example
/gfx hr graphic_type:player_hr tournament_name:Demot town_hall:16
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
gfx match
Create match-related graphics. Graphics creation is only available to premium servers. Consider supporting us on
Patreon to unlock premium status
Usage
/gfx match graphic_type:"graphic type" tournament_name:"tournament name" schedue_name:"schedule name" team_code:"short code for any team in the match"
Example
/gfx match graphic_type:result tournament_name:Demot schedue_name:w1 team_code:GD
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
gfx rm
Remove a graphics template
Usage
/gfx rm tournament_name:"tournament name" template_type:"template type"
Example
/gfx rm tournament_name:Demot template_type:thumbnail
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
gfx setup
Add a new graphics template and configure the components the bot will be placing on it. You need to supply the background image and a black and white mask of all regions you want the bot to fill with content. Template and mask must have the same dimensions. The bot will then process the mask and walk you through the individual regions' setup process. For further information, check out
/howto topic:graphics
Usage
/gfx setup tournament_name:"tournament name" template_type:"template type" template:"attached template file" mask:"attached mask file"
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
gfx stream
Create stream-related graphics optimized for all kinds of social media platforms. Graphics creation is only available to premium servers. Consider supporting us on
Patreon to unlock premium status
Usage
/gfx stream graphic_type:"graphic type" tournament_name:"tournament name" schedue_name:"schedule name" team_code:"short code for any team in the match" streamer:"streamer" platform:"platform"
Example
/gfx stream graphic_type:thumbnail tournament_name:Demot schedule_name:w1 team_code:OSD streamer:@strange.dev platform:twitch
Permission Requirements
MANAGE_MEDIA, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
gfx team
Create team-related graphics. Graphics creation is only available to premium servers. Consider supporting us on
Patreon to unlock premium status
Usage
/gfx team graphic_type:"graphic type" tournament_name:"tournament name" team_code:"team short code"
Example
/gfx team graphic_type:roster tournament_name:Demot team_code:GD
Permission Requirements
MANAGE_TEAMS, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
gfx test
Test a graphic template setup with mock data
Usage
/gfx test template_type:"template type" tournament_name:"tournament name"
Example
/gfx test template_type:result tournament_name:Demot
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
The guardian-module keeps clans safe by automatically and periodically scanning them for banned players
guardian activate
Activate the clan guardian. This feature will automatically scan the provided clan and all of its members against all ban lists available on the server once every 24 hours to help you keep your clan clean and safe
Usage
/guardian activate clan_tag:"clan tag"
Example
/guardian activate clan_tag:#2PP
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
guardian list
List all currently active clan guardians
Usage
/guardian list
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
guardian stop
Deactivates the clan guardian
Usage
/guardian stop clan_tag:"clan tag"
Example
/guardian stop clan_tag:#2PP
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
The hr-module unites everything related to hit rate statistics. It offers commands to display a tournament's best attackers and defenders as well tournament-wide hit rates and even your personal attack stats. Only attacks from tournament matches registered with /match settime will count towards these statistics
hr acc
Print attack statistics for a coc account. Optionally, provide a tournament name to only consider attacks from that tournament. By default, stored attacks from all tournaments will be used. You can also provide a start and end date to filter attacks
Usage
/hr acc player_tag:"player tag" tournament_name:"optional: tournament name" start_date:"optional: start date" end_date:"optional: end date"
Example
/hr acc player_tag:#2PVPRC2L8
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
hr roster
Print hit rates for every player on a team roster. Optionally, provide a town hall level to only output hit rates for players of that town hall. This command can only be used on a linked team server
Usage
/hr roster tournament_name:"tournament name" team_code:"team code" town_hall:"optional: town hall level"
Example
/hr roster tournament_name:Demot team_code:GD town_hall:14
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
hr team
Print attack statistics for a team. If no team code is provided, an overview of all teams will be printed
Usage
/hr team tournament_name:"tournament name" team_code:"optional: team code"
Example
/hr team tournament_name:Demot team_code:OSD
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
hr top-attackers
Print a list of a tournament's best attackers. Optionally, provide a town hall level to print an extended list of the best attackers at that town hall level
Usage
/hr top-attackers tournament_name:"tournament name" town_hall:"optional: town hall level"
Example
/hr top-attackers tournament_name:Demot
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
hr top-defenders
Print a list of a tournament's best defenders. Optionally, provide a town hall level to print an extended list of the best defenders at that town hall level
Usage
/hr top-defenders tournament_name:"tournament name" town_hall:"optional: town hall level"
Example
/hr top-defenders tournament_name:Demot
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
hr tournament
Print overall attack statistics for all players in a tournament. Optionally, provide a schedule name to limit the statistics to attacks from that particular week
Usage
/hr tournament tournament_name:"tournament name" schedule_name:"optional: schedule name"
Example
/hr tournament tournament_name:Demot schedule_name:w1
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
hr user
Print attack statistics for a Discord user. This will include attacks from all accounts that are tied to the user in question. Optionally, provide a tournament name to only consider attacks from that tournament. You can also provide a start and end date to filter attacks
Usage
/hr user user:"Discord user" tournament_name:"optional: tournament name" start_date:"optional: start date" end_date:"optional: end date"
Example
/hr user user:@strange.dev tournament_name:Demot
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
The
league-module contains the toolkit for league creation and setup and the league ban list management. Most commands are only available on league servers. Adding your own league to the bot requires whitelisting by the bot development team. Come talk to us about it on the
support serverleague addlogo
Save a league logo. The logo must be a .jpg, .jpeg or .png file
Usage
/league addlogo league_name:"league name" logo:"attached logo file"
Permission Requirements
LEAGUE_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
league ban
Add one or multiple (separated by whitespaces) players or clans to a ban list. If no end date is provided, the ban is considered permanent. If you want to submit multiple player/clan tags, separate them with whitespaces
Usage
/league ban ban_type:"ban type" league_name:"league name" tags:"player/clan tag(s)" ban_level:"ban level" reason:"reason" end_date:"optional: end date"
Example
/league ban ban_type:player league_name:DEMOL tags:#2PVPRC2L8 #2PP ban_level:3 reason:"Devs gotta get banned"
Permission Requirements
LEAGUE_ADMIN, MANAGE_BANLIST
Guild Tier Requirements
LEAGUE_SERVER
league ban-user
Add a Discord user to a ban list. If no end date is provided, the ban is considered permanent. The "include_accounts" parameter lets you choose whether to ban all accounts claimed by the user as well (defaults to true)
Usage
/league ban-user league_name:"league name" user:"Discord account" ban_level:"ban level" reason:"reason" end_date:"optional: end date" include_accounts:"optional: also ban claimed accounts?"
Example
/league ban-user league_name:DEMOL user:strange.dev ban_level:3 reason:"Devs gotta get banned"
Permission Requirements
LEAGUE_ADMIN, MANAGE_BANLIST
Guild Tier Requirements
LEAGUE_SERVER
league create
Create a new league in the bot's database. The long form is the league's full name, league_name:"league name" is the identifier that will be used for all bot commands
Usage
/league create display_name:"display name" league_name:"league name"
Example
/league create display_name:DEMOlition League league_name:DEMOL
Permission Requirements
LEAGUE_ADMIN
Guild Tier Requirements
LEAGUE_SERVER
league deactivate
Mark a league as inactive. This does not delete the league, but the league will be unavailable for any commands and referencing it will result in an "Invalid league"-error. This action can not be reversed, but data can still be accessed in coordination with the bot development team
Usage
/league deactivate league_name:"league name"
Example
/league deactivate league_name:DEMOL
Permission Requirements
LEAGUE_ADMIN
Guild Tier Requirements
LEAGUE_SERVER
league info
Print info about a league
Usage
/league info league_name:"league name"
Example
/league info league_name:DEMOL
Permission Requirements
NONE, LEAGUE_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
league lift-suspension
Lift a player's suspension in a league, making them eligible to play in the tournament again
Usage
/league lift-suspension league_name:"league name" player_tag:"player tag"
Example
/league lift-suspension league_name:DEMOL player_tag:#2PVPRC2L8
Permission Requirements
LEAGUE_ADMIN, MANAGE_BANLIST
Guild Tier Requirements
LEAGUE_SERVER
league list
Show all leagues that are available in this server. A bot admin can
/subscribe
to additional leagues to make them available on this server
Usage
/league list
Permission Requirements
NONE, LEAGUE_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
league rm
Remove an existing league and all associated data from the bot's database. This will also delete all tournaments associated with the chosen league, regardless of where they have been set up, so don't use this command lightly
Usage
/league rm league_name:"league name"
Example
/league rm league_name:DEMOL
Permission Requirements
LEAGUE_ADMIN
Guild Tier Requirements
LEAGUE_SERVER
league setup
Set a league up. For more details on options, parameters and their meaning use
/howto topic:league setup
Usage
/league setup league_name:"league name"
Example
/league setup league_name:DEMOL
Permission Requirements
LEAGUE_ADMIN
Guild Tier Requirements
LEAGUE_SERVER
league showconfig
Show the configuration for a league
Usage
/league showconfig league_name:"league name"
Example
/league showconfig league_name:DEMOL
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
league togglevisibility
Toggle a league's visibility. Hiding it will prevent it from showing up in
/league list
and
/subscribe
. Active subscriptions will not be affected by this and the league can still be used in commands. To un-hide a league, simply re-run the command
Usage
/league togglevisibility league_name:"league name"
Example
/league togglevisibility league_name:DEMOL
Permission Requirements
LEAGUE_ADMIN
Guild Tier Requirements
LEAGUE_SERVER
league unban
Remove one or multiple (separated by whitespaces) players/clans from a ban list. Submit multiple tags as multiple arguments
Usage
/league unban ban_type:"ban type" league_name:"league name" tags:"player/clantag1 player/clantag2 ..."
Example
/league unban ban_type:player league_name:DEMOL tags:#2PVPRC2L8 #2PP
Permission Requirements
LEAGUE_ADMIN, MANAGE_BANLIST
Guild Tier Requirements
LEAGUE_SERVER
league unban-user
Remove a Discord user from a ban list. The "include_accounts" parameter lets you choose whether to unban all claimed accounts as well (defaults to true)
Usage
/league unban-user league_name:"league name" user:"Discord account" include_accounts:"optional: unban all claimed accounts as well?"
Example
/league unban-user league_name:DEMOL user:strange.dev
Permission Requirements
LEAGUE_ADMIN, MANAGE_BANLIST
Guild Tier Requirements
LEAGUE_SERVER
The match-module allows the general public to follow the progress of a tournament in great detail: results, attacks and attack statistics, tournament standings - it's all there. It also has some more commands for team representatives regarding match scheduling and an entire command suite for tournament admins to manage their tournament's matches
match attacks
Show all attacks in a tournament match. Optionally, specify a player tag to only display the attacks by that player
Usage
/match attacks tournament_name:"tournament name" schedue_name:"schedule name" team_code:"short code for any team in the match" player_tag:"optional: player tag"
Example
/match attacks tournament_name:Demot schedue_name:w1 team_code:GD
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
PUBLIC_SERVER
match checklu
Check if the war lineups for a match consist of eligible players. The match has to be ongoing for this command to work
Usage
/match checklu tournament_name:"tournament name" schedue_name:"schedule name" team_code:"short code for any team in the match"
Example
/match checklu tournament_name:Demot schedue_name:w1 team_code:OSD
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
match defenses
Show all defenses for a player in a tournament match
Usage
/match defenses tournament_name:"tournament name" schedue_name:"schedule name" team_code:"short code for any team in the match" player_tag:"player tag"
Example
/match defenses tournament_name:Demot schedue_name:w1 team_code:OSD player_tag:#2PVPRC2L8
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
PUBLIC_SERVER
match forfeit
Assign a team a default loss in one or multiple tournament match(es)
Usage
/match forfeit tournament_name:"tournament name" team_code:"team code" schedule_name:"optional: schedule name" include_played:"optional: also forfeit played matches?"
Example
/match forfeit tournament_name:Demot team_code:GD schedule_name:w1
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
match info
Print detailed info about a specific tournament match
Usage
/match info tournament_name:"tournament name" schedue_name:"schedule name" team_code:"short code for any team in the match"
Example
/match info tournament_name:Demot schedue_name:w1 team_code:OSD
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
PUBLIC_SERVER
match journey
Print a team's journey through a tournament
Usage
/match journey tournament_name:"tournament name" team_code:"team code"
Example
/match journey tournament_name:Demot team_code:GD
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
PUBLIC_SERVER
match lineup
Print the team lineups for a (finished or currently ongoing) match
Usage
/match lineup tournament_name:"tournament name" schedule_name:"schedule name" team_code:"short code for any team in the match"
Example
/match lineup tournament_name:Demot w1 GD OSD
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
PUBLIC_SERVER
match loadstats
Force a load of attack data for a match. This will only work if the war in question is still available from the API
Usage
/match loadstats tournament_name:"tournament name" schedule_name:"schedule name" team_code:"short code for any team in the match"
Example
/match loadstats tournament_name:Demot schedule_name:w1 team_code:OSD
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
match participation
Print a list of all tournament matches a player has participated in
Usage
/match participation tournament_name:"tournament name" player_tag:"player tag"
Example
/match participation tournament_name:Demot player_tag:#2PVPRC2L8
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
PUBLIC_SERVER
match penalty
Apply a star and/or percentage penalty towards a team's result in a match. The stars/percentage points will be deducted from the team's result
Usage
/match penalty tournament_name:"tournament name" schedule_name:"schedule name" team_code:"short code for any team in the match" star_deduction:"optional: how many stars to deduct?" perc_deduction:"optional: how much percentage to deduct?"
Example
/match penalty tournament_name:Demot schedule_name:w1 team_cod:OSD star_deduction:2
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
match results
Print the results for all finished matches of a scheduled war week. If the schedule name is omitted, the most recent schedule will be displayed. Optionally, specify a group name to limit the output to matches from that group
Usage
/match results tournament_name:"tournament name" schedule_name:"optional: schedule name" group_name:"optional: group name"
Example
/match results tournament_name:Demot schedule_name:w1
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
PUBLIC_SERVER
match schedule
Print scheduled matches for a week of tournament play. If the schedule name is omitted, the most recent schedule will be displayed. Optionally, additional arguments can be specified to limit the output: set "today_only" to true to only display matches that take place today, specify "open_only" to only show matches without result or pass a "group_name" to only show matches from that group
Usage
/match schedule tournament_name:"tournament name" schedule_name:"optional: schedule name" today_only:"optional: today only" group_name:"optional: group name"
Example
/match schedule tournament_name:Demot schedule_name:w1
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
PUBLIC_SERVER
match setresult
Add or alter a match result. This overwrites any prior result, but it does not affect attack data
Usage
/match setresult tournament_name:"tournament name" schedule_name:"schedule name" team_code1:"team 1 short code" stars1:"stars team 1" perc1:"percentage team 1" team_code2:"team2 short code" stars2:"stars team 2" perc2:"percentage team 2" time2:"optional: average attack duration team 2" winner:"optional: short code of the winning team"
Example
/match setresult tournament_name:Demot schedule_name:w1 team_code1:GD stars1:14 perc21:98,8 team_code2:OSD stars2:11 perc2:83
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
match settime
Set a match date. Match date and time refer to the preparation day start in the server time zone
Usage
/match settime tournament_name:"tournament name" schedule_name:"schedule name" team_code:"short code for any team in the match" prep_start:"prep date and time in yyyy-mm-ddThh:mm-format" prep_duration:"preparation day duration"
Example
/match settime tournament_name:Demot schedule_name:w1 team_code:GD prep_start:2021-10-17T19:00 prep_duration:5m
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES, MANAGE_NEGOTIATIONS, MANAGE_OWN_MATCHES, REPRESENTATIVE
Guild Tier Requirements
TOURNAMENT_SERVER
match standings
Print standings for a tournament. Optionally, specify a group to print standings for that group only
Usage
/match standings tournament_name:"tournament name" group_name:"optional group"
Example
/match standings tournament_name:Demot
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
PUBLIC_SERVER
match stats
Display the current standing and attack statistics for an ongoing tournament match. If the match is over, this will display the final result and statistics instead (if available from the database). If the schedule name is omitted, the most recent schedule will be used. If no team code is provided, all matches of the chosen schedule will be shown
Usage
/match stats tournament_name:"tournament name" schedule_name:"optional: schedule name" team_code:"optional: short code for any team in the match"
Example
/match stats tournament_name:Demot schedule_name:w1 team_code:OSD
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
PUBLIC_SERVER
match tiebreaker
Schedule a tie breaker for a drawn match. Match date and time refer to the preparation day start in the server time zone
Usage
/match tiebreaker tournament_name:"tournament name" schedule_name:"schedule name" team_code:"short code for any team in the match" prep_start:"prep date and time in yyyy-mm-ddThh:mm-format" prep_duration:"preparation day duration"
Example
/match tiebreaker tournament_name:Demot schedule_name:w1 team_code:GD 2021-10-17T19:00 prep_duration:5m
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES, MANAGE_NEGOTIATIONS, MANAGE_OWN_MATCHES, REPRESENTATIVE
Guild Tier Requirements
TOURNAMENT_SERVER
match update
Check the SC API for updates on tournament match results. If a schedule identifier is provided, only that week's matches will be polled
Usage
/match update tournament_name:"tournament name" schedule_name:"optional: schedule name"
Example
/match update tournament_name:Demot schedule_name:w1
Cooldown
24.0 hours for each tournament
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
match voidattack
Void one or all attacks by a player in a match (if you omit the optional defender tag, all attacks will be voided). By default, this will also update the match result if the player had the best attack on an enemy base. You can use the optional "update_result" parameter to prevent the update if you already placed custom sanctions
Usage
/match voidattack tournament_name:"tournament name" schedule_name:"schedule name" team_code:"short code for any team in the match" attacker_tag:"ingame tag of the attacker" defender_tag:"optional: ingame tag of the defender" update_result:"optional: change the result as well?" push_to_feeds:"push new result to live feeds?"
Example
/match voidattack tournament_name:Demot schedule_name:w1 team_code:GD attacker_tag:#2PP push_to_feeds:True
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
The
mb-module is the bot's
Minion Bot integration. It is able to generate most of the codelines needed to set up and manage a tournament with Minion bot. Note that the bot cannot create the Minion Bot tournament itself, that needs to be done by Minion Bot support staff
mb clans
Generate Minion Bot codelines to set up main and shell clans for a tournament
Usage
/mb clans tournament_name:"tournament name"
Example
/mb clans tournament_name:Demot
Permission Requirements
MANAGE_WM, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
mb matches
Generate Minion Bot codelines to set up matches for a week of tournament play
Usage
/mb matches tournament_name:"tournament name" schedule_name:"schedule name"
Example
/mb matches tournament_name:Demot
Permission Requirements
MANAGE_WM, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
The media-module contains all commands related to content creation. It has tools for the creators to update their profiles and claim matches, commands for tournament staff to manage their content creators and commands for the public to view content creators and live streams
media addcreator
Self-service registration for content creators. The provided platform should indicate the creator's primary media outlet, the language must be a valid IANA language code
Usage
/media addcreator display_name:"creator name" user:"Discord user" platform:"platform" url:"channel link" language:"language code"
Example
/media addcreator display_name:strange_plays user:@strange.dev platform:twitch url:https://twitch.tv/strangeplays language:de
Permission Requirements
STREAMER
Guild Tier Requirements
TOURNAMENT_SERVER
media addlogo
Save a logo for a content creator. Only registered content creators may use this. The logo must be a .jpg, .jpeg or .png file
Usage
/media addlogo logo:"attached logo file"
Permission Requirements
STREAMER
Guild Tier Requirements
TOURNAMENT_SERVER
media addplatform
Add an additional platform for a content creator. Supported platforms are "youtube", "twitch", "facebook", "twitter", "discord", "douyu", "huya" and "bilibili". Only registered content creators may use this
Usage
/media addplatform platform:"platform" url:"channel url"
Example
/media addplatform platform:youtube url:youtube.com/c/strangeplays
Permission Requirements
STREAMER
Guild Tier Requirements
TOURNAMENT_SERVER
media associate
Associate a content creator with a tournament
Usage
/media associate tournament_name:"tournament name" target:"@[Role or User]"
Example
/media associate tournament_name:Demot target:@strange.dev
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MEDIA
Guild Tier Requirements
TOURNAMENT_SERVER
media claim
Lay a streaming claim on a tournament match. If the team code is omitted, the bot will bring up a list of all available matches. Only content creators associated with the tournament may use this
Usage
/media claim tournament_name:"tournament name" schedule_name:"schedule name" team_code:"optional: short code for any team in the match" platform:"optional: the platform to use for graphics"
Example
/media claim tournament_name:Demot schedule_name:w1 team_code:OSD
Permission Requirements
STREAMER
Guild Tier Requirements
TOURNAMENT_SERVER
media copy-associations
Copy the media associations from one tournament to another This will completely erase the target tournament's creator associations and replace them with the creators associated to the source tournament
Usage
/media copy-associations source_tournament:"source tournament name" target_tournament:"target tournament name"
Example
/media copy-associations source_tournament:Demot target_tournament:Demot2
Permission Requirements
Guild Tier Requirements
TOURNAMENT_SERVER
media deletecreator
Self-service deletion for content creators. This will irreversibly delete all information about you and your platforms from the bot database
Usage
/media deletecreator
Permission Requirements
STREAMER
Guild Tier Requirements
TOURNAMENT_SERVER
media dissociate
Revoke an association between a content creator and a tournament
Usage
/media dissociate tournament_name:"tournament name" user:"@User"
Example
/media dissociate tournament_name:Demot user:@strange.dev
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MEDIA
Guild Tier Requirements
TOURNAMENT_SERVER
media info
Print info on a content creator. The creator id can be a discord identifier or the name the creator is registered with
Usage
/media info identifier:"creator id"
Example
/media info identifier:strange_plays
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
media listcreators
List all content creators associated with a tournament. Optionally, submit a language code to filter the output
Usage
/media listcreators tournament_name:"tournament name" language:"optional: creator language"
Example
/media listcreators tournament_name:Demot language:en
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
media rmplatform
Remove a platform for a content creator. Supported platforms are "youtube", "twitch", "facebook", "twitter", "discord", "douyu", "huya" and "bilibili". Only registered content creators may use this
Usage
/media rmplatform platform:"platform"
Example
/media rmplatform platform:youtube
Permission Requirements
STREAMER
Guild Tier Requirements
TOURNAMENT_SERVER
media schedulestream
Change the scheduled start time for a stream. Only content creators associated with the tournament may use this for matches on which they hold a claim. Date and time are interpreted in the server time zone
Usage
/media schedulestream tournament_name:"tournament name" schedule_name:"schedule name" team_code:"short code for any team in the match" start_date:"time in "yyyy-mm-ddThh:mm"-format"
Example
/media schedulestream tournament_name:Demot schedule_name:w1 team_code:GD start_date:2021-10-17T20:30
Permission Requirements
STREAMER
Guild Tier Requirements
TOURNAMENT_SERVER
media streams
List all streams for a week of tournament play. If the schedule name is omitted, the most recent schedule will be displayed. Optionally, supply a team code, a content creator language or the upcoming_only argument to filter the output
Usage
/media streams tournament_name:"tournament name" schedule_name:"optional: schedule name" team_code:"optional: team code" language:"broadcaster language" upcoming_only:"optional: future streams only?"
Example
/media streams tournament_name:Demot w1
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
media summary
Print a summary of streaming statistics for a given tournament
Usage
/media summary tournament_name:"tournament name"
Example
/media summary tournament_name:Demot
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
media togglestreams
Lock/unlock a match to prevent content creators from claiming it/allow them to claim it again. You can omit the team code to toggle all matches of a week
Usage
/media togglestreams tournament_name:"tournament name" schedule_name:"schedule name" team_code:"optional: team code"
Example
/media togglestreams tournament_name:Demot schedule_name:w1
Permission Requirements
MANAGE_MEDIA
Guild Tier Requirements
TOURNAMENT_SERVER
media unclaim
Remove a streaming claim from a tournament match. If the team code is omitted, the bot will bring up a list of all available matches. Only registered content creators may use this for matches on which they hold a claim
Usage
/media unclaim tournament_name:"tournament name" schedule_name:"schedule name" team_code:"short code for any team in the match"
Example
/media unclaim tournament_name:Demot schedule_name:w1 team_code:OSD
Permission Requirements
STREAMER
Guild Tier Requirements
TOURNAMENT_SERVER
media verifyaccounts
Print a list of all streamers that have claimed a match and a list of their ingame accounts
Usage
/media verifyaccounts tournament_name:"tournament name" schedule_name:"schedule name" team_code:"short code for any team in the match"
Example
/media verifyaccounts tournament_name:Demot schedule_name:w1 team_code:OSD
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
The mr-module offers commands for league admins to manage master rosters. It contains commands to bulk load a team roster from a preliminary roster or delete it entirely and update player metadata based on SC-API data
mr claims
Show all claims on a team's master roster
Usage
/mr claims tournament_name:"tournament name" team_code:"team code"
Example
/mr claims tournament_name:Demot team_code:OSD
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_ROSTER
Guild Tier Requirements
TOURNAMENT_SERVER
mr load-form
Create a new team for a tournament and load that team's roster. Requires the signup form to be set up. The team code parameter chosen with this command will be used for all actions concerning the team for the duration of the entire tournament. Team codes must be alphanumeric and at most 8 characters long. More details can be found by using
/howto topic:tournament setup
Usage
/mr load-form tournament_name:"tournament name" team_code:"team code" response_id:"Google form response id or full URL" add_reproles:"optional: give out rep roles as well?"
Example
/mr load-form tournament_name:Demot team_code:OSD response_id:https://docs.google.com/forms/d/abcdefg/edit#response=thisistheresponseid
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_ROSTER
Guild Tier Requirements
TOURNAMENT_SERVER
mr load-sheet
Create a new team for a tournament and load that team's roster. Requires the preliminary master roster gsheet to be set up. The team code parameter chosen with this command will be used for all actions concerning the team for the duration of the entire tournament. Team codes must be alphanumeric and at most 8 characters long. More details can be found by using
/howto topic:tournament setup
Usage
/mr load-sheet tournament_name:"tournament name" team_code:"team code" sheet_id:"google sheet id or full URL" add_reproles:"optional: give out rep roles as well?"
Example
/mr load-sheet tournament_name:Demot team_code:OSD sheet_id:https://docs.google.com/spreadsheets/d/thisistheactualid/view
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_ROSTER
Guild Tier Requirements
TOURNAMENT_SERVER
mr rm
Delete an existing roster from the bot. If a team code is supplied, delete that team's roster, otherwise delete all tournament rosters. This does not delete the roster sheet
Usage
/mr rm tournament_name:"tournament name" team_code:"optional: team code"
Example
/mr rm tournament_name:Demot team_code:GD
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_ROSTER
Guild Tier Requirements
TOURNAMENT_SERVER
mr sync
Synchronize a tournament's master roster, the team overview and transaction overview to google sheets. After the command has completed, the google sheet will reflect the database status. The master roster gsheet needs to be set up for this command to work. Use
/howto topic:gsheet mr
for more information
Usage
/mr sync tournament_name:"tournament name"
Example
/mr sync tournament_name:Demot
Cooldown
24.0 hours for each tournament
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_ROSTER
Guild Tier Requirements
TOURNAMENT_SERVER
mr update
Update a master roster with regard to hero levels and name changes. Optionally provide a team code to update only one team
Usage
/mr update tournament_name:"tournament name" team_code:"optional: team code"
Example
/mr update tournament_name:Demot team_code:GD
Cooldown
24.0 hours for each tournament
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_ROSTER
Guild Tier Requirements
TOURNAMENT_SERVER
The perm-module is the tool to view, grant and revoke permissions. Permissions are granted based on resource groups and are valid on a per-server basis. Server administrators automatically have bot admin status as well. Check /howto topic:permissions for more information
perm access
List all commands a resource group has access to
Usage
/perm access resource_group:"resource group"
Example
/perm access resource_group:MANAGE_ROSTER
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
perm add
Grant a user or role access to a resource group (and the commands connected to it) on this server. Use
/perm groups
for a list of resource groups and
/howto topic:permissions
for more information
Usage
/perm add target:"@[Role or User]" resource_group:"resource group"
Example
/perm add target:"@Senior Admin" resource_group:TOURNAMENT_ADMIN
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
perm cleanup
Remove permissions for all invalid users and roles
Usage
/perm cleanup
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
perm groups
List all available resource groups. Use
/howto topic:permissions
for more information
Usage
/perm groups
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
perm list
Lists a user's or role's resource groups in this server. Use
/howto topic:permissions
for more information
Usage
/perm list target:"@[Role or User]"
Example
/perm list target:@strange.dev
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
perm requirements
List all resource groups that have access to a command. If a user or role has any of the listed resource groups, they can use the command
Usage
/perm requirements command_name:"command name"
Example
/perm requirements command_name:"match stats"
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
perm revoke
Revoke a user's or role's access to a resource group on this server. Use
/perm groups for a list of resource groups and
/howto topic:permissions
for more information
Usage
/perm revoke target:"@[Role or User]" resource_group:"resource group"
Example
/perm revoke target:"@Nego Team" resource_group:MANAGE_NEGOTIATIONS
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
The schedule-module is home to the toolkit for tournament staff to manage their schedule and determine who is playing who and when
schedule addmatch
Add one or multiple new matches to a tournament schedule. Each pair of consecutive team codes will be interpreted as a match. Teams can have at most one match per schedule
Usage
/schedule addmatch tournament_name:"tournament name" schedue_name:"schedule name" team_codes:"team 1 short code team2 short code team 3 short code team 4 short code ..."
Example
/schedule addmatch tournament_name:Demot schedue_name:w1 team_codes:GD OSD
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
schedule copy
Copy one or more schedules from one tournament to another. This will only copy the schedules themselves, not their matches. If no schedule name is provided, all schedules will be copied
Usage
/schedule copy source_tournament:"source tournament name" target_tournament:"target tournament name" schedue_name:"optional: schedule name"
Example
/schedule copy source_tournament:Demot target_tournament:Demot2
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
schedule create
Add a new schedule to a tournament. Available play types are "bye", "groups", "playoffs". Date and time are interpreted in the server timezone. If you supply the optional default time, all matches in this schedule will be set to start at that time and only staff can specify different match times
Usage
/schedule create tournament_name:"tournament name" schedue_name:"schedule name" display_name:"display name" start_date:"start date in yyyy-mm-ddThh:mm format" end_date:"end date in yyyy-mm-ddThh:mm format" play_type:"play type" default_time:"optional: default battle day start time in yyyy-mm-ddThh:mm format"
Example
/schedule create tournament_name:Demot schedule_name:w1 display_name:"Week 1" start_date:2021-10-16T00:00 end_date:2021-10-22T23:59 play_type:groups
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
schedule delmatch
Delete a match and all associated data from the bot's database
Usage
/schedule delmatch tournament_name:"tournament name" schedue_name:"schedule name" team_code:"short code for any team in the match"
Example
/schedule delmatch tournament_name:Demot schedue_name:w1 team_code:GD
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
schedule load
Initialize matches for a tournament by parsing the schedule sheet to the database. This requires the schedule sheet to be set up. More details can be found by using
/howto topic:gsheet sched
. The team identifier declares how the teams will be identified in the sheet: "name" for team names, "clan" for (main) clan names, "code" for team codes. The identifiers in the sheet must be spelled exactly like they are in the database, or the bot can't make a connection between the teams
Usage
/schedule load tournament_name:"tournament name" "team identifier"
Example
/schedule load tournament_name:Demot team_identifier:name
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
schedule makebrackets
Create playoff brackets for a tournament. Available bracket types are "single" for single elimination and "double" for double elimination brackets. You have two choices on the bracket initialisation: if you provide a number n (must be a power of two for double elimination brackets), the bot will create a bracket featuring the top n teams. The top teams will be determined based on the standings in the bot's databas according to the standing criteria chosen when the tournament was set up, so make sure all of that information is up to date. Alternatively, you can manually create a first round of playoffs (e.g. to include some wildcard teams. The number of matches in this round must be a power of two for double elimination brackets) and submit the schedule name. The bot will then build the playoffs based off of this round. Once built, the bot will automatically populate the matches for upcoming rounds as matches in the previous round are played, no further setup is required. For single elimination brackets, you can optionally specify the "rounds" parameter to instruct the bot to generate a partial bracket that ends after that many rounds
Usage
/schedule makebrackets tournament_name:"tournament name" bracket_type:"bracket type" bracket_initialisation:"bracket initialisation" start_date:"start date in yyyy-mm-ddThh:mm format" rounds:"optional: number of rounds"
Example
/schedule makebrackets Demot bracket_type:single bracket_initialisation:8 start_date:2020-01-31T00:00
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
schedule makegroupstage
Generate schedules and matches for a tournament's group stage. If all teams are assigned to a group and the number of requested matches per team is smaller than the number of teams in all groups, matches will be created between teams of the same group, otherwise teams will be matched across groups. The number of matches can be omitted if all teams are assigned to a group. In that case, all possible matches within the groups will be created
Usage
/schedule makegroupstage tournament_name:"tournament name" start_date:"start date in yyyy-mm-ddThh:mm format" schedule_in_days:"schedule duration in days" matches_per_team:"optional number of matches per team"
Example
/schedule makegroupstage Demot start_date:2020-01-31T00:00 schedule_in_days:7 matches_per_team:4
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
schedule makeswissround
Create the next round of a Swiss-style tournament following the Monrad system. This command creates the schedule and populates it with matches. If the optional "allow_repeat_matches" parameter is set to true, the bot will still attempt to create non-repeat matches first, but will fall back to repeating matchups if that fails
Usage
/schedule makeswissround tournament_name:"tournament name" schedule_name:"schedule name" display_name:"display name" start_date:"start date in yyyy-mm-ddThh:mm format" end_date:"end date in yyyy-mm-ddThh:mm format" default_time:"optional: default battle day start time in yyyy-mm-ddThh:mm format" allow_repeat_matches:"optional: allow repeated matches between teams?"
Example
/schedule makeswissround tournament_name:Demot schedule_name:w4 display_name:"Week 4" start_date:2021-10-16T00:00 end_date:2021-10-22T23:59
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
schedule rm
Remove a tournament schedule and all associated matches from the database. This does not delete the schedule sheet itself
Usage
/schedule rm tournament_name:"tournament name" schedule_name:"optional schedule name"
Example
/schedule rm tournament_name:Demot schedule_name:w1
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
schedule setup
Update a schedule. You can update the "start_date", "end_date", "default_time", "name" (display name), "code" (short code used in commands) and "play_type" parameters of a schedule. If you set up a default time, all matches in this schedule will be set to start at that time and only staff can specify different match times. This will not affect already scheduled matches
Usage
/schedule setup tournament_name:"tournament name" schedule_name:"schedule name" parameter:"parameter name" value:"optional: new value"
Example
/schedule setup tournament_name:Demot schedule_name:w1 parameter:start_date value:2020-01-31T00:00
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
schedule showbrackets
Output the tournament's playoff stage as an image. This command can only be for brackets created with the
/match makebrackets
command
Usage
/schedule showbrackets tournament_name:"tournament name"
Example
/schedule showbrackets tournament_name:Demot
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
The team-module is all about team management and comes with a toolkit to view and manage team aspects for both the team representatives as well as tournament staff
team addlogo
Save a team logo. The logo must be a .jpg, .jpeg or .png file
Usage
/team addlogo tournament_name:"tournament name" team_code:"team code" logo:"attached logo file"
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_TEAMS, MANAGE_OWN_TEAM, REPRESENTATIVE
Guild Tier Requirements
TOURNAMENT_SERVER
team addmedia
Add a media account for a team. Supported platforms are "discord", "instagram", "twitch", "youtube", "twitter", "website". "account name" is what will be shown to users, choose anything that is descriptive
Usage
/team addmedia tournament_name:"tournament name" team_code:"team code" platform:"platform" account_name:"account name" url:"account link"
Example
/team addmedia tournament_name:Demot team_code:OSD platform:Discord account_name:"Support Server" url:https://discord.gg/qpUsKaT3pK
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_TEAMS, MANAGE_OWN_TEAM, REPRESENTATIVE
Guild Tier Requirements
TOURNAMENT_SERVER
team addplayers
Add one or multiple (separated by whitespaces) players to a team's master roster. This addition will not show as a transaction
Usage
/team addplayers tournament_name:"tournament name" team_code:"team code" player_tags:"playertag1 playertag2 ..."
Example
/team addplayers tournament_name:Demot team_code:OSD player_tags:#2PVPRC2L8 #2PP
Permission Requirements
MANAGE_TEAMS, LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_ROSTER
Guild Tier Requirements
TOURNAMENT_SERVER
team clear-warnings
Clear one specific or all warnings for a team. If an ID is passed, that warning will be deleted, if the ID is omitted, all warnings will be cleared
Usage
/team clear-warnings tournament_name:"tournament name" team_code:"team code" warning_id:"optional: warning ID"
Example
/team clear-warnings tournament_name:Demot team_code:GD
Permission Requirements
MANAGE_TEAMS, MANAGE_NEGOTIATIONS, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
team create
Create a new team for a tournament. The team code parameter chosen with this command will be used for all actions concerning the team for the duration of the entire tournament. Team codes must be alphanumeric and at most 8 characters long
Usage
/team create tournament_name:"tournament name" team_code:"team code" team_name:"team name" clan_tag:"(main) clan tag" rep1:"Discord id rep 1" rep2:"optional Discord id rep 2" add_reproles:"optional: give out rep roles as well?"
Example
/team create tournament_name:Demot team_code:OSD team_name:"One strange Dev" clan_tag:#2PP rep1:@strange.dev"
Permission Requirements
MANAGE_TEAMS, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
team edit-warning
Update a warning for a team. The provided reason will overwrite the existing one, but the original timestamp will remain
Usage
/team edit-warning tournament_name:"tournament name" team_code:"team code" warning_id:"warning ID" reason: "warning reason"
Example
/team edit-warning tournament_name:Demot team_code:OSD warning_id:3 reason: "Being even meaner to the bot"
Permission Requirements
MANAGE_TEAMS, MANAGE_NEGOTIATIONS, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
team eliminate
Mark a team as eliminated in a tournament. Eliminated teams will remain associated to the tournament, keeping their match history, roster and info visible. The team will also be available to use in commands. It will however not be considered for the creation of future matches and hidden from stats, standings and the team overview. Exactly one of team_code and schedule_name must be provided. Providing the schedule code will result in the elimination of all teams that lost during that round
Usage
/team eliminate tournament_name:"tournament name" team_code:"optional: team code" schedue_name:"optional: schedule name"
Example
team eliminate tournament_name:Demot team_code:OSD
Permission Requirements
MANAGE_TEAMS, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
team info
Show team info for a given team. This will print the representatives, a link to their registered clan(s) as well as a team logo and team media where available. In order for this command to also function as a team search tool, it will also respond to the full team name or the registered clan tag instead of the team code. If the team identifier is omitted, the bot will bring up a list of all teams for you to choose from
Usage
/team info tournament_name:"tournament name" team_identifier:"optional: team short code/clantag/name"
Example
/team info tournament_name:Demot team_identifier:GD
Permission Requirements
NONE, MANAGE_TEAMS, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
team linkserver
Link a Discord server to a team. This will unlock the participant features in the
teamorg
module for that server and team. If no guild ID is provided, the current server will be used
Usage
/team linkserver tournament_name:"tournament name" team_code:"team code" guild_id:"optional: server ID"
Example
/team linkserver tournament_name:Demot team_code:GD guild_id:123456
Permission Requirements
NONE, MANAGE_TEAMS, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
team mr
Show a team's master roster. Provide a town hall level (as an integer) to restrict the output to a certain town hall
Usage
/team mr tournament_name:"tournament name" team_code:"team code" th_level:"optional: townhall-level"
Example
/team mr tournament_name:Demot team_code:GD
Permission Requirements
NONE, MANAGE_TEAMS, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
team reinstate
Reinstate an eliminated team in a tournament
Usage
/team reinstate tournament_name:"tournament name" team_code:"team code"
Example
/team reinstate tournament_name:Demot team_code:GD
Permission Requirements
MANAGE_TEAMS, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
team rm
Remove a team from a tournament. This action is irreversible, so don't use this command lightly
Usage
/team rm tournament_name:"tournament name" team_code:"team code"
Example
/team rm tournament_name:Demot team_code:GD
Permission Requirements
MANAGE_TEAMS, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
team rmplayers
Remove one or multiple (separated by whitespaces) players from a team's master roster. This removal will not show as a transaction
Usage
/team rmplayers tournament_name:"tournament name" team_code:"team code" player_tags:"playertag1 playertag2 ..."
Example
/team rmplayers tournament_name:Demot team_code:OSD player_tags:#2PVPRC2L8 #2PP
Permission Requirements
MANAGE_TEAMS, LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_ROSTER
Guild Tier Requirements
TOURNAMENT_SERVER
team search
Search for teams having one or more of the following parameters: "rep" will match either of the team representatives, "clan_tag" will match either of the team's clans and "player_tag" will match any player on a team's roster. You have to supply at least one of these three parameters, and if multiple are provided, all of them must match for a team to be returned. If you pass the optional "tournament_name", only teams from that tournament will be searched, otherwise all tournaments on your server will be queried
Usage
/team search tournament_name:"optional: tournament name" rep:"optional: @User" clan_tag:"optional: clan tag" player_tag:"optional: player tag"
Example
/team search tournament_name:Demot rep:@strange.dev
Permission Requirements
NONE, MANAGE_TEAMS, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
team setup
Set a team up. Possible parameters are "main_clan", "secondary_clan", "rep1", "rep2", "name", "code", "timezone" and "language". Omitting the value will delete the corresponding property instead of updating it
Usage
/team setup tournament_name:"tournament name" team_code:"team code" parameter:"parameter" value:"optional: value"
Example
/team setup tournament_name:Demot team_code:OSD parameter:rep1 value:1234567
Permission Requirements
MANAGE_TEAMS, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
team warn
Give a warning to a team. The bot will inform the team representatives of the warning and store it for future reference through
/team warnings
Usage
/team warn tournament_name:"tournament name" team_code:"team code" reason: "warning reason"
Example
/team warn tournament_name:Demot team_code:GD reason:"Being mean to the bot"
Permission Requirements
MANAGE_TEAMS, MANAGE_NEGOTIATIONS, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
team warnings
Output a list of all warnings a team have received
Usage
/team warnings tournament_name:"tournament name" team_code:"team code"
Example
/team warnings tournament_name:Demot team_code:OSD
Permission Requirements
MANAGE_TEAMS, MANAGE_NEGOTIATIONS, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
The teamorg-module contains tools designed to help tournament participants organize their matches. They can only be used on a server linked to a team with /team linkserver
teamorg attacks
Print a list of all players that have remaining attacks in an ongoing tournament match
Usage
/teamorg attacks tournament_name:"tournament name" schedue_name:"schedule name" team_code:"team code"
Example
/teamorg attacks tournament_name:Demot schedue_name:w1 team_code:OSD
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
teamorg availability
Create a survey to check your team's availability for a match
Usage
/teamorg availability tournament_name:"tournament name" schedue_name:"schedule name" team_code:"team code"
Example
/teamorg availability tournament_name:Demot schedue_name:w1 team_code:OSD
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
teamorg chooselineup
Select a lineup from all players that have signed up for a match. This command can only be used in a match signup channel
Usage
/teamorg chooselineup is_in:"will the account(s) play?"
Example
/teamorg chooselineup is_in:True
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
teamorg createsignupchannel
Create a channel where your team can sign up for a tournament match
Usage
/teamorg createsignupchannel tournament_name:"tournament name" schedue_name:"schedule name" team_code:"team code"
Example
/teamorg createsignupchannel tournament_name:Demot schedue_name:w1 team_code:OSD
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
teamorg missing
Check which players are still missing from the match clan. If no schedule name is provided, this will check all players on the master roster, otherwise, the check will be run against the players signed up for that week's match
Usage
/teamorg missing tournament_name:"tournament name" team_code:"team code" clan_type:"clan type" schedule_name:"optional: schedule name"
Example
/teamorg missing tournament_name:Demot team_code:GD clan_type:main
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
teamorg setparticipantrole
Configure the role for your team members. Using the optional add_roles parameter, you can choose to have the bot distribute the participant role to all users that have claimed accounts on your team's roster
Usage
/teamorg setparticipantrole tournament_name:"tournament name" team_code:"team code" role:"@Role" add_roles:"optional: give role to participants?"
Example
/teamorg setparticipantrole tournament_name:Demot team_code:OSD role:@Demot-Participant
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
teamorg setupdatechannel
Configure the channel for automated updates for your team
Usage
/teamorg setupdatechannel tournament_name:"tournament name" team_code:"team code" channel:"#Channel"
Example
/teamorg setupdatechannel tournament_name:Demot team_code:OSD channel:#tournament-updates
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
teamorg showlineup
Show the selected lineup for a match. This command can only be used in a match signup channel
Usage
/teamorg showlineup
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
teamorg showsignups
Show all accounts that are currently signed up for a match. This command can only be used in a match signup channel
Usage
/teamorg showsignups
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
teamorg signup
Sign your accounts in or out of a match. If the player tag is omitted, the bot will bring up a select menu of all your claimed accounts on the roster. Team reps and bot admins can sign up/out on behalf of others. This command can only be used in a match signup channel
Usage
/teamorg signup is_in:"is the account in?" player_tag:"optional: player tag"
Example
/teamorg signup is_in:True player_tag:#2PVPRC2L8
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
teamorg unresponsive
Show a list of all accounts that have not responded to a match signup. This command can only be used in a match signup channel
Usage
/teamorg unresponsive
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
teamorg unrostered
Show a list of all members of the chosen clan that are not on the provided team's roster
Usage
/teamorg unrostered tournament_name:"tournament name" team_code:"team code" clan_type:"clan type"
Example
/teamorg unrostered tournament_name:Demot team_code:OSD clan_type:main
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
The
tournament-module is your toolkit to create and manage tournaments. Most commands are only available to tournament servers. Creating your own tournaments with the bot requires whitelisting by the bot development team. Come talk to us about it on the
support servertournament addgroup
Create a group and add teams to it. Group names can be up to 8 characters long
Usage
/tournament addgroup tournament_name:"tournament name" group_name:"group name" team_codes:"team code 1 team code 2 ..."
Example
/tournament addgroup tournament_name:Demot group_name:GrpA team_codes:OSD GD
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
tournament addlogo
Save a tournament logo. The logo must be a .jpg, .jpeg or .png file
Usage
/tournament addlogo tournament_name:"tournament name" logo:"attached logo file"
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
tournament calendar
Print a tournament's match calendar with all schedules
Usage
/tournament calendar tournament_name:"tournament name"
Example
/tournament calendar tournament_name:Demot
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
tournament copy-setup
Copy the tournament setup from one tournament to another. This will completely wipe the target tournament's parameters and replace them with the source tournament's configuration. Be aware that no validation of the target tournament against the new parameters will be performed. Therefore, this command is not recommended to be used mid-season
Usage
/tournament copy-setup source_tournament:"source tournament name" target_tournament:"target tournament name"
Example
/tournament copy-setup source_tournament:Demot target_tournament:Demot2
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
tournament create
Create a new tournament in the bot's database. The display name will be for display purposes only, the tournament name is what will be used in all commands. The league name refers to the tournament's parent league. The transaction channel will be where the bot logs all transaction requests. The rep role is the role that will be given to all team representatives of the tournament
Usage
/tournament create display_name:"display name" tournament_name:"tournament abbreviation" league_name:"league name" season:"season number" transaction_log_channel:"transaction output channel" rep_role:"rep role"
Example
/tournament create display_name:"DEMOlition Tournament" tournament_name:Demot league_name:DEMOL season:1 transaction_log_channel:#channel-name rep_role:@Rep-Role
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
tournament createchannels
Create negotiation channels for a week of tournament play. These channels will be visible to the representatives of both teams and negotiation staff
Usage
/tournament createchannels tournament_name:"tournament name" schedue_name:"schedule name"
Example
/tournament createchannels tournament_name:Demot schedule_name:w1
Permission Requirements
MANAGE_NEGOTIATIONS, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
tournament deactivate
Mark a tournament as inactive. This does not delete the tournament, but it will free up the name for re-use. The tournament will be unavailable for any commands and referencing it will result in an "Invalid tournament"-error. This action can not be reversed, but data can still be accessed in coordination with the bot development team
Usage
/tournament deactivate tournament_name:"tournament name"
Example
/tournament deactivate tournament_name:Demot
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
tournament deletechannels
Delete negotiation channels for all finished matches for a week of tournament play (regardless of channel location). Optionally, set "finished_only" to False to also delete channels for ongoing matches. You may also supply a team code to only delete a single negotiation channel
Usage
/tournament deletechannels tournament_name:"tournament name" schedue_name:"schedule name" finished_only:"optional: only finished matches?" team_code:"optional: team code"
Example
/tournament deletechannels tournament_name:Demot schedule_name:w1
Permission Requirements
MANAGE_NEGOTIATIONS, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
tournament draw
Randomly and evenly distributed assign teams to a number of groups. By setting the optional "by_timezone" argument to true, you can instruct the bot to group teams based on their indicated time zones
Usage
/tournament draw tournament_name:"tournament name" groups:"number of groups" by_timezone:"optional: create groups by time zones?"
Example
/tournament draw tournament_name:Demot groups:4
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
tournament duals
Print a list of all dual players (Discord user with accounts in multiple teams) in a tournament. If the optional include_same_team parameter is set to True, the bot will also flag same-team duals, i.e. users with multiple accounts on a single roster
Usage
/tournament duals tournament_name:"tournament name" include_same_team:"optional: also flag same-team duals?"
Example
/tournament duals tournament_name:Demot
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_ROSTER
Guild Tier Requirements
TOURNAMENT_SERVER
tournament groups
Show all groups in a tournament
Usage
/tournament groups tournament_name:"tournament name"
Example
/tournament groups tournament_name:Demot
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
tournament info
Print info about a tournament
Usage
/tournament info tournament_name:"tournament name"
Example
/tournament info tournament_name:Demot
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
tournament list
Show all active tournaments that are available in this server. A bot admin can
/subscribe
to additional tournaments to make them available on the server
Usage
/tournament list
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
tournament newseason
Create a new season for an existing tournament. This deactivates the existing tournament and creates a new one with the same name, setup and content creator associations. The only exceptions are the mr, pmr and schedule sheet IDs, the setup parameters for the sheets are copied over, however
Usage
/tournament newseason tournament_name:"tournament name"
Example
/tournament newseason tournament_name:Demot
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
tournament participants
List participants for a tournament. The optional "extended" argument can be used to control how much team info is shown. If omitted, extended infos are shown. The order of teams can be changed with the "sort_by" argument, the default is the team code
Usage
/tournament participants tournament_name:"tournament name" extended:"optional: show extended info?" sort_by:"optional: sorting criterion"
Example
/tournament participants tournament_name:Demot
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
tournament participation
Output a list of all tournaments (and their respective teams) one or multiple (separated by whitespaces) players (ingame accounts) are currently participating in. Optionally, a league name can be supplied to limit the output to tournaments under that league
Usage
/tournament participation player_tags:"playertag1 playertag2 ..." league_name:"optional: league name"
Example
/tournament participation player_tags:#2PVPRC2L8 #2PP
Permission Requirements
NONE, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
tournament replaceteam
Replace a team by another team. The new team must have been added to the tournament prior to this command
Usage
/tournament replaceteam tournament_name:"tournament name" old_team_code:"old team code" new_team_code:"new team code"
Example
/tournament replaceteam tournament_name:Demot old_team_code:GD new_team_code:DG
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
tournament reproles
Give out ("add") or remove ("rm") rep roles from all representatives for a tournament. If you chose the "rm" action, you may specify "purge" as a third argument to kick the representatives instead of removing their roles
Usage
/tournament reproles action:"action" tournament_name:"tournament name" purge:"optional: kick reps?"
Example
/tournament reproles action:rm tournament_name:Demot purge:True
Permission Requirements
MANAGE_TEAMS, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
tournament rm
Remove an existing tournament and all associated data from the bot's database. This action is irreversible, so don't use this command lightly
Usage
/tournament rm tournament_name:"tournament name"
Example
/tournament rm tournament_name:Demot
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
tournament rmgroup
Remove an existing group. This will remove all teams from the group as well, but it won't delete the teams
Usage
/tournament rmgroup tournament_name:"tournament name" group_name:"group name"
Example
/tournament rmgroup tournament_name:Demot group_name:GrpA
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_MATCHES
Guild Tier Requirements
TOURNAMENT_SERVER
tournament setup
Set a tournament up. For more details on parameters and their meaning use
/howto topic:tournament setup
Usage
/tournament setup tournament_name:"tournament name"
Example
/tournament setup tournament_name:Demot
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
tournament showconfig
Show the configuration for a tournament
Usage
/tournament showconfig tournament_name:"tournament name"
Example
/tournament showconfig tournament_name:Demot
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
tournament togglevisibility
Toggle a tournament's visibility. Hiding it will prevent it from showing up in
/tournament list
and
/subscribe
. Active subscriptions will not be affected by this and the tournament can still be used in commands. To un-hide a tournament, simply re-run the command
Usage
/tournament togglevisibility tournament_name:"tournament name"
Example
/tournament togglevisibility tournament_name:Demot
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
The transaction-module provides commands to deal with master roster transactions. Team representatives can request player changes for their team and staff can review these requests to confirm or deny the changes. A transaction will only take effect after it has been confirmed
transaction add
Request the permanent addition of a player to a team's master roster. The request has to be reviewed by a member of staff. After the review, a message will indicate whether the request was accepted or denied
Usage
/transaction add tournament_name:"tournament name" team_code:"team code" player_tag:"player tag"
Example
/transaction add tournament_name:Demot team_code:OSD player_tag:#2PVPRC2L8
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_ROSTER, MANAGE_TRANSACTIONS, MANAGE_OWN_ROSTER, REPRESENTATIVE
Guild Tier Requirements
TOURNAMENT_SERVER
transaction confirm
Authorize a pending transaction request. The requested roster change will take effect after this command has been executed
Usage
/transaction confirm transaction_id:"transaction id"
Example
/transaction confirm transaction_id:1234
Permission Requirements
LEAGUE_ADMIN, MANAGE_TRANSACTIONS, TOURNAMENT_ADMIN, MANAGE_ROSTER
Guild Tier Requirements
TOURNAMENT_SERVER
transaction deny
Deny a pending transaction request. The requested roster change will not be executed
Usage
/transaction deny transaction_id:"transaction id"
Example
/transaction deny transaction_id:1234
Permission Requirements
LEAGUE_ADMIN, MANAGE_TRANSACTIONS, TOURNAMENT_ADMIN, MANAGE_ROSTER
Guild Tier Requirements
TOURNAMENT_SERVER
transaction list
List all authorized transactions for a tournament or a specific team. If the transaction type is provided, it has to be one of "add" (addition), "rm" (removal) or "sub" (substitute)
Usage
/transaction list tournament_name:"tournament name" team_code:"optional: team code" "optional: transaction type"
Example
/transaction list tournament_name:Demot team_code:OSD
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_ROSTER, MANAGE_TRANSACTIONS, MANAGE_OWN_ROSTER, REPRESENTATIVE
Guild Tier Requirements
TOURNAMENT_SERVER
transaction pending
List all pending transaction requests for a tournament
Usage
/transaction pending tournament_name:"tournament name"
Example
/transaction pending tournament_name:Demot
Permission Requirements
LEAGUE_ADMIN, MANAGE_TRANSACTIONS, TOURNAMENT_ADMIN, MANAGE_ROSTER
Guild Tier Requirements
TOURNAMENT_SERVER
transaction reset
Reset the transactions for a tournament. This sets all transaction counters to zero and deletes the transaction history, but it does not undo the transactions. Optionally, provide a team code to reset the transactions for that team only
Usage
/transaction reset tournament_name:"tournament name" team_code:"optional: team code"
Example
/transaction reset tournament_name:Demot
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
transaction rm
Request the permanent deletion of a player from a team's master roster. The request has to be reviewed by a member of staff. After the review, a message will indicate whether the request was accepted or denied
Usage
/transaction rm tournament_name:"tournament name" team_code:"team code" player_tag:"player tag"
Example
/transaction rm tournament_name:Demot team_code:OSD player_tag:#2PVPRC2L8
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_ROSTER, MANAGE_TRANSACTIONS, MANAGE_OWN_ROSTER, REPRESENTATIVE
Guild Tier Requirements
TOURNAMENT_SERVER
transaction sub
Request the addition of a substitute player to a team's roster for the ongoing war week. The request has to be reviewed by a member of staff. After the review, a message will indicate whether the request was accepted or denied
Usage
/transaction sub tournament_name:"tournament name" team_code:"team code" player_tag:"player tag"
Example
/transaction sub tournament_name:Demot team_code:OSD player_tag:#2PVPRC2L8
Permission Requirements
LEAGUE_ADMIN, TOURNAMENT_ADMIN, MANAGE_ROSTER, MANAGE_TRANSACTIONS, MANAGE_OWN_ROSTER, REPRESENTATIVE
Guild Tier Requirements
TOURNAMENT_SERVER
transaction undo
Undo a transaction. This reverts the player change and deletes the transaction from the team's transaction record
Usage
/transaction undo transaction_id:"transaction id"
Example
/transaction undo transaction_id:1234
Permission Requirements
LEAGUE_ADMIN, MANAGE_TRANSACTIONS, TOURNAMENT_ADMIN, MANAGE_ROSTER
Guild Tier Requirements
TOURNAMENT_SERVER
The tz-module takes care of all time zone calculations for you. Not only does it come with a toolkit to compare offsets and convert times back and forth, it also allows you to set a server time. That way, all times will always be right for you
tz convert
Convert a date time between two time zones. Datetime must be in "yyyy-mm-ddThh:mm"-format, time zones must be from
/tz list
Usage
/tz convert datetime:"datetime in yyyy-mm-ddThh:mm format" from_timezone:"source time zone" "target time zone"
Example
/tz convert datetime:2021-10-16T20:00 from_timezone:UTC to_timezone:CEST
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
tz list
Outputs a list of all valid time zone names and aliases
Usage
/tz list
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
tz maketime
An interactive way to convert your day and time to the server time and output a time string the bot accepts as input
Usage
/tz maketime input_timezone:"your time zone"
Example
/tz maketime input_timezone:CEST
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
tz now
Print the current date and time in a given time zone
Usage
/tz now timezone:"time zone"/tz now timezone:UTC
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
tz offset
Calculates the difference between two time zones. Time zones must be from
/tz list
Usage
/tz offset timezone1:"time zone 1" timezone2:"time zone 2"
Example
/tz offset timezone1:UTC timezone2:CEST
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
tz servertime
Output the current server time and time zone
Usage
/tz servertime
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
tz set-servertime
Set the server's time zone. Time zones must be from
/tz list
Usage
/tz set-servertime timezone:"time zone"
Example
/tz set-servertime timezone:UTC
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
The
wm-module is the bot's
warmatch.us integration. It is able to generate most of the codelines needed to set up and manage a warmatch league page. Note that the bot cannot create the league page itself, that needs to be done by warmatch support staff
wm clans
Generate wm clan codelines for a league. This will use each team's main clan
Usage
/wm clans tournament_name:"tournament name"
Example
/wm clans tournament_name:Demot
Permission Requirements
MANAGE_WM, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
wm groups
Generate wm group and groupclans codelines for a league
Usage
/wm groups tournament_name:"tournament name"
Example
/wm groups tournament_name:Demot
Permission Requirements
MANAGE_WM, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
wm matches
Generate wm match codelines for a week of league play
Usage
/wm matches tournament_name:"tournament name" schedule_name:"schedule name"
Example
/wm matches tournament_name:Demot w1
Permission Requirements
MANAGE_WM, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
wm results
Generate wm results codelines for a week of league play
Usage
/wm results tournament_name:"tournament name" schedule_name:"schedule name"
Example
/wm results tournament_name:Demot schedule_name:w1
Permission Requirements
MANAGE_WM, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
wm schedules
Generate wm schedule codelines for a league
Usage
/wm schedules tournament_name:"tournament name"
Example
/wm schedules tournament_name:Demot
Permission Requirements
MANAGE_WM, LEAGUE_ADMIN, TOURNAMENT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
misc module
This pseudo-module holds miscellaneous commands that have no dedicated module
addcommand
Add a custom command to this server. Anybody on the server will be able to call the command with the provided command name and the bot will answer with the defined response
Usage
/addcommand command_name:"command name" response:"bot response when called" image:"optional: attached image file to send with the command response"
Example
/addcommand command_name:"demo command" response:"This is a demo response"
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
announce
Have the bot post an announcement to a specified channel. Optionally, specify a date to schedule a post for later or omit the output channel to invoke a selection menu allowing you to send the announcement to multiple channels or even entire categories
Usage
/announce message:"message to post" as_embed:"send as embed?" output_channel:"optional: output channel" date:"optional: date in "yyyy-mm-ddThh:mm"-format"
Example
/announce message:"Listen up, this is an announcement" output_channel:#some-channel as_embed:True
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
cancel-premium
Cancel the premium boost for the server this is called from, freeing your credits up to be used on another server
Usage
/cancel premium
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
clan-calendar
Outputs a list of all upcoming matches for teams tied to one of the provided clan tags
Usage
/clan-calendar clan_tags:"clantag1 clantag2 ..."
Example
/clan-calendar clan_tags:#2PP
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
commands
Outputs a list of all available commands. You can provide an optional module name. If provided, only commands from that module will be output
Usage
/commands module:"optional: module name"
Example
/commands module:match
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
gdpr
Prints our privacy and data protection disclaimer
Usage
/gdpr
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
help
/help help
... is that help-ception? Nope. Get back to researching something useful. If you're actually looking for help on the
/help
command, try
/help
Usage
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
howto
Show guides on how to use the bot. Optionally, a topic for guidance on a certain aspect of the bot can be supplied. If it is omitted, a general introduction is printed
Usage
/howto topic:"optional: topic"
Example
/howto topic:setup
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
info
Display info about the bot
Usage
/info
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
inviteme
Print a link to invite the bot to your server
Usage
/inviteme
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
languages
List all languages the bot can communicate with you in
Usage
/languages
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
manual
Print a link to the bot manual with help and information on all commands
Usage
/manual
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
ping
Ping the bot. If the bot is reachable, it will respond with "Pong"
Usage
/ping
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
raise-incident
Open an incident, flagging the channel for staff attention. The reason will be displayed in the channel topic for easy reference. This can only be executed by reps in their negotiation channels
Usage
/raise-incident reason:"optional: reason"
Example
/raise-incident reason:"They are being mean to me :("
Permission Requirements
MANAGE_OWN_TEAM, REPRESENTATIVE, MANAGE_NEGOTIATIONS, TOURNAMENT_ADMIN, LEAGUE_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
redeem-premium
Redeem premium features earned from a Patreon pledge for the server this command is called from. If you are a new patron, make sure your Discord account is connected to your Patreon account and allow for up to two hours for your pledge to be processed. Thank you for your support!
Usage
/redeem-premium
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
resolve-incident
Resolve an incident, removing the flag for attention
Usage
/resolve-incident
Permission Requirements
MANAGE_NEGOTIATIONS, TOURNAMENT_ADMIN, LEAGUE_ADMIN
Guild Tier Requirements
TOURNAMENT_SERVER
rmcommand
Remove a custom command from this server
Usage
/rmcommand command_name:"command name"
Example
/rmcommand command_name:"demo command"
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
subscribe
Subscribe to an entity from another server. Entities can be "league" or "tournament", the former enabling fp-checks against another server's ban list, the latter enabling match-commands against another server's tournaments. After executing the command, the bot will bring up a list of all available options for you to choose from. If you supply the optional entity name, the list will be limited to entities of that name. If only one entity with the provided name is available, the subscription will be processed immediately
Usage
/subscribe entity_type:"entity type" entity_name:"optional: entity name"
Example
/subscribe entity_type:tournament
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
subscriptions
List all active subscriptions for the server
Usage
/subscriptions
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
support
Print an invite link to the support server
Usage
/support
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
unsubscribe
Unsubscribe from another server's entity. Entities can be "league" or "tournament"
Usage
/unsubscribe entity_type:"entity type" entity_name:"entity name"
Example
/unsubscribe entity_type:tournament entity_name:Demot
Permission Requirements
BOT_ADMIN
Guild Tier Requirements
PUBLIC_SERVER
use-language
Set the language the bot will use to communicate with you or in your server. Options can be viewed by using
/languages
. To set the language for a server, you need to be a bot admin on that server
Usage
/use-language language:"language code" target:"optional target"
Example
/use-language language:en
Permission Requirements
NONE
Guild Tier Requirements
PUBLIC_SERVER
