An automatic moderation plugin for Minecraft servers (Paper/Spigot), designed to automatically filter profanity, with a flexible punishment system and convenient administration. Supports three languages, detects obfuscated profanity, tracks violations, and allows real-time filter training.
Profanity filtering in Russian, English, and Romanian with an extendable dictionary.
Obfuscation detection: detects character substitutions, special symbols, and numbers (e.g., "бл@ть", "s#it", "p1zda").
Progressive punishment system: kick → mute → ban, with customizable thresholds and durations.
Flexible punishments: different rules for player groups (e.g., lenient for newcomers, strict for repeat offenders) using permission nodes.
Temporary mute and ban with automatic removal even after a server restart.
Temporary private message ban (/msg, /tell, /w) for multiple violations.
Visual notifications: titles/subtitles, action bars, and tooltips for blocked messages.
Automatic filter training: logs suspicious messages not caught by the filter, allowing quick addition to the blacklist.
SQLite database for storing violations, punishments, and suspicious message logs.
Admin commands: view statistics, top violators, player history, and manage the dictionary.
Moderator notifications about violations and punishments.
Flexible config via config.yml: change all parameters and dictionaries without recompiling.
Permission system to differentiate admin and player capabilities.
/automoderator (aliases: /automod, /am)/automoderator reload — reload config and dictionary
/automoderator status — show summary statistics
/automoderator check <player> — view a player's violations
/automoderator top — top 10 offenders in the past 7 days
/automoderator stats — overall server stats for the past 24 hours
/automoderator player <name> — detailed history of a specific player
/automoderator suspicious — recent suspicious messages (filter training log)
/automoderator suspicious add <word> — add word to blacklist from the log
Reload config and dictionary:
/automoderator reload
Use after editing config.yml or dictionary without restarting the server.
Check player violations:
/automoderator check Steve
Shows the number of violations and punishment history for player Steve.
View top violators:
/automoderator top
Lists the top 10 rule-breakers over the past week.
Server-wide statistics:
/automoderator stats
Shows total violations and unique offenders for the past 24 hours.
Player violation history:
/automoderator player Alex
Displays detailed violation data for player Alex.
Suspicious messages and adding words:
/automoderator suspicious
/automoderator suspicious add exampleword
The first command shows recent suspicious messages, the second adds a word to the blacklist.
Temporary private message ban:
After 2+ violations, players are blocked from using /msg, /tell, /w for 10 minutes. A warning is shown if they attempt to send a message.
Visual notifications:
Blocked messages display a tooltip or title with the reason.
automoderator.notify — receive violation alerts (default: OP)
automoderator.bypass — bypass profanity filter (default: OP)
automoderator.reload — use plugin commands (default: OP)
automoderator.soft — soft punishments (e.g., for newcomers)
automoderator.hard — strict punishments (e.g., for repeat offenders)
1–3 violations in 20 minutes: Kick from server
4th violation: 5-second mute + warning
