Meta XR Simulator

Download from Unity

Updated: Jun 5, 2025|

Version

77.0

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 77.0 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
New NUX experience and flow
Alpha channel can be displayed in Image Preview Window
What's Fixed / Improved
UI Improvements
Telemetry popups has been changed with more detailed information
Welcome window is more informative with description of how to navigate
Mixed Reality window shows frame format and FPS
Crash fixes
Do not crash on xrEnumerateSwapchains
Fix a crash when recording in Unreal
Fix a crash when rendering Tips
Fix a crash due to invalid subImage swapchains
Miscellaneous improvements
Fix for triangle orientation in cylinder layers
Performance of Json Server is improved
Data forwarding poses are more robust
Fix device type selection
Known Issues
General issues
There are FPS drops when using the Replay feature.
Occlusions do not work on BiRP Sample.
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
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
Unreal Engine specific issues
Restarting XrSim sometimes causes Occlusion failures.
Occlusions project crashes when Vulkan Preview is enabled, disables preview and use.
Anchors Spawn on different location compared to user spawn location
The Controller menu on Anchors jitters when moving