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 | Tier | Descripción |
|---|---|---|
manage_assets | Pro | Búsqueda en Creator Store, inserción de modelos/paquetes, información de assets |
manage_tween | Pro | Crear, reproducir, pausar y cancelar tweens |
manage_animation | Pro | Cargar, reproducir, detener animaciones y consultar tracks |
manage_audio | Pro | Reproducir/detener/pausar sonidos, configurar audio listener |
manage_effects | Pro | Emitir partículas, limpiar y alternar efectos |
manage_physics | Pro | 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 (Pro)
| Acción | Descripción | Tier |
|---|---|---|
insert | Insertar un modelo por ID de asset | Pro |
info | Obtener metadatos del asset | Pro |
search | Buscar en Creator Store | Pro |
search_insert | Buscar e insertar el primer resultado | Pro |
insert_free | Insertar un modelo gratuito | Pro |
insert_package | Insertar un paquete | Pro |
export | Exportar la selección actual | Pro |
Manage Tween (Pro)
| Acción | Descripción | Tier |
|---|---|---|
create | Crear un tween con propiedades objetivo | Pro |
play | Reproducir el tween creado | Pro |
pause | Pausar el tween en ejecución | Pro |
cancel | Cancelar el tween | Pro |
Manage Animation (Pro)
| Acción | Descripción | Tier |
|---|---|---|
load | Cargar una animación en un Humanoid/AnimationController | Pro |
play | Reproducir el track de animación cargado | Pro |
stop | Detener la animación en reproducción | Pro |
get_tracks | Listar todos los tracks de animación cargados | Pro |
Manage Audio (Pro)
| Acción | Descripción | Tier |
|---|---|---|
play | Reproducir un sonido (crea Sound si es necesario) | Pro |
stop | Detener el sonido en reproducción | Pro |
pause | Pausar el sonido en reproducción | Pro |
resume | Reanudar el sonido pausado | Pro |
set_listener | Configurar el tipo/objetivo del audio listener | Pro |
Manage Effects (Pro)
| Acción | Descripción | Tier |
|---|---|---|
emit | Emitir partículas desde un ParticleEmitter | Pro |
clear | Limpiar todas las partículas | Pro |
toggle | Activar o desactivar un efecto | Pro |
Manage Physics (Pro)
| Acción | Descripción | Tier |
|---|---|---|
register_group | Registrar un grupo de colisión | Pro |
set_collidable | Configurar si dos grupos pueden colisionar | Pro |
get_groups | Listar todos los grupos de colisión registrados | Pro |
Entorno del mundo
Herramientas incluidas
| Herramienta | Tier | Descripción |
|---|---|---|
manage_lighting | Pro | Configuración de Lighting, Atmosphere, Sky y hora del día |
manage_terrain | Pro | Creación/modificación de terreno y gestión de datos de vóxels |
spatial_query | Pro | Raycasts, búsqueda de suelo, validación de colocación y mapa de altura |
manage_camera | Mixto | 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 (Pro)
"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 (Pro)
"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 (Pro)
"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 (Pro)
| Acción | Descripción | Tier |
|---|---|---|
lighting | Configurar las propiedades del servicio Lighting | Pro |
atmosphere | Configurar las propiedades de Atmosphere | Pro |
sky | Configurar las propiedades de Sky | Pro |
terrain_props | Configurar propiedades visuales/de agua del terreno | Pro |
time | Establecer la hora del día | Pro |
Manage Terrain (Pro)
| Acción | Descripción | Tier |
|---|---|---|
fill_block | Rellenar terreno en forma de bloque | Pro |
fill_ball | Rellenar terreno en forma de esfera | Pro |
fill_cylinder | Rellenar terreno en forma de cilindro | Pro |
fill_wedge | Rellenar terreno en forma de cuña | Pro |
clear_region | Limpiar el terreno de una región | Pro |
clear_bounds | Limpiar el terreno de un límite | Pro |
replace_material | Reemplazar el material de una región | Pro |
colors_get | Obtener los colores de los materiales | Pro |
colors_set | Establecer los colores de los materiales | Pro |
read_voxel | Leer datos de un solo vóxel | Pro |
read_voxels | Leer datos de vóxels en masa | Pro |
write_voxels | Escribir datos de vóxels en masa | Pro |
generate | Generar terreno procedural | Pro |
smooth | Suavizar el terreno | Pro |
Spatial Query (Pro)
| Acción | Descripción | Tier |
|---|---|---|
raycast | Lanzar un solo rayo | Pro |
find_ground | Encontrar la posición del suelo bajo un punto | Pro |
check_placement | Verificar si una colocación no tiene colisiones | Pro |
multi_raycast | Lanzar múltiples rayos en lote | Pro |
scan_area | Generar un mapa de altura de un área | Pro |
find_flat | Encontrar una zona plana para construir | Pro |
find_spawn | Encontrar una posición de aparición adecuada | Pro |
analyze_walkable | Analizar una cuadrícula de área transitable | Pro |
spatial_map | Obtener las posiciones de todas las BaseParts | Pro |
find_space | Encontrar espacio vacío para un objeto | Pro |
bounds | Obtener el bounding box de una instancia | Pro |
snap_grid | Ajustar una posición a la cuadrícula | Pro |
collision | Verificar colisión AABB | Pro |
Manage Camera (Mixto)
| Acción | Descripción | Tier |
|---|---|---|
info | Obtener la posición, rotación, FOV y tamaño del viewport de la cámara | Basic |
focus_path | Mover el foco de la cámara a una instancia | Basic |
focus_position | Mover el foco de la cámara a una posición | Basic |
suggest | Obtener una vista de cámara sugerida para un objetivo | Basic |
screenshot | Capturar el viewport del modo edición actual de Studio como imagen PNG (solo modo edición) | Pro |