Meta XR Simulator

Download

Updated: Mar 14, 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 74 Release Notes

Documentation
Getting Started:
Unity
Unreal
Native

Feature Documentation:
Meta XR Simulator Introduction
Passthrough Simulation
Scene Recorder
Scene Json Formatting
Record and Replay (Session Capture)
Multiplayer Testing
Hand Tracking
Body Tracking
Data Forwarding
Test Rooms
Automated Testing
What's New
The minimum supported Unity version has been increased to 2022.3.15f1
Support XR_META_dynamic_object_keyboard
Support XR_EXT_PALM_POSE_EXTENSION
Support XR_KHR_locate_spaces
Controller-Driven Hand Tracking: try connecting physical controllers for a better hand tracking experience!
Quest3S device profile
Adding support for LocalFloor space
Passthrough resuming is supported
Enable gamepad control for MacOS
Added report issue button for easier feedback
Introduce Log Types: differentiate messages between OpenXR Compliance and MetaXR Simulator internals
What's Fixed / Improved
Improvements in logging
Improvements in input simulation
Fixed device profiles. Added correct render models
Corrected orientation of mesh returned from a synthetic environment
Meta XR Core SDK 74.2 - Fixed XrSim freezing on launch if used with OpenXR Plugin and Floor space is set. (See 74.2 release notes for Meta XR Core SDK
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. User 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
Vulkan specific issues
Unreal Engine specific issues
Restarting XrSim sometimes causes Occlusion failures.
Occlusions project crashes when Vulkan Preview is enabled, disable preview and use.
Anchors Spawn on different location compared to user spawn location