QuickChat Configuration Wiki
A clear, structured, and easy-to-read wiki-style explanation of every section in the QuickChat configuration.
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).
This section controls the overall appearance and interactivity of the chat system.
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.
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.
This section fully customizes the PM system.
4. 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.
This is useful for moderation and staff oversight.
5. Chat Mute System (chat-mute)
Controls the message shown when global chat is muted.
Players attempting to send messages during a mute will see this warning.
6. Advanced Hexadecimal Color System
This is a documentation block explaining how to use:
- Basic hex colors (#RRGGBB or &#RRGGBB)
- Gradients (<gradient:color1:color2>Text</gradient>)
- Rainbow effect (<rainbow>Text</rainbow>)
- Format ordering best practices
This does not change configuration behavior; it's a built-in guide for server owners.
7. Anti-Popup System (anti-popup)
Disables the Minecraft chat reporting interface.
Features
- Blocks server data packets.
- Blocks chat configuration packets.
- Delays processing to prevent popups from appearing on player join.
This system protects players from Mojang's chat reporting system.
8. Internal Settings (settings)
Contains admin/developer options.
- debug: When enabled, shows extra information and error logs.
Use this only when troubleshooting.
9. Event Priority (event-priority)
Controls how QuickChat interacts with other plugins that modify chat.
Priority Levels
- LOWEST
- LOW
- NORMAL (default)
- HIGH
- HIGHEST
- MONITOR (read-only)
Adjusting this can fix conflicts with other chat-related plugins.
10. Text Filters (text-filters)
Adds protections against spam and unreadable messages.
Features
- Repeated characters control (e.g., "hellooooo" → "hellooo").
- Uppercase reduction (turns SHOUTING messages into lowercase if excessive).
This helps maintain clean chat behavior.
11. Console Log Format (console-log-format)
Defines how chat messages appear in the
server console.
This does not affect players; only administrators see this format.
End of Wiki
This document provides a clear overview of how each configuration block works within QuickChat. Let me know if you want a PDF version, a more visual wiki layout, or a Spanish edition.