Merge branch 'main' into audioanalyzer-empty-array

Author: aetter

content/common/navigation/engine/guides.yaml

@@ -428,6 +428,8 @@ navigation:
         section:
           - title: Overview
             path: /chat/in-experience-text-chat
+          - title: Guidelines
+            path: /chat/guidelines
           - title: Customization
             path: /chat/customizing-in-experience-text-chat
           - title: Bubble Chat
@@ -508,7 +510,7 @@ navigation:
           - title: Experience Icons
             path: /production/publishing/experience-icons
           - title: Experience Thumbnails
-            path: /production/promotion/thumbnails
+            path: /production/publishing/thumbnails
           - title: Badges
             path: /production/publishing/badges
       # - title: Accessories

content/en-us/assets/publishing/experience-thumbnails/Thumbnail-Home-Page-Tab.png

@@ -23,7 +23,7 @@ As a result, Assistant can act directly on your data model, such as inserting an
 
 For a more in-depth look at what Assistant can do and how to use it, see the [Prompt Guide and Examples](prompt-engineering.md) and the following Roblox Staff livestream for tips, tricks, and inspiration.
 
-<iframe width="640" height="360" src="https://www.youtube.com/embed/vMaOGgeuR4Y?si=fuX-80mMMzhQB6sn&amp;start=240" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+<iframe width="640" height="360" src="https://www.youtube-nocookie.com/embed/vMaOGgeuR4Y?si=fuX-80mMMzhQB6sn&amp;start=240" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
 
 ### Insert and Modify Scripts
 

content/en-us/assets/publishing/experience-thumbnails/Thumbnail-Impressions-Graph.png

@@ -0,0 +1,45 @@
+---
+title: Usage Guidelines
+description: Important guidelines for using the in-experience text chat feature.
+comments: Eventually fold the key points of this page into other pages and remove.
+---
+
+In-experience text chat is any message created within your experience that originated from one user and is delivered to one or more other users, including:
+
+- Chat bubbles over an avatar's head
+- Direct messages between users
+- Chat window communication between users
+- Team-specific messages
+
+For sending and delivery, these types of communications must each go through a `Class.TextChannel` instance. This ensures messages respect privacy settings, are visible to moderators, and are properly text filtered.
+
+Certain text is **not** considered chat:
+
+- Text on menus created by developers (for example, "Press any button to continue.")
+- Status updates from the experience (for example, "Two minutes remaining!")
+- Announcements from admin commands
+- A user renaming their pet dog
+- A user writing on a sign
+- Moderation audit logs or messages
+- Comments on posts in an experience
+
+  <Alert severity="info">
+  If the comments support a reply feature, these replies would be considered a conversation and thus subject to this policy.
+  </Alert>
+
+- Writing a post on a bulletin board
+- Any user-generated text unrelated to a conversation
+
+For communication shared by users that can be seen by other users, even if it doesn't need to go through `Class.TextChatService`, you must ensure it goes through a [text filter](../ui/text-filtering.md).
+
+## Requirements
+
+- All experiences that offer in-experience text chat for users must integrate `Class.TextChatService`, per the [Misusing Roblox Systems Community Standard](https://en.help.roblox.com/hc/en-us/articles/203313410-Roblox-Community-Standards).
+  - Between 30 December 2024 and 30 April 2025, creators that use a custom chat solution not powered by `Class.TextChatService` or a modified or forked [Legacy Chat](legacy/legacy-chat-system.md) can continue to use their existing feature, but must also deploy the `Class.TextChatService:CanUserChatAsync()|CanUserChatAsync()` and `Class.TextChatService:CanUserDirectChatAsync()|CanUserDirectChatAsync()` methods in their experiences.
+  - After 30 April 2025, all creators must use the `Class.TextChatService` API.
+  - For more information on migrating, see the [Roblox developer forums](https://devforum.roblox.com/t/migrate-to-textchatservice-removing-support-for-legacy-chat-and-custom-chat-systems/3237100).
+- All incoming text that originates from another user must first use [Text Filtering](../ui/text-filtering.md) before your experience displays it.
+- Communication between users must respect user privacy settings.
+  - `Class.TextChannel:SendAsync` handles basic privacy and parental settings automatically.
+  - `Class.TextChannel:SetDirectChatRequester` must be used to mark `TextChannels` created for direct chat.
+- In-experience communication should be [reportable for abuse](https://en.help.roblox.com/hc/en-us/articles/203312410-How-to-Report-Rule-Violations). `TextChannels` handle this automatically.

content/en-us/assets/publishing/experience-thumbnails/Thumbnail-Start-Personalization.png

@@ -5,37 +5,32 @@ description: Lists legacy REST APIs for Open Cloud.
 
 This section contains documentation for Roblox's many legacy APIs.
 
-Roblox offers API key and/or OAuth 2.0 support **for the select legacy APIs listed on this page**. Instead of sharing cookies, you can grant access to specific permissions and use these more secure authentication methods. These APIs might change without notice and break your application and do not have the stability guarantees of the newer Open Cloud APIs.
+Roblox offers API key and/or OAuth 2.0 support **for the select legacy API endpoints listed on this page**. Instead of sharing cookies, you can grant access to specific permissions and use these more secure authentication methods. These APIs might change without notice and break your application and do not have the stability guarantees of the newer Open Cloud APIs.
 
-This page summarizes the available operations and authentication types, but you might find the legacy API documentation useful, as well:
-
-- [Badges API](/cloud/legacy/badges/v1)
-- [Develop API](/cloud/legacy/develop/v1)
-- [Followings API](/cloud/legacy/followings/v1)
-- [Game Internationalization API](/cloud/legacy/gameinternationalization/v1)
-- [Groups API](/cloud/legacy/groups/v1)
-- [Localization Tables API](/cloud/legacy/localizationtables/v1)
-- [Publish API](/cloud/legacy/publish/v1)
+This page summarizes the available operations and authentication types.
 
 <Alert severity="warning">
   Refer to the left navigation for documentation of legacy APIs that only support cookie authentication and **not** API key and/or OAuth 2.0 authentication.
-  
+
   Just like the legacy APIs listed on this page, those APIs might change without notice. We do not recommend depending on those APIs as they rely on needing to share cookies with application code that interacts with these endpoints.
 </Alert>
 
 ## Badges API
 
 - Base URL: `https://apis.roblox.com/legacy-badges`
 - Authentication types: OAuth 2.0 and API key
-
+- Additional Badges API endpoints without Open Cloud authentication support can be found [here](/cloud/legacy/badges/v1).
+- Robux might be required to create a badge. To identify the number of remaining free badges you can create in the specified universe for the current UTC day, use the `/v1/universes/{universeId}/free-badges-quota` endpoint.
 | **API**     | **Path**                    | **Scope**                     |
 | :---------- | :-------------------------- | :---------------------------- |
 | UpdateBadge | `PATCH v1/badges/{badgeId}` | `legacy-universe.badge:write` |
+| CreateBadge | `POST v1/universes/{universeId}/badges` | `legacy-universe.badge:manage-and-spend-robux` |
 
 ## Develop API
 
 - Base URL: `https://apis.roblox.com/legacy-develop`
 - Authentication types: OAuth 2.0 and API key
+- Additional Develop API endpoints without Open Cloud authentication support can be found [here](/cloud/legacy/develop/v1).
 
 | **API**                              | **Path**                                                    | **Scope**                          |
 | :----------------------------------- | :---------------------------------------------------------- | :--------------------------------- |
@@ -48,11 +43,14 @@ This page summarizes the available operations and authentication types, but you
 | GetGroupsWithEditGroupGamePermission | `GET v1/user/groups/canmanage`                              | `legacy-group:manage`              |
 | ActivateUniverse                     | `POST v1/universes/{universeId}/activate`                   | `legacy-universe:manage`           |
 | DeactivateUniverse                   | `POST v1/universes/{universeId}/deactivate`                 | `legacy-universe:manage`           |
+| GetUniversePermissions               | `GET v1/universes/{universeId}/permissions`                 | `legacy-universe:manage`           |
+| MultiGetUniversePermissions          | `GET v1/universes/multiget/permissions`                     | `legacy-universe:manage`           |
 
 ## Followings API
 
 - Base URL: `https://apis.roblox.com/legacy-followings`
 - Authentication types: OAuth 2.0 and API key
+- Additional Followings API endpoints without Open Cloud authentication support can be found [here](/cloud/legacy/followings/v1).
 
 | **API**            | **Path**                                              | **Scope**                         |
 | :----------------- | :---------------------------------------------------- | :-------------------------------- |
@@ -66,6 +64,7 @@ This page summarizes the available operations and authentication types, but you
 
 - Base URL: `https://apis.roblox.com/legacy-game-internationalization`
 - Authentication types: OAuth 2.0 and API key
+- Additional Game Internationalization API endpoints without Open Cloud authentication support can be found [here](/cloud/legacy/gameinternationalization/v1).
 
 | **API**                                            | **Path**                                                                                                                     | **Scope**                         |
 | :------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- | :-------------------------------- |
@@ -113,6 +112,7 @@ This page summarizes the available operations and authentication types, but you
 
 - Base URL: `https://apis.roblox.com/legacy-groups`
 - Authentication types: OAuth 2.0 and API key
+- Additional Groups API endpoints without Open Cloud authentication support can be found [here](/cloud/legacy/groups/v1).
 
 | **API**                           | **Path**                                            | **Scope**             |
 | :-------------------------------- | :-------------------------------------------------- | :-------------------- |
@@ -129,6 +129,7 @@ This page summarizes the available operations and authentication types, but you
 
 - Base URL: `https://apis.roblox.com/legacy-localization-tables`
 - Authentication types: OAuth 2.0 and API key
+- Additional Localization Tables API endpoints without Open Cloud authentication support can be found [here](/cloud/legacy/localizationtables/v1).
 
 | **API**                                 | **Path**                                                                  | **Scope**                |
 | :-------------------------------------- | :------------------------------------------------------------------------ | :----------------------- |
@@ -147,6 +148,7 @@ This page summarizes the available operations and authentication types, but you
 
 - Base URL: `https://apis.roblox.com/legacy-publish`
 - Authentication types: OAuth 2.0 and API key
+- Additional Publish API endpoints without Open Cloud authentication support can be found [here](/cloud/legacy/publish/v1).
 
 | **API**                                 | **Path**                                                                  | **Scope**                |
 | :-------------------------------------- | :------------------------------------------------------------------------ | :----------------------- |

content/en-us/assistant/guide.md

@@ -4,7 +4,7 @@ description: Use referral links to track and reward players that have successful
 ---
 
 <Alert severity="info">
-This feature is still in beta. If you'd like to provide Roblox with feedback about this feature, join the [User Acquisition Referrals](https://www.guilded.gg/i/kbQ4Po42) Guilded group.
+This feature is still in beta. If you'd like to provide Roblox with feedback about this feature, join the [User Acquisition Referrals](https://www.guilded.gg/i/EwKQPZWE) Guilded group.
 </Alert>
 
 The friend referral system encourages existing players to bring new players into your experience, increasing player retention and overall engagement. Players can access and share referral links from [player invite prompts](./invite-prompts.md) or directly from the default in-experience invite menu.