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

---

Moderator Bot

Free AI-powered moderation for Discord. Detects nudity, gore, scams, and other violations in messages, media, and avatars. 

التصويت لـModerator Bot