QuickChat Configuration Wiki
A clear, structured, and easy-to-read wiki-style explanation of every section in the QuickChat configuration files.

1. Global Format (default-global)
This section defines the main chat format used for all players unless overwritten by group-specific settings. Key Elements

• variables-extras: Optional extra placeholders or symbols.
• prefix: Typically the player's rank prefix from LuckPerms.
• name: How the player’s name is displayed.
• suffix: Separator or additional symbols after the name.
• chat_color: Default color for the player’s message.

Interactive Features

• Tooltips: Text shown when hovering over parts of the message.
• Click Commands: Actions executed when clicking parts of the chat (commands or URLs).

2. Group-Based Format (groups)
This section allows chat customization based on the player's LuckPerms group. What It Does

• Overrides global settings for specific groups.
• Allows different prefixes, colors, tooltips, and click actions per group.
• Example: Default players can have gray formatting, while VIP players can have colorful gradients.

3. Private Messages (private-messages)
Handles the appearance and behavior of private (direct) messages via /msg and /reply. Includes

• Message to format: How messages look when you send them.
• Message from format: How messages look when you receive them.
• Gradient and hex support: Enables colorful message styles.
• Sound options: Optional effects when receiving messages.

4. Mentions & Item Display

• Mentions (@player): Notifies a player when their name is mentioned in chat, sending a sound and an Actionbar alert.
• Item Feature ([item]): Allows players to display the item they are holding in chat. Hovering over the text shows the item's name, lore, amount, and enchantments sorted logically.

5. Redis Cross-Server Network (redis.yml)
Configures the connection to a Redis server to synchronize chat across a BungeeCord/Velocity network. What It Synchronizes

• Public Chat: Syncs global chat keeping hover texts, hex colors, and gradients intact.
• Private Messages: Allows /msg and /reply to work across different servers.
• StaffChat & Spy: Admins can talk in /staffchat and monitor private messages globally.

6. World Isolation System (world-isolation.yml)
Controls chat separation for specific worlds (e.g., Minigames or PvP Arenas). Isolation Modes

• Two-Way (Full Isolation): Players in isolated worlds ONLY see each other. They cannot see normal world chat, and normal worlds cannot see them.
• One-Way (Arenas): Messages FROM the isolated world stay inside it, but messages FROM normal worlds CAN be read by players inside the isolated world.
• PM Blocking: Optionally blocks /msg between isolated and normal worlds to prevent ghosting (bypassed in One-Way mode).

7. Personal Chat Settings (/chatsettings)
An interactive GUI allowing players to customize their chat experience. What It Does

• Allows players to toggle receiving Global Chat, Private Messages, and Mention Alerts independently.
• Note: This is handled internally and saved per-player.

8. Spy Mode (spy)
Allows users with permission to view private messages between players. Features

• Spy format: How intercepted messages appear.
• Enable/disable messages: Notifications shown when toggling spy mode.
• Works seamlessly across the entire Redis network if enabled.

9. Chat Mute & Text Filters (chat-mute & text-filters)
Protects against spam and unwanted chat behavior. Features

• Mute System: Controls warnings shown when global chat is locked by an admin.
• Repeated Characters: Reduces spam (e.g., "hellooooo" → "hellooo").
• Anti-Caps: Turns SHOUTING messages into lowercase if excessive.

10. Anti-Popup System (anti-popup)
Protects players from Mojang's chat reporting system interface (1.19+). Features

• Blocks server data and chat configuration packets.
• Delays processing to prevent popups from appearing on player join, avoiding the need for extra plugins.

11. Advanced Hexadecimal Color System
A documentation block inside the config explaining how to use modern formatting:

• Basic hex colors (#RRGGBB or &#RRGGBB)
• Gradients (<gradient:color1:color2>Text</gradient>)
• Rainbow effect (<rainbow>Text</rainbow>) (This does not change configuration behavior; it's a built-in guide for server owners).

12. Internal Settings & Event Priority

• Debug (settings.debug): Shows extra information and error logs. Use only when troubleshooting.
• Console Log Format (console-log-format): Defines how chat messages appear in the server console (does not affect players).
• Event Priority (event-priority): Controls how QuickChat interacts with other chat plugins. Changing this from NORMAL to HIGHEST or LOWEST can fix conflicts.