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 | Descrição |
|---|---|
manage_assets | Pesquisa no Creator Store, inserção de modelos/pacotes, informações de assets |
manage_tween | Criar, reproduzir, pausar e cancelar tweens |
manage_animation | Carregar, reproduzir, parar animações e consultar tracks |
manage_audio | Reproduzir/parar/pausar sons, configurar listener de áudio |
manage_effects | Emitir partículas, limpar, ativar/desativar |
manage_physics | 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
| Ação | Descrição |
|---|---|
insert | Inserir modelo por ID de asset |
info | Obter metadados do asset |
search | Pesquisar no Creator Store |
search_insert | Pesquisar e inserir o primeiro resultado |
insert_free | Inserir modelo gratuito |
insert_package | Inserir pacote |
export | Exportar seleção atual |
Manage Tween
| Ação | Descrição |
|---|---|
create | Criar tween com propriedades alvo |
play | Reproduzir tween criado |
pause | Pausar tween em execução |
cancel | Cancelar tween |
Manage Animation
| Ação | Descrição |
|---|---|
load | Carregar animação em Humanoid/AnimationController |
play | Reproduzir track de animação carregada |
stop | Parar animação em reprodução |
get_tracks | Listar todas as tracks de animação carregadas |
Manage Audio
| Ação | Descrição |
|---|---|
play | Reproduzir som (cria Sound se necessário) |
stop | Parar som em reprodução |
pause | Pausar som em reprodução |
resume | Retomar som pausado |
set_listener | Configurar tipo/alvo do listener de áudio |
Manage Effects
| Ação | Descrição |
|---|---|
emit | Emitir partículas do ParticleEmitter |
clear | Limpar todas as partículas |
toggle | Ativar ou desativar efeito |
Manage Physics
| Ação | Descrição |
|---|---|
register_group | Registrar grupo de colisão |
set_collidable | Configurar se dois grupos podem colidir |
get_groups | Listar todos os grupos de colisão registrados |
Ambiente do Mundo
Ferramentas Incluídas
| Ferramenta | Descrição |
|---|---|
manage_lighting | Configurar Lighting, Atmosphere, Sky e horário |
manage_terrain | Criar/modificar terreno e gerenciar dados de voxel |
spatial_query | Raycast, localizar terreno, validar posicionamento, heightmap |
manage_camera | 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
"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
"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
"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
| Ação | Descrição |
|---|---|
lighting | Configurar propriedades do serviço Lighting |
atmosphere | Configurar propriedades do Atmosphere |
sky | Configurar propriedades do Sky |
terrain_props | Configurar propriedades visuais da água/terreno |
time | Configurar horário |
Manage Terrain
| Ação | Descrição |
|---|---|
fill_block | Preencher terreno em forma de bloco |
fill_ball | Preencher terreno em forma de esfera |
fill_cylinder | Preencher terreno em forma de cilindro |
fill_wedge | Preencher terreno em forma de cunha |
clear_region | Limpar terreno de uma região |
clear_bounds | Limpar terreno dos limites |
replace_material | Substituir material de uma região |
colors_get | Obter cores dos materiais |
colors_set | Definir cores dos materiais |
read_voxel | Ler dados de um único voxel |
read_voxels | Ler dados de voxels em massa |
write_voxels | Escrever dados de voxels em massa |
generate | Gerar terreno proceduralmente |
smooth | Suavizar terreno |
Spatial Query
| Ação | Descrição |
|---|---|
raycast | Lançar um único raio |
find_ground | Encontrar posição do terreno abaixo de um ponto |
check_placement | Verificar se o posicionamento está livre de colisões |
multi_raycast | Lançar vários raios em lote |
scan_area | Gerar heightmap de uma área |
find_flat | Encontrar área plana para construção |
find_spawn | Encontrar posição de spawn adequada |
analyze_walkable | Analisar grade de área transitável |
spatial_map | Obter posições de todos os BaseParts |
find_space | Encontrar espaço vazio para um objeto |
bounds | Obter bounding box de uma instância |
snap_grid | Ajustar posição para a grade |
collision | Verificar colisão AABB |
Manage Camera (Misto)
| Ação | Descrição |
|---|---|
info | Obter posição, rotação, FOV e tamanho do viewport da câmera |
focus_path | Mover foco da câmera para uma instância |
focus_position | Mover foco da câmera para uma posição |
suggest | Obter visualização de câmera sugerida para um alvo |
screenshot | Capturar o viewport atual do Studio no modo Edit como imagem PNG (somente modo Edit) |