Skip to content

Commit 4821d1f

Browse files
update Open Source Docs from Roblox internal teams
1 parent 0a2389c commit 4821d1f

32 files changed

+612
-264
lines changed

content/common/navigation/assets.yaml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,6 @@ navigation:
2121
path: /projects/assets/privacy
2222
- title: Creator Store
2323
path: /production/creator-store
24-
- title: Monetize models and plugins
25-
path: /production/sell-on-creator-store
2624

2725
- heading: Creation tools
2826
- title: Studio

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

Lines changed: 30 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,59 +1,67 @@
11
---
2-
title: Custom meshes
3-
description: External modeling is the use of a third-party modeling software to create custom meshes.
2+
title: Custom 3D assets
3+
description: External modeling is the use of a third-party modeling software to create custom 3D assets.
44
---
55

6-
**Custom meshes** are 3D objects that enhance the visual appeal and uniqueness of your environment and characters. In Studio, custom meshes are represented as `Class.MeshPart` objects, and you can use them to create assets like characters, clothing, environment props, and cosmetics. To create a custom mesh, you must use a third-party modeling application, such as [Blender](https://www.blender.org) or [Maya](https://www.autodesk.com/products/maya/overview), to design and model the asset before importing the 3D object into Studio.
6+
Meshes are **custom 3D assets** that let you personalize and stylize your game's environment and characters. Unlike parts, which you can directly create in Studio, you need to use a third-party modeling application like [Blender](https://www.blender.org) or [Maya](https://www.autodesk.com/products/maya/overview) to design and model meshes, then import them into Studio. Studio represents imported meshes as `Class.MeshPart` objects, descendants of the `Class.BasePart` class.
77

8-
Many 3D assets, like characters, are made up of several meshes and are represented in Studio as a single `Class.Model`. See [Models](../../parts/models.md) for more information.
8+
<Alert severity = 'info'>
9+
Many 3D assets are made up of several meshes that are parented to a single `Class.Model` object.
10+
</Alert>
911

10-
In Roblox, custom 3D assets generally fall under three types of applications:
12+
Meshes typically fall into one of three types of application in games:
1113

12-
- **Generic meshes or models** you can use for environmental props, buildings, characters, and decoration within an experience.
13-
- **Avatar models** for users or non-player characters (NPCs).
14-
- **Accessory models** that character models can equip and wear, like clothing and cosmetics.
14+
- Meshes for **decorating your game's environment**, such as plants, buildings, and vehicles.
15+
- Meshes for **individual body parts** for avatars or non-player characters (NPCs).
16+
- Meshes for **cosmetic accessories** that characters can equip and wear, such as clothing, props, and weapons.
1517

16-
If you meet certain account requirements, you can publish and sell your avatar-ready models on the Marketplace and earn a commission for each sale. For more information, see [Roblox avatars](../../avatar/index.md).
18+
Each mesh type must meet specifications according to how you are going to use the mesh on the platform. For example, while all meshes must meet general mesh specifications, meshes for characters must also meet character specifications that account for rigging and skinning data. For a full list of specifications for different types of meshes, see [Resources](#resources).
19+
20+
In addition, if you meet certain account requirements, you can publish and sell collections of meshes that are parented to a single `Class.Model` object. For example, you can publish avatar-ready models on the Marketplace and earn a commission for each sale, or you can sell models on the Creator Store and earn 100% of net proceeds on each transaction.
21+
22+
<Alert severity = 'info'>
23+
For more information on monetizing meshes, see [Monetize avatar items](../../monetize-avatar.md) and [Creator Store - Distribute and sell assets](../../production/creator-store.md#distribute-and-sell-assets).
24+
</Alert>
1725

1826
<GridContainer numColumns="3">
1927
<figure>
20-
<img src="../../assets/modeling/surface-appearance/Layered-Clothing-Example.png" alt="A Roblox avatar wearing a glossy puffy jacket and jeans"/>
21-
<figcaption>Create custom accessories, clothing, and characters that anyone can wear and use</figcaption>
28+
<img src="../../assets/modeling/meshes/Mystery-of-Duvall-Example.png" alt="A cluttered interior room with a candle in the forefront and spooky interior lighting from the Mystery of Duvall Drive experience"/>
29+
<figcaption>Use custom meshes and models to give your environments ambiance and depth</figcaption>
2230
</figure>
2331
<figure>
2432
<img src="../../assets/modeling/meshes/Beyond-The-Dark-Example.png" alt="A floating alien creature in space, from the Beyond The Dark experience"/>
2533
<figcaption>Design a custom character unique to your experience</figcaption>
2634
</figure>
2735
<figure>
28-
<img src="../../assets/modeling/meshes/Mystery-of-Duvall-Example.png" alt="A cluttered interior room with a candle in the forefront and spooky interior lighting from the Mystery of Duvall Drive experience"/>
29-
<figcaption>Use custom meshes and models to give your environments ambiance and depth</figcaption>
36+
<img src="../../assets/modeling/surface-appearance/Layered-Clothing-Example.png" alt="A Roblox avatar wearing a glossy puffy jacket and jeans"/>
37+
<figcaption>Create custom accessories, clothing, and characters that anyone can wear and use</figcaption>
3038
</figure>
3139
</GridContainer>
3240

33-
## Supported meshes
41+
## Supported 3D assets
3442

35-
Roblox supports many types of custom meshes, as long as they adhere to the [general mesh specifications](../../art/modeling/specifications.md). A basic custom mesh consists of at least one mesh object and one texture:
43+
Roblox supports many types of custom 3D assets, as long as they adhere to the [general mesh specifications](../../art/modeling/specifications.md). A basic custom 3D asset consists of at least one `Class.MeshPart` object and one texture:
3644

3745
<GridContainer numColumns="3">
3846
<figure>
3947
<img src="../../assets/art/Basic-Mesh-Example.png" alt="A plain white tree mesh without a texture"/>
40-
<figcaption>A mesh object sets the shape and geometry of the 3D object</figcaption>
48+
<figcaption>A `Class.MeshPart` object sets the shape and geometry of the 3D asset</figcaption>
4149
</figure>
4250
<figure>
4351
<img src="../../assets/art/Basic-Texture-Example.png" alt="Various color maps used to apply textures to the tree bark, and inner, middle, and outer leaves"/>
4452
<figcaption>A texture image map applies a surface appearance and color</figcaption>
4553
</figure>
4654
<figure>
4755
<img src="../../assets/art/Basic-Mesh-Combined-Example.png" alt="The tree mesh and the image maps combined to create a single tree"/>
48-
<figcaption>The mesh and texture combine to make a unique custom 3D object</figcaption>
56+
<figcaption>The mesh and texture combine to make a unique custom 3D asset</figcaption>
4957
</figure>
5058
</GridContainer>
5159

52-
Studio also supports meshes that include [rigging and skinning](#rigging-and-skinning) data, [PBR textures](#pbr-textures), and other [Studio-related objects](#studio-related-objects) like cage meshes and attachments. Many of these various components are required if you are creating avatar character models or accessories.
60+
Studio also supports custom 3D assets that include [rigging and skinning](#rigging-and-skinning) data, [PBR textures](#pbr-textures), and other [Studio-related objects](#studio-related-objects) like cage meshes and attachments. Many of these various components are required if you are creating avatar character models or accessories.
5361

5462
### Rigging and skinning
5563

56-
A **rigged mesh** is a mesh with an internal poseable skeleton rig and bone structure. Rigged meshes allow mesh surfaces to rotate and move where internal bone joints are placed within a model, such as a character's knee or elbow. Skinning a rigged mesh allows the mesh object to bend organically, imitating the natural way joints would move in real life.
64+
A **rigged mesh** is a `Class.MeshPart` object with an internal poseable skeleton rig and bone structure. Rigged meshes allow mesh surfaces to rotate and move where internal bone joints are placed within a model, such as a character's knee or elbow. Skinning a rigged mesh allows the mesh to bend organically, imitating the natural way joints would move in real life.
5765

5866
<GridContainer numColumns="2">
5967
<figure>
@@ -70,7 +78,7 @@ For more information on rigging and skinning, see [Rigging and skinning](../../a
7078

7179
### PBR textures
7280

73-
**Physically-Based rendering** (PBR) textures allow you to represent realistic shading and lighting by using multiple types of texture images, or **maps**, on a single object. Combining multiple texture maps can more accurately simulate color, roughness, and reflectivity in any lighting environment and can enhance the visual elements of your assets and environment.
81+
**Physically-Based rendering** (PBR) textures allow you to represent realistic shading and lighting by using multiple types of texture images, or **maps**, on a single 3D asset. Combining multiple texture maps can more accurately simulate color, roughness, and reflectivity in any lighting environment, and can enhance the visual elements of your assets and environment.
7482

7583
<GridContainer numColumns="2">
7684
<img src="../../assets/modeling/surface-appearance/SurfaceAppearance-Example-1.jpg" alt="A realistic looking leafy bush with shadows and depth."/>
@@ -83,7 +91,7 @@ For more information on PBR textures, see [PBR textures](../../art/modeling/surf
8391

8492
Studio automatically converts certain types of objects found in 3D modeling files as specific workspace objects in the experience. These are typically used when creating a character or accessory, and configuring these in your modeling software can sometimes be the primary way of correctly setting up these Studio objects.
8593

86-
The following objects are automatically created in Studio if they are detected by the importer:
94+
The following objects are automatically created in Studio if they are detected by the 3D Importer:
8795

8896
- `Class.Attachment` - Created when Studio detects mesh objects that include `_Att` at the end of their name.
8997
- `Class.WrapTarget` - Created when Studio detects mesh objects that include `_OuterCage` at the end of their name.
@@ -92,7 +100,7 @@ The following objects are automatically created in Studio if they are detected b
92100

93101
## Resources
94102

95-
There are a variety of resources available for creators of all backgrounds to get started with custom meshes.
103+
There are a variety of resources available for creators of all backgrounds to get started with custom 3D assets.
96104

97105
If you are interested in specific avatar creation topics, use the following table to find guides and resources that best match your needs:
98106

content/en-us/assets.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,15 @@ export const sections = [
3838
{ text: "Moderation", href: "./projects/assets#asset-moderation" },
3939
{ text: "Manage and publish", href: "/projects/assets/manager" },
4040
]
41+
},
42+
{
43+
title: "Sell on the Creator Store",
44+
description: "The Creator Store is full of assets made by the community for people to use within their experiences. You can become a seller on the Creator Store to monetize any models or plugins that you create for United States Dollars (USD). Creator Store's real-world pricing model allows us to give 100% of net proceeds on transactions to creators, bypassing platform fees and DevEx rates.",
45+
image: "./assets/landing/creator-store.png",
46+
links: [
47+
{ text: "Creator Store", href: "./production/creator-store" },
48+
{ text: "Monetize models and plugins", href: "./production/creator-store#distribute-and-sell-assets" },
49+
]
4150
}
4251
]
4352
}
Lines changed: 3 additions & 0 deletions
Loading
Lines changed: 3 additions & 0 deletions
Loading
Lines changed: 3 additions & 0 deletions
Loading
Lines changed: 3 additions & 0 deletions
Loading
Lines changed: 3 additions & 0 deletions
Loading
Lines changed: 3 additions & 0 deletions
Loading
Lines changed: 3 additions & 0 deletions
Loading

0 commit comments

Comments
 (0)