Documentation

!buzz
Allows the user who ran the command to speak. If the user was not first to buzz, they will be added to the buzz list in order of buzzing. Requires the user to be on a team to use.

!team [1,2,leave]
Assigns the user to team 1, 2, or removes them from their current team (respectively). Being on a team allows a user to buzz and in most cases join competition channels.

!help
Sends a link to this documentation





!clear
Clears the past 100 messages from the past 2 weeks in that channel. The user must have administrator permissions on the server to use this. A confirmation message appears before messages are deleted, which the user who ran the command can either approve or cancel the action.

!mutechannel
Server mutes everyone in the voice channel that user is currently in, except those with the Mute Exempt role. The user must have the mute members permission on the server to use this.

!unmutechannel
Un-server mutes everyone in the voice channel that the user is currently in. The user must have the mute members permission on the server to use this.

!buzzlist
Shows a list of users who buzzed in the order that they buzzed.

!reset
Resets the buzzlist, buzzer, and re-mutes everyone who was muted before buzzes. A confirmation message will appear allowing the user who ran the command to either approve or cancel the action. Administrator permissions are required for use.

!next
Unmutes the next person on the buzz list, and mutes the person who is currently unmuted/selected from the buzz list. Administrator permissions required.

!incorrect
Marks the current user's team as incorrect for that question, allowing the other team to buzz again to try and answer the question. The user currently speaking will also be muted again. Administrator permissions are required to run this command.

!sendinfomessage
Sends a series of messages in that channel with instructions for users on how to use the bot (useful for an information channel). Administrator permissions are required.

It is useful to have multiple voice and text channels for utilization of this bot. 

Text channels:
- A channel dedicated for users to run commands in (like !buzz). To prevent abuse/spam, it is recommended this be restricted to coaches and those with a team role (Team 1 or Team 2)
- Another channel for users to chat/request team roles. If the other commands channel is restricted to those with a team role, this is required.

Voice channels:
- A main competition voice channel, restricted to those who have joined a team to prevent abuse. Most of the competition should take place here (reading questions and answering)
- (Optional) Team deliberation channels restricted to their designated team for discussion about bonuses, etc.

A few roles are required for use of this bot. On invitation of the bot, a ScholasticBowlBot role will be created. Please place that role above that of all the roles described here so the bot can assign these roles to other users.

Absolutely required roles. Case sensitive.
Team 1 - Automatically assigned to players who run "!team 1"
Team 2 - Automatically assigned to players who run "!team 2"
Mute Exempt - Prevents that user from being muted by the bot during competitions. Should be manually assigned to anyone who is going to be reading questions.

Strongly recommended roles. Name does not matter.
Some sort of "Coach" or "Admin" role - Should be given Administrator permissions. This will allow those users to run commands related to the competition.

Set up a site - Click here