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

• Captcha Verification Require newcomers to pass a captcha challenge before gaining access. Customize grace periods, attempt limits, pre-access roles, success/failure actions, and logging.

• 🤖 AI Moderation (Accelerated only) 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.

• Voice Chat Moderation (Accelerated only) Transcribes and scans live voice channels for violations (e.g., hate speech, self-harm encouragement, harassment). Supports configurable actions and monthly budget controls.

• 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, and more.

• Private API Pool Users can contribute OpenAI keys (encrypted) to a shared pool to increase moderation capacity. Guild-level keys are not used.

---

🧩 Captcha Verification

Require new members to complete a captcha before they can see or interact with the rest of your server. Moderator Bot DMs the verification link (with a public channel fallback) and automatically cleans up pending sessions when members leave. On success, it can grant roles or run other onboarding actions; on failure, it enforces your chosen punishments and logs the outcome.

🔧 Configuration:

• /settings set name=captcha-verification-enabled value=true – Turn captcha verification on or off.
• /settings set name=captcha-grace-period value=10m – Control how long newcomers have to finish the captcha.
• /settings set name=captcha-max-attempts value=3 – Limit how many attempts a user gets before failure actions trigger.
• /settings set name=pre-captcha-roles role=@Visitor – Assign temporary roles while members are awaiting verification.
• /settings set name=captcha-success-actions value="give_role:Member" – Run success actions (e.g., grant roles, clear timeouts) after completion.
• /settings set name=captcha-failure-actions value="timeout:1d" – Apply disciplinary actions when the captcha is failed.

📜 Logging:

• /channels set type=Captcha channel=#mod-logs – Choose where captcha pass/fail embeds are posted.

---

🔺 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.

Budget: AI moderation is capped at $2 per billing cycle. Pricing is $0.45 per 1M tokens; once the cycle budget is reached, autonomous moderation pauses until the next cycle. Note: Enable higher-accuracy AI moderation with gpt-5-mini (approx. 2.25 USD per 1M tokens) via the aimod-high-accuracy setting. This consumes the monthly budget faster than the default gpt-5-nano (0.45 USD per 1M tokens).

🎙️ Voice Chat Moderation

Real-time moderation for Discord voice channels. Audio is transcribed, analyzed by AI, and checked against your configured rules.

🔧 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 check_links – Enable or disable link safety checks
• /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 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
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
nsfw-high-accuracy	bool (Accelerated)	High-accuracy NSFW scans
banned-words-action	list[str]	Action on banned words
exclude-channels	list[TextChannel]	Channels excluded from checks
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-check-interval	TimeString	How often to run AI moderation
no-forward-from-role	list[Role]	Roles that can't forward messages

---