Skip to content
 
 

Repository files navigation

ModBotX - Advanced Discord AI Moderation Bot

ModBotX Banner
A premium Discord moderation bot with a modern dashboard, hybrid commands, and advanced automod.

Stars License Developers


Overview

ModBotX is a feature-rich Discord moderation and utility bot built with Discord.js v14, Components V2, MongoDB, and a responsive web dashboard.

It is designed for server owners who want strong moderation tools, polished command UX, practical automation, and a clean browser-based control panel for managing their guilds.

Features

  • Advanced automod with static filters, AI-assisted analysis, link controls, and whitelist support
  • Hybrid command system with both slash commands and prefix commands
  • Modern Components V2 responses instead of old embed-heavy flows
  • Responsive dashboard for moderation analytics, automod settings, docs, and command browsing
  • Case logging and moderation history
  • Utility and info commands for server management
  • Ticket and support system modules
  • Multi-guild admin access through Discord OAuth
  • Sharded architecture using discord-hybrid-sharding

Command Highlights

  • Moderation: ban, kick, warn, timeout, untimeout, massban, purge, lock, unlock, case
  • Info: help, ping, serverinfo, userinfo
  • Utility: avatar, botstats, roleinfo
  • Owner: dok, nop

Dashboard

The dashboard includes:

  • Overview analytics
  • Moderation activity insights
  • Auto Moderation controls
  • Command Center
  • Docs & Guides
  • Mobile-friendly layout for Android and desktop browsers

Tech Stack

  • Node.js
  • Discord.js v14
  • MongoDB with Mongoose
  • Express
  • React + Vite
  • discord-hybrid-sharding

Installation

Prerequisites

  • Node.js 20 or newer
  • A MongoDB database
  • A Discord bot application with the required intents enabled

Setup

  1. Clone the repository
git clone https://github.com/aryanshrai3/ModBotX.git
cd ModBotX
  1. Install dependencies
npm install
cd dashboard
npm install
cd ..
  1. Create your environment file

Use example.env as a base and configure:

  • TOKEN
  • CLIENTID
  • CLIENT_SECRET
  • REDIRECT_URI
  • MONGO_URI
  • JWT_SECRET
  1. Update the bot config

Edit:

  • src/config/config.json

Set your prefix, owner IDs, colors, emojis, and other bot preferences.

  1. Build the dashboard
cd dashboard
npm run build
cd ..
  1. Start the bot
npm start

Development

Run the bot and dashboard together:

npm run dev

Credits

Developed by Devrock and Foil

License

This project is licensed under the ModBotX Custom Credit Protection License.

  • Credits to Devrock and Foil must remain intact
  • Redistribution must include the original license
  • Commercial use requires prior written permission from the original developers

See LICENSE for full terms.


(c) 2026 ModBotX Project • Created by Devrock and Foil

Releases

Packages

Contributors

Languages