PremiumChat ?✨
适用于 Paper 和 Purpur 的终极现代 Minecraft 聊天系统
PremiumChat 是一款生产就绪、高性能的聊天格式化插件,专为现代 Minecraft 服务器(1.20+ / 1.21+)设计。它将 LPC 风格的聊天格式化、DonutChatHover 风格的交互式玩家卡片、Adventure MiniMessage 格式化、RGB/HEX 渐变与图案、LuckPerms 与 EternalTags 钩子、现代箱子 GUI 以及自动 ChatColor API 发现功能整合为一个精致的解决方案。
? 主要特性
- ⚡ 高级 LPC 聊天格式化:简洁的按组、按世界和全局格式模板(
%prefix%、%player%、%suffix%、%message%、%ping%、%world%、%rank%、%balance%、%online%)。
- ? DonutChatHover 交互式工具提示:悬停在玩家名称上即可查看排名、延迟、世界、在线状态和余额。包含安全的点击操作(
SUGGEST_COMMAND、RUN_COMMAND、OPEN_URL、COPY_TO_CLIPBOARD),并具备严格的命令清理功能以防止注入攻击。
- ? 24 种聊天颜色、15 种渐变 & 6 种图案:
- 24 种颜色: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 种渐变:Sunset, Ocean, Forest, Candy, Twilight, Arctic, Volcanic, Cosmic, Neon, Rose Gold, Midnight, Lava, Aurora, Cyberpunk, Sunfire。
- 6 种图案:Rainbow, Fire, Ice, Galaxy, Toxic, Cherry。
- ? 自动集成 ChatColor:如果服务器上安装了 ChatColor API,则自动检测。如果未安装,PremiumChat 将无缝回退到其内置的内部颜色引擎,不会报错。
- ? 原生 LuckPerms 与 EternalTags 集成:
- 自动读取 LuckPerms 的排名前缀、颜色和组别。
- 自动读取 EternalTags 的活动后缀/标签(
%suffix% / %tag%)。
- LuckPerms 尾部颜色代码(例如
&f、&a、&#HEX)会自动设置玩家名称的颜色。
- ?️ 现代箱子 GUI:
- 用于颜色、渐变、图案、预设、实时预览和管理员的交互式菜单。
- 内置分页和音频反馈。
- ? 零初始解锁颜色系统:
- 普通玩家默认解锁 0 种颜色。
- 管理员使用
/premiumchat give <player> <type> <id> 授予颜色权限。
- 解锁的选项会立即出现在玩家的 GUI 中作为可装备项。
- ?️ 内置管理 & 反垃圾邮件:
- 防垃圾冷却时间、重复消息过滤、大写过滤、脏话过滤、广告过滤。
- 聊天慢速模式(
/premiumchat slow)、聊天禁言(/premiumchat mute)、聊天清除(/premiumchat clear)以及员工聊天(/staffchat)。
- ⚡ 高性能异步数据库:
- 非阻塞 SQLite(默认)和 MySQL/MariaDB 异步数据库引擎。
? 命令与权限
玩家与管理员命令
| 命令 |
描述 |
权限 |
/premiumchat |
打开主菜单 GUI |
无 |
/premiumchat color <id> |
选择活动的聊天颜色 |
无 |
/premiumchat gradient <id> |
选择活动的聊天渐变 |
无 |
/premiumchat pattern <id> |
选择活动的聊天图案 |
无 |
/premiumchat reset |
卸下活动的聊天选择 |
无 |
/premiumchat list <colors|gradients|patterns> |
列出可用的聊天选项 |
无 |
/premiumchat give <player> <type> <id|all> |
授予颜色/渐变/图案访问权限 |
premiumchat.admin |
/premiumchat remove <player> <type> <id|all> |
移除颜色/渐变/图案访问权限 |
premiumchat.admin |
/premiumchat defaultcolor <color> |
设置默认的聊天消息颜色 |
premiumchat.admin |
/premiumchat admin |
打开管理员管理 GUI |
premiumchat.gui.admin |
/premiumchat reload |
重新加载所有配置及集成 |
premiumchat.reload |
/premiumchat debug chatcolor |
检查 ChatColor 集成状态 |
premiumchat.debug |
/premiumchat slow <seconds> |
启用聊天慢速模式 |
premiumchat.admin |
/premiumchat mute |
切换全局聊天禁言 |
premiumchat.admin |
/premiumchat clear |
清除全局聊天 |
premiumchat.admin |
/staffchat <message> |
向员工频道发送消息 |
premiumchat.staffchat |
绕过权限
premiumchat.bypass.spam — 绕过反垃圾邮件和单词过滤器
premiumchat.bypass.slowchat — 绕过聊天慢速模式
premiumchat.bypass.mute — 在全局聊天被禁言时仍可聊天
⚙️ 配置文件
PremiumChat 在 plugins/PremiumChat/ 目录下创建 13 个模块化配置文件:
config.yml — 插件设置及默认消息颜色
messages.yml — 自定义消息及前缀
formats.yml — 按组和按世界的 LPC 格式模板
hover.yml — 玩家资料及消息悬停卡片
click.yml — 悬停点击操作绑定
colors.yml — 24 种颜色定义及 HEX 代码
gradients.yml — 15 种多色渐变定义
patterns.yml — 6 种图案定义
gui.yml — GUI 布局、标题及音频设置
filters.yml — 管理、反垃圾邮件及单词过滤器
integrations.yml — 软依赖开关
permissions.yml — 权限节点配置
? 开发者 API
将 PremiumChat 集成到您的自定义插件中:
import com.premiumchat.api.PremiumChatAPI;
// 获取玩家当前选择
String color = PremiumChatAPI.getPlayerColor(player);
String gradient = PremiumChatAPI.getPlayerGradient(player);
String pattern = PremiumChatAPI.getPlayerPattern(player);
// 设置玩家当前选择
PremiumChatAPI.setPlayerColor(player, "hot-pink");
PremiumChatAPI.setPlayerGradient(player, "ocean");
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");
评论 0
登录后参与评分
还没有评论,来抢沙发吧