@weppy/roblox-mcp 0.1.11 → 1.0.0

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

@@ -4,23 +4,28 @@ Instrucciones para instalar el plugin que conecta Roblox Studio con agentes de I
 
 ## 1. Descargar el Plugin
 
-1. Descarga `weppy-roblox-mcp-basic-v{versión}.zip` desde [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
-2. Extrae el archivo ZIP — encontraras el archivo `roblox-plugin/WeppyRobloxMCP.rbxm` y guias de instalacion
+1. Abre [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+2. Descarga `weppy-roblox-mcp-v{version}.zip`
+3. Extrae el ZIP - encontraras `roblox-plugin/WeppyRobloxMCP.rbxm` y guias de instalacion
+
+Nota:
+- Basic usa el mismo paquete del plugin con politica Basic (Studio -> Local, una via)
+- Con licencia Pro por suscripcion se habilita sync bidireccional y funciones avanzadas mas amplias
 
 ## 2. Instalar el Plugin
 
 1. Abre **Roblox Studio**
-2. Clic en la pestana **Plugins** en el menu superior
-3. Clic en el boton **Plugins Folder**
+2. Clic en la pestana **Plugins**
+3. Clic en **Plugins Folder**
 
 ![Abrir Plugins Folder](../../assets/screenshots/plugins_menu.png)
 
-4. **Copia** el archivo `WeppyRobloxMCP.rbxm` de la carpeta extraida a la carpeta de Plugins abierta
+4. **Copia** `WeppyRobloxMCP.rbxm` a la carpeta abierta de Plugins
 5. **Reinicia Roblox Studio**
 
 ## 3. Verificar la Instalacion
 
-Despues de reiniciar, aparecera el boton **W-MCP** en la pestana Plugins.
+Despues de reiniciar, aparecera el boton **W-MCP** en Plugins.
 
 ![Boton W-MCP](../../assets/screenshots/weppy_plugin_toolbar.png)
 
@@ -28,7 +33,7 @@ Despues de reiniciar, aparecera el boton **W-MCP** en la pestana Plugins.
 
 ### Requisitos Previos
 
-El servidor MCP debe estar instalado. Completa primero la guia correspondiente a tu aplicacion de IA:
+El servidor MCP debe estar instalado. Completa primero la guia de tu app de IA:
 
 | Aplicacion IA | Guia de instalacion |
 |---------------|---------------------|
@@ -42,38 +47,38 @@ El servidor MCP debe estar instalado. Completa primero la guia correspondiente a
 ### Conectar
 
 1. Abre cualquier proyecto en **Roblox Studio**
-2. Pestana **Plugins** superior → Clic en **W-MCP**
-3. Clic en el boton **Connect** en la ventana del plugin
-4. ¡Conexion completada cuando aparece el estado **"Connected"**!
+2. Pestaña **Plugins** -> **W-MCP**
+3. Clic en **Connect**
+4. Cuando veas **"Connected"**, listo
 
 ![Pantalla principal del plugin](../../assets/screenshots/plugin_main.png)
 
 ## 5. Configuracion (Opcional)
 
-Haz clic en el boton de configuracion en la esquina superior derecha del plugin para cambiar varias opciones.
+Usa el boton de configuracion en la esquina superior derecha.
 
 ![Pantalla de configuracion](../../assets/screenshots/settings.png)
 
-- **Conexion automatica**: Conecta automaticamente al servidor MCP al iniciar Studio
-- **Reconexion automatica**: Intenta reconectar automaticamente si se pierde la conexion
-- **Enfoque automatico de camara**: Mueve la camara automaticamente hacia los objetos creados
-- **Idioma**: Cambia el idioma de la interfaz del plugin
+- **Conexion automatica**
+- **Reconexion automatica**
+- **Enfoque automatico de camara**
+- **Idioma**
 
 ## Solucion de Problemas
 
 ### El plugin no aparece
 
-- Cierra completamente Roblox Studio y reinicia
-- Verifica que el archivo se haya copiado correctamente a la carpeta Plugins
-- Verifica que el archivo `.rbxm` no este danado
+- Reinicia Roblox Studio por completo
+- Verifica que el archivo fue copiado correctamente
+- Verifica que `.rbxm` no este dañado
 
 ### No se puede conectar
 
-- Verifica que el servidor MCP este ejecutandose en la aplicacion de IA
-- Haz clic nuevamente en el boton **Connect** en el plugin
-- Verifica que el puerto 3002 no este siendo usado por otro programa
+- Verifica que el servidor MCP esta en ejecucion
+- Pulsa **Connect** otra vez
+- Verifica conflicto en el puerto 3002
 
-### La conexion se pierde frecuentemente
+### La conexion se corta seguido
 
-- Activa la opcion **Reconexion automatica** en la configuracion
-- Intenta reiniciar la aplicacion de IA
+- Activa **Reconexion automatica**
+- Reinicia tu app de IA

package/docs/es/pro-upgrade.md

@@ -1,51 +1,57 @@
 # Guia de Actualizacion a Pro
 
-## Por que Pro?
+## ¿Por qué Pro?
 
-**Ahorro de tokens de IA** - Un solo comando de operacion masiva reemplaza docenas de operaciones individuales. Menos trabajo repetitivo significa menor uso de tokens y resultados mas rapidos.
+### Sync bidireccional para flujos de desarrollo reales
 
-**Juegos mas completos** - Con herramientas de terreno, entorno, assets y espacio, puedes crear mundos de juego terminados, no solo prototipos.
+Pro Sync va más allá del simple export. Edita scripts localmente y súbelos a Studio. Haz cambios en Studio y tráelos de vuelta al disco. Pro mantiene ambos lados sincronizados.
 
-## Herramientas que agrega Pro
+- **Sync bidireccional** — Los cambios fluyen en ambas direcciones entre Studio y los archivos locales.
+- **Direction por tipo** — Configura la dirección de forma independiente para Scripts, Values, Containers, Data y Services.
+- **Apply Mode por tipo** — Elige Auto o Manual por tipo para equilibrar velocidad y control.
+- **Full Sync / Resync** — Reconstruye el estado limpio del proyecto tras cambios grandes o reconexiones.
+- **Historial de cambios** — Rastrea qué cambió, cuándo y en qué dirección antes de aplicar.
+- **Sync multi-place** — Sincroniza hasta 3 Roblox Places a la vez, cada uno con almacenamiento aislado e historial de cambios propio.
 
-| Categoria | Funciones |
-|-----------|-----------|
-| **Operaciones masivas** | Crea 100 arboles con un solo comando. Modifica todas las partes simultaneamente. |
-| **Generacion de terreno** | Genera montanas, cuevas y paisajes de forma procedural. |
-| **Gestion de assets** | Busca en Creator Store e inserta modelos directamente. |
-| **Raycast** | Encuentra posiciones de spawn, detecta colisiones, analiza areas transitables. |
-| **Control de entorno** | Configura iluminacion, atmosfera, cielo y hora del dia. |
-| **Visualizacion** | Muestra areas, crea marcadores, resalta zonas. |
+### Ahorra tokens de IA con flujos de alto impacto
 
-## Como Comprar
+Las acciones masivas y avanzadas reducen las llamadas repetitivas — haz más por cada prompt.
 
-### Paso 1: Comprar en Gumroad
+### Capacidades avanzadas más amplias
 
-1. Visita [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin)
-2. Descarga el plugin
+Generación de terreno, búsqueda de assets, análisis espacial, animación, audio y automatización a escala de producción.
 
-### Paso 2: Instalar el Plugin
+## Suscripcion y descarga
 
-1. Abre Roblox Studio
-2. Pestana Plugins → Clic en **Plugins Folder**
-3. **Elimina** el `WeppyRobloxMCP.rbxm` existente (version Basic)
-4. **Copia** el `WeppyRobloxMCP-Pro.rbxm` descargado a la carpeta
-5. Reinicia Roblox Studio
+### Paso 1: Suscribirte en Gumroad
+
+1. Ve a [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/faccjs?utm_source=github&utm_medium=repo&utm_campaign=pro_upgrade_md)
+2. Completa la compra de licencia Pro por suscripcion
+
+### Paso 2: Descargar desde GitHub Releases
+
+1. Abre [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+2. Descarga `weppy-roblox-mcp-v{version}.zip`
+3. Extrae y copia `roblox-plugin/WeppyRobloxMCP.rbxm` a tu carpeta de Plugins de Roblox
 
 ### Paso 3: Verificar
 
-1. Abre el plugin W-MCP
-2. Verifica que aparezca la insignia "Pro"
-3. Todas las herramientas estan disponibles!
+1. Abre W-MCP en Roblox Studio
+2. Confirma que aparece la insignia Pro
+3. Ejecuta una accion Pro (por ejemplo: `manage_sync` u operaciones masivas)
 
-## Comparacion de Funciones
+## Comparación de Funciones
 
-| Funcion | Basic | Pro |
+| Función | Basic | Pro |
 |---------|:-----:|:---:|
-| Instance, Script, Property | ✅ Acceso completo | ✅ Acceso completo |
+| Gestión de Script, Instance, Property | ✅ Acceso completo | ✅ Acceso completo |
 | Selection, Tag, Camera, Log | ✅ Acceso completo | ✅ Acceso completo |
-| Operaciones masivas (Bulk) | ― | ✅ Ilimitado |
-| Busqueda e insercion de assets | ― | ✅ Ilimitado |
-| Generacion de terreno (Terrain) | ― | ✅ Ilimitado |
-| Entorno, Raycast, Espacio | ― | ✅ Ilimitado |
-| Herramientas de visualizacion | ― | ✅ Ilimitado |
+| Dirección de Sync | Studio → Local (una vía) | Bidireccional |
+| Sync Direction por tipo | ❌ | ✅ Scripts / Values / Containers / Data / Services |
+| Apply Mode por tipo | ❌ | ✅ Auto / Manual |
+| Full Sync | ❌ | ✅ |
+| Resync / Reconstruir estado | ❌ | ✅ |
+| Historial de cambios | ❌ | ✅ |
+| Sync multi-place | ❌ | ✅ Hasta 3 places con almacenamiento aislado |
+| Cobertura avanzada de tools | Conjunto base | Conjunto avanzado más amplio |
+| Eficiencia de tokens IA | Estándar | Mejor con acciones masivas / de alto impacto |

package/docs/es/tools/overview.md

@@ -2,6 +2,10 @@
 
 Conecta la IA con Roblox Studio para automatizar diversas tareas. A continuacion se presenta lo que puedes hacer por categoria.
 
+Politica de Sync:
+- Basic: Studio -> Local (una via)
+- Pro: Sync bidireccional + funcionalidades avanzadas mas amplias (mejor eficiencia de tokens IA con operaciones masivas)
+
 ---
 
 ## Basic (Gratis)

package/docs/id/README.md

@@ -53,6 +53,12 @@ Instalasi cuma dua langkah:
 
 5 menit kelar. 👉 [Lihat panduan instalasi](installation/README.md)
 
+## Mulai dengan Pro
+
+Bangun tanpa batas. Sync dua arah, kemampuan kreasi lanjutan, dan efisiensi token AI — semua dalam satu upgrade.
+
+👉 [Panduan Upgrade Pro](pro-upgrade.md)
+
 ## Link
 
 - [GitHub](https://github.com/hope1026/roblox-mcp)

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

@@ -4,23 +4,28 @@ Panduan instalasi plugin untuk menghubungkan AI agent di Roblox Studio.
 
 ## 1. Unduh Plugin
 
-1. Unduh `weppy-roblox-mcp-basic-v{versi}.zip` dari [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
-2. Ekstrak file ZIP — Anda akan menemukan file `roblox-plugin/WeppyRobloxMCP.rbxm` dan panduan instalasi
+1. Buka [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+2. Unduh `weppy-roblox-mcp-v{version}.zip`
+3. Ekstrak ZIP - Anda akan menemukan `roblox-plugin/WeppyRobloxMCP.rbxm` dan panduan instalasi
+
+Catatan:
+- Basic menggunakan paket plugin yang sama dengan kebijakan Basic (Studio -> Local satu arah)
+- Setelah lisensi langganan Pro aktif, sync dua arah dan fitur lanjutan yang lebih luas akan terbuka
 
 ## 2. Instal Plugin
 
 1. Jalankan **Roblox Studio**
-2. Klik tab **Plugins** di menu atas
-3. Klik tombol **Plugins Folder**
+2. Klik tab **Plugins**
+3. Klik **Plugins Folder**
 
 ![Buka Plugins Folder](../../assets/screenshots/plugins_menu.png)
 
-4. **Salin** file `WeppyRobloxMCP.rbxm` dari folder yang diekstrak ke folder Plugins yang terbuka
+4. **Salin** `WeppyRobloxMCP.rbxm` ke folder Plugins
 5. **Restart Roblox Studio**
 
 ## 3. Verifikasi Instalasi
 
-Setelah restart, tombol **W-MCP** akan muncul di tab Plugins.
+Setelah restart, tombol **W-MCP** muncul di tab Plugins.
 
 ![Tombol W-MCP](../../assets/screenshots/weppy_plugin_toolbar.png)
 
@@ -28,7 +33,7 @@ Setelah restart, tombol **W-MCP** akan muncul di tab Plugins.
 
 ### Persiapan
 
-MCP server harus sudah terinstal. Selesaikan panduan yang sesuai dengan aplikasi AI yang Anda gunakan terlebih dahulu:
+MCP server harus sudah terinstal. Selesaikan dulu panduan app AI yang Anda pakai:
 
 | Aplikasi AI | Panduan Instalasi |
 |-------------|-------------------|
@@ -42,38 +47,38 @@ MCP server harus sudah terinstal. Selesaikan panduan yang sesuai dengan aplikasi
 ### Menghubungkan
 
 1. Buka proyek apa saja di **Roblox Studio**
-2. Tab **Plugins** di atas → Klik **W-MCP**
-3. Klik tombol **Connect** di jendela plugin
-4. Jika status **"Connected"** ditampilkan, koneksi berhasil!
+2. Tab **Plugins** -> **W-MCP**
+3. Klik **Connect**
+4. Jika status **"Connected"** tampil, koneksi berhasil
 
 ![Layar Utama Plugin](../../assets/screenshots/plugin_main.png)
 
 ## 5. Pengaturan (Opsional)
 
-Klik tombol pengaturan di kanan atas plugin untuk mengubah berbagai opsi.
+Gunakan tombol pengaturan di kanan atas plugin.
 
 ![Layar Pengaturan](../../assets/screenshots/settings.png)
 
-- **Auto Connect**: Otomatis terhubung ke MCP server saat Studio dimulai
-- **Auto Reconnect**: Otomatis mencoba menghubungkan kembali jika koneksi terputus
-- **Auto Camera Focus**: Kamera otomatis bergerak ke objek yang dibuat
-- **Language**: Ubah bahasa UI plugin
+- **Auto Connect**
+- **Auto Reconnect**
+- **Auto Camera Focus**
+- **Language**
 
 ## Pemecahan Masalah
 
 ### Plugin tidak terlihat
 
-- Tutup Roblox Studio sepenuhnya lalu restart
-- Pastikan file sudah disalin dengan benar ke Plugins Folder
-- Pastikan file `.rbxm` tidak rusak
+- Restart Roblox Studio sepenuhnya
+- Pastikan file sudah disalin benar
+- Pastikan `.rbxm` tidak rusak
 
 ### Tidak dapat terhubung
 
-- Pastikan MCP server berjalan di aplikasi AI
-- Klik tombol **Connect** lagi di plugin
-- Pastikan port 3002 tidak digunakan oleh program lain
+- Pastikan MCP server berjalan
+- Klik **Connect** lagi
+- Cek konflik port 3002
 
 ### Koneksi sering terputus
 
-- Aktifkan opsi **Auto Reconnect** di pengaturan
-- Coba restart aplikasi AI
+- Aktifkan **Auto Reconnect**
+- Restart app AI

package/docs/id/pro-upgrade.md

@@ -2,50 +2,56 @@
 
 ## Mengapa Pro?
 
-**Hemat Token AI** - Satu perintah operasi massal menggantikan puluhan operasi individual. Penggunaan token berkurang karena tugas berulang diminimalkan dan hasilnya lebih cepat.
+### Sync dua arah untuk alur kerja pengembangan nyata
 
-**Game yang Lebih Lengkap** - Dengan tools terrain, environment, asset, dan spatial, Anda dapat membuat dunia game yang lengkap, bukan hanya prototipe.
+Pro Sync melampaui sekadar export satu arah. Edit script secara lokal dan kirim ke Studio. Buat perubahan di Studio dan tarik kembali ke disk. Pro menjaga keduanya tetap sinkron.
 
-## Tools yang Ditambahkan Pro
+- **Sync dua arah** — Perubahan mengalir dua arah antara Studio dan file lokal.
+- **Direction per tipe** — Atur arah secara independen untuk Scripts, Values, Containers, Data, dan Services.
+- **Apply Mode per tipe** — Pilih Auto atau Manual per tipe untuk menyeimbangkan kecepatan dan kontrol.
+- **Full Sync / Resync** — Bangun ulang state proyek yang bersih setelah perubahan besar atau reconnect.
+- **Riwayat Perubahan** — Lacak apa yang berubah, kapan, dan ke arah mana sebelum menerapkan.
+- **Sync multi-place** — Sync hingga 3 Roblox Place sekaligus, masing-masing dengan penyimpanan terisolasi dan riwayat perubahan sendiri.
 
-| Kategori | Fungsi |
-|----------|--------|
-| **Operasi Massal** | Buat 100 pohon dengan satu perintah. Ubah semua part secara bersamaan. |
-| **Pembuatan Terrain** | Hasilkan gunung, gua, dan lanskap secara prosedural. |
-| **Manajemen Asset** | Cari di Creator Store lalu sisipkan model langsung. |
-| **Raycast** | Temukan posisi spawn, deteksi tabrakan, analisis area yang dapat dilalui. |
-| **Kontrol Environment** | Atur pencahayaan, atmosfer, langit, dan waktu hari. |
-| **Visualisasi** | Tampilkan area, buat marker, sorot zona. |
+### Hemat token AI dengan workflow berdampak tinggi
 
-## Cara Pembelian
+Aksi massal dan lanjutan mengurangi panggilan berulang — lakukan lebih banyak per prompt.
 
-### Langkah 1: Beli di Gumroad
+### Kemampuan lanjutan yang lebih luas
 
-1. Kunjungi [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin)
-2. Unduh plugin
+Pembuatan terrain, pencarian aset, analisis spasial, animasi, audio, dan otomasi skala produksi.
 
-### Langkah 2: Instal Plugin
+## Langganan dan unduhan
 
-1. Jalankan Roblox Studio
-2. Tab Plugins → Klik **Plugins Folder**
-3. **Hapus** `WeppyRobloxMCP.rbxm` (versi Basic) yang ada
-4. **Salin** `WeppyRobloxMCP-Pro.rbxm` yang diunduh ke folder
-5. Restart Roblox Studio
+### Langkah 1: Berlangganan di Gumroad
+
+1. Buka [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/faccjs?utm_source=github&utm_medium=repo&utm_campaign=pro_upgrade_md)
+2. Selesaikan pembelian lisensi langganan Pro
+
+### Langkah 2: Unduh dari GitHub Releases
+
+1. Buka [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+2. Unduh `weppy-roblox-mcp-v{version}.zip`
+3. Ekstrak lalu salin `roblox-plugin/WeppyRobloxMCP.rbxm` ke folder Plugins Roblox
 
 ### Langkah 3: Verifikasi
 
-1. Buka plugin W-MCP
-2. Periksa apakah badge "Pro" ditampilkan
-3. Semua tools dapat digunakan!
+1. Buka W-MCP di Roblox Studio
+2. Pastikan badge Pro terlihat
+3. Jalankan aksi Pro (misalnya: `manage_sync` atau operasi massal)
 
 ## Perbandingan Fitur
 
 | Fitur | Basic | Pro |
 |-------|:-----:|:---:|
-| Instance, Script, Property | ✅ Akses penuh | ✅ Akses penuh |
+| Manajemen Script, Instance, Property | ✅ Akses penuh | ✅ Akses penuh |
 | Selection, Tag, Camera, Log | ✅ Akses penuh | ✅ Akses penuh |
-| Operasi Massal (Bulk) | ― | ✅ Tanpa batas |
-| Pencarian & Penyisipan Asset | ― | ✅ Tanpa batas |
-| Pembuatan Terrain | ― | ✅ Tanpa batas |
-| Environment, Raycast, Spatial | ― | ✅ Tanpa batas |
-| Tools Visualisasi | ― | ✅ Tanpa batas |
+| Arah Sync | Studio → Local (satu arah) | Dua arah |
+| Sync Direction per tipe | ❌ | ✅ Scripts / Values / Containers / Data / Services |
+| Apply Mode per tipe | ❌ | ✅ Auto / Manual |
+| Full Sync | ❌ | ✅ |
+| Resync / Bangun ulang state | ❌ | ✅ |
+| Riwayat Perubahan | ❌ | ✅ |
+| Sync multi-place | ❌ | ✅ Hingga 3 place dengan penyimpanan terisolasi |
+| Cakupan tools lanjutan | Set dasar | Set lanjutan lebih luas |
+| Efisiensi token AI | Standar | Lebih efisien dengan aksi massal / berdampak tinggi |

package/docs/id/tools/overview.md

@@ -2,6 +2,10 @@
 
 Hubungkan AI dengan Roblox Studio dan otomatiskan berbagai pekerjaan. Berikut adalah hal-hal yang bisa kamu lakukan berdasarkan kategori.
 
+Kebijakan Sync:
+- Basic: Studio -> Local (satu arah)
+- Pro: Sync dua arah + cakupan fitur lanjutan lebih luas (efisiensi token AI lebih baik lewat operasi massal)
+
 ---
 
 ## Basic (Gratis)

package/docs/ja/README.md

@@ -53,6 +53,12 @@ Creator Storeから無料モデルとアセットを検索して、すぐにゲ
 
 5分で終わります。👉 [インストールガイド](installation/README.md)
 
+## Proで始めよう
+
+制限なく制作しましょう。双方向Sync、高度な制作機能、AIトークン効率 — 一度のアップグレードで全てを手に入れる。
+
+👉 [Proアップグレードガイド](pro-upgrade.md)
+
 ## リンク
 
 - [GitHub](https://github.com/hope1026/roblox-mcp)

package/docs/ja/installation/README.md

@@ -29,11 +29,11 @@ GitHubからプラグインファイルをダウンロードして、Roblox Stud
 | AIアプリ | 設定方法 |
 |---------|---------|
 | Claude Code | [設定手順](ai-apps/claude-code.md) |
-| Cline | [設定手順](ai-apps/cline.md) |
-| Roo Code | [設定手順](ai-apps/roo-code.md) |
-| Cursor | [設定手順](ai-apps/cursor.md) |
-| Zed | [設定手順](ai-apps/zed.md) |
-| その他のMCP対応アプリ | [設定手順](ai-apps/other-mcp-clients.md) |
+| Claude Desktop | [設定手順](ai-apps/claude-app.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) |
 
 > 上記のリストにないAIアプリでも、MCPをサポートしていれば使用できます。MCPサーバーコマンド: `npx -y @weppy/roblox-mcp`
 

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

@@ -2,12 +2,17 @@
 
 Roblox StudioでAIエージェントと連携するためのプラグインインストール方法です。
 
-## 1. プラグインのダウンロード
+## 1. プラグインをダウンロード
 
-1. [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)から `weppy-roblox-mcp-basic-v{バージョン}.zip` をダウンロードします
-2. ZIPファイルを解凍します — `roblox-plugin/WeppyRobloxMCP.rbxm` ファイルとセットアップガイドが含まれています
+1. [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest) を開く
+2. `weppy-roblox-mcp-v{version}.zip` をダウンロード
+3. ZIPを解凍 - `roblox-plugin/WeppyRobloxMCP.rbxm` とセットアップガイドを確認
 
-## 2. プラグインのインストール
+メモ:
+- Basicは同じプラグインパッケージを使い、Basicポリシー（Studio -> Local 片方向Sync）で動作
+- Proサブスクライセンス有効化後、双方向Syncとより広い高度機能を利用可能
+
+## 2. プラグインをインストール
 
 1. **Roblox Studio** を起動
 2. 上部メニューの **Plugins** タブをクリック
@@ -15,7 +20,7 @@ Roblox StudioでAIエージェントと連携するためのプラグインイ
 
 ![Plugins Folderを開く](../../assets/screenshots/plugins_menu.png)
 
-4. 解凍したフォルダから `WeppyRobloxMCP.rbxm` ファイルを開いたPluginsフォルダに**コピー**
+4. 解凍フォルダ内の `WeppyRobloxMCP.rbxm` を Plugins フォルダへ**コピー**
 5. **Roblox Studioを再起動**
 
 ## 3. インストール確認
@@ -24,11 +29,11 @@ Roblox StudioでAIエージェントと連携するためのプラグインイ
 
 ![W-MCPボタン](../../assets/screenshots/weppy_plugin_toolbar.png)
 
-## 4. AIエージェントとの接続
+## 4. AIエージェントに接続
 
 ### 事前準備
 
-MCPサーバーがインストールされている必要があります。お使いのAIアプリに合ったガイドを先に完了してください:
+MCPサーバーがインストールされている必要があります。利用中のAIアプリのガイドを先に完了してください:
 
 | AIアプリ | インストールガイド |
 |-------|-------------|
@@ -39,41 +44,41 @@ MCPサーバーがインストールされている必要があります。お
 | Gemini CLI | [設定方法](ai-apps/gemini-cli.md) |
 | Antigravity | [設定方法](ai-apps/antigravity.md) |
 
-### 接続する
+### 接続
 
-1. **Roblox Studio**で任意のプロジェクトを開きます
-2. 上部の **Plugins** タブ → **W-MCP** をクリック
-3. プラグインウィンドウで **Connect** ボタンをクリック
-4. **"Connected"** 状態が表示されたら接続完了！
+1. **Roblox Studio**で任意のプロジェクトを開く
+2. **Plugins** タブ -> **W-MCP**
+3. プラグインウィンドウで **Connect** をクリック
+4. **"Connected"** が表示されたら完了
 
 ![プラグインメイン画面](../../assets/screenshots/plugin_main.png)
 
-## 5. 設定 (オプション)
+## 5. 設定（任意）
 
-プラグイン右上の設定ボタンをクリックすると、さまざまなオプションを変更できます。
+右上の設定ボタンからオプションを変更できます。
 
 ![設定画面](../../assets/screenshots/settings.png)
 
-- **自動接続**: Studio起動時に自動的にMCPサーバーに接続
-- **自動再接続**: 接続が切断された場合に自動的に再接続を試行
-- **自動カメラフォーカス**: 作成されたオブジェクトにカメラを自動移動
-- **言語**: プラグインUIの言語を変更
+- **自動接続**: Studio起動時に自動接続
+- **自動再接続**: 切断時に自動再接続
+- **自動カメラフォーカス**: 生成オブジェクトへ自動フォーカス
+- **言語**: UI言語を変更
 
 ## トラブルシューティング
 
 ### プラグインが表示されない
 
-- Roblox Studioを完全に終了してから再起動
-- Plugins Folderにファイルが正しくコピーされているか確認
-- `.rbxm` ファイルが破損していないか確認
+- Roblox Studioを完全終了して再起動
+- Plugins Folderへのコピーを確認
+- `.rbxm` が破損していないか確認
 
 ### 接続できない
 
-- AIアプリでMCPサーバーが実行中か確認
-- プラグインで **Connect** ボタンを再度クリック
-- ポート3002が他のプログラムで使用されていないか確認
+- AIアプリでMCPサーバーが起動しているか確認
+- **Connect** を再クリック
+- ポート3002の競合を確認
 
-### 接続がよく切れる
+### 接続が切れやすい
 
-- 設定で **自動再接続** オプションを有効化
-- AIアプリを再起動してみてください
+- 設定で **自動再接続** を有効化
+- AIアプリを再起動