# Creating Avatars

## Tutorial Video

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

## Avatar Creation Guidelines / Rules

* .png file format
* each frame has the same dimensions
* characters face right
* first 5 rows are preset: idle, run, sit, stand, jump
* after 5 rows are custom animations
* you can override certain animations with custom animations by naming them respectively.
* frame sizes under 100x100 pixels are more efficient and higher quality.

## Override Avatar Animations

* attack
* fart
* dance
* bomb
* spawn
* death
* despawn
* ~~damaged~~
* hug
* sit\_loop
* fall
* land

## Sprite-sheet format

<figure><img src="/files/2VaX97ep3OCqirRYKUYE" alt=""><figcaption><p>NOTE: sleep is not required, this is just showing you can add custom animations beyond the initial 5.</p></figcaption></figure>

## Locate the Avatar Folder

Once you've found the folder, put your png file inside the avatars folder.

<figure><img src="/files/H6f52KIbWqhxKb9hvWJi" alt=""><figcaption><p>open folder</p></figcaption></figure>

<figure><img src="/files/oZ5eCVAxdFrUr4JxXgrB" alt=""><figcaption><p>place png spritesheet inside avatars folder</p></figcaption></figure>

## Apply Avatar Settings

Set the width and height of your avatar. (single frame dimensions from the sprite-sheet)

Click Apply once you set the dimensions. (clicking apply will reset the avatar and potentially lose animation and gear positioning data.

<figure><img src="/files/4XKbxFgWpzO7Yjw93xU6" alt=""><figcaption><p>Save, select avatar, set width, set height, click apply.</p></figcaption></figure>

## Avatar and Gear Settings

You can find more information and explanations for all of the settings in Avatar and Gear with the link below.

{% content-ref url="/pages/MNnDjqpU6tATi2vgYl8Q" %}
[Avatars And Gear](/stream-avatars/application-settings/avatars-and-gear.md)
{% endcontent-ref %}


---

# 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.streamavatars.com/stream-avatars/content-creating/creating-avatars.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.