# HTC Vive with Wave SDK (Unreal SDK)

---

:::danger[Deprecated — use the OpenXR path instead]
HTC has deprecated the **WaveVR** Unreal SDK in favour of **ViveOpenXR**, so the dedicated **AR51SDK_WAVE** plugin is being retired from AR 51 releases. HTC Vive headsets are now supported through the standard **OpenXR** runtime, which the AR 51 SDK covers with its **AR51SDK_OPENXR** plugin.

**Set up HTC Vive with the [OpenXR path](./htc-vive-openxr.md) instead.** The steps below remain only for existing projects still on the Wave plugin.
:::

## Follow the "New Project" instructions from the Vive Wave website

Follow the instructions from the [wave website](https://hub.vive.com/storage/docs/en-us/UnrealPlugin/UnrealPluginGettingStart.html)  to set up your project

:::warning
Make Sure to disable **"Support Vulkan"** and enable **"Support OpenGL ES3.1"**. Also make sure to select **"No MSAA"** as the value for MSAA Sample Count. 

:::

## Ensure that your project is compatible with the Android guidelines

Follow the instructions from the [unreal android guidelines](https://docs.unrealengine.com/5.0/en-US/how-to-set-up-android-sdk-and-ndk-for-your-unreal-engine-development-environment/)  to get setup up your project

## Download and extract Wave Unreal Plugins into the Plugins folder

Download Meta's plugin from [wave unreal plugin](https://developer.vive.com/resources/vive-wave/download/latest/). Extract the plugin into the project "Plugins" folder and restart the unreal editor.

## Disable all other VR-related plugins

Especially disable: **OpenXR**, **OculusVR**, and **SteamVR** to prevent conflicts.

:::warning
Enabling multiple VR plugins might cause unexpected results.

:::

## Try to deploy a simple level to your headset

Try and build the project and deploy it to your headset.

## Download and extract AR 51 Unreal-SDK Plugin and AR 51 Wave Plugins into the Plugins folder

Your plugins folder should look like this ![HTC Vive with Wave SDK (Unreal SDK) — Unreal plugin folder wave](../img/unreal_plugin_folder_wave.png)

Restart the editor to enable the plugins.

## Create a new level

File -> New Level -> Basic

## Be sure to set the visibility of the plugins to True

In the Content Browser window. Select settings and enable "Show Plugin Content"

## Drag the AR 51 SDK Blueprint into the current level

From the "Content Browser" windows, select Plugins -> AR 51 SDK Content -> Blueprints and drag "AR51SDK_Blueprint" into the level. 

## Drag the AR 51 Wave-related Blueprints into the current level

From the "Content Browser" windows, select Plugins -> AR51SDK_WAVE Content -> Blueprints and drag: "VRPawn", "WaveBoundary Adapter_BP" and "WaveHands Adapter_BP" into the level. 

## Make sure your VrPawn object uses "stage tracking"

Either create a new VRPawn object (using [these instructions](https://hub.vive.com/storage/docs/en-us/UnrealPlugin/VRPawn.html)) or edit the provided VRPawn Blueprint.

Make sure that your tracking space is set to “Stage”.  ![HTC Vive with Wave SDK (Unreal SDK) — Unreal vrpawn tracking origin set to stage](../img/unreal_vrpawn_tracking_origin_set_to_stage.png)

:::warning
If you do not set the tracking mode to “Stage”, the skeleton will not appear on your body once you restart the VR application.

:::

## In AR 51 Blueprint, select "HtcVive" as the platform type

From the Details panel, Under “General”, you should see a field "Platform". Please select "HTC Vive"  ![HTC Vive with Wave SDK (Unreal SDK) — Unreal select plaform type wave](../img/unreal_select_plaform_type_wave.png)

## Make sure you added WaveInputManager to the scene to enable Hand support

In the details-pannel of WaveInputManager under Hand, make sure to enable "Natural Hand" ![HTC Vive with Wave SDK (Unreal SDK) — Unreal enable wave natural hand](../img/unreal_enable_wave_natural_hand.png):

## In a tethered deployment - enable "Start in VR"

Before deploying to a tethered application (PC VR app), be sure that you project is set to start in VR.

In “Unreal engine”, under "Project Settings" -> "Project Description" enable "Start in VR".

![HTC Vive with Wave SDK (Unreal SDK) — Unreal engine start in VR](../img/unreal_engine_start_in_VR.png)

:::warning
## Hit Play 

Make sure that AR 51's system is running on the same local network as your device.

:::

You should see the character move in realtime. ![HTC Vive with Wave SDK (Unreal SDK) — Unreal character waving](../img/unreal_character_waving.png).

## On your first run, perform device calibration

You should now perform [device calibration](../../06-calibration/02-device-calibration.md)  so that the character would position on your body.