🛡️ 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
reportmode 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 betweenreportorintervalscanning/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 |