update Open Source Docs from Roblox internal teams

rbx-open-source-docs[bot] · rbx-open-source-docs[bot] · commit 8fff7c849e90 · 2026-07-24T16:11:33.000Z
diff --git a/content/en-us/assets/avatar-anatomy/avatar-walk-poster.png b/content/en-us/assets/avatar-anatomy/avatar-walk-poster.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f5a7c6ec16841b931cefdd2b1e524abcc35ced9ce0e00a89926d3c7adf8ba178
+size 108507
diff --git a/content/en-us/assets/avatar-anatomy/avatar-walk.gif b/content/en-us/assets/avatar-anatomy/avatar-walk.gif
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c64d52b913753827cab15f9695bbb3161b69d3791ef5d05fa0e5f7d1dea80bb2
+size 426703
diff --git a/content/en-us/assets/avatar-anatomy/classic-clothing/all-clothes.png b/content/en-us/assets/avatar-anatomy/classic-clothing/all-clothes.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4142187f83bfb7e134b33b9da2c323d6513d3d93f2eed594b934d773ae51b11f
+size 98612
diff --git a/content/en-us/assets/avatar-anatomy/classic-clothing/no-clothes.png b/content/en-us/assets/avatar-anatomy/classic-clothing/no-clothes.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:035596be64a52b8ea07aad1c4cd9c1adefb69dbba1d986ea22b24c263f938dde
+size 60680
diff --git a/content/en-us/assets/avatar-anatomy/classic-clothing/pants-only.png b/content/en-us/assets/avatar-anatomy/classic-clothing/pants-only.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5e28f26ebf65a495988f7d8a84df13fd348421205fbdedaee737903939d4f94c
+size 41420
diff --git a/content/en-us/assets/avatar-anatomy/classic-clothing/shirt-only.png b/content/en-us/assets/avatar-anatomy/classic-clothing/shirt-only.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:45f15cd093d08a42c36d888d685b1445e3c7cf74b5886496632cd35ff115571e
+size 90869
diff --git a/content/en-us/assets/avatar-anatomy/facial-expressions-poster.png b/content/en-us/assets/avatar-anatomy/facial-expressions-poster.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:2259ab519ae6526adf4035a5e3d0a35ebaf282950866e36bee80665948739bb0
+size 263194
diff --git a/content/en-us/assets/avatar-anatomy/facial-expressions.gif b/content/en-us/assets/avatar-anatomy/facial-expressions.gif
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:df031d9454e11f1d48e4acef69149792cbe23187aae7ac94240cdb5e0b191b84
+size 16128036
diff --git a/content/en-us/assets/avatar-anatomy/floss-dance-emote-poster.png b/content/en-us/assets/avatar-anatomy/floss-dance-emote-poster.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:742d2e72ed0a8910fd528eafb5d2936a036c322d962480d7ceba4fcc3a432024
+size 159308
diff --git a/content/en-us/assets/avatar-anatomy/floss-dance-emote.gif b/content/en-us/assets/avatar-anatomy/floss-dance-emote.gif
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:cd3d729a3631fb1cf1b361bb149717159d0b93e365013875d063d02abe2183c7
+size 2245534
diff --git a/content/en-us/assets/avatar-anatomy/layered-accessories/jacket-1.png b/content/en-us/assets/avatar-anatomy/layered-accessories/jacket-1.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:73ed655c0ba177032ed65e2e5e49ad8179bf882f4d6724f975003eab92a1949b
+size 76268
diff --git a/content/en-us/assets/avatar-anatomy/layered-accessories/jacket-2.png b/content/en-us/assets/avatar-anatomy/layered-accessories/jacket-2.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a3168f88509e9d94c30d8903a66b863f5d87efa0d2f36642f55737376d54c29f
+size 75243
diff --git a/content/en-us/assets/avatar-anatomy/layered-accessories/jacket-3.png b/content/en-us/assets/avatar-anatomy/layered-accessories/jacket-3.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4d917f8c9cc4ed58804fbc0a8e89c0410e26820e81e729effec3db1be56336ac
+size 73159
diff --git a/content/en-us/assets/avatar-anatomy/layered-accessories/jacket-4.png b/content/en-us/assets/avatar-anatomy/layered-accessories/jacket-4.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d09e80351287e10e9b5a0daceb94b94808a1c6ae8c1d85fae47d50cf9fddabcd
+size 88134
diff --git a/content/en-us/assets/avatar-anatomy/layered-accessories/no-clothing.png b/content/en-us/assets/avatar-anatomy/layered-accessories/no-clothing.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:785d54254ebb5a17b1d0dfa6af10566cebe6e2c9609c773015f784d679c6fbdb
+size 74069
diff --git a/content/en-us/assets/avatar-anatomy/makeup/eyes-face.png b/content/en-us/assets/avatar-anatomy/makeup/eyes-face.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:2bfa4013dc383a0dd902d73ae2c7724c991fa3c21d50d80ea594fa310d7d38fe
+size 171955
diff --git a/content/en-us/assets/avatar-anatomy/makeup/eyes-only.png b/content/en-us/assets/avatar-anatomy/makeup/eyes-only.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:3337a03de0b3d9f934a80ef6c947dff1af21f1c929c474ce175c1e794c551895
+size 171190
diff --git a/content/en-us/assets/avatar-anatomy/makeup/face-only.png b/content/en-us/assets/avatar-anatomy/makeup/face-only.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:9415f73bbb97a971b2f5cceccc66abedcfc793e658017900a10401a6a9d04674
+size 172166
diff --git a/content/en-us/assets/avatar-anatomy/makeup/lips-eyes-face.png b/content/en-us/assets/avatar-anatomy/makeup/lips-eyes-face.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:90e9b2c37d9970719b0d5ebf7bd7733c37f8b0fcda9a46c890d7f8eed3f2d1f6
+size 171593
diff --git a/content/en-us/assets/avatar-anatomy/makeup/lips-eyes.png b/content/en-us/assets/avatar-anatomy/makeup/lips-eyes.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:2e68f0ee932db7bfcefcb417a4c3864ff4e465abafe5ae12c9b0e410c9725acf
+size 170862
diff --git a/content/en-us/assets/avatar-anatomy/makeup/lips-face.png b/content/en-us/assets/avatar-anatomy/makeup/lips-face.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:83596b33a4cc08c1e4efd35cd749b4c6093b370b86b997b79935d024aec78874
+size 172307
diff --git a/content/en-us/assets/avatar-anatomy/makeup/lips-only.png b/content/en-us/assets/avatar-anatomy/makeup/lips-only.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:b6bc09431c3318855d8839ffbd086b4f55c29e4ae23e82c062feb9d55b0be0a5
+size 171656
diff --git a/content/en-us/assets/avatar-anatomy/makeup/no-makeup.png b/content/en-us/assets/avatar-anatomy/makeup/no-makeup.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:407a93c956455dba2e90908c8ca2d2819a0a92e370dae59c915ac9d9c8fa0a74
+size 171334
diff --git a/content/en-us/assets/avatar-anatomy/rigid-accessories/back-only.png b/content/en-us/assets/avatar-anatomy/rigid-accessories/back-only.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d81adaef5dd0c07d007806be8ffbcabb42f6a6f3d17172eb3822e49ea28a8f84
+size 222315
diff --git a/content/en-us/assets/avatar-anatomy/rigid-accessories/back-waist.png b/content/en-us/assets/avatar-anatomy/rigid-accessories/back-waist.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:9b8edc3bb6e95707d36f45918fbfbbfe8e754b9ca11fabcffc4e990094b335aa
+size 293990
diff --git a/content/en-us/assets/avatar-anatomy/rigid-accessories/neck-back-waist.png b/content/en-us/assets/avatar-anatomy/rigid-accessories/neck-back-waist.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:516819172002ad653d9cfcf4171046b4c3303dd533a736fba9fdf712f3945a9a
+size 299026
diff --git a/content/en-us/assets/avatar-anatomy/rigid-accessories/neck-back.png b/content/en-us/assets/avatar-anatomy/rigid-accessories/neck-back.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:b8a4e5accd9710198f0414b80e49a4641018dd6cf800151c1f00a9629a0db617
+size 226654
diff --git a/content/en-us/assets/avatar-anatomy/rigid-accessories/neck-only.png b/content/en-us/assets/avatar-anatomy/rigid-accessories/neck-only.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:930ab3c9239f1aea4e5225194462e9b39083a1f30f80ba6fbbf251719e7592ec
+size 192741
diff --git a/content/en-us/assets/avatar-anatomy/rigid-accessories/neck-waist.png b/content/en-us/assets/avatar-anatomy/rigid-accessories/neck-waist.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:bb6b4329e4a7f3ed83c66c0dedb30787512d6d8f3e153c701bbb1140ce134897
+size 272173
diff --git a/content/en-us/assets/avatar-anatomy/rigid-accessories/no-accessories.png b/content/en-us/assets/avatar-anatomy/rigid-accessories/no-accessories.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:cface2c19328921915a989a8cce50ca700f2ad81e1f4f7a8f75d07f16a284080
+size 189306
diff --git a/content/en-us/assets/avatar-anatomy/rigid-accessories/waist-only.png b/content/en-us/assets/avatar-anatomy/rigid-accessories/waist-only.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d44c6148faad3180f38891b62d076ff60b7bfa3ef9ff571cff536bc4d638b7a9
+size 267326
diff --git a/content/en-us/assets/avatar-anatomy/shrug-emote-poster.png b/content/en-us/assets/avatar-anatomy/shrug-emote-poster.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:99356f0ee738931d44919c49c2903772935210f38d24ffcb5e8ab2b193af2774
+size 155770
diff --git a/content/en-us/assets/avatar-anatomy/shrug-emote.gif b/content/en-us/assets/avatar-anatomy/shrug-emote.gif
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6aa94f0646fb35afd8087fadd33317bb779981f3148976a16b7a35adade6bbeb
+size 2328337
diff --git a/content/en-us/assets/avatar-anatomy/static-sections/cages-attachments.png b/content/en-us/assets/avatar-anatomy/static-sections/cages-attachments.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a10472be8638efcc576622520ec483973ed179379d26ad0441e911964ccb5852
+size 64713
diff --git a/content/en-us/assets/avatar-anatomy/static-sections/geometry.png b/content/en-us/assets/avatar-anatomy/static-sections/geometry.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:2385a099e1e65e5dcf99e66379bd274794ef512006fd026e87afe7cf79c7f361
+size 55631
diff --git a/content/en-us/assets/avatar-anatomy/static-sections/rigging.png b/content/en-us/assets/avatar-anatomy/static-sections/rigging.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:de78ba722d85cdeb3fe5869e6ee5d20114597cfc02e3ce33c92d10f9260db6d1
+size 31510
diff --git a/content/en-us/assets/landing/gimp-logo.png b/content/en-us/assets/landing/gimp-logo.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d64fd22c6d078b1319cec64ebba478bc79a13de327265061aad495b79b3e5124
+size 362817
diff --git a/content/en-us/assets/landing/maya-logo.png b/content/en-us/assets/landing/maya-logo.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:465b2b0c6b703458a9445976fbf1c09a384aaa761bdee7819814a569a57aa00d
+size 10867
diff --git a/content/en-us/avatar/create.md b/content/en-us/avatar/create.md
@@ -0,0 +1,89 @@
+---
+title: Create avatar assets
+description: Create avatar characters, cosmetics, clothing, and accessories to the Marketplace.
+
+hideInPageNavigation: true
+---
+
+As an avatar creator, you can empower self-expression with your creativity and monetize your creations. Whether you're a 3D artist, character rigging specialist, animator, or someone with interest in character design, there are many pathways for you to create on Roblox, including:
+
+- **Bodies** - Geometry, textures, rigging armature, attachment points, and cages that make up how a character renders and articulates in the 3D space.
+- **Makeup** - Facial cosmetic items, such as traditional makeup art, face paint, or battle markings.
+- **Accessories and clothing** - Equippable items that attach or wrap around the character's body.
+- **Animations** - Full body emotes or facial expressions that express the character's personality.
+
+Almost every custom avatar asset requires a combination of creative work in third-party image editing or 3D modeling software and Studio's built-in avatar customization and validation tooling. Let's explore your options.
+
+## Third-party tools
+
+There are a wide range of third-party tools available to create file types that you can import into Studio for avatar assets. The following are examples of popular third-party software that creators commonly use for their creative workflows.
+
+<table>
+<tbody>
+ <tr>
+   <td width="33%"><center><img src="../assets/landing/blender-logo.png" width="100%" /></center></td>
+   <td width="33%"><center><img src="../assets/landing/maya-logo.png" width="55%" /></center></td>
+   <td width="33%"><center><img src="../assets/landing/gimp-logo.png" width="80%" /></center></td>
+ </tr>
+ <tr>
+   <td width="33%">[Blender](https://www.blender.org/) is a free, open-source 3D creation suite with a broad range of modeling, sculpting, texturing, rigging, and animation tools.</td>
+   <td width="33%">[Autodesk Maya](https://www.autodesk.com/products/maya/overview) is a subscription-based industry standard toolset that covers the entire 3D production pipeline.</td>
+   <td width="33%">[GNU Image Manipulation Program](https://www.gimp.org/) (GIMP) is a free, open-source image editor.</td>
+ </tr>
+</tbody>
+</table>
+
+## Studio tools
+
+Once you have your custom image or 3D model file, Studio offers a full suite of tooling to convert the model or image file into Roblox-ready avatar assets that meet platform policies and technical standards. The following are all major tools you can use to create, test, and upload your assets to the Marketplace.
+
+<table>
+<thead>
+ <tr>
+   <th width="33%">**Importer**</th>
+   <th width="33%">**Avatar Setup**</th>
+   <th width="33%">**Automatic Skinning Transfer**</th>
+ </tr>
+</thead>
+<tbody>
+ <tr>
+   <td width="33%">The [Importer](../studio/importer.md) allows you to import 3D models, images, and other file types into Studio. It supports meshes for avatar items with PBR textures, rigging, skinning, and animation data.</td>
+   <td width="33%">[Avatar Setup](../avatar-setup/index.md) automatically processes custom models into avatar assets. If the models don't have all essential components for publishing to the Marketplace, Avatar Setup generates them, such as partitions for your geometry, rigging armatures, skinning weights and influences, cages, facial animations, and attachments.</td>
+   <td width="33%">[Automatic Skinning Transfer](../avatar/automatic-skinning-transfer.md) transfers or generates skinning data to layered accessories and facial rigid accessories. This allows the accessories to deform along the character it's attached to without you having to skin the accessory itself.</td>
+ </tr>
+</tbody>
+</table>
+
+<table>
+<thead>
+ <tr>
+   <th width="33%">**Accessory Fitting Tool**</th>
+   <th width="33%">**Animation Editor**</th>
+   <th width="33%">**Adaptive Animation**</th>
+ </tr>
+</thead>
+<tbody>
+ <tr>
+   <td width="33%">The [Accessory Fitting Tool](../avatar/accessory-fitting-tool.md) (AFT) lets you test your custom models on multiple combinations of character bodies, animations, and accessories before generating the final `Class.Accessory` object.</td>
+   <td width="33%">The [Animation Editor](../animation/editor.md) lets you import, design, and publish custom emotes for your rigging armatures.</td>
+   <td width="33%">The [Adaptive Animation](../characters/adaptive-animation.md) system lets you customize, modify, and map the internal joints of your custom avatar characters for universal animation support across bodies with unique body types, rigs, and proportions.</td>
+ </tr>
+</tbody>
+</table>
+
+In addition, you can create and configure experiences to let players create avatar assets during runtime, either from base models that you provide or their own photos and prompts.
+
+<table>
+<thead>
+ <tr>
+   <th width="50%">**Avatar in-experience creation**</th>
+   <th width="50%">**Photo-to-Avatar generation**</th>
+ </tr>
+</thead>
+<tbody>
+ <tr>
+   <td width="50%">[Avatar in-experience creation](../avatar/in-experience-creation.md) lets players create, customize, and purchase avatar bodies in real time. When purchased, these custom bodies save directly to the player's Roblox inventory, allowing them to equip and wear the custom avatars in other experiences.</td>
+   <td width="50%">[Photo-to-Avatar generation](../avatar/avatar-generation.md) lets players generate a fully functional avatar character using a photo and a text prompt.</td>
+ </tr>
+</tbody>
+</table>
diff --git a/content/en-us/avatar/index.md b/content/en-us/avatar/index.md
diff --git a/content/en-us/projects/update-games.md b/content/en-us/projects/update-games.md
diff --git a/content/en-us/reference/cloud/openapi.json b/content/en-us/reference/cloud/openapi.json
diff --git a/content/en-us/workspace/streaming/techniques.md b/content/en-us/workspace/streaming/techniques.md
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
diff --git a/tools/checks/utils/allowedHttpLinks.txt b/tools/checks/utils/allowedHttpLinks.txt
diff --git a/tools/checks/utils/markdownlint.ts b/tools/checks/utils/markdownlint.ts
