💬 QChatSimple

QChat is an interactive, lightweight, and highly configurable chat management plugin designed for modern Paper servers. It shifts heavy operations (such as location updates, SQLite logging, and text similarity checks) to asynchronous threads, ensuring your server ticks stay perfectly stable.

With a rich array of visual polish, interaction features, and a built-in SQLite moderation suite, QChat serves as an all-in-one chat solution.

---

✨ Key Features

📍 Ranged Local & Global Chat

• Keep chat local with custom block radius options (e.g., 100 blocks).
• Players can prefix their messages (e.g., with !) to shout globally.
• Warns players if they are talking to themselves with a "no listeners nearby" message.

↩️ Interactive Reply System

• Click a [↩] button next to any message to auto-fill a reply format.
• Shows a clean hover card preview of the original message above your reply, with optional small-caps stylization.
• Sends configurable notifications (Action Bar, Title, and/or Pling sound pings) to the recipient.

🔔 Smart Mentions

• Ping players using @username in chat.
• Highlights the mentioned player's name in a customizable color and style.
• Plays a configurable sound ping only to the mentioned player.

🎨 Visual Polish & Text Stylization

• Hoverable Stickers: Turn specific words into interactive "stickers" with custom colors, styles (bold, italic, obfuscated), and hover-text.
• Color Triggers: Start a message with certain characters (like >) to color the entire line (e.g., classic green-text style).
• Legacy & Hex Color Support: Easily use hex colors (#ffffff or &#ffffff) and custom defined shorthand color maps.

👤 Name Hover & Click Cards

• Supports dynamic tooltips when hovering over player names in chat.
• Custom dynamic variables like %world%, %group%, %prefix%, %suffix%, %player%, and PlaceholderAPI.
• Click on a name to suggest a custom action (like /msg <player> ).

🛡️ Moderation & SQLite Mute System

• SQLite Database: Stores temporary and permanent mutes safely across restarts.
• In-depth commands: Check active mutes with /qmutelist or query exact details with /qmuteinfo.
• Smart Anti-Spam: Prevents flood with configurable cooldowns, similarity checking (Levenshtein distance), and a percentage-based Caps Lock filter.
• Profanity Filter: Automatically blocks messages containing configurable blocked words.

---

🛠️ Commands & Permissions

General Chat Commands

Command	Alias	Description	Permission	Default
/qchat status	/qc status	View plugin configuration status	qchat.admin	OP
/qchat reload	/qc reload	Reload the config.yml file	qchat.admin.reload	OP
/qchat clear	/qc clear	Clean/clear the server chat	qchat.admin.clear	OP

Moderation Commands

Command	Alias	Description	Permission	Default
/qmute <player> [time] [reason]	/qm	Mute a player temporarily or permanently	qchat.mute	OP
/qunmute <player>	/qum	Unmute a muted player	qchat.unmute	OP
/qmutelist	/qml	View all active mutes in list format	qchat.mute.list	OP
/qmuteinfo <player>	/qmi	View specific mute information	qchat.mute.list	OP

Utility Permissions

• qchat.chat — Allows speaking in chat. (Default: true)
• qchat.chat.color — Allows color/hex formatting in chat. (Default: OP)
• qchat.chat.global — Allows global shout messages. (Default: true)
• qchat.reply — Allows using the reply system. (Default: true)
• qchat.reply.notify — Receive reply-related action bar/title notifications. (Default: true)
• qchat.reply.bypass.cooldown — Bypass reply cooldown timer. (Default: OP)
• qchat.bypass.spam — Bypass the anti-spam and similarity limits. (Default: OP)
• qchat.bypass.blockedwords — Bypass the blocked words list. (Default: OP)
• qchat.bypass.mute — Cannot be muted, and automatically unmutes on join. (Default: OP)
• qchat.mute.notify — Receives broadcast notifications when someone is muted. (Default: OP)

---

🧩 Compatibility & Hooks

QChat works standalone but hooks natively into the following plugins to enhance features:

• LuckPerms: Fetches primary group formats, prefixes, and suffixes. Supports stacking multiple prefixes/suffixes.
• PlaceholderAPI: Automatically parses custom placeholders within formatting templates and name hover lines.