AutoMute

Discord

PideMann

If you find any bugs or need support, you can contact me here.

AutoMute

AutoMute is a configurable Paper plugin that automatically detects profanity and advertising in chat, cancels the offending message, and applies a temporary mute. Staff can also apply, inspect, list, and remove mutes.

Supported environment

• Paper 1.16.x through 1.21.x (use the matching jar)
• Java 8 or newer
• SQLite by default
• Optional MySQL persistence

Automatic filters

The profanity filter matches configured words as complete words. It does not match a configured word inside a larger word. The advertising filter detects domains, IP addresses, and custom patterns. Operators and players with automute.bypass or automute.exempt are ignored when the corresponding setting is enabled.

Commands

/mute Shows the configured reason codes. /mute Applies the configured duration for a reason. /mute Applies a custom duration and reason. /unmute Removes an active mute. /muteinfo <player|ID> Shows active or historical mute information. /mutelist Lists active mutes. /otomute help Shows administration commands. /otomute word <add|remove|list> Manages profanity words. /otomute ad <add|remove|list> Manages advertising patterns. /otomute filter <status|toggle> <profanity|advertising|general> Shows or changes filter state. /otomute reason <list|add|remove|duration|name> ... Manages ready-made mute reasons. /otomute message <list|set> ... Manages messages in lang.yml. /otomute broadcast <list|add|remove> ... Manages the mute announcement. /otomute settings <list|set> ... Manages filter and announcement settings. /otomute reload Reloads configuration, language, reasons, and stored mutes.

Permissions

automute.mute.reason Use configured reason codes. automute.mute.timed Use custom durations and reasons. automute.mute.any Use both mute modes. automute.unmute Remove mutes. automute.info View mute details. automute.list List active mutes. automute.admin Use all administration functions. automute.exempt Ignore automatic filtering. automute.bypass Ignore automatic filtering.

Storage

Active mutes are stored in mutes.yml and mirrored to SQLite by default. MySQL can be enabled in config.yml. Historical mute records are stored in history.yml. Database credentials remain in the server configuration and are never sent to Modrinth.

Modrinth update notifications

AutoMute checks the public Modrinth versions endpoint for project riym9KGa. It never sends a token, credential, database value, or player data. It does not download or install updates automatically. Operators are notified when they join the server if a newer version is available. The check can be disabled with update-check.enabled: false.