QuickChat - Folia support and Redis v18.4

We've fixed a Redis issue caused by the new version of Folia; it should now work correctly.

"And version detection was improved. "

We've fixed a Redis issue caused by the new version of Folia; it should now work correctly.

We've made changes to how the config.yml file is read to ensure that changes are always applied correctly.

Remember that QuickChat is compatible with any plugin that interacts with the chat. Just make sure to set the event-priority to “HIGHEST”; this ensures that QuickChat is always processed last.

Changelog
Network & Synchronization Update
Today we implemented a major advancement in network communication, synchronization, and administrative control within the plugin. Below is the complete overview of everything added and improved:

1. Cross-Server Mentions Synchronization (Redis)
Raw Message Transmission
We modified the Redis protocol (RedisMessageData) to include the rawMessage (original message) hidden inside the public chat JSON before applying colors, gradients, or visual formatting.

Detection on the Destination Server
When a server receives the packet from Redis, it now silently processes the rawMessage using MentionsManager to properly detect mentions.

Cross-Server Alerts
If a player is mentioned from another server in the network, they will now receive:

Visual ActionBar alert
Notification sound
fully synchronized across servers.

Respect for Local Configuration
Mentions fully respect each server's local configuration. Example:

If Server B has mentions.enabled: false
then no mention coming from Server A will trigger alerts there.
Self-Mention Prevention
We blocked the possibility of players receiving their own cross-server mention notifications.

Duplicate Prevention
A HashSet<UUID> was implemented to ensure players never receive duplicate sounds or alerts for the same synchronized message.

2. Sound Support & Compatibility Improvements
New Structured Sound Configuration
Sound settings for both PMs and mentions now support a structured configuration format:

enabled
name
volume
pitch
Legacy & Modern Compatibility
We analyzed and fixed compatibility issues between old and modern Minecraft sound names.

The plugin now properly supports:

ORB_PICKUP
ENTITY_EXPERIENCE_ORB_PICKUP
BLOCK_NOTE_BLOCK_PLING
as well as custom Resource Pack sounds such as:

custom.soundname
3. Critical Cross-Server Mentions Bugfix
During a technical audit, we detected and patched a critical issue inside RedisSubscriber.

Detected Problem
When Redis received a Legacy format (plain text without JSON):

chat messages were processed correctly,
but execution terminated prematurely (return),
preventing mentions from being processed entirely.
Applied Fix
The mentions processing system was integrated directly into the Legacy fallback path:

sendPublicChatLegacy
ensuring mentions now work correctly even with old message formats.

4. Native PlaceholderAPI Expansion
We developed and injected a native PlaceholderExpansion directly into the plugin to expose real-time player settings and states.

This allows seamless integration with:

Scoreboards
TAB plugins
Holograms
Menus
any PlaceholderAPI-compatible system
Available Placeholders
Fast Boolean States
%quickchat_chat_enabled%
%quickchat_msg_enabled%
Returns:

true
false
Ideal for conditions and logic checks in external plugins.

Visual Status Placeholders
%quickchat_chat_status%
%quickchat_msg_status%
These directly fetch the formatted texts configured in player_settings.yml, for example:

&aEnabled
&cDisabled
ready to be displayed in GUIs, scoreboards, or menus.

5. New Subcommands & Administrative Tools
The base /qchat command has been significantly expanded with advanced administration, debugging, and monitoring tools.

Forced Preference Management
New commands:

/qchat chattoggle [player]
/qchat msgtoggle [player]
These allow:

Console
Administrators
Staff members
to modify any player's chat or private message visibility preferences across the network.

Useful for:

player assistance,
moderation,
or soft punishments.
Anti-Popup Suite
New system:

/qchat antipopup
Available subcommands:

info
status
reload
clear
help
This suite allows administrators to monitor and hot-reload the packet interception system related to:

Secure Chat Reporting
client popups
packet interception
without restarting the server.

We have fixed an issue with Discord SRV

"one-way" - Unidirectional isolation. Messages FROM the isolated world stay INSIDE it (other worlds don't see them). Messages FROM normal worlds CAN be seen by players in isolated worlds. Private messages (/msg) are NOT blocked in this mode. Ideal for arenas where you want players to stay informed but keep their own chat private. isolation-mode: "one-way"

We recommend deleting and regenerating world-isolation.yml

QuickChat - Features Overview

Redis Cross-Server (Global Synchronization)
Config:

Code:

redis.yml

QuickChat includes Redis support to connect all your servers (Lobby, Survival, Skyblock, etc.) in real-time, creating a unified chat system across your entire network.

Features

Global Private Messaging
Use

Code:

/msg

and

Code:

/r

across all servers.
Global Tab Complete
Auto-complete player names from the entire network.
StaffChat Across Servers
Staff members can communicate from any server.
Global Public Chat (Optional)
Sync chat between all servers.
Server Tags
Show the origin server in messages.
Example:

Code:

[Skyblock] Player -> You: Hello

Notes

Fully asynchronous system
Automatic Redis reconnection if connection is lost
No impact on main server thread

World Isolation System
Config:

Code:

world-isolation.yml

Designed for servers running multiple worlds (e.g. Survival + PvP arenas).

Features

Per-World Chat Isolation
Players only see messages from their current world.
Example
If

Code:

arena_pvp

is isolated:
Players inside only see messages from that world
No messages from Survival
Survival players don’t see arena chat
Private Message Control
Option to block

Code:

/msg

between isolated worlds and global worlds.

Use Cases

PvP arenas
Minigames
Competitive environments

⚠ Important

Do NOT use Redis Cross-Server and World Isolation together on the same server.

They serve opposite purposes.

Recommendation:
Disable Redis in

Code:

redis.yml

if you want full isolation.

Command: /mutechat
Silences or enables the global server chat.

Main Permission:
quickchat.admin.mutechat
Description: Allows muting and unmuting the global chat.
⚙ Default: OP (operators)

Bypass Permission:
quickchat.bypass.mutechat
Description: Allows a player to send messages even if the global chat is muted.
⚙ Default: OP (operators)

Command: /chatsettings
Opens the player's personal settings menu.

Permission:
quickchat.chatsettings
Description: Allows opening the personal configuration menu (global chat and private messages).

Bypass Permission:
quickchat.bypass.mutechat

⚙ Configuration:
This permission can be configured in:
chat-mute/player_settings.yml

Default: quickchat.chatsettings
If left empty (""): the command will be accessible to all players.