---

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