WEPPY가 설치되고 연결되면 AI 에이전트로 Roblox Studio를 직접 조작할 수 있습니다. 이 페이지는 첫 번째 작업을 시작하고 결과를 안전하게 검증하는 기본 흐름을 안내합니다.
기본 워크플로우
1단계 — 연결 확인
작업을 시작하기 전에 연결 상태부터 확인합니다.
연결 상태 확인해줘
또는 연결 확인 페이지의 절차를 따르세요. Roblox Studio 플러그인의 Connect 상태를 먼저 확인하고, 자세한 정보가 필요하면 대시보드 Connection 탭을 봅니다.
2단계 — 첫 작업 요청
간단한 작업으로 시작합니다. AI 에이전트에게 자연어로 지시하세요.
Workspace에 빨간 파트를 하나 만들어줘. 크기는 5x1x5로 설정해줘.
ServerScriptService에 'GameManager' ModuleScript를 만들어줘.
Lighting 시간대를 오후 6시로 설정해줘.
3단계 — 변경 결과 확인
AI가 작업을 수행하면 Studio에 바로 반영됩니다. 대시보드의 Changelog에서 변경 내용을 Before & After로 확인할 수 있습니다.
자세한 방법은 변경 히스토리 페이지를 참고하세요.
4단계 — 더 복잡한 작업으로
검증이 완료되면 한 번에 여러 변경이 일어나는 작업으로 넘어갑니다.
플레이어 점프 시 파티클과 사운드를 넣고, 쿨타임도 같이 넣어줘.
맵 중앙에 보스 아레나를 만들고, 스폰 포인트도 충돌 없이 배치해줘.
이 모듈 인터페이스를 바꾸고 참조하는 스크립트를 전부 함께 수정해줘.
핵심 도구 예시
인스턴스 생성
Workspace에 'Platform' Part를 만들고 Position을 (0, 5, 0)으로 설정해줘.
내부적으로 mutate_instances 도구의 create 액션과 manage_properties 도구의 set 액션이 사용됩니다.
스크립트 작성
ServerScriptService에 'PlayerController' Script를 만들고, 플레이어가 스폰될 때 메시지를 출력하는 코드를 넣어줘.
내부적으로 manage_scripts 도구의 create, set_source 액션이 사용됩니다.
에셋 삽입
Creator Store에서 'Tree' 모델을 검색해서 Workspace에 넣어줘.
내부적으로 manage_assets 도구의 search_insert 액션이 사용됩니다 (Pro 전용).
배치 실행
여러 작업을 한 번에 처리할 때 batch_execute를 사용하면 AI 토큰을 절약할 수 있습니다 (Pro 전용).
Sync를 활용한 대규모 변경
프로젝트 전체 구조를 기반으로 작업하려면 Sync를 먼저 활성화합니다. Sync가 켜져 있으면 AI가 로컬에 동기화된 파일을 기준으로 전체 구조를 이해하고, 여러 파일에 걸친 변경을 일관되게 수행합니다.
Sync 상태 확인하고, 최근 변경 기록 기준으로 위험한 변경만 요약해줘.
ServerScriptService 쪽 스크립트만 우선 리팩터링하고, 변경 이력까지 남겨줘.
자세한 내용은 양방향 Sync를 참고하세요.
도구 카테고리
AI 에게 시킬 수 있는 작업을 카테고리로 묶어 보여 줍니다. 자세한 사용법은 도구와 통계 페이지를 참고하세요.
| 카테고리 | 설명 |
|---|---|
| 인스턴스 & 속성 | 인스턴스 검색·생성·수정·삭제·복제, 속성·태그 관리 |
| 스크립트 & 코드 실행 | 스크립트 작성·수정, 임의 Luau 코드 실행 |
| 월드 환경 | 조명·대기권, 지형 생성·편집, 공간 쿼리·레이캐스트, 카메라 |
| 에셋 & 오브젝트 연출 | 에셋 검색·삽입, 트윈·애니메이션, 오디오, 파티클·이펙트, 물리 그룹 |
| 플레이테스트 & 자동 테스트 | Run / Play 모드 제어, 테스트 스크립트 자동 주입과 리포트 |
| 동기화 | Studio ↔ 로컬 파일 양방향 동기화, 멀티 Place |
| 시스템 & 디버깅 | 연결 확인, 로그 조회, 선택 관리, 배치 실행 |
티어 정책
- Basic — 인스턴스·속성·스크립트·선택·카메라·로그를 다루는 핵심 도구와 Studio → Local 단방향 Sync 까지 사용할 수 있습니다.
- Pro — 위 핵심 기능에 양방향 Sync, 대량 작업, 환경·연출, 공간 쿼리, 에셋, Playtest 자동화를 추가합니다.