Chat AutoMod

Chat AutoMod is a lightweight, server-side moderation mod for Fabric servers.

It automatically checks player messages for spam, excessive caps, repeated characters, advertising, suspicious links and configurable filtered words or phrases. Messages can be blocked, logged or reported to online staff without requiring any external moderation service.

Players do not need to install the mod to join the server.

Features

Message cooldown and rapid-spam detection
Duplicate and similar-message detection
Excessive caps detection
Repeated-character and symbol spam detection
Unicode and zero-width character normalization
Configurable word and phrase filters
Basic leetspeak and obfuscation detection
Domain, IP address and Discord invite detection
Configurable allowed domains
Score-based violation system
Temporary and permanent mutes
Configurable punishment commands
Staff moderation alerts
Violation history
Plain-text moderation logs
Live configuration reload
Message testing command
Permission and bypass support
No required client installation
No AI services or external moderation APIs

Score-based punishments

Chat AutoMod does not have to immediately punish a player for every violation.

Each rule can add a configurable number of points. Different actions can then be applied when the player reaches certain score thresholds.

For example:

{
  "2": "warn",
  "5": "mute 5m",
  "10": "kick",
  "20": "permanent mute"
}

Violation points automatically decay after a configurable amount of time.

This allows servers to treat occasional minor violations differently from repeated or severe abuse.

Configurable actions

Each moderation rule can independently:

Allow the message
Block the message
Notify staff
Warn the player
Add violation points
Temporarily mute the player
Permanently mute the player
Kick the player
Execute a configurable server command

Administration commands

/automod reload
/automod test <message>
/automod history <player>
/automod violations <player>
/automod clear <player>
/automod mute <player> <duration>
/automod unmute <player>
/automod inspect

The /automod test command runs a message through the active moderation rules without punishing anyone.

Example:

/automod test join my server example dot com

The result shows:

Matched:
- advertising.domain_obfuscation

Normalized:
join my server example.com

Action:
Message blocked

Points:
+5

This makes it much easier to configure and test filters without using another account.

Privacy

Original player messages are not stored by default.

Server owners can optionally enable message storage for moderation logs and violation history. Automatic log retention can also be configured.

Supported versions

Minecraft 1.21.1 Fabric
Minecraft 26.2 Fabric

Chat AutoMod is intended to remain server-side only. Vanilla clients can join without installing it.

Planned features

Moderation of private-message commands such as /msg, /tell and /reply
NeoForge support
Discord webhook notifications
Optional moderation dashboard and configuration GUI
Additional configurable security checks
Luckperms Compatibility

Auto Mod Chat Moderation