💬 CTChatControl
A modern, lightweight, and highly customizable chat management and moderation plugin for Paper & Folia servers.
⚠️ This project is currently in Beta. Features may change as development continues and feedback is collected.
📥 Downloads
Always use the latest release for the newest features, improvements, and fixes.
✨ Features
| 🎨 | Fully customizable chat formats per permission group |
| 🌈 | Legacy (&), Hex (&#RRGGBB), and MiniMessage support |
| 🖱️ | Click events — Suggest Command, Run Command, Open URL, Copy to Clipboard |
| 💬 | Hover events with fully customizable content |
| 👥 | Vault group integration |
| 📦 | PlaceholderAPI support |
| 🗑️ | Delete signed chat messages |
| 🚫 | Anti Advertising system (Chat, Commands, Signs) |
| 🔤 | Anti Unicode system with configurable Unicode block filtering |
| 🤬 | Anti Swear system with block or censor modes |
| 🛡️ | Staff notifications for moderation violations |
| ⚙️ | Configurable punishment commands |
| ⚡ | Adventure API powered components |
| 🎯 | Lightweight, fast, and Folia compatible |
🛡️ Moderation Systems
Anti Advertising
Block server advertisements, IPs, domains, and links in:
- Chat messages
- Commands
- Signs
Features:
- Staff notifications
- Configurable punishment commands
- Command whitelist support
- Domain whitelist support
- Anti-bypass normalization
Anti Unicode
Prevent players from using special Unicode characters commonly used to bypass filters or disguise advertisements.
Features:
- Chat support
- Command support
- Sign support
- Unicode block blacklist
- Character whitelist
- Staff notifications
- Configurable punishment commands
Example blocked text:
ᴀꜱᴅꜰ.ɪʀ
Anti Swear
Filter inappropriate language with advanced normalization.
Features:
- Chat support
- Command support
- Sign support
- Staff notifications
- Configurable punishment commands
- Word whitelist
- Anti-bypass protection
Detects:
fuck
f.u.c.k
f_u_c_k
f-u-c-k
f u c k
fuccck
fuuuuuck
Modes:
Block Mode
mode: BLOCK
The message is completely blocked.
Censor Mode
mode: CENSOR
Example:
You are a fucking idiot
↓
You are a ******* *****
📋 Requirements
| Requirement | Notes |
|---|---|
| Java | 21 or higher |
| Server | Paper or Folia 1.20+ |
| Vault | Optional — enables group formats |
| PlaceholderAPI | Optional — enables placeholders in chat formats and hover text |
⚙️ Chat Format Configuration
CTChatControl allows fully customizable formats per permission group.
Example
formats:
default:
chat: "%vault_prefix% &7<player> &8» &f<message>"
hover:
enable: true
lines:
- "%player_name%"
- "&8&m----------------"
- "&fWorld: &e%player_world%"
- "&fPing: &a%player_ping%"
- "&fHealth: &c%player_health%"
click-event:
enable: true
type: SUGGEST_COMMAND
value: "/msg <player>"
🎨 Supported Formatting
| Type | Example |
|---|---|
| Legacy Colors | &a, &c |
| Hex Colors | &#FFAA00 |
| MiniMessage | <gradient>, <rainbow>, <bold> |
🔑 Permissions
| Permission | Description |
|---|---|
ctchatcontrol.chat.delete |
Allows deleting signed chat messages. |
ctchatcontrol.color.color |
Allows players to use legacy (&) and hex color codes in chat. |
ctchatcontrol.color.minimessage |
Allows players to use MiniMessage formatting in chat. |
ctchatcontrol.clearchat.bypass |
Players with this permission won't have their chat cleared. |
ctchatcontrol.command.clearchat |
Allows usage of the /clearchat command. |
ctchatcontrol.command.clearchat.silence |
Allows using silent clear chat functionality. |
ctchatcontrol.staff |
Receives moderation notifications from Anti Advertising, Anti Unicode, and Anti Swear systems. |
ctchatcontrol.admin |
Grants access to administrative features. |
🚀 Performance
CTChatControl is designed to be:
- Lightweight
- Thread-safe
- Folia compatible
- Minimal memory usage
- Suitable for large servers
All moderation checks are optimized to minimize overhead while still detecting common bypass techniques.
🛠️ Current Status
CTChatControl is actively developed and receives regular updates.
Planned improvements include:
- Chat cooldowns
- Anti spam system
- Anti caps system
- Anti flood system
- Advanced moderation tools
- GUI management tools
🐛 Reporting Issues
Found a bug or have a suggestion?
Please open an issue on GitHub and include:
- Server version
- Plugin version
- Console errors (if any)
- Steps to reproduce
GitHub Issues:
https://github.com/OZyroX086/CTChatControl/issues
❤️ Support
If you enjoy CTChatControl, consider starring the repository on GitHub. It helps the project grow and motivates future development.
