Documentation Index
Fetch the complete documentation index at: https://mintlify.com/112cxyz/MoltenVR-Preview/llms.txt
Use this file to discover all available pages before exploring further.
MoltenVR’s Games screen automatically detects installed VR titles from your Steam, BSManager, and itch.io libraries. When you select a game, MoltenVR patches it with the correct OpenXR and OpenVR settings so it runs through MoltenVR’s own OpenXR runtime — no manual configuration required.
Starting a Game
Start the stream
Open MoltenVR and press Start Stream to begin the streaming session from your Mac.
Put your headset on
Put on your headset and open the ALVR app on the headset to connect to the stream.
Select your game
Back on your Mac, open the Games screen in MoltenVR and click the game you want to launch. MoltenVR applies the correct patch automatically and starts the game.
SteamVR-Native Games and OpenComposite
SteamVR-native games use the OpenVR API rather than OpenXR. MoltenVR uses OpenComposite to translate those OpenVR calls directly onto MoltenVR’s OpenXR runtime, so SteamVR itself never needs to run. This translation happens transparently when MoltenVR patches the game.
Half-Life: Alyx
Half-Life: Alyx is fully playable through MoltenVR. It runs with DXVK rendering and OpenComposite translating SteamVR calls onto MoltenVR’s OpenXR runtime, with full 6DoF tracking, controllers, and haptics all working.
Because OpenComposite has no SteamVR dashboard, there is no in-game controller rebinding UI. To change your controller bindings, edit the file directly:
game/hlvr/cfg/bindings_touch.json
Open that file in a text editor and modify the bindings as needed before launching.
Beat Saber and BSManager
If you want to run modded Beat Saber with BSIPA mods, use BSManager to manage multiple Beat Saber versions side by side. MoltenVR detects BSManager libraries automatically, so your modded installs appear in the Games screen alongside your standard Steam library.
Minecraft + Vivecraft
Minecraft with the Vivecraft mod runs fully native on macOS — no Wine required. Install Minecraft through Prism Launcher with the Vivecraft mod, and it will appear in the Games screen. This is the first working Mac Minecraft VR since SteamVR for Mac was discontinued in 2020.
Troubleshooting: Game Launches Flat (Not in VR)
If a game launches in a flat window instead of in VR, it likely needs one additional OpenXR extension to be advertised by the runtime. This is a small fix on MoltenVR’s side. Open a GitHub issue at github.com/112cxyz/MoltenVR-Preview/issues with the name of the game and it can be added in a future release.