VR Jester API

模组

· 作者 Caliburs

适用于 Vivecraft 和 QuestCraft 的虚拟现实手势识别 API

0 本站下载 0 关注 更新于 3 个月前

需要前置:Quest: Rebound、Vivecraft、Architectury API、Fabric API

最新 1.21.1-2.0.1-fabric · 1.21.1 · Fabric

一键开服(送7天)

Minecraft VR 虚拟手势识别 API

玩 Vivecraft 或 QuestCraft?喜欢模组?是否曾希望模组能更好地兼容 VR?无需再等待。这是为开发者和玩家提供的解决方案!

此 API 允许 Minecraft 模组开发者轻松实现其模组的 VR 兼容性。创建可映射到任意键位绑定并触发事件的任何自定义手势。你不再需要将控制器按键绑定映射到键盘按键。使用此 API,你的身体就是控制器。

演示:

安装方法:

  1. 安装所需的依赖模组。注意 Questbind 仅在使用 QuestCraft 时需要。
  2. 下载 VR Jester API 模组并将其放入 mods 文件夹中。
  3. 运行 Minecraft。必要的配置文件将在初始化时自动生成。

使用方法:

  1. 在 Minecraft VR 中,将控制器的一个按钮绑定到“手势监听器触发器”(Gesture Listener Trigger)。建议使用握持按钮(Grip Button)。对于 Vivecraft,你必须通过 Steam VR 的控制器绑定菜单进行设置;对于 QuestCraft,则通过 QuestBind 进行设置。

  2. 有两种创建手势的方式:

    • 使用 /gesture 命令
    • 直接修改存储手势的 config/gesture_store.json 文件。

    示例手势存储配置:

    "GESTURE 1": {
       "RIGHT_CONTROLLER|LEFT_CONTROLLER": [
         {
           "vrDevice": "RIGHT_CONTROLLER|LEFT_CONTROLLER",
           "movement": "forward",
           "elapsedTime": 0,
           "speed": 0.0,
           "direction": {
             "x": 0.0,
             "y": 0.0,
             "z": 0.0
           },
           "devicesInProximity": {}
         }
       ]
     },
     ...
    
  3. 创建好手势后,你可以在 config/VRJesterAPI.cfg 中的 "GESTURE_KEY_MAPPINGS" 字段下创建键值对象,将它们映射到键位绑定。你可以在 .minecraft/options.txt 中找到键位绑定的名称。(注意:该文件中单个键位绑定的实际 KeyMapping 字符串位于 key_ 和冒号之间。例如:key_key.inventory:18) "KEY_ACTION" 字段用于确定识别出的手势是触发单次 点击 按键按下还是 按住 按键按下。当你在手势被识别后保持手势位置不动时,会触发 按住 效果。

"GESTURE_KEY_MAPPINGS": {
   "GESTURE 1": {
      "KEY_MAPPING": "examplemod.key.ability_1",
      "KEY_ACTION": "click"
   },
   "GESTURE 2": {
      "KEY_MAPPING": "key.hotbar.2,key.sneak",
      "KEY_ACTION": "hold"
   },
   "GESTURE 3": {
      "KEY_MAPPING": "key.keyboard.j",
      "KEY_ACTION": "click"
   }
}

下载:

信息:

  • 将方括号 [ ] 内的每个对象视为手势的一个片段。你可以添加多个 GestureComponent 对象。此 API 支持识别复杂程度由你决定的手势!只需知道,手势越复杂,正确执行以匹配存储的手势就越困难。
  • "movement" 的不同取值为 forward(前)、back(后)、left(左)、right(右)、up(上)、down(下)。移动方向相对于你按下 Jester Trigger 启动手势监听器时的朝向。简单的例子是:朝你面对的方向出拳会被识别为“forward”。
  • "vrDevice" 的不同取值为 RIGHT_CONTROLLER、LEFT_CONTROLLER、HEAD_MOUNTED_DISPLAY。如果你希望手势在多个 VR 设备上都被识别,可以使用管道符 | 表示逻辑或,例如 RIGHT_CONTROLLER|LEFT_CONTROLLER|HEAD_MOUNTED_DISPLAY。
  • "elapsedTime" 的单位是毫秒。因此,设置值为 2000 意味着该手势片段持续 2 秒。这非常适合类似蓄力攻击的动作。
  • "speed" 字段是一个浮点数值,代表该 GestureComponent 的速度。识别出拳速度的合理阈值约为 1500.0-2000.0,你可以随意调整这些值。
  • "direction" 字段接受 x,y,z 浮点数值以创建一个三维归一化向量。例如,使用 {0.0, 1.0, 0.0} 可以识别玩家砖手(brick hand)朝上的情况。存在一定容差范围,因此不需要完全精确。
  • 最后是 "devicesInProximity",其格式如下:
    "devicesInProximity": {
        "LEFT_CONTROLLER": 20
    }
    
    这个示例的含义是:该 GestureComponent 的 vrDevice 必须在左侧控制器附近持续 20 刻(ticks)。
  • 订阅事件总线以处理由识别出的手势触发的事件(Forge),或者注册事件回调接口(Fabric)。

Forge:

@SubscribeEvent
public void onGestureEvent(GestureEvent event) {
    // 此处编写手势处理代码 -> event.getGestureName()
}

Fabric:

public static void init() {
    GestureEventCallback.EVENT.register((gestureEvent) -> {
        // 此处编写手势处理代码 -> gestureEvent.getGestureName()
    });
}

计划功能:

未来我将添加连续手势识别、更多配置选项以及性能优化。

2025年3月27日更新 - 我知道有一段时间没有更新了,但我完全打算回归这个模组。我一直在忙于其他项目。为此带来的不便表示歉意。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源