A bot designed to make online fighting game tournaments run smoother.
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.
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
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.
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
Subcommands are still actively being implemented
!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.
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.
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.
Commands everyone can use
Returns the role that allows access to the administrator commands.
Shows the current bracket set in the channel.
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.
Displays the link to the GitHub repository for Lizard-BOT
Displays a list of all commands.
Displays the invite link to join the Lizard-BOT Discord Server for additional help.
Repeats last part of challonge checkin command. Tells people discord nick must match challonge name.
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.
Prints the prefix currently in use for Lizard-BOT.
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
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.
Returns the current round number in a message that can be customized. Will let users know if a tournament has not begun.
Returns the stream link if one is set.
Sends a message back with all the Tournament Organizers pinged, if set.
Please see our documentation here for more information about initial configuration
If you have any further questions or concerns, feel free to contact me via discord @lizardman301#0301.
Reviews can be left only by registered users. All reviews are moderated by Top.gg moderators. Please make sure to check our guidelines before posting.
No reviews here yet!