Develop

Meta XR Simulator JSON Format Rooms

Updated: Sep 3, 2026

Overview

Built-in rooms or rooms created using the Synthetic Environment Builder are ideal for development and testing, offering data for passthrough, scene, and depth. However, if you only require scene data, lightweight JSON-based rooms are the perfect solution for your needs.

Built-in JSON format rooms

Meta XR Simulator ships with two built-in rooms in JSON format. The JSON files for these rooms are located at: MetaXRSimulator/config/anchors/scene_anchors_room_with_furnitures.json and MetaXRSimulator/config/anchors/scene_anchors_empty_room.json. You can load them into Meta XR Simulator by following these steps:

Meta XR Simulator loads JSON rooms through its bundled JSON Synthetic Environment Server.

Exit any OpenXR application that is using Meta XR Simulator.

Open a terminal and run the JSON server with the room file and port 33792:

Windows

& "C:\path\to\MetaXRSimulator\json_synthenv_server\json_server.exe" "C:\path\to\room.json" --port 33792

macOS

"/Applications/MetaXRSimulator.app/Contents/Resources/MetaXRSimulator/json_synthenv_server/json_server" "/path/to/room.json" --port 33792

Leave the server running and start your application with Meta XR Simulator as its active OpenXR runtime.

To stop serving the JSON room, exit the application and press Ctrl+C in the terminal running the JSON server.

Export room setup from Quest device

Alternatively, you can set up a room using your Quest device and export it into a JSON file for use in Meta XR Simulator. For details, please refer to Scene Recorder.

Create your own JSON rooms

If you wish to construct a JSON room, it is necessary to understand the JSON schema. Please refer to Meta XR Simulator Room JSON Syntax for more details.