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.
- 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
- Moderation:
ban,kick,warn,timeout,untimeout,massban,purge,lock,unlock,case - Info:
help,ping,serverinfo,userinfo - Utility:
avatar,botstats,roleinfo - Owner:
dok,nop
The dashboard includes:
- Overview analytics
- Moderation activity insights
- Auto Moderation controls
- Command Center
- Docs & Guides
- Mobile-friendly layout for Android and desktop browsers
- Node.js
- Discord.js v14
- MongoDB with Mongoose
- Express
- React + Vite
- discord-hybrid-sharding
- Node.js 20 or newer
- A MongoDB database
- A Discord bot application with the required intents enabled
- Clone the repository
git clone https://github.com/aryanshrai3/ModBotX.git
cd ModBotX- Install dependencies
npm install
cd dashboard
npm install
cd ..- Create your environment file
Use example.env as a base and configure:
TOKENCLIENTIDCLIENT_SECRETREDIRECT_URIMONGO_URIJWT_SECRET
- Update the bot config
Edit:
src/config/config.json
Set your prefix, owner IDs, colors, emojis, and other bot preferences.
- Build the dashboard
cd dashboard
npm run build
cd ..- Start the bot
npm startRun the bot and dashboard together:
npm run devDeveloped by Devrock and Foil
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
