---

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

---

⚔️ Interactive Chat Display Tags

Players with the appropriate permissions can show their items, inventories, and ender chests dynamically in chat.

• [item] (Permission: quickchat.item): Displays the item the player is currently holding in their main hand, listing custom lore, amounts, and logically sorted enchantments on hover.
• [inv] (Permission: quickchat.inventory): Creates a read-only snapshot of the sender's inventory. Other players can click the message to open a virtual GUI and inspect the items.
• [ec] (Permission: quickchat.enderchest): Creates a read-only snapshot of the sender's ender chest. Other players can click the message to open a virtual GUI and inspect the items.

---

🚀 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 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.
• 🛡️ Advanced Filters & Moderation: Built-in Anti-Spam, Anti-Caps, and Anti-Popup (blocks Secure Chat Reporting warnings on 1.19+ without external plugins).
• 💾 Smart Database I/O: Supports both SQLite and MySQL utilizing HikariCP connection pooling and asynchronous execution.

---

📜 Commands

🧑‍🤝‍🧑 Player Commands (General)

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

🛡️ Staff & Moderation Commands

Command	Alias	Description	Permission Required
/staffchat [msg]	sc	Toggle staff chat mode or send a quick staff message	quickchat.staffchat
/spy	-	Toggle cross-server PM Spy mode	quickchat.spy
/mutechat	-	Opens the Mute GUI Control to lock/unlock chat and PMs	quickchat.admin.mutechat
/clearchat	cc	Clears the global chat for everyone	quickchat.admin.clearchat
/say <message>	broadcast, bc	Broadcast an announcement to the entire network	quickchat.say
/qchat chattoggle [player]	-	Toggle global chat visibility for yourself or a target player	quickchat.chattoggle (self) / quickchat.admin.chattoggle (others)
/qchat msgtoggle [player]	-	Toggle private messages availability for yourself or a target player	quickchat.msgtoggle (self) / quickchat.admin.msgtoggle (others)

⚙️ Administrator Commands

Command	Alias	Description	Permission Required
/qchat reload	qc reload	Reloads all configurations, database connections, and caches	quickchat.admin.reload
/qchat colors	qc colors	Shows help/formatting codes for Hex, gradients, and rainbows	quickchat.admin.colors
/qchat testcolors	-	Runs a live test suite to verify colors, gradients, and rainbows rendering	quickchat.admin.colors
/qchat announcements <status|next|list|toggle>	-	Manage the automatic announcements system	quickchat.admin.announcements
/qchat antipopup <info|status|reload|clear|clearcache|help>	-	Manage the Anti-Popup secure chat reporting warning blocker	quickchat.admin.antipopup
/qcview <uuid>	-	Internal command used to display a player inventory snapshot	quickchat.inventory
/qcview <uuid>	-	Internal command used to display a player ender chest snapshot	quickchat.enderchest
/chatcolors	colors, chatcolor	Open the VIP chat color selection GUI	quickchat.menucolors

---

🔑 Bypass & Feature Permissions

⚙️ Command & Moderation Permissions

Permission Node	Description	Default
quickchat.admin	Grants full access to all Quickchat admin commands and configurations.	op
quickchat.admin.reload	Allows reloading the plugin configuration and caching.	op
quickchat.admin.announcements	Allows managing the automatic announcements system.	op
quickchat.admin.colors	Allows viewing color formatting help and running color tests.	op
quickchat.admin.mutechat	Allows locking/unlocking the global chat via GUI or command.	op
quickchat.admin.clearchat	Allows clearing the server's global chat.	op
quickchat.admin.antipopup	Allows managing the Anti-Popup secure reporting filter.	op
quickchat.admin.chattoggle	Allows forcing chat visibility state on other players.	op
quickchat.admin.msgtoggle	Allows forcing private message state on other players.	op
quickchat.spy	Allows spying on player private messages across the network.	op
quickchat.staffchat	Allows read/write access to the native staff chat channel.	op
quickchat.say	Allows broadcasting announcements to the server network.	op

🛡️ Exemption & Bypass Permissions

Permission Node	Description	Default
quickchat.bypass.clearchat	Prevents the player's chat history from being cleared (Staff/Admins).	op
quickchat.bypass.mutechat	Allows speaking in chat even when global chat is muted.	op
quickchat.bypass.textfilters	Bypasses text limitations (like anti-caps and repeated characters).	op
quickchat.bypass.worldisolation	Bypasses World Isolation constraints to send messages to all worlds.	op
quickchat.ignore.exempt	Prevents this player from being ignored by other players.	op

✨ Feature & VIP Permissions

Permission Node	Description	Default
quickchat.menucolors	Allows opening the VIP /chatcolors color selection menu.	op
quickchat.menucolors.all	Unlocks all color choices inside the /chatcolors selection GUI.	op
quickchat.styles.all	Unlocks all chat formatting styles (bold, italic, etc.) inside the GUI.	op
quickchat.colors	Allows using Legacy and Hex formatting codes in standard chat.	op
quickchat.item	Allows displaying the held item using the [item] placeholder tag in chat.	op
quickchat.inventory	Allows displaying player inventory snapshots using [inv].	op
quickchat.enderchest	Allows displaying player ender chest snapshots using [ec].	op
quickchat.msgtoggle	Allows toggling one's own private message availability status.	true
quickchat.chattoggle	Allows toggling one's own global chat visibility status.	true

---

📦 Requirements

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