Construye el mundo del juego con inserción de assets, animaciones tween, audio, efectos de partículas, grupos de colisión física, iluminación, terreno, consultas espaciales y cámara.
Assets y efectos de objetos
Herramientas incluidas
| Herramienta | Descripción |
|---|---|
manage_assets | Búsqueda en Creator Store, inserción de modelos/paquetes, información de assets |
manage_tween | Crear, reproducir, pausar y cancelar tweens |
manage_animation | Cargar, reproducir, detener animaciones y consultar tracks |
manage_audio | Reproducir/detener/pausar sonidos, configurar audio listener |
manage_effects | Emitir partículas, limpiar y alternar efectos |
manage_physics | Registrar grupos de colisión y configurar colisiones |
Flujos de trabajo principales
Construir una escena con assets
"Busca el modelo 'árbol' en Creator Store y coloca 3 en Workspace"Gestiona la búsqueda y la inserción en un solo paso con search_insert de manage_assets.
Efectos interactivos
"Crea un tween que abra una puerta en 3 segundos cuando se haga clic"Define el tween con create de manage_tween y reprodúcelo con play. Al mismo tiempo, añade el efecto de sonido de la puerta abriéndose con play de manage_audio.
Combinación de partículas + sonido
"Reproduce una explosión de partículas junto con un efecto de sonido cuando aparezca el jefe"Emite las partículas con emit de manage_effects y reproduce el sonido simultáneamente con play de manage_audio.
Referencia de acciones
Manage Assets
| Acción | Descripción |
|---|---|
insert | Insertar un modelo por ID de asset |
info | Obtener metadatos del asset |
search | Buscar en Creator Store |
search_insert | Buscar e insertar el primer resultado |
insert_free | Insertar un modelo gratuito |
insert_package | Insertar un paquete |
export | Exportar la selección actual |
Manage Tween
| Acción | Descripción |
|---|---|
create | Crear un tween con propiedades objetivo |
play | Reproducir el tween creado |
pause | Pausar el tween en ejecución |
cancel | Cancelar el tween |
Manage Animation
| Acción | Descripción |
|---|---|
load | Cargar una animación en un Humanoid/AnimationController |
play | Reproducir el track de animación cargado |
stop | Detener la animación en reproducción |
get_tracks | Listar todos los tracks de animación cargados |
Manage Audio
| Acción | Descripción |
|---|---|
play | Reproducir un sonido (crea Sound si es necesario) |
stop | Detener el sonido en reproducción |
pause | Pausar el sonido en reproducción |
resume | Reanudar el sonido pausado |
set_listener | Configurar el tipo/objetivo del audio listener |
Manage Effects
| Acción | Descripción |
|---|---|
emit | Emitir partículas desde un ParticleEmitter |
clear | Limpiar todas las partículas |
toggle | Activar o desactivar un efecto |
Manage Physics
| Acción | Descripción |
|---|---|
register_group | Registrar un grupo de colisión |
set_collidable | Configurar si dos grupos pueden colisionar |
get_groups | Listar todos los grupos de colisión registrados |
Entorno del mundo
Herramientas incluidas
| Herramienta | Descripción |
|---|---|
manage_lighting | Configuración de Lighting, Atmosphere, Sky y hora del día |
manage_terrain | Creación/modificación de terreno y gestión de datos de vóxels |
spatial_query | Raycasts, búsqueda de suelo, validación de colocación y mapa de altura |
manage_camera | Consultar información de la cámara, mover el foco, vista sugerida y captura de pantalla del viewport en modo edición |
Flujos de trabajo principales
Configurar la atmósfera del mundo
"Crea un ambiente de atardecer. Cielo naranja, aumenta la densidad de la niebla y establece la hora en 18h"Establece la hora con time de manage_lighting, ajusta la niebla con atmosphere y cambia el color del cielo con sky.
Construir terreno
"Crea una colina de césped con radio 200 en el centro del mapa y llena los alrededores con agua"Crea la colina con fill_ball de manage_terrain y rellena la zona de agua alrededor con fill_block.
Validar la colocación
"Encuentra un terreno plano donde pueda colocar este edificio"Encuentra la posición adecuada con find_flat de spatial_query, verifica las colisiones con check_placement y confirma el resultado visualmente con focus_position de manage_camera.
Referencia de acciones
Manage Lighting
| Acción | Descripción |
|---|---|
lighting | Configurar las propiedades del servicio Lighting |
atmosphere | Configurar las propiedades de Atmosphere |
sky | Configurar las propiedades de Sky |
terrain_props | Configurar propiedades visuales/de agua del terreno |
time | Establecer la hora del día |
Manage Terrain
| Acción | Descripción |
|---|---|
fill_block | Rellenar terreno en forma de bloque |
fill_ball | Rellenar terreno en forma de esfera |
fill_cylinder | Rellenar terreno en forma de cilindro |
fill_wedge | Rellenar terreno en forma de cuña |
clear_region | Limpiar el terreno de una región |
clear_bounds | Limpiar el terreno de un límite |
replace_material | Reemplazar el material de una región |
colors_get | Obtener los colores de los materiales |
colors_set | Establecer los colores de los materiales |
read_voxel | Leer datos de un solo vóxel |
read_voxels | Leer datos de vóxels en masa |
write_voxels | Escribir datos de vóxels en masa |
generate | Generar terreno procedural |
smooth | Suavizar el terreno |
Spatial Query
| Acción | Descripción |
|---|---|
raycast | Lanzar un solo rayo |
find_ground | Encontrar la posición del suelo bajo un punto |
check_placement | Verificar si una colocación no tiene colisiones |
multi_raycast | Lanzar múltiples rayos en lote |
scan_area | Generar un mapa de altura de un área |
find_flat | Encontrar una zona plana para construir |
find_spawn | Encontrar una posición de aparición adecuada |
analyze_walkable | Analizar una cuadrícula de área transitable |
spatial_map | Obtener las posiciones de todas las BaseParts |
find_space | Encontrar espacio vacío para un objeto |
bounds | Obtener el bounding box de una instancia |
snap_grid | Ajustar una posición a la cuadrícula |
collision | Verificar colisión AABB |
Manage Camera (Mixto)
| Acción | Descripción |
|---|---|
info | Obtener la posición, rotación, FOV y tamaño del viewport de la cámara |
focus_path | Mover el foco de la cámara a una instancia |
focus_position | Mover el foco de la cámara a una posición |
suggest | Obtener una vista de cámara sugerida para un objetivo |
screenshot | Capturar el viewport del modo edición actual de Studio como imagen PNG (solo modo edición) |