@weppy/roblox-mcp 0.1.10 → 1.0.0

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アプリを再起動

package/docs/ja/pro-upgrade.md

@@ -1,51 +1,57 @@
 # Proアップグレードガイド
 
-## なぜProなのか？
+## なぜProか？
 
-**AIトークンの節約** - 1つの一括操作コマンドが数十の個別操作を置き換えます。繰り返し作業が減り、トークン使用量が削減され、結果も速くなります。
+### 実際の開発ワークフローのための双方向Sync
 
-**完成度の高いゲーム** - 地形、環境、アセット、空間ツールでプロトタイプではなく完成されたゲームワールドを作成できます。
+Pro Syncは単方向エクスポートを超えます。ローカルでスクリプトを編集してStudioに反映。Studioで変更してローカルに取り込む。Proが両側を常に同期します。
 
-## Proが追加するツール
+- **双方向Sync** — StudioとローカルファイルのSyncが双方向で変更を反映します。
+- **タイプ別Direction** — Scripts、Values、Containers、Data、Servicesをそれぞれ独立して設定。
+- **タイプ別Apply Mode** — タイプごとにAutoまたはManualを選択し、速度と制御のバランスを調整。
+- **Full Sync / Resync** — 大規模変更や再接続後に即座にクリーンなプロジェクト状態を再構築。
+- **変更履歴** — 適用前に何が、いつ、どの方向に変更されたかを追跡。
+- **マルチ Place Sync** — 最大3つのRoblox Placeを同時にSync。各Placeは独立したストレージと変更履歴を持ちます。
 
-| カテゴリ | 機能 |
-|---------|------|
-| **一括操作** | 1つのコマンドで木を100本生成。すべてのパーツを同時に修正。 |
-| **地形生成** | 山、洞窟、風景を手続き的に生成。 |
-| **アセット管理** | Creator Store検索後、モデルを直接挿入。 |
-| **レイキャスト** | スポーン位置の検出、衝突検出、移動可能エリアの分析。 |
-| **環境制御** | ライティング、大気、空、時間帯の設定。 |
-| **可視化** | エリア表示、マーカー作成、ゾーンハイライト。 |
+### 高効率ワークフローでAIトークンを節約
 
-## 購入方法
+一括/高度なアクションで繰り返し呼び出しを削減 — 1プロンプトでより多くの作業を。
 
-### ステップ1: Gumroadで購入
+### より広い高度な機能
 
-1. [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin) にアクセス
-2. プラグインをダウンロード
+地形生成、アセット検索、空間解析、アニメーション、オーディオ、大規模自動化。
 
-### ステップ2: プラグインのインストール
+## サブスク購入とダウンロード
 
-1. Roblox Studioを起動
-2. Pluginsタブ → **Plugins Folder** をクリック
-3. 既存の `WeppyRobloxMCP.rbxm` (Basicバージョン) を**削除**
-4. ダウンロードした `WeppyRobloxMCP-Pro.rbxm` をフォルダに**コピー**
-5. Roblox Studioを再起動
+### ステップ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サブスクライセンスを購入
+
+### ステップ2: GitHub Releasesからダウンロード
+
+1. [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest) を開く
+2. `weppy-roblox-mcp-v{version}.zip` をダウンロード
+3. 解凍して `roblox-plugin/WeppyRobloxMCP.rbxm` を Roblox Plugins フォルダへコピー
 
 ### ステップ3: 確認
 
-1. W-MCPプラグインを開く
-2. "Pro" バッジが表示されているか確認
-3. すべてのツールが使用可能！
+1. Roblox StudioでW-MCPを開く
+2. Proバッジが表示されることを確認
+3. Proアクション（例: `manage_sync`、一括操作）を実行
 
 ## 機能比較
 
 | 機能 | Basic | Pro |
 |-----|:-----:|:---:|
-| Instance, Script, Property | ✅ 全機能利用可能 | ✅ 全機能利用可能 |
-| Selection, Tag, Camera, Log | ✅ 全機能利用可能 | ✅ 全機能利用可能 |
-| 一括操作 (Bulk) | ― | ✅ 無制限 |
-| アセット検索・挿入 | ― | ✅ 無制限 |
-| 地形生成 (Terrain) | ― | ✅ 無制限 |
-| 環境、レイキャスト、空間 | ― | ✅ 無制限 |
-| 可視化ツール | ― | ✅ 無制限 |
+| Script、Instance、Property管理 | ✅ フル利用可 | ✅ フル利用可 |
+| Selection、Tag、Camera、Log | ✅ フル利用可 | ✅ フル利用可 |
+| Sync方向 | Studio → Local（片方向） | 双方向 |
+| タイプ別Sync Direction | ❌ | ✅ Scripts / Values / Containers / Data / Services |
+| タイプ別Apply Mode | ❌ | ✅ Auto / Manual |
+| Full Sync | ❌ | ✅ |
+| Resync / 状態再構築 | ❌ | ✅ |
+| 変更履歴 | ❌ | ✅ |
+| マルチ Place Sync | ❌ | ✅ 最大3 Place、各Place独立ストレージ |
+| 高度ツール範囲 | コア範囲 | より広い高度範囲 |
+| AIトークン効率 | 標準 | 一括/高効率アクションで有利 |

package/docs/ja/tools/overview.md

@@ -2,6 +2,10 @@
 
 AIとRoblox Studioを接続して、さまざまな作業を自動化できます。カテゴリ別にどんなことができるかを紹介します。
 
+Syncポリシー:
+- Basic: Studio -> Local（片方向）
+- Pro: 双方向Sync + より広い高度機能（バルク操作でAIトークン効率向上）
+
 ---
 
 ## Basic（無料）

package/docs/ko/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/ko/installation/ai-apps/gemini-cli.md

@@ -18,7 +18,23 @@
 
 ## MCP 서버 등록
 
-### 방법 1: 설정 파일 편집 (권장)
+### 방법 1: CLI 명령어 (권장)
+
+터미널에서 한 줄로 등록할 수 있습니다:
+
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -- -y @weppy/roblox-mcp
+```
+
+> `--trust` 플래그는 도구 호출 시 매번 확인 프롬프트를 건너뜁니다.
+
+글로벌 설정으로 등록하려면 `-s user`를 추가하세요:
+
+```bash
+gemini mcp add weppy-roblox-mcp npx -s user --trust -- -y @weppy/roblox-mcp
+```
+
+### 방법 2: 설정 파일 편집
 
 `.gemini/settings.json` 파일에 아래 내용을 추가하세요:
 
@@ -39,10 +55,16 @@
 | 프로젝트 | `<프로젝트>/.gemini/settings.json` |
 | 글로벌 | `~/.gemini/settings.json` |
 
-### 방법 2: 환경 변수 사용
+### 방법 3: 환경 변수 사용
 
 특정 환경 변수가 필요한 경우:
 
+**CLI:**
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -e MCP_PORT=3002 -- -y @weppy/roblox-mcp
+```
+
+**설정 파일:**
 ```json
 {
   "mcpServers": {
@@ -73,35 +95,6 @@ Gemini CLI 내에서 `/mcp` 명령으로 연결된 서버 상태를 확인할
 /mcp
 ```
 
-## 고급 설정
-
-### 도구 필터링
-
-특정 도구만 사용하거나 제외할 수 있습니다:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "excludeTools": ["execute_script"],
-      "includeTools": ["get_selection", "create_instance", "set_property"]
-    }
-  }
-}
-```
-
-> `excludeTools`가 `includeTools`보다 우선합니다.
-
-### 디버그 모드
-
-연결 문제를 디버깅하려면:
-
-```bash
-gemini --debug
-```
-
 ## 문제 해결
 
 ### 서버가 시작되지 않을 때

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

@@ -4,8 +4,13 @@ Roblox Studio에서 AI 에이전트와 연결하기 위한 플러그인 설치
 
 ## 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{버전}.zip` 다운로드
+3. ZIP 압축 해제 - `roblox-plugin/WeppyRobloxMCP.rbxm` 파일과 설치 가이드 포함
+
+참고:
+- Basic은 동일한 플러그인 패키지를 설치하고 Basic 정책(Studio -> Local 단방향 Sync)으로 동작합니다.
+- Pro 구독 라이선스 활성화 시 양방향 Sync와 더 넓은 고급 Tool 기능을 사용할 수 있습니다.
 
 ## 2. 플러그인 설치
 
@@ -42,9 +47,9 @@ MCP 서버가 설치되어 있어야 합니다. 사용하는 AI 앱에 맞는
 ### 연결하기
 
 1. **Roblox Studio**에서 아무 프로젝트를 엽니다
-2. 상단 **Plugins** 탭 → **W-MCP** 클릭
+2. 상단 **Plugins** 탭 -> **W-MCP** 클릭
 3. 플러그인 창에서 **Connect** 버튼 클릭
-4. **"Connected"** 상태가 표시되면 연결 완료!
+4. **"Connected"** 상태가 표시되면 연결 완료
 
 ![플러그인 메인 화면](../../assets/screenshots/plugin_main.png)
 
@@ -76,4 +81,4 @@ MCP 서버가 설치되어 있어야 합니다. 사용하는 AI 앱에 맞는
 ### 연결이 자주 끊어져요
 
 - 설정에서 **자동 재연결** 옵션 활성화
-- AI 앱을 재시작해보세요
+- AI 앱을 재시작

package/docs/ko/pro-upgrade.md

@@ -2,50 +2,56 @@
 
 ## 왜 Pro인가?
 
-**AI 토큰 절약** - 하나의 대량 작업 명령이 수십 개의 개별 작업을 대체합니다. 반복 작업이 줄어 토큰 사용량이 감소하고 결과도 빨라집니다.
+### 실제 개발 워크플로우를 위한 양방향 Sync
 
-**완성도 높은 게임** - 지형, 환경, 에셋, 공간 도구로 프로토타입이 아닌 완성된 게임 월드를 만들 수 있습니다.
+Pro Sync는 단방향 내보내기를 넘어섭니다. 로컬에서 스크립트를 편집하고 Studio에 반영하세요. Studio에서 변경하고 로컬로 가져오세요. Pro는 양쪽을 항상 동기화합니다.
 
-## Pro가 추가하는 도구
+- **양방향 Sync** — Studio와 로컬 파일 간 양방향으로 변경사항이 흐릅니다.
+- **타입별 Direction** — Scripts, Values, Containers, Data, Services를 각각 독립적으로 방향 설정.
+- **타입별 Apply Mode** — 타입별로 Auto 또는 Manual을 선택하여 속도와 제어를 균형있게.
+- **Full Sync / Resync** — 대규모 변경이나 재연결 후 즉시 깨끗한 프로젝트 상태를 재구축.
+- **변경 기록** — 적용 전에 무엇이, 언제, 어느 방향으로 변경됐는지 추적.
+- **멀티 Place Sync** — 최대 3개의 Roblox Place를 동시에 Sync하며, 각 Place마다 독립된 저장소와 변경 기록을 유지합니다.
 
-| 카테고리 | 기능 |
-|---------|------|
-| **대량 작업** | 한 번의 명령으로 나무 100개 생성. 모든 파트를 동시에 수정. |
-| **지형 생성** | 산, 동굴, 풍경을 절차적으로 생성. |
-| **에셋 관리** | Creator Store 검색 후 모델 직접 삽입. |
-| **레이캐스트** | 스폰 위치 찾기, 충돌 감지, 이동 가능 영역 분석. |
-| **환경 제어** | 조명, 대기, 하늘, 시간대 설정. |
-| **시각화** | 영역 표시, 마커 생성, 구역 하이라이트. |
+### 고효율 워크플로우로 AI 토큰 절약
 
-## 구매 방법
+대량 및 고급 작업으로 반복 호출을 줄여 프롬프트 한 번에 더 많은 작업을 처리합니다.
 
-### 1단계: Gumroad에서 구매
+### 더 넓은 고급 기능
 
-1. [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin) 접속
-2. 플러그인 다운로드
+지형 생성, 에셋 검색, 공간 분석, 애니메이션, 오디오, 대규모 자동화.
 
-### 2단계: 플러그인 설치
+## 구독 및 다운로드
 
-1. Roblox Studio 실행
-2. Plugins 탭 → **Plugins Folder** 클릭
-3. 기존 `WeppyRobloxMCP.rbxm` (Basic 버전) **삭제**
-4. 다운로드한 `WeppyRobloxMCP-Pro.rbxm` 폴더에 **복사**
-5. Roblox Studio 재시작
+### 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 구독 라이선스 구매 완료
+
+### 2단계: GitHub Releases에서 다운로드
+
+1. [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest) 열기
+2. `weppy-roblox-mcp-v{version}.zip` 다운로드
+3. 압축 해제 후 `roblox-plugin/WeppyRobloxMCP.rbxm`를 Roblox Plugins 폴더에 복사
 
 ### 3단계: 확인
 
-1. W-MCP 플러그인 열기
-2. "Pro" 배지가 표시되는지 확인
-3. 모든 도구 사용 가능!
+1. Roblox Studio에서 W-MCP 열기
+2. Pro 배지가 표시되는지 확인
+3. Pro action(예: `manage_sync`, 대량 작업) 실행 확인
 
 ## 기능 비교
 
 | 기능 | Basic | Pro |
 |-----|:-----:|:---:|
-| Instance, Script, Property | ✅ 전체 사용 | ✅ 전체 사용 |
+| Script, Instance, Property 관리 | ✅ 전체 사용 | ✅ 전체 사용 |
 | Selection, Tag, Camera, Log | ✅ 전체 사용 | ✅ 전체 사용 |
-| 대량 작업 (Bulk) | ― | ✅ 무제한 |
-| 에셋 검색 및 삽입 | ― | ✅ 무제한 |
-| 지형 생성 (Terrain) | ― | ✅ 무제한 |
-| 환경, 레이캐스트, 공간 | ― | ✅ 무제한 |
-| 시각화 도구 | ― | ✅ 무제한 |
+| Sync 방향 | Studio → Local (단방향) | 양방향 |
+| 타입별 Sync Direction | ❌ | ✅ Scripts / Values / Containers / Data / Services |
+| 타입별 Apply Mode | ❌ | ✅ Auto / Manual |
+| Full Sync | ❌ | ✅ |
+| Resync / 상태 재구축 | ❌ | ✅ |
+| 변경 기록 | ❌ | ✅ |
+| 멀티 Place Sync | ❌ | ✅ 최대 3개 Place, 각각 독립 저장소 |
+| 고급 Tool 범위 | 기본 범위 | 더 넓은 고급 범위 |
+| AI 토큰 효율 | 기본 | 대량/고효율 action으로 더 유리 |