에셋 삽입, 트윈 애니메이션, 오디오, 파티클 이펙트, 물리 충돌 그룹, 조명·지형·공간 쿼리·카메라로 게임 월드를 구축합니다.
에셋 & 오브젝트 연출
포함된 도구
| 도구 | 티어 | 설명 |
|---|---|---|
manage_assets | Pro | Creator Store 검색, 모델/패키지 삽입, 에셋 정보 |
manage_tween | Pro | 트윈 생성, 재생, 일시정지, 취소 |
manage_animation | Pro | 애니메이션 로드, 재생, 정지, 트랙 조회 |
manage_audio | Pro | 사운드 재생/정지/일시정지, 오디오 리스너 설정 |
manage_effects | Pro | 파티클 방출, 초기화, 토글 |
manage_physics | Pro | 충돌 그룹 등록, 충돌 여부 설정 |
주요 워크플로우
에셋으로 씬 구성
"Creator Store에서 '나무' 모델을 검색해서 Workspace에 3개 배치해줘"manage_assets의 search_insert로 검색과 삽입을 한 번에 처리합니다.
인터랙티브 연출
"문을 클릭하면 3초에 걸쳐 열리는 트윈을 만들어줘"manage_tween의 create로 트윈을 정의하고 play로 재생합니다. 동시에 manage_audio의 play로 문 여는 효과음을 추가합니다.
파티클 + 사운드 조합
"보스 등장 시 폭발 파티클과 함께 효과음을 재생해줘"manage_effects의 emit으로 파티클을 방출하고, manage_audio의 play로 사운드를 동시에 재생합니다.
액션 레퍼런스
Manage Assets (Pro)
| 액션 | 설명 | 티어 |
|---|---|---|
insert | 에셋 ID로 모델 삽입 | Pro |
info | 에셋 메타데이터 가져오기 | Pro |
search | Creator Store 검색 | Pro |
search_insert | 검색하여 첫 번째 일치 항목 삽입 | Pro |
insert_free | 무료 모델 삽입 | Pro |
insert_package | 패키지 삽입 | Pro |
export | 현재 선택 내보내기 | Pro |
Manage Tween (Pro)
| 액션 | 설명 | 티어 |
|---|---|---|
create | 대상 속성을 가진 트윈 생성 | Pro |
play | 생성된 트윈 재생 | Pro |
pause | 실행 중인 트윈 일시정지 | Pro |
cancel | 트윈 취소 | Pro |
Manage Animation (Pro)
| 액션 | 설명 | 티어 |
|---|---|---|
load | Humanoid/AnimationController에 애니메이션 로드 | Pro |
play | 로드된 애니메이션 트랙 재생 | Pro |
stop | 재생 중인 애니메이션 정지 | Pro |
get_tracks | 로드된 모든 애니메이션 트랙 나열 | Pro |
Manage Audio (Pro)
| 액션 | 설명 | 티어 |
|---|---|---|
play | 사운드 재생 (필요시 Sound 생성) | Pro |
stop | 재생 중인 사운드 정지 | Pro |
pause | 재생 중인 사운드 일시정지 | Pro |
resume | 일시정지된 사운드 재개 | Pro |
set_listener | 오디오 리스너 타입/대상 설정 | Pro |
Manage Effects (Pro)
| 액션 | 설명 | 티어 |
|---|---|---|
emit | ParticleEmitter에서 파티클 방출 | Pro |
clear | 모든 파티클 초기화 | Pro |
toggle | 효과 활성화 또는 비활성화 | Pro |
Manage Physics (Pro)
| 액션 | 설명 | 티어 |
|---|---|---|
register_group | 충돌 그룹 등록 | Pro |
set_collidable | 두 그룹이 충돌할 수 있는지 설정 | Pro |
get_groups | 등록된 모든 충돌 그룹 나열 | Pro |
월드 환경
포함된 도구
| 도구 | 티어 | 설명 |
|---|---|---|
manage_lighting | Pro | Lighting, Atmosphere, Sky, 시간대 설정 |
manage_terrain | Pro | 지형 생성/수정/복셀 데이터 관리 |
spatial_query | Pro | 레이캐스트, 지면 탐색, 배치 검증, 높이맵 |
manage_camera | Mixed | 카메라 정보 조회, 포커스 이동, 추천 뷰, 에디트 모드 뷰포트 스크린샷 |
주요 워크플로우
월드 분위기 설정 (Pro)
"해질녘 분위기로 바꿔줘. 주황색 하늘, 안개 밀도 높이고, 시간대는 18시로 설정"manage_lighting의 time으로 시간대 설정, atmosphere로 안개 조정, sky로 하늘 컬러를 변경합니다.
지형 빌딩 (Pro)
"맵 중앙에 반경 200의 잔디 언덕을 만들고, 주변에 물을 채워줘"manage_terrain의 fill_ball로 언덕을 생성하고, fill_block으로 주변 물 영역을 채웁니다.
배치 검증 (Pro)
"이 건물을 놓을 수 있는 평평한 땅을 찾아줘"spatial_query의 find_flat으로 적합한 위치를 찾고, check_placement로 충돌 여부를 확인한 뒤, manage_camera의 focus_position으로 결과를 시각적으로 확인합니다.
액션 레퍼런스
Manage Lighting (Pro)
| 액션 | 설명 | 티어 |
|---|---|---|
lighting | Lighting 서비스 속성 설정 | Pro |
atmosphere | Atmosphere 속성 설정 | Pro |
sky | Sky 속성 설정 | Pro |
terrain_props | Terrain 물/시각 속성 설정 | Pro |
time | 시간대 설정 | Pro |
Manage Terrain (Pro)
| 액션 | 설명 | 티어 |
|---|---|---|
fill_block | 블록 형태의 지형 채우기 | Pro |
fill_ball | 구 형태의 지형 채우기 | Pro |
fill_cylinder | 원통 형태의 지형 채우기 | Pro |
fill_wedge | 쐐기 형태의 지형 채우기 | Pro |
clear_region | 영역의 지형 초기화 | Pro |
clear_bounds | 경계의 지형 초기화 | Pro |
replace_material | 영역의 재질 교체 | Pro |
colors_get | 재질 색상 가져오기 | Pro |
colors_set | 재질 색상 설정 | Pro |
read_voxel | 단일 복셀 데이터 읽기 | Pro |
read_voxels | 대량 복셀 데이터 읽기 | Pro |
write_voxels | 대량 복셀 데이터 쓰기 | Pro |
generate | 절차적 지형 생성 | Pro |
smooth | 지형 부드럽게 하기 | Pro |
Spatial Query (Pro)
| 액션 | 설명 | 티어 |
|---|---|---|
raycast | 단일 광선 투사 | Pro |
find_ground | 지점 아래 지면 위치 찾기 | Pro |
check_placement | 배치가 충돌 없는지 확인 | Pro |
multi_raycast | 여러 광선 일괄 투사 | Pro |
scan_area | 영역의 높이맵 생성 | Pro |
find_flat | 건축을 위한 평평한 영역 찾기 | Pro |
find_spawn | 적절한 스폰 위치 찾기 | Pro |
analyze_walkable | 이동 가능 영역 그리드 분석 | Pro |
spatial_map | 모든 BasePart 위치 가져오기 | Pro |
find_space | 오브젝트를 위한 빈 공간 찾기 | Pro |
bounds | 인스턴스의 바운딩 박스 가져오기 | Pro |
snap_grid | 위치를 그리드에 스냅 | Pro |
collision | AABB 충돌 확인 | Pro |
Manage Camera (Mixed)
| 액션 | 설명 | 티어 |
|---|---|---|
info | 카메라 위치, 회전, FOV, 뷰포트 크기 가져오기 | Basic |
focus_path | 카메라를 인스턴스에 포커스 이동 | Basic |
focus_position | 카메라를 위치에 포커스 이동 | Basic |
suggest | 대상에 대한 추천 카메라 뷰 가져오기 | Basic |
screenshot | 현재 Studio 에디트 모드 뷰포트를 PNG 이미지로 캡처 (에디트 모드 전용) | Pro |