HexNicks 是一款简单易用的 Minecraft 昵称插件，允许玩家自定义包含普通颜色、十六进制颜色甚至渐变色的个性化昵称。它完全支持 Spigot 和 Paper 服务器，同时也兼容它们的衍生版本。插件提供了少量指令和权限，方便服务器管理员进行管理。HexNicks 支持 MySQL 存储，尤其适合小型 Spigot/Paper 服务器。

✨ HexNicks 插件

⭐ 主要特性

• 采用 MiniMessage 解析，方便快捷地设置昵称样式。
• 针对 Spigot 和 Paper 进行了优化，兼容各类衍生服务端。
• 支持 PlaceholderAPI，使用 %hexnicks_nick% 占位符显示玩家昵称。
• 支持 MySQL 存储，方便 BungeeCord/Velocity 用户跨服务器同步昵称。
• 通过 bStats 收集插件使用数据。
• 活跃的插件维护和开发者支持。
• 内置聊天格式化功能，无需额外聊天格式化插件。
• 提供功能完善的 API 供开发者使用。
• 提供完整的文档。

🎮 指令

插件包含以下 6 个指令：

• /nick <nickname> - 设置自己的昵称。
• /nickother <player> <nickname> - 设置其他玩家的昵称。
• /nonick [player] - 移除自己或其他玩家的昵称。
• /nickcolor <color> - 更改昵称的颜色。
• /realname <nickname> - 查询拥有特定昵称的玩家的用户名。
• /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 将点击事件等内容注入到聊天消息中。

🎨 颜色

渐变色

在未修改配置的情况下，默认不支持旧版颜色代码（&c、&l 等）。启用配置选项后可以粗略支持，但插件主要使用 MiniMessage 进行颜色和格式设置。

HexNicks 让你轻松地在昵称中使用漂亮的渐变色。格式很简单，例如上面的示例命令是：

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

注意：如果不希望在初始文本后添加任何内容，则结束标记是可选的。

第一个渐变标签也可以采用两个以上的十六进制代码，但它们必须采用标准的六字符十六进制格式。

在此处查看大量的十六进制代码。

👨‍💻 开发者

HexNicks 提供了 API，并且所有命令在执行时都会触发事件。这些事件可以像其他 Bukkit 事件一样进行监听。你可以在此处查看事件，并在此处查看所有 JavaDocs。

事件示例：

@EventHandler
public void onNickname(SetNickEvent event) {
  Player player = event.player();
  player.sendMessage("Setting nickname...");
  event.newNick(Component.text("New nickname"));
}

有多种方法可以检索昵称，但最简单的方法是：

Nicks.api().getNick(player); // You can pass thru a player, offlineplayer, or uuid

❓ 支持

如果您在使用插件时遇到问题，并且在 Spigot 上找不到答案，那么获得帮助的最佳方式是加入我的 Discord。请务必先阅读常见问题解答频道，然后再在错误报告频道（如果是错误）或 hexnicks 频道（用于一般帮助）中发布内容。

如果你发现了错误，你可以加入我的 Discord 并在那里报告，或者在 GitHub 上创建一个 issue。请不要在 Spigot 上给我发送有关错误的私信，有更简单的沟通方式。

请不要将错误报告或问题作为评论发布！获得支持的最快方式是 Discord！