@weppy/roblox-mcp 2.3.0 → 2.3.1

package/docs/ja/README.md

@@ -6,7 +6,7 @@
 
 [English](../../README.md) | [한국어](../ko/README.md) | **日本語** | [Español](../es/README.md) | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
 
-[![デモ — AIがリアルタイムでRobloxゲームを制作する様子](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
+[![デモ — AIがリアルタイムでRobloxゲームを制作する様子](https://img.youtube.com/vi/puQB4u1VlMw/maxresdefault.jpg)](https://youtu.be/puQB4u1VlMw)
 
 ## WROX（Weppy Roblox MCP）を使う理由
 
@@ -18,6 +18,14 @@ Claude、Codex、GeminiなどのAIコーディングエージェントは強力
 
 ## クイックインストール
 
+Webページのガイドに沿ってインストールできます。
+
+👉 **[インストールページ](https://weppy-web.pages.dev/ja/install)**
+
+### ターミナル ワンラインインストール
+
+ターミナルに慣れている方は、1行ですべてインストールできます。
+
 **macOS / Linux**
 
 ```bash
@@ -30,18 +38,16 @@ curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/inst
 irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
 ```
 
-Roblox Studioを再起動したら完了です！
+AIアプリを再起動し、Roblox Studioを再起動してください。
 
 自動MCP登録は **Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI, Antigravity** に対応しています。
 
-WindowsでPowerShellの実行がブロックされる場合は、下の手動インストールに進んでください。ZIPパッケージを使う場合は `setup-plugin.bat` と `setup-mcp.bat` も利用できます。
-
 ### 手動インストール
 
-ワンラインインストールが動作しない場合、または環境上自動インストールを使えない場合は、以下の手動インストールを代替手段として進めてください。
+ワンラインインストールが動作しない場合:
 
-**Step 1** — Roblox Studioプラグインのインストール（StudioとAIを接続する橋渡し）:
-[プラグインインストールガイド](installation/roblox-plugin.md)
+**Step 1** — Roblox Studioプラグインのインストール:
+[プラグインインストールガイド](https://weppy-web.pages.dev/ja/install#plugin)
 
 **Step 2** — AIアプリにMCPサーバーを登録:
 
@@ -169,7 +175,7 @@ Roblox Studioプラグインをインストールし、Claude CodeにMCPサー
 はい。AIはインスタンスの作成、スクリプトの記述、地形の生成、ライティングの設定、アセットの挿入、物理の設定など、すべてをライブStudioセッション内で直接実行します。コード生成を超えて実行可能なアクションまで処理します。
 
 ### BasicとProの違いは？
-Basic（無料）にはMCPツール実行と片方向同期（Studio -> Local）が含まれます。Proは双方向同期、バルク操作、地形生成、空間分析、オーディオ/アニメーション制御、マルチPlaceサポートを追加します。[Proアップグレードガイド](pro-upgrade.md)を参照してください。
+Basic（無料）にはMCPツール実行と片方向同期（Studio -> Local）が含まれます。Proは双方向同期、バルク操作、地形生成、空間分析、オーディオ/アニメーション制御、マルチPlaceサポートを追加します。[Proアップグレードガイド](https://weppy-web.pages.dev/ja/plans)を参照してください。
 
 ### Weppyは他のRoblox MCPサーバーとどう違いますか？
 Weppyは機能ごとに個別ツールを分ける代わりにアクションベースのディスパッチを使用します。これによりAIトークン消費が大幅に削減されます。また、双方向プロジェクト同期とマルチPlaceサポートを提供しますが、他の代替製品にはないことがほとんどです。
@@ -181,7 +187,7 @@ Weppyは機能ごとに個別ツールを分ける代わりにアクションベ
 
 双方向Sync、高度な制作機能、AIトークン効率 — 一度のアップグレードで全てを手に入れる。
 
-[Proアップグレードガイド](pro-upgrade.md)
+[Proアップグレードガイド](https://weppy-web.pages.dev/ja/plans)
 
 ## ライセンス
 

package/docs/ja/installation/README.md

@@ -46,7 +46,7 @@ WindowsでPowerShellの実行がブロックされる場合は、下の手動イ
 
 GitHubからプラグインファイルをダウンロードして、Roblox StudioのPluginsフォルダに配置します。
 
-👉 [プラグインインストールガイド](roblox-plugin.md)
+👉 [プラグインインストールガイド](https://weppy-web.pages.dev/ja/install#plugin)
 
 ---
 
@@ -73,7 +73,7 @@ GitHubからプラグインファイルをダウンロードして、Roblox Stud
 同期されたインスタンスツリーをRobloxクラスアイコン付きでVSCode内で閲覧できます。
 この拡張を使うには、先に上記のRoblox MCPセットアップを完了している必要があります。Explorer はプロジェクトルート配下の `wrox-project-sync` にある Sync データを読み取るためです。
 
-👉 [WROX Roblox Explorerインストールガイド](roblox-explorer.md)
+👉 [WROX Roblox Explorerインストールガイド](https://weppy-web.pages.dev/ja/install#explorer)
 
 直接インストール:
 - [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)

package/docs/ja/pro-upgrade.md

@@ -25,9 +25,16 @@ StudioのプレイテストをAIが実行・検証します。F5(Play)/F8(Run)
 - 「SpawnLocationが地面の上にあるかテストスクリプトを書いて自動実行して。」
 - 「さっき変更したスクリプトがエラーなく動くかプレイテストで検証して。」
 
-### より広い高度な機能
+### Pro専用の追加機能
 
-地形生成、アセット検索、空間解析、アニメーション、オーディオ、大規模自動化。
+Proはコアワークフローを超え、さらに多くの機能を利用できます。
+
+- **一括操作** — 1回のリクエストで複数インスタンスを作成・変更・削除
+- **地形生成** — ブロック、ボール、シリンダー、ウェッジの充填とマテリアル置換
+- **アセット検索/挿入** — Robloxマーケットからアセットを検索し直接挿入
+- **空間分析** — レイキャスト、地面検出、平地探索、衝突判定
+- **環境制御** — ライティング、大気、スカイ、時間帯の設定
+- **オーディオ/アニメーション** — サウンド再生とアニメーションのロード/再生
 
 ## 購入後のアクティベーション
 
@@ -70,13 +77,20 @@ StudioのプレイテストをAIが実行・検証します。F5(Play)/F8(Run)
 
 | 機能 | Basic | Pro |
 |-----|:-----:|:---:|
-| Script、Instance、Property管理 | ✅ フル利用可 | ✅ フル利用可 |
-| Selection、Tag、Camera、Log | ✅ フル利用可 | ✅ フル利用可 |
-| Sync方向 | Studio → Local（片方向） | 双方向 |
-| タイプ別Sync Direction | ❌ | ✅ Scripts / Values / Containers / Data / Services |
-| タイプ別Apply Mode | ❌ | ✅ Auto / Manual |
-| 変更履歴 | ❌ | ✅ |
-| マルチ Place Sync | ❌ | ✅ 最大3 Place、各Place独立ストレージ |
-| プレイテスト制御（再生/停止/一時停止/再開） | ❌ | ✅ |
-| 高度ツール範囲 | コア範囲 | より広い高度範囲 |
-| AIトークン効率 | 標準 | 一括/高効率アクションで有利 |
+| スクリプト作成/編集 | ✅ | ✅ |
+| インスタンス作成/削除/移動 | ✅ | ✅ + 一括操作 |
+| プロパティ読み取り/変更 | ✅ | ✅ + 一括変更 |
+| 選択、タグ、検索 | ✅ | ✅ |
+| カメラ制御 | ✅ | ✅ |
+| ログ監視 | ✅ | ✅ |
+| Luauコード実行 | ✅ | ✅ |
+| プロジェクト同期 | Studio → Local 片方向 | 双方向 + タイプ別方向/モード設定 |
+| マルチ Place Sync | — | 最大3 Place同時Sync |
+| 変更履歴 | — | 適用前の変更内容追跡 |
+| プレイテスト制御 | — | 再生 / 停止 / 一時停止 / 再開 + 自動テスト |
+| 地形生成/編集 | — | ブロック、ボール、シリンダー、ウェッジ、マテリアル置換 |
+| アセット検索/挿入 | — | Robloxマーケットから検索して直接挿入 |
+| 空間分析 | — | レイキャスト、地面検出、衝突判定 |
+| 環境制御 | — | ライティング、大気、スカイ、時間帯 |
+| オーディオ / アニメーション | — | サウンド再生、アニメーションロード/再生 |
+| AIトークン効率 | 個別アクション | 一括アクションで呼び出し回数削減 |

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

@@ -0,0 +1,41 @@
+# WROX Sync で `luau-lsp` を使う
+
+WROX Sync は `luau-lsp` が必要とする sourcemap ファイルを自動生成できるため、別の Rojo プロジェクトを用意しなくても Roblox 対応のエディタ機能を利用できます。
+
+## WROX が書き出すファイル
+
+Full Sync が完了すると、WROX は次のファイルを書き出します。
+
+- Place sourcemap: `wrox-project-sync/place_<id>/sourcemap.json`
+- ルート代表ファイル: `wrox-project-sync/sourcemap.json`
+
+ほとんどのユーザーには `wrox-project-sync/sourcemap.json` の利用を推奨します。
+
+## 何が改善されるか
+
+`luau-lsp` が WROX sourcemap を読むと、次の点が改善されます。
+
+- `game.*` の補完
+- 同期済みスクリプト間のナビゲーション
+- 同期済みスクリプト同士の `require` 解決
+
+## 推奨セットアップ
+
+1. WROX が `wrox-project-sync/sourcemap.json` を生成できるように、まず Full Sync を 1 回実行します。
+2. エディタの `luau-lsp` sourcemap 設定で `wrox-project-sync/sourcemap.json` を指定します。
+3. 利用中のクライアントで自動 Rojo 生成を無効にできる場合は、`luau-lsp.sourcemap.autogenerate` を `false` に設定します。
+
+VSCode 設定例:
+
+```json
+{
+  "luau-lsp.sourcemap.enabled": true,
+  "luau-lsp.sourcemap.autogenerate": false,
+  "luau-lsp.sourcemap.sourcemapFile": "wrox-project-sync/sourcemap.json"
+}
+```
+
+## Multi-place メモ
+
+`wrox-project-sync/sourcemap.json` は、プロジェクトの現在の代表 place に追従します。
+特定の place に固定したい場合は、その place の `wrox-project-sync/place_<id>/sourcemap.json` を `luau-lsp` から直接指定してください。

package/docs/ja/sync/overview.md

@@ -19,6 +19,8 @@ Syncがない場合、AIはチャットに貼られた断片だけを見て判
 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) を参照してください。
 
 ### VSCodeで同期データを閲覧する
 
@@ -146,5 +148,6 @@ explorer/
 
 ## 関連ドキュメント
 
+- [WROX Sync で `luau-lsp` を使う](./luau-lsp.md)
 - [Tool対応範囲 (Tools Overview)](../tools/overview.md)
-- [Proアップグレードガイド](../pro-upgrade.md)
+- [Proアップグレードガイド](https://weppy-web.pages.dev/ja/plans)

package/docs/ko/README.md

@@ -6,7 +6,7 @@
 
 [English](../../README.md) | **한국어** | [日本語](../ja/README.md) | [Español](../es/README.md) | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
 
-[![데모 — AI가 실시간으로 Roblox 게임을 제작하는 모습](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
+[![데모 — AI가 실시간으로 Roblox 게임을 제작하는 모습](https://img.youtube.com/vi/puQB4u1VlMw/maxresdefault.jpg)](https://youtu.be/puQB4u1VlMw)
 
 ## WROX (Weppy Roblox MCP)를 쓰는 이유
 
@@ -18,6 +18,14 @@ Claude, Codex, Gemini 같은 AI 코딩 에이전트는 강력하지만 — Roblo
 
 ## 빠른 설치
 
+웹페이지에서 안내에 따라 설치할 수 있습니다.
+
+👉 **[설치 페이지](https://weppy-web.pages.dev/ko/install)**
+
+### 터미널 원라인 설치
+
+터미널이 익숙하다면 아래 한 줄로 MCP 서버와 플러그인을 한 번에 설치할 수 있습니다.
+
 **macOS / Linux**
 
 ```bash
@@ -34,14 +42,12 @@ AI 앱을 다시 열고 Roblox Studio를 재시작하세요.
 
 자동 MCP 등록은 **Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI, Antigravity**를 지원합니다.
 
-Windows에서 PowerShell 실행이 차단되면 아래 설치 가이드를 사용하세요. ZIP 패키지를 사용하는 경우 `setup-plugin.bat`, `setup-mcp.bat`도 사용할 수 있습니다.
-
 ### 수동 설치
 
-원라인 설치가 동작하지 않거나 환경상 자동 설치를 사용할 수 없는 경우, 아래 설치 가이드를 대안으로 진행하세요.
+원라인 설치가 동작하지 않거나 환경상 자동 설치를 사용할 수 없는 경우:
 
-**1단계** — Roblox Studio 플러그인 설치 (Studio와 AI를 연결하는 다리):
-[플러그인 설치 가이드](installation/roblox-plugin.md)
+**1단계** — Roblox Studio 플러그인 설치:
+[플러그인 설치 가이드](https://weppy-web.pages.dev/ko/install#plugin)
 
 **2단계** — AI 앱에 MCP 서버 등록:
 
@@ -169,7 +175,7 @@ Roblox Studio 플러그인을 설치한 뒤, Claude Code에 MCP 서버(`npx -y @
 네. AI가 인스턴스 생성, 스크립트 작성, 지형 생성, 조명 설정, 에셋 삽입, 물리 설정 등을 라이브 Studio 세션 안에서 직접 수행합니다. 코드 생성을 넘어 실행 가능한 작업까지 처리합니다.
 
 ### Basic과 Pro의 차이는?
-Basic(무료)은 MCP 도구 실행과 단방향 동기화(Studio -> Local)를 포함합니다. Pro는 양방향 동기화, 대량 작업, 지형 생성, 공간 분석, 오디오/애니메이션 제어, 멀티 Place 지원을 추가합니다. [Pro 업그레이드 가이드](pro-upgrade.md)를 참고하세요.
+Basic(무료)은 MCP 도구 실행과 단방향 동기화(Studio -> Local)를 포함합니다. Pro는 양방향 동기화, 대량 작업, 지형 생성, 공간 분석, 오디오/애니메이션 제어, 멀티 Place 지원을 추가합니다. [Pro 업그레이드 가이드](https://weppy-web.pages.dev/ko/plans)를 참고하세요.
 
 ### Weppy는 다른 Roblox MCP 서버와 어떻게 다른가요?
 Weppy는 기능별 도구 분리 대신 액션 기반 디스패칭을 사용합니다. 이로 인해 AI 토큰 소비가 크게 줄어듭니다. 또한 양방향 프로젝트 동기화와 멀티 Place 지원을 제공하는데, 대부분의 대안에는 없는 기능입니다.
@@ -181,7 +187,7 @@ Weppy는 기능별 도구 분리 대신 액션 기반 디스패칭을 사용합
 
 양방향 Sync, 고급 제작 기능, AI 토큰 효율 — 한 번의 업그레이드로 모두 누리세요.
 
-[Pro 업그레이드 가이드](pro-upgrade.md)
+[Pro 업그레이드 가이드](https://weppy-web.pages.dev/ko/plans)
 
 ## 라이선스
 

package/docs/ko/installation/README.md

@@ -48,7 +48,7 @@ Windows에서 PowerShell 실행이 차단되면 아래 수동 설치로 진행
 
 GitHub에서 플러그인 파일을 다운로드한 뒤, Roblox Studio의 Plugins 폴더에 넣으면 됩니다.
 
-👉 [플러그인 설치 가이드](roblox-plugin.md)
+👉 [플러그인 설치 가이드](https://weppy-web.pages.dev/ko/install#plugin)
 
 ---
 
@@ -75,7 +75,7 @@ GitHub에서 플러그인 파일을 다운로드한 뒤, Roblox Studio의 Plugin
 동기화된 인스턴스 트리를 Roblox 클래스 아이콘과 함께 VSCode에서 탐색할 수 있습니다.
 이 확장은 위의 Roblox MCP 설치를 먼저 완료해야 사용할 수 있습니다. Explorer가 프로젝트 루트 아래의 `wrox-project-sync` Sync 데이터를 읽기 때문입니다.
 
-👉 [WROX Roblox Explorer 설치 가이드](roblox-explorer.md)
+👉 [WROX Roblox Explorer 설치 가이드](https://weppy-web.pages.dev/ko/install#explorer)
 
 바로 설치:
 - [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)

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

@@ -1,18 +1,22 @@
-# WROX Roblox Explorer (VSCode 확장)
+# WROX Roblox Explorer (VSCode · Antigravity 확장)
 
-Roblox Studio의 Explorer와 동일한 인스턴스 트리를 VSCode에서 볼 수 있는 확장입니다. 동기화된 인스턴스를 탐색하고, 스크립트를 바로 열고, Sync 상태를 에디터 안에서 확인할 수 있습니다.
+> **선택 사항** — Explorer는 필수가 아닙니다. MCP와 플러그인만으로도 모든 핵심 기능을 사용할 수 있습니다. 프로젝트 구조를 에디터에서 탐색하고 싶을 때 설치하세요.
+
+Roblox Studio의 Explorer와 동일한 인스턴스 트리를 에디터에서 볼 수 있는 확장입니다. 동기화된 인스턴스를 탐색하고, 스크립트를 바로 열고, Sync 상태를 에디터 안에서 확인할 수 있습니다.
 이 확장은 WROX용 companion 확장이며, 단독 Roblox 연동 도구는 아닙니다.
 
 ![WROX Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 
 ## 요구 사항
 
-- VSCode 1.85+
+- VSCode 1.85+ 또는 Antigravity
 - [Roblox MCP](../../../README.md) 설치 및 Sync 활성화 (Basic 또는 Pro)
 - 프로젝트 루트 아래에 Sync가 생성한 `wrox-project-sync/place_*/.sync-meta.json` 존재
 
 ## 설치 방법
 
+### VSCode
+
 VSCode Extensions 사이드바(`Ctrl+Shift+X` / `Cmd+Shift+X`)에서 **WROX Roblox Explorer**를 검색하고 **Install**을 클릭합니다.
 
 또는 아래 마켓플레이스에서 바로 설치할 수 있습니다.
@@ -20,6 +24,12 @@ VSCode Extensions 사이드바(`Ctrl+Shift+X` / `Cmd+Shift+X`)에서 **WROX Robl
 - [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 탭에서 **WROX Roblox Explorer**를 검색하고 **Install**을 클릭합니다.
+
+---
+
 기본 트리 탐색은 디스크에 있는 sync 파일만으로 동작합니다. 로컬 MCP 서버에 연결되면 실시간 sync 상태, direction 표시, Explorer 텔레메트리 전달 기능을 함께 사용할 수 있습니다.
 
 ## 기능

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

@@ -2,17 +2,42 @@
 
 Roblox Studio에서 AI 에이전트와 연결하기 위한 플러그인 설치 방법입니다.
 
-## 1. 플러그인 다운로드
+## 자동 설치 (권장)
+
+MCP 서버 설치가 완료되었다면 플러그인은 **자동으로 설치**됩니다. 별도 다운로드나 파일 복사가 필요 없습니다.
+
+### 동작 방식
+
+1. MCP 서버가 처음 실행될 때 플러그인 파일(`WeppyRobloxMCP.rbxm`)을 Roblox Studio의 Plugins 폴더에 자동 배치합니다.
+2. Roblox Studio를 시작하면 Plugins 탭에 **WROX** 버튼이 나타납니다.
+
+### 연결하기
+
+1. **Roblox Studio**에서 아무 프로젝트를 엽니다
+2. 상단 **Plugins** 탭 → **WROX** 클릭
+
+![WROX 버튼](../../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` 파일과 설치 가이드 포함
-
-참고:
-- Basic은 동일한 플러그인 패키지를 설치하고 Basic 정책(Studio -> Local 단방향 Sync)으로 동작합니다.
-- Pro 구독 라이선스 활성화 시 양방향 Sync와 더 넓은 고급 Tool 기능을 사용할 수 있습니다.
+3. ZIP 압축 해제 — `roblox-plugin/WeppyRobloxMCP.rbxm` 파일 포함
 
-## 2. 플러그인 설치
+### 2. 플러그인 설치
 
 1. **Roblox Studio** 실행
 2. 상단 메뉴 **Plugins** 탭 클릭
@@ -23,38 +48,19 @@ Roblox Studio에서 AI 에이전트와 연결하기 위한 플러그인 설치
 4. 압축 해제한 폴더에서 `WeppyRobloxMCP.rbxm` 파일을 열린 Plugins 폴더에 **복사**
 5. **Roblox Studio 재시작**
 
-## 3. 설치 확인
+### 3. 설치 확인
 
 재시작 후 Plugins 탭에 **WROX** 버튼이 나타납니다.
 
 ![WROX 버튼](../../assets/screenshots/plugin/installation/toolbar-button.png)
 
-## 4. AI 에이전트 연결
-
-### 사전 준비
-
-MCP 서버가 설치되어 있어야 합니다. 사용하는 AI 앱에 맞는 가이드를 먼저 완료하세요:
-
-| AI 앱 | 설치 가이드 |
-|-------|-------------|
-| Claude Code | [설정 방법](ai-apps/claude-code.md) |
-| Claude Desktop | [설정 방법](ai-apps/claude-app.md) |
-| Cursor | [설정 방법](ai-apps/cursor.md) |
-| Codex CLI | [설정 방법](ai-apps/codex-cli.md) |
-| Codex Desktop | [설정 방법](ai-apps/codex-app.md) |
-| Gemini CLI | [설정 방법](ai-apps/gemini-cli.md) |
-| Antigravity | [설정 방법](ai-apps/antigravity.md) |
-
-### 연결하기
+### 4. 연결하기
 
-1. **Roblox Studio**에서 아무 프로젝트를 엽니다
-2. 상단 **Plugins** 탭 -> **WROX** 클릭
-3. 플러그인 창에서 **Connect** 버튼 클릭
-4. **"Connected"** 상태가 표시되면 연결 완료
+위의 "연결하기" 섹션과 동일하게 Connect 버튼을 클릭하면 됩니다.
 
-![플러그인 메인 화면](../../assets/screenshots/plugin/installation/main-screen.png)
+---
 
-## 5. 설정 (선택사항)
+## 설정 (선택사항)
 
 플러그인 우측 상단의 설정 버튼을 클릭하면 다양한 옵션을 변경할 수 있습니다.
 
@@ -65,6 +71,11 @@ MCP 서버가 설치되어 있어야 합니다. 사용하는 AI 앱에 맞는
 - **자동 카메라 포커스**: 생성된 오브젝트로 카메라 자동 이동
 - **언어**: 플러그인 UI 언어 변경
 
+## 티어 안내
+
+- Basic은 동일한 플러그인 패키지를 설치하고 Basic 정책(Studio → Local 단방향 Sync)으로 동작합니다.
+- Pro 구독 라이선스 활성화 시 양방향 Sync와 더 넓은 고급 Tool 기능을 사용할 수 있습니다.
+
 ## 문제 해결
 
 ### 플러그인이 안 보여요

package/docs/ko/pro-upgrade.md

@@ -25,9 +25,16 @@ Studio 플레이테스트를 AI가 실행하고 검증합니다. F5(Play)/F8(Run
 - "SpawnLocation이 지면 위에 있는지 테스트 스크립트를 작성해서 자동 실행해줘."
 - "방금 수정한 스크립트가 에러 없이 동작하는지 플레이테스트로 검증해줘."
 
-### 더 넓은 고급 기능
+### 더 많은 Pro 전용 기능
 
-지형 생성, 에셋 검색, 공간 분석, 애니메이션, 오디오, 대규모 자동화.
+Pro는 핵심 워크플로를 넘어 더 많은 기능을 사용할 수 있습니다.
+
+- **대량 작업** — 한 번의 요청으로 여러 인스턴스를 생성·수정·삭제
+- **터레인 생성** — 블록, 볼, 실린더, 웨지 채우기 및 재질 교체
+- **에셋 검색/삽입** — Roblox 마켓에서 에셋을 검색하고 바로 삽입
+- **공간 분석** — 레이캐스트, 지면 찾기, 평지 탐색, 충돌 검사
+- **환경 제어** — 라이팅, 대기, 스카이, 시간대 설정
+- **오디오/애니메이션** — 사운드 재생 및 애니메이션 로드/재생
 
 ## 구매 후 활성화
 
@@ -70,13 +77,20 @@ Studio 플레이테스트를 AI가 실행하고 검증합니다. F5(Play)/F8(Run
 
 | 기능 | Basic | Pro |
 |-----|:-----:|:---:|
-| Script, Instance, Property 관리 | ✅ 전체 사용 | ✅ 전체 사용 |
-| Selection, Tag, Camera, Log | ✅ 전체 사용 | ✅ 전체 사용 |
-| Sync 방향 | Studio → Local (단방향) | 양방향 |
-| 타입별 Sync Direction | ❌ | ✅ Scripts / Values / Containers / Data / Services |
-| 타입별 Apply Mode | ❌ | ✅ Auto / Manual |
-| 변경 기록 | ❌ | ✅ |
-| 멀티 Place Sync | ❌ | ✅ 최대 3개 Place, 각각 독립 저장소 |
-| 플레이테스트 제어 (실행/정지/일시정지/재개) | ❌ | ✅ |
-| 고급 Tool 범위 | 기본 범위 | 더 넓은 고급 범위 |
-| AI 토큰 효율 | 기본 | 대량/고효율 action으로 더 유리 |
+| 스크립트 생성/편집 | ✅ | ✅ |
+| 인스턴스 생성/삭제/이동 | ✅ | ✅ + 대량 작업 |
+| 속성 읽기/변경 | ✅ | ✅ + 대량 변경 |
+| 선택, 태그, 검색 | ✅ | ✅ |
+| 카메라 제어 | ✅ | ✅ |
+| 로그 모니터링 | ✅ | ✅ |
+| Luau 코드 실행 | ✅ | ✅ |
+| 프로젝트 동기화 | Studio → Local 단방향 | 양방향 + 타입별 방향/모드 설정 |
+| 멀티 Place Sync | — | 최대 3개 Place 동시 Sync |
+| 변경 기록 | — | 적용 전 변경 내용 추적 |
+| 플레이테스트 제어 | — | 실행 / 정지 / 일시정지 / 재개 + 자동 테스트 |
+| 터레인 생성/편집 | — | 블록, 볼, 실린더, 웨지, 재질 교체 |
+| 에셋 검색/삽입 | — | Roblox 마켓에서 검색 후 바로 삽입 |
+| 공간 분석 | — | 레이캐스트, 지면 찾기, 충돌 검사 |
+| 환경 제어 | — | 라이팅, 대기, 스카이, 시간대 |
+| 오디오 / 애니메이션 | — | 사운드 재생, 애니메이션 로드/재생 |
+| AI 토큰 효율 | 건별 작업 | 대량 action으로 호출 횟수 절감 |

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

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

package/docs/ko/sync/overview.md

@@ -19,6 +19,8 @@ Sync가 없으면 AI는 대화에 붙여 넣은 코드 일부만 보고 판단
 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)에서 확인할 수 있습니다.
 
 ### VSCode에서 Sync 데이터 탐색
 
@@ -146,5 +148,6 @@ explorer/
 
 ## 함께 보면 좋은 문서
 
+- [WROX Sync에서 `luau-lsp` 사용하기](./luau-lsp.md)
 - [Tool 지원 범위 (Tools Overview)](../tools/overview.md)
-- [Pro 업그레이드 가이드](../pro-upgrade.md)
+- [Pro 업그레이드 가이드](https://weppy-web.pages.dev/ko/plans)

package/docs/pt-br/README.md

@@ -6,7 +6,7 @@
 
 [English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | [Español](../es/README.md) | **Português** | [Bahasa Indonesia](../id/README.md)
 
-[![Demo — IA criando um jogo Roblox em tempo real](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
+[![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)?
 
@@ -18,6 +18,14 @@ Sem necessidade de copiar e colar código. A IA trabalha e você confere os resu
 
 ## Instalacao rapida
 
+Instale seguindo o guia na pagina web.
+
+👉 **[Pagina de instalacao](https://weppy-web.pages.dev/en/install)**
+
+### Instalacao por terminal
+
+Se voce esta confortavel com o terminal, instale tudo em uma linha.
+
 **macOS / Linux**
 
 ```bash
@@ -40,8 +48,8 @@ Se a execução do PowerShell estiver bloqueada no Windows, siga a instalação
 
 Se a instalacao em um comando nao funcionar, ou se a instalacao automatica nao puder ser usada no seu ambiente, use a instalacao manual abaixo como alternativa.
 
-**Passo 1** — Instale o plugin do Roblox Studio (ponte entre Studio e IA):
-[Guia de instalacao do plugin](installation/roblox-plugin.md)
+**Passo 1** — Instale o plugin do Roblox Studio:
+[Guia de instalacao do plugin](https://weppy-web.pages.dev/en/install#plugin)
 
 **Passo 2** — Registre o servidor MCP no seu app de IA:
 
@@ -169,7 +177,7 @@ Sim. Consulte [Configuração do Cursor](installation/ai-apps/cursor.md). Qualqu
 Sim. A IA pode criar instâncias, escrever scripts, gerar terrain, configurar iluminação, inserir assets, configurar física e mais — tudo dentro de uma sessão de Studio ao vivo. Vai além da geração de código para ações executáveis.
 
 ### Qual é a diferença entre Basic e Pro?
-Basic (gratuito) inclui execução de ferramentas MCP e sincronização unidirecional (Studio -> Local). Pro adiciona sincronização bidirecional, operações em massa, geração de terrain, análise espacial, controle de áudio/animação e suporte multi-place. Consulte o [Guia de upgrade Pro](pro-upgrade.md).
+Basic (gratuito) inclui execução de ferramentas MCP e sincronização unidirecional (Studio -> Local). Pro adiciona sincronização bidirecional, operações em massa, geração de terrain, análise espacial, controle de áudio/animação e suporte multi-place. Consulte o [Guia de upgrade Pro](https://weppy-web.pages.dev/en/plans).
 
 ### Como o Weppy se diferencia de outros servidores MCP para Roblox?
 O Weppy usa despacho baseado em ações em vez de ferramentas separadas para cada função. Isso reduz significativamente o consumo de tokens de IA. Também fornece sincronização bidirecional de projeto e suporte multi-place, que a maioria das alternativas não possui.
@@ -181,7 +189,7 @@ O servidor roda apenas em localhost (127.0.0.1:3002). Caminhos proibidos (CoreGu
 
 Sync bidirecional, recursos avancados de criacao e eficiencia de tokens de IA — tudo em uma unica atualizacao.
 
-[Guia de upgrade Pro](pro-upgrade.md)
+[Guia de upgrade Pro](https://weppy-web.pages.dev/en/plans)
 
 ## Licença
 

package/docs/pt-br/installation/README.md

@@ -46,7 +46,7 @@ Se a instalacao em um comando nao funcionar, ou quando a instalacao automatica n
 
 Baixe o arquivo do plugin no GitHub e coloque na pasta Plugins do Roblox Studio.
 
-👉 [Guia de instalação do plugin](roblox-plugin.md)
+👉 [Guia de instalação do plugin](https://weppy-web.pages.dev/en/install#plugin)
 
 ---
 
@@ -73,7 +73,7 @@ Registre o servidor MCP no seu app de IA. Funciona com qualquer app que suporte
 Navegue pelas árvores de instâncias sincronizadas dentro do VSCode com ícones de classes Roblox.
 Esta extensao opcional exige que a instalacao do Roblox MCP acima ja esteja concluida, porque o Explorer le os dados de Sync em `wrox-project-sync` dentro da raiz do projeto.
 
-👉 [Guia de instalação do WROX Roblox Explorer](roblox-explorer.md)
+👉 [Guia de instalação do WROX Roblox Explorer](https://weppy-web.pages.dev/en/install#explorer)
 
 Instalação direta:
 - [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)