A productive VR Toolkit for rapidly building VR solutions in Unity3d.
VRTK has just launched a Kickstarter campaign to fund version 4 and beyond. Visit the Kickstarter campaign and pledge today! :)
| Supported SDK | Download Link |
|---|---|
| VR Simulator | Included |
| SteamVR Unity Asset | SteamVR Plugin |
| Oculus Utilities Unity Package | Oculus Utilities |
The documentation for the project can be found within this repository in DOCUMENTATION.md which includes the up to date documentation for this GitHub repository.
Alternatively, the stable versions of the documentation can be viewed online at http://docs.vrtk.io.
If you have an issue or question then check the FAQ document to see if your query has already been answered.
VRTK requires a supported VR SDK to be imported into your Unity3d Project.
- Clone this repository
git clone https://github.com/thestonefox/VRTK.git. - Open
VRTKwithin Unity3d. - Add the
VRTK_SDKManagerscript to a GameObject in the scene.
**Instructions for using the VR Simulator**
- Drag the
VRSimulatorCameraRigprefab from the VRTK/Prefabs into the scene. - Select the GameObject with the
VRTK_SDKManagerscript attached to it. - Select
Simulatorfor each of the SDK Choices. - Click the
Auto Populate Linked Objectsbutton to find the relevant Linked Objects. - Use the Left Alt to switch between mouse look and move a hand.
- Press Tab to switch between left/right hands.
- Hold Left Shift to change from translation to rotation for the hands.
- Hold Left Crtl to switch between X/Y and X/Z axis.
- All above keys can be remapped using the inspector on the
VRSimulatorCameraRigprefab. - Button mapping for the VR control are as follows:
- Grip: Left mouse button
- Trigger: Right mouse button
- Touchpad Press: Q
- Button One: E
- Button Two: R
**Instructions for using the SteamVR Unity3d asset**
- Import the SteamVR Plugin from the Unity Asset Store.
- Drag the
[CameraRig]prefab from the SteamVR plugin into the scene. - Check that
Virtual Reality Supportedis ticked in theEdit -> Project Settings -> Playermenu. - Ensure that
OpenVRis added in theVirtual Reality SDKslist in theEdit -> Project Settings -> Playermenu. - Select the GameObject with the
VRTK_SDKManagerscript attached to it. - Select
Steam VRfor each of the SDK Choices. - Click the
Auto Populate Linked Objectsbutton to find the relevant Linked Objects. - Optionally, browse the
Examplesscenes for example usage of the scripts.
**Instructions for using the Oculus Utilities Unity3d package**
- Download the Oculus Utilities from the Oculus developer website.
- Import the
OculusUtilities.unitypackageinto the project. - Drag the
OVRCameraRigprefab from the Oculus package into the scene. - Check that
Virtual Reality Supportedis ticked in theEdit -> Project Settings -> Playermenu. - Ensure that
Oculusis added in theVirtual Reality SDKslist in theEdit -> Project Settings -> Playermenu. - Select the GameObject with the
VRTK_SDKManagerscript attached to it. - Select
Oculus VRfor each of the SDK Choices. - Click the
Auto Populate Linked Objectsbutton to find the relevant Linked Objects.
VRTK is a collection of useful scripts and concepts to aid building VR solutions rapidly and easily in Unity3d 5+.
It covers a number of common solutions such as:
- Locomotion within virtual space.
- Interactions like touching, grabbing and using objects
- Interacting with Unity3d UI elements through pointers or touch.
- Body physics within virtual space.
- 2D and 3D controls like buttons, levers, doors, drawers, etc.
- And much more...
A collection of example scenes have been created to aid with understanding the different aspects of VRTK.
A list of the examples can be viewed in EXAMPLES.md which includes an up to date list of examples showcasing the features of VRTK.
The examples have all been built to work with the SteamVR Plugin by default, but they can be converted over to using the Oculus Utilities package by following the instructions for using the Oculus Utilities package above.
If the examples are not working on first load, click the
[VRTK]GameObject in the scene hierarchy to ensure the SDK Manager editor script successfully sets up the project and scene.
Many games and experiences have already been made with VRTK.
Check out the Made With VRTK Document to see the full list.
I would love to get contributions from you! Follow the instructions below on how to make pull requests.
For the full contribution guidelines see the Contribution Document.
- Fork the project, clone your fork, and configure the remotes.
- Create a new topic branch (from
master) to contain your feature, chore, or fix. - Commit your changes in logical units.
- Make sure all the example scenes are still working.
- Push your topic branch up to your fork.
- Open a Pull Request with a clear title and description.
Code released under the MIT License.