🛡️ 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

---