Skip to content
X-Plane 5 min read

How do I use OpenXR with X-Plane 12?

Ian Stephens
In short

Use OpenXR in X-Plane 12 on Windows: select the right headset runtime, add the launch option, enable VR, and solve common detection problems.

To use OpenXR with X-Plane 12, run version 12.07 or later on Windows, make your headset software the active OpenXR runtime, start X-Plane with the --open_xr launch option, then enable VR Hardware in the simulator. Restart X-Plane whenever you change the active runtime.

Which OpenXR runtime should I use?

Choose the runtime that directly manages your headset or its PC connection. OpenXR is the interface X-Plane uses; the runtime supplied by Meta, SteamVR or another headset vendor handles the actual display and controller connection.

Headset connectionRuntime to selectWhen to use it
Meta Quest through Link or Air LinkMeta OpenXR runtimeUse this direct route when the Meta PC software manages the connection. Our Quest 2 Link and Air Link setup sequence covers the required launch order.
SteamVR-managed headset or streaming routeSteamVR OpenXR runtimeChoose this when the headset is detected and controlled through SteamVR. Follow our SteamVR installation and runtime-selection steps if it is not yet configured.
Headset with its own Windows OpenXR softwareVendor OpenXR runtimeUse the manufacturer's runtime when it provides a direct OpenXR connection supported by the headset.

Only one OpenXR runtime is registered as active in Windows at a time. X-Plane does not contain a menu for selecting between them, so make the change in the headset or SteamVR software before launching the simulator.

How do I enable OpenXR in X-Plane 12?

The reliable setup order is runtime first, headset second and simulator last.

  1. Check the platform and version. Use the Windows edition of X-Plane 12.07 or later. Supported VR operation is not provided by the macOS or Linux editions; our X-Plane 12 VR platform and hardware checklist explains those restrictions.
  2. Activate the correct OpenXR runtime. Open the headset application and use its option to make that application the active OpenXR runtime. The wording varies between applications. You normally do not need to download a separate generic OpenXR package.
  3. Connect and ready the headset. Confirm that the PC software can see the headset. Quest users should enter Link or Air Link mode; SteamVR users should wait until SteamVR reports the headset as ready.
  4. Add the OpenXR launch option. For a standalone installation, edit the Windows shortcut so its Target ends with "X-Plane.exe" --open_xr, with the option outside the closing quotation mark. For a Steam installation, enter --open_xr in X-Plane 12's Launch Options under its Steam properties.
  5. Launch X-Plane through the configured route. A frequent mistake is editing one shortcut and then starting the simulator from a different shortcut that lacks the argument.
  6. Enable the headset in X-Plane. Open Settings, select VR Hardware and enable VR Hardware. If the control is unavailable or the simulator remains on the monitor, OpenXR initialisation has probably failed.
  7. Centre the cockpit view. Sit in your normal flying position, use X-Plane's VR view reset or centring command, and bind that command to an accessible controller button.

How can I confirm X-Plane is using OpenXR?

Check Log.txt in the main X-Plane 12 folder after a launch attempt and search for OpenXR. The log records OpenXR initialisation activity and can expose a missing runtime or unavailable headset. The VR Hardware checkbox alone does not identify which VR backend was attempted.

Do I need SteamVR for X-Plane 12 OpenXR?

No. SteamVR is required only when it is the active OpenXR runtime for your headset or connection method. Owning the Steam edition of X-Plane 12 does not by itself force you to use SteamVR.

For example, a Steam installation can launch X-Plane while the Meta runtime handles a Quest headset. If SteamVR is the selected OpenXR runtime, leave it running because it is then part of the display path. To return to X-Plane's previous VR backend, remove --open_xr from the shortcut or Steam launch options.

Why does X-Plane 12 not detect my OpenXR headset?

Most detection failures come from the wrong active runtime, a missing launch argument or starting X-Plane before the headset connection is ready.

  • X-Plane starts in flat-screen mode: verify that the argument is exactly --open_xr, including two hyphens and the underscore. On a Windows shortcut, it must sit outside the quoted executable path.
  • The wrong headset application opens: another program is registered as the active OpenXR runtime. Change the runtime, close X-Plane completely and launch it again.
  • VR Hardware remains unavailable: confirm that the headset software reports a working PC VR connection before starting X-Plane. Also verify that the simulator is version 12.07 or later.
  • The monitor renders but the headset stays black: wake the headset, re-enter its PC VR mode and temporarily disable third-party OpenXR API layers, capture tools and overlays.
  • X-Plane crashes only with OpenXR enabled: remove --open_xr to establish a non-OpenXR baseline. Then update the headset runtime and graphics driver, disable optional OpenXR layers, and retest with a default aircraft before restoring plugins.
  • A runtime change has no effect: restart X-Plane. If the old runtime still loads, restart the headset software and confirm that its active-runtime setting was retained.

Does OpenXR improve X-Plane 12 performance or clarity?

OpenXR does not guarantee higher frame rates or a sharper image. A direct vendor runtime can avoid an unnecessary translation layer, but the result still depends on headset render scale, X-Plane graphics settings, aircraft complexity, weather and the connection method.

Compare runtimes with the same aircraft, location and settings, changing one item at a time. If OpenXR works but the cockpit remains soft, use our VR render-scale, anti-aliasing and headset-fit checks rather than treating blur as a detection problem.

AI Assistant New

Still stuck? Ask Fly Away

Ask Fly Away is our AI flight-sim assistant. Ask your exact question and get a direct, step-by-step answer in seconds — free to try.

Ask Fly Away Free preview · unlimited for PRO members