QuestBridge
QuestBridge 是一款 Minecraft 客户端侧 Fabric 模组,可将 Meta Quest 3 控制器直接桥接至在头显上原生运行的 Minecraft Java Edition。它托管一个本地 WebXR 网页,用于捕获控制器输入并通过低延迟 WebSocket 服务器发送至正在运行的游戏实例,从而在不依赖 PC 的情况下实现完全独立的类主机沉浸式体验。
? 寻找完整安装指南?
如需完整的逐步设置说明、自定义 Amethyst 控制器布局(以支持 ESC/T 内置按键)以及高级故障排除,请阅读我们的 GitHub 上的完整安装指南!
演示视频:
功能
- 独立 VR 支持
- 沉浸式环境
- 集成控制器触觉反馈 ⭐
- 持久化设置
要求
开始前请确保满足以下所有要求:
使用方法
- 启动 Minecraft:打开 Amethyst 并使用配置好的 Fabric 配置文件启动游戏。
- 启动 Quest 浏览器:打开原生 Meta Quest 浏览器并导航至:
故障排除
| 问题 |
可能原因 |
解决方案 |
| 输入未注册 |
未启用无缝多任务处理 |
确保在 Quest 实验性设置中开启 Seamless Multitasking。 |
| 控制器断开连接 |
焦点转移 |
确认你没有将控制器直接指向 Minecraft 面板。 |
| 页面未加载 |
服务器端口冲突或模组未运行 |
验证 Minecraft 是否已完全加载 Amethyst,并确保浏览器指向 http://localhost:7373。 |
| 透视模式为黑色 |
权限阻止或会话类型问题 |
确保在按下 Enter VR 之前 选择了 Pass 卡,以便系统正确初始化 immersive-ar 会话。 |
| 缺少触觉反馈 |
强度设置为 0% |
在 Web UI 上将 Haptic Intensity 滑块调整到大于 0% 的值。 |
许可证
本项目采用 MIT 许可证授权 - 详情请参阅 LICENSE 文件。
QuestBridge
QuestBridge is a Minecraft client-side Fabric mod that bridges Meta Quest 3 controllers directly to Minecraft Java Edition running natively on the headset. It hosts a local WebXR webpage that captures controller inputs and sends them to the running game instance via a low-latency WebSocket server, enabling a console-like immersive experience entirely standalone without a PC.
? Looking for the Full Installation Guide?
For the complete step-by-step setup, custom Amethyst controller layouts (to play ESC/T in-game), and advanced troubleshooting, please read our Full Installation Guide on GitHub!
Demo video:
Features
- Standalone VR Support
- Immersive Environments
- Integrated Controller Haptics ⭐
- Persistent Settings
Requirements
Ensure all of the following requirements are met before starting:
How to use
- Launch Minecraft: Open Amethyst and boot the game using your configured Fabric profile.
- Launch Quest Browser: Open the native Meta Quest Browser and navigate to:
Troubleshooting
| Issue |
Potential Cause |
Resolution |
| Inputs not registering |
Seamless Multitasking is disabled |
Ensure Seamless Multitasking is turned ON in the Quest Experimental settings. |
| Controllers disconnected |
Focus shift |
Confirm that you are not pointing the controllers directly at the Minecraft panel. |
| Page not loading |
Server port conflict or mod not running |
Verify Minecraft has fully loaded Amethyst and ensure the browser is pointed to http://localhost:7373. |
| Passthrough mode is black |
Permission block or session type issue |
Ensure you selected the Pass card before pressing Enter VR so that the system correctly initializes an immersive-ar session. |
| Haptics missing |
Intensity set to 0% |
Adjust the Haptic Intensity slider to a value greater than 0% on the Web UI. |
License
This project is licensed under the MIT License - see the LICENSE file for details.
评论 0
登录后参与评分
还没有评论,来抢沙发吧