QuestBridge

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:

Seu navegador não suporta a exibição de vídeos HTML5.

Features

• Standalone VR Support
• Immersive Environments
• Integrated Controller Haptics ⭐
• Persistent Settings

Requirements

Ensure all of the following requirements are met before starting:

• Meta Quest 3 (Tested) | Quest 3S & 2 (Supported).
• Developer Mode Enabled on the headset. Refer to the Official Meta Developer Guide for setup steps.
• “Seamless Multitasking” enabled on the headset
• Amethyst-Android launcher installed.
• Controlify and Fabric API installed in your mods folder.

How to use

1. Launch Minecraft: Open Amethyst and boot the game using your configured Fabric profile.
2. Launch Quest Browser: Open the native Meta Quest Browser and navigate to:

http://localhost:7373

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.