Skip to content

amrutmuj/QuickStartXR

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

QuickStartXR

QuickStartXR is a Unity Editor helper for converting Unity 2022.3+ projects into OpenXR projects for Meta Quest.

QuickStartXR Overview

This screenshot shows what QuickStartXR sets up in your Unity project.

Package

This folder is a Unity Package Manager package:

Packages/com.quickstartxr.setup

To reuse it in another Unity project, copy this folder into that project's Packages folder, or use Package Manager > Add package from disk and select package.json.

Import Into A Fresh Project

  1. Create or open a Unity 2022.3+ project.
  2. Copy the full com.quickstartxr.setup folder into the fresh project's Packages folder.
  3. Wait for Unity to refresh and compile.
  4. Open Tools > QuickStartXR.
  5. Click Convert Current Project To Android OpenXR VR.
  6. If Unity switches build target or installs packages, wait for the reload to finish. The tool resumes automatically.
  7. Open Project Settings > Player and confirm Company Name is XRGeek.
  8. Open Project Settings > XR Plug-in Management > Android and confirm OpenXR is enabled.

Alternative import path:

  1. In Unity, open Window > Package Manager.
  2. Click + > Add package from disk.
  3. Select Packages/com.quickstartxr.setup/package.json.
  4. Open Tools > QuickStartXR and run the conversion.

Features

  • One-click Android OpenXR setup.
  • Installs XR Plug-in Management, OpenXR, Input System, and Meta XR All-in-One SDK.
  • Sets Android build target and Android player settings.
  • Sets Company Name to XRGeek.
  • Sets Active Input Handling to Both.
  • Imports Oculus Passthrough Camera API samples into Assets/PassthroughCameraApiSamples.
  • Provides validation and fixErrors workflow.

Usage

Open:

Tools > QuickStartXR

Run:

  1. Convert Current Project To Android OpenXR VR
  2. Import Passthrough Camera API Samples
  3. fixErrors if validation shows issues

Requirements

  • Unity 2022.3 LTS or newer.
  • Android Build Support module installed.
  • URP, Built-in Render Pipeline, or compatible SRP.
  • HDRP is not supported.
  • Git installed for PassthroughCameraApi import.

Notes

QuickStartXR pre-creates Assets/XR, Assets/XR/Loaders, and Assets/XR/Settings before touching Unity XR/OpenXR setup APIs. This avoids Unity creating duplicate collision folders such as Assets/XR 1 or Assets/XR/Settings 1 during package import or repeated conversion runs.

About

QuickStartXR is a Unity Editor helper for converting Unity 2022.3+ projects into OpenXR projects for Meta Quest.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages