Skip to content

batminecraft/PurpleAutoMod

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

Advanced AI-Powered Chat Moderation for Minecraft Servers

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages