Skip to content
A collection of productive prefabs for rapidly building spatial computing solutions in the Unity software.
C# ShaderLab
Branch: master
Clone or download
ExtendReality-Bot chore(release): set version to 1.1.5 [skip ci]
### [1.1.5](v1.1.4...v1.1.5) (2019-11-10)

#### Miscellaneous Chores

* **deps:** bump io.extendreality.zinnia.unity from 1.7.0 to 1.8.0 ([8cc9f18](8cc9f18))
  > Bumps [io.extendreality.zinnia.unity](https://github.com/ExtendRealityLtd/Zinnia.Unity) from 1.7.0 to 1.8.0. - [Release notes](https://github.com/ExtendRealityLtd/Zinnia.Unity/releases) - [Changelog](https://github.com/ExtendRealityLtd/Zinnia.Unity/blob/master/CHANGELOG.md) - [Commits](ExtendRealityLtd/Zinnia.Unity@v1.7.0...v1.8.0)
  >
  > Signed-off-by: dependabot-preview[bot] <support@dependabot.com>
Latest commit eb56fbe Nov 10, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.dependabot chore: add dependabot configuration Oct 20, 2019
.devops chore(deps): use latest pipeline templates Oct 20, 2019
CameraRig feat(structure): add prefab collection Oct 15, 2019
Helpers feat(structure): add prefab collection Oct 15, 2019
Interactions fix(Interactions): interactor to emit collision stopped on disable Oct 22, 2019
Locomotion fix(Locomotion): disable snap to floor during teleport action Oct 29, 2019
Pointers feat(structure): add prefab collection Oct 15, 2019
SharedResources feat(structure): add prefab collection Oct 15, 2019
.gitignore docs(support): add supporting .github files Oct 15, 2019
CHANGELOG.md chore(release): set version to 1.1.5 [skip ci] Nov 10, 2019
CHANGELOG.md.meta fix(CHANGELOG.md): add meta file for Unity to consume Oct 15, 2019
CameraRig.meta feat(structure): add prefab collection Oct 15, 2019
FodyWeavers.xml feat(structure): add prefab collection Oct 15, 2019
FodyWeavers.xml.meta feat(structure): add prefab collection Oct 15, 2019
Helpers.meta feat(structure): add prefab collection Oct 15, 2019
Interactions.meta feat(structure): add prefab collection Oct 15, 2019
LICENSE.md docs(support): add supporting .github files Oct 15, 2019
LICENSE.md.meta docs(support): add supporting .github files Oct 15, 2019
Locomotion.meta feat(structure): add prefab collection Oct 15, 2019
Pointers.meta feat(structure): add prefab collection Oct 15, 2019
README.md fix(README.md): provide more concise release data and update info Oct 28, 2019
README.md.meta docs(support): add supporting .github files Oct 15, 2019
SharedResources.meta feat(structure): add prefab collection Oct 15, 2019
VRTK.Prefabs.Runtime.asmdef feat(structure): add prefab collection Oct 15, 2019
VRTK.Prefabs.Runtime.asmdef.meta feat(structure): add prefab collection Oct 15, 2019
package.json chore(release): set version to 1.1.5 [skip ci] Nov 10, 2019
package.json.meta feat(structure): add prefab collection Oct 15, 2019

README.md

VRTK logo

VRTK Prefabs v4-beta

A collection of productive prefabs for rapidly building spatial computing solutions in the Unity software.

Release License Backlog Documentation

Slack Videos Twitter

Beta Disclaimer

The VRTK Prefabs have not yet been released fully are still in a beta phase meaning there may still be undiscovered bugs, missing features and a lack of usable documentation. All of these things are being worked on but progress is slow as there is only one person actively working on these VRTK Prefabs in their spare time so please be patient and respectful. You are free to use the VRTK Prefabs in any way you wish, but if you feel you will struggle figuring stuff out for yourself without detailed documentation then it may be better off if you wait until the full release of the VRTK Prefabs.

The prefabs contained in this repository will eventually be separated out into their own repositories and packages.

Introduction

The VRTK Prefabs aim 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

Setting up the project

  • Create a new project in the Unity software version 2018.3.10f1 (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 (or above) requires additional project setup before importing the VRTK Prefabs.

  • 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.

Adding the package to the Unity project manifest

  • Navigate to the Packages directory of your project.

  • Adjust the project manifest file manifest.json in a text editor.

    • Ensure https://registry.npmjs.org/ is part of scopedRegistries.
      • Ensure io.extendreality is part of scopes.
    • Add io.extendreality.vrtk.prefabs to dependencies, stating the latest version.

    A minimal example ends up looking like this. Please note that the version X.Y.Z stated here is to be replaced with the latest released version which is currently Release.

    {
      "scopedRegistries": [
        {
          "name": "npmjs",
          "url": "https://registry.npmjs.org/",
          "scopes": [
            "io.extendreality"
          ]
        }
      ],
      "dependencies": {
        "io.extendreality.vrtk.prefabs": "X.Y.Z",
        ...
      }
    }
  • Switch back to the Unity software and wait for it to finish importing the added package.

Updating to the latest version

The package will show up in the Unity Package Manager UI once the above steps have been carried out. From then on the package can be updated by selecting the package in the Unity Package Manager and clicking on the Update button or using the version selection UI.

Documentation

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

Contributing

Please refer to the Extend Reality Contributing guidelines and the Unity project coding conventions.

Code of Conduct

Please refer to the Extend Reality Code of Conduct.

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.