🛡️ SiuuuChatFilter – The Ultimate Highly Configurable Chat Filter

Keep your server chat clean and toxicity-free with SiuuuChatFilter — a lightweight yet extremely powerful chat moderation plugin for Spigot and Paper servers.

Unlike simple word filters, SiuuuChatFilter doesn't just block prohibited words. It features a complete Strike System, allowing you to define exactly what happens when players break the rules.

Want to simply delete the message? Issue a warning? Kick the player? Temporarily ban them? Permanently ban them? Execute a custom command? The choice is yours.

---

Features

Custom Word Filter

Add any prohibited words directly in the config.yml.

Examples:

blocked-words:
  - word1
  - word2
  - word3

---

Automatic Message Removal

Messages containing prohibited words are instantly blocked and removed from chat.

• Chat event gets cancelled
• Other players never see the message
• Keeps your chat clean automatically

---

Staff Alert System

Staff members can still see filtered messages through configurable alerts.

Players with the alert permission receive information about:

• The player who sent the message
• The violation count
• The exact blocked message

This allows moderators to monitor chat activity without exposing inappropriate content to regular players.

---

Advanced Strike & Punishment System

Configure different punishments based on how many violations a player has accumulated.

Available punishment types:

• Delete Message Only
• Kick Player
• Temporary Ban
• Permanent Ban
• Execute Custom Commands

Examples:

| Strike Count | Punishment |
|--------------|------------|
| 1 | Delete Message |
| 2 | Warning Command |
| 3 | Kick |
| 4 | TempBan (1 Hour) |
| 5 | Permanent Ban |

---

Temporary Ban Support

Supports custom duration formats:

10m
30m
1h
12h
1d
7d
30d

Examples:

duration: 10m
duration: 1h
duration: 7d

---

Fully Configurable

Everything can be customized through the configuration file:

• Blocked words
• Alert messages
• Punishments
• Prefixes
• Player messages
• Ban durations
• Command actions

No coding required.

---

Lightweight & Efficient

• No database required
• Minimal performance impact
• Fast event handling
• Plug & Play installation

Perfect for servers of any size.

---

Permissions

| Permission | Description |
|------------|-------------|
| siuuuchatfilter.bypass | Completely bypasses the chat filter. Operators automatically bypass the filter. |
| siuuuchatfilter.alert | Receives staff alerts whenever a prohibited word is detected. |
| siuuuchatfilter.admin | Allows usage of administrative commands such as reloading the configuration. |

---

Commands

| Command | Description |
|----------|-------------|
| /siuuuchatfilterreload | Reloads the config.yml without restarting the server. |

---

How The Alert & Punishment System Works

When a player sends a message containing a prohibited word:

Step 1

The message is immediately blocked and removed from chat.

Step 2

Players with the permission:

siuuuchatfilter.alert

receive a configurable alert containing:

• %player% → Player name
• %count% → Current violation count
• %message% → The blocked message

Step 3

The plugin checks the player's violation count and executes the configured punishment.

Examples:

• 1st violation → Delete Message
• 2nd violation → Warning
• 3rd violation → Kick
• 4th violation → TempBan
• 5th violation → Permanent Ban

Everything is fully customizable.

---

Installation

1. Download the latest .jar file.
2. Place it into your server's plugins folder.
3. Start or restart your server.
4. Open the generated configuration file:

plugins/SiuuuChatFilter/config.yml

5. Customize the settings to your needs.
6. Reload changes anytime with:

/siuuuchatfilterreload

No restart required.

---

Why SiuuuChatFilter?

Most chat filters simply block words.

SiuuuChatFilter gives you complete control over moderation by combining:

• Word Filtering
• Staff Monitoring
• Strike Tracking
• Automated Punishments
• Custom Commands

All in one lightweight plugin.

Included Features

• ✔ Custom Word Lists
• ✔ Staff Alerts
• ✔ Strike System
• ✔ Temporary & Permanent Bans
• ✔ Fully Configurable
• ✔ Lightweight Performance

Keep your chat clean, professional, and welcoming for every player.

---

Made with ❤️ for Minecraft Server Owners and Moderation Teams by the SiuuuHD Team