@weppy/roblox-mcp 2.0.5 → 2.0.7

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.7"
   },
   "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.7",
       "author": {
         "name": "hope1026"
       },

package/CHANGELOG.md

@@ -19,6 +19,21 @@ All notable changes to this project will be documented in this file.
 
 
 
+## [2.0.7] - 2026-03-25
+
+### What's New
+
+- Published Weppy Roblox Explorer to VS Code Marketplace and Open VSX Registry. Install directly from your editor's extension marketplace.
+- Updated installation guide to reflect new marketplace links for Roblox Explorer.
+
+
+## [2.0.6] - 2026-03-25
+
+### Improved
+
+- Enhanced overall stability and reliability
+
+
 ## [2.0.5] - 2026-03-24
 
 ### Bug Fixes

package/README.md

@@ -114,6 +114,8 @@ 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.
+Install from [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer) or [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer).
 
 ![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,9 +72,14 @@ 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)
 
+Direct listings:
+- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
+- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
+
 ---
 
 ## After Installation

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

@@ -1,32 +1,26 @@
-# Weepy Roblox Explorer (VSCode Extension)
+# Weppy 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)
+![Weppy 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 **Weppy 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 ZIP package contains the `weppy-roblox-explorer-*.vsix` file you will install in VSCode.
+- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
+- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
 
-### 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
 
@@ -52,15 +46,11 @@ Go to the [Releases](https://github.com/hope1026/weppy-roblox-mcp/releases) page
 
 | Command | Description |
 |---------|-------------|
-| `Weepy Roblox Explorer: Refresh` | Manually refresh the instance tree |
-| `Weepy Roblox Explorer: Search Instances` | Search instances across all services |
-| `Weepy Roblox Explorer: Open Backing File` | Open the file backing a selected instance |
-| `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.
+| `Weppy Roblox Explorer: Refresh` | Manually refresh the instance tree |
+| `Weppy Roblox Explorer: Search Instances` | Search instances across all services |
+| `Weppy Roblox Explorer: Open Backing File` | Open the file backing a selected instance |
+| `Weppy Roblox Explorer: Copy Instance Path` | Copy the full instance path (e.g. `game.Workspace.Part`) |
+| `Weppy Roblox Explorer: Reveal in Explorer` | Show the backing file in the default VSCode explorer |
 
 ## Related
 

package/docs/en/sync/overview.md

@@ -22,9 +22,10 @@ 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.
+Install the [Weppy 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)
+![Weppy Roblox Explorer — browse synced instance tree in VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 
 - Service/instance tree with Roblox class icons
 - Click a script to open it for editing

package/docs/es/README.md

@@ -105,6 +105,8 @@ 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.
+Instálalo desde [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer) o [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer).
 
 ![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,9 +67,14 @@ 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)
 
+Instalación directa:
+- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
+- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
+
 ---
 
 ## Después de la Instalación

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

@@ -0,0 +1,58 @@
+# Weppy 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.
+
+![Weppy 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 **Weppy 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 estos marketplaces:
+
+- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
+- [Open VSX](https://open-vsx.org/extension/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 |
+|---------|-------------|
+| `Weppy Roblox Explorer: Refresh` | Actualizar manualmente el árbol de instancias |
+| `Weppy Roblox Explorer: Search Instances` | Buscar instancias en todos los servicios |
+| `Weppy Roblox Explorer: Open Backing File` | Abrir el archivo de respaldo de una instancia seleccionada |
+| `Weppy Roblox Explorer: Copy Instance Path` | Copiar la ruta completa de la instancia (ej. `game.Workspace.Part`) |
+| `Weppy 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

@@ -22,9 +22,10 @@ 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.
+Instala la extension [Weppy 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)
+![Weppy Roblox Explorer — explorar el arbol de instancias sincronizado en VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 
 - Arbol de servicios/instancias con iconos de clases Roblox
 - Haz clic en un script para abrirlo y editarlo

package/docs/id/README.md

@@ -105,6 +105,8 @@ 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.
+Instal dari [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer) atau [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer).
 
 ![Roblox Explorer — pohon instance Studio ditampilkan di sidebar VSCode](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 

package/docs/id/installation/README.md

@@ -72,9 +72,14 @@ 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)
 
+Instal langsung:
+- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
+- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
+
 ---
 
 ## Setelah Instalasi Selesai

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

@@ -0,0 +1,58 @@
+# Weppy 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.
+
+![Weppy 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 **Weppy Roblox Explorer** di sidebar Ekstensi VSCode (`Ctrl+Shift+X` / `Cmd+Shift+X`) dan klik **Install**.
+
+Atau instal langsung dari marketplace berikut:
+
+- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
+- [Open VSX](https://open-vsx.org/extension/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 |
+|----------|-----------|
+| `Weppy Roblox Explorer: Refresh` | Perbarui pohon instansi secara manual |
+| `Weppy Roblox Explorer: Search Instances` | Cari instansi di semua layanan |
+| `Weppy Roblox Explorer: Open Backing File` | Buka file pendukung instansi yang dipilih |
+| `Weppy Roblox Explorer: Copy Instance Path` | Salin jalur instansi lengkap (contoh: `game.Workspace.Part`) |
+| `Weppy 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

@@ -22,9 +22,10 @@ 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.
+Instal ekstensi [Weppy 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)
+![Weppy Roblox Explorer — jelajahi tree instance yang tersinkron di VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 
 - Tree service/instance dengan ikon kelas Roblox
 - Klik script untuk membukanya dan mengedit

package/docs/ja/README.md

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

package/docs/ja/installation/README.md

@@ -72,9 +72,14 @@ GitHubからプラグインファイルをダウンロードして、Roblox Stud
 ## オプション: Roblox Explorer (VSCode拡張) のインストール
 
 同期されたインスタンスツリーをRobloxクラスアイコン付きでVSCode内で閲覧できます。
+この拡張を使うには、先に上記のRoblox MCPセットアップを完了している必要があります。ExplorerはSyncが生成した`roblox-project-sync`データを読み取るためです。
 
 👉 [Roblox Explorerインストールガイド](roblox-explorer.md)
 
+直接インストール:
+- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
+- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
+
 ---
 
 ## インストール後

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

@@ -0,0 +1,58 @@
+# Weppy Roblox Explorer (VSCode拡張)
+
+Roblox StudioのExplorerと同じインスタンスツリーをVSCodeで表示できる拡張機能です。同期済みインスタンスの探索、スクリプトの直接開封、Sync状態の確認をエディタ内で行えます。
+この拡張はWeppy Roblox MCP用のcompanion拡張であり、単体のRoblox連携ツールではありません。
+
+![Weppy 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`）で **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)
+
+基本のツリー閲覧はディスク上の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状態のデコレーションを表示する。 |
+
+## コマンド
+
+| コマンド | 説明 |
+|---------|------|
+| `Weppy Roblox Explorer: Refresh` | インスタンスツリーを手動で更新 |
+| `Weppy Roblox Explorer: Search Instances` | 全サービスでインスタンスを検索 |
+| `Weppy Roblox Explorer: Open Backing File` | 選択したインスタンスのファイルを開く |
+| `Weppy Roblox Explorer: Copy Instance Path` | 完全なインスタンスパスをコピー（例: `game.Workspace.Part`） |
+| `Weppy Roblox Explorer: Reveal in Explorer` | デフォルトのVSCodeエクスプローラーでファイルを表示 |
+
+## 関連ドキュメント
+
+- [Sync詳細ガイド](../sync/overview.md)
+- [インストールガイド](README.md)

package/docs/ja/sync/overview.md

@@ -22,9 +22,10 @@ Syncがない場合、AIはチャットに貼られた断片だけを見て判
 
 ### VSCodeで同期データを閲覧する
 
-[Weepy Roblox Explorer](../installation/roblox-explorer.md) 拡張機能をインストールすると、Roblox Studioと同じようにVSCode上で同期済みインスタンスツリーを閲覧できます。
+[Weppy 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)
+![Weppy Roblox Explorer — VSCodeで同期済みインスタンスツリーを閲覧](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 
 - Robloxクラスアイコン付きのサービス/インスタンスツリー
 - スクリプトをクリックして編集用に開く

package/docs/ko/README.md

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

package/docs/ko/installation/README.md

@@ -72,9 +72,14 @@ GitHub에서 플러그인 파일을 다운로드한 뒤, Roblox Studio의 Plugin
 ## 선택 사항: Roblox Explorer (VSCode 확장) 설치
 
 동기화된 인스턴스 트리를 Roblox 클래스 아이콘과 함께 VSCode에서 탐색할 수 있습니다.
+이 확장은 위의 Roblox MCP 설치를 먼저 완료해야 사용할 수 있습니다. Explorer가 Sync가 생성한 `roblox-project-sync` 데이터를 읽기 때문입니다.
 
 👉 [Roblox Explorer 설치 가이드](roblox-explorer.md)
 
+바로 설치:
+- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
+- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
+
 ---
 
 ## 설치 완료 후

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

@@ -1,32 +1,26 @@
-# Weepy Roblox Explorer (VSCode 확장)
+# Weppy Roblox Explorer (VSCode 확장)
 
 Roblox Studio의 Explorer와 동일한 인스턴스 트리를 VSCode에서 볼 수 있는 확장입니다. 동기화된 인스턴스를 탐색하고, 스크립트를 바로 열고, Sync 상태를 에디터 안에서 확인할 수 있습니다.
+이 확장은 Weppy Roblox MCP용 companion 확장이며, 단독 Roblox 연동 도구는 아닙니다.
 
-![Weepy Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+![Weppy 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`)에서 **Weppy Roblox Explorer**를 검색하고 **Install**을 클릭합니다.
 
-[Releases](https://github.com/hope1026/weppy-roblox-mcp/releases) 페이지에서 최신 `weppy-roblox-explorer-v*.zip` 파일을 다운로드합니다.
+또는 아래 마켓플레이스에서 바로 설치할 수 있습니다.
 
-> ZIP 패키지 안에 VSCode에 설치할 `weppy-roblox-explorer-*.vsix` 파일이 들어 있습니다.
+- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
+- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
 
-### 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 텔레메트리 전달 기능을 함께 사용할 수 있습니다.
 
 ## 기능
 
@@ -52,15 +46,11 @@ Roblox Studio의 Explorer와 동일한 인스턴스 트리를 VSCode에서 볼
 
 | 명령어 | 설명 |
 |--------|------|
-| `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 탐색기에서 파일 표시 |
-
-## 업데이트
-
-[Releases](https://github.com/hope1026/weppy-roblox-mcp/releases)에서 최신 `weppy-roblox-explorer-v*.zip`를 다운로드하고 `.vsix`를 압축 해제한 뒤 동일한 설치 과정을 반복하면 됩니다. 기존 버전이 자동으로 교체됩니다.
+| `Weppy Roblox Explorer: Refresh` | 인스턴스 트리 수동 새로고침 |
+| `Weppy Roblox Explorer: Search Instances` | 모든 서비스에서 인스턴스 검색 |
+| `Weppy Roblox Explorer: Open Backing File` | 선택한 인스턴스의 파일 열기 |
+| `Weppy Roblox Explorer: Copy Instance Path` | 전체 인스턴스 경로 복사 (예: `game.Workspace.Part`) |
+| `Weppy Roblox Explorer: Reveal in Explorer` | 기본 VSCode 탐색기에서 파일 표시 |
 
 ## 관련 문서
 

package/docs/ko/sync/overview.md

@@ -22,9 +22,10 @@ Sync가 없으면 AI는 대화에 붙여 넣은 코드 일부만 보고 판단
 
 ### VSCode에서 Sync 데이터 탐색
 
-[Weepy Roblox Explorer](../installation/roblox-explorer.md) 확장을 설치하면, 동기화된 인스턴스 트리를 Roblox Studio와 동일한 형태로 VSCode에서 탐색할 수 있습니다.
+[Weppy 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)
+![Weppy Roblox Explorer — 동기화된 인스턴스 트리를 VSCode에서 탐색하는 모습](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 
 - 서비스/인스턴스 트리를 Roblox 클래스 아이콘과 함께 표시
 - 스크립트 파일을 클릭하면 바로 편집 가능

package/docs/pt-br/README.md

@@ -105,6 +105,8 @@ 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.
+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).
 
 ![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,9 +72,14 @@ 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)
 
+Instalação direta:
+- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
+- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
+
 ---
 
 ## Depois da instalação