QuickChat - Folia support and Redis

✨ Main Features

Chat Formatting & Design

• LuckPerms Integration: Custom chat formats per group (ranks).
• Global Variables: Configurable prefixes, suffixes, and colors.
• Deep Interactivity: Tooltips (hover text) and click actions (open URL, run command, suggest text) available on every single part of the message (Prefix, Name, Suffix).
• Future-Proof Hexadecimal (RGB) Support: Native, automatic support for Hex colors (&#RRGGBB) on versions 1.16+ (including 1.21+).
• Advanced Text FX:
  • Gradients: <gradient:color1:color2>Text</gradient>
  • Rainbow: <rainbow>Text</rainbow>
• Legacy Compatibility: Extremely fast, mathematically optimized Hex-to-Legacy color approximation for older clients (<1.16).

Redis Cross-Server Network (BungeeCord / Velocity)
Connect your entire network flawlessly using our highly optimized Redis synchronization.

• Global Public Chat: Synchronizes public chat seamlessly across all servers, keeping hex colors, gradients, and hover tooltips 100% intact.
• Cross-Server PMs & Tab-Complete: Built-in /msg and /reply work across the entire network. Players can tab-complete names from any server.
• Cross-Server StaffChat: Staff members can communicate across all servers in real time.
• Cross-Server Broadcast: Run /say from any server or console, and broadcast it network-wide.
• Cross-Server Spy Mode: Admins can quietly monitor private messages sent across the network.
• Cross-Server Mentions: Mention any online player across the entire network in real-time. Audio and visual alerts are instantly synchronized across your Redis setup.

World Isolation System
Isolate chat in specific worlds (e.g., PvP Arenas, Minigames) with two unique modes:

• Two-Way Mode (Strict): Full bidirectional isolation. Isolated worlds cannot see the global chat, and normal worlds cannot see the isolated chat.
• One-Way Mode (Arenas): Players in the isolated world can read the server's global chat, but their messages stay exclusively inside the arena.
• PM Blocking: Option to block private messages between isolated and normal worlds to prevent ghosting or external interference.

⚙️ Personal Player Settings (Interactive GUI)
Players have full control over their chat experience via the /chatsettings interactive menu:

• Toggle Global Chat: Players can mute the public chat for themselves to focus on the game.
• Toggle Private Messages: Players can block all incoming PMs.
• Toggle Mentions: Turn on/off sound and actionbar alerts when mentioned.

Custom PlaceholderAPI Expansion
Quickchat registers its own highly optimized PlaceholderAPI expansion to share player settings state with tablists, scoreboards, and other menus across the network:

• %quickchat_chat_enabled% – Returns true or false based on the player's global chat preference.
• %quickchat_chat_status% – Returns a beautifully pre-formatted, colorized status message (e.g., &aEnabled or &cDisabled).
• %quickchat_msg_enabled% – Returns true or false based on the player's private message settings.
• %quickchat_msg_status% – Returns the pre-formatted colorized status message for private messages.

✉️ Private Messaging & Moderation

• PM System & Custom Audio: Robust /msg and /reply (/r) commands with cross-version sound fallback.
• Spy Mode (/spy): Allows administrators to see other players’ private messages.
• O(1) Ignore System: Players can block private messages and chat from specific users with /ignorar and /designorar.
• Mute Chat: Instantly lock the global chat for maintenance or moderation (/qchat mutechat).

️ Chat Tools & Filters

• Anti-Spam: Reduces excessive repeated characters (e.g., "hellooooo" → "hellooo").
• Anti-Caps: Intelligently converts messages that abuse uppercase letters to lowercase.
• Anti-Popup (1.19+): Blocks system messages and warnings from Secure Chat Reporting without needing extra plugins.
• Smart Mentions System: Sound and visual alerts (ActionBar) when a player is mentioned using [USER=39012]@name[/USER] (supports configurable prefixes or no symbol).
  • Network-Wide Sync: Full support for cross-server mentions via Redis.
  • Respect for Local Configs: If a server has mentions disabled, it will never trigger alerts for players on that server, ensuring perfect compliance with local settings.
  • Adaptive Sound Engine: Supports native sounds (legacy names like ORB_PICKUP, modern names like ENTITY_EXPERIENCE_ORB_PICKUP / BLOCK_NOTE_BLOCK_PLING) and custom resource pack sounds (custom.sound) with configurable volume and pitch.
  • High-Performance Deduplication: Uses thread-safe memory sets to prevent duplicate alerts and avoid self-mentions.

⚔️ Interactive Item Feature ([item])
Displays the item you are holding in chat simply by typing [item].

• Details: Shows the exact display name, amount, custom lore, and enchantments.
• Visual Ordering: Enchantments are sorted logically (Damage > Enhancements > Utility).
• Format Protection: Fully compatible with gradients and hex colors without breaking the chat layout or tooltips.

⚡ Enterprise-Grade Performance (Optimized for 20,000+ Players)

• Zero-Allocation Hot Paths: Chat processing uses cached, pre-merged formats, static compiled patterns, and highly optimized cross-server mention checks to eliminate Garbage Collection pressure.
• Thread-Safe Concurrency: Built with ConcurrentHashMap and thread-safe sets to completely prevent main-thread locks and ConcurrentModificationExceptions.
• Smart Database I/O: Supports both SQLite and MySQL utilizing HikariCP connection pooling and a single-thread executor to ensure zero database bottlenecks.
• Folia Supported: Fully compatible with Folia’s multi-threaded, region-based architecture.

Other Integrations

• Clean Logs: Customizable format for chat logs in the server console.
• DiscordSRV Support: Seamless integration to relay formatted messages to your Discord server.

Commands & Permissions

Command	Alias	Description	Permission	Default
/qchat reload	qc reload	Reloads all configurations & caches	quickchat.admin.reload	OP
/qchat testcolors	-	Test Hex, gradients, and rainbow colors	quickchat.admin.colors	OP
/qchat antipopup	-	Manage Anti-Popup system	quickchat.admin.antipopup	OP
/qchat mutechat	-	Toggle global chat from console/ingame	quickchat.admin.mutechat	OP
/qchat chattoggle [player]	-	Toggle global chat state for yourself or others	quickchat.chattoggle / admin.chattoggle	Everyone / OP
/qchat msgtoggle [player]	-	Toggle PMs state for yourself or others	quickchat.msgtoggle / admin.msgtoggle	Everyone / OP
/chatcolors	colors, chatcolor	Open color selection GUI	quickchat.menucolors	OP
/chatsettings	settings	Open personal settings GUI	-	Everyone
/msg <player>	tell, w, pm, t	Private message	-	Everyone
/r <message>	reply	Reply to the last PM	-	Everyone
/ignorar <player>	ignore	Ignore a player	-	Everyone
/designorar <player>	unignore	Stop ignoring a player	-	Everyone
/spy	-	Spy mode (Local & Cross-Server)	quickchat.spy	OP
/say <message>	broadcast, bc	Server & Network broadcast	quickchat.say	OP
/staffchat	sc	Private staff chat channel	quickchat.staffchat	OP

Bypass & Staff Permissions:

• quickchat.admin – Full admin access.
• quickchat.admin.antipopup – Manage Anti-Popup configurations.
• quickchat.admin.msgtoggle – Admin toggle PMs for other players.
• quickchat.admin.chattoggle – Admin toggle Chat for other players.
• quickchat.colors – Allows color usage in chat.
• quickchat.ignore.exempt – Players with this cannot be ignored.
• quickchat.bypass.textfilters – Bypass spam/caps filters.
• quickchat.bypass.mutechat – Talk while global chat is muted.
• quickchat.bypass.worldisolation – Bypass world isolation restrictions.
• quickchat.menucolors.all – Unlock all GUI colors.
• quickchat.styles.all – Unlock all GUI styles.
• quickchat.item – Allows the use of [item].

Dependencies

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