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:

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

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:

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.