Skip to content

Khanmanan/automod-bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ€– 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


πŸš€ 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

git clone https://github.com/Khanmanan/automod-bot.git
cd automod-bot
npm install

Environment Setup

Create a .env file in the root:

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

node index.js

To deploy slash commands globally or per guild:

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

  • Auto-load slash commands by category
  • Help command with pagination and buttons
  • Logging system for moderation actions
  • Toggle-based automod (on/off per rule)
  • 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
Bot Repo: automod-bot


πŸ“œ License

MIT Β© 2025 Khanmanan