Skip to content

About

Unity tool for exporting scanned Mixed Reality Utility Kit (MRUK) scene data from Meta Quest devices.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

69 Commits

Folders and files

Repository files navigation

XRHouseDesignExport

Unity tool for Meta Quest that scans a home with the Mixed Reality Utility Kit (MRUK) and exports 3D models, floor plans and reports from the scan.

What it does

  • Scan once, export anywhere – "Save scan" stores the scene MRUK currently holds (including the global mesh) in the app's local cache. Any saved scan can be exported later, away from the building; the scan row in the menu picks the source (live scene or a saved scan).
  • 3D export (OBJ + GLB, valid glTF 2.0) in four flavours: clean anchor reconstruction (the Blender-ready one: real wall thickness, blue windows, brown doors, floor-length balcony doors), mesh-based, analytical mesh and raw scan. Multi-room, multi-floor and sloped ceilings are handled.
  • HTML report with a floor plan per story and per room, dimension chains (exterior walls from outside, openings from inside), axis-aligned plans, and tables.
  • In-headset viewers – a dollhouse of the whole scan and a floor-plan viewer with paging. Rooms can be named from a preset list (Quest does not share its room names with apps); the names are stored per room and used in plans, reports and folders.
  • Exports go to dated session folders, Export_<timestamp>_<scan name>; each room also gets its own subfolder with the same 4 model tiers and its own HTML report, scoped to just that room.

Using the app

The menu floats in front of you (follows your gaze). Point with the right controller and pull the trigger to click.

On/off buttons (Dollhouse, Floor plans, Scan overlay, Minimap) tint green while they're on, and the two Delete buttons are tinted red as a standing warning - both colours are always kept in sync with what's actually on screen, however it got that way (another button, a shortcut, or a scan-source change turning something back off).

Button Shortcut
Export B (right) Runs the full export of the selected source
Dollhouse A (right) Turns the in-headset dollhouse on/off, showing whatever tier was last picked
Mode right stick left/right Cycles the dollhouse between its 4 tiers: Anchor (clean, 25cm walls, no furniture), Anchor+Dim (same, with 3D dimension labels including sill/opening heights), Mesh, Raw
Floor plans stick click (left) Plan viewer (< > page, right stick left/right also pages while open, "Rename room" names the room)
Save scan X (left) Stores the live scene in the scan cache
Delete scan Deletes the currently selected saved scan (not the live source)
Delete exports Clears every exported session from device storage
Scan overlay Highlights the scanned room(s) over passthrough, like Quest's own Room Setup preview
Minimap Small always-facing copy of the house near your left wrist with a live position marker
Save log Y (left) Writes the on-screen log to a file
Scan source left stick left/right Cycles between the live scan and saved scans; clicking the scan name force-reloads it

Requirements

  • Unity 6000.3.9f1 (Unity 6), Android build target (IL2CPP, ARM64), URP.
  • Meta XR SDK / MRUK 205.0.0 (pinned in Packages/manifest.json). Target the newest SDK APIs.
  • A Quest 3 with a completed Space Setup (Scene permission granted to the app).

Editor tooling (menu MRUK)

Build, install to a USB-connected Quest, pull exports and scan cache, and export from a scan opened in the Editor. MRUKExporter.EditorFastBuildAndInstall() is the one-call build + adb install + launch used for iteration; build results are in the Unity Editor.log ("BUILD COMPLETED SUCCESSFULLY", "FAST BUILD AND INSTALL DONE" or "BUILD FAILED"). Do not edit project files or enter Play Mode while it builds.

Exports and scan cache pulled from the headset land in Exports/ (git-ignored).

Tests

Assets/Tests – EditMode tests for the floor-plan geometry and room names, PlayMode tests that run the whole export pipeline against MRUK's sample scenes. Run them from Window > General > Test Runner.

Notes

  • Don't install packages that spawn helper processes (e.g. com.unity.ai.assistant's relay_win.exe inherits the MCP bridge's listening socket on Windows, so the bridge can't rebind after a domain reload).
  • The app reads/writes only inside its own storage (persistentDataPath) because of Android scoped storage; use the Editor menu to pull files to the PC.

Versioning

Current version: see Assets/Resources/BuildInfo.txt (written on every build). Semantic Versioning.

License

Distributed under the MIT License. See LICENSE.

About

Unity tool for exporting scanned Mixed Reality Utility Kit (MRUK) scene data from Meta Quest devices.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages