TournaBot is a Discord bot designed to streamline smash.gg tournaments and improve user quality-of-life through specialized commands - built on Node.js and Discord.js.
Please check out TournaBot's top.gg page and the support/development Discord server if you need any help. You can find the invite link here.
-
Automatic tournament reminders an hour before your tournaments begin, which provide tournament/event information.
-
Automatic match calling called DQ pinging, which automatically pings users in a specified channel a minute after their match has been called.
-
User tournament results that include details and sets from a user's three latest tournaments.
-
Announcing tournaments with event and tournament information so that you don't have to.
-
A better matchmaking system that takes Discord role-based matchmaking to another level, enabling users to specify whether or not they want to be pinged for a role.
-
Search for tournaments by game directly in your Discord server.
-
Full localization through custom timezones and languages.
-
Custom prefixes so that TournaBot never clashes with other bots.
TournaBot was initially created on Windows, but is compatible with any UNIX-based system.
To create a Discord bot client, make an application through the Discord Developer Portal and create a client through the Bot tab. The bot's Token is used for authentication.
TournaBot uses Node.js v12.0.0 or higher.
To install the required npm dependencies, execute npm run build through the console within the project folder. If you clone the project using git and the package.json file is empty, you can copy and paste the text from the web repository.
TournaBot requires a MongoDB instance to store data. The production version of TournaBot uses Mongoose to connect to a MongoDB Atlas database. If you don't know how to set up a local database, I recommend using this guide.
A connection string is required to connect to any database. Read this if you don't know what the connection string should look like. It must be set up before running TournaBot.
TournaBot uses the following collections for categorizing data:
announcemessageschannelslanguagesmatchmakingrolesmatchmakinguserspingrolestimezonesuseridsprefixes
If there is no collection present for a given model, no data for that model will be collected.
Don't be afraid to join the support/development Discord server if you need help setting up the database.
The following environment variables are required to run TournaBot locally:
PREFIX- The prefix used for each commandDISCORDTOKEN- A valid Discord bot token from the Discord Developer PortalSMASHGGTOKEN- a valid developer token used to access the smash.gg API. You can create a developer token through Developer Settings found when clicking your profile picture on the bottom left of the smash.gg website.MONGOPASS- The connection string used to authenticate into a MongoDB database.
Note that within the original production code, ALTDISCORDTOKEN is used to authenticate into a dummy bot that is used for local development. It is not required for testing locally.
The original production code uses a config.json file to store the environment variables, but there are other methods to storing them.
To run TournaBot locally on your machine, execute node index.js through a console within the project folder. It is recommended that you use nodemon for any testing that requires lots of saving and re-executing.
For any help you need, feel free to join the support/development Discord server and give yourself the Contributor role. This server also contains a list of requested features, incase you want an idea to start!