Skip to content

Repository files navigation

🐼 Panda Bot

The all-in-one Discord bot powering the DevHub server.

License: GPL-3.0 Made with discord.js Runtime: Bun PRs Welcome

Panda is a [self hostable] discord bot that keeps DevHub engaging, organized, and fun with community management, gamification, and a little bit of magic.

✨ Features

Feature Description
Welcome System Greets new members with embeds in the server and via DM, plus a sticky introduction message with 👋 reactions.
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.
AFK System Set an AFK status and get notified when someone pings you.
Rule Lookup Instantly fetch any rule embed with ?r<number>.
Moderation Tools Purge, lock/unlock, hide/unhide, slowmode, and a user-report context menu.
Macros Quick community macros triggered with the ++ prefix.

🛠️ Tech Stack

🚀 Getting Started

Prerequisites

Setup

  1. Clone the repo

    git clone https://github.com/your-username/pandabot.git
    cd pandabot
  2. Install dependencies

    bun install
  3. Configure your environment

    Copy .env.example to .env and fill in your values:

    cp .env.example .env

    Then set your Discord token in .env.

  4. Run the bot

    bun start        # production
    bun dev          # development with watch mode

🤝 Contributing

We welcome contributions! Open an issue or submit a pull request.

Please see CONTRIBUTING.md for detailed guide.

📜 License

Panda Bot is released under the GPL-3.0 License. See LICENSE for details.

Contributors

Languages