⚠️ 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>, <✨>, <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.