Skip to content

Commit d597e42

Browse files
update Open Source Docs from Roblox internal teams
1 parent d825376 commit d597e42

File tree

9 files changed

+529
-837
lines changed

9 files changed

+529
-837
lines changed
Lines changed: 3 additions & 0 deletions
Loading
Lines changed: 3 additions & 0 deletions
Loading

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

Lines changed: 39 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,44 @@ To grant a creator permission to use a private asset in any of these scenarios:
6565

6666
1. At the bottom of the page, click the **Save Changes** button.
6767

68+
### To Groups
69+
70+
To grant a group permission to use one of your private assets, you must have [Edit all group experiences](../../projects/groups.md#roles-and-permissions) permission in that group. After you grant the group permission, group members gain permission to use the asset only in experiences owned by that group (see [Granting Permission to Experiences](#to-experiences)).
71+
72+
Group members can insert the asset into experiences from the **Creations** tab of the [Toolbox](../../projects/assets/toolbox.md). Use the dropdown to select the appropriate **Group** category. You can also use the private asset's ID in the [Properties](../../studio/properties.md) window.
73+
74+
<GridContainer numColumns="2">
75+
<figure>
76+
<img src="../../assets/studio/toolbox/Creations-Group-Audio.png" alt="A close up view of the Toolbox with the Creations tab highlighted and Group Audio category selected." width="100%" />
77+
<figcaption>Inserting a private asset through the Toolbox</figcaption>
78+
</figure>
79+
<figure>
80+
<img src="../../assets/studio/properties/Private-SoundID.jpg" alt="A close up view of the Properties window with the SoundID property highlighted." width="100%" />
81+
<figcaption>Inserting a private asset in the Properties window</figcaption>
82+
</figure>
83+
</GridContainer>
84+
85+
If group members want to use the private asset in a script, or if they want to save or publish a template place that they were editing that includes the private asset, they must also give the [experience](#to-experiences) itself permission to use it. If a group member doesn't complete this step, the asset isn't visible or audible during runtime, and an error message displays in the **Output** window.
86+
87+
<img src="../../assets/studio/general/Output-Window-Error.png" alt="An example of an error that displays in the Output Window when a creator or experience doesn't have permission to use a private asset." width="100%" />
88+
89+
To grant a group permission to use a private asset in any of these scenarios:
90+
91+
1. Navigate to the [Creator Dashboard](https://create.roblox.com/dashboard/creations).
92+
1. Select **Development Items**, then click either **Audio** or **Videos**.
93+
94+
<img src="../../assets/creator-dashboard/Development-Items-Asset-Privacy.png" alt="A close up view of tabs on the Creator Dashboard. The Development Items tab and its Audio and Videos subtabs are highlighted." width="780"/>
95+
96+
1. Select the asset you want the group to have permission to use in any of their experiences and **Permissions**.
97+
98+
<img src="../../assets/creator-dashboard/Asset-Settings-Permissions-Button.png" alt="A close up view of a Swamp SFX asset's left-hand menu. The Permissions navigation menu item is highlighted." width="330" />
99+
100+
1. Under **Collaborator Access** &rarr; **Creators**, search for the group that you want to grant permission to. You can also see and remove existing groups.
101+
102+
<img src="../../assets/creator-dashboard/Asset-Settings-Permissions-Groups.png" alt="A close up view of the Creators Collaborator Access settings. The search friends bar is highlighted." width="780" />
103+
104+
1. Click the **Save Changes** button.
105+
68106
### To Experiences
69107

70108
<Alert severity="error">
@@ -170,7 +208,7 @@ To revoke permission for a creator to use a private asset in any additional expe
170208
<img src="../../assets/creator-dashboard/Development-Items-Asset-Privacy.png" alt="A close up view of tabs on the Creator Dashboard. The Development Items tab and its Audio and Videos subtabs are highlighted." width="780"/>
171209

172210
1. Select the asset you want to revoke permission for one or more creators to use in their own experiences. The asset's **Configure** page displays.
173-
1. In the asset's left-hand navigation, select **Permissions**. The asset's **Permissions** page displays, and under **Collaborator Access** **Creators**, all creators who have permission to use the asset display.
211+
1. In the asset's left-hand navigation, select **Permissions**. The asset's **Permissions** page displays, and under **Collaborator Access** &rarr; **Creators**, all creators who have permission to use the asset display.
174212

175213
<img src="../../assets/creator-dashboard/Asset-Settings-Permissions-Button.png" alt="A close up view of a Swamp SFX asset's left-hand menu. The Permissions navigation menu item is highlighted." width="330" />
176214

content/en-us/reference/engine/classes/Attachment.yaml

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,8 @@ summary: |
66
Defines a point and orientation relative to a parent `Class.BasePart`,
77
`Class.Bone`, or another `Class.Attachment`.
88
description: |
9-
An `Class.Attachment` defines a point and orientation relative to a parent
10-
`Class.BasePart`, `Class.Bone`, or another `Class.Attachment`. The offset is
9+
An `Attachment` defines a point and orientation relative to a parent
10+
`Class.BasePart`, `Class.Bone`, or another `Attachment`. The offset is
1111
stored in the `Class.Attachment.CFrame|CFrame` property. The offset can also
1212
be set through other properties, such as
1313
`Class.Attachment.WorldCFrame|WorldCFrame`.
@@ -58,9 +58,9 @@ properties:
5858
`Datatype.CFrame` offset of the attachment.
5959
description: |
6060
The `Datatype.CFrame` offset of the attachment. Changes to this property
61-
will reflect onto the `Class.Attachment.Position` and
62-
`Class.Attachment.Rotation` properties of this object. Similarly, a change
63-
to either of those properties will reflect onto this property.
61+
will reflect onto the `Class.Attachment.Position|Position` and
62+
`Class.Attachment.Rotation|Rotation` properties of this object. Similarly,
63+
a change to either of those properties will reflect onto this property.
6464
code_samples:
6565
type: CFrame
6666
tags: []
@@ -137,7 +137,7 @@ properties:
137137
- Deprecated
138138
deprecation_message: |
139139
This property is deprecated and should not be used in new work. See
140-
`Class.Attachment.Orientation` instead.
140+
`Class.Attachment.Orientation|Orientation` instead.
141141
security:
142142
read: None
143143
write: None
@@ -302,7 +302,8 @@ properties:
302302
- NotReplicated
303303
- Deprecated
304304
deprecation_message: |
305-
This item has been superseded by `Class.Attachment.WorldOrientation` which
305+
This item has been superseded by
306+
`Class.Attachment.WorldOrientation|WorldOrientation` which
306307
should be used in new work.
307308
security:
308309
read: None
@@ -352,7 +353,7 @@ methods:
352353
tags:
353354
- Deprecated
354355
deprecation_message: |
355-
This function is deprecated and should not be used in new work.
356+
This method is deprecated and should not be used in new work.
356357
security: None
357358
thread_safety: Unsafe
358359
capabilities: []
@@ -390,7 +391,7 @@ methods:
390391
tags:
391392
- Deprecated
392393
deprecation_message: |
393-
This function is deprecated and should not be used in new work.
394+
This method is deprecated and should not be used in new work.
394395
security: None
395396
thread_safety: Unsafe
396397
capabilities: []
@@ -412,7 +413,7 @@ methods:
412413
tags:
413414
- Deprecated
414415
deprecation_message: |
415-
This function is deprecated and should not be used in new work.
416+
This method is deprecated and should not be used in new work.
416417
security: None
417418
thread_safety: Unsafe
418419
capabilities: []
@@ -436,7 +437,7 @@ methods:
436437
tags:
437438
- Deprecated
438439
deprecation_message: |
439-
This function is deprecated and should not be used in new work.
440+
This method is deprecated and should not be used in new work.
440441
security: None
441442
thread_safety: Unsafe
442443
capabilities: []

0 commit comments

Comments
 (0)