Construa o mundo do jogo com inserção de assets, animação tween, áudio, efeitos de partículas, grupos de colisão física, iluminação/terreno/spatial query/câmera.
Assets & Apresentação de Objetos
Ferramentas Incluídas
| Ferramenta | Tier | Descrição |
|---|---|---|
manage_assets | Pro | Pesquisa no Creator Store, inserção de modelos/pacotes, informações de assets |
manage_tween | Pro | Criar, reproduzir, pausar e cancelar tweens |
manage_animation | Pro | Carregar, reproduzir, parar animações e consultar tracks |
manage_audio | Pro | Reproduzir/parar/pausar sons, configurar listener de áudio |
manage_effects | Pro | Emitir partículas, limpar, ativar/desativar |
manage_physics | Pro | Registrar grupos de colisão, configurar colisões |
Principais Fluxos de Trabalho
Montar cena com assets
"Pesquise o modelo 'árvore' no Creator Store e coloque 3 no Workspace"Processa pesquisa e inserção de uma vez com search_insert do manage_assets.
Apresentação interativa
"Crie um tween que abre uma porta em 3 segundos quando clicada"Defina o tween com create do manage_tween e reproduza com play. Ao mesmo tempo, adicione o efeito sonoro de abrir a porta com play do manage_audio.
Combinação de partículas + som
"Reproduza um efeito sonoro junto com partículas de explosão quando o chefe aparecer"Emita partículas com emit do manage_effects e reproduza o som simultaneamente com play do manage_audio.
Referência de Ações
Manage Assets (Pro)
| Ação | Descrição | Tier |
|---|---|---|
insert | Inserir modelo por ID de asset | Pro |
info | Obter metadados do asset | Pro |
search | Pesquisar no Creator Store | Pro |
search_insert | Pesquisar e inserir o primeiro resultado | Pro |
insert_free | Inserir modelo gratuito | Pro |
insert_package | Inserir pacote | Pro |
export | Exportar seleção atual | Pro |
Manage Tween (Pro)
| Ação | Descrição | Tier |
|---|---|---|
create | Criar tween com propriedades alvo | Pro |
play | Reproduzir tween criado | Pro |
pause | Pausar tween em execução | Pro |
cancel | Cancelar tween | Pro |
Manage Animation (Pro)
| Ação | Descrição | Tier |
|---|---|---|
load | Carregar animação em Humanoid/AnimationController | Pro |
play | Reproduzir track de animação carregada | Pro |
stop | Parar animação em reprodução | Pro |
get_tracks | Listar todas as tracks de animação carregadas | Pro |
Manage Audio (Pro)
| Ação | Descrição | Tier |
|---|---|---|
play | Reproduzir som (cria Sound se necessário) | Pro |
stop | Parar som em reprodução | Pro |
pause | Pausar som em reprodução | Pro |
resume | Retomar som pausado | Pro |
set_listener | Configurar tipo/alvo do listener de áudio | Pro |
Manage Effects (Pro)
| Ação | Descrição | Tier |
|---|---|---|
emit | Emitir partículas do ParticleEmitter | Pro |
clear | Limpar todas as partículas | Pro |
toggle | Ativar ou desativar efeito | Pro |
Manage Physics (Pro)
| Ação | Descrição | Tier |
|---|---|---|
register_group | Registrar grupo de colisão | Pro |
set_collidable | Configurar se dois grupos podem colidir | Pro |
get_groups | Listar todos os grupos de colisão registrados | Pro |
Ambiente do Mundo
Ferramentas Incluídas
| Ferramenta | Tier | Descrição |
|---|---|---|
manage_lighting | Pro | Configurar Lighting, Atmosphere, Sky e horário |
manage_terrain | Pro | Criar/modificar terreno e gerenciar dados de voxel |
spatial_query | Pro | Raycast, localizar terreno, validar posicionamento, heightmap |
manage_camera | Misto | Consultar informações da câmera, mover foco, sugerir visualização, screenshot do viewport no modo Edit |
Principais Fluxos de Trabalho
Definir atmosfera do mundo (Pro)
"Mude para uma atmosfera de pôr do sol. Céu laranja, aumente a densidade da névoa e defina o horário para 18h"Defina o horário com time do manage_lighting, ajuste a névoa com atmosphere e altere a cor do céu com sky.
Construir terreno (Pro)
"Crie uma colina de grama com raio 200 no centro do mapa e preencha os arredores com água"Crie a colina com fill_ball do manage_terrain e preencha a área de água ao redor com fill_block.
Validar posicionamento (Pro)
"Encontre um terreno plano para colocar este edifício"Encontre uma posição adequada com find_flat do spatial_query, confirme se há colisão com check_placement e verifique visualmente o resultado com focus_position do manage_camera.
Referência de Ações
Manage Lighting (Pro)
| Ação | Descrição | Tier |
|---|---|---|
lighting | Configurar propriedades do serviço Lighting | Pro |
atmosphere | Configurar propriedades do Atmosphere | Pro |
sky | Configurar propriedades do Sky | Pro |
terrain_props | Configurar propriedades visuais da água/terreno | Pro |
time | Configurar horário | Pro |
Manage Terrain (Pro)
| Ação | Descrição | Tier |
|---|---|---|
fill_block | Preencher terreno em forma de bloco | Pro |
fill_ball | Preencher terreno em forma de esfera | Pro |
fill_cylinder | Preencher terreno em forma de cilindro | Pro |
fill_wedge | Preencher terreno em forma de cunha | Pro |
clear_region | Limpar terreno de uma região | Pro |
clear_bounds | Limpar terreno dos limites | Pro |
replace_material | Substituir material de uma região | Pro |
colors_get | Obter cores dos materiais | Pro |
colors_set | Definir cores dos materiais | Pro |
read_voxel | Ler dados de um único voxel | Pro |
read_voxels | Ler dados de voxels em massa | Pro |
write_voxels | Escrever dados de voxels em massa | Pro |
generate | Gerar terreno proceduralmente | Pro |
smooth | Suavizar terreno | Pro |
Spatial Query (Pro)
| Ação | Descrição | Tier |
|---|---|---|
raycast | Lançar um único raio | Pro |
find_ground | Encontrar posição do terreno abaixo de um ponto | Pro |
check_placement | Verificar se o posicionamento está livre de colisões | Pro |
multi_raycast | Lançar vários raios em lote | Pro |
scan_area | Gerar heightmap de uma área | Pro |
find_flat | Encontrar área plana para construção | Pro |
find_spawn | Encontrar posição de spawn adequada | Pro |
analyze_walkable | Analisar grade de área transitável | Pro |
spatial_map | Obter posições de todos os BaseParts | Pro |
find_space | Encontrar espaço vazio para um objeto | Pro |
bounds | Obter bounding box de uma instância | Pro |
snap_grid | Ajustar posição para a grade | Pro |
collision | Verificar colisão AABB | Pro |
Manage Camera (Misto)
| Ação | Descrição | Tier |
|---|---|---|
info | Obter posição, rotação, FOV e tamanho do viewport da câmera | Basic |
focus_path | Mover foco da câmera para uma instância | Basic |
focus_position | Mover foco da câmera para uma posição | Basic |
suggest | Obter visualização de câmera sugerida para um alvo | Basic |
screenshot | Capturar o viewport atual do Studio no modo Edit como imagem PNG (somente modo Edit) | Pro |