update Open Source Docs from Roblox internal teams

Author: rbx-open-source-docs[bot]

content/common/navigation/engine/reference.yaml

@@ -2985,6 +2985,16 @@ navigation:
         type: engineapi
         source: /reference/engine/classes/VRStatusService.yaml
         ignoreTranslation: true
+      - title: WebSocketClient
+        path: /reference/engine/classes/WebSocketClient
+        type: engineapi
+        source: /reference/engine/classes/WebSocketClient.yaml
+        ignoreTranslation: true
+      - title: WebSocketService
+        path: /reference/engine/classes/WebSocketService
+        type: engineapi
+        source: /reference/engine/classes/WebSocketService.yaml
+        ignoreTranslation: true
       - title: WedgePart
         path: /reference/engine/classes/WedgePart
         type: engineapi
@@ -3628,11 +3638,6 @@ navigation:
         type: engineapi
         source: /reference/engine/enums/CameraType.yaml
         ignoreTranslation: true
-      - title: CaptureUIHideMode
-        path: /reference/engine/enums/CaptureUIHideMode
-        type: engineapi
-        source: /reference/engine/enums/CaptureUIHideMode.yaml
-        ignoreTranslation: true
       - title: CatalogCategoryFilter
         path: /reference/engine/enums/CatalogCategoryFilter
         type: engineapi
@@ -5023,6 +5028,11 @@ navigation:
         type: engineapi
         source: /reference/engine/enums/StartCorner.yaml
         ignoreTranslation: true
+      - title: StateObjectFieldType
+        path: /reference/engine/enums/StateObjectFieldType
+        type: engineapi
+        source: /reference/engine/enums/StateObjectFieldType.yaml
+        ignoreTranslation: true
       - title: Status
         path: /reference/engine/enums/Status
         type: engineapi
@@ -5313,6 +5323,11 @@ navigation:
         type: engineapi
         source: /reference/engine/enums/TweenStatus.yaml
         ignoreTranslation: true
+      - title: UICaptureMode
+        path: /reference/engine/enums/UICaptureMode
+        type: engineapi
+        source: /reference/engine/enums/UICaptureMode.yaml
+        ignoreTranslation: true
       - title: UIDragDetectorBoundingBehavior
         path: /reference/engine/enums/UIDragDetectorBoundingBehavior
         type: engineapi
@@ -5498,6 +5513,11 @@ navigation:
         type: engineapi
         source: /reference/engine/enums/WaterForce.yaml
         ignoreTranslation: true
+      - title: WebSocketState
+        path: /reference/engine/enums/WebSocketState
+        type: engineapi
+        source: /reference/engine/enums/WebSocketState.yaml
+        ignoreTranslation: true
       - title: WeldConstraintPreserve
         path: /reference/engine/enums/WeldConstraintPreserve
         type: engineapi

content/en-us/assets/art/accessories/creating/Long_Sleeve_Export.fbx

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:63c0817bbb11ad2e596c768b38b492dbe82eec8b7355405ddc6fcb1ee2f17657
-size 394684
+oid sha256:9e3b54928a64b11375a1af5df3f32abe03797754b383551dffeee334ee1f0036
+size 395196

content/en-us/assets/assistant/Studio-Generated-Green-Dragon.jpg

@@ -3,13 +3,16 @@ title: Assistant
 description: How to use Assistant to help build, grow, and monetize your creations.
 ---
 
+import BetaAlert from '../includes/beta-features/beta-alert.md'
+
 **Assistant** is an AI helper that accelerates content creation by helping you get started, supplementing your skills, and assisting with ongoing development. It can do the following and much more:
 
 - Answer how to do things on Roblox
 - Add and edit objects and scripts directly in your place's data model
 - Insert objects from the Creator Store
 - "Explain this code" by selecting parts of a script in the Script Editor
 - Create materials to restyle your objects
+- Generate 3D objects to populate your scene
 
 <Alert severity="info">
 [Built with Meta Llama 3](https://llama.meta.com/llama3/license/)
@@ -55,6 +58,17 @@ When given a request to generate a material, Assistant in Studio can quickly sty
 
 <img src="../assets/assistant/Studio-Quick-Styling-Material.png" width="360" alt="Material variations shown in Assistant for quick styling." />
 
+### Generate 3D models
+
+<BetaAlert betaName="Assistant Mesh Generation" leadIn="This feature is currently in beta. Enable it through " leadOut="." components={props.components} />
+
+The `/generate` command enables [mesh generation](https://corp.roblox.com/newsroom/2025/03/introducing-roblox-cube), powered by Roblox's Cube 3D model.
+
+1. In the Assistant chat window, type a command such as `/generate a red buggy with knobby tires`.
+1. Assistant generates the corresponding object and adds it directly to your workspace for further customization.
+
+<img src="../assets/assistant/Studio-Generated-Green-Dragon.jpg" width="360" alt="A generated green dragon provided by Assistant in Studio." />
+
 ## Access Assistant
 
 Assistant is available in two locations: Studio and the documentation.

content/en-us/assistant/guide.md

@@ -3,6 +3,10 @@ title: Automatically translate dynamic content
 description: Explain how to generate translations in real time for dynamic content.
 ---
 
+<Alert severity = 'warning'>
+The following feature is currently in early development and is subject to change. For the latest updates and changes, see the [announcement](https://devforum.roblox.com/t/introducing-the-real-time-translation-api/3550206).
+</Alert>
+
 The standard translation workflow detects strings in your experience based on how frequently they're viewed by players and adds them to your localization table for translation. It might miss uncommon strings and/or strings generated during gameplay, such as dynamically generated text or text created by players. You can use the translate text API to generate translations for these strings in real-time, ensuring that your experience is fully localized.
 
 ## Translate text into a player's language

content/en-us/production/localization/auto-translate-dynamic-content.md

@@ -509,6 +509,38 @@ methods:
     thread_safety: Unsafe
     capabilities: []
     writeCapabilities: []
+  - name: AnimationTrack:GetTargetInstance
+    summary: ''
+    description: ''
+    code_samples: []
+    parameters:
+      - name: name
+        type: string
+        default:
+        summary: ''
+    returns:
+      - type: Instance
+        summary: ''
+    tags: []
+    deprecation_message: ''
+    security: None
+    thread_safety: Unsafe
+    capabilities: []
+    writeCapabilities: []
+  - name: AnimationTrack:GetTargetNames
+    summary: ''
+    description: ''
+    code_samples: []
+    parameters: []
+    returns:
+      - type: Array
+        summary: ''
+    tags: []
+    deprecation_message: ''
+    security: None
+    thread_safety: Unsafe
+    capabilities: []
+    writeCapabilities: []
   - name: AnimationTrack:GetTimeOfKeyframe
     summary: |
       Returns the time position of the first `Class.Keyframe` of the given name
@@ -599,6 +631,28 @@ methods:
     thread_safety: Unsafe
     capabilities: []
     writeCapabilities: []
+  - name: AnimationTrack:SetTargetInstance
+    summary: ''
+    description: ''
+    code_samples: []
+    parameters:
+      - name: name
+        type: string
+        default:
+        summary: ''
+      - name: target
+        type: Instance
+        default:
+        summary: ''
+    returns:
+      - type: void
+        summary: ''
+    tags: []
+    deprecation_message: ''
+    security: None
+    thread_safety: Unsafe
+    capabilities: []
+    writeCapabilities: []
   - name: AnimationTrack:Stop
     summary: |
       Stops the `Class.AnimationTrack`.

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

@@ -7,7 +7,8 @@ description: ''
 code_samples: []
 inherits:
   - Instance
-tags: []
+tags:
+  - NotBrowsable
 deprecation_message: ''
 properties:
   - name: AudioTextToSpeech.IsLoaded

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

@@ -2,9 +2,15 @@ name: GenerationService
 type: class
 category:
 memory_category: Instances
-summary: ''
-description: ''
-code_samples: []
+summary: |
+  Generate 3D objects from text prompts using Roblox's
+  [Cube 3D foundation model](https://corp.roblox.com/newsroom/2025/03/introducing-roblox-cube).
+description: |
+  `GenerationService` lets you generate 3D objects from text prompts using
+  Roblox's [Cube 3D foundation model](https://corp.roblox.com/newsroom/2025/03/introducing-roblox-cube).
+code_samples:
+  - GenerationService-ServerSideMeshGeneration
+  - GenerationService-ClientSideMeshGeneration
 inherits:
   - Instance
 tags:
@@ -14,29 +20,61 @@ deprecation_message: ''
 properties: []
 methods:
   - name: GenerationService:GenerateMeshAsync
-    summary: ''
-    description: ''
-    code_samples: []
+    summary: |
+      Generates a new mesh from a text prompt and returns unique IDs to track
+      and retrieve the result.
+    description: |
+      Generates a new mesh from a text prompt and returns unique IDs to track
+      and retrieve the result. Mesh generation happens in two stages, with an
+      initial non-textured mesh being generated first and the texture generated
+      in the second stage. To retrieve more intermediate results, use the
+      optional callback to retrieve the initial generated mesh before the
+      texture has been created and applied.
+
+      For a more detailed example, see
+      [this demo experience](https://www.roblox.com/games/86571743597273/Mesh-Generation-Template).
+      Click the **⋯** button and **Edit in Studio**.
+
+      - The `GenerateMeshAsync()` method triggers the mesh generation and returns
+        the generation ID which can then be loaded with the
+        `LoadGeneratedMeshAsync()` method after the generation process
+        completes.
+      - The `GenerateMeshAsync()` method can only be called on the server.
+      - Requests are limited to 5 per minute, per experience.
+
+    code_samples:
+      - GenerationService-GenerateMeshAsync-BasicUsage
+      - GenerationService-GenerateMeshAsync-WithIntermediateResultsCallback
+      - GenerationService-GenerateMeshAsync-ServerSideGenerationWithErrorHandling
     parameters:
       - name: inputs
         type: Dictionary
         default:
-        summary: ''
+        summary: |
+          Mesh generation inputs. Must include a `Prompt` key with a string
+          value describing the object to generate.
       - name: player
         type: Player
         default:
-        summary: ''
+        summary: |
+          The player requesting the generation.
       - name: options
         type: Dictionary
         default:
-        summary: ''
+        summary: |
+          Mesh generation options (none currently available).
       - name: intermediateResultCallback
         type: Function?
         default:
-        summary: ''
+        summary: |
+          Optional function that receives intermediate generations. The callback
+          receives three parameters: `intermediateType` (an enum indicating the
+          type of intermediate result), `generationId` (string), and `contextId`
+          (string).
     returns:
       - type: Tuple
-        summary: ''
+        summary: |
+          A tuple of generation ID and context ID.
     tags:
       - Yields
     deprecation_message: ''
@@ -45,17 +83,37 @@ methods:
     capabilities: []
     writeCapabilities: []
   - name: GenerationService:LoadGeneratedMeshAsync
-    summary: ''
-    description: ''
-    code_samples: []
+    summary: |
+      Loads a generated mesh from RCC using the generation ID. The generated
+      mesh is an `Class.MeshPart`.
+    description: |
+      Loads the mesh generated by `Class.GenerationService:GenerateMeshAsync()|GenerateMeshAsync()`
+      using the `generationId` and returns a `Class.MeshPart` with the editable
+      content. The resulting generation is then subject to `Class.EditableMesh`
+      characteristics.
+
+      For a more detailed example, see
+      [this demo experience](https://www.roblox.com/games/86571743597273/Mesh-Generation-Template).
+      Click the **⋯** button and **Edit in Studio**.
+
+      Currently, the `LoadGeneratedMeshAsync()` method can only be called on
+      the client due to the restrictions on replicating editable meshes. This
+      means that only one player will be able to see the generated mesh, as this
+      function can only be called once per `generationId`.'
+
+    code_samples:
+      - GenerationService-LoadGeneratedMeshAsync-LoadAGeneratedMesh
     parameters:
       - name: generationId
         type: string
         default:
-        summary: ''
+        summary: |
+          The generation ID returned by
+          `Class.GenerationService:GenerateMeshAsync()|GenerateMeshAsync()`.
     returns:
       - type: MeshPart
-        summary: ''
+        summary: |
+          The generated `Class.MeshPart`.
     tags:
       - Yields
     deprecation_message: ''

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

@@ -64,6 +64,24 @@ properties:
     capabilities:
       - UI
     writeCapabilities: []
+  - name: GuiButton.HoverHapticEffect
+    summary: ''
+    description: ''
+    code_samples: []
+    type: HapticEffect
+    tags: []
+    deprecation_message: ''
+    security:
+      read: None
+      write: None
+    thread_safety: ReadSafe
+    category: Haptic
+    serialization:
+      can_load: true
+      can_save: true
+    capabilities:
+      - UI
+    writeCapabilities: []
   - name: GuiButton.Modal
     summary: |
       If `true` while the GUI element is visible, the mouse will not be locked
@@ -86,6 +104,24 @@ properties:
     capabilities:
       - UI
     writeCapabilities: []
+  - name: GuiButton.PressHapticEffect
+    summary: ''
+    description: ''
+    code_samples: []
+    type: HapticEffect
+    tags: []
+    deprecation_message: ''
+    security:
+      read: None
+      write: None
+    thread_safety: ReadSafe
+    category: Haptic
+    serialization:
+      can_load: true
+      can_save: true
+    capabilities:
+      - UI
+    writeCapabilities: []
   - name: GuiButton.Selected
     summary: |
       A boolean property which indicates whether the object has been selected.