Import into Studio

If you are following the common practice of authoring makeup changes in a third-party tool, use the following import instructions to get your custom makeup textures into Roblox Studio:

1. Before importing into Studio, ensure that your .fbx or .gltf template file is correctly configured with the following:

   • Target head mesh
   • Target head cage mesh
   • If modified, Lips mesh and associated textures.
   • If modified, Face mesh and associated textures.
   • If modified, Eyes mesh and associated textures.

2. In Studio, open up the Makeup test place.

3. Click File > Import and select your 3D makeup asset. Verify there are no errors with the imported components.

4. Click Import to add the file into Studio. A new Model populates in the workspace.

5. In the Explorer window, expand the new Model. Verify that Decal child objects have populated, each with their own WrapTextureTransfer child object.

   

   

6. In the test place, copy your new Decal objects into a character model's Makeup folder.

7. If you want to apply eyebrows or eyelashes, move those MeshParts into the character's Accessories folder. For this place file, you do not need to convert eyelashes and eyebrows into Accessories first.

   

8. Press Play to playtest and verify that the character has the new makeup applied.

Test with Avatar Setup

You can also use the Avatar Setup tool to preview makeup assets without playtesting.

1. Open the Avatar Setup tool by navigating to Avatar > Setup.
2. Select the model you would like to preview your assets on.
3. For makeup decals, such as eyes, face, and lips:

   1. In the Explorer window, select any makeup decal assets you want to add into the Avatar Setup preview. The preview only supports valid makeup decals with a child WrapTextureTransfer.
   2. In the Avatar Setup panel, click the + symbol to add the assets to the Avatar Setup tool.
   3. In the new prompt, specify the makeup asset type (eyes, face, lips), for each decal selected.
4. For makeup meshes, such as eyebrows and eyelashes, in the Explorer window, move the MeshPart objects as children within the avatar model, then click the + button to add them to Avatar Setup.
5. In the Avatar Setup panel, navigate to the Face > Makeup tab and validate that your assets were properly imported into the tool.
6. Click on assets to equip them in your preview.

   1. Change the order of the assets by dragging their icons on the right side of the preview box.
   2. Click X to remove them from your avatar preview.
7. To see how makeup animates, navigate to the Animations tab, and test various sequences to see what your avatar looks like with the makeup applied.

For the best results, use the avatars provided from Roblox in the test place. You may also bring in any other avatar, but the quality of the makeup fit depends on the head's underlying cage, which may result in varied appearance if not properly aligned.