🤖 Advanced Discord Bot (ADB)

🚀 ADB is a self-hosted Discord bot platform built to become whatever your server needs.
🔌 Install plugins • 🧩 Build your own modules • 🖥️ Manage everything from a dashboard • 🔓 Own the stack

---

📊 Project Statistics

Stars

Forks

Open Issues

Pull Requests

Contributors

👑 Maintainer

Role	Name	GitHub
🛠️ Maintainer	DeadIndian	@DeadIndian

ADB is not participating in any open source contribution program at the moment. Contributions are reviewed through regular GitHub issues and pull requests.

---

🖼️ Screenshots

🎨 Feature Showcase

🎂 Birthday System	💰 Daily Rewards	📝 Feedback Collection
💡 Suggestions	🏆 Leaderboards	📋 Main Menu
😂 Memes	📊 Performance Dashboard	⏰ Reminders

---

✨ Why Choose ADB?

🔌 Plugin-first foundation - Add commands, dashboards, scheduled jobs, models, and hooks without editing core code
🖥️ Dashboard-ready - Built around a web control plane for server admins and plugin management
🛒 Marketplace-ready - Discover and install community plugins from a registry-backed marketplace
🎯 General or specialized - Run it as an all-in-one community bot or strip it down into a focused custom bot
🔓 Self-hosted ownership - Your bot, your data, your infrastructure, your rules
🛡️ Privacy-first - Data stays in your MongoDB instance instead of a third-party SaaS platform
🤖 AI capable - Google Gemini integration for assistant and FAQ-style workflows
⚡ Modern Discord stack - Discord.js v14, Node.js, MongoDB, Fastify/Express pieces, and hot-reloadable plugins

---

🎯 Features

🔌 Plugin Platform

• Local plugins from plugins/
• npm-style plugin packages
• Plugin manifests with metadata, config schemas, permissions, restart flags, and optional dashboard ports
• Command registration and command overrides
• Event listeners, scheduled jobs, hook bus integration, and namespaced database models
• Registry support for a plugin marketplace

🖥️ Administration Dashboard

• Discord OAuth-based admin access
• Guild picker for server-specific management
• Plugin install, enable, disable, and status views
• Settings pages for AI, XP, tickets, birthdays, economy, anti-raid, and plugins
• Activity logs and operational visibility

🤖 AI Assistant

• Google Gemini-powered responses
• Configurable AI channels and behavior
• FAQ-oriented plugin support
• Rate limiting and graceful failure handling

💎 Economy, XP & Rewards

• Wallet, bank, shop, work, collect, gamble, and leaderboard commands
• XP profiles, daily rewards, role rewards, and server-configurable leveling
• Persistent MongoDB-backed user data

🎫 Moderation & Tickets

• Ban, kick, purge, anti-raid, support tickets, and ticket dashboards
• Configurable ticket categories and logs
• Permission-aware command handling

🎉 Community Tools

• Birthdays, polls, reminders, feedback, memes, truth-or-dare, dice, 8ball, avatars, server info, and utility commands

---

Commands List

📊 Command Categories Breakdown

Category	Examples
🎮 Fun & Games	8ball, meme, roll, secret, truthordare
🛡️ Moderation	antiraid, ban, kick, purge
📊 Utility & Info	help, ping, userinfo, serverinfo, botstats
💎 Economy & XP	bal, daily, points, profile, work, shop, xpconfig
🎫 Support System	ticket, ticketdashboard
🤖 AI Assistant	aiassistant, faq, config-ai
🎂 Community	birthday, feedback, poll, reminder

Refer to DOCUMENTATION.md for the complete slash command reference.

---

Quick Start

Prerequisites

• Node.js v18.0.0 or higher
• MongoDB database, local or cloud
• Discord Bot Token from the Discord Developer Portal
• Google Gemini API Key from Google AI Studio, optional unless AI features are enabled

Option 1: Local Setup

1. Clone the repository

   git clone https://github.com/DeadIndian/Advanced-Discord-Bot.git
   cd Advanced-Discord-Bot

2. Install dependencies

   npm install

3. Configure environment variables

   Create a .env file:

   DISCORD_TOKEN=your_discord_bot_token_here
   CLIENT_ID=your_bot_client_id_here
   GUILD_ID=your_test_guild_id_here
   MONGODB_URI=your_mongodb_connection_string
   GEMINI_API_KEY=your_gemini_api_key_here
   PORT=3000
   DASHBOARD_URL=http://localhost:5173
   SESSION_SECRET=replace_with_a_long_random_secret

4. Deploy slash commands

   npm run deploy

5. Start the bot

   npm start

Option 2: Docker Setup

1. Clone the repository

   git clone https://github.com/DeadIndian/Advanced-Discord-Bot.git
   cd Advanced-Discord-Bot

2. Configure environment variables

   Create a .env file:

   DISCORD_TOKEN=your_discord_bot_token_here
   CLIENT_ID=your_bot_client_id_here
   GUILD_ID=your_test_guild_id_here
   MONGODB_URI=mongodb://advance:bot@mongo:27017/discord-bot?authSource=admin&retryWrites=true&w=majority
   GEMINI_API_KEY=your_gemini_api_key_here
   SESSION_SECRET=replace_with_a_long_random_secret

3. Deploy slash commands

   docker compose run --rm bot npm run deploy

4. Build and start

   docker compose up --build -d

5. View logs

   docker compose logs -f bot

---

🌐 Deployment

ADB can run on Render, Railway, Fly.io, a VPS, or any host that supports Node.js and MongoDB access.

Recommended production steps:

1. Set all required environment variables in your host dashboard.
2. Use npm install as the build command.
3. Use npm start as the start command.
4. Run npm run deploy once after first deployment or after slash command changes.
5. Point the dashboard URL and OAuth callback URLs at your deployed domain.

Suggested service name:

Advanced Discord Bot

---

🔧 Database Setup

MongoDB Options

Option 1: MongoDB Atlas

1. Create a cluster at MongoDB Atlas
2. Create a database user
3. Allow your deployment host in Network Access
4. Copy the connection string into MONGODB_URI

Option 2: Local MongoDB

mongod --dbpath ./data

Option 3: Docker Compose

Use the included docker-compose.yml to run MongoDB alongside the bot.

Database Features

• Automatic schema creation
• Persistent guild, user, ticket, economy, XP, birthday, and plugin config data
• Plugin-specific model namespacing
• Backup-friendly MongoDB storage

---

🔌 Plugins & Marketplace

ADB is designed to be extended. A plugin can:

• Add slash commands
• Override existing commands
• Listen to Discord events
• Register scheduled jobs
• Define MongoDB models
• Hook into bot flows
• Expose its own dashboard
• Provide a settings schema for generated admin UI

Start here:

• CREATE-PLUGIN.md - build a plugin
• REGISTRY-SETUP.md - create or operate a plugin registry
• PLUGINS-ROADMAP.md - platform architecture and roadmap

---

🛠️ Technical Architecture

Modern Tech Stack

• Discord.js v14 - Discord API wrapper
• Node.js 18+ - JavaScript runtime
• MongoDB + Mongoose - Persistent data and schemas
• Google Gemini AI - AI assistant features
• Fastify/Express - Dashboard and internal API surfaces
• React - Administration dashboard

Core Runtime

• Dynamic command and event loading
• Plugin Manager and Hook Bus
• Scheduled jobs via node-cron
• MongoDB-backed guild and user configuration
• Dashboard API for plugin and guild management

See ARCHITECTURE.md for implementation details.

---

📞 Support & Community

• 📖 Documentation - Start with this README and the linked docs
• 🐛 Bug Reports - Open a GitHub issue
• 💡 Feature Requests - Open an issue with the feature proposal
• 🔌 Plugin Ideas - Discuss or submit plugin-focused issues and PRs

---

📄 License

This project is licensed under the MIT License. See LICENSE for details.

🏆 Acknowledgments

• Discord Developer Community - For tooling, examples, and ecosystem knowledge
• Open Source Contributors - For improving the project through issues and PRs
• Plugin Authors - For turning ADB into more than a single-purpose bot
• Everyone self-hosting it - For shaping the project through real-world usage

---

🚀 Build The Bot Your Server Actually Needs

Self-hosted • Plugin-ready • Dashboard-managed

🌟 Star this repo • 🍴 Fork & Deploy • 📖 Read the docs

---

Maintained by @DeadIndian
"One base bot. Any use case."

⬆️ Back to Top