update Open Source Docs from Roblox internal teams

rbx-open-source-docs[bot] · rbx-open-source-docs[bot] · commit 0f030629946b · 2025-10-14T23:39:06.000Z
diff --git a/content/en-us/assets/makeup/Blender_Screenshot.png b/content/en-us/assets/makeup/Blender_Screenshot.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:1e48fdc1e80ea0df35b050f3a54877c0a4b83865ce4870f348729478824fb62c
+size 432286
diff --git a/content/en-us/assets/makeup/Imported-DataModel.png b/content/en-us/assets/makeup/Imported-DataModel.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:fa094c124dc88a46fe4534b51761e6642d4866a11b145829b49356d259062a41
+size 108039
diff --git a/content/en-us/assets/makeup/Makeup-Blender-Datamodel.png b/content/en-us/assets/makeup/Makeup-Blender-Datamodel.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:5336f9e0ea1a987683823c1aee1a31c8d152aa2648f13c347dea3ecb3de57a9a
-size 23458
+oid sha256:caf6d2239dd4ef63b60321749fe7fce3e0fe38fc54731b1caa54a9fa84b958a9
+size 44762
diff --git a/content/en-us/assets/makeup/Makeup-Character-Folders.png b/content/en-us/assets/makeup/Makeup-Character-Folders.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:6a4a60dd5de50027c3366b56f9eca0670103977e36f0a0c5fa307042eff69b9f
-size 12176
+oid sha256:e82e84d5771d12b933b830b46c9ee9bd61706effb72e3f54bada6edd7aacc90c
+size 58825
diff --git a/content/en-us/assets/makeup/Makeup-Eye-Acc.png b/content/en-us/assets/makeup/Makeup-Eye-Acc.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:e93dab6fe2c3026e4a3af3329d4f27d4c0c1fe91b2c08eaffdd514d814069baf
-size 74203
+oid sha256:d0f6981e58d9730d76fa1a79d605cc5f1c62f27c938fbb7d8b1ea5f17ece91d6
+size 17347
diff --git a/content/en-us/assets/makeup/Makeup-Eye-Section.png b/content/en-us/assets/makeup/Makeup-Eye-Section.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:955dbc641b6a191b2dbf5f6c2265ae16e5ce3a94910eb643b476adcee6a69679
-size 512806
+oid sha256:991a9e54079ac1e91b65a9c880d4c0b91075ca7da385d4ada281b1c095d903d5
+size 675556
diff --git a/content/en-us/assets/makeup/Makeup-Face-Section.png b/content/en-us/assets/makeup/Makeup-Face-Section.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:e2a7b618cabc6a525ab497fd6e01a77b815bf2b5adc4186478f9b655ef5e9bab
-size 643395
+oid sha256:08636550ff4c8b2474f2848e8fbf8ad7f97fd939ff54a9135b7806e9fb20e8fe
+size 725690
diff --git a/content/en-us/assets/makeup/Makeup-Full-Render.png b/content/en-us/assets/makeup/Makeup-Full-Render.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:155aba8cfc08343739583c654b5ead9dd6d5bc4f91eaec68033d33fa4a5eb517
-size 746561
+oid sha256:111775694f0e0573af14bfa5d8267ebc4d5ed61a5933230131335e94caf99457
+size 677964
diff --git a/content/en-us/assets/makeup/Makeup-Mouth-Section.png b/content/en-us/assets/makeup/Makeup-Mouth-Section.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:5770072666a00b809f4f1d2c4ccf8510c1ca31504ebe59715b2000746b2122d4
-size 696566
+oid sha256:f5c29ba7f88bc55ae90d1d75eb33b127e3b523a6f5034b84717afb55d2102527
+size 582730
diff --git a/content/en-us/assets/makeup/resources/Blender-Thumbnail.png b/content/en-us/assets/makeup/resources/Blender-Thumbnail.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:8bfcd9c0150ebfe493eb79cd15d8dc0be3e871bc6ea747536282069963cb1681
-size 635500
+oid sha256:f01936a2a35cc795e89b52f255a2b5f442d83a257dde55e77fcccbf75bda6538
+size 774181
diff --git a/content/en-us/assets/makeup/resources/Maya-Thumbnail.png b/content/en-us/assets/makeup/resources/Maya-Thumbnail.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:d03c405212a3a14a995b85934bd0fc54ea3fe9a880f5688e1d8e57fcb8720ced
-size 398868
+oid sha256:b352392345db47a43a45b2c3964c6a3bed33261d135cc8780fb13db00235daaf
+size 311939
diff --git a/content/en-us/assets/makeup/resources/Substance-Thumbnail.png b/content/en-us/assets/makeup/resources/Substance-Thumbnail.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:e3c923d0f07ffb82ee221f5df388a21e6adfacdb705ded35af7cea8509ef676f
-size 428445
+oid sha256:7d3f062110723122f4d4d028309cc55354bcc2370c8360eec2dc9ce298d2ef8a
+size 828029
diff --git a/content/en-us/makeup/face-caging-best-practices.md b/content/en-us/makeup/face-caging-best-practices.md
@@ -94,9 +94,7 @@ When applicable enclose the open edge of the eye section right up to the eye mes
 
 It's a little easier to visualize the eyebrow shape using the vertex color provided in the template. Once you've established the head and tail of the eyebrow, you should place the three upper and lower verts equidistant from each other.
 
-<GridContainer numColumns="2">
-  <figure><img src="../assets/makeup/caging-examples/Primary-A.png" /></figure><figure><img src="../assets/makeup/caging-examples/Primary-B.png" /></figure>
-</GridContainer>
+<img src="../assets/makeup/caging-examples/Primary-B.png" />
 
 ### Establish the head and tail
 
@@ -145,12 +143,12 @@ Establish the top of the ear with the triangle portion of the ear, the bottom wi
 ## Hairline
 
 Establish from eyebrows the forehead shape and hairline.
- <figure><img src="../assets/makeup/caging-examples/Nose.png" /></figure>
+ <figure><img src="../assets/makeup/caging-examples/Hairline-A.png" /></figure>
 
 If working with sideburns, define the shape of the sideburns in front and around the ears and consider where the hairline should end at the base of the neck. This will help determine how layered hair accessories fits to the head.
 
 <GridContainer numColumns="2">
-  <figure><img src="../assets/makeup/caging-examples/Ears-A.png" /></figure><figure><img src="../assets/makeup/caging-examples/Ears-B.png" /></figure>
+  <figure><img src="../assets/makeup/caging-examples/Hairline-A.png" /></figure><figure><img src="../assets/makeup/caging-examples/Hairline-B.png" /></figure>
 </GridContainer>
 
 ## Caging examples of other facial types
diff --git a/content/en-us/makeup/import.md b/content/en-us/makeup/import.md
@@ -18,15 +18,22 @@ These instructions apply specifically to the Makeup test place, available in the
    1. Primarily, ensure that your model includes:
       - Target head mesh
       - Target head cage mesh
-      - `Lips` mesh and associated textures.
-      - `Face` mesh and associated textures.
-      - `Eyes` mesh and associated textures.
+      - 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 3D** 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, expand the new `Model`. Verify that `Decal` child objects have populated, each with their own `WrapTextureTransfer` child object.
 
-    <img src="../assets/makeup/Makeup-Studio-Datamodel.png" width="25%" />
+    <GridContainer numColumns="2">
+      <figure><img src="../assets/makeup/Imported-DataModel.png" width = "80%"/><figcaption>On import, makeup decals appear within the Model. </figcaption></figure>
+      <figure><img src="../assets/makeup/Makeup-Studio-Datamodel.png" width = "60%" /><figcaption>Each decal parents a WrapTextureTransfer object</figcaption></figure>
+   </GridContainer>
+
 6. In the test place, copy your new `Decal` objects into a character model's `Makeup` folder.
    1. 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.
+
+   <img src="../assets/makeup/Makeup-Character-Folders.png" />
+
 7. Press **Play** to playtest and verify that the character has the new makeup applied.
diff --git a/content/en-us/makeup/index.md b/content/en-us/makeup/index.md
@@ -13,17 +13,17 @@ Makeup is currently in beta and is not yet available for sale or implementation
 <center>
 <figure>
 <img src="../assets/makeup/Makeup-Full-Render.png" width="55%" />
-<figcaption><center>A character model head, with a smokey eye effect, natural lipstick, and cheek and forehead adornments. <br />You can [download](https://github.com/Roblox/avatar/tree/main/Makeup) this template and a test place file.</center></figcaption>
+<figcaption><center>A character model head, with a smokey eye effect, natural lipstick, and cheek and forehead adornments. <br />You can [download](#resources) this template and a test place file.</center></figcaption>
 </figure>
 </center>
 
 ## 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.
+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.
 
 <GridContainer numColumns="3">
-  <figure><img src="../assets/makeup/Makeup-Eye-Section.png" /><figcaption>Eye region</figcaption></figure>
-  <figure><img src="../assets/makeup/Makeup-Mouth-Section.png" /><figcaption>Lips region</figcaption></figure>
+  <figure><img src="../assets/makeup/Makeup-Eye-Section.png" /><figcaption>Eye region<sup>&dagger;</sup></figcaption></figure>
+  <figure><img src="../assets/makeup/Makeup-Mouth-Section.png" /><figcaption>Lips region<sup>&dagger;</sup></figcaption></figure>
   <figure><img src="../assets/makeup/Makeup-Face-Section.png" /><figcaption>Face/cheek region</figcaption></figure>
 </GridContainer>
 
@@ -34,13 +34,20 @@ You can optionally include eyebrows and eyelashes with makeup. These are `Class.
   <figure><img src="../assets/makeup/Makeup-Eye-Accessory-Datamodel.png" /><figcaption>Eyebrow and eyelash data model</figcaption></figure>
 </GridContainer>
 
-You can quickly apply any decals and optional models to characters in the test place by dropping those assets in the appropriate character's `Makeup` or `Accessories` folder.
+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.
 
-<img src="../assets/makeup/Makeup-Character-Folders.png" width="55%" />
+<GridContainer numColumns="2">
+  <figure><img src="../assets/makeup/Imported-DataModel.png" /><figcaption>On import, the decals are automatically generated within the **imported model**.</figcaption></figure>
+  <figure><img src="../assets/makeup/Makeup-Character-Folders.png" /><figcaption>In the demo place, move the generated decals into the character's **Makeup folder** to apply makeup.</figcaption></figure>
+</GridContainer>
+
+<Alert severity = 'warning'>
+Makeup assets intended for the Marketplace can include up to 6 total decals, comprised of any combination of regions.
+</Alert>
 
 ### Makeup template
 
-The makeup template resource, available in the [Makeup Beta downloadable resource](https://github.com/Roblox/avatar/tree/main/Makeup) 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.
+The makeup template resource, available in the [Makeup Beta downloadable resource](#resources) 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.
 
 <GridContainer numColumns="2">
   <figure><img src="../assets/makeup/Makeup-Full-Render.png" /><figcaption>Reference template render</figcaption></figure>
@@ -52,7 +59,7 @@ 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
-- Face 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).
@@ -64,14 +71,14 @@ Makeup is currently in beta. Check out the DevForum announcement for the latest
 </Alert>
 
 <GridContainer numColumns="3">
-  <figure><img src="../assets/makeup/Creation-Steps-1.png" /><figcaption>Download the 3D reference template head and texture templates applicable to your workflowe.</figcaption></figure>
+  <figure><img src="../assets/makeup/Creation-Steps-1.png" /><figcaption>Download the 3D reference template head and texture templates applicable to your workflow.</figcaption></figure>
   <figure><img src="../assets/makeup/Creation-Steps-2.png" /><figcaption>Modify the texture images in the tools of your choice.</figcaption></figure>
   <figure><img src="../assets/makeup/Creation-Steps-3.png" /><figcaption>In Blender/Maya, replace the textures in the template with your new textures and export. </figcaption></figure>
 </GridContainer>
 
 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:
 
-- The [Makeup test place and template files](https://github.com/Roblox/avatar/tree/main/Makeup)
+- The [Makeup test place and template files](#resources)
 - A 3D modeling tool such as [Blender](https://www.blender.org/) or [Maya](https://www.autodesk.com/products/maya/overview)
 - Any PBR texturing software, such as [Substance Painter](https://www.adobe.com/products/substance3d/apps/painter.html), [Materialize](http://boundingboxsoftware.com/materialize/index.php), or plugins like [Ucupaint](https://extensions.blender.org/add-ons/ucupaint/) (Blender).
 
@@ -81,15 +88,19 @@ This process assumes a proficiency in 3D modeling software such as Blender or Ma
 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.
 </Alert>
 
-1. Download a [reference template head](https://github.com/Roblox/avatar/tree/main/Makeup) and open it in the general modeling software of your choice.
+1. Download a [reference template head](#resources) 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. Depending on your change, modify the textures associated with the different regions: `TransferTexture_Eyes`, `TransferTexture_Face`, or `TransferTexture_Lips`
-   1. If you are authoring textures in a third-party texturing tool, you may need to export your mesh objects to import into your own tool.
-3. When you've created your new texture images, update the existing file textures in the template to point to your newly created textures.
-   1. Blender: Save any new textures files to your project using  **File** > **External Data** > **Pack Resources** before exporting or sharing your `.blend`.
+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 `.fbx`or `.gltf`. See [Export specifications](../art/modeling/export-requirements.md) for additional export instructions from Maya or Blender.
-5. In the test place, [import](./import.md) the template file into Studio. Studio should automatically detect your mesh object names and associated textures and generate `Decal` objects. For more details, see [import into Studio](./import.md).
+5. [Import](./import.md) the template file into Studio. Studio should automatically detect your mesh object names and associated textures and generate `Decal` objects.
+
+   <img src="../assets/makeup/Imported-DataModel.png" />
+  
 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.
+
+   <img src="../assets/makeup/Makeup-Character-Folders.png" />
+
 7. Press Play, and navigate to the character with new makeup assets to preview.
 
 ## Resources
@@ -107,7 +118,7 @@ The following are downloadable resources. See [Template heads](#template-heads)
 <center> <img src="../assets/makeup/resources/Blender-Thumbnail.png" width="100%" /> </center>
 </figure>
 <figure>
-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.
+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. <br /><br />Includes both Cage and Reference Mesh Head templates.
 </figure>
 </CardContent>
 
@@ -127,7 +138,7 @@ A comprehensive `.zip` folder of Blender assets, including multiple reference he
 <center> <img src="../assets/makeup/resources/Maya-Thumbnail.png" width="100%" /> </center>
 </figure>
 <figure>
-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.
+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. <br /><br />Includes both Cage and Reference Mesh Head templates.
 </figure>
 </CardContent>
 
diff --git a/content/en-us/makeup/reassign-textures.md b/content/en-us/makeup/reassign-textures.md
@@ -9,6 +9,58 @@ To import custom makeup textures, use Blender or Maya to reassign the existing t
 The following information is **specific for applying makeup textures to the Roblox provided head reference**, which already has PBR texture nodes assigned. For more information on assigning textures from scratch, see [Assign textures in Blender and Maya](../art/modeling/assign-textures.md).
 </Alert>
 
+## Video workflows
+
+The following are video workflows for various tasks in exporting textures from a texture editing tool and reconnecting them in Blender and Maya.
+
+<BaseAccordion>
+<AccordionSummary>
+<Typography variant="label1">Reassigning textures in Blender</Typography>
+</AccordionSummary>
+<AccordionDetails>
+<iframe width="800" height="450" src="https://www.youtube-nocookie.com/embed/B0y5fLlwkF0" title="YouTube video player" frameborder="0" allow="accelerometer; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe><br /><br />
+
+Additional notes:
+
+- In the video, the presenter opts to clear all existing image links by navigating to **File** > **External Data** > **Unpack Resources** and selecting **Remove Pack**.
+  - This is a method to unassign all images, equivalent to the [Blender](#blender) reassignment step #5.
+
+</AccordionDetails>
+</BaseAccordion>
+
+<BaseAccordion>
+<AccordionSummary>
+<Typography variant="label1">Reassigning textures in Maya</Typography>
+</AccordionSummary>
+<AccordionDetails>
+<iframe width="800" height="450" src="https://www.youtube-nocookie.com/embed/JaX5rcsStvQ" title="YouTube video player" frameborder="0" allow="accelerometer; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+
+</AccordionDetails>
+</BaseAccordion>
+
+<BaseAccordion>
+<AccordionSummary>
+<Typography variant="label1">Exporting textures from Photoshop</Typography>
+</AccordionSummary>
+<AccordionDetails>
+<iframe width="800" height="450" src="https://www.youtube-nocookie.com/embed/0se12PNhVCI" title="YouTube video player" frameborder="0" allow="accelerometer; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe><br /><br />
+
+Additional notes:
+
+- In the video, the presenter uses **File** > **Export** > **Layers to Files** to export each layer as its own `.png` file.
+
+</AccordionDetails>
+</BaseAccordion>
+
+<BaseAccordion>
+<AccordionSummary>
+<Typography variant="label1">Exporting textures from Substance Painter</Typography>
+</AccordionSummary>
+<AccordionDetails>
+<iframe width="800" height="450" src="https://www.youtube-nocookie.com/embed/g79GBh0AcXA" title="YouTube video player" frameborder="0" allow="accelerometer; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</AccordionDetails>
+</BaseAccordion>
+
 ## Blender
 
 1. Unzip and open the [Blender reference head file](../assets/makeup/resources/Makeup-Reference-Blender.zip).
diff --git a/content/en-us/makeup/specifications.md b/content/en-us/makeup/specifications.md
@@ -24,8 +24,11 @@ If you are following the best practice creation process, ensure that your templa
 - A **head mesh object** and associated **cage mesh object**.
   - These two objects must include the prefix "TransferTarget_" in their name.
 - **TransferTexture mesh objects** for each region: `Eyes`, `Face`, `Lips`.
-  - These three objects must include the prefix "TransferTexture_" in their name.
-  - Always export every region. Even if exporting makeup applied to the `TransferTexture_Eye` object, export `TransferTexture_Lips` and `TransferTexture_Face` as well.
+  - These three objects must follow the following naming conventions.
+    - `TransferTexture_Eyes_01`
+    - `TransferTexture_Lips_01`
+    - `TransferTexture_Face_01`
+    - Any for multiple regions, increment the affix number: `TransferTexture_Face_02`
 - Optional [eyebrows and eyelashes](#optional-eyebrows-and-eyelashes).
 
 <Alert severity = 'warning'>
diff --git a/content/en-us/reference/engine/classes/Players.yaml b/content/en-us/reference/engine/classes/Players.yaml
diff --git a/tools/checks/utils/allowedHttpLinks.txt b/tools/checks/utils/allowedHttpLinks.txt
