update Open Source Docs from Roblox internal teams

rbx-open-source-docs[bot] · rbx-open-source-docs[bot] · commit aebb5ecd0a49 · 2026-07-22T21:44:33.000Z
diff --git a/content/common/navigation/avatar/guides.yaml b/content/common/navigation/avatar/guides.yaml
@@ -35,8 +35,6 @@ navigation:
             path: /avatar/rigid-accessories/
           - title: Specifications
             path: /avatar/rigid-accessories/specifications
-          - title: Body scale
-            path: /art/accessories/body-scale
           - title: Export settings
             path: /avatar/rigid-accessories/export
           - title: Import into Studio
diff --git a/content/en-us/art/accessories/body-scale.md b/content/en-us/art/accessories/body-scale.md
diff --git a/content/en-us/assets/accessories/lc-requirements-maya-settings.png b/content/en-us/assets/accessories/lc-requirements-maya-settings.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:37624b57af8ab6d6f32e60c08e2d742cc6763b427a9b9dddecf6b2cbeaeec56a
-size 90041
+oid sha256:5011804da82456301782d0e02ee3988886ee83be88487c74d0096df21305e8a3
+size 218237
diff --git a/content/en-us/assets/accessories/rigid-accessory-blender.png b/content/en-us/assets/accessories/rigid-accessory-blender.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:820cf3d1a3bd9d6bd077b138c205c26ddc0b8eac7a00d56a80e6ca7ff5794b09
+size 155768
diff --git a/content/en-us/assets/art/accessories/Attachment-Bow-Example.png b/content/en-us/assets/art/accessories/Attachment-Bow-Example.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f288455dc9c15e232113684cb994449b7dc0c6ce08f34f2bf0484c153505009a
+size 361787
diff --git a/content/en-us/assets/art/accessories/Attachment-Hair-Example.png b/content/en-us/assets/art/accessories/Attachment-Hair-Example.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:367d197c18fcda1b3526e41363eb29125871733b29dcebe00f0f4c7900fcdb97
+size 722405
diff --git a/content/en-us/assets/art/accessories/Mesh-Bow-Example.png b/content/en-us/assets/art/accessories/Mesh-Bow-Example.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:d447465e6cc5e48e7a52585f6dfd85914ad2ff19fc65c3a41a31ffa9e1d3737e
-size 103851
+oid sha256:bcebc9662d521b4d6825014935104511ff64499f9e5e4f8492a3aaf4ed9dec09
+size 79000
diff --git a/content/en-us/assets/art/accessories/Mesh-Hair-Example.png b/content/en-us/assets/art/accessories/Mesh-Hair-Example.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:1d24926ba2d5e4e3f34398468fbfe74043419895921e395852c32666de6245b8
+size 328503
diff --git a/content/en-us/assets/art/accessories/Texture-Bow-Example.png b/content/en-us/assets/art/accessories/Texture-Bow-Example.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e2b485f08202b9521057113d1776643eaa4fcf4f14e455391e8c97c517164ae1
+size 405842
diff --git a/content/en-us/assets/art/accessories/Texture-Hair-Example.png b/content/en-us/assets/art/accessories/Texture-Hair-Example.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5512497e05c0e7f167141d16e862d6c218c6b31e57a11f9958685f0ba75667f0
+size 475813
diff --git a/content/en-us/assets/art/accessories/creating-rigid/AFT-Add-Avatar-Panel-Bow.png b/content/en-us/assets/art/accessories/creating-rigid/AFT-Add-Avatar-Panel-Bow.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d8d5e623f46422b382663b54fc889279379bedc69dc9421361d6659832309d36
+size 99102
diff --git a/content/en-us/assets/art/accessories/creating-rigid/AFT-Select-Mesh-Bow.png b/content/en-us/assets/art/accessories/creating-rigid/AFT-Select-Mesh-Bow.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4804ac86b86a7fe753d1ae4638793b23cb8b1d2ac105a86aa38424fa8b409c0b
+size 10493
diff --git a/content/en-us/assets/art/accessories/creating-rigid/AFT-Select-Type-Bow.png b/content/en-us/assets/art/accessories/creating-rigid/AFT-Select-Type-Bow.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:95233a634a0673497888a7fd99af0421d609246fcd3e9b0a11ca341a987cbdfb
+size 17491
diff --git a/content/en-us/assets/art/accessories/creating-rigid/Adding-Surface-Appearance-Bow.png b/content/en-us/assets/art/accessories/creating-rigid/Adding-Surface-Appearance-Bow.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6f06d29f1cce5a4309e6b4603117a3fff189ae236a2ddad1479abbe154154915
+size 9983
diff --git a/content/en-us/assets/art/accessories/creating-rigid/Import-Rigid-Accessory.png b/content/en-us/assets/art/accessories/creating-rigid/Import-Rigid-Accessory.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:72d30075d1df263792f14fdd4eceb406cd9754f4d1b4bdad01aabed54005c4ca
+size 349951
diff --git a/content/en-us/assets/art/accessories/creating-rigid/Surface-Appearance-Asset-Dropdown-Bow.png b/content/en-us/assets/art/accessories/creating-rigid/Surface-Appearance-Asset-Dropdown-Bow.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:01c14e910148198712ecaff9beda4bb7228a2605c2f5495163b88026c45ac438
+size 33502
diff --git a/content/en-us/assets/feeds/inspire_2026.webp b/content/en-us/assets/feeds/inspire_2026.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4a33a4ffdb1c0423b86ac06b9304ebb709034da28d6847f7f58712876682449e
+size 22988
diff --git a/content/en-us/assets/makeup/Imported-DataModel.png b/content/en-us/assets/makeup/Imported-DataModel.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:ee6b4969fe631f6834f8d8d5e7a0042a91f695404f200a32d16d5ab8a7e144b0
-size 108304
+oid sha256:ed1f6212ea2711ce44a34d1ca955fd331e811da5f091856efbd79a2d003b1a74
+size 74334
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:62517bd1bcfe48275880bcf1c091d22f6586ec7df1db4452380f1251990e723b
-size 44495
+oid sha256:2fb8549e91da8efc80cd62153efee9dadfc8fb1d4684b218658e428da7155ca2
+size 198004
diff --git a/content/en-us/assets/makeup/Makeup-Eye-Accessory-Datamodel.png b/content/en-us/assets/makeup/Makeup-Eye-Accessory-Datamodel.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:1c9d384792b843010734c65ea81efb2d28c4966f1b2422d572c1c96eba944f04
-size 43750
+oid sha256:a8c0e74ad6ff1e2585fae2d1540fcd0b753168ba520f2de9d4f62edcff8f129d
+size 204764
diff --git a/content/en-us/assets/makeup/Makeup-Studio-Datamodel.png b/content/en-us/assets/makeup/Makeup-Studio-Datamodel.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:41bb05b938556bf85b2fc1db5d9952fba34673646657c3df8b0a1395bf0cae9b
-size 12866
+oid sha256:df910b46e0f8cf9289221811d880d630ca7ea36279c5c43d73d2c0501e8537aa
+size 72657
diff --git a/content/en-us/avatar/character-bodies/export.md b/content/en-us/avatar/character-bodies/export.md
@@ -3,27 +3,23 @@ title: Export character bodies
 description: Use the appropriate export settings in Maya and Blender to generate Studio-ready .fbx files.
 ---
 
-<Alert severity = 'warning'>
-It's important to test your assets multiple times at every point of the asset creation process, whether it is within your modeling application or after importing into Studio. See [Test characters](../../art/characters/testing/index.md) for more information.
-</Alert>
+When you are ready to export a character body model that meets Roblox's [character body specifications](./specifications.md), it's important to review the following prerequisite information and step-by-step instructions for the `.fbx` or `.gltf` export files so that your creation takes advantage of all of Studio's [Importer](../../studio/importer.md) features.
 
-When you are ready to export a character body model that meets Roblox's [avatar character specifications](../../avatar/character-bodies/specifications.md), it's important to review the following prerequisite information and step-by-step instructions for the `.fbx` or `.gltf` export files so that your creation takes advantage of all of Studio's [Importer](../../studio/importer.md) features.
+This is particularly important for character body models because they contain all the mesh and texture data, including the rig and influence data that's essential for characters to move and animate properly across the platform.
 
-This is particularly important for character body models because they contain all the mesh and texture data, including the rig and influence data, that's essential for characters to move and animate properly across the platform.
+<Alert severity = 'warning'>
+If you are using Roblox's avatar template files, you must perform the [cleanup steps](../../art/characters/creating/combine-head-geometry.md) in order for the assets to properly validate.
+</Alert>
 
 <Alert severity = 'info'>
-<AlertTitle>If creating other types of 3D models:</AlertTitle>
+<AlertTitle>For other types of 3D models:</AlertTitle>
 <ul>
-<li>For generic meshes, see [general mesh specifications](../../art/modeling/specifications.md) and [general export settings](../../art/modeling/export-requirements.md).</li> <br />
-<li>For rigid accessories, see [accessory specifications](../rigid-accessories/specifications.md) and [accessory export settings](../rigid-accessories/export.md).</li> <br />
-<li>For layered accessories, see [layered accessory specifications](../layered-accessories/specifications.md) and [layered export settings](../layered-accessories/export.md).</li> <br />
+<li>[General mesh](../../art/modeling/export-requirements.md) export settings.</li>
+<li>[Rigid accessory](../rigid-accessories/export.md) export settings.</li>
+<li>[Layered accessory](../layered-accessories/export.md) export settings.</li>
 </ul>
 </Alert>
 
-<Alert severity = 'error'>
-If you are using Roblox's avatar template files, you must perform the [cleanup steps](../../art/characters/creating/combine-head-geometry.md) in order for the assets to properly validate.
-</Alert>
-
 ## Prerequisites
 
 Before you export your custom character body:
@@ -56,8 +52,8 @@ Blender allows you to export your character body as either a `.fbx` or `.gltf` f
 
 To export a mesh in Blender as a `.fbx` file:
 
-1. In the topbar, click **File** > **Export** > **FBX (.fbx)**. The Blender file browser window displays.
-1. Set **Path Mode** to **Copy** and enable the **Embed Textures** icon.
+1. In the topbar, click **File** > **Export** > **FBX (.fbx)**. The **Blender File View** window displays.
+1. On the right-hand side, set **Path Mode** to **Copy**, then toggle the **Embed Textures** button.
 1. In the **Include** section, enable **Custom Properties**.
 1. In the **Transform** section, set **Apply Scalings** to **FBX Unit Scale**. If you run into scaling issues on import, see [Blender FBX scaling](../../art/blender.md#adjust-scale-fbx) for alternative approaches.
 1. In the **Armature** section, uncheck **Add Leaf Bones**.
diff --git a/content/en-us/avatar/character-bodies/import.md b/content/en-us/avatar/character-bodies/import.md
@@ -30,51 +30,42 @@ To import your asset as a character body model:
 
 1. Select **Import**. The asset populates in your workspace as a `Class.Model` with the appropriate textures applied as a `Class.SurfaceAppearance` or `Class.MeshPart.TextureID`.
 
+   <GridContainer numColumns="2">
+   <figure>
+   <img src="../../assets/art/avatar/Avatar-Studio-Example.png" />
+   </figure>
+   <figure>
+   <img src="../../assets/art/avatar/Avatar-Data-Model.png" />
+   </figure>
+   </GridContainer>
+
 <BaseAccordion>
-<AccordionSummary>Manually add textures</AccordionSummary>
+<AccordionSummary>Textures didn't load correctly?</AccordionSummary>
 <AccordionDetails>
- If textures didn't load correctly, add them manually. You may need to save and publish your game in order to access the [Asset Manager](../../projects/assets/manager.md).
+If your textures didn't load correctly, you can import them manually using the [Asset Manager](../../projects/assets/manager.md):
 
-1.  In the **Asset Manager**, click the **Import** button.
-2.  Upload your image files.
-3.  After moderation clears for your image, select the `Class.MeshPart` parented within your imported `Class.Model`.
-4.  If you are using a single basic texture, set the `Class.MeshPart.TextureID` property to your uploaded texture image.
-5.  If you are using PBR textures:
+1. In the **Asset Manager**, click the **Import** button. If you are unable to access the Asset Manager, save and publish your game first.
+1. Upload your image files.
+1. After moderation clears your images, select the `Class.MeshPart` parented within your imported `Class.Model`.
+1. If you are using a single basic texture, set the `Class.MeshPart.TextureID` property to your uploaded texture image.
+1. If you are using PBR textures:
 
-    1. Add a `Class.SurfaceAppearance` child to your `Class.MeshPart`.
+   1. Add a `Class.SurfaceAppearance` child to your `Class.MeshPart`.
 
-       <img src="../../assets/art/avatar/Avatar-Surface-Appearance.png" width = "40%"/>
+      <img src="../../assets/art/avatar/Avatar-Surface-Appearance.png" width = "40%"/>
 
-    2. In the `Class.SurfaceAppearance` properties, click each property value and assign the appropriate texture image from the asset dropdown:
+   1. In the `Class.SurfaceAppearance` properties, click each property value and assign the appropriate texture image from the asset dropdown:
 
-       1. Set the **ColorMap** to the **\_ALB** texture image.
-       2. Set the **MetalnessMap** to the **\_MTL** texture image.
-       3. Set the **NormalMap** to the **\_NOR** texture image.
-       4. Set the **RoughnessMap** to the **\_RGH** texture image.
+      1. Set the **ColorMap** to the **\_ALB** texture image.
+      1. Set the **MetalnessMap** to the **\_MTL** texture image.
+      1. Set the **NormalMap** to the **\_NOR** texture image.
+      1. Set the **RoughnessMap** to the **\_RGH** texture image.
 
-       <img src="../../assets/art/avatar/Avatar-Roughness-Map.png" width = "50%"/>
+      <img src="../../assets/art/avatar/Avatar-Roughness-Map.png" width = "50%"/>
 
 </AccordionDetails>
 </BaseAccordion>
-
-<Alert severity = 'success'>
-After successful import, your model object should populate in your project as a `Class.Model` with the appropriate textures applied.
-</Alert>
-
-After successful fitting and converting, your 3D model should populate in your project as an avatar-ready `Class.Model` in the **Explorer** window.
-
-      <GridContainer numColumns="2">
-      <figure>
-         <img src="../../assets/art/avatar/Avatar-Studio-Example.png" />
-      </figure>
-      <figure>
-         <img src="../../assets/art/avatar/Avatar-Data-Model.png" />
-      </figure>
-      </GridContainer>
-
-<Alert severity = 'warning'>
-Character creation is a complex process that requires lots of testing and iteration. See [Test characters](../../art/characters/testing/index.md) for steps on importing your character model into a test place and verifying your avatar and related components.
-</Alert>
+<br />
 
 With this new character `Class.Model`, you can perform any of the following:
 
@@ -84,4 +75,8 @@ With this new character `Class.Model`, you can perform any of the following:
 
   - Playtest as the character by renaming the `Class.Model` to `StarterCharacter` and moving the `Class.Model` to the `Class.StarterPlayer` folder in the **Explorer** before play testing.
 
-- Save the model to your [Toolbox](../../projects/assets/toolbox.md) or make it public on the [Creator Store](../../production/creator-store.md) to share or use within any of your games.
+- Save the model to your [Toolbox](../../projects/assets/toolbox.md) or make it public on the [Creator Store](../../production/creator-store.md) to use within any of your games or share with other creators.
+
+<Alert severity = 'warning'>
+Character creation is a complex process that requires lots of testing and iteration. For information on importing your character model into a test place and verifying your avatar and related components, see [Test characters](../../art/characters/testing/index.md).
+</Alert>
diff --git a/content/en-us/avatar/character-bodies/index.md b/content/en-us/avatar/character-bodies/index.md
@@ -19,7 +19,7 @@ While you can create each of these layers manually in third-party modeling tools
 1. Review all [resources](#resources) that Roblox provides to standardize and expedite the [creation process](#creation-process), such as Blender and Maya project files, Studio tooling, and step-by-step guides.
 1. Follow the [basic character creation tutorial](../../art/characters/creating/index.md) that uses Roblox templates in collaboration with common Blender modeling and texturing tools.
 
-Once you have a character body model, you can import it into Studio and use the Avatar Setup tool to process your creation into an avatar asset that's ready to be sold on the [Marketplace](../../marketplace/index.md).
+Once you have a custom character body model, you can import it into Studio and use the Avatar Setup tool to process your creation into an avatar asset that's ready to be sold on the [Marketplace](../../marketplace/index.md).
 
 ## Character body components
 
@@ -107,6 +107,7 @@ In Studio, each joint of the rigging armature is represented by `Class.Bone` obj
 </GridContainer>
 
 <figure><img src="../../assets/art/avatar/Facial-Animation-Timeline.png" /><figcaption>Each required face pose is saved as a keyframe in the animation timeline.</figcaption></figure>
+
 Facial animation data from either the character's rigging armature or facial joints allow avatars to express emotions with their eyes, mouth, and teeth. Each character includes facial joints, skinning data, animation timeline data, and mapped pose data that allows it. In Studio, these facial animation elements are represented by a `Class.FaceControls` instance.
 
 ### Cage meshes
@@ -131,20 +132,20 @@ If you are caging your own non-template character model, it's important to use o
 
 Attachment points set the specific points where rigid accessories and in-game equipable objects attach to the character's body. These are not rendered on the platform, but they are represented visually as spheres in 3D modeling software when you use Roblox's **R15 Rig and Attachments** [project file](../../avatar/resources.md#project-files).
 
-When you import a rig with these visual representations, the spheres are created as `Class.Attachment` instances using the standardized names.
+When you import a rig with these visual representations, the spheres are created as `Class.Attachment` objects using standardized names.
 
 <Alert severity = 'info'>
 When users wear layered clothing, the clothing isn't attached directly to the attachment, but it does reference the associated attachment point during ragdoll and dismemberment animations.
 </Alert>
 
 ## Creation process
 
-When designing an avatar model, you must export all of the avatar components in a single `.fbx` or `.gltf` for import into Studio. Since 3D creation isn't a linear process and always requires reiteration and testing, the process of creating an avatar character model can differ between individuals and various creation workflows.
+When designing a character body in [Blender](https://www.blender.org/) or [Maya](https://www.autodesk.com/products/maya/overview), you must export all of the avatar components in a single `.fbx` or `.gltf` for import into Studio. Since 3D creation isn't a linear process and always requires reiteration and testing, the process of creating an avatar character model can differ between individuals and various creation workflows.
 
 In general, the creation process follows these typical workflows:
 
 <GridContainer numColumns="2">
-  <figure><center>**Basic Creation with Templates**</center><br />Customize a [character body template ](../../art/characters/creating/index.md) that already includes all the necessary components.<img src="../../assets/art/avatar/Workflow-Bodies-Templates.png"/></figure>
+  <figure><center>**Basic Creation with Templates**</center><br />Customize a [character body template](../../art/characters/creating/index.md) that already includes all the necessary components.<img src="../../assets/art/avatar/Workflow-Bodies-Templates.png"/></figure>
 
   <figure><center>**Advanced Creation from Scratch**</center><br />Create characters from scratch, allowing full customization of the avatar character's components.<img src="../../assets/art/avatar/Workflow-Bodies-Traditional.png"/></figure>
 </GridContainer>
diff --git a/content/en-us/avatar/character-bodies/specifications.md b/content/en-us/avatar/character-bodies/specifications.md
diff --git a/content/en-us/avatar/makeup/import.md b/content/en-us/avatar/makeup/import.md
diff --git a/content/en-us/avatar/makeup/reassign-textures.md b/content/en-us/avatar/makeup/reassign-textures.md
diff --git a/content/en-us/avatar/makeup/specifications.md b/content/en-us/avatar/makeup/specifications.md
diff --git a/content/en-us/avatar/rigid-accessories/export.md b/content/en-us/avatar/rigid-accessories/export.md
diff --git a/content/en-us/avatar/rigid-accessories/import.md b/content/en-us/avatar/rigid-accessories/import.md
diff --git a/content/en-us/avatar/rigid-accessories/index.md b/content/en-us/avatar/rigid-accessories/index.md
diff --git a/content/en-us/avatar/rigid-accessories/specifications.md b/content/en-us/avatar/rigid-accessories/specifications.md
