PurpleAutoModeration

# PurpleAutoModeration **Advanced AI-Powered Chat Moderation for Minecraft Servers** PurpleAutoModeration is a powerful and highly configurable moderation plugin designed to keep your Minecraft community safe, respectful, and spam-free. Combining traditional word filtering, advanced pattern detection, anti-spam protection, moderator review workflows, and optional OpenAI-powered moderation, it provides a complete solution for modern server administration. --- ## ✨ Features ### 🤖 OpenAI Moderation Integration Leverage OpenAI's moderation models to automatically detect: * Harassment and threats * Hate speech * Violent content * Self-harm content * Sexual content * Illegal activity * And more Configure individual confidence thresholds for every moderation category and decide exactly how your server should react. ### 🔍 Advanced Word Filter Block offensive language using: * Custom blocked word lists * Multi-language support * Regular expressions (regex) * Obfuscation detection * Leetspeak variations * Accent and spacing bypass protection Examples detected automatically: * `fdp` * `f d p` * `n!que ta m3re` * `k y s` * `s t f u` --- ### 👮 Moderator Review System Instead of automatically punishing players, suspicious messages can be sent to a moderator review queue. Features include: * Interactive review requests * One-click **Approve** button * One-click **Punish** button * Pending review storage * Automatic review history Moderators receive complete context: * Player name * Detection category * Confidence score * Original message --- ### ⚡ Flexible Actions Every detector can trigger one or multiple actions: * Delete messages * Censor messages * Notify moderators * Create reviews * Log detections * Send Discord webhooks * Escalate violations * Warn players * Execute custom console commands Mix and match actions for each moderation source. --- ### 📈 Violation Tracking & Escalation Automatically track repeat offenders and escalate punishments. Example configuration: | Violations | Action | | ---------- | -------------- | | 1 | Warning | | 2 | 10-minute mute | | 3 | 1-hour mute | | 4 | 1-day ban | Violation counters can automatically expire after a configurable period. --- ### 🚫 Anti-Spam Protection Built-in anti-spam system featuring: * Message cooldowns * Duplicate message detection * Similar message detection * Flood protection * Repeated character detection * Permission-based bypass support Stops messages like: ```text HELLOOOOOOOOOOOOOOOOO buy now buy now buy now spam spam spam spam ``` before they flood your chat. --- ### 📊 Moderation History & Statistics Track moderation activity with: * Player violation history * Recent detections * Review logs * Moderation statistics * Stored evidence for staff investigations Useful commands include: ```text /pam history <player> /pam violations <player> /pam stats ``` --- ### 🌐 Discord Webhook Support Send moderation alerts directly to Discord. Webhook notifications can include: * Player name * Detection category * Confidence score * Original message * Timestamp Perfect for keeping staff informed even when they are offline. --- ### 💾 Multiple Storage Options Choose the storage system that fits your infrastructure: * YAML * SQLite * MySQL All moderation data, reviews, violations, and statistics are safely persisted. --- ### 🌍 Multi-Language Support PurpleAutoModeration supports language files and can be fully translated. Included languages: * English * French Create your own language files to support any community. --- ## 🛡️ Designed for Real Communities Whether you run: * Survival servers * Factions servers * Prison servers * Skyblock networks * Minigame networks * Roleplay communities PurpleAutoModeration helps reduce toxicity, automate moderation tasks, and improve player experience without replacing your staff team. --- ## 🎯 Why PurpleAutoModeration? ✅ AI-powered moderation ✅ Advanced profanity detection ✅ Anti-spam protection ✅ Interactive moderator reviews ✅ Violation escalation system ✅ Discord integration ✅ MySQL support ✅ Fully configurable actions ✅ Multi-language support ✅ Lightweight and production-ready --- ## 🔧 Permissions | Permission | Description | | ---------------------------------- | --------------------------------------------- | | `purpleautomoderation.review` | Receive moderation alerts and review requests | | `purpleautomoderation.bypass.spam` | Bypass anti-spam protection | --- ## 📜 Commands | Command | Description | | -------------------------------- | ----------------------------- | | `/pam reload` | Reload configuration files | | `/pam stats` | Display moderation statistics | | `/pam review` | Manage pending reviews