The all-in-one Discord bot powering the DevHub server.
Panda keeps DevHub engaging, organized, and fun — with community management, moderation, gamification, and a little bit of magic.
| Feature | Description |
|---|---|
| 👋 Welcome System | Greets new members with embeds in the server and via DM, plus a sticky introduction message with 👋 reactions. |
| 🔐 Captcha Verification | New members complete a visual captcha (via DM) before gaining full access; suspended members can verify to restore access. |
| 🎫 Ticketing System | Clean support-ticket creation and management with transcripts and an admin log channel. |
| ⭐ Starboard | Messages that reach enough reactions are promoted to the starboard channel. |
| 💡 Suggestions | Collect, queue, vote on, and mark community suggestions as implemented. |
| 🔢 Counting Game | Classic counting-channel game with a per-user count leaderboard, plus reset/set-count tools. |
| 🧑💻 Profiles | Custom profiles with bio, stack, GitHub, portfolio, hobbies & badge roles (Admin, Developer, VIP, Bug Hunter, and more). |
| 😴 AFK System | Set an AFK status and get notified when someone pings you. |
| 📜 Rule Lookup | Instantly fetch any rule embed with p!r<number>. |
| 🧰 Moderation Tools | Purge, lock/unlock, hide/unhide, slowmode, and a user-report context menu. |
| ⚡ Macros | Quick community macros triggered with the ++ prefix. |
| 🛠️ Utility Commands | Slash + prefix commands: ping, snowflake decoding, DM sending, custom embeds/messages, and more. |
- discord.js v14: Discord API
- Bun: runtime & package manager
- MongoDB (Mongoose): persistent storage
- Firebase: cloud services
- captcha-canvas: verification captchas
- Bun >= 1.0
- A Discord application with a bot token
- MongoDB instance (local or Atlas)
- (Optional) Firebase project credentials
-
Clone the repo
git clone https://github.com/your-username/pandabot.git cd pandabot -
Install dependencies
bun install
-
Configure your environment
Copy
.env.exampleto.envand fill in your values:cp .env.example .env
Then set your Discord token and MongoDB URI in
.env. -
Run the bot
bun start # production bun dev # development with watch mode
Tip
Slash commands are registered automatically on startup. Set REGISTER_COMMANDS=false in .env to skip registration.
We welcome contributions! Open an issue or submit a pull request — see CONTRIBUTING.md for detailed guide.
Panda Bot is released under the GPL-3.0 License. See LICENSE for details.
