Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!

OZyroX /

CTChatControl

A modern, lightweight, and highly customizable chat management and moderation plugin for Paper & Folia servers.

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