@weppy/roblox-mcp 2.4.1 → 2.5.1

package/docs/ko/explorer/overview.md

@@ -0,0 +1,104 @@
+# WEPPY Roblox Explorer 상세 가이드
+
+**WEPPY Roblox Explorer**는 Roblox Studio의 Explorer 트리를 VSCode·Antigravity 같은 에디터 안에서 동일한 형태로 보여주는 companion 확장입니다. Studio와 로컬을 오가지 않고도 동기화된 인스턴스 계층을 탐색하고, 스크립트를 열고, 속성을 편집할 수 있습니다.
+
+> **선택 사항** — Explorer는 필수가 아닙니다. MCP 서버와 Roblox Studio 플러그인만으로도 모든 핵심 기능을 사용할 수 있습니다. 에디터 안에서 프로젝트 구조를 탐색하거나 속성을 빠르게 확인·편집하고 싶을 때 설치하세요.
+
+![WEPPY Roblox Explorer — VSCode 사이드바에 표시되는 Studio 인스턴스 트리](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+
+## 왜 Explorer를 쓰는가
+
+Sync가 생성한 파일만으로도 AI는 프로젝트 전체 문맥을 이해할 수 있지만, 사람이 직접 탐색할 때는 파일 경로만으로는 구조가 잘 드러나지 않습니다. Explorer는 같은 sync 데이터를 **Roblox Studio와 동일한 계층 구조**로 다시 보여주기 때문에 다음이 편해집니다.
+
+- 스크립트가 어느 서비스/인스턴스 아래에 있는지 한눈에 파악
+- 여러 서비스에 걸친 인스턴스를 이름·경로 기준으로 빠르게 찾기
+- 동기화 상태(modified / studio / conflict)를 파일별로 확인
+- Studio로 전환하지 않고 속성값을 편집
+
+## 요구 사항
+
+- VSCode 1.85+ 또는 Antigravity
+- [Roblox MCP](../installation/README.md) 설치 및 Sync 활성화 (Basic 또는 Pro)
+- 프로젝트 루트 아래에 Sync가 생성한 `weppy-project-sync/place_*/.sync-meta.json` 존재
+
+Explorer는 기본적으로 디스크의 sync 파일만 읽어도 동작하며, 로컬 MCP 서버가 실행 중이면 실시간 sync 상태와 direction 정보를 추가로 반영합니다.
+
+## 설치 방법
+
+VSCode 또는 Antigravity의 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)
+
+## 인스턴스 트리 탐색
+
+설치 후 VSCode Activity Bar에 **WEPPY Explorer** 뷰가 생성되며, 프로젝트 루트에서 sync 디렉토리를 자동 탐색합니다.
+
+- **서비스 루트**: `Workspace`, `ReplicatedStorage`, `ServerScriptService` 등 동기화 대상 서비스가 최상위에 표시됩니다.
+- **Roblox 클래스 아이콘**: 200개 이상의 Studio 아이콘이 다크/라이트 테마에 맞춰 자동으로 전환됩니다.
+- **멀티 Place**: 동기화된 Place가 여러 개일 때 각 Place별로 트리 루트가 분리되어 표시됩니다.
+- **자동 새로고침**: Sync 파일이 변경되면 500ms 디바운스로 트리가 자동 갱신됩니다.
+- **Sync 상태 배지**: `modified`, `studio`, `conflict` 상태가 아이콘 옆에 표시되어 변경/충돌을 즉시 확인할 수 있습니다.
+
+트리에서 항목을 클릭하면 해당 인스턴스를 뒷받침하는 파일(`.server.luau`, `.client.luau`, `.module.luau`, `.props.json` 등)이 바로 열립니다. 우클릭 메뉴로 인스턴스 경로를 `game.Workspace.Part` 형식으로 복사하거나, 기본 VSCode 탐색기에서 해당 파일 위치를 보여줄 수 있습니다.
+
+## Property Panel
+
+Explorer 트리에서 인스턴스를 선택하고 **Open Properties** 명령을 실행하면, Studio의 Properties 창과 같은 형태의 패널이 열립니다. `.props.json` 파일을 직접 편집하지 않고도 속성을 그룹별로 확인하고 수정할 수 있습니다.
+
+![Property Panel — Roblox Studio와 동일한 속성 편집 화면을 VSCode에서 사용](../../assets/screenshots/roblox-explorer/roblox-explorer-property-window.png)
+
+- **그룹별 표시**: Appearance, Behavior, Data, Part, Transform 등 Studio와 같은 분류로 속성을 정리합니다.
+- **타입 기반 에디터**: 숫자, 문자열, Boolean, Color, Vector3, Enum 등 속성 타입에 맞는 입력 위젯이 제공됩니다.
+- **파일 기반 편집**: 변경 내용은 해당 인스턴스의 `*.props.json` 파일에 저장되며, Sync의 reverse 경로를 통해 Studio로 반영됩니다(Pro, bidirectional 설정 시).
+- **커스텀 에디터 등록**: `.props.json` 파일을 직접 열면 기본 편집기 대신 Property Panel이 자동으로 연결됩니다.
+
+자동으로 Property Panel을 열고 싶다면 설정에서 `robloxExplorer.propertyPanel.autoOpen` 을 `true` 로 바꾸면 됩니다.
+
+## 인스턴스 검색
+
+`WEPPY Explorer: Search Instances` 명령(뷰 상단 아이콘 또는 Command Palette)을 사용하면 모든 서비스에 걸쳐 QuickPick 기반 검색을 할 수 있습니다.
+
+- 인스턴스 이름의 부분 일치로 빠르게 탐색
+- 결과 선택 시 트리에서 해당 항목으로 포커스 이동
+- 여러 Place가 동기화된 경우 Place별 네임스페이스에서 검색
+
+## 설정
+
+| 설정 | 기본값 | 설명 |
+|------|--------|------|
+| `robloxExplorer.mcpBaseUrl` | `""` | 로컬 MCP HTTP 베이스 URL. 비워두면 `http://127.0.0.1:3002`, `http://127.0.0.1:3003` 순으로 시도합니다. |
+| `robloxExplorer.syncRoot` | `""` | `weppy-project-sync` 루트 절대 경로. 비워두면 워크스페이스 폴더에서 자동 탐색합니다. |
+| `robloxExplorer.hidePropsFiles` | `false` | 기본 VSCode 탐색기에서 sync 파일(`.props.json`, `_tree.json`, `.value.json`)을 숨깁니다. |
+| `robloxExplorer.autoRefresh` | `true` | Sync 파일 변경 시 트리를 자동 새로고침합니다. |
+| `robloxExplorer.showSyncStatus` | `true` | 트리 항목에 Sync 상태 배지를 표시합니다. |
+| `robloxExplorer.followFocusCue` | `false` | 외부 focus cue 파일에 따라 트리를 자동으로 열고 관련 파일을 엽니다. |
+| `robloxExplorer.propertyPanel.autoOpen` | `false` | 트리에서 인스턴스 선택 시 Property Panel을 자동으로 엽니다. |
+
+## 명령어
+
+| 명령어 | 설명 |
+|--------|------|
+| `WEPPY Explorer: Refresh` | 인스턴스 트리 수동 새로고침 |
+| `WEPPY Explorer: Search Instances` | 모든 서비스에서 인스턴스 검색 |
+| `WEPPY Explorer: Open Backing File` | 선택한 인스턴스의 backing 파일 열기 |
+| `WEPPY Explorer: Open Properties` | 선택한 인스턴스의 Property Panel 열기 |
+| `WEPPY Explorer: Copy Instance Path` | 전체 인스턴스 경로 복사 (예: `game.Workspace.Part`) |
+| `WEPPY Explorer: Reveal in Explorer` | 기본 VSCode 탐색기에서 파일 위치 표시 |
+| `WEPPY Explorer: Collapse All` | 트리의 모든 노드 접기 |
+| `WEPPY Explorer: Open Settings` | Explorer 설정 페이지 열기 |
+
+## 문제 해결
+
+- **트리가 비어 있음**: `weppy-project-sync/place_*` 디렉토리가 존재하는지, Sync가 최소 한 번 Full Sync를 마쳤는지 확인하세요. 필요하다면 `robloxExplorer.syncRoot`를 수동 지정합니다.
+- **Sync 상태가 표시되지 않음**: 로컬 MCP 서버가 실행 중인지 확인하고, `robloxExplorer.mcpBaseUrl`을 명시적으로 설정해 보세요.
+- **Property Panel이 열리지 않음**: `.props.json` 파일이 기본 편집기로 열릴 경우, 파일 우클릭 메뉴에서 **Reopen Editor With... → WEPPY Property Panel**을 선택합니다.
+- **아이콘이 깨짐**: VSCode 테마를 다시 선택하거나 창을 재시작해 아이콘 캐시를 갱신합니다.
+
+## 함께 보면 좋은 문서
+
+- [Roblox MCP 설치 가이드](../installation/README.md)
+- [Sync 기능 상세 가이드](../sync/overview.md)
+- [Tool 지원 범위 (Tools Overview)](../tools/overview.md)

package/docs/ko/installation/README.md

@@ -70,12 +70,12 @@ GitHub에서 플러그인 파일을 다운로드한 뒤, Roblox Studio의 Plugin
 
 ---
 
-## 선택 사항: WROX Roblox Explorer (VSCode 확장) 설치
+## 선택 사항: WEPPY Roblox Explorer (VSCode 확장) 설치
 
 동기화된 인스턴스 트리를 Roblox 클래스 아이콘과 함께 VSCode에서 탐색할 수 있습니다.
-이 확장은 위의 Roblox MCP 설치를 먼저 완료해야 사용할 수 있습니다. Explorer가 프로젝트 루트 아래의 `wrox-project-sync` Sync 데이터를 읽기 때문입니다.
+이 확장은 위의 Roblox MCP 설치를 먼저 완료해야 사용할 수 있습니다. Explorer가 프로젝트 루트 아래의 `weppy-project-sync` Sync 데이터를 읽기 때문입니다.
 
-👉 [WROX Roblox Explorer 설치 가이드](https://weppyai.com/ko/install#explorer)
+👉 [WEPPY Roblox Explorer 설치 가이드](https://weppyai.com/ko/install#explorer)
 
 바로 설치:
 - [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
@@ -85,7 +85,7 @@ GitHub에서 플러그인 파일을 다운로드한 뒤, Roblox Studio의 Plugin
 
 ## 설치 완료 후
 
-1. **Roblox Studio**를 열고, Plugins 탭에서 **WROX** → **Connect** 클릭
+1. **Roblox Studio**를 열고, Plugins 탭에서 **WEPPY** → **Connect** 클릭
 2. **AI 앱**에서 다음과 같이 테스트해보세요:
 
 ```

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

@@ -60,7 +60,7 @@ Antigravity에서는 MCP 서버를 **에이전트 패널(Agent pane)**에서 관
 
 ## 연결 테스트
 
-1. **Roblox Studio** 실행 → Plugins 탭 → **WROX** → **Connect**
+1. **Roblox Studio** 실행 → Plugins 탭 → **WEPPY** → **Connect**
 2. **Antigravity**에서 다음을 입력:
    ```
    Roblox Studio에서 현재 선택된 것을 알려줘

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

@@ -46,7 +46,7 @@
 
 ## 연결 테스트
 
-1. **Roblox Studio** 실행 → Plugins 탭 → **WROX** → **Connect**
+1. **Roblox Studio** 실행 → Plugins 탭 → **WEPPY** → **Connect**
 2. **Claude Desktop**에서 새 대화 시작 후 테스트:
    ```
    Roblox Studio에 파란 파트 만들어줘

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

@@ -64,7 +64,7 @@ Claude Code는 MCP 서버를 자동으로 관리합니다:
 
 ## 연결 테스트
 
-1. **Roblox Studio** 실행 → Plugins 탭 → **WROX** → **Connect**
+1. **Roblox Studio** 실행 → Plugins 탭 → **WEPPY** → **Connect**
 2. **Claude Code**에서 테스트:
    ```
    Roblox Studio에 파란 파트 만들어줘

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

@@ -30,7 +30,7 @@ Command: npx -y @weppy/roblox-mcp
 
 ## 연결 테스트
 
-1. **Roblox Studio** 실행 → Plugins 탭 → **WROX** → **Connect**
+1. **Roblox Studio** 실행 → Plugins 탭 → **WEPPY** → **Connect**
 2. **Codex App**에서 새 대화 시작 후 테스트:
    ```
    Roblox Studio에서 현재 선택된 것을 알려줘

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

@@ -40,7 +40,7 @@ args = ["-y", "@weppy/roblox-mcp"]
 
 ## 연결 테스트
 
-1. **Roblox Studio** 실행 → Plugins 탭 → **WROX** → **Connect**
+1. **Roblox Studio** 실행 → Plugins 탭 → **WEPPY** → **Connect**
 2. **Codex CLI** 실행 후 다음을 입력:
    ```
    Roblox Studio에서 현재 선택된 것을 알려줘

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

@@ -45,7 +45,7 @@
 
 ## 연결 테스트
 
-1. **Roblox Studio** 실행 → Plugins 탭 → **WROX** → **Connect**
+1. **Roblox Studio** 실행 → Plugins 탭 → **WEPPY** → **Connect**
 2. **Cursor**에서 다음을 입력:
    ```
    Roblox Studio에서 현재 선택된 것을 알려줘

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

@@ -81,7 +81,7 @@ gemini mcp add weppy-roblox-mcp npx --trust -e HTTP_PORT=3002 -- -y @weppy/roblo
 
 ## 연결 테스트
 
-1. **Roblox Studio** 실행 → Plugins 탭 → **WROX** → **Connect**
+1. **Roblox Studio** 실행 → Plugins 탭 → **WEPPY** → **Connect**
 2. **Gemini CLI** 실행 후 다음을 입력:
    ```
    Roblox Studio에서 현재 선택된 것을 알려줘

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

@@ -1,23 +1,23 @@
-# WROX Roblox Explorer (VSCode · Antigravity 확장)
+# WEPPY Roblox Explorer (VSCode · Antigravity 확장)
 
 > **선택 사항** — Explorer는 필수가 아닙니다. MCP와 플러그인만으로도 모든 핵심 기능을 사용할 수 있습니다. 프로젝트 구조를 에디터에서 탐색하고 싶을 때 설치하세요.
 
 Roblox Studio의 Explorer와 동일한 인스턴스 트리를 에디터에서 볼 수 있는 확장입니다. 동기화된 인스턴스를 탐색하고, 스크립트를 바로 열고, Sync 상태를 에디터 안에서 확인할 수 있습니다.
-이 확장은 WROX용 companion 확장이며, 단독 Roblox 연동 도구는 아닙니다.
+이 확장은 WEPPY용 companion 확장이며, 단독 Roblox 연동 도구는 아닙니다.
 
-![WROX Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+![WEPPY Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 
 ## 요구 사항
 
 - VSCode 1.85+ 또는 Antigravity
 - [Roblox MCP](../../../README.md) 설치 및 Sync 활성화 (Basic 또는 Pro)
-- 프로젝트 루트 아래에 Sync가 생성한 `wrox-project-sync/place_*/.sync-meta.json` 존재
+- 프로젝트 루트 아래에 Sync가 생성한 `weppy-project-sync/place_*/.sync-meta.json` 존재
 
 ## 설치 방법
 
 ### VSCode
 
-VSCode Extensions 사이드바(`Ctrl+Shift+X` / `Cmd+Shift+X`)에서 **WROX Roblox Explorer**를 검색하고 **Install**을 클릭합니다.
+VSCode Extensions 사이드바(`Ctrl+Shift+X` / `Cmd+Shift+X`)에서 **WEPPY Roblox Explorer**를 검색하고 **Install**을 클릭합니다.
 
 또는 아래 마켓플레이스에서 바로 설치할 수 있습니다.
 
@@ -26,7 +26,7 @@ VSCode Extensions 사이드바(`Ctrl+Shift+X` / `Cmd+Shift+X`)에서 **WROX Robl
 
 ### Antigravity
 
-Antigravity는 VSCode 기반이므로 동일한 확장을 사용합니다. Antigravity의 Extensions 탭에서 **WROX Roblox Explorer**를 검색하고 **Install**을 클릭합니다.
+Antigravity는 VSCode 기반이므로 동일한 확장을 사용합니다. Antigravity의 Extensions 탭에서 **WEPPY Roblox Explorer**를 검색하고 **Install**을 클릭합니다.
 
 ---
 
@@ -47,7 +47,7 @@ Antigravity는 VSCode 기반이므로 동일한 확장을 사용합니다. Antig
 
 | 설정 | 기본값 | 설명 |
 |------|--------|------|
-| `robloxExplorer.syncRoot` | `""` | `wrox-project-sync` 루트 절대 경로. 비워두면 자동 탐색합니다. WROX는 `{projectRoot}/wrox-project-sync` 를 사용합니다. |
+| `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 상태 장식을 표시합니다. |
@@ -56,11 +56,11 @@ Antigravity는 VSCode 기반이므로 동일한 확장을 사용합니다. Antig
 
 | 명령어 | 설명 |
 |--------|------|
-| `WROX Explorer: Refresh` | 인스턴스 트리 수동 새로고침 |
-| `WROX Explorer: Search Instances` | 모든 서비스에서 인스턴스 검색 |
-| `WROX Explorer: Open Backing File` | 선택한 인스턴스의 파일 열기 |
-| `WROX Explorer: Copy Instance Path` | 전체 인스턴스 경로 복사 (예: `game.Workspace.Part`) |
-| `WROX Explorer: Reveal in Explorer` | 기본 VSCode 탐색기에서 파일 표시 |
+| `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 탐색기에서 파일 표시 |
 
 ## 관련 문서
 

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

@@ -9,14 +9,14 @@ MCP 서버 설치가 완료되었다면 플러그인은 **자동으로 설치**
 ### 동작 방식
 
 1. MCP 서버가 처음 실행될 때 플러그인 파일(`WeppyRobloxMCP.rbxm`)을 Roblox Studio의 Plugins 폴더에 자동 배치합니다.
-2. Roblox Studio를 시작하면 Plugins 탭에 **WROX** 버튼이 나타납니다.
+2. Roblox Studio를 시작하면 Plugins 탭에 **WEPPY** 버튼이 나타납니다.
 
 ### 연결하기
 
 1. **Roblox Studio**에서 아무 프로젝트를 엽니다
-2. 상단 **Plugins** 탭 → **WROX** 클릭
+2. 상단 **Plugins** 탭 → **WEPPY** 클릭
 
-![WROX 버튼](../../assets/screenshots/plugin/installation/toolbar-button.png)
+![WEPPY 버튼](../../assets/screenshots/plugin/installation/toolbar-button.png)
 
 3. 플러그인 창에서 **Connect** 버튼 클릭
 4. **"Connected"** 상태가 표시되면 연결 완료
@@ -50,9 +50,9 @@ MCP 서버 설치가 완료되었다면 플러그인은 **자동으로 설치**
 
 ### 3. 설치 확인
 
-재시작 후 Plugins 탭에 **WROX** 버튼이 나타납니다.
+재시작 후 Plugins 탭에 **WEPPY** 버튼이 나타납니다.
 
-![WROX 버튼](../../assets/screenshots/plugin/installation/toolbar-button.png)
+![WEPPY 버튼](../../assets/screenshots/plugin/installation/toolbar-button.png)
 
 ### 4. 연결하기
 

package/docs/ko/pro-upgrade.md

@@ -48,7 +48,7 @@ Pro는 핵심 워크플로를 넘어 더 많은 기능을 사용할 수 있습
 
 ### 플러그인에서 활성화
 
-1. Roblox Studio에서 **WROX** 플러그인을 열고 MCP 서버에 연결합니다.
+1. Roblox Studio에서 **WEPPY** 플러그인을 열고 MCP 서버에 연결합니다.
 2. 플러그인의 **Settings > License** 섹션을 엽니다.
 3. `License key` 입력창에 구매한 키를 붙여넣습니다.
 4. **Activate** 버튼을 눌러 라이선스를 활성화합니다.

package/docs/ko/sync/luau-lsp.md

@@ -1,19 +1,19 @@
-# WROX Sync에서 `luau-lsp` 사용하기
+# WEPPY Sync에서 `luau-lsp` 사용하기
 
-WROX Sync는 `luau-lsp`가 필요한 sourcemap 파일을 자동으로 생성할 수 있으므로, 별도의 Rojo 프로젝트를 따로 구성하지 않아도 Roblox 인식 편집기 기능을 사용할 수 있습니다.
+WEPPY Sync는 `luau-lsp`가 필요한 sourcemap 파일을 자동으로 생성할 수 있으므로, 별도의 Rojo 프로젝트를 따로 구성하지 않아도 Roblox 인식 편집기 기능을 사용할 수 있습니다.
 
-## WROX가 생성하는 파일
+## WEPPY가 생성하는 파일
 
-Full Sync가 끝나면 WROX는 다음 파일을 생성합니다.
+Full Sync가 끝나면 WEPPY는 다음 파일을 생성합니다.
 
-- Place sourcemap: `wrox-project-sync/place_<id>/sourcemap.json`
-- 루트 대표 파일: `wrox-project-sync/sourcemap.json`
+- Place sourcemap: `weppy-project-sync/place_<id>/sourcemap.json`
+- 루트 대표 파일: `weppy-project-sync/sourcemap.json`
 
-대부분의 사용자에게 권장되는 경로는 `wrox-project-sync/sourcemap.json`입니다.
+대부분의 사용자에게 권장되는 경로는 `weppy-project-sync/sourcemap.json`입니다.
 
 ## 어떤 점이 좋아지나
 
-`luau-lsp`가 WROX sourcemap을 읽으면 다음이 개선됩니다.
+`luau-lsp`가 WEPPY sourcemap을 읽으면 다음이 개선됩니다.
 
 - `game.*` 자동완성
 - 동기화된 스크립트 기준 탐색
@@ -21,8 +21,8 @@ Full Sync가 끝나면 WROX는 다음 파일을 생성합니다.
 
 ## 권장 설정 방법
 
-1. WROX가 `wrox-project-sync/sourcemap.json`을 만들도록 Full Sync를 한 번 실행합니다.
-2. 에디터의 `luau-lsp` sourcemap 설정이 `wrox-project-sync/sourcemap.json`을 가리키게 합니다.
+1. WEPPY가 `weppy-project-sync/sourcemap.json`을 만들도록 Full Sync를 한 번 실행합니다.
+2. 에디터의 `luau-lsp` sourcemap 설정이 `weppy-project-sync/sourcemap.json`을 가리키게 합니다.
 3. 사용하는 클라이언트에서 자동 Rojo 생성을 끌 수 있다면 `luau-lsp.sourcemap.autogenerate`를 `false`로 설정합니다.
 
 VSCode 설정 예시:
@@ -31,11 +31,11 @@ VSCode 설정 예시:
 {
   "luau-lsp.sourcemap.enabled": true,
   "luau-lsp.sourcemap.autogenerate": false,
-  "luau-lsp.sourcemap.sourcemapFile": "wrox-project-sync/sourcemap.json"
+  "luau-lsp.sourcemap.sourcemapFile": "weppy-project-sync/sourcemap.json"
 }
 ```
 
 ## Multi-place 참고
 
-`wrox-project-sync/sourcemap.json`은 프로젝트의 현재 대표 place를 따라갑니다.
-특정 place를 고정해서 쓰고 싶다면 `luau-lsp`가 해당 place의 `wrox-project-sync/place_<id>/sourcemap.json`을 직접 보도록 설정하면 됩니다.
+`weppy-project-sync/sourcemap.json`은 프로젝트의 현재 대표 place를 따라갑니다.
+특정 place를 고정해서 쓰고 싶다면 `luau-lsp`가 해당 place의 `weppy-project-sync/place_<id>/sourcemap.json`을 직접 보도록 설정하면 됩니다.

package/docs/ko/sync/overview.md

@@ -18,16 +18,16 @@ Sync가 없으면 AI는 대화에 붙여 넣은 코드 일부만 보고 판단
 2. Incremental Sync: 변경 감시로 이후 변경분만 반영
 3. History/Status 추적: 어떤 변경이 언제 어떤 방향으로 반영됐는지 확인
 
-Sync 데이터는 `{projectRoot}/wrox-project-sync/place_{placeId}/explorer` 아래에 생성됩니다.
-WROX는 여기에 더해 place별 sourcemap을 `{projectRoot}/wrox-project-sync/place_{placeId}/sourcemap.json`에 기록하고, 권장 루트 대표 파일을 `{projectRoot}/wrox-project-sync/sourcemap.json`에 유지합니다.
-`luau-lsp` 같은 에디터 연동에는 루트 경로 사용을 권장합니다. 설정 방법은 [WROX Sync에서 `luau-lsp` 사용하기](./luau-lsp.md)에서 확인할 수 있습니다.
+Sync 데이터는 `{projectRoot}/weppy-project-sync/place_{placeId}/explorer` 아래에 생성됩니다.
+WEPPY는 여기에 더해 place별 sourcemap을 `{projectRoot}/weppy-project-sync/place_{placeId}/sourcemap.json`에 기록하고, 권장 루트 대표 파일을 `{projectRoot}/weppy-project-sync/sourcemap.json`에 유지합니다.
+`luau-lsp` 같은 에디터 연동에는 루트 경로 사용을 권장합니다. 설정 방법은 [WEPPY Sync에서 `luau-lsp` 사용하기](./luau-lsp.md)에서 확인할 수 있습니다.
 
 ### VSCode에서 Sync 데이터 탐색
 
-[WROX Roblox Explorer](../installation/roblox-explorer.md) 확장을 설치하면, 동기화된 인스턴스 트리를 Roblox Studio와 동일한 형태로 VSCode에서 탐색할 수 있습니다.
+[WEPPY Roblox Explorer](../explorer/overview.md) 확장을 설치하면, 동기화된 인스턴스 트리를 Roblox Studio와 동일한 형태로 VSCode에서 탐색할 수 있습니다.
 Explorer는 여기서 생성된 sync 파일을 읽고, 로컬 MCP 서버가 실행 중이면 추가로 실시간 sync 상태와 direction 정보를 표시할 수 있습니다.
 
-![WROX Roblox Explorer — 동기화된 인스턴스 트리를 VSCode에서 탐색하는 모습](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+![WEPPY Roblox Explorer — 동기화된 인스턴스 트리를 VSCode에서 탐색하는 모습](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 
 - 서비스/인스턴스 트리를 Roblox 클래스 아이콘과 함께 표시
 - 스크립트 파일을 클릭하면 바로 편집 가능
@@ -40,7 +40,7 @@ Explorer는 여기서 생성된 sync 파일을 읽고, 로컬 MCP 서버가 실
 | 동기화 방향 | Studio -> Local | 양방향 |
 | 타입별 Direction | 미지원 | 지원 (Scripts / Values / Containers / Data / Services) |
 | 타입별 Apply Mode | 미지원 | 지원 (Auto / Manual) |
-| 상태/기록 조회 API | 미지원 | 지원 (`status`, `history`, `progress`) |
+| 상태/기록 조회 API | 미지원 | 지원 (`status_current_place`, `history`, `progress`) |
 | `manage_sync` 도구 사용 | 미지원 | 지원 |
 | 멀티 Place Sync | 미지원 | 지원 (최대 3개 Place) |
 
@@ -87,7 +87,7 @@ Pro에서는 타입별로 Direction/Apply Mode를 다르게 설정해 워크플
 
 | 액션 | 설명 | 주요 인자 |
 |------|------|-----------|
-| `status` | 현재 Place의 동기화 상태 확인 | `placeId` |
+| `status_current_place` | 현재 연결된 Place의 동기화 상태 확인 | `-` |
 | `history` | 변경 기록 조회 | `placeId`, `query.limit`, `query.offset` |
 | `directions` | 타입별 Direction 조회 | `placeId` |
 | `read_file` | 동기화된 파일 읽기 | `placeId`, `instancePath` |
@@ -148,6 +148,6 @@ explorer/
 
 ## 함께 보면 좋은 문서
 
-- [WROX Sync에서 `luau-lsp` 사용하기](./luau-lsp.md)
+- [WEPPY Sync에서 `luau-lsp` 사용하기](./luau-lsp.md)
 - [Tool 지원 범위 (Tools Overview)](../tools/overview.md)
 - [Pro 업그레이드 가이드](https://weppyai.com/ko/plans)

package/docs/ko/tools/overview.md

@@ -227,7 +227,7 @@ Sync 정책:
 
 | 액션 | 설명 | 티어 |
 |------|------|------|
-| `status` | Place의 동기화 상태 가져오기 | Pro |
+| `status_current_place` | 현재 연결된 Place의 동기화 상태 가져오기 | Pro |
 | `history` | 변경 기록 가져오기 | Pro |
 | `directions` | 타입별 동기화 방향 가져오기 | Pro |
 | `read_file` | 동기화된 파일 읽기 | Pro |

package/docs/ko/tools/playtest.md

@@ -81,10 +81,10 @@ Edit ──play──→ Running ──stop──→ Edit
 - 마지막 로그 수집
 
 ### 5. 리포트 생성
-리포트와 로그는 로컬 `{projectRoot}/wrox-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/` 아래에 저장됩니다.
+리포트와 로그는 로컬 `{projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/` 아래에 저장됩니다.
 
 ```
-{projectRoot}/wrox-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/
+{projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/
 ├── test-report.md    # 결과 요약 (상태, 시간, 시그널)
 └── test-log.txt      # 전체 로그 (타임스탬프, 시퀀스, 레벨)
 ```

package/docs/pt-br/README.md

@@ -1,6 +1,6 @@
 # Roblox MCP — Servidor MCP para Roblox Studio | Desenvolvimento de jogos com IA usando Claude, Codex, Cursor e Gemini
 
-> **WROX** e um servidor MCP que permite agentes de codificacao IA controlarem uma sessao ao vivo do Roblox Studio — crie e edite scripts, instancias, terrain, iluminacao, assets, audio e animacoes com linguagem natural.
+> **WEPPY** e um servidor MCP que permite agentes de codificacao IA controlarem uma sessao ao vivo do Roblox Studio — crie e edite scripts, instancias, terrain, iluminacao, assets, audio e animacoes com linguagem natural.
 
 **Ferramentas consolidadas baseadas em ações · Sync bidirecional · Playtest automatizado · Suporte multi-place**
 
@@ -8,11 +8,11 @@
 
 [![Demo — IA criando um jogo Roblox em tempo real](https://img.youtube.com/vi/puQB4u1VlMw/maxresdefault.jpg)](https://youtu.be/puQB4u1VlMw)
 
-## Por que WROX (Weppy Roblox MCP)?
+## Por que WEPPY (Weppy Roblox MCP)?
 
 Agentes de codificação IA como Claude, Codex e Gemini são poderosos — mas não conseguem ver nem modificar nada dentro do Roblox Studio. O DataModel, scripts, terrain e iluminação são todos invisíveis para ferramentas externas. Sem uma ponte, a IA só pode gerar trechos de código que você precisa colar manualmente.
 
-**WROX** é uma ponte entre agentes de IA e o Roblox Studio. A IA cria e modifica diretamente instâncias, scripts, propriedades, terrain e mais dentro do Studio, e as alterações são refletidas imediatamente no Studio e no dashboard para que você possa **ver exatamente o que mudou**.
+**WEPPY** é uma ponte entre agentes de IA e o Roblox Studio. A IA cria e modifica diretamente instâncias, scripts, propriedades, terrain e mais dentro do Studio, e as alterações são refletidas imediatamente no Studio e no dashboard para que você possa **ver exatamente o que mudou**.
 
 Sem necessidade de copiar e colar código. A IA trabalha e você confere os resultados.
 
@@ -104,9 +104,9 @@ A IA pode controlar diretamente o playtest do Studio. Ela pode iniciar e parar P
 - "Escreva e execute um teste para confirmar que o SpawnLocation esta acima do chao."
 - "Valide com playtest se o script que acabei de alterar roda sem erros."
 
-![WROX Playtest Dashboard — historico de testes e relatorio detalhado](../assets/screenshots/dashboard/dashboard_playtest.png)
+![WEPPY Playtest Dashboard — historico de testes e relatorio detalhado](../assets/screenshots/dashboard/dashboard_playtest.png)
 
-### 4) WROX Dashboard: monitore as operacoes da IA em tempo real
+### 4) WEPPY Dashboard: monitore as operacoes da IA em tempo real
 
 No dashboard web fornecido pelo servidor MCP, acompanhe em tempo real o status de conexao, historico de execucao de ferramentas, status de sincronizacao e historico de alteracoes do jogo.
 
@@ -114,19 +114,19 @@ No dashboard web fornecido pelo servidor MCP, acompanhe em tempo real o status d
 - Compare todas as alteracoes feitas pela IA com Before & After no Changelog
 - Analise o fluxo de trabalho com historico e estatisticas de execucao de ferramentas
 
-![WROX WROX Dashboard Overview — status do servidor, alteracoes recentes e resumo da sessao](../assets/screenshots/dashboard/dashboard_overview.png)
+![WEPPY WEPPY Dashboard Overview — status do servidor, alteracoes recentes e resumo da sessao](../assets/screenshots/dashboard/dashboard_overview.png)
 
-### 5) WROX Roblox Explorer: navegue a hierarquia do Studio no VSCode
+### 5) WEPPY Roblox Explorer: navegue a hierarquia do Studio no VSCode
 
 Visualize a arvore completa de instancias do seu lugar no Roblox Studio diretamente dentro do VSCode. Navegue pelos servicos, abra scripts e arquivos de propriedades sincronizados, e acompanhe o status de sincronizacao — tudo sem trocar para o Studio.
-WROX Roblox Explorer e uma extensao complementar do VSCode para os dados de sync gerados pelo WROX. A navegacao basica da arvore funciona a partir dos arquivos sincronizados em disco, e os indicadores ao vivo de status sync ou direction ficam mais completos quando o servidor MCP local esta em execucao.
+WEPPY Roblox Explorer e uma extensao complementar do VSCode para os dados de sync gerados pelo WEPPY. A navegacao basica da arvore funciona a partir dos arquivos sincronizados em disco, e os indicadores ao vivo de status sync ou direction ficam mais completos quando o servidor MCP local esta em execucao.
 Instale pela [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer) ou pela [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer).
 
 - Icones de classe iguais ao Studio para reconhecimento imediato
 - Clique para abrir scripts e arquivos de propriedades sincronizados
 - Suporte multiplace com indicadores de status de sincronizacao
 
-![WROX Roblox Explorer — arvore de instancias do Studio exibida na barra lateral do VSCode](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+![WEPPY Roblox Explorer — arvore de instancias do Studio exibida na barra lateral do VSCode](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 
 ## Valor imediato para o usuario
 
@@ -148,8 +148,9 @@ Instale pela [VS Code Marketplace](https://marketplace.visualstudio.com/items?it
 - [Guia de instalacao](installation/README.md)
 - [Lista completa de tools](tools/overview.md)
 - [Guia detalhado de Sync](sync/overview.md)
-- [Guia do WROX Dashboard](dashboard/overview.md)
-- [WROX Roblox Explorer (Extensao VSCode)](installation/roblox-explorer.md)
+- [Guia do WEPPY Dashboard](dashboard/overview.md)
+- [Guia detalhado do WEPPY Roblox Explorer](explorer/overview.md)
+- [Instalacao do WEPPY Roblox Explorer](installation/roblox-explorer.md)
 - [Compatibilidade](../compatibility.md)
 - [Solucao de problemas](../troubleshooting.md)
 

package/docs/pt-br/dashboard/changelog.md

@@ -106,7 +106,7 @@ Filtre a categoria Instance na timeline e rastreie as alteracoes do tipo delete
 
 ## Documentos relacionados
 
-- [WROX Dashboard Overview](overview.md)
+- [WEPPY Dashboard Overview](overview.md)
 - [Connection](connection.md)
 - [Sync](sync.md)
 - [Playtest](playtest.md)

package/docs/pt-br/dashboard/connection.md

@@ -69,7 +69,7 @@ Confira o nome, PID e diretorio de trabalho do agente conectado na tabela AI Age
 
 ## Documentos relacionados
 
-- [WROX Dashboard Overview](overview.md)
+- [WEPPY Dashboard Overview](overview.md)
 - [Changelog](changelog.md)
 - [Sync](sync.md)
 - [Playtest](playtest.md)

package/docs/pt-br/dashboard/overview.md

@@ -2,7 +2,7 @@
 
 > Monitore e gerencie em tempo real o status, conexoes, sincronizacao, historico de execucao de ferramentas e historico de alteracoes do jogo do servidor MCP diretamente no navegador.
 
-![WROX Dashboard Overview — status do servidor, alteracoes recentes e resumo da sessao em uma unica tela](../../assets/screenshots/dashboard/dashboard_overview.png)
+![WEPPY Dashboard Overview — status do servidor, alteracoes recentes e resumo da sessao em uma unica tela](../../assets/screenshots/dashboard/dashboard_overview.png)
 
 ## O que e o Dashboard?
 

package/docs/pt-br/dashboard/playtest.md

@@ -52,7 +52,7 @@ Verifique o timestamp e o Status no Test History para acompanhar a tendencia dos
 
 ## Documentos relacionados
 
-- [WROX Dashboard Overview](overview.md)
+- [WEPPY Dashboard Overview](overview.md)
 - [Changelog](changelog.md)
 - [Connection](connection.md)
 - [Sync](sync.md)

package/docs/pt-br/dashboard/settings.md

@@ -52,7 +52,7 @@ Altere o idioma da interface do Dashboard. Suporta 6 idiomas + Auto (deteccao au
 
 ## Documentos relacionados
 
-- [WROX Dashboard Overview](overview.md)
+- [WEPPY Dashboard Overview](overview.md)
 - [Changelog](changelog.md)
 - [Connection](connection.md)
 - [Sync](sync.md)

package/docs/pt-br/dashboard/sync.md

@@ -59,7 +59,7 @@ Verifique a Direction do tipo Scripts na tabela Sync Directions.
 
 ## Documentos relacionados
 
-- [WROX Dashboard Overview](overview.md)
+- [WEPPY Dashboard Overview](overview.md)
 - [Changelog](changelog.md)
 - [Connection](connection.md)
 - [Playtest](playtest.md)

package/docs/pt-br/dashboard/tools.md

@@ -60,7 +60,7 @@ Encontre o item com Status Error na aba History para verificar as informacoes de
 
 ## Documentos relacionados
 
-- [WROX Dashboard Overview](overview.md)
+- [WEPPY Dashboard Overview](overview.md)
 - [Changelog](changelog.md)
 - [Connection](connection.md)
 - [Sync](sync.md)