Skip to content

Commit d55a2c0

Browse files
update Open Source Docs from Roblox internal teams
1 parent 67898b9 commit d55a2c0

File tree

4 files changed

+31
-14
lines changed

4 files changed

+31
-14
lines changed

content/en-us/parts/models.md

Lines changed: 15 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,9 @@ title: Models
33
description: Models are container objects for geometric groupings like parts, Motor6D objects, and other models.
44
---
55

6-
**Models** are containers for physical objects, such as parts, welds, and joints that you can use to organize your workspace and group your assets. While models can often contain connected parts, known as an [assembly](../physics/assemblies.md), models can contain any number of individual parts and other objects, such as scripts, and attachments.
6+
**Models** are containers for physical objects that you can use to organize your workspace and group your assets, such as parts, welds, or joints. While models often contain connected parts known as an [assembly](../physics/assemblies.md), they can also contain any number of individual parts or objects, such as scripts, attachments, or other models.
77

8-
Characters, such as avatars or NPCs, are a single `Class.Model` containing the appropriate humanoid parts, joints, and additional components:
8+
To demonstrate, avatar characters are a single `Class.Model` containing the appropriate humanoid parts, joints, and scripts necessary for runtime behavior:
99

1010
<GridContainer numColumns="2">
1111
<figure>
@@ -20,7 +20,14 @@ Characters, such as avatars or NPCs, are a single `Class.Model` containing the a
2020

2121
## Create models
2222

23-
When you **group** objects together, they automatically become a `Class.Model` object. However, you can also insert an empty `Class.Model` object into the Workspace, then manually add child objects to the model.
23+
<Alert severity="warning">
24+
You can create models using any open use or restricted asset, but any restricted assets that you don't have [explicit permission](../projects/assets/privacy.md#view-permissions) to use are **not** visible or audible at runtime unless the experience itself has permission to use those assets.
25+
</Alert>
26+
27+
There are two ways to create models:
28+
29+
- Group objects together to automatically form a `Class.Model` object.
30+
- Insert an empty `Class.Model` object into the Workspace, then manually add child objects to the model.
2431

2532
To create a model using the grouping method:
2633

@@ -129,13 +136,15 @@ To upload a model you made in Studio:
129136

130137
## Distribute models
131138

132-
You can distribute models to the [Creator Store](../production/creator-store.md) for other creators to use within their own experiences as long as each model only references:
139+
You can distribute models with less than 15,000 descendants to the [Creator Store](../production/creator-store.md) for other creators to use within their own experiences as long as each model only references:
133140

134141
- Open use assets.
135142
- Restricted assets that you created, excluding audio and video.
136-
- Free assets from the Creator Store, including audio and video.
143+
- Audio and video assets from the Creator Store.
137144

138-
If you want to distribute a model with a child audio or video asset that you created, you must distribute the audio or video asset on the Creator Store **_before_** making them a child of the model in order for the audio or video to be audible and visible at runtime.
145+
<Alert severity="warning">
146+
If you want to distribute a model with a child audio asset that you created, you must distribute the audio asset on the Creator Store **_before_** making it a child of the model in order for the audio to be audible at runtime.
147+
</Alert>
139148

140149
As with any asset, all models must adhere to the [Community Rules](https://en.help.roblox.com/hc/articles/203313410), [Terms of Use](https://en.help.roblox.com/hc/articles/115004647846), the [DMCA Guidelines](../production/publishing/dmca-guidelines.md) regarding copyright and Creator Store [asset moderation](../production/creator-store.md#asset-moderation) rules. When creating models for the Creator Store:
141150

content/en-us/production/creator-store.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,15 +5,15 @@ description: The Creator Store is where you can find all assets for public use i
55

66
The **Creator Store** features assets made by Roblox and the Roblox community for the community to use within their experiences, including models, images, meshes, audio, fonts, videos, and plugins.
77

8-
You can create and distribute models, images, meshes, plugins, and audio sound effects under 10 seconds to the Creator Store for others to use as long as you are the original creator, and it adheres to Roblox's [Community Rules][CommunityRulesURL] and [Terms&nbsp;of&nbsp;Use][TermsUseURL]. If you have a [seller account](./sell-on-creator-store.md), you can also sell your plugins to other creators.
8+
You can create and distribute models, images, meshes, plugins, and audio sound effects under 10 seconds to the Creator Store for others to use as long as you are the original creator, and it adheres to Roblox's [Community Rules][CommunityRulesURL] and [Terms of Use][TermsUseURL]. If you have a [seller account](./sell-on-creator-store.md), you can also sell your plugins to other creators.
99

1010
<Alert severity="warning">
1111
To maintain community safety, Roblox may terminate accounts that publish spam or assets with malicious or obfuscated code.
1212
</Alert>
1313

1414
## Asset moderation
1515

16-
Roblox performs both human and automated asset moderation on a proactive and reactive basis to ensure assets adhere to the [Community Rules][CommunityRulesURL], [Terms&nbsp;of&nbsp;Use][TermsUseURL], and [Digital Millennium Copyright Act](../production/publishing/dmca-guidelines.md) (DMCA). If any asset violates these moderation policies, such as including discriminatory or adult content, the moderation team flags and removes the asset to protect users from harmful or non-compliant content. This process generally happens within a few hours after you upload the asset.
16+
Roblox performs both human and automated asset moderation on a proactive and reactive basis to ensure assets adhere to the [Community Rules][CommunityRulesURL], [Terms of Use][TermsUseURL], and [Digital Millennium Copyright Act](../production/publishing/dmca-guidelines.md) (DMCA). If any asset violates these moderation policies, such as including discriminatory or adult content, the moderation team flags and removes the asset to protect users from harmful or non-compliant content. This process generally happens within a few hours after you upload the asset.
1717

1818
In addition, the Creator Store **restricts** use of the following practices to ensure asset safety:
1919

@@ -102,7 +102,7 @@ For information on how to verify your account either through a government-issued
102102

103103
## Distribute and sell assets
104104

105-
Distributing to the Creator Store is the only way to make your assets publicly available to all users to use within their own experiences in Studio. You can distribute any mesh or image that you have imported through the [Asset Manager](../projects/assets/manager.md), or any [model](../parts/models.md), [plugin](../studio/plugins.md), or [audio asset](../sound/assets.md) sound effect under 10 seconds that you have uploaded to your inventory.
105+
Distributing to the Creator Store is the only way to make your assets publicly available to all users to use within their own experiences in Studio. You can distribute any mesh or image that you have imported through the [Asset Manager](../projects/assets/manager.md), or any [model](../parts/models.md), [plugin](../studio/plugins.md), or [audio asset](../audio/assets.md) sound effect under 10 seconds that you have uploaded to your inventory.
106106

107107
Every asset that you import must adhere to the [Community Rules][CommunityRulesURL] and [Terms&nbsp;of&nbsp;Use][TermsUseURL], and respect the [DMCA Guidelines](../production/publishing/dmca-guidelines.md) regarding copyright. In addition, there are limits on the number of assets you can distribute per 30 days, depending on whether you've [verified your account](../production/publishing/account-verification.md):
108108

content/en-us/production/monetization/commerce-products.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -398,7 +398,7 @@ As with other product information synced from Shopify, any updates to the produc
398398

399399
### Additional information
400400

401-
The **Additional information** section displays supplementary details about your product using collapsible accordions. You can add **up to five** accordion sections for different topics, such as "Materials," "Care Instructions," or "Size Chart."
401+
The **Additional information** section displays supplementary details about your product using collapsible accordions. You can add **up to five** accordion sections for different topics, such as "Materials," "Care Instructions," or "Sizing".
402402

403403
This is an optional feature and is populated using Shopify product metafields. To create a metafield accordion in Shopify:
404404

@@ -407,10 +407,12 @@ This is an optional feature and is populated using Shopify product metafields. T
407407
- Set the following fields:
408408

409409
- **Name** — The value in this field displays as the header for that accordion.
410-
- **Value**The user-facing content within the expanded accordion.
410+
- **Type**Only "Multi-line text" is supported.
411411

412412
<img src="../../assets/monetization/commerce-products/Commerce-Product-Metafield-Example.png" width="60%" />
413413

414+
- Then set the **Value** of the metafield for each desired product. This value displays as the content for that accordion.
415+
414416
Like other product content synced from Shopify, any new or updated information in these metafields is subject to the [moderation process for catalog items](#modify-catalog-items). This page will display previously approved content until the new information is approved.
415417

416418
### Virtual benefit with purchase

content/en-us/projects/assets/packages.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,11 +17,15 @@ The most efficient workflow is to [create a package](#create-packages), [share i
1717

1818
## Create Packages
1919

20+
<Alert severity="warning">
21+
If you want to create a package with restricted assets that you don't have [explicit permission](../../projects/assets/privacy.md#view-permissions) to use, you can still create the package but those specific restricted assets will **not** be visible or audible at runtime unless the experience itself has permission to use those assets.
22+
</Alert>
23+
2024
You can create a package from any single object or any single parent and children branch of objects. If you want to create a package for a single object, add it to a `Class.Model` grouping first so that you can add, remove, or scale child objects within the package later without breaking the package.
2125

2226
To create a package:
2327

24-
1. In the **Explorer** window or 3D viewport, right-click the object you want to turn into a package, then in contextual menu, select **Convert to Package**.
28+
1. In the **Explorer** window or 3D viewport, right-click the object(s) you want to turn into a package, then in contextual menu, select **Convert to Package**.
2529
1. In the new window, fill in the package details. In particular, if you're working in a [group](../../projects/groups.md), set **Ownership** to the appropriate group in which you have permission to create/edit group experiences.
2630

2731
<Alert severity="warning">
@@ -131,11 +135,13 @@ Automatic updating does not apply to [modified](#modifying-packages) package cop
131135

132136
You can grant permission to friends, experiences, groups, or specific group user roles so that they can freely use your packages in their creations. For more information on asset access, see [Asset privacy](privacy.md).
133137

138+
<Alert severity="warning">
139+
If you share a package with restricted assets that you don't have [explicit permission](../../projects/assets/privacy.md#view-permissions) to use, you can still share the package but those specific restricted assets will **not** be visible or audible at runtime unless the friend, experience, or group has permission to use those assets.
140+
</Alert>
141+
134142
<Tabs>
135143
<TabItem key = "1" label="To collaborators">
136144

137-
In order to share packages with other collaborators, the package must only contain references to assetIDs that you created or have explicit permission to use.
138-
139145
To change package permissions for a collaborator, such as a friend or group:
140146

141147
1. In the **Explorer** window, **Toolbox**, or **Asset Manager**, right-click the desired package and select **Package Details**.

0 commit comments

Comments
 (0)