Develop

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.

Overview

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

  1. Start a Synthetic Environment Server and keep it running in the background (see Getting Started with Meta XR Simulator for detailed instructions).
  2. 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.
  3. 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.

Known issues

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.