Quickchat

DISCORD: https://discord.gg/ZRe3RnubdW

Quickchat is an advanced and lightweight chat plugin for Minecraft servers (Spigot/Paper/Folia), designed to provide complete chat management with support for versions from 1.8 up to 1.21+.

📋 Main Features

💬 Chat Formatting

• LuckPerms Integration: Custom chat formats per group (ranks).
• Global Variables: Configurable prefixes, suffixes, and colors.
• Interactivity: Tooltips (hover text) and click actions (open URL, run command, suggest text) on each part of the message (Prefix, Name, Suffix).
• Hexadecimal (RGB) Support: Native support for Hex colors (&#RRGGBB) on versions 1.16+.
  • Gradients: <gradient:color1:color2>Text</gradient>
  • ✨: <✨>Text</✨>
  • Legacy Compatibility: Automatic Hex color approximation for older versions (<1.16).

📩 Private Messaging

• PM System: Built-in /msg and /reply (/r) commands.
• Spy Mode (/spy): Allows administrators to see other players’ private messages.
• Ignore System: Players can block private messages from specific users with /ignore and /unignore.

🛠️ Chat Tools

• Mute Chat: Locks the global chat for maintenance or moderation (/qchat mutechat).
• Text Filters:
  • Anti-Spam: Reduces excessive repeated characters (e.g. "hellooooo" → "hellooo").
  • Anti-Caps: Converts messages that abuse uppercase letters to lowercase.
• Anti-Popup (1.19+): Blocks annoying system messages and warnings from Secure Chat Reporting without extra plugins.
• Mentions: Sound and visual alert (Actionbar) when a player is mentioned using @Name.

📦 Item Feature ([item])

• Displays the item you are holding in chat by typing [item].
• Shows name, amount, lore, and enchantments.
• Visual Ordering: Enchantments are sorted logically (Damage > Enhancements > Utility).
• Format Protection: Compatible with gradients and colors without breaking the tooltip.

📢 Other

• Custom Broadcast: /say command with server format ([SERVER]).
• Clean Logs: Customizable format for chat logs in the console.
• DiscordSRV Support: Basic integration to relay messages.
• Folia Supported: Compatible with Folia’s architecture.

---

📜 Commands and Permissions

Command	Alias	Description	Required Permission	Default
/qchat reload	qc reload	Reloads the configuration.	quickchat.admin.reload	OP
/qchat help	qc help	Shows plugin help.	-	Everyone
/qchat colors	qc colors	Shows color list.	quickchat.admin.colors	OP
/qchat mutechat	-	Enable/Disable global chat.	quickchat.admin.mutechat	OP
/qchat antipopup	-	Manages the AntiPopup system.	quickchat.admin.antipopup	OP
/chatcolors	colors	Opens the color GUI menu.	quickchat.menucolors	OP
/msg <player>	tell, w	Send a private message.	-	Everyone
/r <message>	reply	Reply to the last message.	-	Everyone
/spy	-	Toggle spy mode.	quickchat.spy	OP
/ignore <player>	unignore	Ignore a player.	-	Everyone
/say <message>	broadcast	Server announcement.	quickchat.say	OP
[item] (in chat)	-	Show held item.	quickchat.item	OP

Other Important Permissions

Permission	Description	Default
quickchat.admin	Full access to admin commands.	OP
quickchat.colors	Allows use of color codes (& or hex) in chat.	OP
quickchat.ignore.exempt	Player cannot be ignored by others.	OP
quickchat.bypass.textfilters	Bypasses caps and spam filters.	OP
quickchat.bypass.mutechat	Allows chatting while chat is muted.	OP
quickchat.menucolors.all	Unlocks all colors in the GUI menu.	OP
quickchat.styles.all	Unlocks all styles in the GUI menu.	OP

Dynamic Permissions (Colors and Styles)

The color menu (/chatcolors) can require specific permissions for each color or style if configured in chatcolors.yml.

• Typical format: quickchat.color.<name> or quickchat.style.<name> (Configurable).

---

🎨 Advanced Color Formats

Quickchat supports MiniMessage and hexadecimal color codes:

• Hex: &#RRGGBB (Example: &#FF0000 is Red)
• Gradient: <gradient:Red:Blue>Text</gradient>
  • Example: <gradient:ff0000:0000ff>Hello World</gradient>
• ✨: <✨>Text</✨>

---

⚙️ Dependencies

For proper functionality, make sure you have installed:

1. PlaceholderAPI (Required for variables).
2. LuckPerms (Required for prefixes, suffixes, and groups).