1.0.0
Compatibility
Changes
PremiumChat Version Changelog
🚀 Version 1.0.0 — Initial Release
Welcome to the official initial release of PremiumChat v1.0.0! PremiumChat is a complete, production-ready Minecraft chat formatting system built targeting Paper and Purpur 1.20+ / 1.21+ on Java 21+.
✨ Features & Highlights
💬 1. LPC-Style Chat Formatting System
- Priority-driven format template resolution (
Group→World→Default). - Built-in placeholder support (
%prefix%,%player%,%suffix%,%tag%,%message%,%ping%,%world%,%group%,%rank%,%balance%,%online%,%player_count%). - Configurable default chat message color (defaults to Gray
<gray>/#AAAAAAfor uncolored chat messages). - Administrative command
/premiumchat defaultcolor <colorId|hex>to set the default message color dynamically.
👑 2. Native LuckPerms & EternalTags Integration
- LuckPerms Rank & Prefix Hook: Automatically reads group rank prefixes and primary group.
- LuckPerms Trailing Color Name Hook: Trailing color codes in your LuckPerms prefix (e.g.
&f,&a,&#HEX) automatically define the player name color in non-bold weight. - EternalTags Suffix Hook: Automatically reads active tags from EternalTags via
%eternaltags_tag%or Vault.
🎯 3. DonutChatHover Interactive Tooltips & Click Actions
- Player profile hover cards displaying rank, ping, world, online state, and balance.
- Message hover tooltips with sent timestamps.
- Interactive click actions (
SUGGEST_COMMAND,RUN_COMMAND,OPEN_URL,COPY_TO_CLIPBOARD). - Command injection prevention and URL sanitization.
@Playermention highlighting, sound notifications, and tooltips.
🎨 4. Colors, Gradients & Patterns Engine
- 24 Standard 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,mint,lavender,teal. - 15 Standard Gradients:
sunset,ocean,forest,candy,twilight,arctic,volcanic,cosmic,neon,rose-gold,midnight,lava,aurora,cyberpunk,sunfire. - 6 Standard Patterns:
rainbow,fire,ice,galaxy,toxic,cherry. - Automatic ChatColor Integration: Auto-detects ChatColor API if installed. If absent, PremiumChat seamlessly falls back to its built-in internal color engine without errors.
🖥️ 5. Modern Chest GUIs & Unlock System
- Interactive menus for Main GUI, Colors, Gradients, Patterns, Presets, Preview, and Admin Overview.
- Zero-Color Initial Unlock System: Players start with 0 colors unlocked by default.
- Administrators grant colors using
/premiumchat give <player> <type> <id|all>. - In-game unlock notifications sent to target players when granted a new color.
🛡️ 6. Anti-Spam & Moderation Tools
- Cooldowns, duplicate message filter, caps filter, bad word filter, advertisement filter.
- Chat slow mode (
/premiumchat slow <seconds>). - Chat mute (
/premiumchat mute). - Chat clear (
/premiumchat clear). - Staff chat channel (
/staffchat <message>).
⚡ 7. Database Persistence & Developer API
- Asynchronous SQLite (default) and MySQL/MariaDB storage drivers. Never blocks the main server thread.
PremiumChatAPIstatic methods for third-party plugins.- Paper custom events (
PremiumChatMessageEvent,PremiumChatFormatEvent,PremiumChatHoverEvent,PremiumChatColorEvent,PremiumChatGradientEvent).
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:XRqEiRQL:LvLJ7JDs"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:XRqEiRQL:LvLJ7JDs"
}

