Skip to content

Commit 0b8d164

Browse files
update Open Source Docs from Roblox internal teams
1 parent 1ff59c1 commit 0b8d164

File tree

18 files changed

+524
-50
lines changed

18 files changed

+524
-50
lines changed

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ When ready to export, see [Export requirements](../../art/accessories/export-set
3030

3131
### Body scale
3232

33-
Roblox supports 3 types of body scales: `Classic`, `Normal`, and `Slender`. When designing your accessory, the size of your accessory cannot exceed the following sizes based on body scale and accessory asset type.
33+
Roblox supports 3 types of body scales: `Classic`, `Normal`, and `Slender`. When designing your accessory, the size of your accessory cannot exceed the following sizes based on body scale and accessory asset type. Accessory size is measured based on attachment orientation.
3434

3535
See [Body scale](../accessories/body-scale.md) for more information on the different types of body proportions Roblox supports.
3636

content/en-us/cloud/guides/usage-assets.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -38,16 +38,18 @@ Updating asset metadata using the **Update Asset** endpoint is not subject to th
3838
<td>
3939
<ul>
4040
<li>`.rbxm`</li>
41+
<li>`.rbxmx`</li>
4142
</ul>
4243
</td>
4344
<td>
4445
<ul>
4546
<li>`model/x-rbxm`</li>
47+
<li>`model/x-rbxm`</li>
4648
</ul>
4749
</td>
4850
<td>
4951
<ul>
50-
<li>`.rbxm` files edited outside of [Roblox Studio](../../studio/setup.md) might not upload or function.</li>
52+
<li>`.rbxm` or `.rbxmx` files edited outside of [Roblox Studio](../../studio/setup.md) might not upload or function.</li>
5153
</ul>
5254
</td>
5355
</tr>
@@ -130,6 +132,7 @@ Updating asset metadata using the **Update Asset** endpoint is not subject to th
130132
<li>`.gltf`</li>
131133
<li>`.glb`</li>
132134
<li>`.rbxm`</li>
135+
<li>`.rbxmx`</li>
133136
</ul>
134137
</td>
135138
<td>
@@ -138,6 +141,7 @@ Updating asset metadata using the **Update Asset** endpoint is not subject to th
138141
<li>`model/gltf+json`</li>
139142
<li>`model/gltf-binary`</li>
140143
<li>`model/x-rbxm`</li>
144+
<li>`model/x-rbxm`</li>
141145
</ul>
142146
</td>
143147
<td>
@@ -147,7 +151,7 @@ Updating asset metadata using the **Update Asset** endpoint is not subject to th
147151
<li>Depending on your use-case, consider uploading custom 3D models manually using the [3D Importer](../../art/modeling/3d-importer.md).</li>
148152
<li>The 3D Importer provides a 3D preview, various error-checking, and many customizable import settings.</li>
149153
</ul>
150-
<li>`.rbxm` files edited outside of [Roblox Studio](../../studio/setup.md) might not upload or function.</li>
154+
<li>`.rbxm` or `.rbxmx` files edited outside of [Roblox Studio](../../studio/setup.md) might not upload or function.</li>
151155
</ul>
152156
</td>
153157
</tr>

content/en-us/production/monetization/avatar-creation-token.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Avatar creation token
33
description: Enable users to create and purchase avatar items in experience.
44
---
55

6-
An **avatar creation token** enables developers to allow users to create, purchase, and save avatar items directly from an experience to their platform-level inventory using [in-experience creation](../../avatar/in-experience-creation.md). Experiences that implement in-experience creation APIs, such as `Class.AvatarCreationService.PromptCreateAvatarAsync|PromptCreateAvatarAsync`, must include one or more avatar creation tokens. You can purchase and manage tokens in your experience's [Creator Dashboard](https://create.roblox.com/dashboard/creations).
6+
An **avatar creation token** enables developers to allow users to create, purchase, and save avatar items directly from an experience to their platform-level inventory using [in-experience creation](../../avatar/in-experience-creation.md). Experiences that implement in-experience creation APIs, such as `Class.AvatarCreationService.PromptCreateAvatarAsync|PromptCreateAvatarAsync` and `Class.AvatarCreationService.PromptCreateAvatarAssetAsync|PromptCreateAvatarAssetAsync`, must include one or more avatar creation tokens. You can purchase and manage tokens in your experience's [Creator Dashboard](https://create.roblox.com/dashboard/creations).
77

88
<Alert severity = 'info'>
99
Owners of experiences that incorporate in-experience avatar item creation also benefit from [Marketplace commissions](../../marketplace/marketplace-fees-and-commissions.md#commissions) as both **creator** and **experience owner**.
@@ -31,11 +31,12 @@ To create a token:
3131

3232
1. **Name** - The name of your token. This is not user-facing and can be changed after creation.
3333
2. **Description** - The description of your token. This is not user-facing and can be changed after creation.
34-
3. **Item Type** - At this time, you can only create the **Body** item type in experience. You cannot change this setting after token creation.
34+
3. **Item Type** - The **Body** item type can be used in experience with `Class.AvatarCreationService.PromptCreateAvatarAsync|PromptCreateAvatarAsync` whereas the rest of the item types are meant to be used with
35+
`Class.AvatarCreationService.PromptCreateAvatarAssetAsync|PromptCreateAvatarAssetAsync`. You cannot change this setting after token creation.
3536
4. **Amount Above Price Floor** - Set the price above the Marketplace Price Floor for created items. If you intend to have different price points for items of the same type in your experience, the best way to achieve this is by purchasing multiple tokens. You can modify this field after creation.
3637
5. **Do not price below (Optional)** - Set the minimum price for users to purchase your item. You can modify this field after creation.
3738
<img src="../../assets/monetization/avatar-creation-tokens/Avatar-Creation-Token-Prices.png" width="90%" alt="Price related fields for avatar token creation, including a calculated item price."/>
3839

3940
7. When complete, verify the **Creation Advance** and **Creation Fee** calculations and select **Create Token** to submit your purchase.
40-
8. You can now access the created token in the experience's **avatar creation tokens** settings. To implement `Class.AvatarCreationService.PromptCreateAvatarAsync|PromptCreateAvatarAsync`, you'll need the token ID which you can access by selecting the three dots on the thumbnail and selecting **Copy Token ID**.
41+
8. You can now access the created token in the experience's **avatar creation tokens** settings. To implement `Class.AvatarCreationService.PromptCreateAvatarAsync|PromptCreateAvatarAsync` or `Class.AvatarCreationService.PromptCreateAvatarAssetAsync|PromptCreateAvatarAssetAsync`, you'll need the token ID, which you can access by selecting the three dots on the thumbnail and selecting **Copy Token ID**.
4142
<img src="../../assets/monetization/avatar-creation-tokens/Avatar-Creation-Token-Copy-ID.png" width="30%" alt="Dropdown for created tokens revealing a Copy Token ID option" />

content/en-us/production/promotion/content-maturity.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ If an experience does not have accurate or all content maturity information, Rob
2222

2323
## Generate labels
2424

25-
If your Roblox account is at least 30 days old, you can generate content maturity information by filling out the **Maturity & Compliance Questionnaire**, which contains a set of questions about the type of content players can possibly encounter within your experience, as well as how frequently it occurs. Your answers give Roblox an understanding of the content in your experience and ensure that the experience is available to the appropriate audience.
25+
You can generate content maturity information by filling out the **Maturity & Compliance Questionnaire**, which contains a set of questions about the type of content players can possibly encounter within your experience, as well as how frequently it occurs. Your answers give Roblox an understanding of the content in your experience and ensure that the experience is available to the appropriate audience.
2626

2727
<Alert severity="warning">
2828
If your experience is going to have [Restricted content](https://en.help.roblox.com/hc/articles/15869919570708), it must first receive a Restricted maturity label so that its content is restricted to ID-verified players who are at least 17 years old. You must not add any restricted content to your experience before adding content maturity information.

content/en-us/reference/cloud/cloud.docs.json

Lines changed: 35 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8736,6 +8736,7 @@
87368736
}
87378737
},
87388738
"Place": {
8739+
"required": ["templatePlace"],
87398740
"type": "object",
87408741
"properties": {
87418742
"path": {
@@ -8771,6 +8772,25 @@
87718772
"type": "integer",
87728773
"description": "The maximum number of allowed users in a single server.",
87738774
"format": "int32"
8775+
},
8776+
"root": {
8777+
"readOnly": true,
8778+
"example": true,
8779+
"type": "boolean",
8780+
"description": "Whether this place is its parent universe's root place or not.\nEach universe has exactly one root place."
8781+
},
8782+
"universeRuntimeCreation": {
8783+
"readOnly": true,
8784+
"example": true,
8785+
"type": "boolean",
8786+
"description": "Whether this place was created through in-experience creation.\nIf true, the place was created by calling AssetService::CreatePlaceAsync()\nfrom a script."
8787+
},
8788+
"templatePlace": {
8789+
"writeOnly": true,
8790+
"example": "universes/{universe_id}/places/{place_id}",
8791+
"type": "string",
8792+
"description": "The resource path of the template place used to initialize the place on\ncreation.\nThe newly created place will be a clone of this template.\nA list of the valid template places can be obtained from\nListTemplatePlaces. Format: universes/{universe_id}/places/{place_id}",
8793+
"x-immutable": true
87748794
}
87758795
},
87768796
"description": "Represents a Roblox place.",
@@ -9060,6 +9080,7 @@
90609080
"description": "Restore the data store"
90619081
},
90629082
"Universe": {
9083+
"required": ["templateRootPlace"],
90639084
"type": "object",
90649085
"properties": {
90659086
"path": {
@@ -9099,9 +9120,9 @@
90999120
"description": "The universe is user-owned."
91009121
},
91019122
"group": {
9102-
"readOnly": true,
91039123
"type": "string",
9104-
"description": "The universe is group-owned."
9124+
"description": "The universe is group-owned.",
9125+
"x-immutable": true
91059126
},
91069127
"visibility": {
91079128
"readOnly": true,
@@ -9187,6 +9208,18 @@
91879208
"example": true,
91889209
"type": "boolean",
91899210
"description": "Whether or not players can join the Experience via VR."
9211+
},
9212+
"rootPlace": {
9213+
"readOnly": true,
9214+
"type": "string",
9215+
"description": "The resource path of the root place of this universe\nFormat: universes/{universe_id}/places/{place_id}"
9216+
},
9217+
"templateRootPlace": {
9218+
"writeOnly": true,
9219+
"example": "universes/{universe_id}/places/{place_id}",
9220+
"type": "string",
9221+
"description": "The resource path of the template place, used for CreateUniverse.\nThe root place of the newly-created universe will be a clone of this\ntemplate. A list of the valid template places can be obtained from\nListTemplatePlaces. Format: universes/{universe_id}/places/{place_id}",
9222+
"x-immutable": true
91909223
}
91919224
},
91929225
"description": "Represents a Roblox experience.",

0 commit comments

Comments
 (0)