Skip to content

A collection of useful scripts and prefabs for building SteamVR titles in Unity 5

License

Notifications You must be signed in to change notification settings

JDadders/SteamVR_Unity_Toolkit

 
 

Repository files navigation

SteamVR Unity Toolkit - Slack Subreddit Waffle

A collection of useful scripts and prefabs for building SteamVR titles in Unity 5.

This Toolkit requires the SteamVR Plugin from the Unity Asset Store to be imported into your Unity project.

Games, Apps and Experiences that use this Toolkit

Quick Start

  • Clone this repository git clone https://github.com/thestonefox/SteamVR_Unity_Toolkit.git
  • Open the SteamVR_Unity_Toolkit within Unity3d
  • Import the SteamVR Plugin from the Unity Asset Store
  • Browse the Examples scenes for example usage of the scripts

FAQ/Troubleshooting

Summary

This toolkit provides many common VR functionality within Unity3d such as (but not limited to):

  • Controller button events with common aliases
  • Controller world pointers (e.g. laser pointers)
  • Player teleportation
  • Grabbing/holding objects using the controllers
  • Interacting with objects using the controllers
  • Transforming game objects into interactive UI elements

The toolkit is heavily inspired and based upon the SteamVR Plugin for Unity3d Github Repo.

The reason this toolkit exists is because I found the SteamVR plugin to contain confusing to use or broken code and I decided to build a collection of scripts/assets that I would find useful when building for VR within Unity3d.

What's In The Box

This toolkit project is split into three main sections:

  • Prefabs - SteamVR_Unity_Toolkit/Prefabs/
  • Scripts - SteamVR_Unity_Toolkit/Scripts/
  • Examples - SteamVR_Unity_Toolkit/Examples/

The SteamVR_Unity_Toolkit directory is where all of the relevant files are kept and this directory can be simply copied over to an existing project. The Examples directory contains useful scenes showing the SteamVR_Unity_Toolkit in action.

Documentation

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 https://steamvr-unity-toolkit.readme.io/.

Contributing

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.

Pull requests

  1. Fork the project, clone your fork, and configure the remotes.
  2. Create a new topic branch (from master) to contain your feature, chore, or fix.
  3. Commit your changes in logical units.
  4. Make sure all the example scenes are still working.
  5. Push your topic branch up to your fork.
  6. Open a Pull Request with a clear title and description.

License

Code released under the MIT License.

About

A collection of useful scripts and prefabs for building SteamVR titles in Unity 5

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 99.4%
  • GLSL 0.6%