QuestBridge

QuestBridge 是一个 Minecraft 客户端 Fabric 模组，可将 Meta Quest 3 控制器直接桥接到头戴设备本地运行的 Minecraft Java 版。它托管一个本地 WebXR 网页，用于捕获控制器输入，并通过低延迟的 WebSocket 服务器将其发送到正在运行的游戏实例，从而无需 PC 即可实现完全独立的沉浸式主机游戏体验。

📖 正在寻找完整安装指南？

有关完整的分步设置、自定义 Amethyst 控制器布局（用于在游戏中操作 ESC/T）以及高级故障排除，请阅读我们的 GitHub 上的完整安装指南！

---

演示视频：

您的浏览器不支持 HTML5 视频播放。

---

特性

• 独立的 VR 支持
• 沉浸式环境
• 集成的控制器触觉反馈 ⭐
• 持久化设置

---

前置要求

开始之前，请确保满足以下所有要求：

• Meta Quest 3（已测试）| Quest 3S 和 2（支持）。
• 头戴设备已启用开发者模式。请参阅 官方 Meta 开发者指南 了解设置步骤。
• 头戴设备已启用**“无缝多任务处理”**。
• 已安装 Amethyst-Android 启动器。
• 已在你的 mods 文件夹中安装 Controlify 和 Fabric API。

---

如何使用

1. 启动 Minecraft：打开 Amethyst 并使用你配置的 Fabric 配置文件启动游戏。
2. 打开 Quest 浏览器：打开原生的 Meta Quest 浏览器并访问：

   http://localhost:7373

---

故障排除

问题	潜在原因	解决方法
输入无法识别	禁用无缝多任务处理	确保在 Quest 实验性设置中开启“无缝多任务处理”。
控制器断开连接	焦点转移	确认你没有将控制器直接指向 Minecraft 面板。
页面无法加载	服务器端口冲突或模组未运行	验证 Minecraft 已完全加载 Amethyst，并确保浏览器访问的是 http://localhost:7373。
穿透模式为黑屏	权限阻止或会话类型问题	确保在按下进入 VR 之前选择了穿透卡片，以便系统正确初始化 immersive-ar 会话。
缺少触觉反馈	强度设置为 0%	在 Web UI 上将触觉强度滑块调整到大于 0% 的值。

---

许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。