# Quick Guide

## UNREAL ENGINE TUTORIAL  by Matt Aspland

{% embed url="<https://www.youtube.com/watch?t=488s&v=hW7FBGoiZ10>" %}
Matt Aspland tutorial video for HEAT with Unreal Engine
{% endembed %}

## OPENING THE HEAT PLUG-IN

* In your Unreal Engine project, Click **'Windows'** in the menu bar at the top of Unreal Engine and you should see HEAT Plug-in at the bottom of the list.

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2F2NT3CqRKoBDulzJBymtS%2Fimage.png?alt=media&#x26;token=1eede369-6bc1-4002-b252-a7446cc5510f" alt="" width="481"><figcaption><p>Opening the HEAT plug-in</p></figcaption></figure>

* Click the HEAT button (<img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2F2kyuyXCPPdvnvLtxJJCJ%2Fimage.png?alt=media&#x26;token=646c1568-ea18-404a-a353-eed19edbab3e" alt="" data-size="line">) and the plug-in open in a pop up window.

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FiEG1rG7Ny9aIvO7bk5x0%2Fimage.png?alt=media&#x26;token=d7da1820-7a14-409b-8e9a-6791a5e06782" alt="" width="563"><figcaption><p>HEAT plug-in within Unreal Engine</p></figcaption></figure>

* In the upper right corner of the plugin pop up you will see the **'Sign In'** button (<img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2Fg9mtEXjQKOC3J6o2fZEp%2Fimage.png?alt=media&#x26;token=3f46d569-c28a-4518-98d5-7158412f247b" alt="" data-size="line">).  Click this button and enter your login credentials.

{% hint style="danger" %}
**The cursor may not appear while trying to log In.  Just start typing and it will start to fill in. This is a UE5 issue.**
{% endhint %}

## USING THE HEAT PLUG-IN

* Once you have successfully signed into your HEAT account, the plug-in will automatically display the animations included in the **'My Library'** section of your profile.
* The library viewer in the HEAT UE5 plug-in works exactly like the web version of our platform.  For more information on navigating our movement library refer to [this section on exploring movements](https://docs.heat.tech/getting-started-with-heat/explore-movements).
* Locate the animation that you would like to pull into your Unreal Engine project.
* When you select the animation you will see the preview viewport window expand on the right hand side of the plug-in.

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FX7R3aGosYczcFolWIjK2%2Fimage.png?alt=media&#x26;token=5be2bdbe-f7c8-4c4f-a70f-48a481a7cd07" alt="" width="563"><figcaption><p>HEAT UE5 plugin with animation selected</p></figcaption></figure>

* Below the viewport you will see the **Character selection drop-down menu** labeled **'Import As:'**.  This is where you choose which character model you would like your animation to appear on when you drag into the Unreal Engine scene.
* To start let's select either T69H, our proprietary avatar, or the Unreal Mannequin.

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FHBwQ3JDipYT8fAW3mQ0s%2Fimage.png?alt=media&#x26;token=01972b0b-ee0d-443d-b51b-38368a445bd0" alt="" width="289"><figcaption><p>UE5 HEAT character selection drop-down menu</p></figcaption></figure>

{% hint style="info" %}
Additional steps are necessary to use MetaHuman or your own user model, but once configured can be dragged in the same way as described here.  Please refer to our [User Model guide](https://docs.heat.tech/unreal-engine-plug-in/advanced-tools-in-ue5/user-models) and our [MetaHuman guide](https://docs.heat.tech/unreal-engine-plug-in/advanced-tools-in-ue5/metahumans) for further instruction.
{% endhint %}

* Once you have selected your model you can simply drag and drop the movement into your Unreal project scene!  You can either drag and drop the **'Drag to Import'** button (<img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FoI04vVK8UdRGe838wYAF%2Fimage.png?alt=media&#x26;token=82938e0c-7768-4f29-baa8-eddd274e3e6e" alt="" data-size="line">) or you can simply drag and drop the animation card (gif) from your library!&#x20;

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FLaDcrZYrfUs2mJKnDAMG%2FUE5%20NEW%20DRAG%20AND%20DROP_v2.gif?alt=media&#x26;token=0f70db8a-aa93-4556-9797-38e7269ab1aa" alt="" width="563"><figcaption><p>Drag and drop straight from HEAT to Unreal Engine 5</p></figcaption></figure>

* The Drag and Drop function automatically retargets to you character of choice.  Your character is now in the scene and animated!

{% hint style="info" %}
If this is the first time you are pulling in a HEAT animation, it can take a few seconds to connect the call to our API.  Following the first call animations will load into your scene faster with subsequent animations.
{% endhint %}

* After being dragged into your scene all HEAT animations are converted to **Animation Sequences** within Unreal.
* You can access these animation sequences for use in the content browser at the path: **All -> Content -> HEAT\_Animations**&#x20;

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FBb26yPByKlXZ6GubD7Gx%2Fimage.png?alt=media&#x26;token=696a0f60-9f14-4e1c-8fbb-09b35ac9b3b3" alt=""><figcaption><p>Location of animation sequences within UE5 content browser</p></figcaption></figure>

Next we will go over using the Animation Sequencer within Unreal Engine to blend multiple HEAT animations together.


---

# 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://docs.heat.tech/unreal-engine-plug-in/quick-guide.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.
