Lizard-BOT

Simple discord bot originally built for the Online Local (formerly r/StreetFighter) East Coast SFV weekly tournament to help players see current round and with some commands for TOs. Support for multiple channels to run multiple tournaments at once and allows for custom prefixes, round flavor text, and more. Requires discord.py and pymysql.

How to Use

In order to get started, you need to invite Lizard-BOT to the discord server you wish to use to run tournaments. Invite link here.

Immediately after the bot joins the server use the command !edit botrole <role> with the role of your choice to make it so that only those with that role can access the commands meant for the Tournament Organizers. From there, feel free to use all the commands listed below to adjust the bot to your needs.

For more information on setting up the bot for use in a Discord server, please see our documentation here

For a more indepth guide to what each command does, please see our documentation here

Note about Challonge

If you have a pro-community, use your custom subdomain e.g., redditfighting of redditfighting.challonge.com.

If you are not a pro-community in Challonge, you will have to find and copy the jumble of symbols that is your community's subdomain. Go to your Challonge community page, and go to community settings. Look for the part that says Subdomain PRO and look for the box beneath it. This is your community subdomain.

If the Challonge community tournament does not add the "LizardBOT" Challonge account as a collaborator or a tournament hosted by a Challonge user, the checkin command WILL work but the seeding command will NOT work. This is because tournaments are read-only by default. Any attempts by Lizard-BOT to updating seeding numbers will fail since "LizardBOT" doesn't have permissions.

TO Commands

These commands will only be available to be used by those with the role mentioned above.

!challonge <subcommand> [bracket URL identifier] [OPTIONALS] Uses Challonge's API to pull data into Discord

Bracket URL identifier is what comes at the end of the URL For example redditfighting.challonge.com/wwyi8jhk Bracket URL identifier = wwyi8jhk

If you have a valid challonge link in your !bracket command, Lizard-BOT does not need the bracket URL identifier and will grab the first challonge link that exists in !bracket

Subcommands

Subcommands are still actively being implemented

• checkin [bracket url ID]
  • Checks the given bracket for users that are not checked in and users whose Challonge names are not in the server
• seeding [bracket url ID] [number of players to seed(Must be integer greater than or equal to 1)]
  • Seeds the tournament based on points in the spreadsheet and the number of players to seed

!edit [channel(s)] <setting> <value> There are multiple settings that can be edited to allow customization.

If multiple channels are listed, the setting will be updated to the same value across all listed channels.

Server-wide

• botrole <@role>
  • This role determines what role is needed to access the TO Commands
  • New value must be a ping to the role desired
  • Default value: @everyone
• challonge
  • Specifies the Challonge subdomain to check for tournaments
  • Necessary for Challonge integration
  • Default Value:
• prefix-lizard
  • Allows you to change the prefix for commands
  • Useful if you use multiple bots that may have similar commands and prefixes
  • Default Value: !

Channel-Specific

• bracket
  • Allows you to add a link to a bracket for users to view
  • Unique for each channel
  • Default value: 'There is no bracket set for this channel'
• pingtest
  • Allows you to add a link to a speedtest and instructions for how to prefer a speedtest
  • Unique for each channel
  • Default value: Use https://testmyspeed.onl/ for ping tests.
• seeding
  • Allows you to set the Google Sheets spreadsheet ID to be used to check points
  • Please see: Our Documentation for instructions on creating/adapting a spreadsheet
  • Unique for each channel
  • Default value:
• status
  • Allows you to change the flavor text of the !round and !status commands for individual channels
  • Text uses {0} as a marker for where the round count will be added
  • Unique for each channel
  • Default value: Winner's Round {0} can play! Losers can play till top 8 losers side. If you have a bye Round {0}, Please Wait!
• stream
  • Allows you to add a stream link for users to easily access without prior knowledge or pinging an admin
  • Unique for each channel
  • Default value: There are no streams set for this channel
• TOs <@user>
  • Allows you to list all Tournament Organizers involved
  • Recommended to make it ping each individual TO
  • Unique for each channel
  • Default value:

!refresh Sends a message to the chat to let people know to refresh the bracket page.

!remind <time in minutes> [reason] Allows the admin to set a timed reminder. When used it will ping the user, with the reason for the reminder if specified, after the alloted time. Useful if you are have to handle multiple situations at once.

!reset Resets the round count back to its default value when a tournament is finished.

!round <round number> Changes the current round number to the new value. Can be more than just numbers if you wish to do something different. Immediately sends a status update in the chat.

General commands

Commands everyone can use

!botrole Returns the role that allows access to the administrator commands.

!bracket Shows the current bracket set in the channel.

!coin-flip A coin is flipped and the result is returned. Either heads or tails.

!draw [mention] <game> Conducts a card draw with the message sender and the user mentioned. Game will default to SFV if no game is given. 7 random characters are drawn, 2 are banned and 4 are picked. Everything is controlled by reactions.

!github Displays the link to the GitHub repository for Lizard-BOT

!help-lizard Displays a list of all commands.

!lizardbot-discord Displays the invite link to join the Lizard-BOT Discord Server for additional help.

!lizardman Ping! Pong!

!not-in-discord Repeats last part of challonge checkin command. Tells people discord nick must match challonge name.

!pingtest Explains how to run a ping test using https://testmyspeed.onl/. Can be edited to match the rules for any tournament's specific ping test rules.

!prefix-lizard Prints the prefix currently in use for Lizard-BOT.

!randomselect [game] Returns a randomly selected character from the current the specified game. Assumes SFV if no game is given. Current games are 3s, footsies, gbvs, samsho, sfv, t7, uni, xrd, +r

!stats [command] Returns the list of all commands and the amount of times they have been used across all servers. Add a command in the argument to return the count for only that command. The stats database was started on January 22, 2021. Any past uses of commands were not counted.

!status Returns the current round number in a message that can be customized. Will let users know if a tournament has not begun.

!stream Returns the stream link if one is set.

!TOs Sends a message back with all the Tournament Organizers pinged, if set.

How to set up your own instance of Lizard-BOT

Please see our documentation here for more information about initial configuration

Contributers

• Lizardman - Initial work, owner of bot, bug hunting - Twitter
• Axio - Initial Idea and general help
• Nogarremi - Database implementation, primary developer - Twitter

Other Resources

• Yaksha Bot - Created by ellipses. We used this for additional ideas about proper structuring of code for ease of expandability and readability. Yaksha Bot was released under an MIT license and this bot(Lizard-bot-rsf) is released as Mozilla Public License 2.0 but to ensure ellipses is credited, the functions copied and then edited by the contributors are commented with "# Yaksha" to give credit

If you have any further questions or concerns, feel free to contact me via discord @lizardman301#0301.