---

✨ What is Quickchat?

Quickchat is the ultimate, enterprise-grade solution for servers that need complete chat management without sacrificing performance. Unlike other heavy plugins, it focuses on extreme speed and zero-allocation processing, allowing you to manage formats, private messages, and filters seamlessly across your entire network.

[!IMPORTANT]
Built for the future: Fully compatible with Folia, natively supports Hexadecimal colors (&#RRGGBB), and is tested to sustain high-traffic environments of 20,000+ concurrent players with zero TPS drop.

---

🚀 Key Features

• ⚡ Elite Performance: Coded with thread-safe O(1) structures, ConcurrentHashMap, and cached pre-merged formats for zero Garbage Collection pressure.
• 🌐 Redis Cross-Server Network: Seamlessly synchronize Global Public Chat, Private Messages (/msg, /reply), StaffChat, Server Broadcasts (/say), and Cross-Server Mentions across all your BungeeCord/Velocity servers.
• 🎨 Deep Formatting & Hex Support: Full LuckPerms integration for ranks. Native support for Hex colors, Gradients (<gradient:color1:color2>), Rainbows, and interactive tooltips (hover/click actions) on every part of the message.
• 🌍 World Isolation System: Two unique modes:
  • Strict Mode: Bidirectional isolation (Arena players only talk to Arena players).
  • Arena Mode: One-way isolation (Arena players can see global chat, but their messages stay in the arena).
• ⚙️ Player GUI Settings (/chatsettings): Players can personally mute global chat, block incoming PMs, or toggle mention alerts without commands.
• 🔔 Smart Mentions System: Sound and visual alerts (ActionBar) when mentioned (@name). Supports cross-server sync, custom resource-pack sounds, respects local server configs, and uses O(1) deduplication to prevent spam/self-mentions.
• 🛡️ Advanced Filters & Moderation: Built-in Anti-Spam, Anti-Caps, and Anti-Popup (blocks Secure Chat Reporting warnings on 1.19+ without external plugins).
• ⚔️ Interactive [item] Tag: Players can show their held item in chat, displaying custom lore, amounts, and logically sorted enchantments without breaking gradients.
• 🔌 Custom PlaceholderAPI Expansion: Natively exposes 4 variables (%quickchat_chat_enabled%, %quickchat_chat_status%, %quickchat_msg_enabled%, %quickchat_msg_status%) to sync player preferences visually with your Tablist or Scoreboard.
• 💾 Smart Database I/O: Supports both SQLite and MySQL utilizing HikariCP connection pooling and asynchronous execution.

---

📜 Commands

🧑🤝🧑 Player Commands (General)

Command	Alias	Description
/msg <player>	tell, w, pm, t	Send a private message (Cross-Server)
/r <message>	reply	Reply to the last PM received
/ignorar <player>	ignore	Ignore PMs and chat from a specific player
/designorar <player>	unignore	Stop ignoring a player
/chatsettings	settings	Open the personal chat preferences GUI

🛡️ Staff & Moderation Commands

Command	Alias	Description	Permission Required
/staffchat	sc	Private staff chat channel	quickchat.staffchat
/spy	-	Toggle cross-server PM Spy mode	quickchat.spy
/qchat mutechat	-	Lock or unlock the global chat	quickchat.admin.mutechat
/say <message>	broadcast, bc	Broadcast a message to the entire network	quickchat.say
/qchat chattoggle [player]	-	Force toggle chat visibility for someone	quickchat.admin.chattoggle
/qchat msgtoggle [player]	-	Force toggle PM availability for someone	quickchat.admin.msgtoggle

⚙️ Administrator Commands

Command	Alias	Description	Permission Required
/qchat reload	qc reload	Reloads all configurations & caches	quickchat.admin.reload
/qchat colors	qc colors	Shows all active standard color codes	quickchat.admin.colors
/qchat testcolors	-	Live test suite for Hex, Gradients & Rainbows	quickchat.admin.colors
/qchat antipopup	-	Manage the Anti-Popup system (info/reload/clear)	quickchat.admin.antipopup
/chatcolors	colors	Open the color selection GUI (VIP Feature)	quickchat.menucolors

---

🔑 Bypass & Feature Permissions

Permission Node	Description
quickchat.admin	Grants full access to all admin commands and features.
quickchat.admin.antipopup	Allows managing the Anti-Popup configuration.
quickchat.admin.chattoggle	Allows forcing global chat state on other players.
quickchat.admin.msgtoggle	Allows forcing PM state on other players.
quickchat.colors	Allows the player to use color codes (Legacy & Hex) in their messages.
quickchat.item	Allows the player to display their held item using the [item] tag.
quickchat.ignore.exempt	Prevents this player from being ignored by others (Ideal for Admins).
quickchat.bypass.textfilters	Bypasses the Anti-Spam and Anti-Caps filters.
quickchat.bypass.mutechat	Allows the player to talk even when the global chat is muted.
quickchat.bypass.worldisolation	Bypasses World Isolation rules, allowing the player to talk to everyone.
quickchat.menucolors.all	Unlocks all color options inside the /chatcolors GUI.
quickchat.styles.all	Unlocks all style options (Bold, Italic, etc.) inside the GUI.

---

📦 Requirements

• PlaceholderAPI – Required for variables and placeholders.
• LuckPerms – Required for handling prefixes, suffixes, and chat groups.