๐ฌ 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.
No gallery available for this project.