🛡️ Moderator Bot
Free AI-powered moderation for Discord. Detects nudity, gore, scams, and other violations in messages, media, and avatars. Fully configurable via slash commands.

📌 Features Overview

Anti-NSFW
Detects explicit or harmful content in uploaded media (images, GIFs, Lottie, APNG), Tenor GIFs, and user avatars. Categories include nudity, sexual content, graphic violence, gore, and self-harm-related material.

Strikes
Escalating punishment system with custom durations, action cycling, and optional DM notifications. Fully configurable.

AI Moderation
Uses OpenAI models to moderate messages based on rules. Supports autonomous mode, batch scanning, and context-aware enforcement.
Default: AI moderation runs in report mode when users @mention the bot.

Scam Detection
Detects scam/phishing messages using patterns, Google Safe Browsing, PhishTank, and link unshortening.

Banned Words
Blocks slurs or custom words. Supports layered punishment and integrates with strikes.

Logging
Tracks joins, leaves, bans, deletions, edits, timeouts, and invite usage.

Custom Settings
Slash-command-driven configuration for rules, thresholds, exclusions, models, and more.

Private API Pool
Users can contribute OpenAI keys (encrypted) to increase moderation capacity.



🔺 Strike System
Automatically issues escalating punishments based on a user’s strike count:

1st Strike → 1d timeout
2nd Strike → 7d timeout
3rd Strike → Ban

⚙️ Commands:

/strikes strike – Manually give a strike to a user
/strikes get – View a user's current strikes
/strikes clear – Remove all active strikes from a user
/strikes remove – Remove a specific strike by ID
/strikes add_action – Add an action for a strike level
/strikes remove_action – Remove a strike action
/strikes view_actions – View configured strike actions
/intimidate – Issue a serious warning (DM or channel)


🤖 AI Moderation
Uses OpenAI to detect violations in user messages.
🔧 Configuration:

/ai_mod rules_set – Define custom server rules
/ai_mod set_mode – Choose between report or interval scanning
/ai_mod toggle – Enable/disable autonomous moderation
/ai_mod add_adaptive_event – Add adaptive triggers
/ai_mod remove_adaptive_event – Remove adaptive triggers

⚙️ Actions:

/ai_mod add_action – Define what happens on violations
/ai_mod remove_action – Remove an AI action
/ai_mod view_actions – Show all AI-triggered actions
/ai_mod clear_adaptive_events – Clear all adaptive triggers
/ai_mod view_adaptive_events – List active adaptive triggers


🖼 NSFW Filtering
Detects nudity, graphic violence, and explicit content in:

Uploaded media (images, GIFs, stickers, emojis, videos)
Tenor GIFs
Profile pictures
Lottie / APNG animations

🔧 Configuration:

/nsfw set_threshold – Set detection confidence
/nsfw add_category – Add custom categories to detect
/nsfw add_action – Action to take when NSFW is detected
/nsfw remove_action – Remove NSFW actions

📜 Inspection:

/nsfw view_actions – View active actions
/nsfw view_threshold – Check the current threshold


❌ Scam & Link Protection
Detects and removes scam/phishing messages using:

Pattern and URL matching
Google Safe Browsing & PhishTank integration
Smart link unshortening with scam checks

🔧 Configuration:

/scam add_message – Add scam message patterns
/scam add_url – Add scam URL substrings
/scam delete – Toggle auto-deletion of flagged messages
/scam check_links – Enable or disable link safety checks
/scam ai_detection – Enable or disable AI-based scam detection
/scam exclude_channel_add – Exclude a channel from scam detection
/scam exclude_channel_remove – Remove a channel from the exclusion list
/scam view – Show current scam detection settings

⚙️ Actions:

/scam add_action – Add moderation actions (e.g., timeout, ban)
/scam remove_action – Remove configured actions
/scam settings – Manage detection settings

📜 Logs & Lists:

/scam list_patterns – View custom scam message patterns
/scam list_urls – View added scam URLs
/scam exclude_channel_list – View excluded channels


💬 Banned Words System
Blocks slurs and custom word lists.
🔧 Configuration:

/bannedwords add – Add a custom banned word
/bannedwords remove – Remove a word from the list
/bannedwords defaults – Enable default slur list
/bannedwords clear – Clear all custom banned words
/bannedwords add_action – Set action when banned words are triggered
/bannedwords remove_action – Remove a word action

📜 Inspection:

/bannedwords view_actions – View all punishment actions


📊 Monitoring & Logging
Tracks and logs key server events:

Joins, leaves, bans, kicks
Edits, deletions, timeouts
Message deletions and audit logs
Invite usage tracking

🔧 Configuration:

/monitor set – Set log output channel
/monitor remove – Disable monitoring
/monitor show – View current log channel


⚙️ Settings Snapshot



Name
Type
Description




api-key
str (encrypted)
OpenAI key for AI/NSFW moderation


strike-expiry
TimeString
Duration before strikes expire


cycle-strike-actions
bool
Loop fallback strike actions


dm-on-strike
bool
DM users when they receive a strike


check-pfp
bool
Scan avatars for NSFW


nsfw-pfp-action
list[str]
Action on NSFW avatars


nsfw-pfp-message
str
Message on NSFW avatar detection


unmute-on-safe-pfp
bool
Auto-unmute on safe avatar change


check-tenor-gifs
bool
Scan Tenor GIFs for NSFW


banned-words-action
list[str]
Action on banned words


exclude-channels
list[TextChannel]
Channels excluded from checks


delete-scam-messages
bool
Auto-delete scam messages


scam-detection-action
list[str]
Actions for scam messages


check-links
bool
Enable URL safety checks


exclude-scam-channels
list[TextChannel]
Skip scam checks in these channels


aimod-model
str
Model used for AI mod


aimod-check-interval
TimeString
How often to run AI moderation


no-forward-from-role
list[Role]
Roles that can't forward messages