---
description: >-
  This doc goes over creating cages for your custom Avatar for Roblox so that
  they can use Marketplace assets like Jackets and shirts.
---

# Cages

{% tabs %}
{% tab title="Tutorial" %}
If you want your avatar to be able to use assets from the marketplace such as jackets, pants, shoes, etc. you will need to set a &#x43;_&#x61;ge_ around your model so the assets know how to warp to your avatar.

The assets you need for this are included in the Avatar template. And all you need to do is modify the assets to align with the model you have created.

Use the cages _as they are_ otherwise the cages will not work correctly. It is possible to use the 'X Mirror' with 'Topology Mirror' option selected to mirror the edits to the Cage meshes as needed.

<figure><img src="https://1511627699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwBY0yo2lTxFMvwpoAeN8%2Fuploads%2Fv0lVSICiRQlYrW4eAIp2%2Fimage.png?alt=media&#x26;token=b6f2c9a2-162d-4553-b946-5ba3a5f8db15" alt=""><figcaption><p>X Mirror with Topology Mirror selected...</p></figcaption></figure>

{% hint style="danger" %}
_**Do not change the names of the assets.**_

_**Do not delete or edit the mesh to save time, such as using a Mirror modifier.**_&#x20;
{% endhint %}

## Modifying the Cage Assets

* Unhide the cage assets in the Outliner.
* Adjust the cages to fit over the top of your avatar in 'Edit' Mode.
  * Note that the positioning of the polygons is the _base_ of the clothes assets in Roblox.
* Use the 'Snap' tools to snap the vertices to your assets.
  * _'Snap to face'_ to position them onto your assets
  * 'Snap to Vertex' to position them to other vertices eg. arm vertices to torso vertices.

<figure><img src="https://1511627699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwBY0yo2lTxFMvwpoAeN8%2Fuploads%2FOxP5wBbeywgEizrJxPUH%2FMirrorXTopology.gif?alt=media&#x26;token=fb28b0c2-a5d8-47de-b3be-140bf0189270" alt=""><figcaption><p>Use the Topology mirror on Symmetrical assets...</p></figcaption></figure>

* Use the 'X Mirror' with 'Topology Mirror' option at the top right of the viewport in 'Edit Mode' to mirror the edits.
  * This only works for single assets with symmetry such as the Head, Upper Torso and Lower Torso.
  * Do not merge the left / right assets to utilise this tool as it may break the cage within Roblox.

<figure><img src="https://1511627699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwBY0yo2lTxFMvwpoAeN8%2Fuploads%2FV6l5ybnmfMARP8EV39mc%2FProportionalEditing.gif?alt=media&#x26;token=359d104e-7b95-4197-a2b2-f8d36126e206" alt=""><figcaption><p>Use Proportional Editing to move vertices easily...</p></figcaption></figure>

* 'Proportional Editing' tools found at the top of the viewport to quickly move vertices around along with those around them.
  * You can toggle Connected Only' to adjust multiple assets.
  * Use Mouse Scroll to enlarge / shrink the radius.
* Scaling vertices outwards using 'Alt + S'.
* Use the 'Shrink Wrap' Modifier to shrink the vertices onto the meshes below it.
* Use 'G', 'G' to move vertices along edge loops.
  * Use 'Face Project' or 'Face Nearest' to keep the vertices on the base assets.

Notice how the polygons are uniform across the entire cage. This is important as the clothes assets will spread evenly over the character. If your polygons are closer together in some areas and spread apart in others, the clothes assets may get stretched in ways that are not ideal.

Another note is that the arms and legs are more straight rather than contouring to the arms and legs themselves. This is so the clothes look correct in Roblox.

<figure><img src="https://1511627699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwBY0yo2lTxFMvwpoAeN8%2Fuploads%2FHIsPyv9BKoCjrWUieyZy%2Fimage.png?alt=media&#x26;token=59d688bd-5bc5-47ce-8e84-b7fe3c0eb7da" alt=""><figcaption></figcaption></figure>

## Testing in Roblox

With the Cages done we can test the avatar in Roblox once more, this time we'll need to add the asset to a space that has access to some Clothes assets such as the Roblox Avatar Test Space.&#x20;

To export your assets, use [exporting-the-avatar](exporting-the-avatar "mention").

To import your assets into the Roblox Avatar Test Space, use [importing-the-avatar](importing-the-avatar "mention").
{% endtab %}

{% tab title="Troubleshooting" %}

{% endtab %}
{% endtabs %}

In this doc&#x20;

