rojo/.cursor/rules/roblox/en-us/art/characters/head-specifications.md

title	description
Head specifications	In-depth details on expected head schemas for Marketplace

This content is for creators who intend to create character heads designated for the Marketplace, or any character heads that support assets from the Marketplace.

Character models designed to be sold on the Marketplace require a specific set of components and configuration standards to ensure all avatar features work as expected. The following guidance applies to character model heads to ensure universal support for head accessories and facial animations.

Validation for heads use a specialized process that may require adjustment of your existing head asset. For more information, see [validation process](./head-validation.md). Auto-setup recommendation
[Avatar auto-setup](../../avatar-setup/auto-setup.md) is an automated tool that automatically generates components for your avatar character, **including the head cage and facial animation** required for Marketplace character models. You can save time by submitting character models without avatar components into the auto-setup tool and modifying the output.

You can test and refine your auto-setup output by using the Avatar setup tool previews. You can even download your output as a .gltf and adjust the FACS or cage data in your DCC tools.

You can alternatively manually modify your own cages and FACS animations within your DCC tools, which may require more time or additional iteration in your workflow, such as weight-painting adjustments, to ensure it meets Marketplace policies.

To submit issues or feedback regarding the avatar auto setup tool, submit a bug report.

Head cage

The head cage is used to verify animations during validation. see [validation process](./head-validation.md).

Similar to other avatar body parts, an outer cage is required for the head. High-quality cages ensure accessories and clothing items fit properly over the head. Head cages also serves to establish facial landmarks for the eyes and mouth of the face for animation validation.

Caging quality

For details on improving the quality of your head cage, see Face cage optimizations.

Facial landmarks

During validation, Roblox projects the cage eye/mouth regions to the base mesh to identify the eyes and mouth regions of your character head. Even for non-humanoid faces that don't include visual eyes or mouths, it's important to ensure that these landmarks still exist and can be projected over your base mesh. For more information on this process, see validation process.

Roblox expects the following 3 distinct landmarks in your cages:

• Left eye landmark
• Right eye landmark
• Mouth landmark

Example face cage UV

Highlighted vertices of cage are used to track eyes/mouth on base mesh

Landmarks from cage applied to base mesh, used as an indicator for basic animation support during validation

The mouth landmark vertices are on the **second loop** of vertices from the mouth opening. This precision may help prevent issues with [landmark validation](./head-validation.md#landmark-projection).

FACS animation

Roblox supports facial animation on character heads and can support more than 50 base poses. If you are creating an avatar character, it must, at minimum, include the following 17 FACS reference poses to support avatar chat:

• LeftEyeClosed
• RightEyeClosed
• EyesLookDown
• JawDrop
• Pucker
• LeftLipCornerPuller
• RightLipCornerPuller
• ChinRaiser
• ChinRaiserUpperLip
• LeftCheekRaiser
• RightCheekRaiser
• LeftInnerBrowRaiser
• RightInnerBrowRaiser
• LeftLipCornerDown
• RightLipCornerDown
• LeftLowerLipDepressor
• RightLowerLipDepressor

While the 17 poses are a minimum requirement, it's recommended to include as many facial poses as possible in your asset to improve expressiveness and facial animation fidelity for facial animation and avatar chat.

To pass validation, the character head must successfully perform the following 5 facial actions. If the head can't deform at the points of the cage landmarks for these facial actions, validation fails for the asset.

Action Unit Test	Non-Zero Control Values
Left eye blink	LeftEyeClosed = `1` EyesLookDown = `1`
Right eye blink	RightEyeClosed = `1` EyesLookDown = `1`
Mouth opens	JawDrop = `1`
Happy expression	Pucker = `1` LeftLipCornerPuller = `1` RightLipCornerPuller = `1`
Sad expression	ChinRaiser = `1` ChinRaiserUpperLip = `1` LeftCheekRaiser = `0.85` RightCheekRaiser = `0.85` LeftInnerBrowRaiser = `1` RightInnerBrowRaiser = `1` LeftLipCornerDown = `1` RightLipCornerDown = `1` LeftLowerLipDepressor = `1` RightLowerLipDepressor = `1`

Marketplace requirements

Along with the other technical requirements listed, your items must meet the following additional specifications before uploading them to the Marketplace to sell:

• Ensure that your items adhere to the Marketplace program guidelines.
• Whenever possible, ensure that your items adhere to the following modeling requirements:
  • Custom mesh specifications
  • Any applicable avatar specifications
• Object Class.MeshPart.Material|Material is set to Plastic.
• Object Class.MeshPart.Transparency|Transparency is set to 0.
• Object Class.MeshPart.VertexColor|VertexColor is the default 1, 1, 1.
• If your head includes separate eyelash and eyebrow assets, you must add them to your character model as Class.Accessory objects.
  • See accessory specifications for additional technical requirements.
• Your Class.Model instance doesn't contain extraneous objects, like Class.Script or additional Class.Part instances.