---

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

---

---

Links

• 🌐 Website: https://vprolabs.xyz
• 💬 Discord: https://discord.gg/SNzUYWbc5Q
• 📦 Modrinth: 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

---