Docker image to run the FIRST Chesapeake Discord Bot.
This is a Docker Image of a Discord Bot for the FIRST Chesapeake Discord Server.
This bot is able to pull information from the FIRST FTC API, FIRST FRC API, and The Orange Alliance API. The bot is also capable of retrieving live information from the FIRST Tech Challenge scorekeeping software (EMS).
This Docker image is being pushed to Docker Hub
- Update the .env file with your API Keys, what Discord Channel you want the bot to receive commands from, and what Discord Channel you want to send the live FTC event information to.
- Run the bot.
- From the Admin Channel run the
!ftc server get apikeycommand to get an API key from the FTC Scorekeeper Software. - Update the .env file with the API key.
- Run the bot.
| Description | Container Path |
|---|---|
| Logs | /var/log/firstchesapeakebot |
None
| Command | Description |
|---|---|
| !frcteam/frc TeamNumber | Retrieves information about the supplied team from the FIRST FRC API |
| !ftcteam/ftc TeamNumber | Retrieves information about the supplied team from the FIRST FTC API |
| !ftcteamtoa TeamNumber | Retrieves information about the supplied team from the The Orange Alliance API |
| !ftc event start EventCode eventName | ADMIN COMMAND Starts the live event feed for the provided FTC Event Code |
| !ftc event stop EventCode | ADMIN COMMAND Stops the live event feed for the provided FTC Event Code |
| !ftc server get apikey | ADMIN COMMAND Request an API key from the FTC Scorekeeper Software. This will output the key to Discord and log. |
| !clear amount | ADMIN COMMAND Removes the specified ammount of messages in a channel, excluding pinned messages. |
| Date | Description |
|---|---|
| 1NOV20 | Initial Release (v1.0) |
| 2NOV20 | v1.0.1 - Added: Auto Assign new users the "Needs Registration" Role, Clear/Sweep Command, Modified bot to also listen for all commands on the Admin channel as well |
| 13NOV20 | v1.0.6 - Changed Admin Role to ENV variable |
| 31JAN21 | v1.0.7 - Updated base image version, Updated requirements to latest, Fixed issue with websocket, ability to set multiple admin and production channels, added saving match results to mySQL server on comit. |
| 7FEB21 | v1.0.7 - Added BOTMATCHRESULTCHANNELS ENV Variable, configured match results to only send to that channel, and configured bot to allow team commands from all but that channel. |
| 7FEB21 | v1.0.8 - Fixed Match Results to post only to Match Results channel, also updated example.env file. |
| 7FEB21 | v1.1.0 - Added voice announcments for match status (Start, Post, Abort). |
| 14FEB21 | v1.1.1 - Added argument to event start for the event name. This gets passed to the voice announcments. |
| 16FEB21 | v1.1.2 - Added ability to assign role to user when they react to a specific message. |
| 16FEB21 | v1.1.3 - Modifed react role. If user already had role remove it. If user is member of Auto Assigned role remove their reaction and do nothing. |
| 22FEB21 | v1.1.4 - Added aliases for frcteam and ftcteam commands. |