WEPPY Roblox AI Toolkit: 로블록스 스튜디오용 AI 개발 도구

WEPPY Roblox AI Toolkit은 로블록스 Studio용 AI 개발 제품입니다. 이 툴킷에는 AI 앱 연결을 위한 WEPPY MCP Server와 실시간 Studio 제어를 위한 WEPPY Roblox Studio Plugin이 포함되어 있습니다. Claude Code, Codex, 그리고 Antigravity는 클라이언트 네이티브 설정 및 워크플로우 가이드를 위해 선택적 WEPPY AI Agent Plugin도 설치할 수 있습니다.

멀티 플레이스(Multi-Place) 스튜디오 작업 · 로블록스로 생성된 에셋 가져오기 · 양방향 동기화 · 자동 플레이 테스트 · UI 스튜디오

English | 한국어 | 日本語 | Español | Português | Bahasa Indonesia | Deutsch

Claude, Codex, Gemini와 같은 AI 코딩 에이전트는 강력하지만, Roblox Studio 내부의 어떤 것도 보거나 수정할 수 없습니다. DataModel, 스크립트, 지형(terrain), 조명(lighting) 등은 외부 도구에게는 보이지 않습니다. 브릿지(bridge) 없이는 AI가 생성한 코드 스니펫을 수동으로 붙여넣어야만 합니다.

WEPPY MCP Server는 AI 에이전트를 WEPPY Roblox Studio Plugin에 연결합니다. AI가 Studio 내부의 인스턴스, 스크립트, 속성(properties), 지형 등을 직접 생성하고 수정하며, 변경 사항은 즉시 Studio와 대시보드에 반영되어 무엇이 어떻게 바뀌었는지 정확히 확인할 수 있습니다.

WEPPY는 여러 Place에 걸쳐 분할된 Roblox 경험을 위해 구축되었습니다. 로비(Lobby), 게임(Game), 상점(Shop), 튜토리얼(Tutorial) 또는 기타 Place를 위해 최대 다섯 개의 Studio 창을 열고, 에이전트에게 사용할 Studio ID를 알려주기만 하면 됩니다. 한 번의 요청으로 컨텍스트를 다시 설명하거나 변경 사항을 수동으로 복사할 필요 없이 여러 Place를 업데이트할 수 있습니다.

에셋의 경우, 에이전트는 이미지를 생성하거나 준비하고, 이를 Asset Library에 저장하며, Roblox Open Cloud를 통해 업로드한 후, 반환된 asset URI를 Place에 적용할 수 있습니다. 그 결과는 '이 아이콘/데칼을 만들어라'에서 'Studio에서 보이게 한다'까지의 경로가 짧아집니다.

코드나 에셋 ID를 복사-붙여넣기 할 필요가 없습니다. AI가 작업을 수행하고, 사용자가 결과를 검토합니다.

웹 설치 페이지부터 시작하세요. 해당 플랫폼에 맞는 권장 한 줄 스크립트를 먼저 보여줍니다.

설치 페이지에서 한 줄 스크립트를 복사하여 터미널(Terminal) 또는 PowerShell에서 실행하세요.

macOS / Linux

macOS / Linux
curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex

이후 AI 앱을 다시 열고 Roblox Studio를 재시작하세요.

자동 WEPPY MCP Server 등록은 Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI, 그리고 Antigravity / Antigravity IDE / Antigravity CLI를 지원합니다.
Claude Code의 경우, 설치 프로그램이 WEPPY AI Agent Plugin도 함께 설치합니다. Codex의 경우, 플러그인 마켓플레이스를 추가한 후 플러그인 디렉토리에서 WEPPY AI Agent Plugin을 직접 설치하도록 요청합니다. Antigravity의 경우, AI 에이전트 플러그인은 Antigravity CLI와 agy plugin이 사용 가능한 경우에만 설치되며, 그렇지 않으면 설치 프로그램은 기존 MCP 연결을 유지합니다.

터미널이나 PowerShell 사용이 불편하다면, 동일한 설치 페이지에서 터미널이 필요 없는 웹 설치기를 사용하세요.

원라인 설치 또는 터미널 프리 웹 설치기가 작동하지 않는 경우, WEPPY MCP Server를 AI 앱에 수동으로 등록하세요.

다음 서버 명령어를 사용합니다:

npx -y @weppy/roblox-mcp@latest

자동 등록은 Claude Code, Claude Desktop, Cursor, Codex CLI, Codex App, Gemini CLI, 그리고 Antigravity / Antigravity IDE / Antigravity CLI를 지원합니다.

MCP와 호환되는 모든 AI 클라이언트가 작동합니다. 서버 명령어는

npx -y @weppy/roblox-mcp@latest
입니다.

Dola Desktop은 로컬 STDIO Custom Connector를 통해 연결됩니다. Dola의 Pro 모드와 로컬 컴퓨터가 필요합니다. Dola 매뉴얼 설정 가이드를 따르세요. 원라인 설치기와 GitHub 마켓플레이스 플러그인은 Dola를 구성하지 않습니다.

WEPPY Roblox AI Toolkit은 WEPPY MCP Server를 통해 모든 지원되는 AI 앱에 연결됩니다. Claude Code, Codex, 그리고 Antigravity는 Studio 제어, 동기화 및 에셋을 위한 클라이언트 네이티브 설정과 워크플로우 가이드를 위해 추가적으로 WEPPY AI Agent Plugin을 설치할 수 있습니다.

Claude Code

Claude Code

claude plugin marketplace add hope1026/weppy-roblox-mcp --scope user
claude plugin install weppy-roblox-ai-toolkit@hope1026-roblox-mcp --scope user

Codex

codex plugin marketplace add hope1026/weppy-roblox-mcp

Codex 마켓플레이스를 추가한 후, Codex를 재시작하고 플러그인 디렉터리를 열어 WEPPY AI Agent Plugin을 설치하세요.

Antigravity

WEPPY AI Agent Plugin을 설치하려면 Antigravity CLI가 필요합니다. 원라인 설치기는 agy plugin install를 사용하여 최신 공개 GitHub 릴리스로 검증하고, agy plugin list로 이를 확인한 다음, 검증된 스킬 전용 페이로드를 지원되는 IDE 표면에 게시합니다. 기존 설치는 실행할 때마다 대체되므로 항상 최신 릴리스로 수렴될 수 있습니다.

설치기는 설치됨(installed), 업데이트됨(updated), 재설치됨(reinstalled), 복구됨(repaired), 폴백(fallback), 실패함(failed), 또는 건너뜀(skipped)으로 결과를 보고합니다. CLI가 누락된 경우, 공유 MCP 연결은 ~/.gemini/config/mcp_config.json에서 작동 상태를 유지하며 폴백을 보고합니다. 기존 플러그인은 절대 건너뛰기로 처리되지 않습니다. 이어서

AI는 Studio 내부의 스크립트(scripts), 인스턴스(instances), 속성(properties), 지형(terrain), 조명(lighting), 에셋(assets), 오디오(audio), 애니메이션(animation)을 직접 처리할 수 있습니다.

• "플레이어가 점프할 때 입자 효과 + 사운드 + 쿨다운 추가."
• "맵 중앙에 보스 아레나를 구축하고 충돌 방지 스폰 지점을 배치해라."
• "이 모듈 인터페이스를 변경하고 모든 종속 스크립트를 업데이트해라."
• "산과 강으로 지형을 생성한 다음, 평평한 지역에 스폰 지점을 배치해라."
• "Creator Store에서 검 모델을 검색하여 StarterPack에 삽입해라."

많은 Roblox 경험은 단일 Place로 구성되지 않습니다. WEPPY는 최대 다섯 개의 Studio 창을 하나의 MCP 서버에 연결하고, Studio ID를 통해 작업을 라우팅할 수 있게 해줍니다.

• 로비(Lobby), 게임(Game), 상점(Shop), 또는 튜토리얼(Tutorial)과 같은 최대 다섯 개의 Roblox Studio 창 열기
• 한 번 요청하기: "studio-1에 이벤트 포털을 Lobby에 추가해라. studio-2에는 도착 지점과 가이드 UI를 Game에 추가해라."
• 대시보드 연결(Dashboard Connection)을 사용하여 모든 AI 에이전트, Studio 대상(Studio Target), 복사 가능한 Studio ID, 및 라우팅 상태 확인
• Roblox 공식 Studio MCP 가이드에서도 문서화된 멀티-Studio 흐름으로 작업하며, WEPPY의 대시보드가 최상위에 표시됨

AI 앱이 PNG 또는 JPG 파일을 생성할 수 있다면, 이 워크플로우를 위한 새 이미지를 만들 수 있습니다. 그렇지 않다면, 가지고 있는 이미지로 시작하여 에셋 라이브러리(Asset Library)에 등록한 후 업로드하세요.

WEPPY Assets는 자연어 기반의 에셋 요청을 Studio에서 사용할 준비가 된 결과물로 변환합니다.

• "상점 버튼용 보석 아이콘을 생성하고, Roblox에 업로드한 다음, Lobby Place의 ShopButton 이미지에 적용해라."
• 생성된 이미지(images), 데칼(Decals), RBXM 파일을 로컬 에셋 라이브러리(Asset Library)에 저장
• Roblox Open Cloud를 통해 이미지를 업로드하고 플레이스별 또는 공유 가능한 에셋을 재사용
• 반환된 에셋 URI를 ImageLabel, Decal, Texture 또는 기타 Studio 속성에 적용합니다.

AI는 사용자의 Studio 프로젝트 로컬 미러(local mirror)를 읽습니다. Studio에 적용하기 전에 보류 중인 로컬 변경 사항을 검토하세요.

• 첫 사용 시 동기화(Sync)는 기본적으로 꺼져 있습니다(Off). 연결 시 시작하는 옵션 역시 '꺼짐'(Off)입니다. 저장된 설정이 항상 우선하며, 이는 '꺼짐'으로 저장된 값도 포함합니다. 첫 사용 워크플로우는 Studio가 우선이며, 따라서 첫 동기화에서는 Studio를 소스로 간주합니다.
• 'Studio 우선(Studio First)', '양방향 검토(Bidirectional Review)', '로컬 코드(Local Code)', 'Studio 월드(Studio World)', 또는 '사용자 지정(Custom)' 중에서 선택할 수 있습니다. 사용자 지정은 네 가지 의미론적 범위(semantic scopes)로 변경됩니다: 스크립트 소스(Script Source), 속성(Properties), 구조(Structure), 및 서비스 속성(Service Properties).
• 콘텐츠 변경 사항과 구조 변경 사항의 적용 모드는 범위 방향과는 별도로 표시됩니다. 로컬 파일 삭제는 기본적으로 Studio 인스턴스를 삭제하지 않으며, Studio에 삭제를 적용하려면 추가적인 옵트인(opt-in)이 필요하며 이는 UI Studio 히스토리 정리와는 별개입니다.
  **변경 사항 검토(Review Changes)**에는 수동 적용을 기다리는 로컬 편집 목록이 표시됩니다. **충돌 검토(Review Conflicts)**에는 Studio와 로컬에서 다르게 변경된 파일 목록이 표시되며, 둘 중 하나를 선택하기 전에 두 버전을 비교해야 합니다.- Basic 버전은 Studio-to-local 동기화를 사용합니다. Pro 버전은 더 풍부한 워크플로우 방향, 히스토리, 그리고 최대 다섯 개의 Place에 대한 지원을 추가합니다.
• WEPPY MCP Server와 WEPPY Roblox Studio Plugin은 반드시 같은 릴리스(release)에서 제공되어야 합니다. 두 가지를 함께 업데이트하고, 버전이 일치하지 않으면 재연결하기 전에 Roblox Studio를 다시 시작해야 합니다.

AI는 게임을 시작하지 않고도 원시 Luau 소스 또는 기존 스크립트를 검사하여 구문 오류(syntax errors)를 확인할 수 있습니다. 독립적인 유효성 검사(Standalone validation)는 Basic 및 Pro 버전에서 사용할 수 있습니다.

• AI에게 소스 또는 스크립트 경로를 요청하여 모든 구문 진단(syntax diagnostics)을 한 응답으로 받을 수 있도록 합니다.
• 지원되는 스크립트 쓰기 후 실제 저장된 소스를 확인하려면 **제어(Controls) → Luau 구문 유효성 검사(Luau Syntax Validation)**를 켜야 합니다. 기본값은 꺼져 있습니다 - 대시보드 설정이 적용됩니다. 도구 호출(tool call)이 다른 validate 값을 요청하는 경우, 쓰기는 대시보드 정책을 따르며 해당 설정 경로와 함께 경고를 반환합니다. 자동 유효성 검사(Automatic valid checks)는 일반적인 쓰기 응답을 변경하지 않습니다. 유효하지 않거나 사용할 수 없는 검사는 세부 정보를 추가하며, 명시적으로 일치하는 validate=true

또한 전체 유효한 세부 정보를 반환합니다. 구문 오류나 사용 불가능한 파서는 성공적인 스크립트 쓰기를 되돌리지 않습니다.

첫 번째 검증은 보조 파서를 다운로드하여 정확히 luau-parser-v1.0.0을 가져옵니다.

WASM 릴리스를 하고 이를 로컬에 캐싱합니다. 호환되는 로컬 luau-compile을 폴백(fallback)으로 사용할 수 있습니다. 스크립트 소스는 사용자의 컴퓨터에서 파싱되며 원격 검증 서비스로 전송되지 않습니다. 다운로드 요청은 오직 파서 아티팩트를 가져옵니다. 매우 큰 스크립트는 일부 읽기 및 파싱 시간을 추가할 수 있습니다.

일반적인 런타임 검사는 구조화된 Play 세션을 사용합니다. AI는 게임 UI를 기다리고, 그 의미론적 구조와 지오메트리를 검사하며, 가상 입력을 전달하고, UI 응답을 관찰하며, 별도의 증거 단계에서 결과 서버 상태를 검증할 수 있습니다. 로컬 대시보드는 저장된 결과를 서버, 클라이언트 UI, 상호 작용 및 시각적 증거별로 그룹화하여 무엇이 통과했고 그 이유가 무엇인지 검토할 수 있게 합니다.

동일한 Playtest 페이지에는 개발 전용 값을 위한 테스트 값(Test Values) 작업 공간도 포함되어 있습니다. 다양한 테스트 설정을 위해 여러 Place-범위 프로필을 생성합니다. 대시보드는 각 Place에 대해 마지막으로 선택된 프로필을 기억합니다. Play 또는 Run이 활성화된 동안 게임을 재시작하지 않고도 프로필을 전환, 생성, 편집 또는 삭제할 수 있습니다. 전환 시 현재 게임 값은 유지되고 제어(controls), 관찰 값(Watch Values), 및 세션에 표시되는 작업(Actions)만 변경됩니다. 제어와 읽기 전용 관찰 내용은 하나의 검색 가능하고 페이지가 지정된 목록에 나타나므로, 대규모 프로필도 쉽게 스캔할 수 있습니다. **값 관리(Manage values)**를 사용하여 프로젝트 테스트 어댑터에서 발견된 항목을 추가하거나, 런타임 경로 및 현재 Studio 선택을 사용하여 직접 값을 사용할 수 있습니다. 오래되었거나 연결이 끊긴 관찰 내용은 현재 값으로 제시되는 대신 마지막으로 관찰된 값으로 표시됩니다.

Pro 버전에서는 프로필의 **액션(Actions)**을 사용하여 Play 중 준비된 게임 작업을 실행할 수 있습니다. 예를 들어, 값을 변경하거나 검토된 테스트 어댑터(Test Adapter)를 호출하는 방식입니다. 액션은 값 변경과는 별도로 그 결과를 보고합니다. **모두 초기화(Reset all)**는 되돌릴 수 있는 값의 변경 사항을 복원하며, 저장된 게임 데이터, 사망 기록, 보상 또는 액션에 의해 발생한 외부 요청은 취소할 수 없습니다.

Basic 버전에는 프로필 생성 및 실시간 런타임 관찰 기능이 포함되어 있습니다. Pro 버전은 Play 중 타입 지정 값 변경, 롤백(rollback), 모두 초기화(Reset all), 그리고 실제 저장된 **자동 테스트 결과(Automated Test Results)**를 추가합니다. 플레이 테스트 페이지에서는 Pro의 추가 기능을 설명하고 사용 가능한 요금제 및 구매 옵션으로 직접 연결됩니다.

Studio Stop은 Play/Run 인스턴스의 변경 사항을 폐기합니다. 런타임이 활성화된 동안, **모두 초기화(Reset all)**는 해당 세션에서 모든 프로필을 통해 변경된 되돌릴 수 있는 값을 복원하며, 부분적으로 실패한 트랜잭션은 롤백됩니다. 시작 시 값을 캐싱하거나 도메인 작업이 필요한 게임의 경우, 선택적 대시보드 메타데이터를 통해 검토된 프로젝트 테스트 어댑터(Project Test Adapter) 메서드를 노출할 수 있습니다. 이 대시보드는 메타데이터를 검증하고, 등록 출처를 보여주며, 각 어댑터 제어에 읽기 전용 관찰자(observer)를 연결합니다. 프로필 참조를 제거해도 어댑터 소스는 그대로 유지됩니다.