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
Shows active or historical mute information.
/mutelist
Lists active mutes.
/otomute help
Shows administration commands.
/otomute word
Manages profanity words.
/otomute ad
Manages advertising patterns.
/otomute filter
Shows or changes filter state.
/otomute reason

• ...

Manages ready-made mute reasons.
/otomute message

• ...

Manages messages in lang.yml.
/otomute broadcast

• ...

Manages the mute announcement.
/otomute settings

• ...

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.