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:

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:

/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
/pam history <player>	Show detection history
/pam violations <player>	View violation count
/pam violations <player> reset	Reset violations
/pam test <message>	Test moderation detection

---

🚀 Keep Your Server Clean Automatically

PurpleAutoModeration combines traditional moderation tools with modern AI technology to provide a powerful, flexible, and reliable moderation experience for Minecraft communities of any size.