Skip to content
A productive toolkit for rapidly building spatial computing solutions in the Unity software.
Branch: master
Clone or download
thestonefox Merge pull request #1984 from ExtendRealityLtd/docs/2019-install
docs(README.md): add instructions for Unity 2019.1 installation
Latest commit 841eb0e Apr 17, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
Dependencies chore(Dependencies): update Zinnia submodule to latest head Apr 8, 2019
Prefabs fix(Interactions): ensure directional drive works in local space Apr 8, 2019
Samples feat(examples): use transform drive in shotgun Apr 8, 2019
.gitattributes fix(assets): enforce correct line-endings Feb 14, 2019
.gitignore fix(assets): enforce correct line-endings Feb 14, 2019
.gitmodules chore(Dependencies): move Zinnia into dependencies folder Feb 8, 2019
Dependencies.meta chore(Dependencies): move Zinnia into dependencies folder Feb 8, 2019
LICENSE.md
LICENSE.md.meta chore(structure): create base structure for v4.0.0 May 17, 2018
Prefabs.meta feat(prefabs): add common spatial computing use case prefabs Feb 3, 2019
README.md docs(README.md): add instructions for Unity 2019.1 installation Apr 17, 2019
README.md.meta
Samples.meta refactor(structure): adhere to Unity's UPM structure suggestions Feb 13, 2019

README.md

VRTK logo

VRTK v4 beta - Virtual Reality Toolkit

A productive toolkit for rapidly building spatial computing solutions in the Unity software.

Slack Documentation Videos Twitter Waffle

Introduction

VRTK aims to make building spatial computing solutions in the Unity software fast and easy for beginners as well as experienced developers.

Requires the Unity software version 2018.3.10f1 (or above).

Getting Started

Documentation

Visit the VRTK.Academy for a collection of educational content to help you get the most out of building spatial computing solutions with VRTK.

Setting up the project

  • Create a new project in the Unity software version 2018.3 (or above) using 3D Template or open an existing project.
  • Ensure Virtual Reality Supported is checked:
    • In the Unity software select Main Menu -> Edit -> Project Settings to open the Project Settings window.
    • Select Player from the left hand menu in the Project Settings window.
    • In the Player settings panel expand XR Settings.
    • In XR Settings ensure the Virtual Reality Supported option is checked.
  • Ensure the project Scripting Runtime Version is set to .NET 4.x Equivalent:
    • In the Unity software select Main Menu -> Edit -> Project Settings to open the Project Settings inspector.
    • Select Player from the left hand menu in the Project Settings window.
    • In the Player settings panel expand Other Settings.
    • Ensure the Scripting Runtime Version is set to .NET 4.x Equivalent.

Note: Unity 2019.1 requires additional project setup before importing VRTK.

  • Download and install the XR Legacy Input Helpers from the Unity Package Manager.
    • In the Unity software select Main Menu -> Window -> Package Manager to open the Package Manager window.
    • Select XR Legacy Input Helpers from the Packages tab in the Package Manager window.
    • Click the Install button located in the bottom right of the Package Manager window.
    • The XR Legacy Input Helpers package will now download and install into the project.

Cloning the repo

  • Navigate to the project Assets/ directory.
  • Git clone with required submodules into the Assets/ directory:
    • git clone --recurse-submodules https://github.com/ExtendRealityLtd/VRTK.git
    • change to the newly cloned directory: cd VRTK/
    • git submodule init && git submodule update
  • The Unity software will now import and compile the new files.

Running the example scene

  • Open the VRTK/Samples/Farm/Scenes/ExampleScene scene.
  • Enable Maximize On Play in the Unity Game view control bar to ensure no performance issues are caused by the Unity Editor overhead.
  • Play the scene in the Unity Editor (CTRL + P).
  • The scene should automatically play within any Unity supported XR hardware.
  • Explore the farm yard and enjoy!

Made With VRTK

image image image image image image image image image image image image

Many games and experiences have already been made with VRTK.

Check out the Made With VRTK website to see the full list.

Contributing

We're not currently in a place where accepting contributions would be helpful. But as soon as we're ready we'll let you know!

License

Code released under the MIT License.

Disclaimer

These materials are not sponsored by or affiliated with Unity Technologies or its affiliates. "Unity" is a trademark or registered trademark of Unity Technologies or its affiliates in the U.S. and elsewhere.

You can’t perform that action at this time.