AutoModerator Plugin for Minecraft Paper 1.21.4

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.

Features

• 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.

Available Commands

/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

Usage Examples

• 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.

Permissions

• 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)

Punishment Logic

1. 1–3 violations in 20 minutes: Kick from server

2. 4th violation: 5-second mute + warning