@weppy/roblox-mcp 2.0.0 → 2.0.2

package/docs/id/README.md

@@ -8,10 +8,28 @@
 
 [![Demo — AI membuat game Roblox secara real-time](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
 
-## Instalasi Cepat (5 menit)
+## Instalasi Cepat
+
+**Instalasi satu perintah** — Install MCP server, plugin Roblox Studio, dan daftarkan ke aplikasi AI dalam satu langkah:
+
+```bash
+# macOS / Linux
+curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+
+# Windows (PowerShell)
+irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
+```
+
+Restart Roblox Studio — selesai!
+
+Jika eksekusi PowerShell diblokir di Windows, lanjutkan dengan instalasi manual di bawah. Jika kamu memakai paket ZIP, kamu juga bisa memakai `setup-plugin.bat` dan `setup-mcp.bat`.
+
+### Instalasi Manual
+
+Jika instalasi satu perintah tidak berjalan, atau instalasi otomatis tidak bisa dipakai di lingkunganmu, gunakan instalasi manual di bawah sebagai alternatif.
 
 **Langkah 1** — Install plugin Roblox Studio (jembatan antara Studio dan AI):
-[Panduan instalasi plugin](../en/installation/roblox-plugin.md)
+[Panduan instalasi plugin](installation/roblox-plugin.md)
 
 **Langkah 2** — Daftarkan MCP server di aplikasi AI:
 
@@ -21,11 +39,12 @@ 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) |
+| Claude Code | [Setup](installation/ai-apps/claude-code.md) |
+| Claude Desktop | [Setup](installation/ai-apps/claude-app.md) |
+| Cursor | [Setup](installation/ai-apps/cursor.md) |
+| 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) |
 
 > Bekerja dengan semua klien MCP yang kompatibel. Perintah server: `npx -y @weppy/roblox-mcp`
 
@@ -95,11 +114,11 @@ Lihat seluruh pohon instance dari place Roblox Studio langsung di dalam VSCode.
 
 ## Dokumen detail
 
-- [Panduan instalasi](../en/installation/README.md)
+- [Panduan instalasi](installation/README.md)
 - [Daftar tool lengkap](tools/overview.md)
 - [Panduan detail Sync](sync/overview.md)
 - [Panduan dashboard](dashboard/overview.md)
-- [Roblox Explorer (Ekstensi VSCode)](../en/installation/roblox-explorer.md)
+- [Roblox Explorer (Ekstensi VSCode)](installation/roblox-explorer.md)
 - [Kompatibilitas](../compatibility.md)
 - [Panduan pemecahan masalah](../troubleshooting.md)
 
@@ -116,7 +135,7 @@ Lihat seluruh pohon instance dari place Roblox Studio langsung di dalam VSCode.
 
 Sync dua arah, kemampuan kreasi lanjutan, dan efisiensi token AI — semua dalam satu upgrade.
 
-[Panduan Upgrade Pro](../en/pro-upgrade.md)
+[Panduan Upgrade Pro](pro-upgrade.md)
 
 ---
 

package/docs/id/installation/README.md

@@ -14,7 +14,29 @@ Ketika aplikasi AI bilang "buatkan part biru", MCP server mengonversi perintah i
 
 ---
 
-## Langkah 1: Install Plugin Roblox Studio
+## Instalasi Satu Perintah (Direkomendasikan)
+
+Install MCP server, plugin Roblox Studio, dan daftarkan ke aplikasi AI dalam satu langkah:
+
+```bash
+# macOS / Linux
+curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+
+# Windows (PowerShell)
+irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
+```
+
+Restart Roblox Studio — selesai!
+
+Jika eksekusi PowerShell diblokir di Windows, lanjutkan dengan instalasi manual di bawah. Jika kamu memakai paket ZIP, kamu juga bisa menjalankan `setup-plugin.bat` dan `setup-mcp.bat`.
+
+---
+
+## Instalasi Manual
+
+Ini adalah metode alternatif jika instalasi satu perintah tidak berjalan, atau jika instalasi otomatis tidak bisa dipakai di lingkunganmu.
+
+### Langkah 1: Install Plugin Roblox Studio
 
 Download file plugin dari GitHub, lalu taruh di folder Plugins Roblox Studio.
 
@@ -22,7 +44,7 @@ Download file plugin dari GitHub, lalu taruh di folder Plugins Roblox Studio.
 
 ---
 
-## Langkah 2: Daftarkan MCP Server di Aplikasi AI
+### Langkah 2: Daftarkan MCP Server di Aplikasi AI
 
 Daftarkan MCP server ke aplikasi AI yang kamu pakai. Bisa digunakan di semua aplikasi AI yang mendukung MCP.
 
@@ -30,6 +52,7 @@ Daftarkan MCP server ke aplikasi AI yang kamu pakai. Bisa digunakan di semua apl
 |-------------|------------------|
 | Claude Code | [Lihat caranya](ai-apps/claude-code.md) |
 | Claude Desktop | [Lihat caranya](ai-apps/claude-app.md) |
+| Cursor | [Lihat caranya](ai-apps/cursor.md) |
 | Codex CLI | [Lihat caranya](ai-apps/codex-cli.md) |
 | Codex Desktop | [Lihat caranya](ai-apps/codex-app.md) |
 | Gemini CLI | [Lihat caranya](ai-apps/gemini-cli.md) |

package/docs/id/installation/ai-apps/cursor.md

@@ -0,0 +1,77 @@
+# Pengaturan Cursor
+
+Cara menggunakan Roblox MCP dengan [Cursor](https://cursor.com/).
+
+## Prasyarat
+
+- **Cursor** sudah terpasang
+- **Node.js** (v18.0.0 atau lebih baru)
+- **Plugin Roblox Studio** sudah terpasang
+
+## Mendaftarkan server MCP
+
+### Metode 1: Konfigurasi proyek
+
+Tambahkan isi berikut ke `.cursor/mcp.json` di proyek Anda:
+
+```json
+{
+  "mcpServers": {
+    "weppy-roblox-mcp": {
+      "command": "npx",
+      "args": ["-y", "@weppy/roblox-mcp"]
+    }
+  }
+}
+```
+
+### Metode 2: Konfigurasi global
+
+Tambahkan isi yang sama ke file konfigurasi global Cursor.
+
+**Lokasi file konfigurasi:**
+
+| Cakupan | Path |
+|---------|------|
+| Proyek | `<proyek>/.cursor/mcp.json` |
+| Global (macOS/Linux) | `~/.cursor/mcp.json` |
+| Global (Windows) | `%USERPROFILE%\\.cursor\\mcp.json` |
+
+> Jika file sudah ada, gabungkan entri `weppy-roblox-mcp` ke dalam objek `mcpServers` yang sudah ada.
+
+### Terapkan perubahan
+
+Setelah mengubah konfigurasi, muat ulang jendela Cursor atau mulai ulang aplikasinya.
+
+## Uji koneksi
+
+1. Buka **Roblox Studio** → tab Plugins → **W-MCP** → **Connect**
+2. Di **Cursor**, masukkan:
+   ```
+   Tell me what's currently selected in Roblox Studio
+   ```
+
+## Pemecahan masalah
+
+### Server MCP tidak muncul
+
+- Pastikan path file konfigurasi sudah benar
+- Pastikan sintaks JSON valid
+- Muat ulang Cursor setelah mengubah konfigurasi
+
+### Server tidak bisa dijalankan
+
+Jalankan server MCP secara langsung untuk memeriksa error:
+
+```bash
+npx -y @weppy/roblox-mcp
+```
+
+### Koneksi gagal
+
+- Pastikan plugin Roblox Studio berada dalam status **Connected**
+- Periksa apakah port 3002 diblokir firewall
+
+## Referensi
+
+- [Dokumentasi Cursor MCP](https://docs.cursor.com/context/model-context-protocol)

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

@@ -39,6 +39,7 @@ MCP server harus sudah terinstal. Selesaikan dulu panduan app AI yang Anda pakai
 |-------------|-------------------|
 | Claude Code | [Cara Konfigurasi](ai-apps/claude-code.md) |
 | Claude Desktop | [Cara Konfigurasi](ai-apps/claude-app.md) |
+| Cursor | [Cara Konfigurasi](ai-apps/cursor.md) |
 | Codex CLI | [Cara Konfigurasi](ai-apps/codex-cli.md) |
 | Codex Desktop | [Cara Konfigurasi](ai-apps/codex-app.md) |
 | Gemini CLI | [Cara Konfigurasi](ai-apps/gemini-cli.md) |

package/docs/id/pro-upgrade.md

@@ -17,28 +17,54 @@ Pro Sync melampaui sekadar export satu arah. Edit script secara lokal dan kirim
 
 Aksi massal dan lanjutan mengurangi panggilan berulang — lakukan lebih banyak per prompt.
 
+### AI yang mengontrol playtest secara langsung
+
+AI dapat mengontrol playtest Roblox Studio secara langsung. AI bisa memulai dan menghentikan Play (F5) atau Run (F8), menyuntikkan script pengujian, mengumpulkan log, dan membuat laporan secara otomatis.
+
+- "Mulai playtest mode Run dan periksa apakah NPC mencapai target."
+- "Tulis test yang memverifikasi SpawnLocation berada di atas tanah lalu jalankan."
+- "Validasi bahwa script yang baru aku ubah berjalan tanpa error di playtest."
+
 ### Kemampuan lanjutan yang lebih luas
 
 Pembuatan terrain, pencarian aset, analisis spasial, animasi, audio, dan otomasi skala produksi.
 
-## Langganan dan unduhan
+## Beli lalu aktifkan
 
-### Langkah 1: Berlangganan di Gumroad
+### Langkah 1: Beli lisensi langganan Pro 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
+3. Salin license key yang kamu terima setelah pembelian
+
+Kamu hanya perlu mengaktifkan lisensi sekali, baik di plugin maupun di dashboard. Keduanya berbagi status lisensi lokal MCP yang sama, jadi saat diaktifkan di satu tempat, status yang sama akan muncul di tempat lainnya.
+
+### Aktifkan di plugin
+
+1. Buka **W-MCP** di Roblox Studio lalu hubungkan ke MCP server.
+2. Buka bagian **Settings > License** di plugin.
+3. Tempel key yang sudah dibeli ke field `License key`.
+4. Klik **Activate** untuk mengaktifkan lisensi.
+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)
+
+### Aktifkan di dashboard
 
-### Langkah 2: Unduh dari GitHub Releases
+1. Jalankan MCP server lalu buka **Settings > License** di dashboard.
+2. Pastikan provider disetel ke `gumroad`.
+3. Tempel key yang sudah dibeli ke field `License Key`.
+4. Klik **Activate License** untuk mengaktifkan lisensi.
+5. Jika perlu, gunakan **Refresh License** untuk mengambil status terbaru.
 
-1. Buka [GitHub Releases](https://github.com/hope1026/weppy-roblox-mcp/releases/latest)
-2. Unduh `weppy-roblox-mcp-v{version}.zip`
-3. Ekstrak lalu salin `roblox-plugin/WeppyRobloxMCP.rbxm` ke folder Plugins Roblox
+![Layar aktivasi lisensi di dashboard](../assets/screenshots/license/license-dashboard.png)
 
-### Langkah 3: Verifikasi
+### Setelah aktivasi
 
-1. Buka W-MCP di Roblox Studio
-2. Pastikan badge Pro terlihat
-3. Jalankan aksi Pro (misalnya: `manage_sync` atau operasi massal)
+- Jika status lisensi tampil sebagai `active` atau `grace`, fitur Pro sudah bisa digunakan.
+- Plugin dan dashboard berbagi status lisensi yang sama, jadi aktivasi di satu tempat akan tercermin di tempat lainnya.
+- Gunakan **Refresh** atau **Refresh License** jika ingin memeriksa status terbaru lagi.
 
 ## Perbandingan Fitur
 
@@ -49,8 +75,6 @@ Pembuatan terrain, pencarian aset, analisis spasial, animasi, audio, dan otomasi
 | 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 |
 | Kontrol Playtest (Putar/Hentikan/Jeda/Lanjutkan) | ❌ | ✅ |

package/docs/ja/README.md

@@ -8,10 +8,28 @@
 
 [![デモ — AIがリアルタイムでRobloxゲームを制作する様子](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
 
-## クイックインストール（5分）
+## クイックインストール
+
+**ワンラインインストール** — MCPサーバー、Roblox Studioプラグイン、AIアプリへの登録を一度に完了します：
+
+```bash
+# macOS / Linux
+curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+
+# Windows (PowerShell)
+irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
+```
+
+Roblox Studioを再起動したら完了です！
+
+WindowsでPowerShellの実行がブロックされる場合は、下の手動インストールに進んでください。ZIPパッケージを使う場合は `setup-plugin.bat` と `setup-mcp.bat` も利用できます。
+
+### 手動インストール
+
+ワンラインインストールが動作しない場合、または環境上自動インストールを使えない場合は、以下の手動インストールを代替手段として進めてください。
 
 **Step 1** — Roblox Studioプラグインのインストール（StudioとAIを接続する橋渡し）:
-[プラグインインストールガイド](../en/installation/roblox-plugin.md)
+[プラグインインストールガイド](installation/roblox-plugin.md)
 
 **Step 2** — AIアプリにMCPサーバーを登録:
 
@@ -21,11 +39,12 @@ 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) |
+| Claude Code | [セットアップ](installation/ai-apps/claude-code.md) |
+| Claude Desktop | [セットアップ](installation/ai-apps/claude-app.md) |
+| Cursor | [セットアップ](installation/ai-apps/cursor.md) |
+| Codex CLI | [セットアップ](installation/ai-apps/codex-cli.md) |
+| Codex Desktop | [セットアップ](installation/ai-apps/codex-app.md) |
+| Gemini CLI | [セットアップ](installation/ai-apps/gemini-cli.md) |
 
 > MCP対応のAIアプリであれば利用できます。サーバーコマンド: `npx -y @weppy/roblox-mcp`
 
@@ -95,11 +114,11 @@ Roblox Studioのインスタンスツリー全体をVSCode内で直接確認で
 
 ## 詳細ドキュメント
 
-- [インストールガイド](../en/installation/README.md)
+- [インストールガイド](installation/README.md)
 - [Tool一覧](tools/overview.md)
 - [Sync機能詳細ガイド](sync/overview.md)
 - [ダッシュボードガイド](dashboard/overview.md)
-- [Roblox Explorer (VSCode拡張)](../en/installation/roblox-explorer.md)
+- [Roblox Explorer (VSCode拡張)](installation/roblox-explorer.md)
 - [互換性](../compatibility.md)
 - [トラブルシューティング](../troubleshooting.md)
 
@@ -116,7 +135,7 @@ Roblox Studioのインスタンスツリー全体をVSCode内で直接確認で
 
 双方向Sync、高度な制作機能、AIトークン効率 — 一度のアップグレードで全てを手に入れる。
 
-[Proアップグレードガイド](../en/pro-upgrade.md)
+[Proアップグレードガイド](pro-upgrade.md)
 
 ---
 

package/docs/ja/installation/README.md

@@ -14,7 +14,29 @@ AIアプリが「青いパーツを作って」と言うと、MCPサーバーが
 
 ---
 
-## ステップ1: Roblox Studioプラグインのインストール
+## ワンラインインストール（推奨）
+
+MCPサーバー、Roblox Studioプラグイン、AIアプリへの登録を一度に完了します：
+
+```bash
+# macOS / Linux
+curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+
+# Windows (PowerShell)
+irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
+```
+
+Roblox Studioを再起動したら完了です！
+
+WindowsでPowerShellの実行がブロックされる場合は、下の手動インストールに進んでください。ZIPパッケージを使う場合は `setup-plugin.bat` と `setup-mcp.bat` を実行できます。
+
+---
+
+## 手動インストール
+
+ワンラインインストールが動作しない場合、または環境上自動インストールを使えない場合に進める代替インストール方法です。
+
+### ステップ1: Roblox Studioプラグインのインストール
 
 GitHubからプラグインファイルをダウンロードして、Roblox StudioのPluginsフォルダに配置します。
 
@@ -22,7 +44,7 @@ GitHubからプラグインファイルをダウンロードして、Roblox Stud
 
 ---
 
-## ステップ2: AIアプリにMCPサーバーを登録
+### ステップ2: AIアプリにMCPサーバーを登録
 
 使用しているAIアプリにMCPサーバーを登録します。MCPをサポートするすべてのAIアプリで使用できます。
 
@@ -30,6 +52,7 @@ GitHubからプラグインファイルをダウンロードして、Roblox Stud
 |---------|---------|
 | Claude Code | [設定手順](ai-apps/claude-code.md) |
 | Claude Desktop | [設定手順](ai-apps/claude-app.md) |
+| Cursor | [設定手順](ai-apps/cursor.md) |
 | Codex CLI | [設定手順](ai-apps/codex-cli.md) |
 | Codex Desktop | [設定手順](ai-apps/codex-app.md) |
 | Gemini CLI | [設定手順](ai-apps/gemini-cli.md) |

package/docs/ja/installation/ai-apps/cursor.md

@@ -0,0 +1,77 @@
+# Cursor セットアップ
+
+[Cursor](https://cursor.com/) で Roblox MCP を使う方法です。
+
+## 前提条件
+
+- **Cursor** がインストール済み
+- **Node.js** (v18.0.0 以上)
+- **Roblox Studio プラグイン** がインストール済み
+
+## MCP サーバー登録
+
+### 方法 1: プロジェクト設定
+
+プロジェクトの `.cursor/mcp.json` に次を追加します。
+
+```json
+{
+  "mcpServers": {
+    "weppy-roblox-mcp": {
+      "command": "npx",
+      "args": ["-y", "@weppy/roblox-mcp"]
+    }
+  }
+}
+```
+
+### 方法 2: グローバル設定
+
+グローバル Cursor MCP 設定ファイルにも同じ内容を追加できます。
+
+**設定ファイルの場所:**
+
+| 範囲 | パス |
+|------|------|
+| プロジェクト | `<project>/.cursor/mcp.json` |
+| グローバル (macOS/Linux) | `~/.cursor/mcp.json` |
+| グローバル (Windows) | `%USERPROFILE%\\.cursor\\mcp.json` |
+
+> 既存ファイルがある場合は、`mcpServers` オブジェクトへ `weppy-roblox-mcp` を追加してください。
+
+### 反映
+
+設定を保存したら Cursor ウィンドウを再読み込みするか、アプリを再起動してください。
+
+## 接続テスト
+
+1. **Roblox Studio** を開く → Plugins タブ → **W-MCP** → **Connect**
+2. **Cursor** で次を入力:
+   ```
+   Tell me what's currently selected in Roblox Studio
+   ```
+
+## トラブルシューティング
+
+### MCP サーバーが表示されない
+
+- 設定ファイルのパスが正しいか確認する
+- JSON 構文が有効か確認する
+- 設定変更後に Cursor を再読み込みしたか確認する
+
+### サーバーが起動しない
+
+直接 MCP サーバーを起動してエラーを確認します。
+
+```bash
+npx -y @weppy/roblox-mcp
+```
+
+### 接続に失敗する
+
+- Roblox Studio プラグインが **Connected** 状態か確認する
+- ポート 3002 がファイアウォールでブロックされていないか確認する
+
+## 参考資料
+
+- [Cursor MCP ドキュメント](https://docs.cursor.com/context/model-context-protocol)

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

@@ -39,6 +39,7 @@ MCPサーバーがインストールされている必要があります。利
 |-------|-------------|
 | Claude Code | [設定方法](ai-apps/claude-code.md) |
 | Claude Desktop | [設定方法](ai-apps/claude-app.md) |
+| Cursor | [設定方法](ai-apps/cursor.md) |
 | Codex CLI | [設定方法](ai-apps/codex-cli.md) |
 | Codex Desktop | [設定方法](ai-apps/codex-app.md) |
 | Gemini CLI | [設定方法](ai-apps/gemini-cli.md) |

package/docs/ja/pro-upgrade.md

@@ -17,28 +17,54 @@ Pro Syncは単方向エクスポートを超えます。ローカルでスクリ
 
 一括/高度なアクションで繰り返し呼び出しを削減 — 1プロンプトでより多くの作業を。
 
+### AIがプレイテストを直接制御
+
+StudioのプレイテストをAIが実行・検証します。F5(Play)/F8(Run)の開始/停止はもちろん、テストスクリプトを注入してログを収集し、レポートまで自動生成します。
+
+- 「Runモードでプレイテストを開始して、NPCが目標地点に到達するか確認して。」
+- 「SpawnLocationが地面の上にあるかテストスクリプトを書いて自動実行して。」
+- 「さっき変更したスクリプトがエラーなく動くかプレイテストで検証して。」
+
 ### より広い高度な機能
 
 地形生成、アセット検索、空間解析、アニメーション、オーディオ、大規模自動化。
 
-## サブスク購入とダウンロード
+## 購入後のアクティベーション
 
 ### ステップ1: GumroadでProサブスクライセンスを購入
 
 1. [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/faccjs?utm_source=github&utm_medium=repo&utm_campaign=pro_upgrade_md) にアクセス
 2. Proサブスクライセンスを購入
+3. 購入後に受け取るライセンスキーをコピー
+
+ライセンスのアクティベーションは、プラグインまたはダッシュボードのどちらか一方で一度行えば十分です。両方の画面は同じMCPローカルライセンス状態を共有するため、片方で有効化するともう片方にも同じ状態が反映されます。
+
+### プラグインで有効化
+
+1. Roblox Studioで **W-MCP** を開き、MCPサーバーに接続します。
+2. プラグインの **Settings > License** セクションを開きます。
+3. `License key` 入力欄に購入したキーを貼り付けます。
+4. **Activate** を押してライセンスを有効化します。
+5. 状態がすぐに更新されない場合は **Refresh** を押して再確認します。
+6. 有効化が完了すると、状態がBasicからProに変わり、Pro機能を使えるようになります。
+
+![プラグインのライセンス有効化画面](../assets/screenshots/license/license-plugin.png)
+
+### ダッシュボードで有効化
 
-### ステップ2: GitHub Releasesからダウンロード
+1. MCPサーバーを起動し、ダッシュボードの **Settings > License** セクションを開きます。
+2. Provider が `gumroad` になっていることを確認します。
+3. `License Key` 入力欄に購入したキーを貼り付けます。
+4. **Activate License** を押してライセンスを有効化します。
+5. 必要に応じて **Refresh License** で最新状態を再取得します。
 
-1. [GitHub Releases](https://github.com/hope1026/weppy-roblox-mcp/releases/latest) を開く
-2. `weppy-roblox-mcp-v{version}.zip` をダウンロード
-3. 解凍して `roblox-plugin/WeppyRobloxMCP.rbxm` を Roblox Plugins フォルダへコピー
+![ダッシュボードのライセンス有効化画面](../assets/screenshots/license/license-dashboard.png)
 
-### ステップ3: 確認
+### 有効化後の確認
 
-1. Roblox StudioでW-MCPを開く
-2. Proバッジが表示されることを確認
-3. Proアクション（例: `manage_sync`、一括操作）を実行
+- ライセンス状態が `active` または `grace` と表示されていれば、Pro機能を利用できます。
+- プラグインとダッシュボードは同じライセンス状態を共有するため、片方で有効化した結果はもう片方にも反映されます。
+- 最新状態を再確認したいときは **Refresh** または **Refresh License** を使ってください。
 
 ## 機能比較
 
@@ -49,8 +75,6 @@ Pro Syncは単方向エクスポートを超えます。ローカルでスクリ
 | Sync方向 | Studio → Local（片方向） | 双方向 |
 | タイプ別Sync Direction | ❌ | ✅ Scripts / Values / Containers / Data / Services |
 | タイプ別Apply Mode | ❌ | ✅ Auto / Manual |
-| Full Sync | ❌ | ✅ |
-| Resync / 状態再構築 | ❌ | ✅ |
 | 変更履歴 | ❌ | ✅ |
 | マルチ Place Sync | ❌ | ✅ 最大3 Place、各Place独立ストレージ |
 | プレイテスト制御（再生/停止/一時停止/再開） | ❌ | ✅ |

package/docs/ko/README.md

@@ -8,10 +8,28 @@
 
 [![데모 — AI가 실시간으로 Roblox 게임을 제작하는 모습](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
 
-## 빠른 설치 (5분)
+## 빠른 설치
+
+**원라인 설치** — MCP 서버, Roblox Studio 플러그인, AI 앱 등록을 한 번에 진행합니다:
+
+```bash
+# macOS / Linux
+curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+
+# Windows (PowerShell)
+irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
+```
+
+Roblox Studio를 재시작하면 완료입니다!
+
+Windows에서 PowerShell 실행이 차단되면 아래 수동 설치로 진행하세요. ZIP 패키지를 사용하는 경우 `setup-plugin.bat`, `setup-mcp.bat`도 사용할 수 있습니다.
+
+### 수동 설치
+
+원라인 설치가 동작하지 않거나 환경상 자동 설치를 사용할 수 없는 경우, 아래 수동 설치를 대안으로 진행하세요.
 
 **1단계** — Roblox Studio 플러그인 설치 (Studio와 AI를 연결하는 다리):
-[플러그인 설치 가이드](../en/installation/roblox-plugin.md)
+[플러그인 설치 가이드](installation/roblox-plugin.md)
 
 **2단계** — AI 앱에 MCP 서버 등록:
 
@@ -21,11 +39,12 @@ 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) |
+| Claude Code | [설정](installation/ai-apps/claude-code.md) |
+| Claude Desktop | [설정](installation/ai-apps/claude-app.md) |
+| Cursor | [설정](installation/ai-apps/cursor.md) |
+| Codex CLI | [설정](installation/ai-apps/codex-cli.md) |
+| Codex Desktop | [설정](installation/ai-apps/codex-app.md) |
+| Gemini CLI | [설정](installation/ai-apps/gemini-cli.md) |
 
 > MCP를 지원하는 모든 AI 앱에서 사용 가능합니다. 서버 명령어: `npx -y @weppy/roblox-mcp`
 
@@ -95,7 +114,7 @@ Roblox Studio의 전체 인스턴스 트리를 VSCode 안에서 바로 확인할
 
 ## 세부 문서
 
-- [설치 가이드](../en/installation/README.md)
+- [설치 가이드](installation/README.md)
 - [Tool 전체 목록](tools/overview.md)
 - [Sync 기능 상세 가이드](sync/overview.md)
 - [대시보드 가이드](dashboard/overview.md)
@@ -116,7 +135,7 @@ Roblox Studio의 전체 인스턴스 트리를 VSCode 안에서 바로 확인할
 
 양방향 Sync, 고급 제작 기능, AI 토큰 효율 — 한 번의 업그레이드로 모두 누리세요.
 
-[Pro 업그레이드 가이드](../en/pro-upgrade.md)
+[Pro 업그레이드 가이드](pro-upgrade.md)
 
 ---