Meta XR Simulator

Download

Updated: Apr 29, 2025|

Version

Meta XR Simulator is a lightweight OpenXR runtime built for developers and enables you to simulate Meta VR devices and features on the API level. This contains the OpenXR runtime library, configuration files and supporting binaries like Synthetic Environment Server, DataForwarding APK, Data Recording APKs, etc...

Version 76 Release Notes

Getting Started Guides:

Unity
Unreal
Native

Feature Documentation:

Meta XR Simulator Introduction
Passthrough Simulation
Scene Recorder
Scene Json Formatting
Session Capture (Record and Replay)
Multiplayer Testing
Body Tracking
Hands Tracking (Experimental)
Data Forwarding

What's New

Support for XR_META_spatial_entity_marker
Support for XR_META_boundary_visibility
MacOS: Added a Crash Reporting and Uploading Dialog
Simulator binaries are not part of the Unity package, they are fetched dynamically. The install location is:
Windows: %%APPDATA%%\Local\MetaXR\MetaXrSimulator\76
macOS: ~/Library/MetaXR/MetaXRSimulator/76


What's Fixed / Improved

UI improvements
Updated the welcome window with an intuitive new user guide to help new users get started quickly.
Improved the tips window: it now only shows if users click the button to open it. Also, added a progress bar to display progress.
Several cosmetic changes were made to NUX windows.
Improvements in input simulation
Failures creating Swapchains will not crash the Simulator
Fixed controller velocity when headset is moving

Known Issues

General issues
For the “connecting physical Quest controllers” feature, we recommend launching the server application from the headset before connecting.
If SES is opened from a different project. Users will need to close that SES before opening a new SES from another project or it will give a warning.
Switching devices when using occlusion project will fail to occlude
Hands asset will show if one input is hand and other is controller
Wall are not showing with the Virtual Home sample from MRUK
Upgrading XR SIM in same project from a previous version will result in instruction panel unresponsive
If you encounter any issues around input, try adding the following line in %APPDATA%/MetaXR\MetaXrSimulator/persistent_data.json: “use_legacy_input”: true
macOS specific issues
XR Simulator is compatible with OpenXR plugin 1.13+. If you are unable to see this plugin version, please upgrade your Unity editor to the latest patched version.
Certain Unity OpenXR Plugin releases include an OpenXR Loader that depends on Vulkan SDK. If you are unable to use Meta XR Simulator with OpenXR Plugin on macOS, you can install the Vulkan SDK following the official instruction, and make sure the installer option [X] System Global Installation is selected.
local_sharing_server will fail to start on Mac if a Synthetic Environment is run. This has no impact on single instance functionality and only blocks multi-instance anchor sharing.
If your project does NOT use Meta XR Core SDK, then the “Deactivate” menu item will not work properly. There is no impact as long as you are not using another OpenXR runtime on macOS.
Json Server will overflow a buffer response when loading room