mirror of
https://github.com/rojo-rbx/rojo.git
synced 2026-10-23 22:11:38 +00:00
rules
This commit is contained in:
Joe
parent
a9b4f8e83b
commit
e6efc04756
8494 changed files with 495610 additions and 0 deletions
|
|
@ -0,0 +1,192 @@
|
|||
# This file is automatically generated. Please don't edit it manually.
|
||||
# To submit a bug report on the content, see
|
||||
# https://devforum.roblox.com/c/bug-reports/documentation-issues/72
|
||||
|
||||
name: GenerationService
|
||||
type: class
|
||||
memory_category: Instances
|
||||
summary: |
|
||||
Service that allows developers to generate 3D objects from text prompts.
|
||||
description: |
|
||||
`GenerationService` enables you to generate 3D objects from text prompts using
|
||||
Roblox's Cube 3D foundation model. This enables the generation of objects like
|
||||
environmental props in-experience.
|
||||
|
||||
You can control the output by providing an optional `Datatype.Vector3` to the
|
||||
`SuggestedSize` parameter. Rather than simply rescaling the result, this
|
||||
parameter guides the model during the creation process, influencing it to
|
||||
create a mesh that attempts to match the proportions and size of your
|
||||
specified bounding box.
|
||||
|
||||
Mesh generation is a two step process:
|
||||
|
||||
1. `Class.GenerationService:GenerateMeshAsync()|GenerateMeshAsync()` starts
|
||||
the mesh generation process using a text prompt and other required
|
||||
parameters. It returns a unique identifier (generation ID) that can be used
|
||||
to retrieve the future result.
|
||||
2. `Class.GenerationService:LoadGeneratedMeshAsync()|LoadGeneratedMeshAsync()`
|
||||
loads the generated mesh into the experience. The mesh is returned as a
|
||||
`Class.MeshPart` or `Class.Model`.
|
||||
|
||||
Currently, `GenerationService` only supports the following usage:
|
||||
|
||||
- `Class.GenerationService:GenerateMeshAsync()|GenerateMeshAsync()` must be
|
||||
called from server scripts.
|
||||
- `Class.GenerationService:LoadGeneratedMeshAsync()|LoadGeneratedMeshAsync()`
|
||||
must be called from client scripts.
|
||||
|
||||
As a result, when a mesh generation request originates from a client, the
|
||||
client must send a signal to the server to initiate generation. Once the
|
||||
server determines that generation is complete, it should notify the
|
||||
appropriate client to call
|
||||
`Class.GenerationService:LoadGeneratedMeshAsync()|LoadGeneratedMeshAsync()`
|
||||
and retrieve the mesh. Note that since the generated mesh is loaded with
|
||||
`Class.EditableMesh` content and only on the client, it is not replicated to
|
||||
any other clients.
|
||||
|
||||
See
|
||||
[this demo experience](https://www.roblox.com/games/108838517877898/SuggestedSize-Generation-Template)
|
||||
for a more detailed example including usage of the `SuggestedSize` option
|
||||
(click the **⋯** button and **Edit in Studio**).
|
||||
code_samples:
|
||||
- GenerationService-ServerSideMeshGeneration
|
||||
- GenerationService-ClientSideMeshGeneration
|
||||
- GenerationService-ServerSideMeshGeneration-WithSuggestedSize
|
||||
- GenerationService-ClientSideMeshGeneration-WithSuggestedSize
|
||||
- GenerationService-StarterPlayerScripts-WithSuggestedSize
|
||||
inherits:
|
||||
- Instance
|
||||
descendants: []
|
||||
tags:
|
||||
- NotCreatable
|
||||
- Service
|
||||
deprecation_message: ''
|
||||
properties: []
|
||||
methods:
|
||||
- name: GenerationService:GenerateMeshAsync
|
||||
summary: |
|
||||
Starts the generation of a new 3D mesh from a text prompt and returns
|
||||
unique IDs used to track and retrieve the result.
|
||||
description: |
|
||||
Starts the generation of a new 3D mesh from a text prompt and returns
|
||||
unique IDs used to track and retrieve the result. You can optionally
|
||||
receive intermediate results, such as the untextured mesh, by providing an
|
||||
`intermediateResultCallback` function. After the generation is complete,
|
||||
use
|
||||
`Class.GenerationService:LoadGeneratedMeshAsync|LoadGeneratedMeshAsync()`
|
||||
to load and display the generated mesh.
|
||||
|
||||
**Error Codes**
|
||||
|
||||
| Error | Description | Recommended developer action |
|
||||
| ------------------------------------------ | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
|
||||
| Rate limit exceeded | The maximum number of mesh generations has been exceeded for the minute. | Wait until the rate limit resets. |
|
||||
| Moderation failed | The mesh generation was flagged for moderation. | Review and modify the prompt to ensure it adheres to Roblox's moderation guidelines. |
|
||||
| Internal server error | An unexpected issue occurred on the server. | Retry the request later or check server status for issues. |
|
||||
| Character limit exceeded | The input prompt length for this generation request exceeded the limit. | Reduce the number of characters in the `Prompt` string of the `input` dictionary. |
|
||||
| Service overloaded | The service is overloaded. | Retry the request later. |
|
||||
| Size dimensions must all be greater than 0 | Invalid size provided. | Change the size to above `0`. |
|
||||
code_samples: []
|
||||
parameters:
|
||||
- name: inputs
|
||||
type: Dictionary
|
||||
default:
|
||||
summary: |
|
||||
A dictionary containing the mesh generation prompts. Currently, the
|
||||
only supported key is the `Prompt` (string) that describes the mesh to
|
||||
generate.
|
||||
- name: player
|
||||
type: Player
|
||||
default:
|
||||
summary: |
|
||||
The `Class.Player` requesting the generation.
|
||||
- name: options
|
||||
type: Dictionary
|
||||
default:
|
||||
summary: |
|
||||
A dictionary for additional generation options to influence the
|
||||
result. The following key is supported: - `SuggestedSize` — Optional
|
||||
`Datatype.Vector3` representing a size guide for the generated asset.
|
||||
The service will attempt to create a model with a size and proportion
|
||||
similar to the provided `Datatype.Vector3`. This does not guarantee
|
||||
the final output size.
|
||||
- name: intermediateResultCallback
|
||||
type: Function?
|
||||
default:
|
||||
summary: |
|
||||
A callback function triggered with intermediate generation results.
|
||||
Useful for retrieving early mesh versions before textures are applied.
|
||||
returns:
|
||||
- type: Tuple
|
||||
summary: |
|
||||
A tuple of the generation ID (a unique ID returned for each invocation
|
||||
of `GenerateMeshAsync()`) and context ID (not currently used).
|
||||
tags:
|
||||
- Yields
|
||||
deprecation_message: ''
|
||||
security: None
|
||||
thread_safety: Unsafe
|
||||
capabilities:
|
||||
- DynamicGeneration
|
||||
- name: GenerationService:GenerateModelAsync
|
||||
summary: ''
|
||||
description: ''
|
||||
code_samples: []
|
||||
parameters:
|
||||
- name: inputs
|
||||
type: Dictionary
|
||||
default:
|
||||
summary: ''
|
||||
- name: schema
|
||||
type: Dictionary
|
||||
default:
|
||||
summary: ''
|
||||
- name: options
|
||||
type: Dictionary?
|
||||
default:
|
||||
summary: ''
|
||||
returns:
|
||||
- type: Tuple
|
||||
summary: ''
|
||||
tags:
|
||||
- Yields
|
||||
deprecation_message: ''
|
||||
security: None
|
||||
thread_safety: Unsafe
|
||||
capabilities:
|
||||
- DynamicGeneration
|
||||
- name: GenerationService:LoadGeneratedMeshAsync
|
||||
summary: |
|
||||
Retrieves and loads a mesh generated by
|
||||
`Class.GenerationService:GenerateMeshAsync()` using the provided
|
||||
`generationId`.
|
||||
description: |
|
||||
Retrieves and loads a mesh generated by
|
||||
`Class.GenerationService:GenerateMeshAsync()|GenerateMeshAsync()` using
|
||||
the provided `generationId`. The mesh can be returned as a
|
||||
`Class.MeshPart` or `Class.Model`. Because editable meshes are not
|
||||
replicated, the loaded mesh is not replicated to any other clients and can
|
||||
only be loaded once per `generationId`.
|
||||
code_samples: []
|
||||
parameters:
|
||||
- name: generationId
|
||||
type: string
|
||||
default:
|
||||
summary: |
|
||||
The unique ID returned by
|
||||
`Class.GenerationService:GenerateMeshAsync()|GenerateMeshAsync()`.
|
||||
Identifies the mesh to load.
|
||||
returns:
|
||||
- type: MeshPart
|
||||
summary: |
|
||||
The generated asset, returned as a `Class.Model` with a single
|
||||
`Class.MeshPart` containing an `Class.EditableMesh`.
|
||||
tags:
|
||||
- Yields
|
||||
deprecation_message: ''
|
||||
security: None
|
||||
thread_safety: Unsafe
|
||||
capabilities:
|
||||
- DynamicGeneration
|
||||
events: []
|
||||
callbacks: []
|
||||
Loading…
Add table
Add a link
Reference in a new issue