{"id":22284949,"url":"https://github.com/cmeone/frcbot","last_synced_at":"2025-03-25T20:20:15.933Z","repository":{"id":259973527,"uuid":"466227985","full_name":"CMEONE/FRCBot","owner":"CMEONE","description":"A feature-rich Discord bot for FRC teams","archived":false,"fork":false,"pushed_at":"2022-10-16T19:46:06.000Z","size":822,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-30T17:48:33.512Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CMEONE.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-03-04T18:20:40.000Z","updated_at":"2022-03-04T20:08:47.000Z","dependencies_parsed_at":"2024-10-28T22:33:08.979Z","dependency_job_id":null,"html_url":"https://github.com/CMEONE/FRCBot","commit_stats":null,"previous_names":["cmeone/frcbot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CMEONE%2FFRCBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CMEONE%2FFRCBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CMEONE%2FFRCBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CMEONE%2FFRCBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CMEONE","download_url":"https://codeload.github.com/CMEONE/FRCBot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245535513,"owners_count":20631298,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-03T16:50:18.134Z","updated_at":"2025-03-25T20:20:15.889Z","avatar_url":"https://github.com/CMEONE.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FRCBot\nA feature-rich Discord bot for FRC teams\n\n## Table of Contents\n- [Add Official Hosted Instance to Server](#add-official-hosted-instance-to-server)\n- [Setup](#setup)\n\t- [Install Node.js and NPM](#install-nodejs-and-npm)\n\t- [Install Dependencies](#install-dependencies)\n\t- [Get Discord Bot Token](#get-discord-bot-token)\n\t- [Get TBA API Key](#get-tba-api-key)\n\t- [Configure](#configure)\n\t- [Add to Server](#add-to-server)\n\t- [Run the Bot](#run-the-bot)\n\n## Add Official Hosted Instance to Server\nFRC Bot provides a hosted instance of the bot at [frcbot.togatech.org](https://frcbot.togatech.org). If you want to host your own instance of the bot, please see the [setup guide](#setup) below.\n\n## Setup\nSome parts of this setup guide have been borrowed from the [FRC Discord Dozer bot documentation](https://github.com/frcdiscord/dozer#setup) and adapted for FRC Bot.\n\n### Install Node.js and NPM\nRun `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](https://nodejs.org/).\n\n### Install Dependencies\nOpen a terminal and navigate to the root directory of FRC Bot. Run `npm i` to install the dependencies used by FRC Bot.\n\n### Get Discord Bot Token\n1. Go to the [Discord Developer Portal](https://discord.com/developers/applications) and create a new application by clicking the button. Enter a name for the application when prompted.\n    ![Creating a new Discord app](static/newapp.png)\n\n2. Create a bot user inside of your application. \n   In the settings menu, go to the \"Bot\" menu.\n   ![Creating a bot user 1](static/createbot1.png)\n   \n   Within the bot menu, select the \"Add bot\" option.\n   ![Creating a bot user 2](static/createbot2.png)\n\n3. Copy and save the bot user token (seen in the image below), you'll need it later.\n   Do not share your token with anyone. If someone obtains your bot user token, they gain full control of your bot. Be careful!\n   ![Token](static/tokens.png)\n\n4. (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](static/logo.png).\n\n5. Within your bot user settings, make sure all \"intents\" settings are enabled.\n   ![Enabling intents](static/intents.png)\n\n### Get TBA API Key\n1. Create a TBA account using your Google Account. Go to [thebluealliance.com](https://www.thebluealliance.com), click the myTBA tab, and click the \"Log in\" button.\n\n2. 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.\"\n![TBA API key](static/tba.png)\n\n3. Copy and save this API key, you'll need it later.\n\n### Configure\nCopy `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.\n\n### Add to Server\n1. Within the scopes menu under OAuth2, select the \"bot\" scope.\n   ![Selecting scopes](static/invite1_scopes.png)\n2. 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.\n   ![Permissions](static/invite2_permissions.png)\n3. 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.\n   ![OAuth invite](static/invite3_oauthurl.png)\n\n### Run the Bot\nOpen a terminal and navigate to the root directory of FRC Bot. Run `npm start` to run the bot!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmeone%2Ffrcbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcmeone%2Ffrcbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmeone%2Ffrcbot/lists"}