https://github.com/marechalg/countrydex
Pokémon-like with flags, hosted on Discord
https://github.com/marechalg/countrydex
discordjs json nodejs
Last synced: 2 months ago
JSON representation
Pokémon-like with flags, hosted on Discord
- Host: GitHub
- URL: https://github.com/marechalg/countrydex
- Owner: marechalg
- Created: 2025-06-22T18:55:45.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-10-06T20:13:19.000Z (9 months ago)
- Last Synced: 2025-10-06T20:40:18.865Z (9 months ago)
- Topics: discordjs, json, nodejs
- Language: JavaScript
- Homepage:
- Size: 16.6 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🌍 Countrydex
A Discord bot that turns geography into an addictive collection game. Hunt flags, guess countries, and compete with players worldwide.
## 🎯 Overview
Countrydex spawns flags from around the world in your Discord server. Race to identify them, build your collection, and climb the global leaderboard.
## ✨ Features
- 🏳️ **Auto-spawning flags** - New flags appear every hour at :30
- 🎮 **Interactive guessing** - Pop-up interface for country identification
- 🏆 **Global leaderboard** - Compete on completion rate, collection size, and speed
- 📊 **Personal stats** - Track your progress with `/dex`
- 💾 **Reliable data** - Database backed up daily
## 🛠️ Commands
| Command | Description |
|---------|-------------|
| `/help` | Display all available commands |
| `/dex` | View your complete flag collection and stats |
| `/lb` | Check the global leaderboard |
| `/clear [1-99]` | Clear messages (requires `MANAGE_MESSAGES`) |
| `/ping` | Display latency and uptime |
| `/reset` | Reset your progression (⚠️ irreversible for now) |
## 🚀 Tech Stack
- **Runtime**: Node.js
- **Framework**: discord.js
- **Database**: PostgreSQL
- **Libraries**:
- node-vibrant (color extraction)
- moment (time handling)
- axios (HTTP requests)
- deepl-node (translations)
you can find more details into [packages file](package.json)
- **Hosting**: Raspberry Pi 5 (8GB)
## 🎮 How to Play
1. Add Countrydex to your Discord server
2. Flags will spawn automatically in designated channels
3. Click the pop-up and guess the country (name or code)
4. Build your collection and compete globally
## 📦 Installation
Invite the bot in your server from this [Invitation Link](https://discord.com/oauth2/authorize?client_id=1342612831647957063&permissions=125968&integration_type=0&scope=bot+applications.commands)
## 🔧 Configuration
Countrydex only requires a text channel having `spawning` in its name, and the permissions asked in the invitation.
## 📝 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🤝 Contributing
Contributions are welcome ! Feel free to open issues or submit pull requests.
## 📞 Support
Join our [Discord Server](https://discord.gg/ZSt2vPydbN) for support, updates and Beta Testing Programm.
---
**Sharpen your knowledge, and start your hunting journey.**