Downloading the VirtualGrasp plugin for Unity

The VirtualGrasp SDK for Unity is currently available in the two versions FREE and PRO:

Version PRO FREE
VG SDK & Interaction Engine
Android & Windows support
Object Baking  
Grasp Editing  
Custom Hand Models  
Replay Features  
Commercial License  

Supported Unity Engine Versions

In our experience Unity and the VirtualGrasp SDK are very robust in terms of up- or downgrading inside a major Unity version (e.g., 2020.x.x, 2021.x.x, etc) for your projects.

Note that VirtualGrasp SDK supports Windows and Android builds, but not MacOS.

The following is a list of Unity Engine versions that we have tested the VirtualGrasp SDK with:

  • Unity 2019.x and earlier is not and will not be supported due to the lack of ArticulationBody components.
  • Unity 2020.x is supported and has been tested successfully.
  • Unity 2021.x is supported and has been tested successfully.
    • Unity 2021.3 is the version that we are currently using to create the SDK.
  • Unity 2022.1 is supported and has been tested successfully.
    • For Unity 2022.1.0b, there is an Inspector GUI artifact in VG_MainScript/Sensors, but it is a known Unity issue.

Installing the VirtualGrasp plugin for Unity

If you start from scratch, just create a new, empty project in Unity.

New Unity Project
Create a New Project in Unity

To import VirtualGrasp into your Unity project, go to Assets → Import Package → Custom Package and import the VirtualGrasp *.unitypackage. After doing this, you should find the main VirtualGrasp installation under ThirdParty/VirtualGrasp in your Unity project.

Updating the VirtualGrasp plugin for Unity

If you are updating the VG SDK in your project, it we strongly recommend to remove the old version before importing the new one, to avoid clutter of old files. The whole VG SDK is placed into a single folder (by default ThirdParty/VirtualGrasp) to make the update process as convenient as possible for you. If you are customizing files inside the VG SDK, you should backup your old state or use a versioning system such as git.

Getting Started with VirtualGrasp and the Console View

There is only one minimal main component you have to add by default to use and configure VirtualGrasp: MyVirtualGrasp.cs. Adding a component to your scene and playing your scene, you should see some messages produced by the plugin in the Console Window.

You can identify that VG has been successfully initialized when a message like these appear on the Console, also informing you of the SDK version:

Initialized VirtualGrasp SDK (version 1.1.0-full).

QuickStart Video

QuickStart with VirtualGrasp in Unity.
If this video shows "This video is unavailable," please try to refresh the page.