An open API service indexing awesome lists of open source software.

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: 1 day ago
JSON representation

Moderation bot discord

Awesome Lists containing this project

README

        

# ๐Ÿค– Automod Bot

A powerful moderation Discord bot built with Discord.js v14, Mongoose, and Firebase, designed to keep your server clean, safe, and automated.

![Automod Banner](https://cwkbot.fun/botbanner.png)

---

## ๐Ÿš€ 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.

- Moderation
- Utility
- Configuration
- Logging

---

## ๐Ÿ“Œ 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 (match drift.rip style)
- [ ] Analytics dashboard (number of mutes/bans per day)
- [ ] Multi-language support

---

## ๐Ÿ‘ค Author

**Khanmanan**
GitHub: [@Khanmanan](https://github.com/Khanmanan)
Bot Repo: [automod-bot](https://github.com/Khanmanan/automod-bot)

---

## ๐Ÿ“œ License

MIT ยฉ 2025 Khanmanan