@weppy/roblox-mcp 2.0.5 → 2.0.6

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Weppy Roblox MCP — MCP server that lets AI coding agents control a live Roblox Studio session with 21 tools, 140+ actions, bidirectional sync, automated playtest, and multi-place support",
-    "version": "2.0.5"
+    "version": "2.0.6"
   },
   "plugins": [
     {
       "name": "weppy-roblox-mcp",
       "source": "./plugins/weppy-roblox-mcp",
       "description": "Weppy Roblox MCP — MCP server that lets AI coding agents control a live Roblox Studio session with 21 tools, 140+ actions, bidirectional sync, automated playtest, and multi-place support",
-      "version": "2.0.5",
+      "version": "2.0.6",
       "author": {
         "name": "hope1026"
       },

package/CHANGELOG.md

@@ -18,6 +18,12 @@ All notable changes to this project will be documented in this file.
 
 
 
+## [2.0.6] - 2026-03-25
+
+### Improved
+
+- Enhanced overall stability and reliability
+
 
 ## [2.0.5] - 2026-03-24
 

package/README.md

@@ -114,6 +114,7 @@ The MCP server provides a web dashboard where you can check connection status, t
 ### 5) Roblox Explorer: Browse Studio hierarchy in VSCode
 
 View the full instance tree of your Roblox Studio place directly inside VSCode. Navigate services, open synced scripts and property files, and track sync status — all without switching to Studio.
+Roblox Explorer is a companion VSCode extension for sync data generated by Weppy Roblox MCP. Tree browsing works from synced files, and live sync state or direction indicators are enhanced when the local MCP server is running.
 
 ![Roblox Explorer — Studio instance tree displayed in VSCode sidebar](docs/assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 

package/docs/en/installation/README.md

@@ -72,6 +72,7 @@ Register the MCP server with your AI app. You can use it with any AI app that su
 ## Optional: Install Roblox Explorer (VSCode Extension)
 
 Browse synced instance trees inside VSCode with Roblox class icons.
+This optional extension requires the Roblox MCP setup above, because it reads `roblox-project-sync` data generated by Sync.
 
 👉 [Roblox Explorer Installation Guide](roblox-explorer.md)
 

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

@@ -1,32 +1,23 @@
 # Weepy Roblox Explorer (VSCode Extension)
 
 Roblox Studio Explorer-like tree view for VSCode. Browse synced instance trees, open scripts directly, and track sync status — all inside your editor.
+This is a companion extension for Weppy Roblox MCP, not a standalone Roblox integration.
 
 ![Weepy Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 
 ## Requirements
 
 - VSCode 1.85+
-- [Roblox MCP](../../../README.md) Sync enabled (Basic or Pro)
+- [Roblox MCP](../../../README.md) installed with Sync enabled (Basic or Pro)
+- `roblox-project-sync/place_*/.sync-meta.json` already generated by Sync
 
 ## Installation
 
-### 1. Download Release Package
+Search for **Weepy Roblox Explorer** in the VSCode Extensions sidebar (`Ctrl+Shift+X` / `Cmd+Shift+X`) and click **Install**.
 
-Go to the [Releases](https://github.com/hope1026/weppy-roblox-mcp/releases) page and download the latest `weppy-roblox-explorer-v*.zip` file.
+Or install directly from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer).
 
-> The ZIP package contains the `weppy-roblox-explorer-*.vsix` file you will install in VSCode.
-
-### 2. Install in VSCode
-
-1. Open VSCode
-2. Open the Extensions sidebar (`Ctrl+Shift+X` / `Cmd+Shift+X`)
-3. Click the `...` menu at the top → **Install from VSIX...**
-
-![Install from VSIX](../../assets/screenshots/roblox-explorer/install-from-vsix.png)
-
-4. Extract the ZIP package and select the included `.vsix` file
-5. Reload VSCode when prompted
+Core tree browsing works from synced files on disk. Live sync state, direction indicators, and Explorer telemetry forwarding are available when the local MCP server is reachable.
 
 ## Features
 
@@ -58,10 +49,6 @@ Go to the [Releases](https://github.com/hope1026/weppy-roblox-mcp/releases) page
 | `Weepy Roblox Explorer: Copy Instance Path` | Copy the full instance path (e.g. `game.Workspace.Part`) |
 | `Weepy Roblox Explorer: Reveal in Explorer` | Show the backing file in the default VSCode explorer |
 
-## Updating
-
-Download the latest `weppy-roblox-explorer-v*.zip` from [Releases](https://github.com/hope1026/weppy-roblox-mcp/releases), extract the `.vsix`, and repeat the installation steps. VSCode will replace the existing version.
-
 ## Related
 
 - [Sync Deep Dive](../sync/overview.md)

package/docs/en/sync/overview.md

@@ -23,6 +23,7 @@ Default local path is `roblox-project-sync/place_{placeId}/explorer`.
 ### Browse sync data in VSCode
 
 Install the [Weepy Roblox Explorer](../installation/roblox-explorer.md) extension to browse the synced instance tree in VSCode, just like in Roblox Studio.
+Explorer reads the sync files generated here, and it can show additional live sync state or direction details when the local MCP server is running.
 
 ![Weepy Roblox Explorer — browse synced instance tree in VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 

package/docs/es/README.md

@@ -105,6 +105,7 @@ El Dashboard web proporcionado por el servidor MCP permite consultar en tiempo r
 ### 5) Roblox Explorer: explora la jerarquia de Studio en VSCode
 
 Visualiza el arbol completo de instancias de tu lugar en Roblox Studio directamente dentro de VSCode. Navega los servicios, abre scripts y archivos de propiedades sincronizados, y rastrea el estado de sincronizacion — todo sin cambiar a Studio.
+Roblox Explorer es una extension complementaria de VSCode para los datos de sync generados por Weppy Roblox MCP. El arbol base funciona con los archivos sincronizados en disco, y los indicadores en vivo de estado sync o direction se enriquecen cuando el servidor MCP local esta en ejecucion.
 
 ![Roblox Explorer — arbol de instancias de Studio mostrado en la barra lateral de VSCode](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 

package/docs/es/installation/README.md

@@ -67,6 +67,7 @@ Configura el servidor MCP en tu app de IA para que pueda comunicarse con Roblox
 ## Opcional: Instalar Roblox Explorer (Extensión VSCode)
 
 Explora los árboles de instancias sincronizados dentro de VSCode con iconos de clases Roblox.
+Esta extensión opcional requiere completar antes la instalación de Roblox MCP, porque Explorer lee los datos `roblox-project-sync` generados por Sync.
 
 👉 [Guía de instalación de Roblox Explorer](roblox-explorer.md)
 

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

@@ -0,0 +1,55 @@
+# Weepy Roblox Explorer (Extensión VSCode)
+
+Vista de árbol de instancias similar al Explorer de Roblox Studio, dentro de VSCode. Navega instancias sincronizadas, abre scripts directamente y consulta el estado de sincronización sin salir del editor.
+Esta es una extensión complementaria para Weppy Roblox MCP, no una integración de Roblox independiente.
+
+![Weepy Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+
+## Requisitos
+
+- VSCode 1.85+
+- [Roblox MCP](../../../README.md) instalado con Sync habilitado (Basic o Pro)
+- `roblox-project-sync/place_*/.sync-meta.json` ya generado por Sync
+
+## Instalación
+
+Busca **Weepy Roblox Explorer** en la barra lateral de Extensiones de VSCode (`Ctrl+Shift+X` / `Cmd+Shift+X`) y haz clic en **Install**.
+
+O instala directamente desde el [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer).
+
+La navegación básica del árbol funciona con los archivos sincronizados en disco. El estado sync en vivo, los indicadores de direction y el reenvío de telemetría del Explorer están disponibles cuando el servidor MCP local es accesible.
+
+## Características
+
+- **Árbol de instancias**: Jerarquía de servicios/instancias idéntica a Roblox Studio
+- **Iconos de clases Roblox**: Más de 200 iconos con soporte de tema oscuro/claro
+- **Multi-Place**: Raíces de árbol separadas por cada Place sincronizado
+- **Abrir al hacer clic**: Abre archivos de respaldo (`.server.luau`, `.client.luau`, `.module.luau`, `.props.json`)
+- **Búsqueda de instancias**: Búsqueda QuickPick en todos los servicios
+- **Insignias de estado Sync**: Visualiza los estados `modified`, `studio`, `conflict` de un vistazo
+- **Actualización automática**: El árbol se actualiza automáticamente cuando cambian los archivos Sync (debounce 500ms)
+- **Copiar ruta de instancia**: Clic derecho para copiar rutas tipo `game.Workspace.Part`
+
+## Configuración
+
+| Configuración | Valor por defecto | Descripción |
+|---------------|-------------------|-------------|
+| `robloxExplorer.syncRoot` | `""` | Ruta absoluta a la raíz de `roblox-project-sync`. Se detecta automáticamente si está vacío. |
+| `robloxExplorer.hidePropsFiles` | `false` | Oculta los archivos de Sync (`.props.json`, `_tree.json`, `.value.json`) en el explorador predeterminado de VSCode. |
+| `robloxExplorer.autoRefresh` | `true` | Actualiza automáticamente el árbol cuando cambian los archivos Sync. |
+| `robloxExplorer.showSyncStatus` | `true` | Muestra decoraciones de estado Sync en los elementos del árbol. |
+
+## Comandos
+
+| Comando | Descripción |
+|---------|-------------|
+| `Weepy Roblox Explorer: Refresh` | Actualizar manualmente el árbol de instancias |
+| `Weepy Roblox Explorer: Search Instances` | Buscar instancias en todos los servicios |
+| `Weepy Roblox Explorer: Open Backing File` | Abrir el archivo de respaldo de una instancia seleccionada |
+| `Weepy Roblox Explorer: Copy Instance Path` | Copiar la ruta completa de la instancia (ej. `game.Workspace.Part`) |
+| `Weepy Roblox Explorer: Reveal in Explorer` | Mostrar el archivo en el explorador predeterminado de VSCode |
+
+## Relacionado
+
+- [Guía detallada de Sync](../sync/overview.md)
+- [Guía de instalación](README.md)

package/docs/es/sync/overview.md

@@ -23,6 +23,7 @@ La ruta local por defecto es `roblox-project-sync/place_{placeId}/explorer`.
 ### Explorar datos sincronizados en VSCode
 
 Instala la extension [Weepy Roblox Explorer](../installation/roblox-explorer.md) para explorar el arbol de instancias sincronizado en VSCode, igual que en Roblox Studio.
+Explorer lee los archivos sync generados aqui, y puede mostrar ademas estado sync en vivo e informacion de direction cuando el servidor MCP local esta en ejecucion.
 
 ![Weepy Roblox Explorer — explorar el arbol de instancias sincronizado en VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 

package/docs/id/README.md

@@ -105,6 +105,7 @@ Dashboard berbasis web yang disediakan server MCP memungkinkan Anda melihat stat
 ### 5) Roblox Explorer: jelajahi hierarki Studio di VSCode
 
 Lihat seluruh pohon instance dari place Roblox Studio langsung di dalam VSCode. Navigasi service, buka script dan file properti yang tersinkron, dan pantau status sinkronisasi — semua tanpa beralih ke Studio.
+Roblox Explorer adalah ekstensi pendamping VSCode untuk data sync yang dihasilkan oleh Weppy Roblox MCP. Penjelajahan tree dasar bekerja dari file yang sudah tersinkron di disk, dan indikator live untuk status sync atau direction menjadi lebih lengkap saat server MCP lokal sedang berjalan.
 
 ![Roblox Explorer — pohon instance Studio ditampilkan di sidebar VSCode](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 

package/docs/id/installation/README.md

@@ -72,6 +72,7 @@ Daftarkan MCP server ke aplikasi AI yang kamu pakai. Bisa digunakan di semua apl
 ## Opsional: Install Roblox Explorer (Ekstensi VSCode)
 
 Jelajahi tree instance yang sudah disinkronkan di dalam VSCode dengan ikon kelas Roblox.
+Ekstensi opsional ini mengharuskan setup Roblox MCP di atas sudah selesai lebih dulu, karena Explorer membaca data `roblox-project-sync` yang dihasilkan oleh Sync.
 
 👉 [Panduan Instalasi Roblox Explorer](roblox-explorer.md)
 

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

@@ -0,0 +1,55 @@
+# Weepy Roblox Explorer (Ekstensi VSCode)
+
+Tampilan pohon instansi seperti Explorer Roblox Studio, langsung di VSCode. Jelajahi instansi yang tersinkronisasi, buka skrip langsung, dan pantau status sinkronisasi tanpa meninggalkan editor.
+Ini adalah ekstensi pendamping untuk Weppy Roblox MCP, bukan integrasi Roblox yang berdiri sendiri.
+
+![Weepy Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+
+## Persyaratan
+
+- VSCode 1.85+
+- [Roblox MCP](../../../README.md) sudah terpasang dengan Sync aktif (Basic atau Pro)
+- `roblox-project-sync/place_*/.sync-meta.json` sudah dihasilkan oleh Sync
+
+## Cara Instalasi
+
+Cari **Weepy Roblox Explorer** di sidebar Ekstensi VSCode (`Ctrl+Shift+X` / `Cmd+Shift+X`) dan klik **Install**.
+
+Atau instal langsung dari [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer).
+
+Penjelajahan tree dasar bekerja dari file sync di disk. Status sync live, indikator direction, dan pengiriman telemetri Explorer tersedia saat server MCP lokal dapat dijangkau.
+
+## Fitur
+
+- **Pohon instansi**: Hierarki layanan/instansi yang identik dengan Roblox Studio
+- **Ikon kelas Roblox**: Lebih dari 200 ikon dengan dukungan tema gelap/terang
+- **Multi-Place**: Akar pohon terpisah per Place yang tersinkronisasi
+- **Buka dengan klik**: Buka file pendukung (`.server.luau`, `.client.luau`, `.module.luau`, `.props.json`)
+- **Pencarian instansi**: Pencarian QuickPick di semua layanan
+- **Badge status Sync**: Lihat status `modified`, `studio`, `conflict` sekilas
+- **Pembaruan otomatis**: Pohon diperbarui otomatis saat file Sync berubah (debounce 500ms)
+- **Salin jalur instansi**: Klik kanan untuk menyalin jalur format `game.Workspace.Part`
+
+## Pengaturan
+
+| Pengaturan | Default | Deskripsi |
+|------------|---------|-----------|
+| `robloxExplorer.syncRoot` | `""` | Jalur absolut ke root `roblox-project-sync`. Terdeteksi otomatis jika kosong. |
+| `robloxExplorer.hidePropsFiles` | `false` | Sembunyikan file Sync (`.props.json`, `_tree.json`, `.value.json`) di explorer VSCode default. |
+| `robloxExplorer.autoRefresh` | `true` | Perbarui pohon otomatis saat file Sync berubah. |
+| `robloxExplorer.showSyncStatus` | `true` | Tampilkan dekorasi status Sync pada item pohon. |
+
+## Perintah
+
+| Perintah | Deskripsi |
+|----------|-----------|
+| `Weepy Roblox Explorer: Refresh` | Perbarui pohon instansi secara manual |
+| `Weepy Roblox Explorer: Search Instances` | Cari instansi di semua layanan |
+| `Weepy Roblox Explorer: Open Backing File` | Buka file pendukung instansi yang dipilih |
+| `Weepy Roblox Explorer: Copy Instance Path` | Salin jalur instansi lengkap (contoh: `game.Workspace.Part`) |
+| `Weepy Roblox Explorer: Reveal in Explorer` | Tampilkan file di explorer VSCode default |
+
+## Terkait
+
+- [Panduan Detail Sync](../sync/overview.md)
+- [Panduan Instalasi](README.md)

package/docs/id/sync/overview.md

@@ -23,6 +23,7 @@ Path lokal default adalah `roblox-project-sync/place_{placeId}/explorer`.
 ### Jelajahi data sync di VSCode
 
 Instal ekstensi [Weepy Roblox Explorer](../installation/roblox-explorer.md) untuk menjelajahi tree instance yang sudah tersinkron di VSCode, seperti di Roblox Studio.
+Explorer membaca file sync yang dihasilkan di sini, dan juga bisa menampilkan status sync live serta informasi direction saat server MCP lokal sedang berjalan.
 
 ![Weepy Roblox Explorer — jelajahi tree instance yang tersinkron di VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 

package/docs/ja/README.md

@@ -105,6 +105,7 @@ MCPサーバーが提供するWebダッシュボードで、接続状態、ツ
 ### 5) Roblox Explorer: VSCodeでStudioの階層構造を閲覧
 
 Roblox Studioのインスタンスツリー全体をVSCode内で直接確認できます。サービスを探索し、同期されたスクリプトやプロパティファイルを開き、同期状態を追跡 — Studioに切り替える必要はありません。
+Roblox Explorerは、Weppy Roblox MCPが生成するsyncデータを扱うcompanion VSCode拡張です。基本のツリー閲覧は同期済みファイルだけで動作し、ローカルMCPサーバーが動作中ならlive sync状態やdirection表示がより正確に反映されます。
 
 ![Roblox Explorer — VSCodeサイドバーに表示されるStudioインスタンスツリー](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 

package/docs/ja/installation/README.md

@@ -72,6 +72,7 @@ GitHubからプラグインファイルをダウンロードして、Roblox Stud
 ## オプション: Roblox Explorer (VSCode拡張) のインストール
 
 同期されたインスタンスツリーをRobloxクラスアイコン付きでVSCode内で閲覧できます。
+この拡張を使うには、先に上記のRoblox MCPセットアップを完了している必要があります。ExplorerはSyncが生成した`roblox-project-sync`データを読み取るためです。
 
 👉 [Roblox Explorerインストールガイド](roblox-explorer.md)
 

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

@@ -0,0 +1,55 @@
+# Weepy Roblox Explorer (VSCode拡張)
+
+Roblox StudioのExplorerと同じインスタンスツリーをVSCodeで表示できる拡張機能です。同期済みインスタンスの探索、スクリプトの直接開封、Sync状態の確認をエディタ内で行えます。
+この拡張はWeppy Roblox MCP用のcompanion拡張であり、単体のRoblox連携ツールではありません。
+
+![Weepy Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+
+## 要件
+
+- VSCode 1.85+
+- [Roblox MCP](../../../README.md) をインストールし、Syncを有効化 (BasicまたはPro)
+- Syncで生成された `roblox-project-sync/place_*/.sync-meta.json` が存在すること
+
+## インストール方法
+
+VSCode Extensionsサイドバー（`Ctrl+Shift+X` / `Cmd+Shift+X`）で **Weepy Roblox Explorer** を検索し、**Install** をクリックします。
+
+または [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer) から直接インストールできます。
+
+基本のツリー閲覧はディスク上のsyncファイルだけで動作します。ローカルMCPサーバーに接続できる場合は、live 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` | `""` | `roblox-project-sync`ルートの絶対パス。空の場合は自動検出。 |
+| `robloxExplorer.hidePropsFiles` | `false` | デフォルトのVSCodeエクスプローラーでSyncファイル（`.props.json`、`_tree.json`、`.value.json`）を非表示にする。 |
+| `robloxExplorer.autoRefresh` | `true` | Syncファイルの変更時にツリーを自動更新する。 |
+| `robloxExplorer.showSyncStatus` | `true` | ツリー項目にSync状態のデコレーションを表示する。 |
+
+## コマンド
+
+| コマンド | 説明 |
+|---------|------|
+| `Weepy Roblox Explorer: Refresh` | インスタンスツリーを手動で更新 |
+| `Weepy Roblox Explorer: Search Instances` | 全サービスでインスタンスを検索 |
+| `Weepy Roblox Explorer: Open Backing File` | 選択したインスタンスのファイルを開く |
+| `Weepy Roblox Explorer: Copy Instance Path` | 完全なインスタンスパスをコピー（例: `game.Workspace.Part`） |
+| `Weepy Roblox Explorer: Reveal in Explorer` | デフォルトのVSCodeエクスプローラーでファイルを表示 |
+
+## 関連ドキュメント
+
+- [Sync詳細ガイド](../sync/overview.md)
+- [インストールガイド](README.md)

package/docs/ja/sync/overview.md

@@ -23,6 +23,7 @@ Syncがない場合、AIはチャットに貼られた断片だけを見て判
 ### VSCodeで同期データを閲覧する
 
 [Weepy Roblox Explorer](../installation/roblox-explorer.md) 拡張機能をインストールすると、Roblox Studioと同じようにVSCode上で同期済みインスタンスツリーを閲覧できます。
+Explorerはここで生成されたsyncファイルを読み取り、ローカルMCPサーバーが動作中なら追加でlive sync状態とdirection情報も表示できます。
 
 ![Weepy Roblox Explorer — VSCodeで同期済みインスタンスツリーを閲覧](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 

package/docs/ko/README.md

@@ -105,6 +105,7 @@ MCP 서버가 제공하는 웹 대시보드에서 연결 상태, 도구 실행
 ### 5) Roblox Explorer: VSCode에서 Studio 계층 구조 탐색
 
 Roblox Studio의 전체 인스턴스 트리를 VSCode 안에서 바로 확인할 수 있습니다. 서비스를 탐색하고, 동기화된 스크립트와 속성 파일을 열고, 동기화 상태를 추적하세요 — Studio로 전환할 필요 없이.
+Roblox Explorer는 Weppy Roblox MCP가 생성한 sync 데이터를 위한 companion VSCode 확장입니다. 기본 트리 탐색은 동기화된 파일만으로 동작하고, 로컬 MCP 서버가 실행 중이면 실시간 sync 상태와 direction 표시가 더 정확하게 반영됩니다.
 
 ![Roblox Explorer — VSCode 사이드바에 표시되는 Studio 인스턴스 트리](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 

package/docs/ko/installation/README.md

@@ -72,6 +72,7 @@ GitHub에서 플러그인 파일을 다운로드한 뒤, Roblox Studio의 Plugin
 ## 선택 사항: Roblox Explorer (VSCode 확장) 설치
 
 동기화된 인스턴스 트리를 Roblox 클래스 아이콘과 함께 VSCode에서 탐색할 수 있습니다.
+이 확장은 위의 Roblox MCP 설치를 먼저 완료해야 사용할 수 있습니다. Explorer가 Sync가 생성한 `roblox-project-sync` 데이터를 읽기 때문입니다.
 
 👉 [Roblox Explorer 설치 가이드](roblox-explorer.md)
 

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

@@ -1,32 +1,23 @@
 # Weepy Roblox Explorer (VSCode 확장)
 
 Roblox Studio의 Explorer와 동일한 인스턴스 트리를 VSCode에서 볼 수 있는 확장입니다. 동기화된 인스턴스를 탐색하고, 스크립트를 바로 열고, Sync 상태를 에디터 안에서 확인할 수 있습니다.
+이 확장은 Weppy Roblox MCP용 companion 확장이며, 단독 Roblox 연동 도구는 아닙니다.
 
 ![Weepy Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 
 ## 요구 사항
 
 - VSCode 1.85+
-- [Roblox MCP](../../../README.md) Sync 활성화 (Basic 또는 Pro)
+- [Roblox MCP](../../../README.md) 설치 및 Sync 활성화 (Basic 또는 Pro)
+- Sync가 생성한 `roblox-project-sync/place_*/.sync-meta.json` 존재
 
 ## 설치 방법
 
-### 1. 릴리스 ZIP 다운로드
+VSCode Extensions 사이드바(`Ctrl+Shift+X` / `Cmd+Shift+X`)에서 **Weepy Roblox Explorer**를 검색하고 **Install**을 클릭합니다.
 
-[Releases](https://github.com/hope1026/weppy-roblox-mcp/releases) 페이지에서 최신 `weppy-roblox-explorer-v*.zip` 파일을 다운로드합니다.
+또는 [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)에서 바로 설치할 수 있습니다.
 
-> ZIP 패키지 안에 VSCode에 설치할 `weppy-roblox-explorer-*.vsix` 파일이 들어 있습니다.
-
-### 2. VSCode에서 설치
-
-1. VSCode를 엽니다
-2. Extensions 사이드바를 엽니다 (`Ctrl+Shift+X` / `Cmd+Shift+X`)
-3. 상단 `...` 메뉴 → **Install from VSIX...** 클릭
-
-![Install from VSIX](../../assets/screenshots/roblox-explorer/install-from-vsix.png)
-
-4. ZIP을 압축 해제한 뒤 포함된 `.vsix` 파일을 선택합니다
-5. 안내에 따라 VSCode를 리로드합니다
+기본 트리 탐색은 디스크에 있는 sync 파일만으로 동작합니다. 로컬 MCP 서버에 연결되면 실시간 sync 상태, direction 표시, Explorer 텔레메트리 전달 기능을 함께 사용할 수 있습니다.
 
 ## 기능
 
@@ -58,10 +49,6 @@ Roblox Studio의 Explorer와 동일한 인스턴스 트리를 VSCode에서 볼
 | `Weepy Roblox Explorer: Copy Instance Path` | 전체 인스턴스 경로 복사 (예: `game.Workspace.Part`) |
 | `Weepy Roblox Explorer: Reveal in Explorer` | 기본 VSCode 탐색기에서 파일 표시 |
 
-## 업데이트
-
-[Releases](https://github.com/hope1026/weppy-roblox-mcp/releases)에서 최신 `weppy-roblox-explorer-v*.zip`를 다운로드하고 `.vsix`를 압축 해제한 뒤 동일한 설치 과정을 반복하면 됩니다. 기존 버전이 자동으로 교체됩니다.
-
 ## 관련 문서
 
 - [Sync 기능 상세 가이드](../sync/overview.md)

package/docs/ko/sync/overview.md

@@ -23,6 +23,7 @@ Sync가 없으면 AI는 대화에 붙여 넣은 코드 일부만 보고 판단
 ### VSCode에서 Sync 데이터 탐색
 
 [Weepy Roblox Explorer](../installation/roblox-explorer.md) 확장을 설치하면, 동기화된 인스턴스 트리를 Roblox Studio와 동일한 형태로 VSCode에서 탐색할 수 있습니다.
+Explorer는 여기서 생성된 sync 파일을 읽고, 로컬 MCP 서버가 실행 중이면 추가로 실시간 sync 상태와 direction 정보를 표시할 수 있습니다.
 
 ![Weepy Roblox Explorer — 동기화된 인스턴스 트리를 VSCode에서 탐색하는 모습](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 

package/docs/pt-br/README.md

@@ -105,6 +105,7 @@ No dashboard web fornecido pelo servidor MCP, acompanhe em tempo real o status d
 ### 5) 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.
+Roblox Explorer e uma extensao complementar do VSCode para os dados de sync gerados pelo Weppy Roblox MCP. 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.
 
 ![Roblox Explorer — arvore de instancias do Studio exibida na barra lateral do VSCode](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 

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

@@ -72,6 +72,7 @@ Registre o servidor MCP no seu app de IA. Funciona com qualquer app que suporte
 ## Opcional: Instalar Roblox Explorer (Extensão VSCode)
 
 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 `roblox-project-sync` gerados pelo Sync.
 
 👉 [Guia de instalação do Roblox Explorer](roblox-explorer.md)
 

package/docs/pt-br/installation/roblox-explorer.md

@@ -0,0 +1,55 @@
+# Weepy Roblox Explorer (Extensão VSCode)
+
+Visualização em árvore de instâncias similar ao Explorer do Roblox Studio, dentro do VSCode. Navegue por instâncias sincronizadas, abra scripts diretamente e acompanhe o status de sincronização sem sair do editor.
+Esta é uma extensao complementar do Weppy Roblox MCP, e não uma integração Roblox independente.
+
+![Weepy Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+
+## Requisitos
+
+- VSCode 1.85+
+- [Roblox MCP](../../../README.md) instalado com Sync habilitado (Basic ou Pro)
+- `roblox-project-sync/place_*/.sync-meta.json` já gerado pelo Sync
+
+## Instalação
+
+Pesquise **Weepy Roblox Explorer** na barra lateral de Extensões do VSCode (`Ctrl+Shift+X` / `Cmd+Shift+X`) e clique em **Install**.
+
+Ou instale diretamente pelo [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer).
+
+A navegação basica da arvore funciona a partir dos arquivos sincronizados em disco. Status sync ao vivo, indicadores de direction e envio de telemetria do Explorer ficam disponiveis quando o servidor MCP local está acessivel.
+
+## Funcionalidades
+
+- **Árvore de instâncias**: Hierarquia de serviços/instâncias idêntica ao Roblox Studio
+- **Ícones de classes Roblox**: Mais de 200 ícones com suporte a temas escuro/claro
+- **Multi-Place**: Raízes de árvore separadas por Place sincronizado
+- **Abrir ao clicar**: Abre arquivos de suporte (`.server.luau`, `.client.luau`, `.module.luau`, `.props.json`)
+- **Pesquisa de instâncias**: Pesquisa QuickPick em todos os serviços
+- **Badges de status Sync**: Visualize os estados `modified`, `studio`, `conflict` de relance
+- **Atualização automática**: A árvore é atualizada automaticamente quando os arquivos Sync mudam (debounce 500ms)
+- **Copiar caminho de instância**: Clique com o botão direito para copiar caminhos no formato `game.Workspace.Part`
+
+## Configurações
+
+| Configuração | Padrão | Descrição |
+|--------------|--------|-----------|
+| `robloxExplorer.syncRoot` | `""` | Caminho absoluto para a raiz do `roblox-project-sync`. Detectado automaticamente se vazio. |
+| `robloxExplorer.hidePropsFiles` | `false` | Oculta arquivos de Sync (`.props.json`, `_tree.json`, `.value.json`) no explorador padrão do VSCode. |
+| `robloxExplorer.autoRefresh` | `true` | Atualiza automaticamente a árvore quando os arquivos Sync mudam. |
+| `robloxExplorer.showSyncStatus` | `true` | Exibe decorações de status Sync nos itens da árvore. |
+
+## Comandos
+
+| Comando | Descrição |
+|---------|-----------|
+| `Weepy Roblox Explorer: Refresh` | Atualizar manualmente a árvore de instâncias |
+| `Weepy Roblox Explorer: Search Instances` | Pesquisar instâncias em todos os serviços |
+| `Weepy Roblox Explorer: Open Backing File` | Abrir o arquivo de suporte de uma instância selecionada |
+| `Weepy Roblox Explorer: Copy Instance Path` | Copiar o caminho completo da instância (ex. `game.Workspace.Part`) |
+| `Weepy Roblox Explorer: Reveal in Explorer` | Mostrar o arquivo no explorador padrão do VSCode |
+
+## Relacionado
+
+- [Guia detalhado de Sync](../sync/overview.md)
+- [Guia de instalação](README.md)

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

@@ -23,6 +23,7 @@ O caminho local padrao e `roblox-project-sync/place_{placeId}/explorer`.
 ### Explorar dados sincronizados no VSCode
 
 Instale a extensao [Weepy Roblox Explorer](../installation/roblox-explorer.md) para explorar a arvore de instancias sincronizada no VSCode, assim como no Roblox Studio.
+O Explorer le os arquivos de sync gerados aqui e tambem pode mostrar status sync ao vivo e informacoes de direction quando o servidor MCP local estiver em execucao.
 
 ![Weepy Roblox Explorer — explorar a arvore de instancias sincronizada no VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 

package/llms-full.txt

@@ -201,10 +201,7 @@ In the agent pane, click ⋯ → MCP Servers → Manage MCP Servers → View raw
 
 Browse synced instance trees inside VSCode with Roblox class icons.
 
-1. Download the latest `weppy-roblox-explorer-v*.zip` from [Releases](https://github.com/hope1026/weppy-roblox-mcp/releases)
-2. Extract the ZIP package to get `weppy-roblox-explorer-*.vsix`
-3. Open VSCode → Extensions sidebar → ⋯ → Install from VSIX...
-4. Select the extracted `.vsix` file
+Search for **Weepy Roblox Explorer** in the VSCode Extensions sidebar and click Install, or install from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer).
 
 Features:
 - Instance tree with Roblox class icons (dark/light theme)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weppy/roblox-mcp",
-  "version": "2.0.5",
+  "version": "2.0.6",
   "description": "MCP (Model Context Protocol) server for Roblox Studio integration - enables AI coding agents to interact with Roblox Studio in real-time",
   "main": "plugins/weppy-roblox-mcp/dist/index.js",
   "type": "module",

package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "weppy-roblox-mcp",
   "description": "MCP server for Roblox Studio integration - AI-powered game development with specialized agents and skills",
-  "version": "2.0.5",
+  "version": "2.0.6",
   "author": {
     "name": "hope1026"
   },