VR Project Migration

1. Create a new 2.18 VR project using the VR Template. Open it in the editor and create a package of vr_template\layers\vr_layer.node. You can close this project. (But don't delete it yet.)

   

2. In SDK Browser, click Upgrade for your project to upgrade assets in your project to 2.18.

   
3. Open your project in Editor and close the world, you'll need Asset Browser only.

4. You can try to import the package you exported from the empty 2.18 template project at Step 1. You'll see the assets highlighted red (they actually duplicate the ones that exist in your project) — delete duplicate *.cs assets from your project, then cancel importing the package.

   

   Namely, delete the following folders and files:

   • vr_template/components/

     • base
     • controllers
     • movements
     • ui
     • vr_input
     • VRPlayer.cs

   • vr_template/components/interactions/

     • interactions
     • VRInteractionManager.cs

   • vr_template/components/interactions/interactable/

     • VRNodeSwitchEnableByKey.cs

   • vr_template/components/transformations/

     • VRAttachToHead.cs

   • vr_template/layers/

     • vr_layer.node

5. In the vr_template/components/interactions/interactable/ folder delete VRKinematicMovableObject.cs, VRPhysicMovableObject.cs, VRTransformMovableObject.cs and copy the identical files from the template project created using 2.18 SDK version.

   Notice

   If you modified any of these files, make a backup to modify the updated files later.
6. Import the package you exported from the empty 2.18 template project at Step 1.
7. Update the code (written by you) that interacts with the template components that have been changed.

In order to launch your app from Editor in VR mode you need to add the -vr_app openvr start-up parameter. However, if you already launched Editor with -vr_app openvr, SteamVR will force close Editor if it detects new application start.

To fix this you need to do the following:

1. Before launching Editor, make sure that Stereo 3D is disabled in the SDK Browser Global Settings:

   

2. Make sure that you have no additional start-up arguments enabling VR in Open Editor custom run options:

   

3. Open Editor and load your world that you want to run in VR.

4. In application start-up settings modify the Arguments field: add -vr_app openvr.

   
5. Make sure to choose correct Configuration (Debug / Release).
6. Press the Play button.

If everything is done correctly, your application will start in VR mode and Editor will be still functional.

Running a VR project from the IDE requires adding command-line arguments. For example, in Visual Studio you can do this way:

1. Open the project Debug Properties:

   

2. In Command line arguments, add -vr_app openvr at the end of the line: