ChatControl
Take control of your chat. Toggle, filter, slowmode, hide spam, LuckPerms support & more! Formerly vChatUtils.
ChatControl
<div align="center">
<h1>ChatControl</h1>
<p>Advanced chat management and control plugin for Paper 1.21.x - 26.1.x</p> <p>Chat toggle, message filtering, slowmode, multi-language support, and LuckPerms integration</p> <p><em>Formerly known as <strong>vChatUtils</strong></em></p>
</div>
---
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
- LuckPerms, Enable/disable chat globally with broadcast notifications - LuckPerms, Hide join/leave messages and advancement announcements - LuckPerms, Regex-based word and link filtering with configurable patterns - LuckPerms, Whitelist-based character filter to block homoglyph/unicode bypass attempts - LuckPerms, Cooldown between messages with configurable delay - LuckPerms, Permission and LuckPerms group-based bypass for disabled chat - LuckPerms, 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
```yaml
============================================
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 ```
---
<div align="center"> <a href="https://www.vprolabs.xyz/foliumhosting"> <img src="https://cdn.modrinth.com/data/cached_images/4a06749284b8ac33f9754f15990dee97e9d57892.png" alt="FoliumHosting"> </a> <h2> <a href="https://www.vprolabs.xyz/foliumhosting">Check out FoliumHosting!</a> </h2> </div>
---
Links
- 🌐 Support: https://vprolabs.xyz - 💬 Support: https://discord.gg/SNzUYWbc5Q - 📦 Support: https://modrinth.com/plugin/chat_control - ☕ Support: https://ko-fi.com/v4bi
---
License
This project is licensed under the vProLabs General License.
- Non-Commercial Use Only - Attribution Required - Share Alike - View Full License
---
<div align="center">
<sub>Made with 🔥 by <strong>vProLabs</strong></sub>
</div>