Premium Chat

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

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");