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

• 
  Discord webhook notifications

• 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

• Optional moderation dashboard and configuration GUI

• Additional configurable security checks

• Luckperms Compatibility