Moderator Bot automatically finds the best language for your server. Applicable to the website as well.

Now supports 30 languages

This project has a complementary web interface that you can use to control or configure your experience

Web Interface

This bot offers extra features or perks that can be unlocked through optional payments or subscriptions.

Paid Features Available

Whether the current project contains any paid features, is paid only, or is 100% free to use.

This project is free to use and contains no paywalls for core functionality.

Has Paid Features

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

Learn more at https://modbot.neomechanical.com.

---

## 📌 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.

* **Support Tickets (Discord Ticket System)**
  Built-in Discord support ticket system / help desk. Members can open private tickets, staff can respond, and transcripts can be logged when tickets close.

* **🤖 AI Ticket Agent** *(Accelerated Pro/Ultra)*
  Let an AI support agent reply inside tickets using your provided context/knowledge base. You can choose what it’s allowed to do (reply only, close tickets, or escalate to a human support role).

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

* **FAQ Auto Replies**
  Instantly answer recurring questions with saved responses, with optional direct replies for Accelerated servers.

* **Banned URL Enforcement**
  Catch blocked domains or exact links and trigger custom actions the moment they appear.

* **Web Dashboard**
  Configure your Discord moderation bot settings, ticket system, FAQ auto replies, and Accelerated subscriptions from https://modbot.neomechanical.com.

* **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.
* `/settings set name=captcha-delivery-method value=embed` – Deliver captcha prompts via DM or a persistent embed in your server.
* `/settings set name=captcha-embed-channel-id channel=#verify-here` – Choose the channel that hosts the verification embed.
* `/settings set name=vpn-detection-enabled value=true` – Screen newcomers for VPNs and proxies before allowing access.
* `/settings set name=vpn-pre-actions value="remove_role:Visitor"` – Adjust roles before VPN screening; pair with `vpn-post-actions` to grant roles after a clean result.
* `/settings set name=vpn-detection-actions value="kick"` – Decide what happens when VPN screening fails (e.g., kick, timeout).

### 📜 Logging:

* `/channels set type=Captcha channel=#mod-logs` – Choose where captcha pass/fail embeds are posted.
* `/settings set name=captcha-log-channel channel=#captcha-logs` – Send detailed verification events to a dedicated channel.

### 🛡️ Verification Extras:

* `/verification sync` – Refresh the verification embed after changing its design or settings.
* `/verification request member=@User` – Manually trigger the captcha & VPN flow for a specific member.

---

## 🔺 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 has a monthly usage limit to keep costs predictable for your server.
Note: You can enable higher-accuracy AI moderation on supported plans (it uses more 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
* `/settings set name=exclude-bannedwords-channels value="#memes"` – Exclude light-hearted channels from filtering.
* `/settings set name=use-default-banned-words value=true` – Pair your custom list with the built-in profanity filter.

### 📜 Inspection:

* `/bannedwords view_actions` – View all punishment actions

---

## ❓ FAQ Auto Replies

Answer repeat questions automatically. Moderator Bot listens for incoming messages, finds the best match, and responds with your saved answer.

### 🔧 Configuration:

* `/faq enable enabled:true` – Turn automatic FAQ replies on (or set `false` to pause them).
* `/settings set name=faq-threshold value=0.72` – Adjust how closely a message must match before the bot replies.
* `/settings set name=faq-direct-reply value=true` – (Accelerated) Respond directly in the channel instead of posting an embed.

### ✏️ Commands:

* `/faq add question:"How do I appeal?" answer:"Appeal instructions..."` – Save a new entry.
* `/faq remove entry_id:123` – Delete a stored answer.
* `/faq list` – Review your current FAQ catalogue.

---

## 🔗 Banned URL Enforcement

Block specific domains or exact links and apply custom punishments when they appear.

### 🔧 Configuration:

* `/bannedurls add url:badsite.com` – Add a domain or full URL to the blocked list.
* `/bannedurls remove url:badsite.com` – Unblock a link.
* `/bannedurls list` – Export the current list as a file.
* `/bannedurls clear` – Wipe all blocked URLs.
* `/bannedurls add_action action:timeout duration:1d` – Decide what happens when a banned link is posted.
* `/settings set name=exclude-url-channels value="#partnerships"` – Allow specific channels to bypass URL blocking.

### 📜 Inspection:

* `/bannedurls view_actions` – Review the enforcement actions currently configured.

---

## 📊 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

---

## 🖥️ Web Dashboard & Self-Service

Access https://modbot.neomechanical.com to review moderation stats, tune settings, and manage your Accelerated subscription.

### 🔧 Quick Actions:

* `/dashboard` – Receive a private link to your server’s dashboard.
* `/accelerated status` – Check your current Accelerated tier and renewal date.
* `/accelerated subscribe` – Generate an upgrade link for your guild.
* `/accelerated cancel` – Get instructions for cancelling your subscription.

---

## ⚙️ Settings Snapshot

| Name                               | Type                  | Description                                         |
| ---------------------------------- | --------------------- | --------------------------------------------------- |
| `strike-channel`                   | TextChannel           | Channel where strike embeds are posted              |
| `strike-expiry`                    | TimeString            | Duration before strikes expire                      |
| `cycle-strike-actions`             | bool                  | Loop fallback strike actions                        |
| `strike-actions`                   | dict\[str, list\[str]] | Custom actions for each strike level                |
| `dm-on-strike`                     | bool                  | DM users when they receive a strike                 |
| `use-default-banned-words`         | bool                  | Enable the built-in profanity list                  |
| `banned-words-action`              | list\[str]            | Action on banned words                              |
| `exclude-bannedwords-channels`     | list\[TextChannel]    | Channels excluded from banned words scanning        |
| `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                            |
| `exclude-channels`                 | list\[TextChannel]    | Channels excluded from checks                       |
| `monitor-channel`                  | TextChannel           | All-purpose moderation log channel                  |
| `monitor-events`                   | dict\[str, bool]      | Toggle individual logging events                    |
| `scam-detection-action`            | list\[str]            | Actions for scam messages                           |
| `delete-scam-messages`             | bool                  | Auto-delete detected scam content                   |
| `check-links`                      | bool                  | Enable URL safety checks                            |
| `exclude-scam-channels`            | list\[TextChannel]    | Skip scam checks in these channels                  |
| `banned-urls`                      | list\[str]            | Custom list of blocked links                        |
| `url-detection-action`             | list\[str]            | Actions when banned URLs appear                     |
| `exclude-url-channels`             | list\[TextChannel]    | Channels that bypass URL blocking                   |
| `aimod-channel`                    | TextChannel           | Where AI violation logs are posted                  |
| `aimod-debug`                      | bool                  | Always share detailed AI moderation context         |
| `aimod-check-interval`             | TimeString            | How often to run AI moderation                      |
| `aimod-mode`                       | str                   | Choose `report`, `interval`, or `adaptive` scanning |
| `aimod-adaptive-events`            | dict\[str, list\[str]] | Events that shift AI moderation modes               |
| `aimod-detection-action`           | list\[str]            | Action when AI moderation flags content             |
| `aimod-high-accuracy`              | bool (Accelerated)    | Use gpt-5-mini for tighter moderation               |
| `autonomous-mod`                   | bool (Accelerated)    | Let AI enforce rules automatically                  |
| `no-forward-from-role`             | list\[Role]           | Roles that can't forward messages                   |
| `faq-enabled`                      | bool                  | Toggle automatic FAQ replies                        |
| `faq-threshold`                    | float                 | Match score required before replying                |
| `faq-direct-reply`                 | bool (Accelerated)    | Reply directly instead of using embeds              |
| `captcha-log-channel`              | TextChannel           | Verification log channel                            |
| `captcha-delivery-method`          | str                   | Choose DM or embed delivery for captcha             |
| `captcha-embed-channel-id`         | TextChannel           | Channel hosting the captcha embed                   |
| `pre-captcha-roles`                | list\[Role]           | Roles assigned before verification                  |
| `captcha-success-actions`          | list\[str]            | Actions after passing verification                  |
| `captcha-failure-actions`          | list\[str]            | Actions after failing verification                  |
| `vpn-detection-enabled`            | bool                  | Screen newcomers for VPN usage                      |
| `vpn-detection-actions`            | list\[str]            | Actions when VPN screening fails                    |
| `vpn-pre-actions`                  | list\[str]            | Role adjustments before VPN screening               |
| `vpn-post-actions`                 | list\[str]            | Role adjustments after VPN screening succeeds       |
| `vcmod-enabled`                    | bool (Accelerated)    | Enable voice moderation                             |
| `vcmod-channels`                   | list\[VoiceChannel \| StageChannel] | Voice/stage channels monitored by the bot           |
| `vcmod-categories`                 | list\[CategoryChannel] | Voice categories whose channels are cycled          |
| `vcmod-listen-duration`            | TimeString            | Active listening window per channel                 |
| `vcmod-idle-duration`              | TimeString            | Pause between transcripts in saver mode             |
| `vcmod-saver-mode`                 | bool                  | Lightweight cycling without constant recording      |
| `vcmod-rules`                      | str                   | Custom rules for voice chat moderation              |
| `vcmod-detection-action`           | list\[str]            | Response when voice moderation flags audio          |
| `vcmod-high-accuracy`              | bool (Accelerated)    | Higher-accuracy voice analysis                      |
| `vcmod-high-quality-transcription` | bool (Accelerated)    | Premium transcription quality                       |
| `vcmod-transcript-channel`         | TextChannel           | Where transcripts are posted                        |
| `vcmod-transcript-only`            | bool                  | Transcribe voice chat without enforcing rules       |
| `vcmod-join-announcement`          | bool                  | Play TTS when the bot joins a voice channel         |

---


Moderator Bot

Free, unlimited anti-NSFW protection, captcha verification, and advanced multimodal AI moderation.

Stemmen voor Moderator Bot

Wil je ons ondersteunen?