手势按键

手势按键

一个客户端Minecraft模组,支持多笔画鼠标手势控制按键绑定/客户端命令。

GestureKeys

将日常操作转化为鼠标手势。 一个客户端 Minecraft 模组,提供多笔画鼠标手势控制按键绑定与客户端命令。

  • 绘制一个动作:将手势绑定到原版或模组游戏动作,或运行本地客户端命令。
  • 使用多笔画:松开鼠标按键后继续绘制,每个手势支持多个样本。
  • 九种玻璃风格可选:液态玻璃、云母、水晶等,界面颜色与轨迹颜色相互独立。
  • 调整时即时预览:风格、强度与颜色更改立即可见;保存后应用,取消则丢弃。

首次使用? 打开设置,先创建并保存一个手势,然后再在游戏中绘制它。

快速开始

创建你的第一个手势

  1. 进入世界,按住 左 Alt,点击左下角的齿轮打开设置。之后可以松开 Alt。
  2. 选择 New gesture(新建手势)并输入名称,例如 “Open inventory”。
  3. 选择对应的 Game action(游戏动作),录制一个样本,然后选择 Finish recording(完成录制)。
  4. 使用 Test recognition(测试识别)检查结果,保存手势并返回游戏。
  5. 再次按住 左 Alt,用鼠标左键绘制手势,然后松开 Alt 执行。

你也可以从模组列表的配置项或使用 /gesturekeys config 打开设置。

绘制控制

输入 效果
按住左 Alt 打开手势覆盖层并显示鼠标光标
按住并拖动鼠标左键 绘制当前笔画
松开左键后再次绘制 添加另一笔画,同时保留已有轨迹
鼠标右键 清除所有笔画并重新开始
松开 Alt 识别手势并执行其绑定的动作
Esc 取消当前绘制

绘制时,底部面板显示候选手势、置信度、动作或拒绝原因。 只有松开 Alt 时才会执行动作。 被接受的手势执行时不会额外显示成功通知。被拒绝的手势会在快捷栏上方短暂显示 “Not recognized”(未识别)或 “Gesture conflict”(手势冲突)。松开 Alt 时未绘制任何内容,或在清除绘制后松开,不会产生任何通知。

在 Options → Controls → Key Binds → GestureKeys 中更改激活按键。 手势覆盖层仅在正常游戏过程中打开。

手势与动作

每个手势支持 1–8 个样本,总共最多 128 个手势。 创建与编辑使用草稿;取消不会更改已保存的手势。

手势列表和游戏动作选择器均支持鼠标滚轮翻页:向下滚动到下一页,向上滚动到上一页。两端均不循环。 页脚显示项目数量和 Page n / x;空列表显示 Page 1 / 1。 翻页浏览动作时会保留搜索查询;更改查询会返回第一页。

可用动作类型

动作类型 行为
游戏动作:单击一次 触发一次动作,并提供 1 tick 的按下状态
游戏动作:定时按住 保持动作按下 1–200 tick,默认为 1 tick
客户端命令 运行本地注册的客户端命令,带或不带前导 / 均可

按名称搜索游戏动作。支持原版动作以及通过 KeyMapping 注册的模组动作,包括没有物理按键绑定的动作。在游戏控制中更改物理绑定不需要重新配置手势。

通常,20 tick 约为 1 秒;客户端卡顿会影响实际持续时间。 再次触发同一动作会重新开始其计时器。当你进入其他界面、切换到游戏窗口之外或离开世界时,模拟的按下状态会被释放。

你可以使用 /gesturekeys 尝试客户端命令。未知命令、无效参数和执行失败会显示错误。命令不会自动转发到服务器。 命令本身可能会产生自己的反馈。

调节识别

使用 Recognition & appearance(识别与外观)中的滑块,或用方向键以 1 个百分点为步进调整。

设置 默认值 范围 效果
Minimum confidence(最低置信度) 78% 60–95% 越低越宽松;越高越严格
Minimum candidate gap(最小候选差距) 6% 2–15% 值越高越容易拒绝相似候选

从默认值开始,录制更多自然绘制的样本,并让不同手势在视觉上有所区分。当样本与另一个手势过于相似时,编辑器会发出警告。

识别会忽略哪些绘制差异?

识别会忽略位置、整体大小、绘制速度、笔画顺序、起点、绘制方向,以及同一路径如何分割为笔画。旋转、镜像和宽高比差异仍有助于区分形状。几何形状完全相同的形状无法仅凭形状区分。

轨迹平滑仅影响显示。识别和保存的样本使用原始坐标,不受外观设置影响。

外观

在设置中打开 Recognition & appearance 以更改玻璃风格、模糊与折射强度、显现动画和颜色。

九种玻璃风格

点击强度滑块下方的 Glass style(玻璃风格)循环切换风格,包括 Off(关闭)。

液态玻璃 磨砂玻璃 玻璃拟态
亚克力 云母 烟熏玻璃
渐变玻璃 极光玻璃 水晶玻璃

每种风格都有各自的模糊、不透明度、折射、颗粒、高光和颜色效果。 以 1 个百分点为步进,在 50–150% 范围内调整 Glass blur & refraction(玻璃模糊与折射)。

独立的界面与轨迹颜色

两个颜色选择器均提供 12 个预设、HSV 调色板和 HEX 输入。

颜色设置 应用于
Interface color(界面颜色) 玻璃表面、控件高光和强调色;文本与状态保持可读
Trail color(轨迹颜色) 游戏内绘制、样本录制、识别测试和手势缩略图

风格、强度和颜色更改会立即预览,无需先保存。

界面 Done 或 Save Cancel 或 Esc
颜色选择器 将所选颜色返回外观草稿 丢弃此次颜色编辑
Recognition & appearance 将所有草稿设置保存到配置 丢弃所有未保存的更改

取消颜色选择器会恢复打开之前的颜色。 轨迹使用抗锯齿着色器、圆角端点与连接以及轻量平滑,同时保留尖角、端点和笔画之间的间隙。如果着色器加载或渲染失败,玻璃控件会回退为半透明圆角控件;轨迹也有几何回退。