Bauen Sie Ihre Spielwelt mit Asset-Einfügung, Tween-Animationen, Audio, Partikeleffekten, Physik-Kollisionsgruppen, Beleuchtung, Terrain, räumlichen Abfragen und Kamera.
Assets & Objektdarstellung
Enthaltene Tools
| Tool | Beschreibung |
|---|---|
manage_assets | Creator Store-Suche, Modell-/Paket-Einfügung, Asset-Info |
manage_tween | Tweens erstellen, abspielen, pausieren und abbrechen |
manage_animation | Animationen laden, abspielen, stoppen und Tracks abfragen |
manage_audio | Sounds abspielen/stoppen/pausieren, Audio-Listener setzen |
manage_effects | Partikeleffekte emittieren, leeren und umschalten |
manage_physics | Kollisionsgruppen registrieren, Kollidierbarkeit setzen |
Wichtige Workflows
Eine Szene mit Assets bauen
"Suche nach einem 'tree'-Modell im Creator Store und platziere 3 davon in Workspace"Verwenden Sie manage_assets search_insert, um in einem Schritt zu suchen und einzufügen.
Interaktive Darstellung
"Erstelle einen Tween, der eine Tür über 3 Sekunden öffnet, wenn sie angeklickt wird"Verwenden Sie manage_tween create, um den Tween zu definieren, und play, um ihn auszuführen. Fügen Sie gleichzeitig einen Tür-Öffnungs-Soundeffekt mit manage_audio play hinzu.
Partikel + Sound-Kombination
"Spiele einen Explosionspartikel-Effekt zusammen mit einem Soundeffekt ab, wenn der Boss erscheint"Verwenden Sie manage_effects emit, um Partikel zu emittieren, und manage_audio play, um den Sound gleichzeitig abzuspielen.
Action-Referenz
Manage Assets
| Action | Beschreibung |
|---|---|
insert | Ein Modell anhand der Asset-ID einfügen |
info | Asset-Metadaten abrufen |
search | Im Creator Store suchen |
search_insert | Suchen und das erste Match einfügen |
insert_free | Ein freies Modell einfügen |
insert_package | Ein Paket einfügen |
export | Die aktuelle Auswahl exportieren |
Manage Tween
| Action | Beschreibung |
|---|---|
create | Einen Tween mit Zieleigenschaften erstellen |
play | Einen erstellten Tween abspielen |
pause | Einen laufenden Tween pausieren |
cancel | Einen Tween abbrechen |
Manage Animation
| Action | Beschreibung |
|---|---|
load | Eine Animation auf einen Humanoid/AnimationController laden |
play | Einen geladenen Animations-Track abspielen |
stop | Eine laufende Animation stoppen |
get_tracks | Alle geladenen Animations-Tracks auflisten |
Manage Audio
| Action | Beschreibung |
|---|---|
play | Einen Sound abspielen (erstellt bei Bedarf einen Sound) |
stop | Einen laufenden Sound stoppen |
pause | Einen laufenden Sound pausieren |
resume | Einen pausierten Sound fortsetzen |
set_listener | Audio-Listener-Typ und -Ziel setzen |
Manage Effects
| Action | Beschreibung |
|---|---|
emit | Partikel von einem ParticleEmitter emittieren |
clear | Alle Partikel löschen |
toggle | Einen Effekt aktivieren oder deaktivieren |
Manage Physics
| Action | Beschreibung |
|---|---|
register_group | Eine Kollisionsgruppe registrieren |
set_collidable | Setzen, ob zwei Gruppen kollidieren können |
get_groups | Alle registrierten Kollisionsgruppen auflisten |
Weltumgebung
Enthaltene Tools
| Tool | Beschreibung |
|---|---|
manage_lighting | Lighting, Atmosphere, Sky und Tageszeit konfigurieren |
manage_terrain | Terrain generieren/bearbeiten und Voxel-Daten verwalten |
spatial_query | Raycasting, Bodenerkennung, Platzierungsvalidierung, Heightmaps |
manage_camera | Kamera-Info abfragen, Fokus bewegen, Ansichten vorschlagen, Edit-Modus-Viewport-Screenshot erfassen |
Wichtige Workflows
Welt-Atmosphäre einstellen
"Ändere die Stimmung in Abenddämmerung: oranger Himmel, Nebeldichte erhöhen, Zeit auf 18:00 setzen"Verwenden Sie manage_lighting time, um die Tageszeit zu setzen, atmosphere, um den Nebel anzupassen, und sky, um die Himmelsfarbe zu ändern.
Terrain bauen
"Erstelle einen grasbewachsenen Hügel mit Radius 200 in der Mitte der Karte und fülle den umliegenden Bereich mit Wasser"Verwenden Sie manage_terrain fill_ball, um den Hügel zu erstellen, und fill_block, um den umliegenden Wasserbereich zu füllen.
Platzierungsvalidierung
"Finde einen flachen Bereich, in dem ich dieses Gebäude platzieren kann"Verwenden Sie spatial_query find_flat, um einen geeigneten Bereich zu finden, check_placement, um zu bestätigen, dass keine Kollisionen vorliegen, und dann manage_camera focus_position, um das Ergebnis visuell zu überprüfen.
Action-Referenz
Manage Lighting
| Action | Beschreibung |
|---|---|
lighting | Lighting-Service-Eigenschaften setzen |
atmosphere | Atmosphere-Eigenschaften setzen |
sky | Sky-Eigenschaften setzen |
terrain_props | Terrain-Wasser-/Visuelle Eigenschaften setzen |
time | Tageszeit setzen |
Manage Terrain
| Action | Beschreibung |
|---|---|
fill_block | Terrain in Block-Form füllen |
fill_ball | Terrain in Kugel-Form füllen |
fill_cylinder | Terrain in Zylinder-Form füllen |
fill_wedge | Terrain in Keil-Form füllen |
clear_region | Terrain in einer Region leeren |
clear_bounds | Terrain innerhalb von Grenzen leeren |
replace_material | Material in einer Region ersetzen |
colors_get | Material-Farben abrufen |
colors_set | Material-Farben setzen |
read_voxel | Ein einzelnes Voxel lesen |
read_voxels | Voxel im Bulk lesen |
write_voxels | Voxel im Bulk schreiben |
generate | Prozedurales Terrain generieren |
smooth | Terrain glätten |
Spatial Query
| Action | Beschreibung |
|---|---|
raycast | Einzelner Raycast |
find_ground | Bodenposition unter einem Punkt finden |
check_placement | Prüfen, ob die Platzierung kollisionsfrei ist |
multi_raycast | Mehrere Raycasts im Batch ausführen |
scan_area | Eine Heightmap eines Bereichs generieren |
find_flat | Einen flachen Bereich für den Bau finden |
find_spawn | Eine geeignete Spawn-Position finden |
analyze_walkable | Begehbares Bereichs-Raster analysieren |
spatial_map | Positionen aller BaseParts abrufen |
find_space | Leeren Raum für ein Objekt finden |
bounds | Den Bounding Box einer Instanz abrufen |
snap_grid | Eine Position an ein Raster anpassen |
collision | AABB-Kollision prüfen |
Manage Camera
| Action | Beschreibung |
|---|---|
info | Kameraposition, -rotation, -FOV und Viewport-Größe abrufen |
focus_path | Kamera anhand eines Pfads auf eine Instanz fokussieren |
focus_position | Kamera auf eine Position fokussieren |
suggest | Eine vorgeschlagene Kameraansicht für ein Ziel abrufen |
screenshot | Den aktuellen Studio Edit-Modus-Viewport als PNG-Bild erfassen (nur Edit-Modus) |