# Getting Started

Welcome to the introductory guide for the **UMA integration** module for **Game Creator 2**! Here, you'll discover how to install the module and dive into its included examples to get started.

## Prepare your Project

To install the **UMA integration** module, you'll need to either created a new project or opened an existing one beforehand.

## Checking Dependencies

The **UMA integration** module relies on both **Game Creator 2** and **UMA**. Make sure you have these two in place before installing the module, or else you'll encounter errors during script compilation. If you haven't installed them yet, here are the package links for your reference:

* [x] **Game Creator 2 - v2.15.49 or latest**
  * [Unity Asset Store](https://assetstore.unity.com/packages/slug/203069)
* [x] **Unity Multipurpose Avatar (UMA) - v2.12 or latest**
  * [Unity Asset Store](https://assetstore.unity.com/packages/slug/35611)
  * ​[GitHub Repository](https://github.com/umasteeringgroup/UMA/releases)

{% hint style="danger" %}
If you're using UMA version 2.13 or greater, ensure that **`UMA_INSTALLED`** is included in the Scripting Define Symbols under Project Settings > Player > Other Settings > Script Compilation. For UMA version 2.12, ensure it is **NOT** included.
{% endhint %}

## Installing the Module

Firstly, ensure that the Unity Editor console is free from any errors that might prevent the scripts from compiling.

If you haven't bought the **UMA integration** module yet, visit the Asset Store's product page and follow the steps to acquire it.

{% stepper %}
{% step %}
In Unity Editor, go to "**Window**" in the top toolbar.
{% endstep %}

{% step %}
Select "**Package Manager**" from the dropdown.
{% endstep %}

{% step %}
Use the search bar in Package Manager to find **UMA Integration**.
{% endstep %}

{% step %}
Click on the package, then download and import the latest stable version.
{% endstep %}

{% step %}
Let your project finish compilation after installation.
{% endstep %}
{% endstepper %}

<figure><img src="/files/6eygd63rRka6EFfeG8r9" alt="" width="563"><figcaption></figcaption></figure>

## Installing the Examples

{% stepper %}
{% step %}
Click on "**Game Creator**" in the top toolbar.
{% endstep %}

{% step %}
Choose "**Install**" to open the Installer window.
{% endstep %}

{% step %}
Find and expand the "**UMA**" section.
{% endstep %}

{% step %}
Select "**Examples 1**" within the UMA section.
{% endstep %}

{% step %}
Click the "**Install**" button to start the installation process.
{% endstep %}
{% endstepper %}

<figure><img src="/files/NXGmjm3F6xXe2nrq3Nle" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="success" %}
Clicking on the Examples **install** button should install all dependencies automatically.&#x20;
{% endhint %}

After installing the examples, click '**Select**' or go to the **Project Window**. Then, navigate to **Plugins/GameCreator/Installs/UMA.Examples1@#.#.#/** to access the UMA examples directory.

<figure><img src="/files/UdFPMVokeAtRr75KQ05C" alt="" width="563"><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://niam.gitbook.io/documentation/game-creator-2/uma-integration/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.