# Getting Started

## 1. What is Vour?

[Vour](http://u3d.as/2kQ2) is an asset for the [Unity game engine](https://unity.com/). It helps you with creating virtual tours with images/videos in 2D, 3D, 180°, 180° 3D, 360°, 360° 3D and in 3D environments.&#x20;

## 2. Project Setup

It is strongly recommended to use the [Universal Render Pipeline](https://docs.unity3d.com/Manual/urp/urp-introduction.html) (URP) for your project by using the `Universal 3D` project template. URP is better supported than the Built-in Render Pipeline and is **required** for WebXR.

To get started, simply import Vour. A setup window will appear, prompting you to install the necessary dependencies. If prompted about the new input system, select *Yes*.&#x20;

If you encounter prefab import errors for `OpenXR Player` and `WebXR Player`, you can safely ignore them. These assets will be imported correctly once VR support is installed.

{% hint style="info" %}
You can later access the setup window for installing additional feature via the top-left menu: **Vou**r → **Setup**.
{% endhint %}

<div align="left"><figure><img src="https://332249766-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAIp4sac1N7HN6wXNcfIb%2Fuploads%2FD03NyZlZWuKaxDN3YxKY%2Fsetup_install_dependencies.jpg?alt=media&#x26;token=0f7daf0c-7d68-4e6a-bda8-24947297efc2" alt=""><figcaption><p>1. Install dependencies</p></figcaption></figure> <figure><img src="https://332249766-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAIp4sac1N7HN6wXNcfIb%2Fuploads%2FLMVVJufZsznDb5biOiIA%2Fsetup_optional_features.jpg?alt=media&#x26;token=2f3646a8-0c69-4b59-8184-68a50db4daff" alt=""><figcaption><p>2. Install optional features</p></figcaption></figure> <figure><img src="https://332249766-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAIp4sac1N7HN6wXNcfIb%2Fuploads%2FLBpXlUCZqIuyMfOOUxAu%2Fsetup_enable_feature.jpg?alt=media&#x26;token=a8beb88f-3d19-4f07-b0be-b18d532e2287" alt=""><figcaption><p>3. Enable installed features</p></figcaption></figure></div>

## 2.1. Adding VR Support

To add VR support for various platforms, you can install and enable them in the setup window under "[Optional Features](https://crizgames.gitbook.io/vour/optional-features)".

Vour utilizes OpenXR, ensuring compatibility with all major VR headsets (e.g. Meta Quest, Valve Index). WebXR is also supported.

{% hint style="info" %}
Due to a limitation of Unity's OpenXR package, it is not possible to automatically load the right controllers for each headset. Controller models have to be added manually for now.  \
For more info: [add-custom-vr-controller-models](https://crizgames.gitbook.io/vour/add-custom-vr-controller-models "mention")
{% endhint %}

## 3. Create a Tour

First, we need to setup the scene. Use either the `Vour Basic` scene template via **File** → **New Scene** or:

1. Create a new scene.
2. Delete `Main Camera`.
3. Create a `Location Manager` via **GameObject** → **Vour** → **Location Manager**.
4. Create a `Player` via **GameObject** → **Vour** → **Player**.

Now we are ready to create a small tour.

1. Create a location of your choice via **GameObject** → **Vour** → **Location**.
2. Assign the image or video to it, and change the other settings as you need to.
3. With the location game object selected, click `Add Teleport Point` in the inspector and position the `Teleport Point`.
4. Create another location and set it up like in steps 1 & 2.
5. Now go back to the `Teleport Point` and drag the second location into `Target Location` field. Now you can teleport from the first location to the second. If you want to teleport back, create a `Teleport Point` at the second location and assign the first location as its `Target Location`.
6. Select the `Location Manager` and drag the first location into the `Start Location` field.

Done! You should now be able to explore the locations in play mode.

For more information on how a tour can be built, please take a look at the "DemoTour" scene located at `Assets/Vour/Sample`*.*

{% embed url="<https://www.youtube.com/watch?v=U1_KJgW9mME>" %}
