@weppy/roblox-mcp 1.3.0 → 1.4.0

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

@@ -0,0 +1,68 @@
+# 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.
+
+![Weepy Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+
+## Requirements
+
+- VSCode 1.85+
+- [Roblox MCP](../../../README.md) Sync enabled (Basic or Pro)
+
+## Installation
+
+### 1. Download VSIX
+
+Go to the [Releases](https://github.com/hope1026/roblox-mcp/releases) page and download the latest `weppy-roblox-explorer-*.vsix` file.
+
+> The VSIX file is attached as a release asset alongside the plugin ZIP.
+
+### 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. Select the downloaded `.vsix` file
+5. Reload VSCode when prompted
+
+## Features
+
+- **Instance tree**: Service/instance hierarchy matching Roblox Studio
+- **Roblox class icons**: Dark/light theme support with 200+ class icons
+- **Multi-place**: Separate tree roots per synced place
+- **Click-to-open**: Open backing files (`.server.luau`, `.client.luau`, `.module.luau`, `.props.json`)
+- **Instance search**: QuickPick search across all services
+- **Sync status badges**: See `modified`, `studio`, `conflict` states at a glance
+- **Auto-refresh**: Tree updates automatically when sync files change (500ms debounce)
+- **Copy instance path**: Right-click to copy `game.Workspace.Part` style paths
+
+## Settings
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| `robloxExplorer.syncRoot` | `""` | Absolute path to `roblox-project-sync` root. Auto-discovered if empty. |
+| `robloxExplorer.hidePropsFiles` | `false` | Hide sync artifact files (`.props.json`, `_tree.json`, `.value.json`) in the default VSCode explorer. |
+| `robloxExplorer.autoRefresh` | `true` | Auto-refresh tree when sync files change. |
+| `robloxExplorer.showSyncStatus` | `true` | Show sync status decorations on tree items. |
+
+## Commands
+
+| 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 `.vsix` from [Releases](https://github.com/hope1026/roblox-mcp/releases) and repeat the installation steps. VSCode will replace the existing version.
+
+## Related
+
+- [Sync Deep Dive](../sync/overview.md)
+- [Installation Guide](README.md)

package/docs/en/sync/overview.md

@@ -20,6 +20,16 @@ Without Sync, AI only sees snippets pasted into chat. With Sync enabled, AI work
 
 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.
+
+![Weepy 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
+- Sync status badges show modified/conflict state
+
 ## Basic vs Pro
 
 | Item | Basic | Pro |

package/docs/es/README.md

@@ -1,16 +1,44 @@
 # Roblox MCP
 
-[English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | **Español** | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
+> Servidor MCP y plugin para Roblox Studio — controla scripts, terrain, assets e iluminacion con Claude Code, Cursor, Codex y Gemini.
 
-> Habla con la IA y se ejecuta directamente en Roblox Studio.
+[English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | **Español** | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
 
 [![Demo](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
 
+## Instalacion rapida (5 minutos)
+
+**Paso 1** — Instala el plugin de Roblox Studio (puente entre Studio e IA):
+[Guia de instalacion del plugin](../en/installation/roblox-plugin.md)
+
+**Paso 2** — Registra el servidor MCP en tu app de IA:
+
+```bash
+npx -y @weppy/roblox-mcp
+```
+
+| App de IA | Guia |
+|-----------|------|
+| Claude Code | [Configuracion](../en/installation/ai-apps/claude-code.md) |
+| Claude Desktop | [Configuracion](../en/installation/ai-apps/claude-app.md) |
+| Codex CLI | [Configuracion](../en/installation/ai-apps/codex-cli.md) |
+| Codex Desktop | [Configuracion](../en/installation/ai-apps/codex-app.md) |
+| Gemini CLI | [Configuracion](../en/installation/ai-apps/gemini-cli.md) |
+
+> Funciona con cualquier cliente MCP compatible. El comando del servidor es `npx -y @weppy/roblox-mcp`.
+
+## Compatibilidad
+
+| Claude Code | Claude Desktop | Cursor | Codex CLI | Gemini CLI |
+|:-----------:|:--------------:|:------:|:---------:|:----------:|
+| ✅ | ✅ | ✅ | ✅ | ✅ |
+
+**Requisitos:** Node.js 18+, Roblox Studio, Windows 10+ o macOS 12+
+
 ## Funciones principales
 
 ### 1) MCP Tool: ejecuta en Studio desde lenguaje natural
 
-El primer eje de Roblox MCP es la **ejecucion de MCP Tool**.
 La IA puede manejar directamente scripts, instancias, propiedades, terreno, iluminacion, assets, audio y animacion dentro de Studio.
 
 - "Agrega particulas + sonido + cooldown cuando el jugador salte."
@@ -21,7 +49,6 @@ No es solo generacion de codigo. Son **acciones ejecutables orientadas a producc
 
 ### 2) Sync: mantiene el contexto completo del proyecto
 
-El segundo eje es **Project Sync**.
 La IA trabaja sobre un espejo local sincronizado, asi que los cambios en multiples archivos se mantienen consistentes.
 
 ![Flujo de Sync — Studio y archivos locales sincronizados en tiempo real](../assets/screenshots/sync.png)
@@ -29,7 +56,15 @@ La IA trabaja sobre un espejo local sincronizado, asi que los cambios en multipl
 - Basic: sincronizacion unidireccional (Studio -> Local)
 - Pro: sincronizacion bidireccional + Direction/Apply Mode por tipo + historial + multiplace
 
-Asi mantienes claro cual es la fuente de verdad y no pierdes contexto de cambios.
+### 3) 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 — arbol de instancias de Studio mostrado en la barra lateral de VSCode](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+
+- Iconos de clase iguales a Studio para reconocimiento inmediato
+- Clic para abrir scripts y archivos de propiedades sincronizados
+- Soporte multiplace con indicadores de estado de sincronizacion
 
 ## Valor inmediato para el usuario
 
@@ -40,25 +75,19 @@ Asi mantienes claro cual es la fuente de verdad y no pierdes contexto de cambios
 
 ## Documentacion detallada
 
-- [Cobertura de herramientas (Tools Overview)](tools/overview.md)
-- [Guia detallada de Sync](sync/overview.md)
-
-## Comenzar
-
-La instalacion se completa en dos pasos:
-
-1. **Instalar el plugin de Roblox Studio** — Hace de puente entre Studio e IA
-2. **Registrar el servidor MCP en tu app de IA** — Para que la app de IA lo reconozca
-
-Solo toma 5 minutos. 👉 [Ver guia de instalacion](installation/README.md)
+- [Guia de instalacion](../en/installation/README.md)
+- [Cobertura de herramientas](../en/tools/overview.md)
+- [Guia detallada de Sync](../en/sync/overview.md)
+- [Roblox Explorer (Extension VSCode)](../en/installation/roblox-explorer.md)
+- [Compatibilidad](../compatibility.md)
+- [Solucion de problemas](../troubleshooting.md)
 
 ## Upgrade Pro
 
 Sync bidireccional, capacidades de creacion avanzadas y eficiencia de tokens de IA — todo en una sola actualizacion.
 
-👉 [Guia de actualizacion Pro](pro-upgrade.md)
+[Guia de actualizacion Pro](../en/pro-upgrade.md)
 
-## Enlaces
+---
 
-- [GitHub](https://github.com/hope1026/roblox-mcp)
-- [Reportar problemas](https://github.com/hope1026/roblox-mcp/issues)
+[GitHub Issues](https://github.com/hope1026/roblox-mcp/issues) · [Discussions](https://github.com/hope1026/roblox-mcp/discussions) · [npm](https://www.npmjs.com/package/@weppy/roblox-mcp)

package/docs/es/installation/README.md

@@ -34,6 +34,14 @@ Configura el servidor MCP en tu app de IA para que pueda comunicarse con Roblox
 > npx -y @weppy/roblox-mcp
 > ```
 
+## Opcional: Instalar Roblox Explorer (Extensión VSCode)
+
+Explora los árboles de instancias sincronizados dentro de VSCode con iconos de clases Roblox.
+
+👉 [Guía de instalación de Roblox Explorer](roblox-explorer.md)
+
+---
+
 ## Después de la Instalación
 
 Prueba con un comando simple:

package/docs/es/sync/overview.md

@@ -20,6 +20,16 @@ Sin Sync, la IA solo ve fragmentos pegados en el chat. Con Sync activo, trabaja
 
 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.
+
+![Weepy 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
+- Badges de estado de sync muestran el estado modificado/conflicto
+
 ## Basic vs Pro
 
 | Item | Basic | Pro |

package/docs/id/README.md

@@ -1,16 +1,44 @@
 # Roblox MCP
 
-[English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | [Español](../es/README.md) | [Português](../pt-br/README.md) | **Bahasa Indonesia**
+> Server MCP dan plugin untuk Roblox Studio — kendalikan script, terrain, asset, dan lighting dengan Claude Code, Cursor, Codex, dan Gemini.
 
-> Bicara ke AI, langsung dijalankan di Roblox Studio.
+[English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | [Español](../es/README.md) | [Português](../pt-br/README.md) | **Bahasa Indonesia**
 
 [![Demo](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
 
+## Instalasi Cepat (5 menit)
+
+**Langkah 1** — Install plugin Roblox Studio (jembatan antara Studio dan AI):
+[Panduan instalasi plugin](../en/installation/roblox-plugin.md)
+
+**Langkah 2** — Daftarkan MCP server di aplikasi AI:
+
+```bash
+npx -y @weppy/roblox-mcp
+```
+
+| Aplikasi AI | Panduan |
+|-------------|---------|
+| Claude Code | [Setup](../en/installation/ai-apps/claude-code.md) |
+| Claude Desktop | [Setup](../en/installation/ai-apps/claude-app.md) |
+| Codex CLI | [Setup](../en/installation/ai-apps/codex-cli.md) |
+| Codex Desktop | [Setup](../en/installation/ai-apps/codex-app.md) |
+| Gemini CLI | [Setup](../en/installation/ai-apps/gemini-cli.md) |
+
+> Bekerja dengan semua klien MCP yang kompatibel. Perintah server: `npx -y @weppy/roblox-mcp`
+
+## Kompatibilitas
+
+| Claude Code | Claude Desktop | Cursor | Codex CLI | Gemini CLI |
+|:-----------:|:--------------:|:------:|:---------:|:----------:|
+| ✅ | ✅ | ✅ | ✅ | ✅ |
+
+**Persyaratan:** Node.js 18+, Roblox Studio, Windows 10+ atau macOS 12+
+
 ## Fitur utama
 
 ### 1) MCP Tool: eksekusi langsung di Studio dari bahasa alami
 
-Pilar pertama Roblox MCP adalah **eksekusi MCP Tool**.
 AI bisa langsung menangani script, instance, properti, terrain, lighting, asset, audio, dan animasi di dalam Studio.
 
 - "Tambahkan partikel + suara + cooldown saat player melompat."
@@ -21,7 +49,6 @@ Ini bukan sekadar generate kode. Ini adalah **aksi yang benar-benar bisa dieksek
 
 ### 2) Sync: menjaga konteks penuh proyek untuk AI
 
-Pilar kedua adalah **Project Sync**.
 AI bekerja dari mirror lokal yang tersinkron, jadi perubahan lintas banyak file tetap konsisten.
 
 ![Alur Sync — Studio dan file lokal tersinkron secara real time](../assets/screenshots/sync.png)
@@ -29,7 +56,15 @@ AI bekerja dari mirror lokal yang tersinkron, jadi perubahan lintas banyak file
 - Basic: sinkronisasi satu arah (Studio -> Local)
 - Pro: sinkronisasi dua arah + Direction/Apply Mode per tipe + riwayat + multiplace
 
-Dengan begitu sumber kebenaran tetap jelas dan konteks perubahan tidak hilang.
+### 3) 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 — pohon instance Studio ditampilkan di sidebar VSCode](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+
+- Ikon class yang sama dengan Studio untuk pengenalan instan
+- Klik untuk membuka script dan file properti yang tersinkron
+- Dukungan multiplace dengan indikator status sinkronisasi
 
 ## Nilai yang langsung terasa
 
@@ -40,25 +75,19 @@ Dengan begitu sumber kebenaran tetap jelas dan konteks perubahan tidak hilang.
 
 ## Dokumen detail
 
-- [Cakupan tool (Tools Overview)](tools/overview.md)
-- [Panduan detail Sync](sync/overview.md)
-
-## Mulai
-
-Instalasi cuma dua langkah:
-
-1. **Install plugin Roblox Studio** — Jembatan antara Studio dan AI
-2. **Daftarkan MCP server di aplikasi AI** — Biar AI-mu mengenali Roblox MCP
-
-5 menit kelar. 👉 [Lihat panduan instalasi](installation/README.md)
+- [Panduan instalasi](../en/installation/README.md)
+- [Cakupan tool](../en/tools/overview.md)
+- [Panduan detail Sync](../en/sync/overview.md)
+- [Roblox Explorer (Ekstensi VSCode)](../en/installation/roblox-explorer.md)
+- [Kompatibilitas](../compatibility.md)
+- [Panduan pemecahan masalah](../troubleshooting.md)
 
 ## Upgrade Pro
 
 Sync dua arah, kemampuan kreasi lanjutan, dan efisiensi token AI — semua dalam satu upgrade.
 
-👉 [Panduan Upgrade Pro](pro-upgrade.md)
+[Panduan Upgrade Pro](../en/pro-upgrade.md)
 
-## Link
+---
 
-- [GitHub](https://github.com/hope1026/roblox-mcp)
-- [Laporkan Masalah](https://github.com/hope1026/roblox-mcp/issues)
+[GitHub Issues](https://github.com/hope1026/roblox-mcp/issues) · [Discussions](https://github.com/hope1026/roblox-mcp/discussions) · [npm](https://www.npmjs.com/package/@weppy/roblox-mcp)

package/docs/id/installation/README.md

@@ -39,6 +39,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.
+
+👉 [Panduan Instalasi Roblox Explorer](roblox-explorer.md)
+
+---
+
 ## Setelah Instalasi Selesai
 
 1. Buka **Roblox Studio**, di tab Plugins klik **W-MCP** → **Connect**

package/docs/id/sync/overview.md

@@ -20,6 +20,16 @@ Tanpa Sync, AI hanya melihat potongan kode yang ditempel di chat. Dengan Sync ak
 
 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.
+
+![Weepy 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
+- Badge status sync menampilkan status modified/conflict
+
 ## Basic vs Pro
 
 | Item | Basic | Pro |

package/docs/ja/README.md

@@ -1,16 +1,44 @@
 # Roblox MCP
 
-[English](../../README.md) | [한국어](../ko/README.md) | **日本語** | [Español](../es/README.md) | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
+> Roblox Studio用MCPサーバー＆プラグイン — Claude Code、Cursor、Codex、GeminiでスクリプトやTerrain、アセット、ライティングをAI制御。
 
-> AIに話しかけるだけで、Roblox Studioで実行されます。
+[English](../../README.md) | [한국어](../ko/README.md) | **日本語** | [Español](../es/README.md) | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
 
 [![デモ](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
 
+## クイックインストール（5分）
+
+**Step 1** — Roblox Studioプラグインのインストール（StudioとAIを接続する橋渡し）:
+[プラグインインストールガイド](../en/installation/roblox-plugin.md)
+
+**Step 2** — AIアプリにMCPサーバーを登録:
+
+```bash
+npx -y @weppy/roblox-mcp
+```
+
+| AIアプリ | ガイド |
+|---------|--------|
+| Claude Code | [セットアップ](../en/installation/ai-apps/claude-code.md) |
+| Claude Desktop | [セットアップ](../en/installation/ai-apps/claude-app.md) |
+| Codex CLI | [セットアップ](../en/installation/ai-apps/codex-cli.md) |
+| Codex Desktop | [セットアップ](../en/installation/ai-apps/codex-app.md) |
+| Gemini CLI | [セットアップ](../en/installation/ai-apps/gemini-cli.md) |
+
+> MCP対応のAIアプリであれば利用できます。サーバーコマンド: `npx -y @weppy/roblox-mcp`
+
+## 互換性
+
+| Claude Code | Claude Desktop | Cursor | Codex CLI | Gemini CLI |
+|:-----------:|:--------------:|:------:|:---------:|:----------:|
+| ✅ | ✅ | ✅ | ✅ | ✅ |
+
+**要件:** Node.js 18+、Roblox Studio、Windows 10+ または macOS 12+
+
 ## 主要機能
 
 ### 1) MCP Tool: 自然言語の指示をStudioで直接実行
 
-Roblox MCPの第一の柱は**MCP Tool実行**です。
 AIがStudio内で、スクリプト、インスタンス、プロパティ、地形、ライティング、アセット、オーディオ、アニメーションを直接処理します。
 
 - 「プレイヤーのジャンプ時に、パーティクル + サウンド + クールタイムを追加して。」
@@ -21,44 +49,45 @@ AIがStudio内で、スクリプト、インスタンス、プロパティ、地
 
 ### 2) Sync: AIがプロジェクト全体の文脈を維持
 
-第二の柱は**Project Sync**です。
 同期されたローカルミラーを基準にAIが作業するため、複数ファイルにまたがる変更も一貫して適用できます。
 
 ![Syncワークフロー — Studioとローカルファイルがリアルタイムで同期される様子](../assets/screenshots/sync.png)
 
-- Basic: 片方向同期 (Studio -> Local)
+- Basic: 片方向同期（Studio -> Local）
 - Pro: 双方向同期 + タイプ別Direction/Apply Mode + 変更履歴 + マルチPlace
 
-どちらを正とするかを明確に保ち、変更文脈の取りこぼしを防げます。
+### 3) Roblox Explorer: VSCodeでStudioの階層構造を閲覧
+
+Roblox Studioのインスタンスツリー全体をVSCode内で直接確認できます。サービスを探索し、同期されたスクリプトやプロパティファイルを開き、同期状態を追跡 — Studioに切り替える必要はありません。
+
+![Roblox Explorer — VSCodeサイドバーに表示されるStudioインスタンスツリー](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+
+- Studio同様のクラスアイコンで直感的に識別
+- クリックで同期済みスクリプトとプロパティファイルを開く
+- 同期状態表示付きのマルチPlaceサポート
 
 ## すぐに実感できる価値
 
 - 反復作業を圧縮: 多数の手作業を1つの指示に集約
 - 関連ファイルを同時に変更: 単一ファイル修正で終わらない
 - リスク低減: 同期状態と履歴を見ながら安全に変更
-- トークン効率向上 (Pro): バルク処理で往復回数を削減
+- トークン効率向上（Pro）: バルク処理で往復回数を削減
 
 ## 詳細ドキュメント
 
-- [Tool対応範囲 (Tools Overview)](tools/overview.md)
-- [Sync機能詳細ガイド](sync/overview.md)
-
-## はじめに
-
-インストールは2つのステップで完了します:
-
-1. **Roblox Studioプラグインのインストール** — StudioとAIを接続する橋渡し
-2. **AIアプリにMCPサーバーを登録** — 使用するAIアプリでRoblox MCPを認識
-
-5分で終わります。👉 [インストールガイド](installation/README.md)
+- [インストールガイド](../en/installation/README.md)
+- [Tool対応範囲](../en/tools/overview.md)
+- [Sync機能詳細ガイド](../en/sync/overview.md)
+- [Roblox Explorer (VSCode拡張)](../en/installation/roblox-explorer.md)
+- [互換性](../compatibility.md)
+- [トラブルシューティング](../troubleshooting.md)
 
 ## Proアップグレード
 
 双方向Sync、高度な制作機能、AIトークン効率 — 一度のアップグレードで全てを手に入れる。
 
-👉 [Proアップグレードガイド](pro-upgrade.md)
+[Proアップグレードガイド](../en/pro-upgrade.md)
 
-## リンク
+---
 
-- [GitHub](https://github.com/hope1026/roblox-mcp)
-- [Issue報告](https://github.com/hope1026/roblox-mcp/issues)
+[GitHubイシュー](https://github.com/hope1026/roblox-mcp/issues) · [Discussions](https://github.com/hope1026/roblox-mcp/discussions) · [npm](https://www.npmjs.com/package/@weppy/roblox-mcp)

package/docs/ja/installation/README.md

@@ -39,6 +39,14 @@ GitHubからプラグインファイルをダウンロードして、Roblox Stud
 
 ---
 
+## オプション: Roblox Explorer (VSCode拡張) のインストール
+
+同期されたインスタンスツリーをRobloxクラスアイコン付きでVSCode内で閲覧できます。
+
+👉 [Roblox Explorerインストールガイド](roblox-explorer.md)
+
+---
+
 ## インストール後
 
 1. **Roblox Studio**を開き、Pluginsタブから **W-MCP** → **Connect** をクリック

package/docs/ja/sync/overview.md

@@ -20,6 +20,16 @@ Syncがない場合、AIはチャットに貼られた断片だけを見て判
 
 ローカルの既定パスは `roblox-project-sync/place_{placeId}/explorer` です。
 
+### VSCodeで同期データを閲覧する
+
+[Weepy Roblox Explorer](../installation/roblox-explorer.md) 拡張機能をインストールすると、Roblox Studioと同じようにVSCode上で同期済みインスタンスツリーを閲覧できます。
+
+![Weepy Roblox Explorer — VSCodeで同期済みインスタンスツリーを閲覧](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+
+- Robloxクラスアイコン付きのサービス/インスタンスツリー
+- スクリプトをクリックして編集用に開く
+- 同期ステータスバッジで変更/コンフリクト状態を表示
+
 ## Basic vs Pro
 
 | 項目 | Basic | Pro |

package/docs/ko/README.md

@@ -1,16 +1,44 @@
 # Roblox MCP
 
+> Roblox Studio용 MCP 서버 및 플러그인 — Claude Code, Cursor, Codex, Gemini로 스크립트, 지형, 에셋, 조명을 AI로 제어합니다.
+
 [English](../../README.md) | **한국어** | [日本語](../ja/README.md) | [Español](../es/README.md) | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
 
-> AI에게 말하면, Roblox Studio에서 바로 실행됩니다.
+[![데모](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
+
+## 빠른 설치 (5분)
+
+**1단계** — Roblox Studio 플러그인 설치 (Studio와 AI를 연결하는 다리):
+[플러그인 설치 가이드](../en/installation/roblox-plugin.md)
+
+**2단계** — AI 앱에 MCP 서버 등록:
+
+```bash
+npx -y @weppy/roblox-mcp
+```
+
+| AI 앱 | 가이드 |
+|-------|--------|
+| Claude Code | [설정](../en/installation/ai-apps/claude-code.md) |
+| Claude Desktop | [설정](../en/installation/ai-apps/claude-app.md) |
+| Codex CLI | [설정](../en/installation/ai-apps/codex-cli.md) |
+| Codex Desktop | [설정](../en/installation/ai-apps/codex-app.md) |
+| Gemini CLI | [설정](../en/installation/ai-apps/gemini-cli.md) |
+
+> MCP를 지원하는 모든 AI 앱에서 사용 가능합니다. 서버 명령어: `npx -y @weppy/roblox-mcp`
+
+## 호환성
 
-[![Demo](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
+| Claude Code | Claude Desktop | Cursor | Codex CLI | Gemini CLI |
+|:-----------:|:--------------:|:------:|:---------:|:----------:|
+| ✅ | ✅ | ✅ | ✅ | ✅ |
+
+**요구 사항:** Node.js 18+, Roblox Studio, Windows 10+ 또는 macOS 12+
 
 ## 핵심 기능
 
 ### 1) MCP Tool: 말로 지시하면 Studio에서 바로 실행
 
-Roblox MCP의 첫 번째 축은 **MCP Tool 실행 능력**입니다.  
 스크립트, 인스턴스, 속성, 지형, 조명, 에셋, 오디오, 애니메이션까지 AI가 Studio에서 직접 처리합니다.
 
 - "플레이어 점프 시 파티클 + 사운드 + 쿨타임까지 한 번에 넣어줘."
@@ -21,7 +49,6 @@ Roblox MCP의 첫 번째 축은 **MCP Tool 실행 능력**입니다.
 
 ### 2) Sync: AI가 프로젝트 전체 문맥을 읽고 유지
 
-두 번째 축은 **Project Sync**입니다.
 AI가 로컬 동기화된 프로젝트를 기준으로 전체 구조를 이해해, 여러 파일에 걸친 변경을 일관되게 수행합니다.
 
 ![Sync 워크플로우 — Studio와 로컬 파일이 실시간으로 동기화되는 모습](../assets/screenshots/sync.png)
@@ -29,7 +56,15 @@ AI가 로컬 동기화된 프로젝트를 기준으로 전체 구조를 이해
 - Basic: Studio -> Local 단방향 동기화
 - Pro: 양방향 동기화 + 타입별 Direction/Apply Mode + 변경 기록 + 멀티 Place
 
-즉, "지금 어떤 파일이 실제 기준인지", "무엇이 언제 바뀌었는지"를 놓치지 않고 협업할 수 있습니다.
+### 3) Roblox Explorer: VSCode에서 Studio 계층 구조 탐색
+
+Roblox Studio의 전체 인스턴스 트리를 VSCode 안에서 바로 확인할 수 있습니다. 서비스를 탐색하고, 동기화된 스크립트와 속성 파일을 열고, 동기화 상태를 추적하세요 — Studio로 전환할 필요 없이.
+
+![Roblox Explorer — VSCode 사이드바에 표시되는 Studio 인스턴스 트리](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+
+- Studio와 동일한 클래스 아이콘으로 직관적 구분
+- 클릭으로 동기화된 스크립트와 속성 파일 열기
+- 동기화 상태 표시를 포함한 멀티 Place 지원
 
 ## 유저가 바로 체감하는 장점
 
@@ -40,25 +75,19 @@ AI가 로컬 동기화된 프로젝트를 기준으로 전체 구조를 이해
 
 ## 세부 문서
 
-- [Tool 지원 범위 (Tools Overview)](tools/overview.md)
-- [Sync 기능 상세 가이드](sync/overview.md)
-
-## 시작하기
-
-설치는 두 단계로 완료됩니다:
-
-1. **Roblox Studio 플러그인 설치** — Studio와 AI를 연결하는 다리 역할을 합니다
-2. **AI 앱에 MCP 서버 등록** — 사용하는 AI 앱에서 Roblox MCP를 인식하도록 설정합니다
-
-5분이면 끝나요. 👉 [설치 가이드 보기](installation/README.md)
+- [설치 가이드](../en/installation/README.md)
+- [Tool 지원 범위](../en/tools/overview.md)
+- [Sync 기능 상세 가이드](../en/sync/overview.md)
+- [Roblox Explorer (VSCode 확장)](installation/roblox-explorer.md)
+- [호환성](../compatibility.md)
+- [문제 해결 가이드](../troubleshooting.md)
 
 ## Pro로 업그레이드
 
 양방향 Sync, 고급 제작 기능, AI 토큰 효율 — 한 번의 업그레이드로 모두 누리세요.
 
-👉 [Pro 업그레이드 가이드](pro-upgrade.md)
+[Pro 업그레이드 가이드](../en/pro-upgrade.md)
 
-## 링크
+---
 
-- [GitHub](https://github.com/hope1026/roblox-mcp)
-- [이슈 리포트](https://github.com/hope1026/roblox-mcp/issues)
+[GitHub 이슈](https://github.com/hope1026/roblox-mcp/issues) · [Discussions](https://github.com/hope1026/roblox-mcp/discussions) · [npm](https://www.npmjs.com/package/@weppy/roblox-mcp)

package/docs/ko/installation/README.md

@@ -39,6 +39,14 @@ GitHub에서 플러그인 파일을 다운로드한 뒤, Roblox Studio의 Plugin
 
 ---
 
+## 선택 사항: Roblox Explorer (VSCode 확장) 설치
+
+동기화된 인스턴스 트리를 Roblox 클래스 아이콘과 함께 VSCode에서 탐색할 수 있습니다.
+
+👉 [Roblox Explorer 설치 가이드](roblox-explorer.md)
+
+---
+
 ## 설치 완료 후
 
 1. **Roblox Studio**를 열고, Plugins 탭에서 **W-MCP** → **Connect** 클릭