> For the complete documentation index, see [llms.txt](https://maxstvps.gitbook.io/documentation-eng/-MbEQLJaN0vXKGxXQmJX/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://maxstvps.gitbook.io/documentation-eng/-MbEQLJaN0vXKGxXQmJX/master.md).

# Setup Guide

## Requirements & Supports

**Requirements**

* MAXSTVPS SDK recommends [Unity 2020](https://unity3d.com/unity/whats-new/2020.3.0) or higher
* In order to use MAXSTVPS SDK for Unity, you need basic knowledge of Unity developer tools and developer resources. 
* To find out more about developer tools for Unity, click [here](https://unity.com/developer-tools) for more information.

## Install MAXST VPS Unity SDK

1. Download **MAXSTVPS SDK** 
2. Create or Open Unity Project
3. Newly created project, must download **MAXSTVPSSDK\_0.8.0.unitypackage** and install on Unity
4. Download **VPSData** and install VPSMap in accordance to location

{% hint style="info" %}
Download these files via **email.**
{% endhint %}

## Unity Setting

Description of File/Build Settings/Player Settings for Unity

{% hint style="danger" %}

* Android must only select **OpenGLES3** in Graphic APIs on Other Settings
* Android must uncheck **Multithreaded Rendering**
* Android must have **Custom Main Manifest** & **Custom Main Gradle Template** installed on Publishing Settings
  {% endhint %}

Refer to the following Github links for **Manifest** and **Gradle** 

| Github Link                                                                                                         |
| ------------------------------------------------------------------------------------------------------------------- |
| [AndroidManifest.xml](https://github.com/maxstdev/VPSSDKUnity/blob/main/Assets/Plugins/Android/AndroidManifest.xml) |
| [MainTemplate.gradle](https://github.com/maxstdev/VPSSDKUnity/blob/main/Assets/Plugins/Android/mainTemplate.gradle) |

{% hint style="warning" %}
iOS must include descriptions for **Camera Usage Description** and **Location Usage Description**
{% endhint %}

## Install Editor Coroutines Package 

MAXSTVPS SDK requires Editor Coroutines Package in Unity 

{% hint style="danger" %}
If the following message pops up, go to **Unity > Window > PackageManager >** Search **Editor Coroutines** and download the package
{% endhint %}

```
The type or namespace name 'EditorCoroutines' does not exist in the namespace ‘Unity'.  
```

## Install VPS Map

VPS Map includes mesh, reference images and simulation data of the location. As suggested below, **VPSData** folder needs to be created at same hierarchy as **Unity Project folder (MAXSTVPSUnity)**, and **VPSMap** folder needs to be saved under **VPSData.**

Once you unzip *VPSData\_yangjae\_indoor.zip* by MAXST, it automatically opens under **VPSData** folder as **VPSMap** and **VPSSimulationData**. **yangjae\_indoor** folder will be generated automatically under these two folders. 

![VPSMap Folder Structure](/files/-MbAm9hlRVpnBpvPNh7d)

{% hint style="warning" %}
You must follow **VPSMap Folder Structure** in order to successfully activate VPS Map
{% endhint %}