CTF-Tracker-BOT is a powerful Discord bot designed to provide real-time updates and insights into Capture The Flag (CTF) events. The bot fetches data from CTFtime.org and allows users to track upcoming CTF events, view detailed team information, and compare multiple teams based on their performance in past CTF competitions. It can also help administrators set up teams for easy comparison.
- Upcoming CTF Events: Displays the top upcoming CTF events, sortable by different criteria such as weight, start time, and participants.
- Team Information: Retrieves detailed information about any CTF team (name, rank, country, recent event performance).
- Team Comparison: Allows comparing teams' scores across their most recent 5 CTF events.
- Administrator Tools: Set teams for comparison with specific commands accessible to admins.
/help: Displays a list of available bot commands and their descriptions./newctfs: Lists the top upcoming CTF events from CTFtime.org./teaminfo: Fetches detailed information about a specific team by name or ID./setteams: Admin command to set teams for comparison. (ADMINISTRATOR-ONLY)/compare: Compares multiple teams' performances across their latest CTF events.
- Node.js (v16 or higher)
discord.jsv14.16.3 or highernode-fetchdotenv- A valid CTFtime.org API key (set in
.env)
-
Clone the repository:
git clone https://github.com/TheLeopard65/CTF-Tracker-BOT.git cd CTF-Tracker-BOT -
Install dependencies:
npm install
-
Create a
.envfile in the root of the project with your Discord bot token:TOKEN=your_discord_bot_token
-
Run the bot:
npm start
- The bot uses the
dotenvpackage to load configuration from a.envfile. Make sure to set your bot token there. - Additional configuration options like color and timezone are set in the
CTF-Tracker.jsfile. You can modify these settings as needed.
MIT License - See LICENSE for more details.
If you encounter any issues, please open an issue on the GitHub repository.
For more information, visit the GitHub page.