> For the complete documentation index, see [llms.txt](https://studio-docs.sandbox.game/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://studio-docs.sandbox.game/avatars/how-to-paint-avatar-clothing.md).

# How to paint avatar clothing

A skin is a set of 2D clothing textures: a top, a bottom, and shoes. Avatar Studio paints those textures onto a platform avatar, or onto an avatar you made.

The rigged character itself is on [How to create an avatar](https://studio-docs.sandbox.game/avatars/how-to-create-an-avatar.md). A 3D accessory, such as a hat, is on [How to create an avatar accessory](https://studio-docs.sandbox.game/avatars/how-to-create-an-avatar-accessory.md).

## Open Paint Skin

Open the hamburger menu at the top left and choose **Avatar Studio...**. Choose **Paint Skin**. The name field is **Skin Name**. Enter a name and select **Create**.

<figure><img src="https://2877193296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWgFjStdWWXj1Wc6xnrcJ%2Fuploads%2Fgit-blob-996d3f19c6b7bbc7d1b63628bf9ed7d487f6ea0e%2Favatar-studio-menu.png?alt=media" alt="Hamburger menu with Avatar Studio selected, and Paint Skin chosen"><figcaption><p><em>Avatar Studio is directly under Asset Packs. Paint Skin is selected.</em></p></figcaption></figure>

The file is `.avatar-skin.json`, under `assets/avatars/`. To reopen it, select it under **Open Recent**, or double-click it in the project.

### Step 1: Choose who wears the skin

On **Avatar**, leave the platform avatar, or pick an avatar you made with **Create Avatar**. A platform avatar is used when you do not pick one.

### Step 2: Choose a clothing template

Open **Template** and choose a combination of sleeves and pants. A garment you do not paint keeps that outfit. Only the garments you paint are exported.

<figure><img src="https://2877193296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWgFjStdWWXj1Wc6xnrcJ%2Fuploads%2Fgit-blob-b0a8fcc8770feb2ba206d13cba353eaa39b36778%2Favatar-studio-skin-template.png?alt=media" alt="Template step with long sleeves and short pants selected"><figcaption><p><em>Long sleeves and short pants is selected. The avatar is wearing that template.</em></p></figcaption></figure>

| Outfit                     | Parts |
| -------------------------- | ----- |
| Long Sleeves, Short Pants  | 8     |
| Long Sleeves, Long Pants   | 8     |
| Short Sleeves, Short Pants | 6     |
| Short Sleeves, Long Pants  | 6     |

### Step 3: Open the texture folder

Open **Paint**. The garments are **Top**, **Bottom**, and **Shoes**. Select **Open Folder for Live Editing**. Edits in that folder update the avatar while you work.

<figure><img src="https://2877193296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWgFjStdWWXj1Wc6xnrcJ%2Fuploads%2Fgit-blob-d0dd461aaf501cab38e8505dcb41b8a5d511878c%2Favatar-studio-skin-paint.png?alt=media" alt="Paint step with Top selected and the texture file listed"><figcaption><p><em>Top is selected. The texture file for that garment is listed beside the avatar.</em></p></figcaption></figure>

### Step 4: Paint the top

Open the top texture in an image editor. The front of the shirt is the upper half. The back is the lower half. Paint, then save over that file. Avatar Studio shows the change on the avatar.

<figure><img src="https://2877193296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWgFjStdWWXj1Wc6xnrcJ%2Fuploads%2Fgit-blob-73974a9c9c00a7378e666fdf98c2d1c02b785074%2Favatar-studio-shirt-template.png?alt=media" alt="Shirt texture in Photoshop, front above back"><figcaption><p><em>The shirt template. The front is on top, the back is below.</em></p></figcaption></figure>

<figure><img src="https://2877193296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWgFjStdWWXj1Wc6xnrcJ%2Fuploads%2Fgit-blob-9999f69dca717d798fc2da8d384758814dab0458%2Favatar-studio-shirt-painted.png?alt=media" alt="Shirt texture painted with a face on the front and spikes on the back"><figcaption><p><em>The face is on the front half. The spikes are on the back half.</em></p></figcaption></figure>

<figure><img src="https://2877193296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWgFjStdWWXj1Wc6xnrcJ%2Fuploads%2Fgit-blob-44741fb78eaa74a728cfce2f6461f9873d553971%2Favatar-studio-shirt-on-avatar.png?alt=media" alt="Avatar wearing the painted shirt"><figcaption><p><em>The saved shirt is on the avatar. The face is on the chest.</em></p></figcaption></figure>

**Reset to Original** clears all of the paint.

### Step 5: Paint the bottom

Open the pants texture. The front is the left half. The back is the right half. Save over the file.

<figure><img src="https://2877193296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWgFjStdWWXj1Wc6xnrcJ%2Fuploads%2Fgit-blob-b6d1d1b4c7f4ba878a64473806dcf4ca5d762f11%2Favatar-studio-pants-template.png?alt=media" alt="Pants texture with the front view on the left and the back view on the right"><figcaption><p><em>The pants template. The front, with the S, is on the left. The back is on the right.</em></p></figcaption></figure>

<figure><img src="https://2877193296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWgFjStdWWXj1Wc6xnrcJ%2Fuploads%2Fgit-blob-eae492218f00d2e742c6f882ea95d68ec65c0dc5%2Favatar-studio-pants-painted.png?alt=media" alt="Pants texture with purple paint on the left of the front view"><figcaption><p><em>Paint on the left of the front view, before it is saved back.</em></p></figcaption></figure>

<figure><img src="https://2877193296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWgFjStdWWXj1Wc6xnrcJ%2Fuploads%2Fgit-blob-c915c9077b2c07c459a7b2eb524a942164b7f711%2Favatar-studio-pants-on-avatar.png?alt=media" alt="Avatar with one pant leg painted purple and an S on the other leg"><figcaption><p><em>The saved pants on the avatar. The S stays on the front of the leg.</em></p></figcaption></figure>

### Step 6: Paint the shoes

Open the shoes texture. It holds both shoes and their soles. Paint the upper shoe shape for the right shoe and the lower shoe shape for the left shoe, then save over the file.

<figure><img src="https://2877193296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWgFjStdWWXj1Wc6xnrcJ%2Fuploads%2Fgit-blob-9737fa9727caa8b50a8969dd2197b0f7a608644f%2Favatar-studio-shoes-template.png?alt=media" alt="Shoes texture with two shoe shapes and separate soles"><figcaption><p><em>The shoes template. Two shoe shapes are stacked, with the soles beside them.</em></p></figcaption></figure>

<figure><img src="https://2877193296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWgFjStdWWXj1Wc6xnrcJ%2Fuploads%2Fgit-blob-4a5d6f86845382f0bcd426e213668f8dd62c3d2a%2Favatar-studio-shoes-painted.png?alt=media" alt="Shoes texture painted blue and purple"><figcaption><p><em>The same texture after painting. The soles are still their own islands.</em></p></figcaption></figure>

<figure><img src="https://2877193296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWgFjStdWWXj1Wc6xnrcJ%2Fuploads%2Fgit-blob-96d3a29adfbaef7f9e0af63d56d3ac0a7bb6d4ee%2Favatar-studio-shoes-on-avatar.png?alt=media" alt="Avatar wearing the painted shirt, pants, and shoes"><figcaption><p><em>Shoes is selected. The painted shirt, pants, and shoes are all on the avatar.</em></p></figcaption></figure>

### Step 7: Export the skin

Open **Export**. Name the skin, and select **Export Skin...**. You get a folder with the textures and materials of the garments you painted.

## What you've done

The clothing textures are exported. Reopen the skin from **Open Recent**, or from `assets/avatars/` in the project. To hang a hat or another mesh on a socket, follow [How to create an avatar accessory](https://studio-docs.sandbox.game/avatars/how-to-create-an-avatar-accessory.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://studio-docs.sandbox.game/avatars/how-to-paint-avatar-clothing.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
