Guides
Avatar Auto Setup: turn a single mesh into a Roblox avatar
Use Roblox's Avatar Setup to turn a body mesh into an R15 avatar: input requirements, triangle budgets, step-by-step use and common failures.
3 min read

Quick answer
What does Roblox Avatar Auto Setup do?
It turns a body mesh into a Roblox-ready avatar. Give it a humanoid model in an A- or T-pose, under 10,742 triangles, and it splits the body into R15 parts, adds a rig if you didn't supply one, adds a face rig, cages and attachment points, and bakes your textures into one map.
What it saves you
Making a custom Roblox avatar used to mean splitting the body into 15 parts, building an R15 skeleton, skinning, modelling inner and outer cages, adding attachments and rigging the face. Avatar Setup automates most of that from a single body mesh. That's why it's the natural next step after you model or generate a character.
Input requirements
From Roblox's Avatar Setup requirements:
Shape and pose
- A general humanoid: two arms, two legs, a torso, a head, and a distinct neck
- Upright A-pose or T-pose. I-pose gives lower-quality results
- Front faces the negative Z axis, and limbs don't overlap from the front
- Centred on the Y axis helps accuracy
Triangle budget: 10,742 total
- Head: 4,000
- Torso: 1,750
- Each arm: 1,248
- Each leg: 1,248
Capping and segmentation add geometry, so models right at the limit can fail. Leave some headroom.
Mesh
- Single or multiple meshes. Multiple are recombined and decimated
- Watertight everywhere except eyes and mouth
- For a face: 2 eyes that share no vertices with the head, and 3 mouthparts (upper teeth, lower teeth, tongue), each separate
- No hair, eyebrows, eyelashes or accessories baked into the body
Textures
- One or more texture maps. Multiple are baked into one, and PBR sets into one each of albedo, normal, metalness and roughness

Running it
- Import your body model into Studio.
- In the Explorer, select the Model, holding Shift to add accessories and their base body if you're processing those.
- Right-click ⟩ Group as Folder.
- Select the Folder and open the Avatar Setup tool.
- After conversion, choose the asset type when prompted.
- Preview with animations and different clothing, then fix problems in your source model and run it again.
The Importer can also send a model straight to Avatar Setup with its Validate UGC Body option (3D Importer).
What it produces
- An R15 rig, if you didn't provide one
- A facial rig
- Body-part segmentation and limb caps
- Cages for layered clothing
- Attachment points for accessories
For accessories, it can also generate cages, attachments, rigging and caging data.
Common reasons it fails
- Over budget on one part, often the head. Reduce detail there.
- Merged neck. The head has to read as separate from the shoulders.
- Arms down at the sides (I-pose) or touching the body.
- Hair or a hat modelled on. Remove them and make separate accessories.
- Eyes or teeth merged into the head mesh.
- Facing the wrong way. Front must face −Z.
Using AI-generated bodies
AI 3D generators are good at a character's shape and texture. For a clean setup, generate the character plain: bald, no accessories, in a T-pose with arms away from the body. Then check the per-part triangle budget and reduce it in Blender if needed. Roblox makes creators responsible for AI-generated uploads (generative AI). See also the Roblox avatar AI generator guide.
Make the body mesh in Vi3W
Vi3W turns a prompt, concept art or a sketch into a textured, retopologised mesh, exported as GLB, FBX or OBJ. It doesn't rig, cage or add attachments. That's exactly what Avatar Setup does next. Check the per-part budget before you run it. Generate a body in Vi3W.
Last reviewed

