update Open Source Docs from Roblox internal teams

Author: rbx-open-source-docs[bot]

content/common/navigation/assets.yaml

@@ -45,19 +45,15 @@ navigation:
         path: /art/modeling/project-files
       - title: Rigging and skinning
         path: /art/modeling/rigging
-      - title: Blender and Maya export settings
+      - title: Blender / Maya export settings
         path: /art/modeling/export-requirements
-      - title: 3D Importer
-        path: /art/modeling/3d-importer
-      - title: glTF Export
-        path: /art/modeling/gltf-export
-      - title: Roblox Blender plugin
-        path: /art/modeling/roblox-blender-plugin
 
   - title: Texturing
     section:
       - title: Texture specifications
         path: /art/modeling/texture-specifications
+      - title: Blender / Maya texture settings
+        path: /art/modeling/assign-textures
       - title: Physically-based rendering (PBR)
         path: /art/modeling/surface-appearance
       - title: PBR material references
@@ -69,4 +65,10 @@ navigation:
         path: /art/characters/export-avatar-animations-from-maya
       - title: Head animation
         path: /art/characters/facial-animation/animate-heads
-  
+  
+  - title: 3D Importer
+    path: /art/modeling/3d-importer
+  - title: glTF Export
+    path: /art/modeling/gltf-export
+  - title: Roblox Blender plugin
+    path: /art/modeling/roblox-blender-plugin

content/common/navigation/avatar/guides.yaml

@@ -82,6 +82,8 @@ navigation:
         path: /makeup/
       - title: Specifications
         path: /makeup/specifications
+      - title: Reassign textures
+        path: /makeup/reassign-textures
       - title: Import into Studio
         path: /makeup/import
       - title: Face cage optimizations

content/common/navigation/engine/reference.yaml

@@ -3450,6 +3450,11 @@ navigation:
         type: engineapi
         source: /reference/engine/datatypes/UDim2.yaml
         ignoreTranslation: true
+      - title: ValueCurveKey
+        path: /reference/engine/datatypes/ValueCurveKey
+        type: engineapi
+        source: /reference/engine/datatypes/ValueCurveKey.yaml
+        ignoreTranslation: true
       - title: Vector2
         path: /reference/engine/datatypes/Vector2
         type: engineapi

content/en-us/art/modeling/assign-textures.md

@@ -0,0 +1,70 @@
+---
+title: Blender and Maya texture settings
+description: Learn to assign basic or PBR textures in Blender or Maya to natively import into Studio.
+---
+
+This guide covers the process to assign texture images in Blender or Maya to your 3D model so that they import seamlessly into Studio. The import process supports both basic textures and realistic PBR textures, as long as they meet Roblox's [texture specifications](./texture-specifications.md).
+
+<Alert severity = 'warning'>
+The following information is **specific for applying makeup textures generic meshes**. For more information on reassigning textures for makeup assets, see [Reassign textures in Blender and Maya](../../makeup/reassign-textures.md).
+</Alert>
+
+## Blender
+
+To assign Roblox-supported textures to your 3D model in Blender:
+
+1. In the Outliner, select your mesh object.
+2. In the Properties panel, navigate to the **Materials tab**.
+3. Verify that your object has a Material assigned with the Surface set to `Principled BSDF`.
+    <img src="../../assets/modeling/textures-decals/Blender-Material-Check.png" width="30%" alt=""/>
+4. If no material is assigned, click the + symbol to add a material.
+   1. Click the New button. A new `Principled BSDF` material populates.
+    <img src="../../assets/modeling/textures-decals/Blender-Create-New-Material.png" width="30%" alt=""/>
+5. Navigate to the **Shading tab**.
+6. With your mesh object selected, check the node graph. There may already be texture image nodes connected to the `Principled BSDF` node.
+7. In the node graph area, add a texture image node with right-click > **Add** > **Texture** > **Image Texture**.
+  <img src="../../assets/modeling/textures-decals/Blender-Add-Image-Texture.png" width="80%" alt=""/>
+8. In the new Image Texture node, click Open to open a file browser and insert your custom texture.
+    <img src="../../assets/modeling/textures-decals/Blender-Image-Texture-No-Assignment.png" width="30%" alt=""/>
+
+    <Alert severity = 'info'> Alternatively to steps 7-8, you can **drag and drop** texture file from another window into the graph editor space.</Alert>
+
+9.  After adding image texture nodes and assigning the appropriate files, drag the `Image Texture` sockets to the appropriate sockets in the `Principled BSDF` node:
+    <img src="../../assets/makeup/resources/Blender-Expected-Nodes.png" width="90%" />
+
+- **Basic texture** or **PBR color/albedo**: connect `Color` to `Base Color`.
+- **Metallic texture**: connect `Color` to `Metallic`.
+- **Roughness texture**: connect `Color` to `Roughness`.
+- **Normal texture** images need to be added to a NormalMap node:
+      1. Right-click in the graph-editor area and select **Add** > **Vector** > **Normal Map**.
+      2. Connect Image Texture `Color` to NormalMap's `Color`.
+      3. Connect NormalMap's `Normal` to PrincipledBSDF's `Normal` socket.
+
+<Alert severity ='success'>
+After replacing your PBR textures, [export the entire head](../../art/modeling/export-requirements.md#blender) and follow instructions to [import into Studio](./3d-importer.md).
+</Alert>
+
+## Maya
+
+To assign Roblox-supported textures to your 3D model in Maya:
+
+1. In the Status Line near the top of the default layout, click on the Hypershade icon.
+   <img src="../../assets/makeup/resources/Maya-Select-Hypershade.png" width="65%" />
+2. In the Create Window panel on the Hypershade popup, navigate to **Maya** > **Surface** and click **Standard Surface**. A surface node appears in the node editor.
+    <img src="../../assets/modeling/textures-decals/Maya-Create-Surface.png" width="65%" />
+3. If adding a normal map, navigate to **Maya** > **Utilities** and click **Bump 2d**. A node required for normal maps appears in the node editor.
+
+    <img src="../../assets/modeling/textures-decals/Maya-Bump-2D.png" width="65%" />
+
+4. Drag and drop your PBR textures to the graph network.
+
+   <img src="../../assets/makeup/resources/Maya-Select-Graph-Network.png" width="65%" />
+
+    1. If adding a normal map, select the Bump 2d node, and change to Tangent Space Normals.
+        <img src="../../assets/modeling/textures-decals/Maya-Tangent-Space-Normals.png" width="65%" />
+5. Select your model and navigate to your material you intend to assign. Right-click and hold over the material and select **Assign Material to Selection**.
+       <img src="../../assets/modeling/textures-decals/Maya-Assign-Material.png" width="65%" />
+
+<Alert severity ='success'>
+After replacing your PBR textures, [export the entire head](../../art/modeling/export-requirements.md#maya) and follow instructions to [import into Studio](./3d-importer.md).
+</Alert>

content/en-us/art/modeling/export-requirements.md

@@ -16,8 +16,7 @@ Check that your model meets Roblox's [modeling specifications](../../art/modelin
 </ul>
 </Alert>
 
-<Tabs>
-  <TabItem label="Blender">
+## Blender
 
 Before exporting a mesh from Blender, make sure to set the Scene Unit Length to **Centimeters** and, if applicable, set the Unit Scale to **.01** to ensure similar `.fbx` scaling within Studio.
 
@@ -43,8 +42,8 @@ To export the `.fbx` file in Blender:
 
 7. Click the **Export FBX** button.
 
-</TabItem>
-<TabItem label="Maya">
+## Maya
+
 To export a mesh in Maya as a `.fbx` file:
 
 1. In the topbar, click **File**. A pop-up menu displays.
@@ -61,6 +60,3 @@ To export a mesh in Maya as a `.fbx` file:
 9. Click the **Export All** button.
 
    <img src="../../assets/accessories/lc-requirements-maya-settings.png" alt="Maya export sidebar showing Bake Animation as unchecked"  />
-
-</TabItem>
-</Tabs>

content/en-us/art/modeling/specifications.md

@@ -56,7 +56,9 @@ See the following requirements for general rigging and skinning:
 
 ## Textures
 
-Roblox supports basic color textures and modern [PBR textures](../../art/modeling/surface-appearance.md). For technical requirements and best practices when generating individual texture images, see [Texture specifications](../../art/modeling/texture-specifications.md).
+- Roblox supports basic color textures and modern [PBR textures](../../art/modeling/surface-appearance.md).
+- For instructions on assigning texture images to natively import with your mesh, see [Assign textures in modeling tools](./assign-textures.md).
+- For technical requirements and best practices when generating individual texture images, see [Texture specifications](../../art/modeling/texture-specifications.md).
 
 ## Animations
 
@@ -81,5 +83,6 @@ For general use, see the following requirements for adding inner and outer cage
    <img src="../../assets/accessories/lc-blender-selecting-cage-in-outlier.png" alt="The Outliner in Blender showing two mesh objects called Tshirt_InnerCage and Tshirt_OuterCage."/>
 
 - **Outer cage** - Models, such as a playable character, that aren't expected deform but are the target of meshes that will stretch over it, only require an Outer Cage.
+  - For more information on applying and implementing cages on non-Humanoid targets, see [layered clothing on non-R15](../../characters/appearance.md#layered-clothing-on-non-r15).
 - **Vertices and UV map** - Don't delete vertices or alter the UVs on the Inner or Outer Cages as this can cause errors when importing in Studio or when equipping onto a character.
 - **Symmetry and consistency** - Keep each face (the space between vertices) consistently sized and retain symmetry wherever possible. Use symmetry tools in your modeling software whenever possible.

content/en-us/art/modeling/surface-appearance.md

@@ -22,6 +22,10 @@ description: PBR textures are advanced textures using multiple texture maps.
 
 Various applications and workflows are available for creating PBR textures. You can use these during the modeling and texturing phases of custom 3D object creation, provided that Roblox Studio [supports](../../art/characters/specifications.md#textures) the specific texture maps you're using.
 
+<Alert severity = 'info'>
+For information on how to properly connect PBR textures to your model in Blender and Maya for import into Studio, see [Blender / Maya texture settings](./assign-textures.md).
+</Alert>
+
 This guide provides instructions on [setting up](#enable-surface-appearance) your mesh objects to use PBR texture maps, and describes common use-cases and best practices for Roblox's supported PBR [texture maps](#texture-maps). When creating your own surfaces, see [material references](../../art/modeling/material-reference.md) for common material values, image comparisons and clothing examples.
 
 ## Enable surface appearance

content/en-us/art/modeling/texture-specifications.md

@@ -7,6 +7,10 @@ A texture is a digital image applied to the surface of a 3D object to simulate a
 
 Roblox also supports [physically-based rendering (PBR) textures](../../art/modeling/surface-appearance.md) which override a mesh's existing `Class.MeshPart.TextureID|TextureID` and can be used to create immersive environments and objects.
 
+<Alert severity = 'info'>
+For information on how to properly connect textures to your model in Blender and Maya for import into Studio, see [Blender / Maya texture settings](./assign-textures.md).
+</Alert>
+
 See the following requirements when creating your own basic and advanced textures:
 
 - **File formats** — File formats for textures that are uploaded separately in Studio must be submitted as a `.png`, `.jpg`, `.tga`, or `.bmp`.
@@ -30,6 +34,10 @@ Roblox default [materials](../../parts/materials.md) follow a similar texel reso
 
 You can add a [surface appearance](../../art/modeling/surface-appearance.md) to your mesh in Studio to add PBR texture options. The `Class.SurfaceAppearance` instance uses UV mapping, a form of texture mapping, to accurately map up to four 2D images onto the mesh object.
 
+<Alert severity = 'info'>
+For information on how to properly connect PBR textures to your model in Blender and Maya for import into Studio, see [Blender / Maya texture settings](./assign-textures.md).
+</Alert>
+
 See the following requirements for `Class.SurfaceAppearance` assets:
 
 - **Texture files** — Ensuring your textures follow consistent conventions optimizes assets for tools like the [3D Importer](../../art/modeling/3d-importer.md) and helps with organization. When possible, texture files should include the appropriate name affix and follow the appropriate image details: