原创 开源 工具 娱乐 【原创/1.21+】HyperNick - 高版本匿名插件 v1.3.1

[MD] # HyperNick — 全新高版本匿名插件 | Book GUI | 多语言 | 数据包级伪装 ## 简介 **HyperNick** 是一款模仿 Hypixel Nick 系统的 Minecraft 自定义昵称插件。 通过 ProtocolLib 数据包拦截实现完整的 **UUID + 名称 + 皮肤**伪装，服务端数据（背包、权限、经济）完全继承。玩家可以通过 **Book GUI** 分步选择 Rank、皮肤和昵称，本插件由AI辅助完成。 --- ## 核心特性 ### Book GUI 匿名系统 模仿 Hypixel Nickname，玩家执行 `/nick` 即可打开书本 GUI，分步完成设置： - **主菜单** — 说明页，点击开始设置 - **Rank 选择** — 选择伪装等级（VIP / MVP 等） - **Skin 选择** — 真实皮肤 / 随机皮肤 / 默认皮肤（Steve/Alex）【有BUG，以后会修复】 - **Name 选择** — 随机昵称 / 使用上次昵称 / 自定义昵称（告示牌输入） 所有 GUI 页面均可在 `GUI/*.yml` 中**完全自定义**文本、颜色和点击指令。 ### 完整身份伪装 - 使用 **Fake UUID**（version 5 格式）替换 GameProfile 的 UUID 与名称 - 客户端看到的是全新身份，Tab 列表 / 头顶名牌 / 聊天全部替换 - 七层拦截：`PLAYER_INFO`、`PLAYER_INFO_REMOVE`、`SPAWN_ENTITY`、`TAB_COMPLETE`、`CHAT`、`SYSTEM_CHAT`、事件层 ### Rank 前缀系统 - 通过 LuckPerms 瞬态节点设置伪装 Rank 前缀 - 支持**传统颜色代码**（`&a &b &l`）和 **HEX 颜色代码**（`&#FF55FF`） - 昵称自动继承 Rank 前缀中最后一个颜色代码 - 未匿名玩家也可根据 LuckPerms 组别自动显示前缀 ### 随机昵称结果页 生成随机昵称后，不会直接应用，而是显示 Book GUI 结果页，玩家可选择： - **使用** 该昵称 - **重新随机** - **自定义输入** ### 错误提示页 遇到禁用 / 已存在 / 非法昵称时，通过 Book GUI 显示错误原因，提供重新输入和随机昵称选项。 ### 其他功能 - `/nick reuse` — 一键复用上次昵称 - `/nick skin <REAL|RANDOM|RESET>` — 切换皮肤模式（立即刷新） - `/unnick` — 快捷取消匿名（同 `/nick reset`） - `/nick reload` — 重载配置并立即刷新所有在线玩家显示 - 名称冲突防护 — 防止设置已存在的玩家名，自动清除冲突昵称 - 每日限额 — 可配置每日昵称修改次数 - PlaceholderAPI 集成 — 提供 11 个变量 --- ## 指令 | 指令 | 权限 | 说明 | |------|------|------| | `/nick` | `hypernick.use` | 打开 Book GUI 匿名设置 | | `/nick <名称>` | `hypernick.use` | 直接设置自定义昵称 | | `/nick random` | `hypernick.use` | 随机昵称 | | `/nick rank <等级>` | `hypernick.use` | 设置伪装 Rank 前缀 | | `/nick skin <REAL\|RANDOM\|RESET>` | `hypernick.use` | 设置皮肤模式 | | `/nick reuse` | `hypernick.use` | 复用上次昵称 | | `/nick info` | `hypernick.use` | 查看匿名详细信息 | | `/nick reset` | `hypernick.use` | 取消匿名 | | `/unnick` | `hypernick.use` | 快捷取消匿名 | | `/nick reload` | `hypernick.admin` | 重载配置 | > 别名：`/nickname`、`/disguise` --- ## 权限 | 权限节点 | 默认 | 说明 | |----------|------|------| | `hypernick.use` | OP | 使用 /nick 指令 | | `hypernick.admin` | OP | 重载配置 | --- ## PlaceholderAPI 变量 | 变量 | 说明 | |------|------| | `%hypernick_nickname%` | 当前昵称 | | `%hypernick_prefix%` | Rank 前缀 | | `%hypernick_rank%` | Rank 键名 | | `%hypernick_fakeuuid%` | Fake UUID | | `%hypernick_realuuid%` | 真实 UUID | | `%hypernick_isnicked%` | 是否已匿名 | | `%hypernick_group_rank%` | LuckPerms 组别对应的 Rank | --- ## 多语言支持 插件内置 **11 种语言**，默认使用简体中文 在 `config.yml` 中修改 `lang: "zh_hans"` 即可切换语言。 --- ## 可自定义 GUI 所有 Book GUI 页面可在 `plugins/HyperNick/GUI/` 文件夹中自由编辑： | 文件 | 页面 | |------|------| | `main.yml` | 主菜单（说明页） | | `rank.yml` | Rank 选择页（支持模板遍历） | | `skin.yml` | Skin 选择页 | | `name.yml` | Name 选择页（支持条件显示） | | `error.yml` | 错误提示页 | | `random-result.yml` | 随机昵称结果页 | 每行支持 `text`（文本）、`click`（点击指令）、`condition`（显示条件）三个字段，支持颜色代码和占位符。 --- ## 配置文件 ### config.yml ```yaml # 语言 lang: "zh_hans" # 数据包级别名称替换（需要 ProtocolLib） packet-disguise: true # 计分板名牌前缀 scoreboard-nametag: true # 接管聊天格式（避免 fake UUID 导致聊天验证错误） override-chat: true # 指令中解析昵称（/tp NickName 等） resolve-nicknames-in-commands: true # 聊天格式: {prefix} {name} {suffix} {message} chat-format: "{prefix}{name}&r&7: &r{message}" # 昵称设置 nick-settings: min-length: 3 max-length: 16 daily-limit: -1 # -1 为无限 allow-custom: true allow-numbers: true allow-underscore: true blocked-names: - "Notch" - "Dinnerbone" - "admin" - "staff" # 随机昵称生成器 name-generator: style: ENGLISH # ENGLISH / PINYIN / MIXED append-number: true number-digits: 2 adjectives: [Swift, Brave, Silent, ...] nouns: [Fox, Wolf, Hawk, ...] ``` ### ranks.yml ```yaml # 未匿名玩家自动显示前缀 enable-group-prefix: true # LuckPerms 组别 → Rank 映射 group-mapping: default: default vip: vip mvp: mvp # Rank 定义（支持 HEX 颜色） ranks: default: prefix: "&7" color: "GRAY" priority: 10 vip: prefix: "&a[VIP] " color: "GREEN" priority: 100 mvp: prefix: "&b[MVP] " color: "AQUA" priority: 300 # HEX 自定义颜色示例: # custom: # prefix: "&#55FFFF[CUSTOM] " # color: "#55FFFF" # priority: 500 # 随机 Rank 池 random-rank-pool: [default, vip, mvp] ``` --- ## 环境要求 | 依赖 | 类型 | 说明 | |------|------|------| | PaperMC 1.21+ / 26.x | 必需 | 服务端（Java 21+） | | ProtocolLib 5.4.0+ | 软依赖 | 数据包拦截（缺少则仅聊天/Tab 显示名生效） | | LuckPerms 5.5+ | 软依赖 | Rank 前缀（缺少则无前缀） | | PlaceholderAPI 2.12.3+ | 软依赖 | 变量扩展（缺少则无变量支持） | --- ## 安装 1. 将 `HyperNick-bukkit-(版本号).jar` 放入服务器的 `plugins/` 目录 2. 确保 ProtocolLib、LuckPerms、PlaceholderAPI 已安装 3. 启动服务器，自动生成默认配置文件 4. 根据需要修改 `config.yml`、`ranks.yml` 和 `GUI/*.yml` 5. 重启或执行 `/nick reload` --- ## 未来更新计划 1.支持本地/MySQL数据库 ✅ 2.完善自定义 Skin 功能 3.适配更多版本 4....（计划中） --- ## 许可 MIT License --- > 反馈与建议请回复本帖或前往 GitHub Issues 提交。[/MD]