Rich (BB code):
AdvancedChatFilter
A powerful, modern, and lightweight chat moderation plugin for Spigot / Paper 1.20+
Filter swearing • Block advertising • Auto-mute offenders • Stop spam • Prevent excessive caps
Keep your server chat clean, professional, and under control.
AdvancedChatFilter is a production-ready chat moderation plugin built for servers that want strong filtering, smart detection, and lightweight performance without unnecessary complexity.It goes beyond simple word matching by using advanced message normalization to catch bypass attempts such as:
- spacing letters out
- using dots or symbols
- leetspeak replacements
- repeated characters
Whether you're running a survival server, minigame network, factions server, or community SMP, AdvancedChatFilter helps you maintain a cleaner player experience with configurable and automatic moderation tools.
✦ Core Features
Chat Filter
Block configurable swear words from your config.yml with smart normalization before checking.
- Removes spaces between letters → catches messages like f u c k
- Removes dots and special characters → catches f.u.c.k
- Replaces common leetspeak → 4 → a, 3 → e, 1 → i, 0 → o
- Converts everything to lowercase
- Removes repeated characters → catches fuuuuck
- Cancels blocked chat messages instantly
- Sends a clear warning to the player
Player warning: ᴄʜᴀᴛ ꜰɪʟᴛᴇʀ »»» ɴᴏ ꜱᴡᴇᴀʀɪɴɢ ɪɴ ᴄʜᴀᴛ
Advertising Blocker
Instantly detect and block common advertising attempts before they reach chat.
- Detects http://
- Detects https://
- Detects www.
- Detects discord.gg
- Detects domain endings such as [.com], [.net], [.org], and more
- Detects IPv4 addresses using regex
- Cancels advertising messages
- Automatically mutes the player
- Alerts staff members in chat
Default auto-mute duration: 300 seconds (5 minutes)
Player warning: ᴄʜᴀᴛ ꜰɪʟᴛᴇʀ »»» ʏᴏᴜ ᴀʀᴇ ᴍᴜᴛᴇᴅ ꜰᴏʀ 5 ᴍɪɴᴜᴛᴇꜱ ꜰᴏʀ ᴀᴅᴠᴇʀᴛɪꜱɪɴɢ
Mute System
Built-in mute management makes moderation simple and fast for staff.
- Mute players for a custom amount of time
- Unmute players instantly
- Check mute status
- View active mute list
- View player mute history
- Prevent muted players from chatting
- Show remaining mute time when they try to speak
- Automatically unmute expired punishments
- Logs mutes to mutelog.txt
Spam Filter
Stop repetitive chat spam automatically with configurable anti-spam protection.
- Detects when the same or similar message is sent multiple times
- Default behavior: 3 messages in 10 seconds
- Cancels the spam message
- Warns the player
- Alerts staff
- Fully configurable
Caps Filter
Reduce shouting and messy chat with automatic excessive caps detection.
- Blocks messages with too much uppercase text
- Default threshold: 70%+ caps
- Cancels the message
- Warns the player
- Threshold is configurable
Staff Alerts
Keep your moderation team informed in real time whenever the plugin blocks suspicious chat activity.
- Permission-based alerts
- Clean and readable format
- Great for active staff moderation
Permission: acf.alerts
Format: &c&l[ACF Alert] &f%player% → %message%
PlaceholderAPI Support
Optional PlaceholderAPI integration is included if PlaceholderAPI is installed on your server.
- %acf_muted%
- %acf_mutetime%
- %acf_filtered%
Discord Webhook Support
Optionally send moderation activity through a configurable Discord webhook for better staff oversight outside the game.
- Optional feature
- Can be enabled or disabled in the config
- Useful for staff teams managing punishments and chat violations remotely
✦ Commands
/acf reload - Reload the plugin configuration /acf mute <player> <seconds> - Mute a player /acf unmute <player> - Unmute a player /acf check <player> - Check a player's mute status /acf mutelist - View currently muted players /acf history <player> - View a player's mute history
✦ Permissions
acf.bypass - Bypass the chat filter systems acf.alerts - Receive staff alerts acf.reload - Use /acf reload acf.mute - Use /acf mute acf.unmute - Use /acf unmute acf.check - Use /acf check acf.history - Use /acf history acf.mutelist - Use /acf mutelist
Permission root: acf.*
✦ Configuration
AdvancedChatFilter includes a clean, beginner-friendly, and well-commented configuration file so server owners can quickly adjust moderation behavior without confusion.
- Mute duration settings
- Spam filter settings
- Caps filter settings
- Blocked words list
- Staff alert toggle
- Discord webhook section
✦ Why Choose AdvancedChatFilter?
- Modern filtering logic that catches common bypass methods
- Lightweight and optimized for production use
- No required external dependencies
- Optional integrations for PlaceholderAPI and Discord webhook usage
- Well-structured moderation tools in one plugin
- Designed for Spigot / Paper 1.20+
✦ Compatibility
- Server Software: Spigot / Paper
- Minecraft Version: 1.20+
- Dependencies: None required
- Optional Support: PlaceholderAPI, Discord Webhooks
AdvancedChatFilter
Smart filtering. Clean chat. Better moderation.
