ChatControl
Advanced chat management and control plugin for Paper 1.21.x - 26.1.x
Chat toggle, message filtering, slowmode, multi-language support, and LuckPerms integration
Formerly known as vChatUtils
TO-DO (in the future)
- [Folia scheduler support]
- [Velocity support]
- [Bungeecord support]
- [Java 25+ compile target for 26.1.x+ native builds]
These will be made in the future of this plugin, if you wanna support us to add these features faster then join our discord!
Features
- Chat Toggle, Enable/disable chat globally with broadcast notifications
- Message Hiding, Hide join/leave messages and advancement announcements
- Chat Filter, Regex-based word and link filtering with configurable patterns
- Allowed Characters, Whitelist-based character filter to block homoglyph/unicode bypass attempts
- Slowmode, Cooldown between messages with configurable delay
- Bypass System, Permission and LuckPerms group-based bypass for disabled chat
- Multi-Language, English and Polish built-in, easy to add more via lang files
- LuckPerms, Prefix and suffix formatting with group-level permission checks
Commands
| Command | Description | Permission |
|---|---|---|
/chatcontrol |
Show plugin info (version, author, links) | Everyone |
/chatcontrol clear |
Clear the chat | chatcontrol.admin |
/chatcontrol on |
Enable chat | chatcontrol.admin |
/chatcontrol off |
Disable chat | chatcontrol.admin |
/chatcontrol status |
Show plugin status | chatcontrol.admin |
/chatcontrol reload |
Reload configuration | chatcontrol.admin |
Alias: /cc = /chatcontrol (configurable via short-alias in config.yml)
Permissions
| Permission | Description | Default |
|---|---|---|
chatcontrol.admin |
Access to all commands | op |
chatcontrol.bypass |
Write when chat is disabled | op |
Configuration
View config.yml
# ============================================
# ChatControl Configuration
# ============================================
# MiniMessage format guide:
# <red>, <green>, <blue> - colors
# <bold>, <italic>, <underlined> - styles
# <gradient:red:blue> - gradients
# <color:#ff0000> - hex colors
# ============================================
# --- General ---
prefix: "<dark_gray>[<red>ChatControl<dark_gray>] "
language: "en"
# --- Commands ---
english-aliases: true
polish-aliases: false
short-alias: true
# --- Chat Toggle ---
chat-enabled: true
hide-join-messages: false
hide-leave-messages: false
hide-advancements: false
# --- Slowmode ---
enable-chat-slowmode: true
chat-slowmode: 3
# --- Chat Filter ---
enable-chat-filter: true
chat-filter:
- "(?i)fuck"
- "(?i)shit"
- "(?i)asshole"
- "(?i)nigger"
- "(?i)discord\\.gg"
# --- Allowed Characters ---
# Enable character whitelist to block unwanted symbols/homoglyphs
enable-allowed-characters: true
# Regex pattern of allowed characters (messages with any char outside this set are blocked)
allowed-characters-regex: "^[a-zA-Z0-9\\s\\-_/\\\\.,!?;:'\"()\\[\\]{}@#$%^&*+=<>~`]+$"
# --- Chat Format ---
enable-chat-format: true
chat-format: "{prefix}{suffix}<white>{username}</white> <dark_gray>\u00bb</dark_gray> <white>{message}</white>"
# --- Integrations ---
luckperms-integration: true
🌐 Quick Socials
Made with ⚡ by vProLabs Team
