ColorPrefix
赋予玩家选择自定义前缀颜色的能力 —— 拥有精美的图形用户界面、渐变支持,以及与 TAB、LPC 等插件的自动兼容性。
功能特性
颜色选择 GUI
玩家通过简洁的库存 GUI(/colorprefix)打开界面,显示其拥有权限的所有颜色。皮革胸甲用作染色预览,当前选中的颜色会发光,分页功能可整洁地处理大量颜色列表。
纯色与渐变
支持单个十六进制颜色以及多色阶 MiniMessage 渐变 —— Adventure 引擎会自动为每个字符插值渐变色。只需在 colors.yml 中写几行代码,即可添加任意数量的颜色。
自动多插件支持
ColorPrefix 在启动时检测已安装的聊天和标签页插件,并为每个插件应用正确的颜色格式 —— 同时生效。无需手动配置。
| 插件 |
使用的格式 |
应用方式 |
| TAB by neznamy 4.x+ |
MiniMessage (原生) |
TAB API setPrefix() |
| LPC |
每个字符使用 &#RRGGBB |
LuckPerms 前缀节点 |
| EssentialsXChat |
每个字符使用 &#RRGGBB |
LuckPerms 前缀节点 |
| ChatControl / Red |
每个字符使用 &#RRGGBB |
LuckPerms 前缀节点 |
| CMI |
每个字符使用 §x 十六进制 |
LuckPerms 前缀节点 |
| VentureChat |
每个字符使用 &#RRGGBB |
LuckPerms 前缀节点 |
| 未检测到 |
— |
仅 PlaceholderAPI |
同时安装了 TAB 和 LPC?没问题 —— 两者会同时获得正确的格式。
PlaceholderAPI 支持
在任何支持 PlaceholderAPI 的地方使用 %colorprefix_prefix% 来渲染彩色前缀,无需直接操作 LuckPerms。
| 占位符 |
返回值 |
%colorprefix_prefix% |
彩色的 LP 前缀(包裹在所选颜色中) |
%colorprefix_tag% |
打开 MiniMessage 颜色标签 |
%colorprefix_close_tag% |
关闭 MiniMessage 标签 |
%colorprefix_color_id% |
所选颜色的 ID,或 none |
多语言支持
内置德语 (de) 和英语 (en)。所有消息和 GUI 文本均可通过 MiniMessage 完全自定义。通过将 lang/xx.yml 放入插件文件夹来添加你自己的语言。
配置文件自动迁移
当你更新插件时,新的配置键会自动添加 —— 绝不会覆盖你现有的设置。迁移过程在启动时静默运行,并记录添加了哪些内容。
安装
- 将
ColorPrefix.jar 放入你的 plugins/ 文件夹
- 安装 LuckPerms 和 PlaceholderAPI (推荐)
- 重启服务器 —— 插件会自动检测一切
- 通过 LuckPerms 给予玩家颜色权限(见下文)
- 玩家使用
/colorprefix 打开 GUI
就这样。如果你使用 TAB 或 LPC,则无需更改聊天格式。
权限
| 权限 |
描述 |
colorprefix.use |
打开颜色 GUI (默认:true) |
colorprefix.color.<id> |
访问特定的纯色 |
colorprefix.gradient.<id> |
访问特定的渐变 |
colorprefix.color.* |
访问所有纯色 |
colorprefix.gradient.* |
访问所有渐变 |
colorprefix.* |
完全访问权限,包括管理命令 |
colorprefix.admin.reload |
重载配置和颜色 |
colorprefix.admin.reset |
重置玩家的颜色 |
colorprefix.admin.give |
给玩家分配颜色 |
命令
| 命令 |
权限 |
描述 |
/cp |
colorprefix.use |
打开颜色 GUI |
/cp reload |
colorprefix.admin.reload |
重载配置和颜色 |
/cp reset [player] |
colorprefix.admin.reset |
重置玩家的颜色 |
/cp give <player> <id> |
colorprefix.admin.give |
给玩家分配颜色 |
别名:/colorprefix, /color, /farbe
添加颜色
打开 colors.yml 并添加一个区块 —— 然后运行 /cp reload,无需重启:
纯色:
my_color:
display-name: "My Color"
permission: "colorprefix.color.my_color"
gradient: false
colors:
- "#FF0099"
渐变:
my_gradient:
display-name: "My Gradient"
permission: "colorprefix.gradient.my_gradient"
gradient: true
colors:
- "#FF0000"
- "#FF8800"
- "#FFFF00"
配置
# Language: en or de (or your own lang/xx.yml)
language: en
# Chat plugin integration
chat-plugins:
auto-apply: true # set false to use PlaceholderAPI only
# LuckPerms prefix node weight
luckperms:
prefix-weight: 100
依赖
- Paper / Purpur 1.21.x
- Java 21+
- LuckPerms (可选但强烈建议)
- PlaceholderAPI (可选)
- TAB / LPC / EssentialsChat / CMI / 等 (可选 —— 自动检测)
Made with ♥ by itsLarss
ColorPrefix
Give your players the power to choose their own rank color — with a beautiful GUI, gradient support, and automatic compatibility with TAB, LPC, and more.
Features
Color Selection GUI
Players open a sleek inventory GUI (/colorprefix) showing all colors they have permission for. Leather chestplates serve as dyed previews, the active color glows, and pagination handles large color lists cleanly.
Solid Colors & Gradients
Supports single hex colors as well as multi-stop MiniMessage gradients — Adventure interpolates gradient colors per character automatically. Add as many colors as you want in colors.yml with just a few lines.
Automatic Multi-Plugin Support
ColorPrefix detects your installed chat and tab plugins at startup and applies the correct color format for each one — simultaneously. No manual configuration required.
| Plugin |
Format used |
How it's applied |
| TAB by neznamy 4.x+ |
MiniMessage (native) |
TAB API setPrefix() |
| LPC |
&#RRGGBB per character |
LuckPerms prefix node |
| EssentialsXChat |
&#RRGGBB per character |
LuckPerms prefix node |
| ChatControl / Red |
&#RRGGBB per character |
LuckPerms prefix node |
| CMI |
§x hex per character |
LuckPerms prefix node |
| VentureChat |
&#RRGGBB per character |
LuckPerms prefix node |
| None found |
— |
PlaceholderAPI only |
Having TAB and LPC installed at the same time? No problem — both get the right format simultaneously.
PlaceholderAPI Support
Use %colorprefix_prefix% anywhere PlaceholderAPI is supported to render the colored prefix without touching LuckPerms directly.
| Placeholder |
Returns |
%colorprefix_prefix% |
Colored LP prefix (wrapped in chosen color) |
%colorprefix_tag% |
Opening MiniMessage color tag |
%colorprefix_close_tag% |
Closing MiniMessage tag |
%colorprefix_color_id% |
ID of the selected color, or none |
Multi-Language
Ships with German (de) and English (en). All messages and GUI texts are fully configurable via MiniMessage. Add your own language by dropping a lang/xx.yml into the plugin folder.
Config Auto-Migration
When you update the plugin, new config keys are added automatically — without ever overwriting your existing settings. The migration runs silently on startup and logs what was added.
Installation
- Drop
ColorPrefix.jar into your plugins/ folder
- Install LuckPerms and PlaceholderAPI (recommended)
- Restart the server — the plugin detects everything automatically
- Give players color permissions via LuckPerms (see below)
- Players use
/colorprefix to open the GUI
That's it. No chat format changes needed if you use TAB or LPC.
Permissions
| Permission |
Description |
colorprefix.use |
Open the color GUI (default: true) |
colorprefix.color.<id> |
Access a specific solid color |
colorprefix.gradient.<id> |
Access a specific gradient |
colorprefix.color.* |
Access all solid colors |
colorprefix.gradient.* |
Access all gradients |
colorprefix.* |
Full access including admin commands |
colorprefix.admin.reload |
Reload config and colors |
colorprefix.admin.reset |
Reset a player's color |
colorprefix.admin.give |
Give a color to a player |
Commands
| Command |
Permission |
Description |
/cp |
colorprefix.use |
Open color GUI |
/cp reload |
colorprefix.admin.reload |
Reload config & colors |
/cp reset [player] |
colorprefix.admin.reset |
Reset a player's color |
/cp give <player> <id> |
colorprefix.admin.give |
Give a color to a player |
Aliases: /colorprefix, /color, /farbe
Adding Colors
Open colors.yml and add a block — then run /cp reload, no restart needed:
Solid color:
my_color:
display-name: "My Color"
permission: "colorprefix.color.my_color"
gradient: false
colors:
- "#FF0099"
Gradient:
my_gradient:
display-name: "My Gradient"
permission: "colorprefix.gradient.my_gradient"
gradient: true
colors:
- "#FF0000"
- "#FF8800"
- "#FFFF00"
Configuration
# Language: en or de (or your own lang/xx.yml)
language: en
# Chat plugin integration
chat-plugins:
auto-apply: true # set false to use PlaceholderAPI only
# LuckPerms prefix node weight
luckperms:
prefix-weight: 100
Requirements
- Paper / Purpur 1.21.x
- Java 21+
- LuckPerms (optional but strongly recommended)
- PlaceholderAPI (optional)
- TAB / LPC / EssentialsChat / CMI / etc. (optional — auto-detected)
Made with ♥ by itsLarss
评论 0
登录后参与评分
还没有评论,来抢沙发吧