@weppy/roblox-mcp 2.0.9 → 2.1.0

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

@@ -18,7 +18,7 @@ Nota:
 2. Clic en la pestana **Plugins**
 3. Clic en **Plugins Folder**
 
-![Abrir Plugins Folder](../../assets/screenshots/plugins_menu.png)
+![Abrir Plugins Folder](../../assets/screenshots/plugin/installation/plugins-menu.png)
 
 4. **Copia** `WeppyRobloxMCP.rbxm` a la carpeta abierta de Plugins
 5. **Reinicia Roblox Studio**
@@ -27,7 +27,7 @@ Nota:
 
 Despues de reiniciar, aparecera el boton **WROX** en Plugins.
 
-![Boton WROX](../../assets/screenshots/weppy_plugin_toolbar.png)
+![Boton WROX](../../assets/screenshots/plugin/installation/toolbar-button.png)
 
 ## 4. Conectar con el Agente de IA
 
@@ -52,13 +52,13 @@ El servidor MCP debe estar instalado. Completa primero la guia de tu app de IA:
 3. Clic en **Connect**
 4. Cuando veas **"Connected"**, listo
 
-![Pantalla principal del plugin](../../assets/screenshots/plugin_main.png)
+![Pantalla principal del plugin](../../assets/screenshots/plugin/installation/main-screen.png)
 
 ## 5. Configuracion (Opcional)
 
 Usa el boton de configuracion en la esquina superior derecha.
 
-![Pantalla de configuracion](../../assets/screenshots/settings.png)
+![Pantalla de configuracion](../../assets/screenshots/plugin/installation/settings-screen.png)
 
 - **Conexion automatica**
 - **Reconexion automatica**

package/docs/es/pro-upgrade.md

@@ -48,7 +48,7 @@ Solo necesitas activar la licencia una vez, ya sea en el plugin o en el dashboar
 5. Si el estado no se actualiza de inmediato, haz clic en **Refresh**.
 6. Cuando la activación se complete, el estado cambiará de Basic a Pro y las funciones Pro quedarán disponibles.
 
-![Pantalla de activación de licencia en el plugin](../assets/screenshots/license/license-plugin.png)
+![Pantalla de activación de licencia en el plugin](../assets/screenshots/plugin/license/plugin-license-screen.png)
 
 ### Activar en el dashboard
 
@@ -58,7 +58,7 @@ Solo necesitas activar la licencia una vez, ya sea en el plugin o en el dashboar
 4. Haz clic en **Activate License** para activar la licencia.
 5. Si hace falta, usa **Refresh License** para obtener el estado más reciente.
 
-![Pantalla de activación de licencia en el dashboard](../assets/screenshots/license/license-dashboard.png)
+![Pantalla de activación de licencia en el dashboard](../assets/screenshots/plugin/license/dashboard-license-screen.png)
 
 ### Después de activar
 

package/docs/es/sync/overview.md

@@ -12,13 +12,13 @@ Sin Sync, la IA solo ve fragmentos pegados en el chat. Con Sync activo, trabaja
 
 ## Como funciona
 
-![Flujo de Sync — arbol de Studio reflejado en archivos locales](../../assets/screenshots/sync.png)
+![Flujo de Sync — arbol de Studio reflejado en archivos locales](../../assets/screenshots/plugin/sync/sync-overview.png)
 
 1. Full Sync: espejo inicial del arbol/instancias de Studio a local
 2. Incremental Sync: reflejo continuo de cambios nuevos
 3. Seguimiento de History/Status: ver que cambio, cuando y en que direccion
 
-La ruta local por defecto es `roblox-project-sync/place_{placeId}/explorer`.
+Los datos de Sync se guardan en `{projectRoot}/wrox-project-sync/place_{placeId}/explorer`.
 
 ### Explorar datos sincronizados en VSCode
 
@@ -109,7 +109,7 @@ En Pro puedes controlar Direction y Apply Mode por tipo.
 
 Cuando se detectan cambios tanto en Studio como en local durante la sincronizacion bidireccional, aparece un dialogo de resolucion de conflictos.
 
-![Local Changes Detected — opciones de resolucion de conflictos (Studio Priority / Local Priority / Per-File)](../../assets/screenshots/sync_conflict.png)
+![Local Changes Detected — opciones de resolucion de conflictos (Studio Priority / Local Priority / Per-File)](../../assets/screenshots/plugin/sync/sync-conflict.png)
 
 - **Studio Priority**: sobrescribir usando el estado de Studio como fuente de verdad
 - **Local Priority**: aplicar los archivos locales a Studio

package/docs/es/tools/playtest.md

@@ -86,10 +86,10 @@ Edit --play--> Running --stop--> Edit
 
 ### 5. Escritura de reportes
 
-Los reportes y logs se escriben en archivos locales:
+Los reportes y logs se escriben en `{projectRoot}/wrox-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/`.
 
 ```text
-roblox-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/
+{projectRoot}/wrox-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/
 ├── test-report.md
 └── test-log.txt
 ```

package/docs/id/README.md

@@ -2,12 +2,20 @@
 
 > **WROX** adalah server MCP yang memungkinkan agen pengkodean AI mengontrol sesi Roblox Studio secara langsung — buat dan edit script, instance, terrain, lighting, asset, audio, dan animasi dengan bahasa alami.
 
-**21 alat terkonsolidasi · 140+ aksi · Sync dua arah · Playtest otomatis · Dukungan multi-place**
+**Alat terkonsolidasi berbasis aksi · Sync dua arah · Playtest otomatis · Dukungan multi-place**
 
 [English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | [Español](../es/README.md) | [Português](../pt-br/README.md) | **Bahasa Indonesia**
 
 [![Demo — AI membuat game Roblox secara real-time](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
 
+## Mengapa WROX (Weppy Roblox MCP)?
+
+Agen pengkodean AI seperti Claude, Codex, dan Gemini sangat kuat — tetapi tidak bisa melihat atau mengubah apa pun di dalam Roblox Studio. DataModel, script, terrain, dan lighting semuanya tidak terlihat oleh alat eksternal. Tanpa jembatan, AI hanya bisa menghasilkan potongan kode yang harus kamu tempelkan secara manual.
+
+**WROX** adalah jembatan antara agen AI dan Roblox Studio. AI langsung membuat dan memodifikasi instance, script, properti, terrain, dan lainnya di dalam Studio, dan perubahan langsung tercermin di Studio dan dashboard sehingga kamu bisa **melihat persis apa yang berubah**.
+
+Tidak perlu copy-paste kode. AI bekerja dan kamu memverifikasi hasilnya.
+
 ## Instalasi Cepat
 
 **Instalasi satu perintah** — Install MCP server, plugin Roblox Studio, dan daftarkan ke aplikasi AI dalam satu langkah:
@@ -52,14 +60,15 @@ npx -y @weppy/roblox-mcp
 | Codex CLI | [Setup](installation/ai-apps/codex-cli.md) |
 | Codex Desktop | [Setup](installation/ai-apps/codex-app.md) |
 | Gemini CLI | [Setup](installation/ai-apps/gemini-cli.md) |
+| Antigravity | [Setup](installation/ai-apps/antigravity.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 |
-|:-----------:|:--------------:|:------:|:---------:|:----------:|
-| ✅ | ✅ | ✅ | ✅ | ✅ |
+| Claude Code | Claude Desktop | Cursor | Codex CLI | Gemini CLI | Antigravity |
+|:-----------:|:--------------:|:------:|:---------:|:----------:|:-----------:|
+| ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
 
 **Persyaratan:** Node.js 18+, Roblox Studio, Windows 10+ atau macOS 12+
 
@@ -73,17 +82,15 @@ AI bisa langsung menangani script, instance, properti, terrain, lighting, asset,
 - "Buat arena boss di tengah map dan pasang spawn point yang aman dari tabrakan."
 - "Ubah interface modul ini dan perbarui semua script yang bergantung padanya."
 
-Ini bukan sekadar generate kode. Ini adalah **aksi yang benar-benar bisa dieksekusi**.
-
 ### 2) Sync: menjaga konteks penuh proyek untuk AI
 
 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)
-
 - Basic: sinkronisasi satu arah (Studio -> Local)
 - Pro: sinkronisasi dua arah + Direction/Apply Mode per tipe + riwayat + multiplace
 
+![Alur Sync — Studio dan file lokal tersinkron secara real time](../assets/screenshots/plugin/sync/sync-overview.png)
+
 ### 3) Playtest: AI menjalankan dan memverifikasi tes secara otomatis
 
 AI bisa mengontrol playtest Studio secara langsung. AI dapat memulai dan menghentikan Play (F5) atau Run (F8), menyuntikkan script test, mengumpulkan log, dan menghasilkan laporan lokal secara otomatis.
@@ -92,28 +99,30 @@ AI bisa mengontrol playtest Studio secara langsung. AI dapat memulai dan menghen
 - "Tulis dan jalankan test untuk memastikan SpawnLocation berada di atas tanah."
 - "Validasi lewat playtest bahwa script yang baru saya ubah berjalan tanpa error."
 
+![WROX Playtest Dashboard — riwayat tes dan laporan detail](../assets/screenshots/dashboard/dashboard_playtest.png)
+
 ### 4) WROX Dashboard: pantau pekerjaan AI secara real-time
 
 Dashboard berbasis web yang disediakan server MCP memungkinkan Anda melihat status koneksi, riwayat eksekusi alat, status sinkronisasi, dan riwayat perubahan game secara real-time.
 
-![WROX WROX Dashboard Overview — status server, perubahan terbaru, ringkasan sesi](../assets/screenshots/dashboard/dashboard_overview.png)
-
 - Lihat status koneksi server/plugin/agen dalam satu pandangan
 - Bandingkan semua perubahan yang dilakukan AI dengan Before & After di Changelog
 - Analisis alur kerja dengan riwayat dan statistik eksekusi alat
 
+![WROX WROX Dashboard Overview — status server, perubahan terbaru, ringkasan sesi](../assets/screenshots/dashboard/dashboard_overview.png)
+
 ### 5) WROX 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.
 WROX Roblox Explorer adalah ekstensi pendamping VSCode untuk data sync yang dihasilkan oleh WROX. 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).
 
-![WROX 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
 
+![WROX Roblox Explorer — pohon instance Studio ditampilkan di sidebar VSCode](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+
 ## Nilai yang langsung terasa
 
 - Ringkas pekerjaan berulang: banyak edit manual jadi satu perintah
@@ -121,6 +130,14 @@ Instal dari [VS Code Marketplace](https://marketplace.visualstudio.com/items?ite
 - Risiko lebih rendah: putuskan perubahan dari status sync dan riwayat
 - Efisiensi token lebih baik (Pro): kurangi bolak-balik dengan aksi massal
 
+## Kasus penggunaan
+
+- **Prototipe cepat**: Jelaskan mekanik game dalam bahasa alami dan lihat AI membuatnya di Studio
+- **Refaktor massal**: Ubah nama interface modul dan perbarui semua script dependen dalam satu permintaan
+- **Terrain & lingkungan**: Hasilkan terrain prosedural, atur lighting/atmosfer, tempatkan asset — semua dari satu prompt
+- **Konsistensi multi-file**: AI membaca seluruh proyek via Sync dan menerapkan perubahan di script terkait secara bersamaan
+- **Integrasi asset**: Cari di Creator Store, sisipkan model, dan konfigurasi properti tanpa meninggalkan editor
+
 ## Dokumen detail
 
 - [Panduan instalasi](installation/README.md)
@@ -140,12 +157,47 @@ Instal dari [VS Code Marketplace](https://marketplace.visualstudio.com/items?ite
 - [Playtest & tes otomatis](tools/playtest.md) - kontrol playtest dan validasi otomatis
 - [Sistem & debugging](tools/system-and-debugging.md) - koneksi, log, dan eksekusi batch
 
+## FAQ
+
+### Bagaimana cara menghubungkan Claude Code ke Roblox Studio?
+Install plugin Roblox Studio, lalu daftarkan MCP server (`npx -y @weppy/roblox-mcp`) di Claude Code. Claude dapat langsung membaca dan menulis script di dalam Studio. Lihat [Setup Claude Code](installation/ai-apps/claude-code.md).
+
+### Bagaimana cara menggunakan Codex CLI dengan Roblox Studio?
+Install plugin, lalu tambahkan konfigurasi MCP server ke Codex CLI. Lihat [Setup Codex CLI](installation/ai-apps/codex-cli.md).
+
+### Apakah Roblox MCP bekerja dengan Cursor?
+Ya. Lihat [Setup Cursor](installation/ai-apps/cursor.md). Semua klien AI yang kompatibel MCP bisa dipakai.
+
+### Bisakah AI membuat game Roblox dengan ini?
+Ya. AI dapat membuat instance, menulis script, menghasilkan terrain, mengatur lighting, menyisipkan asset, mengkonfigurasi fisika, dan lainnya — semua di dalam sesi Studio yang sedang berjalan. Ini melampaui pembuatan kode menuju aksi yang dapat dieksekusi.
+
+### Apa perbedaan antara Basic dan Pro?
+Basic (gratis) mencakup eksekusi alat MCP dan sinkronisasi satu arah (Studio -> Local). Pro menambahkan sinkronisasi dua arah, operasi massal, pembuatan terrain, analisis spasial, kontrol audio/animasi, dan dukungan multi-place. Lihat [Panduan Upgrade Pro](pro-upgrade.md).
+
+### Apa bedanya Weppy dengan server MCP Roblox lainnya?
+Weppy menggunakan dispatching berbasis aksi alih-alih alat terpisah untuk setiap fungsi. Ini mengurangi konsumsi token AI secara signifikan. Weppy juga menyediakan sinkronisasi proyek dua arah dan dukungan multi-place, yang tidak dimiliki kebanyakan alternatif lain.
+
+### Apakah aman? Bisakah AI merusak game saya?
+Server hanya berjalan di localhost (127.0.0.1:3002). Path terlarang (CoreGui, CorePackages) diblokir. Rate limiting (450 req/min) dan timeout 30 detik mencegah operasi yang tidak terkendali. Semua perubahan bisa dilacak melalui riwayat sinkronisasi.
+
 ## Upgrade Pro
 
 Sync dua arah, kemampuan kreasi lanjutan, dan efisiensi token AI — semua dalam satu upgrade.
 
 [Panduan Upgrade Pro](pro-upgrade.md)
 
+## Lisensi
+
+Repositori ini dilisensikan di bawah `AGPL-3.0`.
+
+Lisensi komersial tersedia secara terpisah. Lihat [COMMERCIAL-LICENSE.md](../../COMMERCIAL-LICENSE.md).
+
+Penggunaan nama dan logo Weppy diatur oleh [TRADEMARKS.md](../../TRADEMARKS.md).
+
 ---
 
+[![npm version](https://img.shields.io/npm/v/@weppy/roblox-mcp)](https://www.npmjs.com/package/@weppy/roblox-mcp) [![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org/) [![Smithery](https://smithery.ai/badge/@hope1026/weppy-roblox-mcp)](https://smithery.ai/server/@hope1026/weppy-roblox-mcp)
+
+[![Roblox MCP on Glama](https://glama.ai/mcp/servers/hope1026/roblox-mcp/badges/card.svg)](https://glama.ai/mcp/servers/hope1026/roblox-mcp)
+
 [GitHub Issues](https://github.com/hope1026/weppy-roblox-mcp/issues) · [Discussions](https://github.com/hope1026/weppy-roblox-mcp/discussions) · [npm](https://www.npmjs.com/package/@weppy/roblox-mcp)

package/docs/id/dashboard/connection.md

@@ -6,7 +6,7 @@
 
 ## Ikhtisar
 
-Halaman Connection memantau semua status koneksi sistem MCP di satu tempat. Halaman ini selalu dapat diakses selama server terhubung (L1 ke atas).
+Halaman Connection memantau semua status koneksi sistem MCP di satu tempat. Halaman ini selalu dapat diakses saat dashboard berada dalam status **Server terhubung** atau **Studio terhubung**.
 
 ## Server Status
 

package/docs/id/dashboard/overview.md

@@ -34,17 +34,17 @@ http://localhost:3002
 
 > Atur `DASHBOARD_AUTO_OPEN=false` untuk menonaktifkan pembukaan otomatis (lihat halaman [Settings](settings.md)).
 
-## Level Koneksi
+## Status Koneksi
 
 Fitur yang tersedia di dashboard berbeda tergantung pada status koneksi:
 
-| Level | Kondisi | Halaman yang Tersedia |
-|:-----:|---------|----------------------|
-| **L0** | Server tidak terhubung | Hanya menampilkan layar menunggu koneksi ulang |
-| **L1** | Server terhubung, plugin tidak terhubung | Connection, Tools, Settings |
-| **L2** | Server + Plugin keduanya terhubung | Semua halaman |
+| Status | Kondisi | Halaman yang Tersedia |
+|--------|---------|----------------------|
+| **Server terputus** | Server tidak terhubung | Hanya menampilkan layar menunggu koneksi ulang |
+| **Server terhubung** | Server terhubung, plugin tidak terhubung | Connection, Tools, Settings |
+| **Studio terhubung** | Server + Plugin keduanya terhubung | Semua halaman |
 
-Saat plugin belum terhubung (L1), halaman Overview, Changelog, Sync, dan Playtest tidak dapat diakses.
+Saat dashboard berada dalam status **Server terhubung**, halaman Overview, Changelog, Sync, dan Playtest tidak dapat diakses.
 
 ## Overview
 

package/docs/id/dashboard/playtest.md

@@ -6,7 +6,7 @@
 
 ## Ikhtisar
 
-Halaman Playtest menampilkan status dan hasil pengujian dari playtest yang dijalankan AI. Halaman ini hanya dapat diakses saat plugin terhubung (L2).
+Halaman Playtest menampilkan status dan hasil pengujian dari playtest yang dijalankan AI. Halaman ini hanya dapat diakses saat dashboard berada dalam status **Studio terhubung**.
 
 ## Playtest Status
 

package/docs/id/dashboard/settings.md

@@ -4,7 +4,7 @@
 
 ## Ikhtisar
 
-Di halaman Settings, Anda dapat melihat informasi lisensi dan pengaturan server, serta mengubah sebagian pengaturan. Halaman ini selalu dapat diakses selama server terhubung (L1 ke atas).
+Di halaman Settings, Anda dapat melihat informasi lisensi dan pengaturan server, serta mengubah sebagian pengaturan. Halaman ini selalu dapat diakses saat dashboard berada dalam status **Server terhubung** atau **Studio terhubung**.
 
 ## License (hanya-baca)
 

package/docs/id/dashboard/sync.md

@@ -8,7 +8,7 @@
 
 ## Ikhtisar
 
-Halaman Sync menampilkan status dan pengaturan sinkronisasi Studio <-> file lokal secara visual. Halaman ini hanya dapat diakses saat plugin terhubung (L2).
+Halaman Sync menampilkan status dan pengaturan sinkronisasi Studio <-> file lokal secara visual. Halaman ini hanya dapat diakses saat dashboard berada dalam status **Studio terhubung**.
 
 ## Sync Status
 

package/docs/id/dashboard/tools.md

@@ -6,7 +6,7 @@
 
 ## Ikhtisar
 
-Halaman Tools menyediakan riwayat eksekusi dan statistik alat MCP yang dijalankan oleh AI. Terdiri dari dua sub-tab: **History** dan **Statistics**. Halaman ini selalu dapat diakses selama server terhubung (L1 ke atas).
+Halaman Tools menyediakan riwayat eksekusi dan statistik alat MCP yang dijalankan oleh AI. Terdiri dari dua sub-tab: **History** dan **Statistics**. Halaman ini selalu dapat diakses saat dashboard berada dalam status **Server terhubung** atau **Studio terhubung**.
 
 ## Tab History
 

package/docs/id/installation/README.md

@@ -72,7 +72,7 @@ Daftarkan MCP server ke aplikasi AI yang kamu pakai. Bisa digunakan di semua apl
 ## Opsional: Install WROX 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.
+Ekstensi opsional ini mengharuskan setup Roblox MCP di atas sudah selesai lebih dulu, karena Explorer membaca data Sync dari `wrox-project-sync` di bawah root proyek.
 
 👉 [Panduan Instalasi WROX Roblox Explorer](roblox-explorer.md)
 

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

@@ -9,7 +9,7 @@ Ini adalah ekstensi pendamping untuk WROX, bukan integrasi Roblox yang berdiri s
 
 - 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
+- Sync sudah menghasilkan `wrox-project-sync/place_*/.sync-meta.json` di bawah root proyek
 
 ## Cara Instalasi
 
@@ -37,7 +37,7 @@ Penjelajahan tree dasar bekerja dari file sync di disk. Status sync live, indika
 
 | Pengaturan | Default | Deskripsi |
 |------------|---------|-----------|
-| `robloxExplorer.syncRoot` | `""` | Jalur absolut ke root `roblox-project-sync`. Terdeteksi otomatis jika kosong. |
+| `robloxExplorer.syncRoot` | `""` | Jalur absolut ke root `wrox-project-sync`. Jika kosong, akan dideteksi otomatis. WROX memakai `{projectRoot}/wrox-project-sync`. |
 | `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. |

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

@@ -18,7 +18,7 @@ Catatan:
 2. Klik tab **Plugins**
 3. Klik **Plugins Folder**
 
-![Buka Plugins Folder](../../assets/screenshots/plugins_menu.png)
+![Buka Plugins Folder](../../assets/screenshots/plugin/installation/plugins-menu.png)
 
 4. **Salin** `WeppyRobloxMCP.rbxm` ke folder Plugins
 5. **Restart Roblox Studio**
@@ -27,7 +27,7 @@ Catatan:
 
 Setelah restart, tombol **WROX** muncul di tab Plugins.
 
-![Tombol WROX](../../assets/screenshots/weppy_plugin_toolbar.png)
+![Tombol WROX](../../assets/screenshots/plugin/installation/toolbar-button.png)
 
 ## 4. Hubungkan AI Agent
 
@@ -52,13 +52,13 @@ MCP server harus sudah terinstal. Selesaikan dulu panduan app AI yang Anda pakai
 3. Klik **Connect**
 4. Jika status **"Connected"** tampil, koneksi berhasil
 
-![Layar Utama Plugin](../../assets/screenshots/plugin_main.png)
+![Layar Utama Plugin](../../assets/screenshots/plugin/installation/main-screen.png)
 
 ## 5. Pengaturan (Opsional)
 
 Gunakan tombol pengaturan di kanan atas plugin.
 
-![Layar Pengaturan](../../assets/screenshots/settings.png)
+![Layar Pengaturan](../../assets/screenshots/plugin/installation/settings-screen.png)
 
 - **Auto Connect**
 - **Auto Reconnect**

package/docs/id/pro-upgrade.md

@@ -48,7 +48,7 @@ Kamu hanya perlu mengaktifkan lisensi sekali, baik di plugin maupun di dashboard
 5. Jika status belum langsung diperbarui, klik **Refresh**.
 6. Setelah aktivasi berhasil, status berubah dari Basic ke Pro dan fitur Pro bisa digunakan.
 
-![Layar aktivasi lisensi di plugin](../assets/screenshots/license/license-plugin.png)
+![Layar aktivasi lisensi di plugin](../assets/screenshots/plugin/license/plugin-license-screen.png)
 
 ### Aktifkan di dashboard
 
@@ -58,7 +58,7 @@ Kamu hanya perlu mengaktifkan lisensi sekali, baik di plugin maupun di dashboard
 4. Klik **Activate License** untuk mengaktifkan lisensi.
 5. Jika perlu, gunakan **Refresh License** untuk mengambil status terbaru.
 
-![Layar aktivasi lisensi di dashboard](../assets/screenshots/license/license-dashboard.png)
+![Layar aktivasi lisensi di dashboard](../assets/screenshots/plugin/license/dashboard-license-screen.png)
 
 ### Setelah aktivasi
 

package/docs/id/sync/overview.md

@@ -12,13 +12,13 @@ Tanpa Sync, AI hanya melihat potongan kode yang ditempel di chat. Dengan Sync ak
 
 ## Cara kerjanya
 
-![Alur Sync — tree Studio di-mirror ke file lokal](../../assets/screenshots/sync.png)
+![Alur Sync — tree Studio di-mirror ke file lokal](../../assets/screenshots/plugin/sync/sync-overview.png)
 
 1. Full Sync: mirror awal dari tree/instance Studio ke lokal
 2. Incremental Sync: perubahan baru terus disinkronkan
 3. Pelacakan History/Status: cek apa yang berubah, kapan, dan ke arah mana
 
-Path lokal default adalah `roblox-project-sync/place_{placeId}/explorer`.
+Data Sync disimpan di `{projectRoot}/wrox-project-sync/place_{placeId}/explorer`.
 
 ### Jelajahi data sync di VSCode
 
@@ -109,7 +109,7 @@ Di Pro, Direction dan Apply Mode bisa diatur per tipe.
 
 Ketika perubahan terdeteksi di sisi Studio maupun lokal selama sinkronisasi dua arah, dialog resolusi konflik akan muncul.
 
-![Local Changes Detected — opsi resolusi konflik (Studio Priority / Local Priority / Per-File)](../../assets/screenshots/sync_conflict.png)
+![Local Changes Detected — opsi resolusi konflik (Studio Priority / Local Priority / Per-File)](../../assets/screenshots/plugin/sync/sync-conflict.png)
 
 - **Studio Priority**: timpa dengan status Studio sebagai sumber kebenaran
 - **Local Priority**: terapkan file lokal ke Studio

package/docs/id/tools/playtest.md

@@ -86,10 +86,10 @@ Edit --play--> Running --stop--> Edit
 
 ### 5. Penulisan laporan
 
-Laporan dan log ditulis ke file lokal:
+Laporan dan log ditulis ke `{projectRoot}/wrox-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/`.
 
 ```text
-roblox-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/
+{projectRoot}/wrox-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/
 ├── test-report.md
 └── test-log.txt
 ```

package/docs/ja/README.md

@@ -2,12 +2,20 @@
 
 > **WROX**は、AIコーディングエージェントがライブRoblox Studioセッションを制御できるMCPサーバーです — 自然言語でスクリプト、インスタンス、Terrain、ライティング、アセット、オーディオ、アニメーションを作成・編集します。
 
-**21統合ツール · 140+アクション · 双方向Sync · 自動プレイテスト · マルチPlace対応**
+**アクションベース統合ツール · 双方向Sync · 自動プレイテスト · マルチPlace対応**
 
 [English](../../README.md) | [한국어](../ko/README.md) | **日本語** | [Español](../es/README.md) | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
 
 [![デモ — AIがリアルタイムでRobloxゲームを制作する様子](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
 
+## WROX（Weppy Roblox MCP）を使う理由
+
+Claude、Codex、GeminiなどのAIコーディングエージェントは強力ですが、Roblox Studioの内部は見ることも変更することもできません。DataModel、スクリプト、Terrain、ライティングはすべて外部ツールからは不可視です。ブリッジがなければ、AIはコードスニペットを生成するだけで、手動で貼り付ける必要があります。
+
+**WROX**は、AIエージェントとRoblox Studioをつなぐブリッジです。AIがStudio内でインスタンス、スクリプト、プロパティ、Terrainなどを直接作成・変更すると、変更内容がStudioとダッシュボードに即座に反映され、**何が変わったか一目で確認**できます。
+
+コードをコピー＆ペーストする必要はありません。AIが作業し、あなたが結果を確認するワークフローです。
+
 ## クイックインストール
 
 **ワンラインインストール** — MCPサーバー、Roblox Studioプラグイン、AIアプリへの登録を一度に完了します：
@@ -52,14 +60,15 @@ npx -y @weppy/roblox-mcp
 | Codex CLI | [セットアップ](installation/ai-apps/codex-cli.md) |
 | Codex Desktop | [セットアップ](installation/ai-apps/codex-app.md) |
 | Gemini CLI | [セットアップ](installation/ai-apps/gemini-cli.md) |
+| Antigravity | [セットアップ](installation/ai-apps/antigravity.md) |
 
 > MCP対応のAIアプリであれば利用できます。サーバーコマンド: `npx -y @weppy/roblox-mcp`
 
 ## 互換性
 
-| Claude Code | Claude Desktop | Cursor | Codex CLI | Gemini CLI |
-|:-----------:|:--------------:|:------:|:---------:|:----------:|
-| ✅ | ✅ | ✅ | ✅ | ✅ |
+| Claude Code | Claude Desktop | Cursor | Codex CLI | Gemini CLI | Antigravity |
+|:-----------:|:--------------:|:------:|:---------:|:----------:|:-----------:|
+| ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
 
 **要件:** Node.js 18+、Roblox Studio、Windows 10+ または macOS 12+
 
@@ -73,17 +82,15 @@ AIがStudio内で、スクリプト、インスタンス、プロパティ、地
 - 「マップ中央にボスアリーナを作って、衝突しないスポーンポイントを配置して。」
 - 「このモジュールのインターフェースを変えて、依存スクリプトを全部更新して。」
 
-単なるコード生成ではなく、**実行可能な作業単位**として処理できる点が重要です。
-
 ### 2) Sync: AIがプロジェクト全体の文脈を維持
 
 同期されたローカルミラーを基準にAIが作業するため、複数ファイルにまたがる変更も一貫して適用できます。
 
-![Syncワークフロー — Studioとローカルファイルがリアルタイムで同期される様子](../assets/screenshots/sync.png)
-
 - Basic: 片方向同期（Studio -> Local）
 - Pro: 双方向同期 + タイプ別Direction/Apply Mode + 変更履歴 + マルチPlace
 
+![Syncワークフロー — Studioとローカルファイルがリアルタイムで同期される様子](../assets/screenshots/plugin/sync/sync-overview.png)
+
 ### 3) Playtest: AIがテストを自動実行して検証
 
 AIがStudioプレイテストを直接制御します。Play（F5）/Run（F8）の開始と停止だけでなく、テストスクリプト注入、ログ収集、レポート生成まで自動化できます。
@@ -92,28 +99,30 @@ AIがStudioプレイテストを直接制御します。Play（F5）/Run（F8）
 - 「SpawnLocationが地面の上にあることを確認するテストを書いて実行して。」
 - 「今修正したスクリプトがエラーなしで動くかプレイテストで検証して。」
 
+![WROXプレイテスト ダッシュボード — テスト履歴と詳細レポート](../assets/screenshots/dashboard/dashboard_playtest.png)
+
 ### 4) WROX Dashboard: AI作業をリアルタイムでモニタリング
 
 MCPサーバーが提供するWebダッシュボードで、接続状態、ツール実行履歴、同期状態、ゲーム変更履歴をリアルタイムで確認します。
 
-![ダッシュボード Overview — サーバー状態、最近の変更、セッション要約](../assets/screenshots/dashboard/dashboard_overview.png)
-
 - サーバー/プラグイン/エージェントの接続状態を一目で確認
 - AIが変更したすべての内容をChangelogでBefore & Afterで比較
 - ツール実行履歴と統計で作業フローを分析
 
+![ダッシュボード Overview — サーバー状態、最近の変更、セッション要約](../assets/screenshots/dashboard/dashboard_overview.png)
+
 ### 5) WROX Roblox Explorer: VSCodeでStudioの階層構造を閲覧
 
 Roblox Studioのインスタンスツリー全体をVSCode内で直接確認できます。サービスを探索し、同期されたスクリプトやプロパティファイルを開き、同期状態を追跡 — Studioに切り替える必要はありません。
 WROX Roblox Explorerは、WROXが生成する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) からインストールできます。
 
-![WROX Roblox Explorer — VSCodeサイドバーに表示されるStudioインスタンスツリー](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
-
 - Studio同様のクラスアイコンで直感的に識別
 - クリックで同期済みスクリプトとプロパティファイルを開く
 - 同期状態表示付きのマルチPlaceサポート
 
+![WROX Roblox Explorer — VSCodeサイドバーに表示されるStudioインスタンスツリー](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+
 ## すぐに実感できる価値
 
 - 反復作業を圧縮: 多数の手作業を1つの指示に集約
@@ -121,6 +130,14 @@ WROX Roblox Explorerは、WROXが生成するsyncデータを扱うcompanion VSC
 - リスク低減: 同期状態と履歴を見ながら安全に変更
 - トークン効率向上（Pro）: バルク処理で往復回数を削減
 
+## ユースケース
+
+- **ラピッドプロトタイピング**: 自然言語でゲームメカニクスを説明するだけでAIがStudioで構築
+- **一括リファクタリング**: モジュールインターフェースを変更し、すべての依存スクリプトを一度に更新
+- **Terrain・環境**: 手続き的地形生成、ライティング/雰囲気設定、アセット配置を1つのプロンプトで
+- **マルチファイル一貫性**: AIがSyncでプロジェクト全体を読み取り、関連スクリプトをまとめて変更
+- **アセット統合**: Creator Storeの検索、モデルの挿入、プロパティの設定をエディタから離れずに実行
+
 ## 詳細ドキュメント
 
 - [インストールガイド](installation/README.md)
@@ -140,12 +157,47 @@ WROX Roblox Explorerは、WROXが生成するsyncデータを扱うcompanion VSC
 - [プレイテスト & 自動テスト](tools/playtest.md) - プレイテスト制御、自動検証
 - [システム & デバッグ](tools/system-and-debugging.md) - 接続、ログ、バッチ実行
 
+## FAQ
+
+### Claude CodeをRoblox Studioに接続するには？
+Roblox Studioプラグインをインストールし、Claude CodeにMCPサーバー（`npx -y @weppy/roblox-mcp`）を登録してください。ClaudeがStudio内のスクリプトを直接読み書きできるようになります。[Claude Codeセットアップ](installation/ai-apps/claude-code.md)を参照してください。
+
+### Codex CLIでRoblox Studioを使うには？
+プラグインをインストールし、Codex CLIにMCPサーバー設定を追加してください。[Codex CLIセットアップ](installation/ai-apps/codex-cli.md)を参照してください。
+
+### Roblox MCPはCursorで動きますか？
+はい。[Cursorセットアップ](installation/ai-apps/cursor.md)を参照してください。MCP対応のAIクライアントであれば利用できます。
+
+### AIでRobloxゲームを作れますか？
+はい。AIはインスタンスの作成、スクリプトの記述、地形の生成、ライティングの設定、アセットの挿入、物理の設定など、すべてをライブStudioセッション内で直接実行します。コード生成を超えて実行可能なアクションまで処理します。
+
+### BasicとProの違いは？
+Basic（無料）にはMCPツール実行と片方向同期（Studio -> Local）が含まれます。Proは双方向同期、バルク操作、地形生成、空間分析、オーディオ/アニメーション制御、マルチPlaceサポートを追加します。[Proアップグレードガイド](pro-upgrade.md)を参照してください。
+
+### Weppyは他のRoblox MCPサーバーとどう違いますか？
+Weppyは機能ごとに個別ツールを分ける代わりにアクションベースのディスパッチを使用します。これによりAIトークン消費が大幅に削減されます。また、双方向プロジェクト同期とマルチPlaceサポートを提供しますが、他の代替製品にはないことがほとんどです。
+
+### 安全ですか？AIがゲームを壊すことはありますか？
+サーバーはlocalhost（127.0.0.1:3002）でのみ動作します。禁止パス（CoreGui、CorePackages）はブロックされます。レート制限（450 req/min）と30秒タイムアウトが暴走操作を防ぎます。すべての変更は同期履歴で追跡できます。
+
 ## Proアップグレード
 
 双方向Sync、高度な制作機能、AIトークン効率 — 一度のアップグレードで全てを手に入れる。
 
 [Proアップグレードガイド](pro-upgrade.md)
 
+## ライセンス
+
+このリポジトリは`AGPL-3.0`ライセンスの下で公開されています。
+
+商用ライセンスは別途提供されています。[COMMERCIAL-LICENSE.md](../../COMMERCIAL-LICENSE.md)をご覧ください。
+
+Weppyの名前およびロゴの使用は[TRADEMARKS.md](../../TRADEMARKS.md)に準拠します。
+
 ---
 
+[![npm version](https://img.shields.io/npm/v/@weppy/roblox-mcp)](https://www.npmjs.com/package/@weppy/roblox-mcp) [![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org/) [![Smithery](https://smithery.ai/badge/@hope1026/weppy-roblox-mcp)](https://smithery.ai/server/@hope1026/weppy-roblox-mcp)
+
+[![Roblox MCP on Glama](https://glama.ai/mcp/servers/hope1026/roblox-mcp/badges/card.svg)](https://glama.ai/mcp/servers/hope1026/roblox-mcp)
+
 [GitHubイシュー](https://github.com/hope1026/weppy-roblox-mcp/issues) · [Discussions](https://github.com/hope1026/weppy-roblox-mcp/discussions) · [npm](https://www.npmjs.com/package/@weppy/roblox-mcp)

package/docs/ja/dashboard/connection.md

@@ -6,7 +6,7 @@
 
 ## 概要
 
-ConnectionページはMCPシステムのすべての接続状態を一か所でモニタリングします。サーバーが接続されていれば（L1以上）常にアクセスできます。
+ConnectionページはMCPシステムのすべての接続状態を一か所でモニタリングします。ダッシュボードが **サーバー接続済み** または **Studio接続済み** 状態であれば常にアクセスできます。
 
 ## Server Status