开源 娱乐 自定义玩家屏幕菜单 —— 多场景多样化的实时面对面菜单使用场景【免费版】 1.5.0

# 1.4.0

## 新增功能 / New Features

### NPC镜像系统 / NPC Mirror System

- **新增NPC镜像模块** - 在3D菜单中创建玩家镜像NPC
- 自动同步玩家装备（头盔、胸甲、护腿、靴子、主手、副手）
- 支持SkinsRestorer皮肤同步
- 可配置NPC位置偏移和朝向
- 支持菜单关联配置，可指定哪些菜单启用NPC
- NPC名称支持自定义格式和PlaceholderAPI变量
- 玩家可单独禁用自己的NPC创建

### WASD导航系统 / WASD Navigation System

- **新增WASD导航模块** - 使用键盘导航菜单
- W/S 键上下选择菜单项
- A/D 键左右选择菜单项
- 空格键确认执行命令
- 与原有光标控制系统完全兼容，可同时使用
- 支持菜单关联配置
- 选择时自动放大选中项并播放音效
- 选择冷却机制防止快速连续选择

### PlaceholderAPI变量 / PlaceholderAPI Variables

- **新增WASD导航PAPI变量**
- `%cmp_wasd_menu%` - 当前WASD菜单名称
- `%cmp_wasd_enabled%` - 是否启用WASD导航
- `%cmp_wasd_index%` - 当前选中索引
- `%cmp_wasd_x%` - 当前X坐标
- `%cmp_wasd_y%` - 当前Y坐标
- `%cmp_wasd_z%` - 当前Z坐标
- `%cmp_wasd_location%` - 完整位置信息（格式：菜单名,x,y,z）
- `%cmp_<菜单名>_xyz%` - 指定菜单的坐标

### 新增配置文件 / New Configuration Files

- `npc_config.yml` - NPC镜像系统配置
- 启用/禁用NPC功能
- NPC位置偏移配置
- 菜单关联设置（白名单/黑名单模式）
- 名称显示配置（支持PAPI变量）
- 装备和皮肤同步开关

- `wasd_config.yml` - WASD导航系统配置
- 启用/禁用WASD导航
- 导航阈值配置
- 选择冷却时间
- 音效配置
- 菜单关联设置

- 新增 `wasd-enabled` 选项 - 单独控制每个菜单的WASD导航开关

### 新增软依赖 / New Soft Dependencies

- **FancyNpcs** (可选) - NPC镜像功能必需
- **SkinsRestorer** (可选) - NPC皮肤同步支持

里程碑更新:

• 当前版本是一个分水岭，插件将在下一个版本进入1.4.0的版本。

新增功能:

• 完全自定义的登录注册系统
• 完全支持玩家的注册、登录、密码显示以及玩家账号的记录存储。
• 支持本地 SQL 玩家数据存储。

改进:

• 删除了与 ProtocolLib 插件相关的所有剩余无用代码。
• 改进了 IP 绑定和管理员 IP 白名单功能。
• 提高了菜单加载速度和响应性能。

修复:

• 修复了在1.21.8版本中，传送不支持回到指定坐标点的问题。
• 修复了在测试版本中，玩家登录注册时密码错误的问题。

新增功能

• 新增链接功能：配置中添加 link: "[link]https://xxxxxxx" ，可直接发送可点击链接并跳转至网页。

代码：

    # 文字组件1
    layout5:
      permission: cursormenu.button.test.layout4
      name: 加入官方Q群
      # 文字组件的x轴
      x: 2
      # 文字组件的y轴
      y: -1.0
      # 文字组件的z轴
      z: 3.5
      tilt:
        x: 0.0 # 上下倾斜（俯仰）
        y: 0.0 # 左右倾斜（偏航）
        z: 0.0 # 前后倾斜（翻滚）             
      command: []
      link: "[link]https://XXXXX|&c点击加入我们的官方Q群"

修复

• 修复了当玩家处于菜单中时，使用 /cmenu reload 命令重载配置，若开启了 camera-block-check ，退出菜单后清除的方块不会恢复的问题。

更新日志 – v1.3.5

新增内容
- 密码输入变量
- `%cursormenu_input_password%` 获取玩家首次输入的聊天内容
- `%cursormenu_password_visibility%` 返回输入内容当前是否可见
- `%cursormenu_input_confirm_password%` 获取玩家第二次输入的确认内容
- 同级子菜单 在同一坐标下直接展开子页面，无需退出再进
- 主菜单秒切 若世界与坐标一致，可直接刷新到另一主菜单，不再经历“关闭-再打开”流程
- 文本悬停特效 默认关闭，开启后鼠标悬停文本时显示高亮/阴影效果
- SQL 数据存储支持
- 实验性 WorldGuard 兼容 初步支持区域检测，后续持续完善

修复与优化
- 修复若干微小 bug
- 代码结构优化，提升整体性能

新增 / 重大变更

核心依赖迁移完成：正式弃用 ProtocolLib，全面改用 PacketEvents，安装前请移除旧依赖。

支持 Velocity 跨服传送：命令列表中直接写 [server] 目标服务器 即可无缝跳转。

可自定义光标大小：按需调整指针尺寸，适配不同 UI 风格。

可自定义光标移动范围：限定光标活动区域，防止误触。
修复与优化

修复若干边缘小问题，清理无用代码，体积更小，运行更快。

更新日志 – v1.3.3

新增
- 按钮级「随机概率命令」功能
- 配置 `random-commands` 与 `random-chances` 后生效
- 系统按给定概率（如 `[10,50,40]`）随机选取一条命令执行
- 未配置时自动回退到原有 `commands` 逻辑

调整
- 所有菜单的语言文件已同步更新，支持新随机命令提示字段

优化
- 内部逻辑清理，确保随机分支与旧模式零冲突

更新日志 – v1.3.2
修复

• 延迟命令在玩家退出菜单后仍被执行的问题已修正
• config 内菜单命令失效已恢复，现可正常解析

新增

• 菜单支持“条件使用”——仅当满足设定条件时才允许打开/点击

其他

• 插件已恢复常规更新节奏，后续版本将保持持续迭代

更新日志 – v1.3.1
修复

• 延迟命令计时不再出现偏差
• 新增菜单的坐标过远时，首次传送区块未提前加载导致的菜单错乱问题已解决

优化

• 清理冗余代码，提升性能与可维护性

更新日志 – v1.3.0
重要提示
请删除并备份旧配置文件，随后让插件重新生成全新的配置！
修复

• 修复若干小 Bug

新增功能

• 菜单按钮支持单独设置延迟执行命令
• 玩家首次加入游戏时可执行自定义命令
• 重构配置结构：每个菜单独立文件，新增/编辑菜单更便捷
• 新增特定菜单全局延迟命令功能
• 玩家随时随地可用指令直接打开指定菜单

更新日志 – v1.2.9

修复
- 插件改名后无法加载 ProtocolLib
- 玩家进入菜单时因名称阻挡或范围检测异常被拦截
- 菜单开启 `stopmenu` 后，`spawn` 等传送指令失效
- 玩家在菜单状态中断线/被踢，重登后无法恢复正常游戏

新功能
- 范围检测开关可自定义：开启后自动清除周围方块，退出菜单时原样恢复

其他
- 精简冗余代码，提升整体性能