🛡️ Moderator Bot – Free AI Moderation for Discord
Moderator Bot is a free, AI-enhanced Discord moderation tool that automatically enforces rules, removes harmful content, and logs everything—all highly configurable and extensible.
📌 Features Overview
| Feature | Description |
|---|---|
| 🔺 Strikes | Auto-escalating punishments with expiry and custom actions |
| 🤖 AI Moderation | Batch-based AI rule enforcement for text, images, voice, avatars |
| 🚫 Scam Detection | AI and rule-based scam, phishing, and malware protection |
| 💬 Banned Words | Custom and built-in slur list with layered punishment |
| 🖼 NSFW Filtering | Detects NSFW in images, GIFs, and avatars with OpenAI and vector fallback |
| 📊 Logging | Tracks joins, leaves, bans, deletions, timeouts, and more |
| ⚙️ Custom Settings | Everything is tweakable via /settings, including strike timers and actions |
| 🔐 Private API Pool | Bring your own OpenAI key for full privacy |
🔺 Strike System
Automatically escalates punishments:
- 1st Strike → 1d timeout
- 2nd Strike → 7d timeout
- 3rd Strike → Ban
🧠 Fully customizable:
/strikes add_actionfor custom escalations/settings strike-expiryto auto-expire strikes- Logs go to
strike-channel
🤖 AI Moderation (Batch-Based)
Uses OpenAI to moderate user behavior based on configured rules:
- Run every X minutes or on mention (
aimod-mode) - Context-aware moderation (
contextual-ai) - Customizable punishments:
aimod-detection-action - Set rules with
/ai_mod rules_set
🛠 Commands:
/ai_mod toggle,/ai_mod add_action,/ai_mod view_actions
🖼 NSFW Filtering
Detects NSFW in:
- Uploaded media (images, GIFs, stickers)
- Profile pictures (
check-pfp) - Lottie animations and APNGs
Actions:
- Auto-delete or strike:
nsfw-detection-action - Punish NSFW profile pics:
nsfw-pfp-action,nsfw-pfp-message - Auto-unmute clean users:
unmute-on-safe-pfp
🔧 Commands:
/nsfw add_action,/nsfw add_category,/nsfw view_actions/nsfw set_threshold,/nsfw view_threshold
🚫 Scam & Link Protection
Protect against scams and phishing:
- Match messages/URLs:
/scam add_message,/scam add_url - AI-based scam detection:
ai-scam-detection - Google Safe Browsing + PhishTank integration
- Unshortens links to find real targets
- Auto-delete:
delete-scam-messages - Exclude channels:
exclude-scam-channels
🛠 Commands:
/scam settings,/scam view,/scam list_patterns,/scam list_urls
💬 Banned Words System
- Built-in slur list:
use-default-banned-words - Add/remove words:
/bannedwords add,/bannedwords remove - Layered actions per violation (e.g. strike + delete)
- Fully logged in
monitor-channel
🛠 Commands:
/bannedwords view_actions,/bannedwords clear
📊 Monitoring & Logging
- Logs: Joins/leaves, edits/deletes, timeouts, bans, kicks
- Tracks deleted message authors, even if cached
- Tracks invite usage for new members
Set output: /monitor set, via monitor-channel
⚙️ Settings Snapshot
| Name | Type | Description |
|---|---|---|
strike-channel |
TextChannel | Logs strikes |
nsfw-channel |
TextChannel | Logs NSFW content previews |
monitor-channel |
TextChannel | Logs general events |
api-key |
str (encrypted) | Your OpenAI key for NSFW/AI moderation |
strike-expiry |
TimeString | How long a strike lasts (e.g. 30d) |
check-pfp |
bool | Scan avatars for NSFW |
nsfw-pfp-action |
list[str] | Action on NSFW avatars |
nsfw-pfp-message |
str | Message sent when avatar is flagged |
unmute-on-safe-pfp |
bool | Auto-unmute users after safe avatar change |
use-default-banned-words |
bool | Built-in slur list toggle |
exclude-channels |
list[TextChannel] | Exclude from checks |
delete-scam-messages |
bool | Auto-delete scam messages |
scam-detection-action |
list[str] | Actions to take for scam messages |
aimod-model |
str | OpenAI model used (gpt-4o, etc) |
aimod-mode |
str | Run AI mod on mention or interval |
contextual-ai |
bool | Enables context-aware AI moderation |
💬 Command Index
General
/help,/settings,/api_pool,/monitor
/strikes get,/strikes remove,/strikes clear/strikes add_action,/strikes remove_action,/strikes view_actions
/nsfw add_action,/remove_action,/add_category,/view_actions/nsfw set_threshold,/nsfw view_threshold
/ai_mod toggle,/rules_set,/view_actions,/add_action,/remove_action
/bannedwords add,/remove,/defaults,/add_action,/view_actions
/scam settings,/ai_detection,/check_links,/add_message,/add_url,/list_patterns,/list_urls
