Skip to content

Commit 55cf353

Browse files
update Open Source Docs from Roblox internal teams
1 parent a09f6e0 commit 55cf353

File tree

12 files changed

+574
-515
lines changed

12 files changed

+574
-515
lines changed

content/en-us/assets/publishing/cross-platform/TextScaled-Sizing.png

Lines changed: 0 additions & 3 deletions
This file was deleted.

content/en-us/makeup/import.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,8 @@ hideBreadcrumbs: true
88
Makeup is currently in beta and is not yet available for sale or implementation in-experience. The information provided is subject to change and is intended to prepare creators for the final release. For the latest news and updates, see the [DevForum announcement](https://devforum.roblox.com/t/studio-beta-introducing-avatar-makeup/3973764).
99
</Alert>
1010

11+
## Import into Studio
12+
1113
If you are following the [common practice](./index.md#creation-process) of authoring makeup changes in a third-party tool, use the following import instructions to get your custom makeup textures into Roblox Studio:
1214

1315
<Alert severity = 'info'>
@@ -37,3 +39,27 @@ These instructions apply specifically to the Makeup test place, available in the
3739
<img src="../assets/makeup/Makeup-Character-Folders.png" />
3840

3941
7. Press **Play** to playtest and verify that the character has the new makeup applied.
42+
43+
## Test with Avatar Setup
44+
45+
<iframe width="800" height="450" src="https://www.youtube-nocookie.com/embed/rHkHXl4Qkpg" title="YouTube video player" frameborder="0" allow="accelerometer; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
46+
<br />
47+
48+
You can also use the Avatar Setup tool to preview makeup assets without playtesting.
49+
50+
1. Open the Avatar Setup tool by navigating to **Avatar** > **Setup**.
51+
2. Select the model you would like to preview your assets on.
52+
3. **For makeup decals,** such as eyes, face, and lips:
53+
1. In the Explorer, select any makeup decal assets you want to add into the Avatar Setup preview.
54+
1. The preview only supports valid makeup decals with a child `Class.WrapTextureTransfer`.
55+
2. In the Avatar Setup panel, click the **+** symbol to add the assets to the Avatar Setup tool.
56+
3. In the new prompt, specify the makeup asset type (eyes, face, lips), for each decal selected.
57+
4. **For makeup meshes**, such as eyebrows and eyelashes:
58+
1. In the Explorer, move the `Class.MeshPart` objects as children within the avatar model in the Explorer, and then clicking the **+** button to add them to Avatar Setup.
59+
5. In the Avatar Setup panel, navigate to the **Face** > **Makeup** tab and validate that your assets were properly imported into the tool.
60+
6. Click on assets to equip them in your preview.
61+
1. Change the order of the assets by dragging their icons on the right side of the preview box.
62+
2. Click **X** to remove them from your avatar preview.
63+
7. To see how makeup animates, navigate to the **Animations** tab, and test various sequences to see what your avatar looks like with the makeup applied.
64+
65+
For the best results during this beta period, use the avatars provided from Roblox in the test place. You may also bring in any other avatar, but the quality of the makeup fit depends on the head's underlying cage, which may result in varied appearance if not properly aligned.

content/en-us/production/promotion/ads-manager.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -121,15 +121,15 @@ An **ad campaign** is a coordinated series of ads designed to achieve a specific
121121
Before launching your campaign and submitting it to Roblox for moderation and approval, you'll be able to [review the campaign details](#review-the-campaign).
122122

123123
<Alert severity="warning">
124-
Advertising paid experiences and restricted (17+) experiences is only available with sponsored and search ads.
124+
Advertising paid experiences and Restricted (18+) experiences is only available with sponsored and search ads.
125125
</Alert>
126126

127127
### Define the campaign
128128

129129
Campaigns are defined by their **campaign objective** and **budgeting and scheduling** parameters. Campaign objectives are divided into three categories:
130130

131131
- **Awareness**: Campaigns focused on awareness show image or autoplaying video ads to increase awareness of your brand within an experience.
132-
- **Visits**: Campaigns focused on visits aim to attract people to your experience on Roblox. These can take the form of either **sponsored experiences** on the Home page or **immersive ads** placed within portal ad units in experiences. You can't promote 17+ experiences using the **Visits** objective.
132+
- **Visits**: Campaigns focused on visits aim to attract people to your experience on Roblox. These can take the form of either **sponsored experiences** on the Home page or **immersive ads** placed within portal ad units in experiences. You can't promote experiences with Restricted content maturity labels using the **Visits** objective.
133133
- **Video Views**: Campaigns focused on 15-second click-to-play video views to engage audiences in-experience.
134134

135135
Budgeting and scheduling parameters control campaign spending and duration. There are two different types of budgets:
@@ -190,7 +190,7 @@ To define an ad set:
190190
<tr>
191191
<td>**Full Inventory**</td>
192192
<td>Minimal, mild, moderate, restricted</td>
193-
<td>13+, except in 17+ experiences where users must be 17+ and ID-verified</td>
193+
<td>13+, except in Restricted experiences where users must be 18+ and age-verified</td>
194194
</tr>
195195
<tr>
196196
<td>**Standard Inventory**</td>

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

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -25,14 +25,14 @@ If an experience does not have accurate or all content maturity information, Rob
2525
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">
28-
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.
28+
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 age-verified players who are at least 18 years old. You must not add any restricted content to your experience before adding content maturity information.
2929
</Alert>
3030

3131
As you are completing the questionnaire, **base your answers on the most mature or extreme content players can encounter within your experience**. You can retake the questionnaire and generate a new maturity label at any time to accurately reflect the content in your experience. For restricted experiences, you can't change the maturity, but you can update its content descriptors.
3232

3333
To generate content maturity information:
3434

35-
1. **(Optional)** If you want your experience to include restricted content, confirm you are at least 17 years old by [verifying your account](../../production/publishing/account-verification.md) so the questionnaire can ask questions to generate the Restricted maturity label.
35+
1. **(Optional)** If you want your experience to include restricted content, confirm you are at least 18 years old by [verifying your account](../../production/publishing/account-verification.md) so the questionnaire can ask questions to generate the Restricted maturity label.
3636
1. Navigate to the [Creator Dashboard](https://create.roblox.com/dashboard/creations) and click on the thumbnail of the experience you want to generate content maturity information for. The experience's **Overview** page displays.
3737
1. In the left-hand navigation, navigate to the **Audience** section, then select **Maturity & Compliance**.
3838
1. If you've never taken the questionnaire before, read the notes and details, then click **Start** to proceed. If you've previously completed the questionnaire, the **Questionnaire Completed** page displays, but you can click the **Restart** button to start over.
@@ -42,7 +42,7 @@ To generate content maturity information:
4242
Please review your experience and confirm that your answers accurately reflect the content of your experience. If you intentionally misrepresent your experience, you may be subject to [moderation consequences](#content-maturity-moderation).
4343
</Alert>
4444

45-
1. If you need to modify a previous answer, click the **Edit** button, otherwise click the **Submit** button to immediately publish the content maturity information to the experience's main page. If your experience receives a Restricted maturity label, servers running the experience restart to remove all players except those ID-verified as 17+, and Studio removes all creators from any active [collaboration](../../projects/collaboration.md) session except those ID-verified as 17+.
45+
1. If you need to modify a previous answer, click the **Edit** button, otherwise click the **Submit** button to immediately publish the content maturity information to the experience's main page. If your experience receives a Restricted maturity label, servers running the experience restart to remove all players except those age-verified as 18+, and Studio removes all creators from any active [collaboration](../../projects/collaboration.md) session except those age-verified as 18+.
4646

4747
As long as your experience doesn't have a Restricted maturity label, if you believe that your content maturity information doesn't match your intended audience, you can update the content in your experience so that your experience is appropriate for your target audience, then resubmit the questionnaire. To learn how you can dynamically adjust the content of your experience for different audiences, see the `Class.PolicyService` API reference.
4848

@@ -119,7 +119,7 @@ If your experience contains violence, you must specify the violence's maximum le
119119
</tr>
120120
<tr>
121121
<td>**Restricted**</td>
122-
<td>Graphic and realistic-looking depictions of violence and/or death that do not violate the [Restricted Content Policy](https://en.help.roblox.com/hc/en-us/articles/15869919570708-Roblox-17-Policy-Standards), such as non-real world beheadings/decapitation, impalement, hangings, dismemberment, mutilation, severed/severing body parts, presence of organs, maiming, disfiguration, and electrocution.<br></br><br></br>**Experiences with strong violence are only available to ID-verified players that are at least 17 years old.**</td>
122+
<td>Graphic and realistic-looking depictions of violence and/or death that do not violate the [Restricted Content Policy](https://en.help.roblox.com/hc/en-us/articles/15869919570708-Roblox-17-Policy-Standards), such as non-real world beheadings/decapitation, impalement, hangings, dismemberment, mutilation, severed/severing body parts, presence of organs, maiming, disfiguration, and electrocution.<br></br><br></br>**Experiences with strong violence are only available to age-verified players that are at least 18 years old.**</td>
123123
<td></td>
124124
</tr>
125125
</tbody>
@@ -226,7 +226,7 @@ If you answer realistic for question 2, you must also specify the blood's maximu
226226
</tr>
227227
<tr>
228228
<td>**Heavy**</td>
229-
<td>The bloodshed is significant, such as pools of blood, gushing blood, and up-close blood spatter.<br></br><br></br>**Experiences with heavy, realistic blood are only available to ID-verified players that are at least 17 years old.**</td>
229+
<td>The bloodshed is significant, such as pools of blood, gushing blood, and up-close blood spatter.<br></br><br></br>**Experiences with heavy, realistic blood are only available to age-verified players that are at least 18 years old.**</td>
230230
<td></td>
231231
</tr>
232232
</tbody>
@@ -355,10 +355,10 @@ You do **not** need to report depictions of, and/or references to, items or acti
355355

356356
Strong language is vulgar and obscene language that is not used to harass, discriminate, incite violence, or threaten others, or used in a sexual context. For example, strong language content could be depictions of a non-playable character (NPC) using obscenity like the "f-word" that is not directed towards another character or group of people (e.g. "f* off").
357357

358-
If your experience includes strong language, you must disclose it within the Maturity & Compliance Questionnaire. Experiences that include strong language are only available to ID-verified players that are at least 17 years old.
358+
If your experience includes strong language, you must disclose it within the Maturity & Compliance Questionnaire. Experiences that include strong language are only available to age-verified players that are at least 18 years old.
359359

360360
<Alert severity="info">
361-
If you want to enable strong language in player communication aside from content for your 17+ experiences, see [Publish experiences and places](../../production/publishing/publish-experiences-and-places.md#creator-dashboard).
361+
If you want to enable strong language in player communication aside from content for your experiences with Restricted content maturity labels, see [Publish experiences and places](../../production/publishing/publish-experiences-and-places.md#creator-dashboard).
362362
</Alert>
363363

364364
### Romantic themes
@@ -373,13 +373,13 @@ To understand this question, it's important to understand three different defini
373373
- They are designed for one person or for a very small number of people to engage in private activities, such as a bathroom stall, bedroom, or small tent.
374374
- Settings intended for adults are settings that are designed to cater to adult clientele. These settings are often legally restricted to individuals who have reached the age of majority and are otherwise deemed inappropriate or unsuitable for minors, such as clubs or bars.
375375

376-
If your experience includes romantic themes and/or primarily takes place in private spaces or settings intended for adults, you must disclose it within the Maturity & Compliance Questionnaire, and it will only be available to ID-verified players that are at least 17 years old.
376+
If your experience includes romantic themes and/or primarily takes place in private spaces or settings intended for adults, you must disclose it within the Maturity & Compliance Questionnaire, and it will only be available to age-verified players that are at least 18 years old.
377377

378378
### Alcohol
379379

380380
**Question 1: Does this experience depict, reference, or include use of alcohol?**
381381

382-
Alcohol is an intoxicating adult beverage. If your experience includes, depicts, or references alcohol, or depicts adult business and locations that provide or sell alcohol, such as characters drinking alcohol at a bar, you must disclose it within the Maturity & Compliance Questionnaire. Experiences that depict alcohol are only available to ID-verified players that are at least 17 years old.
382+
Alcohol is an intoxicating adult beverage. If your experience includes, depicts, or references alcohol, or depicts adult business and locations that provide or sell alcohol, such as characters drinking alcohol at a bar, you must disclose it within the Maturity & Compliance Questionnaire. Experiences that depict alcohol are only available to age-verified players that are at least 18 years old.
383383

384384
### Social hangout
385385

@@ -396,7 +396,7 @@ If your experience is a social hangout, you must specify if it includes private
396396
- They are designed for activities that are personal and secluded, such as sleeping, changing clothes, or bathing.
397397
- They are designed for one person or for a very small number of people, such as a bathroom stall, bedroom, or small tent.
398398

399-
If your experience is a social hangout that includes private spaces, you must disclose it within the Maturity & Compliance Questionnaire. Social hangouts without private spaces are only available to players that are at least 13 years old, and social hangouts with private spaces are only available to ID-verified players that are at least 17 years old.
399+
If your experience is a social hangout that includes private spaces, you must disclose it within the Maturity & Compliance Questionnaire. Social hangouts without private spaces are only available to players that are at least 13 years old, and social hangouts with private spaces are only available to age-verified players that are at least 18 years old.
400400

401401
### Free-form user creation
402402

content/en-us/production/publishing/publish-experiences-and-places.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -310,10 +310,10 @@ You can enable strong language and relax the text chat filter in your experience
310310

311311
<img src="../../assets/publishing/experiences-places-assets/Maturity-Label-Strong-Language.jpg" width="780" alt="Label indicating the experience contains strong language" />
312312

313-
Regardless of whether or not you activate the toggle, players do not face moderation consequences just for using strong language in chat or voice in 17+ games, but they cannot violate [Community Standards](https://en.help.roblox.com/hc/en-us/articles/203313410#safety) and [Terms of Use](https://www.roblox.com/info/terms). For example, players can type an expletive if they are scared by a monster, but they cannot abuse another player using strong language or otherwise.
313+
Regardless of whether or not you activate the toggle, players do not face moderation consequences just for using strong language in chat or voice in experiences with Restricted content maturity labels, but they cannot violate [Community Standards](https://en.help.roblox.com/hc/en-us/articles/203313410#safety) and [Terms of Use](https://www.roblox.com/info/terms). For example, players can type an expletive if they are scared by a monster, but they cannot abuse another player using strong language or otherwise.
314314

315315
<Alert severity="warning">
316-
In-experience assets and experience metadata cannot contain strong language, even if the toggle is on and your experience is rated 17+. If you include strong language in your assets or experience page, your experience will be moderated.
316+
In-experience assets and experience metadata cannot contain strong language, even if the toggle is on and your experience has a Restricted content maturity label. If you include strong language in your assets or experience page, your experience will be moderated.
317317
</Alert>
318318

319319
To allow strong language between players in text chat within your experience:

content/en-us/projects/cross-platform.md

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -160,15 +160,10 @@ You should also consider the distribution and relative positioning of elements w
160160
Ensure that all text is legible on all screens. Also make sure all UI has [sufficient contrast](../production/publishing/accessibility.md#color-contrast) and that [nothing relies solely on color](../production/publishing/accessibility.md#color-non-reliance) to distinguish an action or outcome.
161161
</Alert>
162162

163-
Even with UI elements [properly sized](#position-and-size) across all device screen sizes, the overall experience should meet [accessibility standards](../production/publishing/accessibility.md) for players with impaired vision or color blindness. Text size can factor heavily into the legibility of text‑based UI, so it's recommended to use the `Class.TextLabel.TextScaled` or `Class.TextButton.TextScaled` properties to automatically scale text up its parent's bounds. You should include a [text size constraint](../ui/size-modifiers.md#text-size) to ensure text doesn't become illegible (too&nbsp;small) or visually too large on larger screens like 4K&nbsp;TVs.
163+
Even with UI elements [properly sized](#position-and-size) across all device screen sizes, the overall experience should meet [accessibility standards](../production/publishing/accessibility.md) for players with impaired vision or color blindness. Text size can factor heavily into the legibility of text‑based UI, so you should include a [text size constraint](../ui/size-modifiers.md#text-size) to ensure text doesn't become illegible (too&nbsp;small) or visually too large on larger screens like 4K&nbsp;TVs.
164164

165165
For more tips on accessibility, see [here](../production/publishing/accessibility.md).
166166

167-
<figure>
168-
<img src="../assets/publishing/cross-platform/TextScaled-Sizing.png" width="840" />
169-
<figcaption>Resized `Class.TextLabel` objects with `Class.TextLabel.TextScaled|TextScaled` property enabled</figcaption>
170-
</figure>
171-
172167
## Final tips & tricks
173168

174169
As you work toward a full cross‑platform experience, consider the following tips and tricks:

0 commit comments

Comments
 (0)