# 💬 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

Pinned plugins

CTChatControl

Organizations

Stars

Watching