@weppy/roblox-mcp 2.5.1 → 2.6.1

package/docs/ja/installation/ai-apps/codex-cli.md

@@ -1,67 +0,0 @@
-# Codex CLI 設定
-
-[OpenAI Codex CLI](https://github.com/openai/codex) (ターミナルベースのAIコーディングツール)でRoblox MCPを使用する方法です。
-
-## 前提条件
-
-- **Node.js** (v18.0.0以上)
-- **Roblox Studioプラグイン** のインストール完了
-
-## インストール
-
-```bash
-npm install -g @openai/codex
-```
-
-## MCPサーバーの登録
-
-### 方法1: CLIコマンド (推奨)
-
-```bash
-codex mcp add weppy-roblox-mcp -- npx -y @weppy/roblox-mcp
-```
-
-### 方法2: 設定ファイルを直接編集
-
-`~/.codex/config.toml` ファイルに以下の内容を追加してください:
-
-```toml
-[mcp_servers.weppy-roblox-mcp]
-command = "npx"
-args = ["-y", "@weppy/roblox-mcp"]
-```
-
-**設定ファイルの場所:**
-
-| OS | パス |
-|----|------|
-| macOS/Linux | `~/.codex/config.toml` |
-| Windows | `%USERPROFILE%\.codex\config.toml` |
-
-## 接続テスト
-
-1. **Roblox Studio** を起動 → Pluginsタブ → **WEPPY** → **Connect**
-2. **Codex CLI** を起動して以下を入力:
-   ```
-   Roblox Studioで現在選択されているものを教えて
-   ```
-
-## トラブルシューティング
-
-### サーバーが起動しない場合
-
-MCPサーバーを直接実行してエラーを確認してください:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### 接続失敗
-
-- Roblox Studioプラグインが **Connected** 状態か確認
-- ポート3002がファイアウォールでブロックされていないか確認
-
-## 参考資料
-
-- [Codex CLI GitHub](https://github.com/openai/codex)
-- [Codex MCP公式ドキュメント](https://developers.openai.com/codex/mcp/)
-- [Codex設定リファレンス](https://developers.openai.com/codex/config-reference/)

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

@@ -1,77 +0,0 @@
-# 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 タブ → **WEPPY** → **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/ai-apps/gemini-cli.md

@@ -1,120 +0,0 @@
-# Gemini CLI セットアップ
-
-[Google Gemini CLI](https://github.com/google-gemini/gemini-cli)でRoblox MCPを使用する方法です。
-
-## 前提条件
-
-1. **Node.js** (v18.0.0以上)
-   ```bash
-   node --version
-   ```
-
-2. **Gemini CLI** インストール済み
-   ```bash
-   npm install -g @google/gemini-cli
-   ```
-
-3. **Roblox Studioプラグイン** インストール完了
-
-## MCPサーバーの登録
-
-### 方法1: CLIコマンド（推奨）
-
-ターミナルで1行で登録できます：
-
-```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`ファイルに以下の内容を追加してください：
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-**設定ファイルの場所:**
-| スコープ | パス |
-|----------|------|
-| プロジェクト | `<プロジェクト>/.gemini/settings.json` |
-| グローバル | `~/.gemini/settings.json` |
-
-### 方法3: 環境変数の使用
-
-特定の環境変数が必要な場合：
-
-**CLI:**
-```bash
-gemini mcp add weppy-roblox-mcp npx --trust -e HTTP_PORT=3002 -- -y @weppy/roblox-mcp
-```
-
-**設定ファイル:**
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "env": {
-        "HTTP_PORT": "3002"
-      }
-    }
-  }
-}
-```
-
-## 接続テスト
-
-1. **Roblox Studio**を起動 → Pluginsタブ → **WEPPY** → **Connect**
-2. **Gemini CLI**を実行して次のように入力：
-   ```
-   Roblox Studioで現在選択されているものを教えて
-   ```
-
-## MCPサーバーの状態確認
-
-Gemini CLI内で`/mcp`コマンドを使用して、接続されたサーバーの状態を確認できます：
-
-```
-/mcp
-```
-
-## トラブルシューティング
-
-### サーバーが起動しない場合
-
-MCPサーバーを直接実行してエラーを確認してください：
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### 接続失敗
-
-- Roblox Studioプラグインが**Connected**状態であることを確認
-- ポート3002がファイアウォールでブロックされていないか確認
-- `/mcp`コマンドでサーバーの状態を確認
-
-### ツールの競合
-
-複数のMCPサーバーに同じ名前のツールがある場合、`serverAlias__toolName`形式でプレフィックスが付けられます。
-
-## 参考資料
-
-- [Gemini CLI MCP公式ドキュメント](https://geminicli.com/docs/tools/mcp-server/)
-- [Gemini CLI設定ガイド](https://geminicli.com/docs/get-started/configuration/)

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

@@ -1,58 +0,0 @@
-# WEPPY Roblox Explorer (VSCode拡張)
-
-Roblox StudioのExplorerと同じインスタンスツリーをVSCodeで表示できる拡張機能です。同期済みインスタンスの探索、スクリプトの直接開封、Sync状態の確認をエディタ内で行えます。
-この拡張はWEPPY用のcompanion拡張であり、単体のRoblox連携ツールではありません。
-
-![WEPPY Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
-
-## 要件
-
-- VSCode 1.85+
-- [Roblox MCP](../../../README.md) をインストールし、Syncを有効化 (BasicまたはPro)
-- プロジェクトルート配下に Sync により `weppy-project-sync/place_*/.sync-meta.json` が生成済みであること
-
-## インストール方法
-
-VSCode Extensionsサイドバー（`Ctrl+Shift+X` / `Cmd+Shift+X`）で **WEPPY Roblox Explorer** を検索し、**Install** をクリックします。
-
-または次のマーケットプレイスから直接インストールできます。
-
-- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
-- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
-
-基本のツリー閲覧はディスク上のsyncファイルだけで動作します。ローカルMCPサーバーに接続できる場合は、live sync状態、direction表示、Explorerテレメトリ転送も利用できます。
-
-## 機能
-
-- **インスタンスツリー**: Roblox Studioと同一のサービス/インスタンス階層
-- **Robloxクラスアイコン**: 200以上のクラスアイコン（ダーク/ライトテーマ対応）
-- **マルチPlace**: 同期済みPlaceごとにツリールートを分離
-- **クリックでファイルを開く**: `.server.luau`、`.client.luau`、`.module.luau`、`.props.json`などを直接開く
-- **インスタンス検索**: 全サービスにわたるQuickPick検索
-- **Sync状態バッジ**: `modified`、`studio`、`conflict`の状態を一目で確認
-- **自動更新**: Syncファイルの変更時にツリーを自動更新（500msデバウンス）
-- **インスタンスパスコピー**: 右クリックで`game.Workspace.Part`形式のパスをコピー
-
-## 設定
-
-| 設定 | デフォルト | 説明 |
-|------|-----------|------|
-| `robloxExplorer.syncRoot` | `""` | `weppy-project-sync` ルートの絶対パス。空の場合は自動検出します。WEPPY は `{projectRoot}/weppy-project-sync` を使います。 |
-| `robloxExplorer.hidePropsFiles` | `false` | デフォルトのVSCodeエクスプローラーでSyncファイル（`.props.json`、`_tree.json`、`.value.json`）を非表示にする。 |
-| `robloxExplorer.autoRefresh` | `true` | Syncファイルの変更時にツリーを自動更新する。 |
-| `robloxExplorer.showSyncStatus` | `true` | ツリー項目にSync状態のデコレーションを表示する。 |
-
-## コマンド
-
-| コマンド | 説明 |
-|---------|------|
-| `WEPPY Explorer: Refresh` | インスタンスツリーを手動で更新 |
-| `WEPPY Explorer: Search Instances` | 全サービスでインスタンスを検索 |
-| `WEPPY Explorer: Open Backing File` | 選択したインスタンスのファイルを開く |
-| `WEPPY Explorer: Copy Instance Path` | 完全なインスタンスパスをコピー（例: `game.Workspace.Part`） |
-| `WEPPY Explorer: Reveal in Explorer` | デフォルトのVSCodeエクスプローラーでファイルを表示 |
-
-## 関連ドキュメント
-
-- [Sync詳細ガイド](../sync/overview.md)
-- [インストールガイド](README.md)

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

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

package/docs/ja/pro-upgrade.md

@@ -1,96 +0,0 @@
-# Proアップグレードガイド
-
-## なぜProか？
-
-### 実際の開発ワークフローのための双方向Sync
-
-Pro Syncは単方向エクスポートを超えます。ローカルでスクリプトを編集してStudioに反映。Studioで変更してローカルに取り込む。Proが両側を常に同期します。
-
-- **双方向Sync** — StudioとローカルファイルのSyncが双方向で変更を反映します。
-- **タイプ別Direction** — Scripts、Values、Containers、Data、Servicesをそれぞれ独立して設定。
-- **タイプ別Apply Mode** — タイプごとにAutoまたはManualを選択し、速度と制御のバランスを調整。
-- **Full Sync / Resync** — 大規模変更や再接続後に即座にクリーンなプロジェクト状態を再構築。
-- **変更履歴** — 適用前に何が、いつ、どの方向に変更されたかを追跡。
-- **マルチ Place Sync** — 最大3つのRoblox Placeを同時にSync。各Placeは独立したストレージと変更履歴を持ちます。
-
-### 高効率ワークフローでAIトークンを節約
-
-一括/高度なアクションで繰り返し呼び出しを削減 — 1プロンプトでより多くの作業を。
-
-### AIがプレイテストを直接制御
-
-StudioのプレイテストをAIが実行・検証します。F5(Play)/F8(Run)の開始/停止はもちろん、テストスクリプトを注入してログを収集し、レポートまで自動生成します。
-
-- 「Runモードでプレイテストを開始して、NPCが目標地点に到達するか確認して。」
-- 「SpawnLocationが地面の上にあるかテストスクリプトを書いて自動実行して。」
-- 「さっき変更したスクリプトがエラーなく動くかプレイテストで検証して。」
-
-### Pro専用の追加機能
-
-Proはコアワークフローを超え、さらに多くの機能を利用できます。
-
-- **一括操作** — 1回のリクエストで複数インスタンスを作成・変更・削除
-- **地形生成** — ブロック、ボール、シリンダー、ウェッジの充填とマテリアル置換
-- **アセット検索/挿入** — Robloxマーケットからアセットを検索し直接挿入
-- **空間分析** — レイキャスト、地面検出、平地探索、衝突判定
-- **環境制御** — ライティング、大気、スカイ、時間帯の設定
-- **オーディオ/アニメーション** — サウンド再生とアニメーションのロード/再生
-
-## 購入後のアクティベーション
-
-### ステップ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で **WEPPY** を開き、MCPサーバーに接続します。
-2. プラグインの **Settings > License** セクションを開きます。
-3. `License key` 入力欄に購入したキーを貼り付けます。
-4. **Activate** を押してライセンスを有効化します。
-5. 状態がすぐに更新されない場合は **Refresh** を押して再確認します。
-6. 有効化が完了すると、状態がBasicからProに変わり、Pro機能を使えるようになります。
-
-![プラグインのライセンス有効化画面](../assets/screenshots/plugin/license/plugin-license-screen.png)
-
-### ダッシュボードで有効化
-
-1. MCPサーバーを起動し、ダッシュボードの **Settings > License** セクションを開きます。
-2. Provider が `gumroad` になっていることを確認します。
-3. `License Key` 入力欄に購入したキーを貼り付けます。
-4. **Activate License** を押してライセンスを有効化します。
-5. 必要に応じて **Refresh License** で最新状態を再取得します。
-
-![ダッシュボードのライセンス有効化画面](../assets/screenshots/plugin/license/dashboard-license-screen.png)
-
-### 有効化後の確認
-
-- ライセンス状態が `active` または `grace` と表示されていれば、Pro機能を利用できます。
-- プラグインとダッシュボードは同じライセンス状態を共有するため、片方で有効化した結果はもう片方にも反映されます。
-- 最新状態を再確認したいときは **Refresh** または **Refresh License** を使ってください。
-
-## 機能比較
-
-| 機能 | Basic | Pro |
-|-----|:-----:|:---:|
-| スクリプト作成/編集 | ✅ | ✅ |
-| インスタンス作成/削除/移動 | ✅ | ✅ + 一括操作 |
-| プロパティ読み取り/変更 | ✅ | ✅ + 一括変更 |
-| 選択、タグ、検索 | ✅ | ✅ |
-| カメラ制御 | ✅ | ✅ |
-| ログ監視 | ✅ | ✅ |
-| Luauコード実行 | ✅ | ✅ |
-| プロジェクト同期 | Studio → Local 片方向 | 双方向 + タイプ別方向/モード設定 |
-| マルチ Place Sync | — | 最大3 Place同時Sync |
-| 変更履歴 | — | 適用前の変更内容追跡 |
-| プレイテスト制御 | — | 再生 / 停止 / 一時停止 / 再開 + 自動テスト |
-| 地形生成/編集 | — | ブロック、ボール、シリンダー、ウェッジ、マテリアル置換 |
-| アセット検索/挿入 | — | Robloxマーケットから検索して直接挿入 |
-| 空間分析 | — | レイキャスト、地面検出、衝突判定 |
-| 環境制御 | — | ライティング、大気、スカイ、時間帯 |
-| オーディオ / アニメーション | — | サウンド再生、アニメーションロード/再生 |
-| AIトークン効率 | 個別アクション | 一括アクションで呼び出し回数削減 |

package/docs/ja/sync/luau-lsp.md

@@ -1,41 +0,0 @@
-# WEPPY Sync で `luau-lsp` を使う
-
-WEPPY Sync は `luau-lsp` が必要とする sourcemap ファイルを自動生成できるため、別の Rojo プロジェクトを用意しなくても Roblox 対応のエディタ機能を利用できます。
-
-## WEPPY が書き出すファイル
-
-Full Sync が完了すると、WEPPY は次のファイルを書き出します。
-
-- Place sourcemap: `weppy-project-sync/place_<id>/sourcemap.json`
-- ルート代表ファイル: `weppy-project-sync/sourcemap.json`
-
-ほとんどのユーザーには `weppy-project-sync/sourcemap.json` の利用を推奨します。
-
-## 何が改善されるか
-
-`luau-lsp` が WEPPY sourcemap を読むと、次の点が改善されます。
-
-- `game.*` の補完
-- 同期済みスクリプト間のナビゲーション
-- 同期済みスクリプト同士の `require` 解決
-
-## 推奨セットアップ
-
-1. WEPPY が `weppy-project-sync/sourcemap.json` を生成できるように、まず Full Sync を 1 回実行します。
-2. エディタの `luau-lsp` sourcemap 設定で `weppy-project-sync/sourcemap.json` を指定します。
-3. 利用中のクライアントで自動 Rojo 生成を無効にできる場合は、`luau-lsp.sourcemap.autogenerate` を `false` に設定します。
-
-VSCode 設定例:
-
-```json
-{
-  "luau-lsp.sourcemap.enabled": true,
-  "luau-lsp.sourcemap.autogenerate": false,
-  "luau-lsp.sourcemap.sourcemapFile": "weppy-project-sync/sourcemap.json"
-}
-```
-
-## Multi-place メモ
-
-`weppy-project-sync/sourcemap.json` は、プロジェクトの現在の代表 place に追従します。
-特定の place に固定したい場合は、その place の `weppy-project-sync/place_<id>/sourcemap.json` を `luau-lsp` から直接指定してください。