JukeChatFilter

JukeChatFilter

JukeChatFilter is an advanced, fully configurable chat moderation plugin for Minecraft 1.21+ servers. Originally built for jUkESMP, it goes far beyond basic chat filtering - covering every input method players can use to bypass traditional filters.

---

What does it do?

JukeChatFilter scans every way a player can send text on your server:

• 💬 Chat - Blocks inappropriate messages in public chat
• 📢 Commands - Monitors commands like /msg, /tell, /me, and more
• 🪧 Signs - Prevents bad words from being placed on signs
• 📖 Books - Filters written book content before it's submitted
• ⚒️ Anvils - Catches inappropriate item rename attempts

When a player triggers the filter, their message is blocked instantly and they receive a warning in chat and their action bar. No message ever reaches other players.

---

Real-Time Staff Alerts

Staff members with the jukechatfilter.alerts permission receive an instant notification every time the filter is triggered, showing:

• The offending player's name
• The filter type (chat, command, sign, etc.)
• The exact word that triggered the filter
• The full message context

This means your moderation team always knows what's happening, even if they weren't watching chat.

---

Violation Tracking & Automated Punishments

JukeChatFilter keeps a persistent violation count for every player. Each time they trigger the filter, their count goes up. When they hit a configured threshold, a console command is automatically executed - perfect for integrating with punishment plugins like LiteBans or AdvancedBan.

You can configure as many thresholds as you want:

• 15 violations → warn
• 30 violations → mute
• 50 violations → ban

Violation counts persist across restarts, so repeat offenders can never reset their history by logging out.

---

Smart Word Filtering

JukeChatFilter supports both a blocked words list and a whitelisted words list, giving you full control over what gets caught and what doesn't. The whitelist prevents false positives - for example, whitelisting "assassin" ensures it won't be flagged for containing a bad word.

---

Anti-Spam Protection

Built-in anti-spam cooldown prevents players from flooding chat. The cooldown is fully configurable in milliseconds, and players are warned with a message and action bar notification when they send messages too quickly.

---

Commands

| Command | Description |
|---|---|
| /jcf reload | Reload the configuration without restarting |
| /jcf alerts | Toggle real-time staff alerts on/off |
| /chathistory | View a log of all blocked messages |

---

Requirements & Installation

• Server software: Paper or Spigot
• Minecraft version: 1.21+
• Drop the .jar into your /plugins folder and restart
• Configure everything in /plugins/JukeChatFilter/config.yml

---

Originally developed for jUkESMP - built with performance in mind.