HexNicks - Easy nicknames with gradients! - HexNicks - 简易昵称与渐变色彩

HexNicks 是一款简洁的昵称插件，允许玩家设置包含普通颜色、十六进制颜色乃至渐变的个性化昵称。它原生支持 MiniMessage 解析，无需依赖外部聊天格式化插件，并为开发者提供了功能完善的 API。

💡版本与兼容性

此插件仍在持续更新，支持 Minecraft 1.19+ 和 1.20+ 版本。

• 版本 3.0.0 及以上：仅支持 Paper 服务端。
• 版本 2.2.2：这是最后一个支持 Spigot 的版本，将保留在此页面，但不再接收更新。
• 您可以在 此处 下载最新版本。

🎮功能特性

• 强大的文本解析：通过 MiniMessage 解析颜色与格式，您可以使用 此便捷网站 进行练习。
• 广泛的兼容性：优化支持 Spigot 和 Paper 服务端，其衍生版本通常也可运行。
• PlaceholderAPI 支持：提供 %hexnicks_nick% 占位符以获取玩家昵称。
• 跨服数据同步：支持 MySQL 存储，适用于 BungeeCord/Velocity 网络。
• 内置聊天格式化：无需额外聊天格式化插件即可美化聊天信息。
• 开发者 API：提供功能完整的 API 供开发者调用。
• 数据统计：通过 bStats 收集匿名使用数据。
• 活跃维护：插件与开发者均保持活跃更新。
• 完整文档：所有详细说明请参阅 官方文档。

🔧命令列表

插件共有 6 个命令

• /nick <昵称> - 设置你自己的昵称。
• /nickother <玩家> <昵称> - 设置其他玩家的昵称。
• /nonick [玩家] - 移除你自己或指定玩家的昵称。
• /nickcolor <颜色> - 仅更改你昵称的颜色。
• /realname <昵称> - 根据昵称查询对应的玩家真实用户名。
• /nicksreload - 重载插件配置。

✨权限节点

除 hexnicks.nick.other、hexnicks.nonick.other、hexnicks.chat.advanced 和 hexnicks.reload 外，所有权限默认授予所有玩家。您可以使用 LuckPerms 等权限管理器来取消默认授权。

• hexnicks.nick - 允许更改自己的昵称。
• hexnicks.color.* - 允许在昵称中使用所有标准颜色代码。
• hexnicks.color.hex - 允许在昵称中使用十六进制颜色代码。
• hexnicks.color.gradient - 允许在昵称中使用渐变效果。
• hexnicks.nick.other - 允许更改其他玩家的昵称。
• hexnicks.nonick - 允许移除自己的昵称。
• hexnicks.nonick.other - 允许移除其他玩家的昵称。
• hexnicks.nickcolor - 允许使用 /nickcolor 命令。
• hexnicks.reload - 允许重载插件。
• hexnicks.chat.advanced - 允许通过 MiniMessage 在聊天消息中插入点击事件等高级格式。

⭐颜色与渐变

HexNicks 使用 MiniMessage 进行颜色和格式解析，默认不支持旧版颜色代码（如 &c、&l 等）。您可以在配置文件中启用对旧版代码的有限支持。

渐变功能

现在，您可以轻松在昵称中使用华丽的渐变效果。格式非常简单，例如以下命令：

/nick <gradient:#1eae98:#d8b5ff>Majekdor</gradient>

• 注意：如果您不希望初始文本后有任何内容，结束标签 </gradient> 是可选的。
• 第一个 <gradient> 标签可以接受两个以上的十六进制颜色码，但必须使用标准的6字符格式（如 #RRGGBB）。
• 您可以在此 网站 查阅大量十六进制颜色代码。

❓开发者相关

HexNicks 提供了 API，并且所有命令执行时都会触发相应事件。您可以像监听其他 Bukkit 事件一样监听这些事件。

• 查看所有可用事件，请访问 事件列表。
• 查看完整的 JavaDocs，请访问 API 文档。

事件监听示例

@EventHandler
public void onNickname(SetNickEvent event) {
    Player player = event.player();
    player.sendMessage("正在设置昵称...");
    event.newNick(Component.text("新昵称"));
}

获取玩家昵称

获取玩家昵称有多种方式，最简单的方法是

Nicks.api().getNick(player); // 参数可以是 Player, OfflinePlayer 或 UUID

🔧支持与反馈

如果您需要帮助但在 Spigot 页面上找不到答案，最佳方式是加入我的 Discord 服务器。请在发帖前阅读常见问题频道。

• 报告漏洞：您可以加入 Discord 或在 GitHub 上提交 Issue。请不要通过 Spigot 私信报告漏洞。
• 重要提示：请不要将漏洞报告或问题发表在评论/评价中！ 在 Discord 中寻求支持是最快的方式。