{"id":20909630,"url":"https://github.com/theleopard65/ctf-tracker-bot","last_synced_at":"2026-04-16T19:02:56.940Z","repository":{"id":262686006,"uuid":"887927872","full_name":"TheLeopard65/CTF-Tracker-BOT","owner":"TheLeopard65","description":"Discord bot for CTFs with live events, team stats, and easy comparisons.","archived":false,"fork":false,"pushed_at":"2025-03-16T12:24:53.000Z","size":89,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-28T12:43:13.260Z","etag":null,"topics":["bot","ctf","ctftime","discord","nodejs","python","react","updates"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheLeopard65.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,"zenodo":null}},"created_at":"2024-11-13T14:21:44.000Z","updated_at":"2025-06-16T05:25:56.000Z","dependencies_parsed_at":"2025-07-28T12:32:48.581Z","dependency_job_id":"c6bfb71f-02d8-4b0b-9b87-9cd613abc9bd","html_url":"https://github.com/TheLeopard65/CTF-Tracker-BOT","commit_stats":null,"previous_names":["theleopard65/ctf-tracker-bot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/TheLeopard65/CTF-Tracker-BOT","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheLeopard65%2FCTF-Tracker-BOT","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheLeopard65%2FCTF-Tracker-BOT/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheLeopard65%2FCTF-Tracker-BOT/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheLeopard65%2FCTF-Tracker-BOT/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheLeopard65","download_url":"https://codeload.github.com/TheLeopard65/CTF-Tracker-BOT/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheLeopard65%2FCTF-Tracker-BOT/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31899986,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T18:22:33.417Z","status":"ssl_error","status_checked_at":"2026-04-16T18:21:47.142Z","response_time":69,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["bot","ctf","ctftime","discord","nodejs","python","react","updates"],"created_at":"2024-11-18T14:12:09.947Z","updated_at":"2026-04-16T19:02:56.934Z","avatar_url":"https://github.com/TheLeopard65.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CTF-Tracker-BOT\n\nCTF-Tracker-BOT is a powerful and efficient Discord bot that provides real-time updates and insights on Capture The Flag (CTF) events, directly integrated with CTFtime. It enables users to track upcoming CTF events, view detailed information about teams, and even compare performance across multiple teams. Perfect for competitive CTF participants and organizers alike, this bot simplifies tracking and management of CTF competitions.\n\n## Features\n\n- **Real-Time CTF Updates**: Get the latest upcoming CTF events from CTFtime.\n- **Team Information**: Retrieve detailed information on teams, including their rank, points, and history in previous events.\n- **Team Comparison**: Compare multiple teams' performances based on their most recent 5 CTF events.\n- **Command List**:\n  - `/help`: Displays available bot commands.\n  - `/newctfs`: Lists the top upcoming CTF events with flexible sorting options.\n  - `/teaminfo`: Fetches detailed information about a specific team by name or ID.\n  - `/setteams`: Allows admins to set a list of teams to be used in the `/compare` command.\n  - `/compare`: Compares pre-set teams' performances in their latest 5 CTF events.\n\n## Prerequisites\n\n- **Node.js**: Ensure you have [Node.js](https://nodejs.org/) installed.\n- **Discord Bot Token**: You need a valid Discord Bot Token. Follow [this guide](https://discord.com/developers/docs/intro) to create a bot.\n- **CTFtime API**: This bot relies on the [CTFtime API](https://ctftime.org/) to fetch event and team data.\n\n## Setup Instructions\n\n1. **Clone the Repository**\n   ```bash\n   git clone https://github.com/TheLeopard65/CTF-Tracker-BOT.git\n   cd CTF-Tracker-BOT\n   ```\n\n2. **Install Dependencies**\n   The bot uses `discord.js`, `node-fetch`, and `node-cache` for its core functionality. Install all dependencies with npm:\n   ```bash\n   npm install\n   ```\n\n3. **Create `.env` File**\n   In the root directory of the project, create a `.env` file and add the following:\n   ```bash\n   TOKEN=your-discord-bot-token\n   ```\n\n4. **Start the Bot**\n   Run the bot using Node.js:\n   ```bash\n   npm start\n   ```\n\n5. **Bot Commands**\n   Once the bot is running and added to your server, use the commands below:\n\n   - `/help`: Displays a help message with all available bot commands.\n   - `/newctfs [count] [sort]`: Fetches and displays upcoming CTF events. You can specify how many events to show and the sorting criteria (e.g., \"weight\", \"start\", \"end\").\n   - `/teaminfo [teamid]`: Fetches information about a specific team by either name or ID.\n   - `/setteams [team1,team2,...]`: Set the list of teams to be used for comparisons in `/compare`.\n   - `/compare`: Compares the top 5 CTF scores of the teams you've set with `/setteams`.\n\n## Development \u0026 Contributions\n\nFeel free to contribute to this project by forking the repository, making changes, and submitting a pull request. Please ensure all code is properly tested before submitting.\n\n### Installing Dependencies\n\nTo install the necessary dependencies, run:\n```bash\nnpm install\n```\n\n### Running Locally\n\nTo run the bot locally, use the following command:\n```bash\nnpm start\n```\n\n### Running Tests\n\nCurrently, there are no formal tests in place. To add tests, consider using libraries like [Jest](https://jestjs.io/) or [Mocha](https://mochajs.org/).\n\n### Code Structure\n\n- **CTF-Tracker.js**: Main bot file handling logic, commands, and API calls.\n- **package.json**: Manages the bot's dependencies and scripts.\n- **.gitignore**: Specifies which files and folders to ignore for Git.\n- **.nixpacks**: Configuration file for deployment on [Nixpacks](https://nixpacks.com).\n\n## Issues \u0026 Bugs\n\nIf you encounter any issues, feel free to open an issue on the [GitHub issues page](https://github.com/TheLeopard65/CTF-Tracker-BOT/issues). We'll do our best to resolve them promptly.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.\n\n## Acknowledgments\n\n- **Discord.js**: For providing the necessary framework to interact with Discord's API.\n- **CTFtime**: For providing the CTF data API.\n\n## Support\n\nFor any support or questions, feel free to reach out via the [GitHub discussions page](https://github.com/TheLeopard65/CTF-Tracker-BOT/discussions) or create an issue.\n\n## Credits\n\n- **Leopard (@theleopard65)**: The creator and maintainer of the CTF-Tracker-BOT.\n\n---\n\nThank you for using **CTF-Tracker-BOT**! Enjoy tracking your favorite CTF events! 🎉\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheleopard65%2Fctf-tracker-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheleopard65%2Fctf-tracker-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheleopard65%2Fctf-tracker-bot/lists"}