# 💬 CTChatControl **A modern, lightweight, and highly customizable chat management and moderation plugin for Paper & Folia servers.** [![Java](https://img.shields.io/badge/Java-21%2B-orange?style=for-the-badge&logo=openjdk)](#requirements) [![Paper](https://img.shields.io/badge/Paper%2FFolia-1.20%2B-blue?style=for-the-badge)](#requirements)

> ⚠️ **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: ```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: ```text fuck f.u.c.k f_u_c_k f-u-c-k f u c k fuccck fuuuuuck ``` Modes: #### Block Mode ```yaml mode: BLOCK ``` The message is completely blocked. #### Censor Mode ```yaml mode: CENSOR ``` Example: ```text You are a fucking idiot ``` ↓ ```text 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 ```yaml formats: default: chat: "%vault_prefix% &7 &8» &f" 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 " ``` --- ## 🎨 Supported Formatting | Type | Example | | ------------- | ----------------------------------- | | Legacy Colors | `&a`, `&c` | | Hex Colors | `&#FFAA00` | | MiniMessage | ``, ``, `` | --- ## 🔑 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.

OZyroX

OZyroX's Plugins

CTChatControl by OZyroX

OZyroX's Organizations

Stars

Watching

CTChatControl by