{"id":26725412,"url":"https://github.com/thmslfb/helldivers-discord-bot","last_synced_at":"2026-04-11T13:05:28.050Z","repository":{"id":284238077,"uuid":"931137259","full_name":"thmslfb/helldivers-discord-bot","owner":"thmslfb","description":"🤖 A Discord bot for Helldivers 2 players, delivering real-time game updates, war status tracking, and community features.","archived":false,"fork":false,"pushed_at":"2025-03-24T21:37:10.000Z","size":144,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-24T22:21:58.603Z","etag":null,"topics":["api-integration","bot","discord-bot","discordjs","docker","game-tracker","game-updates","gaming","github-actions","helldivers-2","javascript","nodejs","open-source","postresql","slash-commands"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thmslfb.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":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-11T19:22:17.000Z","updated_at":"2025-03-24T21:37:11.000Z","dependencies_parsed_at":"2025-03-24T22:22:07.254Z","dependency_job_id":"4fb25c9e-f186-4cae-b74b-54c62335c4b5","html_url":"https://github.com/thmslfb/helldivers-discord-bot","commit_stats":null,"previous_names":["thmslfb/helldivers-discord-bot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thmslfb%2Fhelldivers-discord-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thmslfb%2Fhelldivers-discord-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thmslfb%2Fhelldivers-discord-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thmslfb%2Fhelldivers-discord-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thmslfb","download_url":"https://codeload.github.com/thmslfb/helldivers-discord-bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245924501,"owners_count":20694731,"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":["api-integration","bot","discord-bot","discordjs","docker","game-tracker","game-updates","gaming","github-actions","helldivers-2","javascript","nodejs","open-source","postresql","slash-commands"],"created_at":"2025-03-27T21:18:39.223Z","updated_at":"2025-12-30T22:50:15.834Z","avatar_url":"https://github.com/thmslfb.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Super Earth Broadcast \u0026nbsp;\u003cimg src=\"https://res.cloudinary.com/dyq2t6mgd/image/upload/v1742646117/bot-logo-md_agljmc.png\" width=\"36\" height=\"36\" align=\"top\" alt=\"Super Earth Broadcast Logo\"\u003e\n\nA Discord bot for Helldivers 2 players, delivering real-time game updates, war status tracking, and community features.\n\n---\n\n## ✨ Features\n\n- 🔔 **Real-time war status updates** from Helldivers 2\n- 🚨 **Automated notifications** for planet losses, victories, and major events in designated channels\n- 🗺️ **Planet tracking** with liberation progress\n- 📊 **Statistical reporting** on community efforts\n- 🏆 **Major Order notifications** and completion tracking\n- 🤖 **Discord slash commands** for game information\n- 🔄 **Automatic deployment** via CI/CD pipeline\n- 🐳 **Containerized deployment** with Docker\n\n## 🛠️ Tech Stack\n\n- **Node.js**\n- **Discord.js** (Bot framework)\n- **Docker** (Containerization)\n- **GitHub Actions** (CI/CD)\n- **ESLint** (Code quality)\n- **PostgreSQL** (Database)\n- **Redis** (Caching)\n\n## 📋 Prerequisites\n\nBefore you begin, ensure you have:\n\n- ✅ Node.js 18+\n- ✅ Discord bot token and application\n- ✅ PostgreSQL database (e.g., [Neon](https://neon.tech/))\n- ✅ Redis instance (e.g., [Upstash](https://upstash.com/))\n- ✅ Docker and Docker Compose (for production)\n- ✅ GitHub account (for CI/CD)\n\n## 🚀 Installation\n\n### 1. Clone the repository:\n\n```bash\ngit clone https://github.com/thmslfb/helldivers-discord-bot.git\ncd helldivers-discord-bot\n```\n\n### 2. Install dependencies:\n\n```bash\nnpm install\n```\n\n### 3. Set up environment variables:\n\n```bash\ncp .env.example .env\n```\n\n### 4. Configure your `.env` file:\n\n```env\n# Discord.js\nTOKEN=\"your-discord-bot-token\"\nGUILD_ID=\"your-discord-server-id\"\nUSER_ID=\"your-discord-user-id\"\nROLE_ID=\"role-id-for-permissions\"\nCLIENT_ID=\"your-bot-client-id\"\n\n# Channels\nWAR_UPDATES_CHANNEL_ID=\"channel-for-war-updates\"\n\n# Database\nDATABASE_URL=\"postgresql://username:password@localhost:5432/helldivers\"\n\n# Redis\nREDIS_URL=\"rediss://:\u003cpassword\u003e@\u003cupstash-endpoint\u003e:6379\"\n\n# API\nDIVEHARDER_API_URL=\"https://api.diveharder.com/v1\"\nHELLDIVERS_API_URL=\"https://api.helldivers2.dev/api/v1\"\n\n# Info\nSUPER_CLIENT=\"your-client-identification\"\nSUPER_CONTACT=\"your-contact-info\"\n```\n\n## 🏃‍♂️ Development\n\nStart the development server:\n\n```bash\nnode .\n```\n\n## 🐳 Docker Development\n\nRun with Docker Compose:\n\n```bash\ndocker compose up -d\n```\n\n## 🔄 CI/CD Pipeline\n\nThis project is configured with a robust CI/CD pipeline using GitHub Actions:\n\n### Continuous Integration (CI)\n\n- ✅ **Automated testing** on every PR and push\n- ✅ **Code quality checks** with ESLint\n- ✅ **Build verification** to ensure Docker compatibility\n\n### Continuous Deployment (CD)\n\n- 🚀 **Automatic deployment** when code is merged to main\n- 🛡️ **SSH-based secure deployments** to production server\n- 📊 **Deployment status reporting** with detailed logs\n\n## 🤖 Bot Commands\n\nThe bot currently supports:\n\n- `/superstore` - Get the current Superstore rotation\n\nComing soon:\n\n- Commands for **Terminids**, **Illuminists** and **Automatons**\n- War status tracking\n- Planet information\n- And many others!\n\n\u003e **Note:** Additional commands are under active development and will be released in future updates.\n\n## Automated Notifications\n\nThe bot sends automated messages to your configured war-updates channel when:\n\n- 🔴 A planet is lost to enemy forces\n- 🟢 A planet is liberated by Super Earth forces\n- 🎖️ Major Orders are completed or failed\n- 🌍 War state changes significantly\n- 📝 Game patches and updates are released\n- 🎮 New Warbonds become available\n\n\u003e **Note:** Some notification features are still in development and will be rolled out in future updates.\n\n## 📜 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🤝 Contributing\n\nWe welcome contributions! Here's how you can help:\n\n1. 🍴 Fork the repository\n2. 🌿 Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. 💾 Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. 📤 Push to the branch (`git push origin feature/amazing-feature`)\n5. 🎯 Open a Pull Request\n\n## 💬 Support\n\nNeed help? Please [open an issue](https://github.com/thmslfb/helldivers-discord-bot/issues) in the repository.\n\n## 👏 Acknowledgments\n\nSpecial thanks to these amazing projects:\n\n- [Discord.js](https://discord.js.org/)\n- [Node.js](https://nodejs.org/)\n- [Neon](https://neon.tech/)\n- [Upstash](https://upstash.com/)\n- [Docker](https://www.docker.com/)\n- [GitHub Actions](https://github.com/features/actions)\n- [DiveHarder API](https://github.com/helldivers-2/diveharder_api.py)\n- [Helldivers 2 API](https://helldivers-2.github.io/api/#/README)\n- [Arrowhead Game Studios](https://www.arrowheadgamestudios.com/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthmslfb%2Fhelldivers-discord-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthmslfb%2Fhelldivers-discord-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthmslfb%2Fhelldivers-discord-bot/lists"}