Описание
# 🛡️ Simple and Easy ChatFilter – 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:
```yaml
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:
```text
10m
30m
1h
12h
1d
7d
30d
```
Examples:
```yaml
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:
```text
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:
```text
plugins/SiuuuChatFilter/config.yml
```
5. Customize the settings to your needs.
6. Reload changes anytime with:
```text
/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