rojo/.cursor/rules/roblox/makeup/index.md
2026-02-02 12:08:47 -06:00

13 KiB

title description
Makeup Makeup is a cosmetic look made up of multiple facial textures and optional eyebrow and eyelashes.
This feature is currently in beta. Enable it through **File** ⟩ **Beta Features** ⟩ **Avatar Makeup**. The information provided is subject to change and is intended to prepare creators for the final release. For the latest news and updates, see the [DevForum announcement](https://devforum.roblox.com/t/studio-beta-introducing-avatar-makeup/3973764). **Makeup** is a cosmetic look available for Roblox characters that allows additional expression, allowing you to add elements like eyeshadow, lipstick, scars, glitter, and blush. This feature uses a combination of specialized facial textures and optional eyebrow and eyelash mesh assets.
A character model head, with a smokey eye effect, natural lipstick, and cheek and forehead adornments.
You can [download](#resources) this template and a test place file.

Components of makeup

Makeup is made up of multiple textures baked into a Class.Decal that you can apply to a face of a character. There are three primary regions of the face (eyes, lips, face/cheeks) that you can apply textures to. Each region has some overlapping surfaces with other regions.

Eye region
Lips region
Face/cheek region

You can optionally include eyebrows and eyelashes with makeup. These are Class.Model containing Class.MeshPart objects with skinning and caging data.

Eyebrow and eyelash mesh objects
Eyebrow and eyelash data model

You can quickly apply any makeup Decal objects and accessories by dragging them from the imported reference head into the appropriate character's Makeup or Accessories folder.

On import, the decals are automatically generated within the **imported model**.
In the demo place, move the generated decals into the character's **Makeup folder** to apply makeup.
Makeup assets intended for the Marketplace can include up to 6 total decals, comprised of any combination of regions.

Makeup template

The makeup template resource, available in the Makeup Beta downloadable resource is a 3D model asset that allows creators to quickly import premade makeup assets into their own 3D modeling tools where you can modify, create, and preview your own makeup assets.

Reference template render
Reference template data model

The makeup template includes the following:

  • Target head mesh object and target head cage mesh object.
  • Eye region mesh, fully linked to reference PBR textures
  • Lip region mesh, fully linked to reference PBR textures
  • Multiple face region mesh objects, fully linked to reference PBR textures
  • Eyebrows and eyelash mesh objects.

For a general workflow on authoring makeup using the template, see the makeup creation process.

Creation process

Makeup is currently in beta. Check out the DevForum announcement for the latest information on additional features, tools, and details regarding creating or implementing makeup.
Download the 3D reference template head and texture templates applicable to your workflow.
Modify the texture images in the tools of your choice.
In Blender/Maya, replace the textures in the template with your new textures and export.

While you can easily swap decal images in Studio to make a quick change to a character's makeup, the following instructions is a best practice for implementing PBR-based textures into Roblox makeup at scale. This process requires:

This process assumes a proficiency in 3D modeling software such as Blender or Maya and understand how to update, replace, export, save, and alter materials within your modeling tool and any additional texturing software or plugins.

As always with 3D art and creation workflows, there are many ways to achieve a specific goal and that is no different for makeup and your own PBR publishing flow.

  1. Download a reference template head and open it in the general modeling software of your choice.

    1. You can choose between a reference mesh and reference cage templates. The authoring flow is the same between these two, but reference mesh may be easier for artists to visualize the applicable region of the makeup texture.
  2. Using your texturing tools or an image editing software, modify the texture images associated with the different regions: TransferTexture_Eyes, TransferTexture_Face, or TransferTexture_Lips.

  3. When you've created your new texture images, use Blender or Maya to replace the existing file textures in the template.

  4. Export the entire template file as a .fbxor .gltf. See Export specifications for additional export instructions from Maya or Blender.

  5. Import the template file into Studio. Studio should automatically detect your mesh object names and associated textures and generate Decal objects.

  6. Apply any makeup decals or eyebrow and eyelash accessories to characters in the test place by dropping makeup assets in the appropriate character's Makeup or Accessories folder.

  7. Press Play, and navigate to the character with new makeup assets to preview.

Resources

The following are downloadable resources. See Template heads for required 3D models to import makeup assets with. See Template textures for additional image and project files available for your convenience and refernece.

Template heads

Blender template reference files
A comprehensive `.zip` folder of Blender assets, including multiple reference heads pre-configured for testing in the Makeup test place or for authoring your own makeup.

Includes both Cage and Reference Mesh Head templates.

<CardActions style={{bottom: 0, width: '100%'}}> <Button href="../assets/makeup/resources/Makeup-Reference-Blender.zip" fullWidth size='large' color='primary' variant='contained' style={{marginBottom:"4px;"}}>Download

<Grid item xs={12} md={6} lg={4} style={{ padding: 6, display: 'flex' }}> <Card style={{ flex: 1, display: 'flex', flexDirection: 'column' }}> <CardContent style={{ flexGrow: 1 }}>

Maya template reference files
A comprehensive `.zip` folder of Maya assets, including multiple reference heads pre-configured for testing in the Makeup test place or for authoring your own makeup.

Includes both Cage and Reference Mesh Head templates.

<CardActions style={{bottom: 0, width: '100%'}}> <Button href="../assets/makeup/resources/Makeup-Reference-Maya.zip" fullWidth size='large' color='primary' variant='contained' style={{marginBottom:"4px;"}}>Download

<Grid item xs={12} md={6} lg={4} style={{ padding: 6, display: 'flex' }}> <Card style={{ flex: 1, display: 'flex', flexDirection: 'column' }}> <CardContent style={{ flexGrow: 1 }}>

FBX / GLTF template reference files
A comprehensive `.zip` folder of `.fbx` and `.gltf` assets, including multiple reference heads pre-configured for testing in the Makeup test place or for authoring your own makeup.

Includes both Cage and Reference Mesh Head templates.

<CardActions style={{bottom: 0, width: '100%'}}> <Button href="../assets/makeup/resources/Makeup-Reference-Fbx-Gltf.zip" fullWidth size='large' color='primary' variant='contained' style={{marginBottom:"4px;"}}>Download

Template textures

Photoshop / GIMP texture images
A comprehensive `.zip` folder texture images for use in Photoshop or your preferred image editor.
When you are finished making changes to these texture images, swap out the textures in the template head using Blender/Maya and import the reference head with new textures into Studio.

<Grid item xs={12} md={6} lg={4} style={{ padding: 6, display: 'flex' }}> <Card style={{ flex: 1, display: 'flex', flexDirection: 'column' }}> <CardContent style={{ flexGrow: 1 }}>

Substance Painter files
A comprehensive .zip folder texture files for use in Substance Painter, an industry-standard PBR authoring software.
When you are finished making changes to these texture images, swap out the textures in the template head using Blender/Maya and import the reference head with new textures into Studio.
<CardActions style={{ width: '100%' }}> <Button href="../assets/makeup/resources/Makeup-Textures-SubstancePainter.zip" fullWidth size="large" color="primary" variant="contained" style={{ marginBottom: '4px' }} > Download