ExChatMod

A Chat Moderation Plugin, Also comes with an AI moderation system!

Quick challenge

How far can you run before the mobs catch you?

ExChatMod

✦ ExChatMod

A powerful, AI-ready chat moderation plugin for modern Paper servers.

Clean. Smart. Secure.

---

✦ Overview

ExChatMod provides real-time chat moderation with AI filtering, spam protection, auto-mute systems, and a full admin GUI.

Intercept messages → Analyze → Flag or Block → Auto-Moderate.

Built for modern Paper servers.

---

✦ Core Moderation

• Real-time chat interception (`AsyncPlayerChatEvent`) • Bypass permission: `exchatmod.bypass` • Configurable max message length • Optional blocking of muted players’ commands

Reliable first-line protection for any server.

---

✦ AI Moderation

Optional OpenAI-compatible AI filtering.

• ALLOW / BLOCK system with sensitivity levels (1–10) • Configurable provider, model, base URL, API key, timeout • Allowed-models allowlist • Auto-disable if API key missing • Debug logging for failed requests • Only BLOCK responses trigger flags

Smart filtering without false positives.

---

✦ Word Filter

• Case-insensitive blocked words list • Actions: MUTE, MUTE, or MUTE • Default mute duration with cap • Staff notifications on word-filter mutes • Flagged message logging

Flexible manual moderation layer.

---

✦ Anti-Links

• Regex URL detection • Allowlist for safe links • Optional flag counting • Message blocking on detection

Stop unwanted ads and scams.

---

✦ Anti-Spam

• Cooldown-based rate limiting • Duplicate message detection • Configurable duplicate threshold • Optional flag counting • Automatic spam blocking

No more chat flooding.

---

✦ Anti-Caps

• Minimum letters before check • Uppercase percentage threshold • Optional flag counting • Blocks excessive caps

Keeps chat readable.

---

✦ Flagging System

• Flags tracked per player UUID • Stores last 10 flagged messages • Auto-mute on threshold • Staff alerts on flagged messages • Saved to `flags.yml`

Smart escalation without manual work.

---

✦ Mute System

• Temporary or permanent mutes • Default & max mute duration limits • Expired mutes auto-cleared • Remaining mute time shown to players • Saved to `mutes.yml`

Consistent punishment handling.

---

✦ Logging

• Full chat logging to file • Flagged chat → `logs/flagged.log` • Optional logging modes • `[FLAGGED]` markers for quick review

Track everything safely.

---

✦ Staff Notifications

Staff alerted on:

• Flagged messages • Auto-mute actions • Word-filter mutes • Manual mute actions

Permissions: `exchatmod.admin` / `exchatmod.notify`

Stay informed instantly.

---

✦ Commands

• `/chatmod reload` – reload configs • `/chatmod mute <player> [duration]` • `/chatmod unmute <player>` • `/chatmod admin` – open GUI • `/chatmod help` Aliases: `/cm`, `/chatmoderation`

Includes full tab completion.

---

✦ Admin GUI

Clean GUI with live moderation controls.

• Toggle AI / filters / anti-spam / anti-caps • Reload config • Clear flags or mutes • View flagged players with pagination • Per-player actions (mute, unmute, clear flags) • Live stats display

Moderate without commands.

---

✦ Messaging & Config

• Fully configurable `messages.yml` • Hex colors & `&` color support • `config.yml`, `mutes.yml`, `flags.yml` • Auto-created logs directory • Safe config reload

Fully customizable.

---