@weppy/roblox-mcp 2.5.0 → 2.6.0

package/docs/ko/installation/ai-apps/claude-code.md

@@ -1,104 +0,0 @@
-# Claude Code 설정
-
-[Claude Code](https://claude.ai/code) (터미널 기반 AI 코딩 도구)에서 Roblox MCP를 사용하는 방법입니다.
-
-## 사전 요구사항
-
-- **Claude Code** 설치됨
-- **Roblox Studio 플러그인** 설치 완료
-
-## 설치
-
-```bash
-npm install -g @anthropic-ai/claude-code
-```
-
-## MCP 서버 등록
-
-### 방법 1: 마켓플레이스에서 설치 (권장)
-
-Claude Code 터미널에서 실행:
-
-```bash
-# 마켓플레이스 추가
-/plugin marketplace add hope1026/weppy-roblox-mcp
-
-# 플러그인 설치
-/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
-```
-
-설치 확인:
-```bash
-/plugin list
-```
-
-### 방법 2: 설정 파일 직접 편집
-
-`.mcp.json` 파일 생성:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-**설정 파일 위치:**
-
-| 범위 | 경로 |
-|------|------|
-| 프로젝트 | `<프로젝트>/.mcp.json` |
-| 글로벌 | `~/.claude/mcp.json` |
-
-## 자동 서버 관리
-
-Claude Code는 MCP 서버를 자동으로 관리합니다:
-
-- 필요할 때 자동 시작
-- 세션 종료 시 자동 정지
-- 별도 설정 불필요
-
-## 연결 테스트
-
-1. **Roblox Studio** 실행 → Plugins 탭 → **WEPPY** → **Connect**
-2. **Claude Code**에서 테스트:
-   ```
-   Roblox Studio에 파란 파트 만들어줘
-   ```
-
-## 문제 해결
-
-### 플러그인 설치 실패
-
-```bash
-# 캐시 정리 후 재시도
-/plugin cache clear
-/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
-```
-
-### 서버가 시작되지 않음
-
-1. Node.js 버전 확인 (18.0 이상 필요):
-   ```bash
-   node --version
-   ```
-
-2. 수동으로 서버 시작 테스트:
-   ```bash
-   npx -y @weppy/roblox-mcp
-   ```
-
-### MCP 도구가 보이지 않음
-
-Claude Code에서 확인:
-```
-사용 가능한 MCP 도구 목록 보여줘
-```
-
-## 참고 자료
-
-- [Claude Code 공식 문서](https://docs.anthropic.com/claude-code)

package/docs/ko/installation/ai-apps/codex-app.md

@@ -1,56 +0,0 @@
-# Codex App 설정
-
-[OpenAI Codex App](https://openai.com/codex/) (macOS)에서 Roblox MCP를 사용하는 방법입니다.
-
-> **2026년 2월 2일 출시** - 멀티 에이전트 워크플로우를 지원하는 네이티브 macOS 앱
-
-## 사전 요구사항
-
-- **Codex App** 설치됨 (macOS)
-- **Roblox Studio 플러그인** 설치 완료
-
-## MCP 서버 등록
-
-### Codex CLI 설정 자동 동기화
-
-Codex CLI에서 이미 MCP를 설정했다면 **추가 설정 없이** 앱에서 바로 사용 가능합니다.
-
-```
-CLI 세션 히스토리와 설정이 자동으로 앱에 동기화됩니다.
-```
-
-### 새로 설정하는 경우
-
-앱 내 **Settings** → **MCP Servers**에서 추가:
-
-```
-Server name: weppy-roblox-mcp
-Command: npx -y @weppy/roblox-mcp
-```
-
-## 연결 테스트
-
-1. **Roblox Studio** 실행 → Plugins 탭 → **WEPPY** → **Connect**
-2. **Codex App**에서 새 대화 시작 후 테스트:
-   ```
-   Roblox Studio에서 현재 선택된 것을 알려줘
-   ```
-
-## 문제 해결
-
-### 서버가 시작되지 않을 때
-
-MCP 서버를 직접 실행하여 오류를 확인하세요:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### 연결 실패
-
-- Roblox Studio 플러그인이 **Connected** 상태인지 확인
-- 포트 3002가 방화벽에 의해 차단되지 않았는지 확인
-
-## 참고 자료
-
-- [Codex App 소개](https://openai.com/index/introducing-the-codex-app/)
-- [Codex MCP 공식 문서](https://developers.openai.com/codex/mcp/)

package/docs/ko/installation/ai-apps/codex-cli.md

@@ -1,67 +0,0 @@
-# Codex CLI 설정
-
-[OpenAI Codex CLI](https://github.com/openai/codex) (터미널 기반 AI 코딩 도구)에서 Roblox MCP를 사용하는 방법입니다.
-
-## 사전 요구사항
-
-- **Node.js** (v18.0.0 이상)
-- **Roblox Studio 플러그인** 설치 완료
-
-## 설치
-
-```bash
-npm install -g @openai/codex
-```
-
-## MCP 서버 등록
-
-### 방법 1: CLI 명령어 (권장)
-
-```bash
-codex mcp add weppy-roblox-mcp -- npx -y @weppy/roblox-mcp
-```
-
-### 방법 2: 설정 파일 직접 편집
-
-`~/.codex/config.toml` 파일에 아래 내용을 추가하세요:
-
-```toml
-[mcp_servers.weppy-roblox-mcp]
-command = "npx"
-args = ["-y", "@weppy/roblox-mcp"]
-```
-
-**설정 파일 위치:**
-
-| OS | 경로 |
-|----|------|
-| macOS/Linux | `~/.codex/config.toml` |
-| Windows | `%USERPROFILE%\.codex\config.toml` |
-
-## 연결 테스트
-
-1. **Roblox Studio** 실행 → Plugins 탭 → **WEPPY** → **Connect**
-2. **Codex CLI** 실행 후 다음을 입력:
-   ```
-   Roblox Studio에서 현재 선택된 것을 알려줘
-   ```
-
-## 문제 해결
-
-### 서버가 시작되지 않을 때
-
-MCP 서버를 직접 실행하여 오류를 확인하세요:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### 연결 실패
-
-- Roblox Studio 플러그인이 **Connected** 상태인지 확인
-- 포트 3002가 방화벽에 의해 차단되지 않았는지 확인
-
-## 참고 자료
-
-- [Codex CLI GitHub](https://github.com/openai/codex)
-- [Codex MCP 공식 문서](https://developers.openai.com/codex/mcp/)
-- [Codex 설정 레퍼런스](https://developers.openai.com/codex/config-reference/)

package/docs/ko/installation/ai-apps/cursor.md

@@ -1,77 +0,0 @@
-# Cursor 설정
-
-[Cursor](https://cursor.com/)에서 Roblox MCP를 사용하는 방법입니다.
-
-## 사전 요구사항
-
-- **Cursor** 설치됨
-- **Node.js** (v18.0.0 이상)
-- **Roblox Studio 플러그인** 설치 완료
-
-## MCP 서버 등록
-
-### 방법 1: 프로젝트 설정
-
-프로젝트의 `.cursor/mcp.json` 파일에 아래 내용을 추가하세요:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-### 방법 2: 글로벌 설정
-
-전역 Cursor MCP 설정 파일에 같은 내용을 추가하세요.
-
-**설정 파일 위치:**
-
-| 범위 | 경로 |
-|------|------|
-| 프로젝트 | `<프로젝트>/.cursor/mcp.json` |
-| 글로벌 (macOS/Linux) | `~/.cursor/mcp.json` |
-| 글로벌 (Windows) | `%USERPROFILE%\\.cursor\\mcp.json` |
-
-> 파일이 이미 있으면 기존 `mcpServers` 객체 안에 `weppy-roblox-mcp` 항목만 병합하세요.
-
-### 적용
-
-설정을 수정한 뒤 Cursor 창을 다시 로드하거나 앱을 재시작하세요.
-
-## 연결 테스트
-
-1. **Roblox Studio** 실행 → Plugins 탭 → **WEPPY** → **Connect**
-2. **Cursor**에서 다음을 입력:
-   ```
-   Roblox Studio에서 현재 선택된 것을 알려줘
-   ```
-
-## 문제 해결
-
-### MCP 서버가 보이지 않을 때
-
-- 설정 파일 경로가 올바른지 확인
-- JSON 문법이 유효한지 확인
-- 설정 변경 후 Cursor를 다시 로드했는지 확인
-
-### 서버가 시작되지 않을 때
-
-MCP 서버를 직접 실행하여 오류를 확인하세요:
-
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### 연결 실패
-
-- Roblox Studio 플러그인이 **Connected** 상태인지 확인
-- 포트 3002가 방화벽에 의해 차단되지 않았는지 확인
-
-## 참고 자료
-
-- [Cursor MCP 문서](https://docs.cursor.com/context/model-context-protocol)

package/docs/ko/installation/ai-apps/gemini-cli.md

@@ -1,120 +0,0 @@
-# Gemini CLI 설정
-
-[Google Gemini CLI](https://github.com/google-gemini/gemini-cli)에서 Roblox MCP를 사용하는 방법입니다.
-
-## 사전 요구사항
-
-1. **Node.js** (v18.0.0 이상)
-   ```bash
-   node --version
-   ```
-
-2. **Gemini CLI** 설치됨
-   ```bash
-   npm install -g @google/gemini-cli
-   ```
-
-3. **Roblox Studio 플러그인** 설치 완료
-
-## MCP 서버 등록
-
-### 방법 1: CLI 명령어 (권장)
-
-터미널에서 한 줄로 등록할 수 있습니다:
-
-```bash
-gemini mcp add weppy-roblox-mcp npx --trust -- -y @weppy/roblox-mcp
-```
-
-> `--trust` 플래그는 도구 호출 시 매번 확인 프롬프트를 건너뜁니다.
-
-글로벌 설정으로 등록하려면 `-s user`를 추가하세요:
-
-```bash
-gemini mcp add weppy-roblox-mcp npx -s user --trust -- -y @weppy/roblox-mcp
-```
-
-### 방법 2: 설정 파일 편집
-
-`.gemini/settings.json` 파일에 아래 내용을 추가하세요:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-**설정 파일 위치:**
-| 범위 | 경로 |
-|------|------|
-| 프로젝트 | `<프로젝트>/.gemini/settings.json` |
-| 글로벌 | `~/.gemini/settings.json` |
-
-### 방법 3: 환경 변수 사용
-
-특정 환경 변수가 필요한 경우:
-
-**CLI:**
-```bash
-gemini mcp add weppy-roblox-mcp npx --trust -e HTTP_PORT=3002 -- -y @weppy/roblox-mcp
-```
-
-**설정 파일:**
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "env": {
-        "HTTP_PORT": "3002"
-      }
-    }
-  }
-}
-```
-
-## 연결 테스트
-
-1. **Roblox Studio** 실행 → Plugins 탭 → **WEPPY** → **Connect**
-2. **Gemini CLI** 실행 후 다음을 입력:
-   ```
-   Roblox Studio에서 현재 선택된 것을 알려줘
-   ```
-
-## MCP 서버 상태 확인
-
-Gemini CLI 내에서 `/mcp` 명령으로 연결된 서버 상태를 확인할 수 있습니다:
-
-```
-/mcp
-```
-
-## 문제 해결
-
-### 서버가 시작되지 않을 때
-
-MCP 서버를 직접 실행하여 오류를 확인하세요:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### 연결 실패
-
-- Roblox Studio 플러그인이 **Connected** 상태인지 확인
-- 포트 3002가 방화벽에 의해 차단되지 않았는지 확인
-- `/mcp` 명령으로 서버 상태 확인
-
-### 도구 충돌
-
-여러 MCP 서버에서 같은 이름의 도구가 있으면 `serverAlias__toolName` 형식으로 프리픽스가 붙습니다.
-
-## 참고 자료
-
-- [Gemini CLI MCP 공식 문서](https://geminicli.com/docs/tools/mcp-server/)
-- [Gemini CLI 설정 가이드](https://geminicli.com/docs/get-started/configuration/)

package/docs/ko/installation/roblox-explorer.md

@@ -1,68 +0,0 @@
-# WEPPY Roblox Explorer (VSCode · Antigravity 확장)
-
-> **선택 사항** — Explorer는 필수가 아닙니다. MCP와 플러그인만으로도 모든 핵심 기능을 사용할 수 있습니다. 프로젝트 구조를 에디터에서 탐색하고 싶을 때 설치하세요.
-
-Roblox Studio의 Explorer와 동일한 인스턴스 트리를 에디터에서 볼 수 있는 확장입니다. 동기화된 인스턴스를 탐색하고, 스크립트를 바로 열고, Sync 상태를 에디터 안에서 확인할 수 있습니다.
-이 확장은 WEPPY용 companion 확장이며, 단독 Roblox 연동 도구는 아닙니다.
-
-![WEPPY Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
-
-## 요구 사항
-
-- VSCode 1.85+ 또는 Antigravity
-- [Roblox MCP](../../../README.md) 설치 및 Sync 활성화 (Basic 또는 Pro)
-- 프로젝트 루트 아래에 Sync가 생성한 `weppy-project-sync/place_*/.sync-meta.json` 존재
-
-## 설치 방법
-
-### VSCode
-
-VSCode Extensions 사이드바(`Ctrl+Shift+X` / `Cmd+Shift+X`)에서 **WEPPY Roblox Explorer**를 검색하고 **Install**을 클릭합니다.
-
-또는 아래 마켓플레이스에서 바로 설치할 수 있습니다.
-
-- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
-- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
-
-### Antigravity
-
-Antigravity는 VSCode 기반이므로 동일한 확장을 사용합니다. Antigravity의 Extensions 탭에서 **WEPPY Roblox Explorer**를 검색하고 **Install**을 클릭합니다.
-
----
-
-기본 트리 탐색은 디스크에 있는 sync 파일만으로 동작합니다. 로컬 MCP 서버에 연결되면 실시간 sync 상태, direction 표시, Explorer 텔레메트리 전달 기능을 함께 사용할 수 있습니다.
-
-## 기능
-
-- **인스턴스 트리**: Roblox Studio와 동일한 서비스/인스턴스 계층 구조
-- **Roblox 클래스 아이콘**: 200개 이상의 클래스 아이콘 (다크/라이트 테마 지원)
-- **멀티 Place**: 동기화된 Place별로 트리 루트 분리
-- **클릭으로 파일 열기**: `.server.luau`, `.client.luau`, `.module.luau`, `.props.json` 등 바로 열기
-- **인스턴스 검색**: 모든 서비스에 걸쳐 QuickPick 검색
-- **Sync 상태 배지**: `modified`, `studio`, `conflict` 상태를 한눈에 확인
-- **자동 새로고침**: Sync 파일 변경 시 트리 자동 갱신 (500ms 디바운스)
-- **인스턴스 경로 복사**: 우클릭으로 `game.Workspace.Part` 형식의 경로 복사
-
-## 설정
-
-| 설정 | 기본값 | 설명 |
-|------|--------|------|
-| `robloxExplorer.syncRoot` | `""` | `weppy-project-sync` 루트 절대 경로. 비워두면 자동 탐색합니다. WEPPY는 `{projectRoot}/weppy-project-sync` 를 사용합니다. |
-| `robloxExplorer.hidePropsFiles` | `false` | 기본 VSCode 탐색기에서 동기화 파일(`.props.json`, `_tree.json`, `.value.json`)을 숨깁니다. |
-| `robloxExplorer.autoRefresh` | `true` | Sync 파일 변경 시 트리를 자동으로 새로고침합니다. |
-| `robloxExplorer.showSyncStatus` | `true` | 트리 항목에 Sync 상태 장식을 표시합니다. |
-
-## 명령어
-
-| 명령어 | 설명 |
-|--------|------|
-| `WEPPY Explorer: Refresh` | 인스턴스 트리 수동 새로고침 |
-| `WEPPY Explorer: Search Instances` | 모든 서비스에서 인스턴스 검색 |
-| `WEPPY Explorer: Open Backing File` | 선택한 인스턴스의 파일 열기 |
-| `WEPPY Explorer: Copy Instance Path` | 전체 인스턴스 경로 복사 (예: `game.Workspace.Part`) |
-| `WEPPY Explorer: Reveal in Explorer` | 기본 VSCode 탐색기에서 파일 표시 |
-
-## 관련 문서
-
-- [Sync 기능 상세 가이드](../sync/overview.md)
-- [설치 가이드](README.md)

package/docs/ko/installation/roblox-plugin.md

@@ -1,96 +0,0 @@
-# Roblox 플러그인 설치
-
-Roblox Studio에서 AI 에이전트와 연결하기 위한 플러그인 설치 방법입니다.
-
-## 자동 설치 (권장)
-
-MCP 서버 설치가 완료되었다면 플러그인은 **자동으로 설치**됩니다. 별도 다운로드나 파일 복사가 필요 없습니다.
-
-### 동작 방식
-
-1. MCP 서버가 처음 실행될 때 플러그인 파일(`WeppyRobloxMCP.rbxm`)을 Roblox Studio의 Plugins 폴더에 자동 배치합니다.
-2. Roblox Studio를 시작하면 Plugins 탭에 **WEPPY** 버튼이 나타납니다.
-
-### 연결하기
-
-1. **Roblox Studio**에서 아무 프로젝트를 엽니다
-2. 상단 **Plugins** 탭 → **WEPPY** 클릭
-
-![WEPPY 버튼](../../assets/screenshots/plugin/installation/toolbar-button.png)
-
-3. 플러그인 창에서 **Connect** 버튼 클릭
-4. **"Connected"** 상태가 표시되면 연결 완료
-
-![플러그인 메인 화면](../../assets/screenshots/plugin/installation/main-screen.png)
-
-> 자동 설치가 동작하지 않는 경우 아래 수동 설치를 진행하세요.
-
----
-
-## 수동 설치
-
-자동 설치가 동작하지 않거나, 특정 버전을 직접 설치해야 하는 경우에 사용합니다.
-
-### 1. 플러그인 다운로드
-
-1. [GitHub Releases](https://github.com/hope1026/weppy-roblox-mcp/releases/latest) 열기
-2. `weppy-roblox-mcp-v{버전}.zip` 다운로드
-3. ZIP 압축 해제 — `roblox-plugin/WeppyRobloxMCP.rbxm` 파일 포함
-
-### 2. 플러그인 설치
-
-1. **Roblox Studio** 실행
-2. 상단 메뉴 **Plugins** 탭 클릭
-3. **Plugins Folder** 버튼 클릭
-
-![Plugins Folder 열기](../../assets/screenshots/plugin/installation/plugins-menu.png)
-
-4. 압축 해제한 폴더에서 `WeppyRobloxMCP.rbxm` 파일을 열린 Plugins 폴더에 **복사**
-5. **Roblox Studio 재시작**
-
-### 3. 설치 확인
-
-재시작 후 Plugins 탭에 **WEPPY** 버튼이 나타납니다.
-
-![WEPPY 버튼](../../assets/screenshots/plugin/installation/toolbar-button.png)
-
-### 4. 연결하기
-
-위의 "연결하기" 섹션과 동일하게 Connect 버튼을 클릭하면 됩니다.
-
----
-
-## 설정 (선택사항)
-
-플러그인 우측 상단의 설정 버튼을 클릭하면 다양한 옵션을 변경할 수 있습니다.
-
-![설정 화면](../../assets/screenshots/plugin/installation/settings-screen.png)
-
-- **자동 연결**: Studio 시작 시 자동으로 MCP 서버에 연결
-- **자동 재연결**: 연결이 끊어지면 자동으로 재연결 시도
-- **자동 카메라 포커스**: 생성된 오브젝트로 카메라 자동 이동
-- **언어**: 플러그인 UI 언어 변경
-
-## 티어 안내
-
-- Basic은 동일한 플러그인 패키지를 설치하고 Basic 정책(Studio → Local 단방향 Sync)으로 동작합니다.
-- Pro 구독 라이선스 활성화 시 양방향 Sync와 더 넓은 고급 Tool 기능을 사용할 수 있습니다.
-
-## 문제 해결
-
-### 플러그인이 안 보여요
-
-- Roblox Studio를 완전히 종료 후 재시작
-- Plugins Folder에 파일이 제대로 복사되었는지 확인
-- `.rbxm` 파일이 손상되지 않았는지 확인
-
-### 연결이 안 돼요
-
-- AI 앱에서 MCP 서버가 실행 중인지 확인
-- 플러그인에서 **Connect** 버튼을 다시 클릭
-- 포트 3002가 다른 프로그램에 사용 중인지 확인
-
-### 연결이 자주 끊어져요
-
-- 설정에서 **자동 재연결** 옵션 활성화
-- AI 앱을 재시작

package/docs/ko/pro-upgrade.md

@@ -1,96 +0,0 @@
-# Pro 업그레이드 가이드
-
-## 왜 Pro인가?
-
-### 실제 개발 워크플로우를 위한 양방향 Sync
-
-Pro Sync는 단방향 내보내기를 넘어섭니다. 로컬에서 스크립트를 편집하고 Studio에 반영하세요. Studio에서 변경하고 로컬로 가져오세요. Pro는 양쪽을 항상 동기화합니다.
-
-- **양방향 Sync** — Studio와 로컬 파일 간 양방향으로 변경사항이 흐릅니다.
-- **타입별 Direction** — Scripts, Values, Containers, Data, Services를 각각 독립적으로 방향 설정.
-- **타입별 Apply Mode** — 타입별로 Auto 또는 Manual을 선택하여 속도와 제어를 균형있게.
-- **Full Sync / Resync** — 대규모 변경이나 재연결 후 즉시 깨끗한 프로젝트 상태를 재구축.
-- **변경 기록** — 적용 전에 무엇이, 언제, 어느 방향으로 변경됐는지 추적.
-- **멀티 Place Sync** — 최대 3개의 Roblox Place를 동시에 Sync하며, 각 Place마다 독립된 저장소와 변경 기록을 유지합니다.
-
-### 고효율 워크플로우로 AI 토큰 절약
-
-대량 및 고급 작업으로 반복 호출을 줄여 프롬프트 한 번에 더 많은 작업을 처리합니다.
-
-### AI가 플레이테스트를 직접 제어
-
-Studio 플레이테스트를 AI가 실행하고 검증합니다. F5(Play)/F8(Run) 시작/정지는 물론, 테스트 스크립트를 주입하고 로그를 수집해 리포트까지 자동 생성합니다.
-
-- "Run 모드로 플레이테스트 시작하고, NPC가 목표 지점까지 이동하는지 확인해줘."
-- "SpawnLocation이 지면 위에 있는지 테스트 스크립트를 작성해서 자동 실행해줘."
-- "방금 수정한 스크립트가 에러 없이 동작하는지 플레이테스트로 검증해줘."
-
-### 더 많은 Pro 전용 기능
-
-Pro는 핵심 워크플로를 넘어 더 많은 기능을 사용할 수 있습니다.
-
-- **대량 작업** — 한 번의 요청으로 여러 인스턴스를 생성·수정·삭제
-- **터레인 생성** — 블록, 볼, 실린더, 웨지 채우기 및 재질 교체
-- **에셋 검색/삽입** — Roblox 마켓에서 에셋을 검색하고 바로 삽입
-- **공간 분석** — 레이캐스트, 지면 찾기, 평지 탐색, 충돌 검사
-- **환경 제어** — 라이팅, 대기, 스카이, 시간대 설정
-- **오디오/애니메이션** — 사운드 재생 및 애니메이션 로드/재생
-
-## 구매 후 활성화
-
-### 1단계: Gumroad에서 Pro 구독 라이선스 구매
-
-1. [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/faccjs?utm_source=github&utm_medium=repo&utm_campaign=pro_upgrade_md) 접속
-2. Pro 구독 라이선스 구매 완료
-3. 결제 완료 후 받은 라이선스 키를 복사
-
-라이선스는 **플러그인 또는 대시보드 중 한 곳에서만 한 번 활성화하면 충분합니다.** 두 화면은 같은 MCP 로컬 라이선스 상태를 공유하므로, 한쪽에서 활성화하면 다른 쪽에도 같은 상태가 반영됩니다.
-
-### 플러그인에서 활성화
-
-1. Roblox Studio에서 **WEPPY** 플러그인을 열고 MCP 서버에 연결합니다.
-2. 플러그인의 **Settings > License** 섹션을 엽니다.
-3. `License key` 입력창에 구매한 키를 붙여넣습니다.
-4. **Activate** 버튼을 눌러 라이선스를 활성화합니다.
-5. 상태가 바로 갱신되지 않으면 **Refresh** 버튼으로 다시 확인합니다.
-6. 활성화가 완료되면 Basic 대신 Pro 상태로 표시되고 Pro 기능을 사용할 수 있습니다.
-
-![플러그인 라이선스 활성화 화면](../assets/screenshots/plugin/license/plugin-license-screen.png)
-
-### 대시보드에서 활성화
-
-1. MCP 서버를 실행한 뒤 대시보드의 **Settings > License** 섹션을 엽니다.
-2. Provider가 `gumroad`로 선택되어 있는지 확인합니다.
-3. `License Key` 입력창에 구매한 키를 붙여넣습니다.
-4. **Activate License** 버튼을 눌러 라이선스를 활성화합니다.
-5. 필요하면 **Refresh License**로 최신 상태를 다시 조회합니다.
-
-![대시보드 라이선스 활성화 화면](../assets/screenshots/plugin/license/dashboard-license-screen.png)
-
-### 활성화 후 확인
-
-- 라이선스 상태가 `active` 또는 `grace`로 표시되면 Pro 기능을 사용할 수 있습니다.
-- 플러그인과 대시보드는 같은 라이선스 상태를 공유하므로, 한쪽에서 활성화한 뒤 다른 쪽에서도 동일한 상태를 확인할 수 있습니다.
-- 라이선스를 다시 확인해야 할 때는 `Refresh` 또는 `Refresh License`를 사용하세요.
-
-## 기능 비교
-
-| 기능 | Basic | Pro |
-|-----|:-----:|:---:|
-| 스크립트 생성/편집 | ✅ | ✅ |
-| 인스턴스 생성/삭제/이동 | ✅ | ✅ + 대량 작업 |
-| 속성 읽기/변경 | ✅ | ✅ + 대량 변경 |
-| 선택, 태그, 검색 | ✅ | ✅ |
-| 카메라 제어 | ✅ | ✅ |
-| 로그 모니터링 | ✅ | ✅ |
-| Luau 코드 실행 | ✅ | ✅ |
-| 프로젝트 동기화 | Studio → Local 단방향 | 양방향 + 타입별 방향/모드 설정 |
-| 멀티 Place Sync | — | 최대 3개 Place 동시 Sync |
-| 변경 기록 | — | 적용 전 변경 내용 추적 |
-| 플레이테스트 제어 | — | 실행 / 정지 / 일시정지 / 재개 + 자동 테스트 |
-| 터레인 생성/편집 | — | 블록, 볼, 실린더, 웨지, 재질 교체 |
-| 에셋 검색/삽입 | — | Roblox 마켓에서 검색 후 바로 삽입 |
-| 공간 분석 | — | 레이캐스트, 지면 찾기, 충돌 검사 |
-| 환경 제어 | — | 라이팅, 대기, 스카이, 시간대 |
-| 오디오 / 애니메이션 | — | 사운드 재생, 애니메이션 로드/재생 |
-| AI 토큰 효율 | 건별 작업 | 대량 action으로 호출 횟수 절감 |