Meta XR Simulator Multiplayer
Updated: Apr 17, 2026
Outdated XR Simulator Version
This information applies to an older version of the XR Simulator, for new projects use the Standalone XR Simulator.Meta XR Simulator allows you to rapidly test your multiplayer mixed reality game
without gathering people for a test session.
Video 1.0: This video demonstrates testing a multiplayer, mixed reality
game without multiple people.
Test your multiplayer MR game
- Launch multiple simulator instances at the same time. The following
approaches are recommended:
Option 1: Configure multiple PIE (Play In Editor) clients. In Editor
Preferences > Level Editor > Play > Multiplayer Options, set
Run Under One Process to False and HMD For Primary Process Only
to False. Set Play Number of Clients to the desired number of
players, then launch VR Preview.
Option 2: Package your project for Windows via File > Package
Project, and set the system’s active OpenXR runtime to Meta XR Simulator:
- In Windows Registry Editor, navigate to
HKEY_LOCAL_MACHINE\SOFTWARE\Khronos\OpenXR\1 and create a field named
“ActiveRuntime” with type REG_SZ. - Find
meta_openxr_simulator.json under your project folder, and set the
registry value to /path/to/meta_openxr_simulator.json. - Then, you can run your game in the simulator from outside of the Unreal
Editor.
- Coordinate the input for all players.
- Option 1: Provide input to each simulator manually, one by one.
- Option 2: Use the Record and Replay functionality (see
Meta XR Simulator Session Capture
for more details) for simultaneous action playback.
Listen server crash
Unreal crashes when the net play mode is set to listen server. Use a different net play mode when testing multiplayer with Meta XR Simulator.