原创 娱乐 Colorful Names - 名字颜色自定义 1.21+ | 支持Folia | 支持MySQL｜简易配置 1.0.0

[MD] # ColorfulNames（中文） 一个轻量级 Minecraft 名字颜色插件：支持传统颜色、HEX 颜色、GUI 预设、随机颜色、导入导出、权限默认色、经济扣费和 PlaceholderAPI。兼容 Paper / Folia 1.21+。 --- ## 名字颜色类型 | 类型 | 说明 | |------|------| | **传统颜色** | 使用经典 Minecraft 颜色码，例如 `&a`、`&b`、`&c`、`&f`。 | | **HEX 颜色** | 使用更细腻的颜色，例如 `#55F7D4` 或 `&#55F7D4`。 | | **渐变颜色** | 让玩家名字呈现静态渐变效果。 | | **三段渐变** | 支持开始色、中间色、结束色，效果更丰富。 | | **样式颜色** | 可选粗体、斜体、下划线。 | | **预设颜色** | 服主预先配置颜色，玩家可在 GUI 中选择。 | | **随机颜色** | 玩家可以随机应用一个可用预设或渐变。 | --- ## 核心功能 - **GUI 颜色菜单**：支持预设、渐变、翻页、重置和关闭。 - **命令改色**：支持传统颜色、HEX、渐变、预设、随机、导入导出和重置。 - **静态渐变**：没有动态动画任务，更适合长期稳定运行。 - **权限默认色**：VIP 或特殊权限组可以拥有独立默认颜色。 - **冷却和每日限制**：控制玩家改色频率。 - **经济支持**：通过 Vault 对不同操作收取不同价格。 - **PlaceholderAPI 支持**：可接入 TAB、聊天格式、计分板等展示位置。 - **CMI 昵称支持**：显示 CMI nickname，同时保留 ColorfulNames 的颜色。 - **中英文提示**：内置简体中文和英文。 - **Paper / Folia 兼容**。 设置前: [ATTACH type="full" size="572x34"]136959[/ATTACH] 设置后: [ATTACH type="full" size="572x38"]136960[/ATTACH] --- ## 玩家命令 | 命令 | 说明 | |------|------| | `/namecolor gui` | 打开颜色选择菜单。 | | `/namecolor <颜色>` | 设置传统颜色或 HEX 颜色。 | | `/namecolor gradient <开始色> <结束色> [中间色] [样式]` | 设置静态渐变名字。 | | `/namecolor preset <id>` | 应用服务器预设颜色。 | | `/namecolor random` | 随机应用一个可用颜色或渐变。 | | `/namecolor export` | 导出当前颜色方案。 | | `/namecolor import <内容>` | 导入导出串或原始颜色代码。 | | `/namecolor reset` | 恢复默认名字颜色。 | 别名： ```text /nc /ncolor ``` --- ## 管理员命令 | 命令 | 说明 | |------|------| | `/namecolor get <玩家>` | 查看玩家当前颜色代码。 | | `/namecolor set <玩家> <颜色>` | 为玩家设置颜色。 | | `/namecolor reload` | 重载插件设置、语言、颜色库和 GUI。 | --- ## 使用示例 设置绿色名字： ```text /namecolor &a ``` 设置 HEX 薄荷色： ```text /namecolor &#55F7D4 ``` 设置粉紫渐变： ```text /namecolor gradient #FF8A00 #FF2D95 ``` 设置粗体渐变： ```text /namecolor gradient #FF8A00 #FF2D95 l ``` 设置三段渐变： ```text /namecolor gradient #55F7D4 #2AA9FF #A970FF ``` 打开 GUI： ```text /namecolor gui [ATTACH type="full" size="720x446"]136961[/ATTACH] ``` 应用预设： ```text /namecolor preset aurora ``` 导出颜色方案： ```text /namecolor export ``` 导入别人分享的方案： ```text /namecolor import <导出内容> ``` --- ## 样式 | 样式 | 含义 | |------|------| | `l` | 粗体 | | `o` | 斜体 | | `n` | 下划线 | 样式可以组合： ```text /namecolor gradient #55F7D4 #A970FF lon ``` --- ## GUI 玩家可以使用： ```text /namecolor gui ``` 打开颜色菜单。 GUI 可以包含： - 传统颜色预设 - HEX 颜色预设 - 渐变预设 - 上一页 / 下一页 - 恢复默认 - 关闭菜单 如果服务器准备了很多颜色，插件会自动分页。 --- ## 权限 | 权限 | 说明 | |------|------| | `colorfulnames.change` | 允许玩家使用改色功能。 | | `colorfulnames.admin.get` | 允许使用 `/namecolor get`。 | | `colorfulnames.admin.set` | 允许使用 `/namecolor set`。 | | `colorfulnames.admin.reload` | 允许使用 `/namecolor reload`。 | 示例： ```text /lp group default permission set colorfulnames.change true ``` --- ## 经济 安装 Vault 和经济插件后，改色可以收费。 可收费操作： | 操作 | 说明 | |------|------| | **普通改色** | `/namecolor <颜色>` | | **预设颜色** | `/namecolor preset <id>` 或 GUI 点击预设 | | **渐变颜色** | `/namecolor gradient ...` 或 GUI 点击渐变 | | **随机颜色** | `/namecolor random` | | **导入颜色** | `/namecolor import ...` | | **恢复默认** | `/namecolor reset` 或 GUI 恢复默认 | 也可以给玩家设置免费权限或折扣权限。 --- ## 冷却和限制 服务器可以限制玩家改色频率。 示例： - 每 60 秒只能改色一次 - 每天最多改色 5 次 - VIP 组拥有更好的默认颜色 适合生存服、经济服，以及把颜色作为奖励的服务器。 --- ## PlaceholderAPI 常用变量： | 变量 | 说明 | |------|------| | `%colorfulnames_name%` | 彩色玩家名。 | | `%colorfulnames_plain_name%` | 纯玩家名。 | | `%colorfulnames_console_name%` | 适合控制台 / 日志使用的纯玩家名。 | | `%colorfulnames_code%` | 当前保存的原始颜色代码。 | | `%colorfulnames_legacy_code%` | 传统颜色前缀。 | | `%colorfulnames_display_name%` | 当前 display name。 | | `%colorfulnames_cmi_name%` | CMI nickname + ColorfulNames 颜色。 | | `%colorfulnames_cmi_console_name%` | 控制台 / 日志使用的原始玩家名。 | 测试： ```text /papi parse me %colorfulnames_name% ``` --- ## TAB 和聊天示例 显示彩色原名： ```text %colorfulnames_name% ``` 显示 CMI 昵称并套用 ColorfulNames 颜色： ```text %colorfulnames_cmi_name% ``` 控制台或日志格式建议使用纯原名： ```text %colorfulnames_console_name% ``` 或： ```text %colorfulnames_cmi_console_name% ``` --- ## CMI 昵称支持 ColorfulNames 可以使用玩家的 CMI nickname 作为显示名，同时保留玩家选择的 ColorfulNames 颜色或渐变。 效果示例： ```text ✎ Nickname ``` 昵称前的标记可以由服务器修改或关闭。 --- ## 适合场景 | 场景 | 示例 | |------|------| | **VIP 权益** | VIP 玩家默认拥有渐变名字。 | | **外观商店** | 玩家花费金币解锁或应用颜色。 | | **活动奖励** | 发放限时节日颜色。 | | **等级系统** | 高等级玩家可使用更多高级预设。 | | **社交服务器** | 让玩家个性化聊天和 TAB 名字。 | --- ## 兼容性 | 插件 / 平台 | 支持情况 | |-------------|----------| | Paper | 支持 | | Folia | 支持 | | PlaceholderAPI | 支持 | | Vault | 支持 | | TAB | 通过变量支持 | | CMI | 通过 nickname 变量支持 | --- ## 语言 内置语言： - English - 简体中文 服务器可以自由修改提示文本。 --- [/MD]