VRIF includes various project settings by default, and you do not need to configure any tags or layers if you choose to import these. However, you may not wish to import these settings if you are setting up VRIF with an existing project. Below are some tips on how to set up your project settings to make sure the framework works properly.
In order for physics to feel smooth in VR you need to adjust your Fixed Timestep in your Project Settings (Project Settings -> Time). The default of 0.02 (50fps) is too slow and can result in jittery behaviour or odd rotations. Instead, you want to aim to match your HMD's refresh rate - so for 72fps you'd want to use 0.013889 (1/72) and for 90fps you can use 0.01111. You can set this in your project settings manually, via code, or by checking the "Auto Set Fixed Timestep" box on the TimeController component, which will set it for you on Start.
It does this by setting : Time.fixedDeltaTime = (Time.timeScale / UnityEngine.XR.XRDevice.refreshRate);
Screenshot of sample Project Settings for 72fps :
While it is not required to have any specific Tags or Layers for VRIF to work, it is recommended to separate the Grabbable and Player objects into their own layers so you their collisions may be ignored. This helps certain interactions, such as trying to pull a drawer open that would then collide with the player's capsule.
If you are importing VRIF into an existing project, the following settings will help you achieve the desired results :
Having a "Player" and "Grabbable" layer will allow you to ignore collisions between grabbable objects and the player's capsule collider. The "Restricted" layer can be used with the PlayerTeleport component to filter out objects you do not want to be able to teleport onto.
To ignore physics collisions between the Grabbable and Player layer, you can modify the Physics Collision Matrix (Edit -> Project Settings -> Physics):
VRIF is considered a "Project Template" and may overwrite your project settings. This can potentially cause your URP project to break. To fix this, go to Project Settings -> Graphics : Scriptable Render Pipeline and choose your pipeline.
If your materials are pink, be sure to upgrade your materials by going to Edit -> Render Pipeline -> Universal Render Pipeline and choose Upgrade Project Materials to URP Materials.