Door middel van tekstprompts en vooraf ingestelde schema's kun jij (en spelers in het spel) zowel statische 3D-assets als volledig functionele modellen genereren, zoals voertuigen die rijden, vliegtuigen die vliegen en wapens die schieten. Deze gids laat zien hoe je GenerateModelAsync() kunt gebruiken als onderdeel van een dynamische, door spelers aangedreven creatieve ervaring.
Overzicht
GenerateModelAsync() maakt de generatie van multi-mesh geometrieën mogelijk met de volgende voordelen:
- Het opgegeven schema definieert hoe de gegenereerde geometrie in delen zal worden opgesplitst.
- Elk object dat in het spel wordt gegenereerd, zal worden gerepliceerd en zichtbaar zijn voor alle spelers, waardoor ze samen in real-time kunnen bouwen.
- Gegenereerde meshes zijn van hogere kwaliteit met betere algehele vormen, silhouetten, meer detail en minder artefacten. Gegenereerde texturen zijn coherenter en gedetailleerder, met minder korreligheid en minder uitgesproken gebakken verlichting.
- De generatie tijden hebben een lagere latentie, waardoor snellere en responsievere creatie in games mogelijk is.
- Jij en zelfs spelers tijdens de speeltijd kunnen begrenzingsdozen specificeren om de grootte en verhoudingen van het gegenereerde model voor te stellen.
- Een optionele maximale driehoekentelling houdt gegenereerde objecten performant voor jouw spel.
Schema-gebaseerde generatie
Om gearticuleerde, functionele objecten te creëren, moet de gegenereerde geometrie worden gescheiden in meerdere MeshParts. Bijvoorbeeld, om een rijdbare auto te maken met wielen die draaien en sturen, zijn er minstens vijf MeshParts nodig: één voor de carrosserie van de auto en vier voor elk van de wielen van de auto. GenerateModelAsync() bereikt dit via een schema dat de te genereren delen opsomt, zoals weergegeven in de volgende codefragment:
local GenerationService = game:GetService("GenerationService")
local Workspace = game:GetService("Workspace")
-- Stel de invoer in voor de gegenereerde geometrie
local inputs = {
TextPrompt = "groene drakenauto met 4 wielen"
}
-- Stel schema in op het vooraf gedefinieerde vijf-modellen auto chassis
local schema = {
PredefinedSchema = "Car5"
}
-- Maak de aanroep om het model te genereren
local success, result, metadata = pcall(function()
return GenerationService:GenerateModelAsync(inputs, schema)
end)
if success then
-- Schaal model naar doelgrootte en positioneer het nabij het wereldcentrum
local targetSize = 16
local modelSize = result:GetExtentsSize()
local scaleFactor = targetSize / math.max(modelSize.X, modelSize.Y, modelSize.Z)
result:ScaleTo(scaleFactor)
result:PivotTo(CFrame.new(0, result:GetExtentsSize().Y / 2, -40))
-- Veranker alle delen zodat de meshes niet uit elkaar vallen
for _, descendant in result:GetDescendants() do
if descendant:IsA("BasePart") then
descendant.Anchored = true
end
end
-- Geef het model een naam en maak het een kind van de workspace
result.Name = "BasicDragonCarGeneration"
result.Parent = Workspace
else
warn(result)
endDe volgende afbeelding toont de verwachte output en de constructie zoals deze verschijnt in de Explorer hiërarchie:


Herbestembare scripts
In Roblox omvatten gedragingen doorgaans de scripts, bijlagen, beperkingen en andere instantie types die aan statische, getextureerde geometrieën zijn bevestigd om ze functioneel te maken. Aangezien GenerateModelAsync() een breed scala aan geometrieën on-the-fly genereert, moeten herbestembare scripts worden bevestigd om gedragingen automatisch aan te passen aan de verwachte functionaliteit.
Bijvoorbeeld, beschouw een spel waarin spelers hun eigen rijdbare auto's kunnen maken. GenerateModelAsync() neemt de spelerprompt en genereert vijf verschillende meshes (carrosserie en vier wielen) via het Car5 schema. Vervolgens past een vooraf ingesteld herbestembaar script het rijgedrag aan op de grootte en vorm van het model om ervoor te zorgen dat de auto rijdbaar is en de wielen realistisch draaien.
Om herbestembare scripts te testen:
Download het Behaviors.rbxm bestand.
Klik met de rechtermuisknop op ReplicatedStorage in de Explorer hiërarchie van Studio, selecteer Invoegen ⟩ Importeer Roblox Model, en kies het gedownloade bestand. Het model wordt uitgepakt in verschillende mappen.

Kopieer en plak een van de volgende codefragmenten in een server Script binnen ServerScriptService, afhankelijk van het type object dat je wilt genereren.
Dit voorbeeld genereert een functionele auto met een rem, nitroboost, audio- en visuele effecten, en een snelheidsmeter op het scherm.
Script in ServerScriptServicelocal GenerationService = game:GetService("GenerationService")local ReplicatedStorage = game:GetService("ReplicatedStorage")local Workspace = game:GetService("Workspace")-- Stel de invoer in voor de gegenereerde geometrielocal inputs = {TextPrompt = "groene drakenauto met 4 wielen"}-- Stel schema in op het vooraf gedefinieerde vijf-modellen auto chassislocal schema = {PredefinedSchema = "Car5"}-- Maak de aanroep om het model te genererenlocal success, result, metadata = pcall(function()return GenerationService:GenerateModelAsync(inputs, schema)end)if success then-- Schaal model naar doelgroottelocal targetSize = 16local modelSize = result:GetExtentsSize()local scaleFactor = targetSize / math.max(modelSize.X, modelSize.Y, modelSize.Z)result:ScaleTo(scaleFactor)-- Laad "makeFunctional" module voor "CarBehavior"local makeFunctional = require(ReplicatedStorage.Behaviors.CarBehavior.makeFunctional)-- Verwijs naar auto onderdelen via namen die gegarandeerd zijn door het "Car5" schemalocal body = result:FindFirstChild("body")local frontLeftWheel = result:FindFirstChild("front left wheel")local frontRightWheel = result:FindFirstChild("front right wheel")local rearLeftWheel = result:FindFirstChild("rear left wheel")local rearRightWheel = result:FindFirstChild("rear right wheel")-- Stel gedragsconfiguratieparameters inlocal config = {seatPosition = "inside",invisibleWhenSeated = false}-- Bevestig gedrag via het "makeFunctional" scriptlocal functionalModel = makeFunctional(result, frontLeftWheel, frontRightWheel, rearLeftWheel, rearRightWheel, body, config)-- Positioneer het model nabij het wereldcentrumfunctionalModel:PivotTo(CFrame.new(0, functionalModel:GetExtentsSize().Y / 2, -40))functionalModel.Name = "BasicDragonCarGeneration"functionalModel.Parent = Workspaceelsewarn(result)end