https://github.com/khanmanan/automod-bot
Moderation bot discord
https://github.com/khanmanan/automod-bot
discor-bot discord discord-fun discord-js-bot discord-moderation discord-moderation-bot discord-music-bot discord-music-bot-24-7 discordjs discordjs-bot discordjsbot glitch moderation-bot nsfw replit watch youtube youtube-bot
Last synced: 10 months ago
JSON representation
Moderation bot discord
- Host: GitHub
- URL: https://github.com/khanmanan/automod-bot
- Owner: Khanmanan
- License: other
- Created: 2021-05-19T19:13:07.000Z (almost 5 years ago)
- Default Branch: v2
- Last Pushed: 2025-03-31T15:37:42.000Z (12 months ago)
- Last Synced: 2025-04-13T10:31:28.178Z (11 months ago)
- Topics: discor-bot, discord, discord-fun, discord-js-bot, discord-moderation, discord-moderation-bot, discord-music-bot, discord-music-bot-24-7, discordjs, discordjs-bot, discordjsbot, glitch, moderation-bot, nsfw, replit, watch, youtube, youtube-bot
- Language: Dockerfile
- Homepage: https://cwkhan.xyz/discord
- Size: 688 KB
- Stars: 270
- Watchers: 10
- Forks: 274
- Open Issues: 39
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# 🤖 Automod Bot
A powerful moderation Discord bot built with Discord.js v14, Mongoose, designed to keep your server clean, safe, and automated.
---
[invite the bot](https://discord.com/oauth2/authorize?client_id=1363943273374154842&permissions=8&scope=bot%20applications.Commands)
## 🚀 Features
- Slash commands with auto-detection and pagination help menu
- Automod with toggle system per server (anti-link, anti-spam, anti-mention, etc.)
- Database logging (MongoDB + Mongoose)
- Moderation tools: Warn, Kick, Ban, TempBan, Mute, Unmute
- Logging system for actions like message delete/edit
- Web dashboard integration (soon)
- Discord OAuth for authentication (in progress)
---
## 🛠 Setup
### Prerequisites
- Node.js v18 or higher
- MongoDB URI (local or cloud)
- Discord Bot Token
- Firebase setup (optional)
### Installation
```bash
git clone https://github.com/Khanmanan/automod-bot.git
cd automod-bot
npm install
```
### Environment Setup
Create a `.env` file in the root:
```env
TOKEN=your_discord_token
MONGO_URI=your_mongo_connection
CLIENT_ID=your_bot_client_id
GUILD_ID=your_guild_id (for testing commands)
```
### Running the Bot
```bash
node index.js
```
To deploy slash commands globally or per guild:
```bash
node deploy.js
```
---
## 🧩 Commands
All commands are organized in the `/commands` folder and auto-loaded by category. Use `/help` to view all.
- Admin
- Info
- Moderation
- General
- Owner
---
## 📌 TODO List
### 🔧 Core Features
- [x] Auto-load slash commands by category
- [x] Help command with pagination and buttons
- [x] Logging system for moderation actions
- [x] Toggle-based automod (on/off per rule)
- [x] Rate-limited buttons on help command
### 🌐 Web Dashboard
- [ ] Discord OAuth2 login
- [ ] Guild selector
- [ ] Toggle Automod settings from UI
- [ ] View mod logs and history
### 🧪 Future Ideas
- [ ] Captcha on join (anti-raid)
- [ ] Dashboard theming (Dark )
- [ ] Analytics dashboard (number of mutes/bans per day)
- [ ] Multi-language support
---
Bot support server
## 👤 Author
**Khanmanan**
GitHub: [@Khanmanan](https://github.com/Khanmanan)
Bot Repo: [automod-bot](https://github.com/Khanmanan/automod-bot)
---
## 📜 License
MIT © 2025 Khanmanan