---
description: Tips and best practices for using the new HEAT Auto-Rigger
---

# Auto-Rig

## PREPARING YOUR CHARACTER MESH

* The HEAT Auto-Rigger accepts .FBX .GLB and .GLTF file formats.  If your character is in a different format, perhaps .OBJ, we recommend pulling your character into a 3D program of your choice and exporting as one of our compatible file types.

{% hint style="warning" %}
If using an FBX file of your character make sure to embed your textures when exporting the file!
{% endhint %}

* We recommend having your character in a T-pose for auto-rigging.  While HEAT will automatically put an A-pose character into T-pose using inverse kinematics, your auto-rigged character will have a better weight painting, and in turn animation result, if it starts in T-pose

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FcNLwdF8iSX3hRZj7Rgjg%2Fimage.png?alt=media&#x26;token=e5736abb-2948-46db-b2a9-cca3da91eca4" alt="" width="516"><figcaption><p>T-pose Character</p></figcaption></figure>

*   Because the HEAT Auto-Rigger is fully automating the bone application and weight painting it is helpful to have separation between certain key elements of your mesh:

    * Fingers will have much better results if there is space between each finger.

    <figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FiGqBEUhn7X35OfQgeliE%2Fimage.png?alt=media&#x26;token=6094e2d7-002c-437d-bc02-914fbe0c61e8" alt="" width="367"><figcaption><p>Ideal distance between fingers of character</p></figcaption></figure>



    * Space between thighs will result in better animating between legs.

    <figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FcG8VpY7uxu620XPJkhkX%2Fimage.png?alt=media&#x26;token=08e484d0-63b1-494c-9355-5b01f626ce45" alt="" width="334"><figcaption><p>Good distance between thighs of character</p></figcaption></figure>
* We also recommend having your character mesh be symmetrical as you will have a much easier time working with it down the road once it is rigged.



## ROTATE AND POSITION

* The first step of the auto-rigging process is to make sure that the character is facing the correct orientation within 3D space.  If your character is not facing you, please use the rotation buttons to reorient the character properly.

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FwyO2SK1EPEGutfhwd4lN%2Fimage.png?alt=media&#x26;token=7c6f324a-4dd7-4463-b272-81a12d1f5fb5" alt="" width="375"><figcaption><p>IMPROPERLY oriented character</p></figcaption></figure>

* The buttons will rotate the character 90 degrees along the X, Y, or Z axis.  We have included visual representations of these rotations (<img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FpZDtrENE7m4MHa8ReY2L%2Fimage.png?alt=media&#x26;token=09a0d61b-75a0-4aa4-a0fc-c530c21e7a44" alt="" data-size="line"><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FFfflCkedLnGDpe8OZx0A%2Fimage.png?alt=media&#x26;token=70fc51b7-e8d5-4e90-a7ec-943c37822e35" alt="" data-size="line"><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FSEE6kerkyiXrO9ZcYUbt%2Fimage.png?alt=media&#x26;token=22182c81-70c7-4c1a-893a-510ea643a8a2" alt="" data-size="line">) to make it easier to orient the character.

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FdmJUxBEDMtjmCW4iV25N%2Fimage.png?alt=media&#x26;token=8689da8b-a6bc-461c-88fd-74d78bb14c61" alt="" width="375"><figcaption><p>PROPERLY oriented character</p></figcaption></figure>

* Your character also must be fully within the bounds of the 3D viewport in order for rigging to work properly.  If your character is not fully in the scene please resize your browser window until the entire character is visible.



## SETTING KEY POINTS

* In this phase you will adjust and set the key point locations for the auto-rigger to build a custom skeleton for your model.
* On initial loading of this page HEAT will automatically try to detect the pose of your character and place the key points.  If they are not in the correct place you can adjust them yourself to put them in the correct location by clicking and holding the points and moving them.
  * The help button (<img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FsLbbG7UJYOsCJGNOKZTJ%2Fimage.png?alt=media&#x26;token=967fab13-c23c-48af-8544-c2f88a6829ed" alt="" data-size="line">) on the key points page will show you a reference image of where the key points should fall on your character.
* If your character is NOT symmetrical you can also turn off key point symmetry by unchecking the symmetry box (<img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FwyZDFmCeUneQcJAjxPTV%2Fimage.png?alt=media&#x26;token=5acacef1-8389-4ea0-a698-c36fdfdde0fa" alt="" data-size="original">).&#x20;
* If you need to reset the points and start over you can hit the 'Reset' button (<img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2F31mHGj9a5XBWyfBDkiST%2Fimage.png?alt=media&#x26;token=687a2a13-05ee-49b4-a451-b4c83ce9ea2a" alt="" data-size="line">).
* If you want to force HEAT to try and automatically detect the point locations again you can hit the 'Auto-Place' button (<img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FnCDrRVHUWsiN6PPUB8fi%2Fimage.png?alt=media&#x26;token=c9d68967-476b-42e9-b944-9a1a88c06237" alt="" data-size="line">).
* Here you can also select how many fingers your character has with the finger amount drop-down menu (<img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FcBAupzcgyTUTeBs2SWnW%2Fimage.png?alt=media&#x26;token=d0771f26-5c2a-494b-8e33-423895e41ef3" alt="" data-size="line">).  At this point we only support 5 fingers and 0 fingers, but will be rolling out 1-4 very soon.

{% hint style="warning" %}
If your character mesh does not have good seperation between fingers and you are getting poor hand results you can change the finger amount to 0 to animate only the hand bone and skip the fingers altogether.
{% endhint %}

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FmqWW1L2DyRDUbPTnZ7TT%2Fimage.png?alt=media&#x26;token=d1cfc0c1-82d0-4f12-9ba6-22397298e462" alt="" width="563"><figcaption><p>Proper key point locations</p></figcaption></figure>



## ADJUSTING BONES

* In this phase the HEAT Auto-Rigger has set each bone in the character and you are given the opportunity to fine tune each bone coordinate to better match your mesh.

{% hint style="info" %}
you can navigate this 3D scene easily with your mouse using LEFT CLICK to ROTATE, RIGHT CLICK to ZOOM, and SHIFT + LEFT CLICK to PAN the scene.
{% endhint %}

* Click on any bone node and you will see an XYZ gizmo appear to adjust the location of that bone.

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2F20yFJT9zs0HH430bHeMD%2Fimage.png?alt=media&#x26;token=8de8cd8a-dc52-4965-8817-bbce1e82786b" alt=""><figcaption><p>Selected bone with XYZ gizmo</p></figcaption></figure>

{% hint style="warning" %}
Note that ThreeJS uses a Y up, Z forward orientation
{% endhint %}

* Bones are automatically symmetrized across the X axis of the character when moved.
* It can be much easier to get the bones in the proper location by viewing the scene in an orthographic view.  You can do this by selecting either X, Y, or Z on the viewport gizmo in the lower right hand corner of the screen.

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FEtHrijzmBH1hMdRwKos8%2Fimage.png?alt=media&#x26;token=fb25b11a-7c18-4ebb-913e-ad6025a4dc8b" alt=""><figcaption><p>Viewport gizmo in perspective mode</p></figcaption></figure>

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FLrrdm1qcr394X0ZEetXJ%2Fimage.png?alt=media&#x26;token=06dcfa3b-d384-4445-856f-279a5ed7d560" alt=""><figcaption><p>Viewport gizmo in orthographic view focused on X axis</p></figcaption></figure>

* In the upper right hand corner you can also see which bone you currently have selected.

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2F1x8ayeWReEgXG5dqn5u6%2Fimage.png?alt=media&#x26;token=58a710fb-68f7-427d-bd3a-74ed2f0e4569" alt=""><figcaption><p>Selected bone display</p></figcaption></figure>

* It is best practice to check the orthographic view on all three axis to make sure that the bone points are right where you want them to be within your mesh!

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2Fd0pzsIjgqgGQPBLmVQRQ%2Fimage.png?alt=media&#x26;token=82afe360-ff69-437e-8611-cbd4b50753c4" alt="" width="500"><figcaption><p>Bones properly aligned along the Z axis</p></figcaption></figure>

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FC1ZOA3LzY2wSV26wDvic%2Fimage.png?alt=media&#x26;token=b325871c-cf7d-4825-ade8-c23eede647ba" alt=""><figcaption><p>Bones properly aligned along the X axis</p></figcaption></figure>

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FJ23oVG6XhDtX7xgnUrxy%2Fimage.png?alt=media&#x26;token=b14a6f3c-4a09-48bd-8824-7a6cc94e75ca" alt="" width="461"><figcaption><p>Bones properly aligned along the Y axis</p></figcaption></figure>



## TEST ANIMATION

* In the next screen you will see our test animation.  Review your characters movements and if everything looks suitable for you hit the NEXT button to save your character to your profile.  If something looks off you can always hit the BACK button to return to adjusting your bone locations!

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FZ8qjKI2O489HGInbq6wH%2Fimage.png?alt=media&#x26;token=d8b11a15-ad28-4b5c-b2a7-df32c94352ba" alt=""><figcaption><p>Test animation viewport</p></figcaption></figure>



## CHARACTER SAVING

* Clicking the NEXT button will pop up the Character Saving modal.  The name of the character will default to the original uploaded file name, so feel free to give your character a name and description here.
* Once your character is saved you can either immediately download a GLTF file of this T-posed character by clicking the DOWNLOAD button.
* Now that your character has been saved to your profile you can view any HEAT animation on this character.  While viewing any animation simply click the 'Select Model' button (<img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FNlwnLYf2mTfwpuS6OiMz%2Fimage.png?alt=media&#x26;token=dd253bcb-1bdc-4a84-8d5e-90358927a238" alt="" data-size="line">) below the animation viewport and choose the model you would like to see animated.

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FwJXbfSuJljPuz1atcqxy%2Fimage.png?alt=media&#x26;token=95463247-7aa2-41b0-b75c-62a9ba5ddda7" alt=""><figcaption><p>Character selection window</p></figcaption></figure>

* Once you have an animation that you like on a character of your choice you can click the 'Download' button (<img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2Fn1Dl1UrkEiyeAtsh3Kh0%2Fimage.png?alt=media&#x26;token=17b5f27e-b010-43b7-9d1c-70a95629af8b" alt="" data-size="line">) to download a GLTF file of the animation on that character!



## CHARACTER MAINTENANCE

* You can navigate to your DASHBOARD by clicking on your profile picture in the upper right hand corner and choosing 'Dashboard'.  Here you will see all of your uploaded models in a grid.

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2F5zNsAOZvaU7n13w3HXne%2Fimage.png?alt=media&#x26;token=9fc2fbd3-423e-438a-9e30-8e8d47246183" alt="" width="563"><figcaption><p>Character models in dashboard view</p></figcaption></figure>

* Click the hamburger menu on any of your characters to re-download your character, edit (change name and description of character) your character, or delete your character.







Next we will go over using our text-to-model generator to create a model from your imagination that you can rig and animate!
