PremiumChat 💬✨

The Ultimate Modern Minecraft Chat System for Paper & Purpur

PremiumChat is a production-ready, high-performance chat formatting plugin designed for modern Minecraft servers (1.20+ / 1.21+). It combines LPC-style chat formatting, DonutChatHover-style interactive profile cards, Adventure MiniMessage formatting, RGB/HEX gradients and patterns, LuckPerms & EternalTags hooks, modern chest GUIs, and automatic ChatColor API discovery into one polished solution.

---

🔥 Key Features

• ⚡ Advanced LPC Chat Formatting: Clean, per-group, per-world, and global format templates (%prefix%, %player%, %suffix%, %message%, %ping%, %world%, %rank%, %balance%, %online%).
• 🎯 DonutChatHover Interactive Tooltips: Hover over player names to view rank, ping, world, online state, and balance. Includes safe click actions (SUGGEST_COMMAND, RUN_COMMAND, OPEN_URL, COPY_TO_CLIPBOARD) with strict command sanitization to prevent injection.
• 🎨 24 Chat Colors, 15 Gradients & 6 Patterns:
  • 24 Colors: Red, Dark Red, Gold, Yellow, Green, Dark Green, Aqua, Dark Aqua, Blue, Dark Blue, Light Purple, Dark Purple, White, Gray, Dark Gray, Black, Hot Pink, Orange, Coral, Lime, Sky Blue, Mint, Lavender, Teal.
  • 15 Gradients: Sunset, Ocean, Forest, Candy, Twilight, Arctic, Volcanic, Cosmic, Neon, Rose Gold, Midnight, Lava, Aurora, Cyberpunk, Sunfire.
  • 6 Patterns: Rainbow, Fire, Ice, Galaxy, Toxic, Cherry.
• 🔌 Automatic ChatColor Integration: Auto-detects ChatColor API if installed on the server. If absent, PremiumChat seamlessly falls back to its built-in internal color engine without errors.
• 👑 Native LuckPerms & EternalTags Integration:
  • Automatically reads LuckPerms rank prefixes, colors, and groups.
  • Automatically reads EternalTags active suffixes/tags (%suffix% / %tag%).
  • LuckPerms trailing color codes (e.g. &f, &a, &#HEX) automatically set the player name color.
• 🖥️ Modern Chest GUIs:
  • Interactive menus for Colors, Gradients, Patterns, Presets, Live Preview, and Admin Management.
  • Built-in pagination and audio feedback.
• 🔒 Zero-Color Initial Unlock System:
  • Normal players start with 0 colors unlocked.
  • Administrators grant colors using /premiumchat give <player> <type> <id>.
  • Unlocked options instantly appear as equipable in the player's GUI.
• 🛡️ Built-in Moderation & Anti-Spam:
  • Anti-spam cooldowns, duplicate message filter, caps filter, bad word filter, advertisement filter.
  • Chat slow mode (/premiumchat slow), chat mute (/premiumchat mute), chat clear (/premiumchat clear), and staff chat (/staffchat).
• ⚡ High Performance Async Database:
  • Non-blocking SQLite (default) and MySQL/MariaDB async database engines.

---

🛠 Commands & Permissions

Player & Admin Commands

Command	Description	Permission
/premiumchat	Opens main menu GUI	None
/premiumchat color <id>	Selects active chat color	None
/premiumchat gradient <id>	Selects active chat gradient	None
/premiumchat pattern <id>	Selects active chat pattern	None
/premiumchat reset	Unequips active chat selection	None
/premiumchat list <colors|gradients|patterns>	Lists available chat options	None
/premiumchat give <player> <type> <id|all>	Gives color/gradient/pattern access	premiumchat.admin
/premiumchat remove <player> <type> <id|all>	Removes color/gradient/pattern access	premiumchat.admin
/premiumchat defaultcolor <color>	Sets default chat message color	premiumchat.admin
/premiumchat admin	Opens admin management GUI	premiumchat.gui.admin
/premiumchat reload	Reloads all configs & integrations	premiumchat.reload
/premiumchat debug chatcolor	Checks ChatColor integration status	premiumchat.debug
/premiumchat slow <seconds>	Enables chat slow mode	premiumchat.admin
/premiumchat mute	Toggles global chat mute	premiumchat.admin
/premiumchat clear	Clears global chat	premiumchat.admin
/staffchat <message>	Sends a message to staff channel	premiumchat.staffchat

Bypass Permissions

• premiumchat.bypass.spam — Bypass anti-spam & word filters
• premiumchat.bypass.slowchat — Bypass chat slow mode
• premiumchat.bypass.mute — Chat while global chat is muted

---

⚙️ Configuration Files

PremiumChat creates 13 modular configuration files in plugins/PremiumChat/:

• config.yml — Plugin settings & default message color
• messages.yml — Custom messages & prefix
• formats.yml — Per-group & per-world LPC format templates
• hover.yml — Player profile & message hover cards
• click.yml — Hover click action bindings
• colors.yml — 24 color definitions & HEX codes
• gradients.yml — 15 multi-color gradient definitions
• patterns.yml — 6 pattern definitions
• gui.yml — GUI layouts, titles, & audio settings
• filters.yml — Moderation, anti-spam, & word filters
• integrations.yml — Softdepend toggles
• permissions.yml — Permission nodes configuration

---

💻 Developer API

Integrate PremiumChat into your custom plugins:

import com.premiumchat.api.PremiumChatAPI;

// Get player active selection
String color = PremiumChatAPI.getPlayerColor(player);
String gradient = PremiumChatAPI.getPlayerGradient(player);
String pattern = PremiumChatAPI.getPlayerPattern(player);

// Set player active selection
PremiumChatAPI.setPlayerColor(player, "hot-pink");
PremiumChatAPI.setPlayerGradient(player, "ocean");