A feature-rich Discord bot for FRC teams
FRC Bot provides a hosted instance of the bot at frcbot.togatech.org. If you want to host your own instance of the bot, please see the setup guide below.
Some parts of this setup guide have been borrowed from the FRC Discord Dozer bot documentation and adapted for FRC Bot.
Run node -v to find what version of Node.js you are running and npm -v to find what version of NPM you are running. If you don't have Node.js or NPM, one of these commands will return an error, and you'll need to install from nodejs.org.
Open a terminal and navigate to the root directory of FRC Bot. Run npm i to install the dependencies used by FRC Bot.
-
Go to the Discord Developer Portal and create a new application by clicking the button. Enter a name for the application when prompted.
-
Create a bot user inside of your application. In the settings menu, go to the "Bot" menu.
Within the bot menu, select the "Add bot" option.
-
Copy and save the bot user token (seen in the image below), you'll need it later. Do not share your token with anyone. If someone obtains your bot user token, they gain full control of your bot. Be careful!
-
(Optional) Name your bot user and add a profile photo through the same interface as the above image! For reference, the name of the bot in the official hosted instance is
FRC Bot, and the profile photo from the official hosted instance can be found here. -
Within your bot user settings, make sure all "intents" settings are enabled.
-
Create a TBA account using your Google Account. Go to thebluealliance.com, click the myTBA tab, and click the "Log in" button.
-
Go to the "More" tab at the top of the page and select the "Account" option. From there, scroll down to "Read API Keys," enter a description for your bot, and select "Add New Key."
-
Copy and save this API key, you'll need it later.
Copy exampleconfig.json over to config.json and open the file in either a code editor or a plain text editor (but not a rich text editor). Paste your Discord Bot token in the empty token field and your TBA API key in the empty tba_key field. Feel free to modify the other fields like prefix and footer to further customize your bot.
- Within the scopes menu under OAuth2, select the "bot" scope.
- A new "permissions" menu should appear below. Select all the permissions that you want your instance of FRC Bot to have. If you want all permissions and you trust your instance wholeheartedly, select the "Administrator" option.
- The bottom of the scopes menu should have a URL. Copy and paste that URL into a new tab in your browser. It'll open a page where you can invite the bot to your server.
Open a terminal and navigate to the root directory of FRC Bot. Run npm start to run the bot!