@weppy/roblox-mcp 2.4.1 → 2.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +2 -2
- package/.github/workflows/install-test.yml +2 -21
- package/CHANGELOG.md +22 -5
- package/COMMERCIAL-LICENSE.md +1 -1
- package/README.md +11 -11
- package/TRADEMARKS.md +1 -1
- package/docs/en/dashboard/changelog.md +1 -1
- package/docs/en/dashboard/connection.md +1 -1
- package/docs/en/dashboard/overview.md +1 -1
- package/docs/en/dashboard/playtest.md +1 -1
- package/docs/en/dashboard/settings.md +1 -1
- package/docs/en/dashboard/sync.md +1 -1
- package/docs/en/dashboard/tools.md +1 -1
- package/docs/en/installation/README.md +4 -4
- package/docs/en/installation/ai-apps/antigravity.md +1 -1
- package/docs/en/installation/ai-apps/claude-app.md +1 -1
- package/docs/en/installation/ai-apps/claude-code.md +1 -1
- package/docs/en/installation/ai-apps/codex-app.md +1 -1
- package/docs/en/installation/ai-apps/codex-cli.md +1 -1
- package/docs/en/installation/ai-apps/cursor.md +1 -1
- package/docs/en/installation/ai-apps/gemini-cli.md +1 -1
- package/docs/en/installation/roblox-explorer.md +12 -12
- package/docs/en/installation/roblox-plugin.md +5 -5
- package/docs/en/pro-upgrade.md +3 -3
- package/docs/en/sync/luau-lsp.md +13 -13
- package/docs/en/sync/overview.md +8 -8
- package/docs/en/tools/overview.md +1 -1
- package/docs/en/tools/playtest.md +2 -2
- package/docs/es/README.md +10 -10
- package/docs/es/dashboard/changelog.md +1 -1
- package/docs/es/dashboard/connection.md +1 -1
- package/docs/es/dashboard/overview.md +1 -1
- package/docs/es/dashboard/playtest.md +1 -1
- package/docs/es/dashboard/settings.md +1 -1
- package/docs/es/dashboard/sync.md +1 -1
- package/docs/es/dashboard/tools.md +1 -1
- package/docs/es/installation/README.md +3 -3
- package/docs/es/installation/ai-apps/antigravity.md +1 -1
- package/docs/es/installation/ai-apps/claude-app.md +1 -1
- package/docs/es/installation/ai-apps/claude-code.md +1 -1
- package/docs/es/installation/ai-apps/codex-app.md +1 -1
- package/docs/es/installation/ai-apps/codex-cli.md +1 -1
- package/docs/es/installation/ai-apps/cursor.md +1 -1
- package/docs/es/installation/ai-apps/gemini-cli.md +1 -1
- package/docs/es/installation/roblox-explorer.md +11 -11
- package/docs/es/installation/roblox-plugin.md +3 -3
- package/docs/es/pro-upgrade.md +1 -1
- package/docs/es/sync/luau-lsp.md +13 -13
- package/docs/es/sync/overview.md +8 -8
- package/docs/es/tools/overview.md +1 -1
- package/docs/es/tools/playtest.md +2 -2
- package/docs/id/README.md +10 -10
- package/docs/id/dashboard/changelog.md +1 -1
- package/docs/id/dashboard/connection.md +1 -1
- package/docs/id/dashboard/overview.md +1 -1
- package/docs/id/dashboard/playtest.md +1 -1
- package/docs/id/dashboard/settings.md +1 -1
- package/docs/id/dashboard/sync.md +1 -1
- package/docs/id/dashboard/tools.md +1 -1
- package/docs/id/installation/README.md +4 -4
- package/docs/id/installation/ai-apps/antigravity.md +1 -1
- package/docs/id/installation/ai-apps/claude-app.md +1 -1
- package/docs/id/installation/ai-apps/claude-code.md +1 -1
- package/docs/id/installation/ai-apps/codex-app.md +1 -1
- package/docs/id/installation/ai-apps/codex-cli.md +1 -1
- package/docs/id/installation/ai-apps/cursor.md +1 -1
- package/docs/id/installation/ai-apps/gemini-cli.md +1 -1
- package/docs/id/installation/roblox-explorer.md +11 -11
- package/docs/id/installation/roblox-plugin.md +3 -3
- package/docs/id/pro-upgrade.md +1 -1
- package/docs/id/sync/luau-lsp.md +13 -13
- package/docs/id/sync/overview.md +8 -8
- package/docs/id/tools/overview.md +1 -1
- package/docs/id/tools/playtest.md +2 -2
- package/docs/installer/assets/index-Bz0amd7x.js +2 -2
- package/docs/installer/index.html +1 -1
- package/docs/installer/manifest.webmanifest +3 -3
- package/docs/ja/README.md +10 -10
- package/docs/ja/installation/README.md +4 -4
- package/docs/ja/installation/ai-apps/antigravity.md +1 -1
- package/docs/ja/installation/ai-apps/claude-app.md +1 -1
- package/docs/ja/installation/ai-apps/claude-code.md +1 -1
- package/docs/ja/installation/ai-apps/codex-app.md +1 -1
- package/docs/ja/installation/ai-apps/codex-cli.md +1 -1
- package/docs/ja/installation/ai-apps/cursor.md +1 -1
- package/docs/ja/installation/ai-apps/gemini-cli.md +1 -1
- package/docs/ja/installation/roblox-explorer.md +11 -11
- package/docs/ja/installation/roblox-plugin.md +3 -3
- package/docs/ja/pro-upgrade.md +1 -1
- package/docs/ja/sync/luau-lsp.md +13 -13
- package/docs/ja/sync/overview.md +8 -8
- package/docs/ja/tools/overview.md +1 -1
- package/docs/ja/tools/playtest.md +2 -2
- package/docs/ko/README.md +10 -10
- package/docs/ko/installation/README.md +4 -4
- package/docs/ko/installation/ai-apps/antigravity.md +1 -1
- package/docs/ko/installation/ai-apps/claude-app.md +1 -1
- package/docs/ko/installation/ai-apps/claude-code.md +1 -1
- package/docs/ko/installation/ai-apps/codex-app.md +1 -1
- package/docs/ko/installation/ai-apps/codex-cli.md +1 -1
- package/docs/ko/installation/ai-apps/cursor.md +1 -1
- package/docs/ko/installation/ai-apps/gemini-cli.md +1 -1
- package/docs/ko/installation/roblox-explorer.md +12 -12
- package/docs/ko/installation/roblox-plugin.md +5 -5
- package/docs/ko/pro-upgrade.md +1 -1
- package/docs/ko/sync/luau-lsp.md +13 -13
- package/docs/ko/sync/overview.md +8 -8
- package/docs/ko/tools/overview.md +1 -1
- package/docs/ko/tools/playtest.md +2 -2
- package/docs/pt-br/README.md +11 -11
- package/docs/pt-br/dashboard/changelog.md +1 -1
- package/docs/pt-br/dashboard/connection.md +1 -1
- package/docs/pt-br/dashboard/overview.md +1 -1
- package/docs/pt-br/dashboard/playtest.md +1 -1
- package/docs/pt-br/dashboard/settings.md +1 -1
- package/docs/pt-br/dashboard/sync.md +1 -1
- package/docs/pt-br/dashboard/tools.md +1 -1
- package/docs/pt-br/installation/README.md +4 -4
- package/docs/pt-br/installation/ai-apps/antigravity.md +1 -1
- package/docs/pt-br/installation/ai-apps/claude-app.md +1 -1
- package/docs/pt-br/installation/ai-apps/claude-code.md +1 -1
- package/docs/pt-br/installation/ai-apps/codex-app.md +1 -1
- package/docs/pt-br/installation/ai-apps/codex-cli.md +1 -1
- package/docs/pt-br/installation/ai-apps/cursor.md +1 -1
- package/docs/pt-br/installation/ai-apps/gemini-cli.md +1 -1
- package/docs/pt-br/installation/roblox-explorer.md +11 -11
- package/docs/pt-br/installation/roblox-plugin.md +3 -3
- package/docs/pt-br/pro-upgrade.md +1 -1
- package/docs/pt-br/sync/luau-lsp.md +13 -13
- package/docs/pt-br/sync/overview.md +8 -8
- package/docs/pt-br/tools/overview.md +1 -1
- package/docs/pt-br/tools/playtest.md +2 -2
- package/docs/troubleshooting.md +1 -1
- package/install.ps1 +8 -8
- package/install.sh +11 -11
- package/llms-full.txt +8 -8
- package/llms.txt +4 -4
- package/package.json +1 -1
- package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ChangelogDetailPage-J4ikmBDz.js → ChangelogDetailPage-DRfFUIvC.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ChangelogPage-CRyiyz5Q.js → ChangelogPage-Dgl8dBt6.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ConfirmModal-BqqXDrdf.js → ConfirmModal-DfdyAPrJ.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ConnectionPage-BFjleYaN.js → ConnectionPage-LSvSX1_u.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{InfoLabel-DG5Q_c5f.js → InfoLabel-DrK7vhO-.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{OverviewPage-skOVAGFT.js → OverviewPage-CXsGuoPu.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{PlaytestPage-jdZTJ1qE.js → PlaytestPage-CgkzRAqQ.js} +2 -2
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{PropertyDiff-DGvziVFn.js → PropertyDiff-Dy3MffNh.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-D2ZBQ2KF.js +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{StatusBadge-D-Jxp4ai.js → StatusBadge-hJyzgRAl.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SyncPage-eX2Rh-Ct.js +4 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{TierComparison-Ct-fbCs5.js → TierComparison-BwKqP_4s.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{TierPromoProgress-CoEpWzRl.js → TierPromoProgress-CLAr1gQq.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ToolsPage-Ov5mDGFU.js → ToolsPage-CqzfCxxH.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{WhatsNewPage-DZ-tJeoq.js → WhatsNewPage-23o8LmsR.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/index-BfvSPSNj.js +207 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{useLiveUptime-BpIv_H68.js → useLiveUptime-BeRNzFBh.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/index.html +3 -3
- package/plugins/weppy-roblox-mcp/dist/index.js +82 -82
- package/plugins/weppy-roblox-mcp/roblox-plugin/WeppyRobloxMCP.rbxm +0 -0
- package/.github/workflows/deploy-docs.yml +0 -41
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-DNmdsQlc.js +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SyncPage-BTX8aTCf.js +0 -4
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/index-aMbdHsW4.js +0 -147
- /package/docs/installer/{wrox-icon.png → weppy-icon.png} +0 -0
- /package/plugins/weppy-roblox-mcp/dashboard/dist/{wrox-icon.png → weppy-icon.png} +0 -0
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
<meta charset="UTF-8" />
|
|
5
5
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
6
6
|
<link rel="manifest" href="manifest.webmanifest" />
|
|
7
|
-
<title>weppy-roblox-mcp (
|
|
7
|
+
<title>weppy-roblox-mcp (WEPPY) 설치</title>
|
|
8
8
|
<script type="module" crossorigin src="./assets/index-Bz0amd7x.js"></script>
|
|
9
9
|
<link rel="stylesheet" crossorigin href="./assets/index-ei4lRUa6.css">
|
|
10
10
|
</head>
|
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
{
|
|
2
|
-
"name": "
|
|
3
|
-
"short_name": "
|
|
2
|
+
"name": "WEPPY 공개 설치",
|
|
3
|
+
"short_name": "WEPPY 설치",
|
|
4
4
|
"start_url": "./",
|
|
5
5
|
"display": "standalone",
|
|
6
6
|
"background_color": "#fbf6ef",
|
|
7
7
|
"theme_color": "#1d2533",
|
|
8
8
|
"icons": [
|
|
9
9
|
{
|
|
10
|
-
"src": "
|
|
10
|
+
"src": "weppy-icon.png",
|
|
11
11
|
"sizes": "192x192",
|
|
12
12
|
"type": "image/png"
|
|
13
13
|
}
|
package/docs/ja/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Roblox MCP — Roblox Studio MCPサーバー | Claude、Codex、Cursor、GeminiでAIゲーム開発
|
|
2
2
|
|
|
3
|
-
> **
|
|
3
|
+
> **WEPPY**は、AIコーディングエージェントがライブRoblox Studioセッションを制御できるMCPサーバーです — 自然言語でスクリプト、インスタンス、Terrain、ライティング、アセット、オーディオ、アニメーションを作成・編集します。
|
|
4
4
|
|
|
5
5
|
**アクションベース統合ツール · 双方向Sync · 自動プレイテスト · マルチPlace対応**
|
|
6
6
|
|
|
@@ -8,11 +8,11 @@
|
|
|
8
8
|
|
|
9
9
|
[](https://youtu.be/puQB4u1VlMw)
|
|
10
10
|
|
|
11
|
-
##
|
|
11
|
+
## WEPPY(Weppy Roblox MCP)を使う理由
|
|
12
12
|
|
|
13
13
|
Claude、Codex、GeminiなどのAIコーディングエージェントは強力ですが、Roblox Studioの内部は見ることも変更することもできません。DataModel、スクリプト、Terrain、ライティングはすべて外部ツールからは不可視です。ブリッジがなければ、AIはコードスニペットを生成するだけで、手動で貼り付ける必要があります。
|
|
14
14
|
|
|
15
|
-
**
|
|
15
|
+
**WEPPY**は、AIエージェントとRoblox Studioをつなぐブリッジです。AIがStudio内でインスタンス、スクリプト、プロパティ、Terrainなどを直接作成・変更すると、変更内容がStudioとダッシュボードに即座に反映され、**何が変わったか一目で確認**できます。
|
|
16
16
|
|
|
17
17
|
コードをコピー&ペーストする必要はありません。AIが作業し、あなたが結果を確認するワークフローです。
|
|
18
18
|
|
|
@@ -102,9 +102,9 @@ AIがStudioプレイテストを直接制御します。Play(F5)/Run(F8)
|
|
|
102
102
|
- 「SpawnLocationが地面の上にあることを確認するテストを書いて実行して。」
|
|
103
103
|
- 「今修正したスクリプトがエラーなしで動くかプレイテストで検証して。」
|
|
104
104
|
|
|
105
|
-

|
|
106
106
|
|
|
107
|
-
### 4)
|
|
107
|
+
### 4) WEPPY Dashboard: AI作業をリアルタイムでモニタリング
|
|
108
108
|
|
|
109
109
|
MCPサーバーが提供するWebダッシュボードで、接続状態、ツール実行履歴、同期状態、ゲーム変更履歴をリアルタイムで確認します。
|
|
110
110
|
|
|
@@ -114,17 +114,17 @@ MCPサーバーが提供するWebダッシュボードで、接続状態、ツ
|
|
|
114
114
|
|
|
115
115
|

|
|
116
116
|
|
|
117
|
-
### 5)
|
|
117
|
+
### 5) WEPPY Roblox Explorer: VSCodeでStudioの階層構造を閲覧
|
|
118
118
|
|
|
119
119
|
Roblox Studioのインスタンスツリー全体をVSCode内で直接確認できます。サービスを探索し、同期されたスクリプトやプロパティファイルを開き、同期状態を追跡 — Studioに切り替える必要はありません。
|
|
120
|
-
|
|
120
|
+
WEPPY Roblox Explorerは、WEPPYが生成するsyncデータを扱うcompanion VSCode拡張です。基本のツリー閲覧は同期済みファイルだけで動作し、ローカルMCPサーバーが動作中ならlive sync状態やdirection表示がより正確に反映されます。
|
|
121
121
|
[VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer) または [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer) からインストールできます。
|
|
122
122
|
|
|
123
123
|
- Studio同様のクラスアイコンで直感的に識別
|
|
124
124
|
- クリックで同期済みスクリプトとプロパティファイルを開く
|
|
125
125
|
- 同期状態表示付きのマルチPlaceサポート
|
|
126
126
|
|
|
127
|
-

|
|
128
128
|
|
|
129
129
|
## すぐに実感できる価値
|
|
130
130
|
|
|
@@ -146,8 +146,8 @@ WROX Roblox Explorerは、WROXが生成するsyncデータを扱うcompanion VSC
|
|
|
146
146
|
- [インストールガイド](installation/README.md)
|
|
147
147
|
- [Tool一覧](tools/overview.md)
|
|
148
148
|
- [Sync機能詳細ガイド](sync/overview.md)
|
|
149
|
-
- [
|
|
150
|
-
- [
|
|
149
|
+
- [WEPPY Dashboard ガイド](dashboard/overview.md)
|
|
150
|
+
- [WEPPY Roblox Explorer (VSCode拡張)](installation/roblox-explorer.md)
|
|
151
151
|
- [互換性](../compatibility.md)
|
|
152
152
|
- [トラブルシューティング](../troubleshooting.md)
|
|
153
153
|
|
|
@@ -68,12 +68,12 @@ GitHubからプラグインファイルをダウンロードして、Roblox Stud
|
|
|
68
68
|
|
|
69
69
|
---
|
|
70
70
|
|
|
71
|
-
## オプション:
|
|
71
|
+
## オプション: WEPPY Roblox Explorer (VSCode拡張) のインストール
|
|
72
72
|
|
|
73
73
|
同期されたインスタンスツリーをRobloxクラスアイコン付きでVSCode内で閲覧できます。
|
|
74
|
-
この拡張を使うには、先に上記のRoblox MCPセットアップを完了している必要があります。Explorer はプロジェクトルート配下の `
|
|
74
|
+
この拡張を使うには、先に上記のRoblox MCPセットアップを完了している必要があります。Explorer はプロジェクトルート配下の `weppy-project-sync` にある Sync データを読み取るためです。
|
|
75
75
|
|
|
76
|
-
👉 [
|
|
76
|
+
👉 [WEPPY Roblox Explorerインストールガイド](https://weppyai.com/ja/install#explorer)
|
|
77
77
|
|
|
78
78
|
直接インストール:
|
|
79
79
|
- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
|
|
@@ -83,7 +83,7 @@ GitHubからプラグインファイルをダウンロードして、Roblox Stud
|
|
|
83
83
|
|
|
84
84
|
## インストール後
|
|
85
85
|
|
|
86
|
-
1. **Roblox Studio**を開き、Pluginsタブから **
|
|
86
|
+
1. **Roblox Studio**を開き、Pluginsタブから **WEPPY** → **Connect** をクリック
|
|
87
87
|
2. **AIアプリ**で次のようにテストしてみてください:
|
|
88
88
|
|
|
89
89
|
```
|
|
@@ -61,7 +61,7 @@ AntigravityではMCPサーバーを **エージェントパネル(Agent pane
|
|
|
61
61
|
|
|
62
62
|
## 接続テスト
|
|
63
63
|
|
|
64
|
-
1. **Roblox Studio** を起動 → Pluginsタブ → **
|
|
64
|
+
1. **Roblox Studio** を起動 → Pluginsタブ → **WEPPY** → **Connect**
|
|
65
65
|
2. **Antigravity**で次を入力:
|
|
66
66
|
```
|
|
67
67
|
Roblox Studioで現在選択されているものを教えて
|
|
@@ -81,7 +81,7 @@ gemini mcp add weppy-roblox-mcp npx --trust -e HTTP_PORT=3002 -- -y @weppy/roblo
|
|
|
81
81
|
|
|
82
82
|
## 接続テスト
|
|
83
83
|
|
|
84
|
-
1. **Roblox Studio**を起動 → Pluginsタブ → **
|
|
84
|
+
1. **Roblox Studio**を起動 → Pluginsタブ → **WEPPY** → **Connect**
|
|
85
85
|
2. **Gemini CLI**を実行して次のように入力:
|
|
86
86
|
```
|
|
87
87
|
Roblox Studioで現在選択されているものを教えて
|
|
@@ -1,19 +1,19 @@
|
|
|
1
|
-
#
|
|
1
|
+
# WEPPY Roblox Explorer (VSCode拡張)
|
|
2
2
|
|
|
3
3
|
Roblox StudioのExplorerと同じインスタンスツリーをVSCodeで表示できる拡張機能です。同期済みインスタンスの探索、スクリプトの直接開封、Sync状態の確認をエディタ内で行えます。
|
|
4
|
-
この拡張は
|
|
4
|
+
この拡張はWEPPY用のcompanion拡張であり、単体のRoblox連携ツールではありません。
|
|
5
5
|
|
|
6
|
-

|
|
7
7
|
|
|
8
8
|
## 要件
|
|
9
9
|
|
|
10
10
|
- VSCode 1.85+
|
|
11
11
|
- [Roblox MCP](../../../README.md) をインストールし、Syncを有効化 (BasicまたはPro)
|
|
12
|
-
- プロジェクトルート配下に Sync により `
|
|
12
|
+
- プロジェクトルート配下に Sync により `weppy-project-sync/place_*/.sync-meta.json` が生成済みであること
|
|
13
13
|
|
|
14
14
|
## インストール方法
|
|
15
15
|
|
|
16
|
-
VSCode Extensionsサイドバー(`Ctrl+Shift+X` / `Cmd+Shift+X`)で **
|
|
16
|
+
VSCode Extensionsサイドバー(`Ctrl+Shift+X` / `Cmd+Shift+X`)で **WEPPY Roblox Explorer** を検索し、**Install** をクリックします。
|
|
17
17
|
|
|
18
18
|
または次のマーケットプレイスから直接インストールできます。
|
|
19
19
|
|
|
@@ -37,7 +37,7 @@ VSCode Extensionsサイドバー(`Ctrl+Shift+X` / `Cmd+Shift+X`)で **WROX R
|
|
|
37
37
|
|
|
38
38
|
| 設定 | デフォルト | 説明 |
|
|
39
39
|
|------|-----------|------|
|
|
40
|
-
| `robloxExplorer.syncRoot` | `""` | `
|
|
40
|
+
| `robloxExplorer.syncRoot` | `""` | `weppy-project-sync` ルートの絶対パス。空の場合は自動検出します。WEPPY は `{projectRoot}/weppy-project-sync` を使います。 |
|
|
41
41
|
| `robloxExplorer.hidePropsFiles` | `false` | デフォルトのVSCodeエクスプローラーでSyncファイル(`.props.json`、`_tree.json`、`.value.json`)を非表示にする。 |
|
|
42
42
|
| `robloxExplorer.autoRefresh` | `true` | Syncファイルの変更時にツリーを自動更新する。 |
|
|
43
43
|
| `robloxExplorer.showSyncStatus` | `true` | ツリー項目にSync状態のデコレーションを表示する。 |
|
|
@@ -46,11 +46,11 @@ VSCode Extensionsサイドバー(`Ctrl+Shift+X` / `Cmd+Shift+X`)で **WROX R
|
|
|
46
46
|
|
|
47
47
|
| コマンド | 説明 |
|
|
48
48
|
|---------|------|
|
|
49
|
-
| `
|
|
50
|
-
| `
|
|
51
|
-
| `
|
|
52
|
-
| `
|
|
53
|
-
| `
|
|
49
|
+
| `WEPPY Explorer: Refresh` | インスタンスツリーを手動で更新 |
|
|
50
|
+
| `WEPPY Explorer: Search Instances` | 全サービスでインスタンスを検索 |
|
|
51
|
+
| `WEPPY Explorer: Open Backing File` | 選択したインスタンスのファイルを開く |
|
|
52
|
+
| `WEPPY Explorer: Copy Instance Path` | 完全なインスタンスパスをコピー(例: `game.Workspace.Part`) |
|
|
53
|
+
| `WEPPY Explorer: Reveal in Explorer` | デフォルトのVSCodeエクスプローラーでファイルを表示 |
|
|
54
54
|
|
|
55
55
|
## 関連ドキュメント
|
|
56
56
|
|
|
@@ -25,9 +25,9 @@ Roblox StudioでAIエージェントと連携するためのプラグインイ
|
|
|
25
25
|
|
|
26
26
|
## 3. インストール確認
|
|
27
27
|
|
|
28
|
-
再起動後、Pluginsタブに **
|
|
28
|
+
再起動後、Pluginsタブに **WEPPY** ボタンが表示されます。
|
|
29
29
|
|
|
30
|
-

|
|
31
31
|
|
|
32
32
|
## 4. AIエージェントに接続
|
|
33
33
|
|
|
@@ -48,7 +48,7 @@ MCPサーバーがインストールされている必要があります。利
|
|
|
48
48
|
### 接続
|
|
49
49
|
|
|
50
50
|
1. **Roblox Studio**で任意のプロジェクトを開く
|
|
51
|
-
2. **Plugins** タブ -> **
|
|
51
|
+
2. **Plugins** タブ -> **WEPPY**
|
|
52
52
|
3. プラグインウィンドウで **Connect** をクリック
|
|
53
53
|
4. **"Connected"** が表示されたら完了
|
|
54
54
|
|
package/docs/ja/pro-upgrade.md
CHANGED
|
@@ -48,7 +48,7 @@ Proはコアワークフローを超え、さらに多くの機能を利用で
|
|
|
48
48
|
|
|
49
49
|
### プラグインで有効化
|
|
50
50
|
|
|
51
|
-
1. Roblox Studioで **
|
|
51
|
+
1. Roblox Studioで **WEPPY** を開き、MCPサーバーに接続します。
|
|
52
52
|
2. プラグインの **Settings > License** セクションを開きます。
|
|
53
53
|
3. `License key` 入力欄に購入したキーを貼り付けます。
|
|
54
54
|
4. **Activate** を押してライセンスを有効化します。
|
package/docs/ja/sync/luau-lsp.md
CHANGED
|
@@ -1,19 +1,19 @@
|
|
|
1
|
-
#
|
|
1
|
+
# WEPPY Sync で `luau-lsp` を使う
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
WEPPY Sync は `luau-lsp` が必要とする sourcemap ファイルを自動生成できるため、別の Rojo プロジェクトを用意しなくても Roblox 対応のエディタ機能を利用できます。
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## WEPPY が書き出すファイル
|
|
6
6
|
|
|
7
|
-
Full Sync が完了すると、
|
|
7
|
+
Full Sync が完了すると、WEPPY は次のファイルを書き出します。
|
|
8
8
|
|
|
9
|
-
- Place sourcemap: `
|
|
10
|
-
- ルート代表ファイル: `
|
|
9
|
+
- Place sourcemap: `weppy-project-sync/place_<id>/sourcemap.json`
|
|
10
|
+
- ルート代表ファイル: `weppy-project-sync/sourcemap.json`
|
|
11
11
|
|
|
12
|
-
ほとんどのユーザーには `
|
|
12
|
+
ほとんどのユーザーには `weppy-project-sync/sourcemap.json` の利用を推奨します。
|
|
13
13
|
|
|
14
14
|
## 何が改善されるか
|
|
15
15
|
|
|
16
|
-
`luau-lsp` が
|
|
16
|
+
`luau-lsp` が WEPPY sourcemap を読むと、次の点が改善されます。
|
|
17
17
|
|
|
18
18
|
- `game.*` の補完
|
|
19
19
|
- 同期済みスクリプト間のナビゲーション
|
|
@@ -21,8 +21,8 @@ Full Sync が完了すると、WROX は次のファイルを書き出します
|
|
|
21
21
|
|
|
22
22
|
## 推奨セットアップ
|
|
23
23
|
|
|
24
|
-
1.
|
|
25
|
-
2. エディタの `luau-lsp` sourcemap 設定で `
|
|
24
|
+
1. WEPPY が `weppy-project-sync/sourcemap.json` を生成できるように、まず Full Sync を 1 回実行します。
|
|
25
|
+
2. エディタの `luau-lsp` sourcemap 設定で `weppy-project-sync/sourcemap.json` を指定します。
|
|
26
26
|
3. 利用中のクライアントで自動 Rojo 生成を無効にできる場合は、`luau-lsp.sourcemap.autogenerate` を `false` に設定します。
|
|
27
27
|
|
|
28
28
|
VSCode 設定例:
|
|
@@ -31,11 +31,11 @@ VSCode 設定例:
|
|
|
31
31
|
{
|
|
32
32
|
"luau-lsp.sourcemap.enabled": true,
|
|
33
33
|
"luau-lsp.sourcemap.autogenerate": false,
|
|
34
|
-
"luau-lsp.sourcemap.sourcemapFile": "
|
|
34
|
+
"luau-lsp.sourcemap.sourcemapFile": "weppy-project-sync/sourcemap.json"
|
|
35
35
|
}
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
## Multi-place メモ
|
|
39
39
|
|
|
40
|
-
`
|
|
41
|
-
特定の place に固定したい場合は、その place の `
|
|
40
|
+
`weppy-project-sync/sourcemap.json` は、プロジェクトの現在の代表 place に追従します。
|
|
41
|
+
特定の place に固定したい場合は、その place の `weppy-project-sync/place_<id>/sourcemap.json` を `luau-lsp` から直接指定してください。
|
package/docs/ja/sync/overview.md
CHANGED
|
@@ -18,16 +18,16 @@ Syncがない場合、AIはチャットに貼られた断片だけを見て判
|
|
|
18
18
|
2. Incremental Sync: 以後の変更分のみを継続反映
|
|
19
19
|
3. History/Status追跡: いつ・どの方向で何が変わったかを確認
|
|
20
20
|
|
|
21
|
-
Sync データは `{projectRoot}/
|
|
22
|
-
加えて、
|
|
23
|
-
`luau-lsp` などのエディタ連携ではルートパスの利用を推奨します。設定手順は [
|
|
21
|
+
Sync データは `{projectRoot}/weppy-project-sync/place_{placeId}/explorer` 配下に生成されます。
|
|
22
|
+
加えて、WEPPY は place ごとの sourcemap を `{projectRoot}/weppy-project-sync/place_{placeId}/sourcemap.json` に書き出し、推奨されるルート代表ファイルを `{projectRoot}/weppy-project-sync/sourcemap.json` に維持します。
|
|
23
|
+
`luau-lsp` などのエディタ連携ではルートパスの利用を推奨します。設定手順は [WEPPY Sync で `luau-lsp` を使う](./luau-lsp.md) を参照してください。
|
|
24
24
|
|
|
25
25
|
### VSCodeで同期データを閲覧する
|
|
26
26
|
|
|
27
|
-
[
|
|
27
|
+
[WEPPY Roblox Explorer](../installation/roblox-explorer.md) 拡張機能をインストールすると、Roblox Studioと同じようにVSCode上で同期済みインスタンスツリーを閲覧できます。
|
|
28
28
|
Explorerはここで生成されたsyncファイルを読み取り、ローカルMCPサーバーが動作中なら追加でlive sync状態とdirection情報も表示できます。
|
|
29
29
|
|
|
30
|
-

|
|
31
31
|
|
|
32
32
|
- Robloxクラスアイコン付きのサービス/インスタンスツリー
|
|
33
33
|
- スクリプトをクリックして編集用に開く
|
|
@@ -40,7 +40,7 @@ Explorerはここで生成されたsyncファイルを読み取り、ローカ
|
|
|
40
40
|
| 同期方向 | Studio -> Local | 双方向 |
|
|
41
41
|
| タイプ別Direction | 非対応 | 対応 (Scripts / Values / Containers / Data / Services) |
|
|
42
42
|
| タイプ別Apply Mode | 非対応 | 対応 (Auto / Manual) |
|
|
43
|
-
| 状態/履歴API | 非対応 | 対応 (`
|
|
43
|
+
| 状態/履歴API | 非対応 | 対応 (`status_current_place`, `history`, `progress`) |
|
|
44
44
|
| `manage_sync` ツール | 非対応 | 対応 |
|
|
45
45
|
| マルチPlace Sync | 非対応 | 対応 (最大3 Place) |
|
|
46
46
|
|
|
@@ -87,7 +87,7 @@ ProではタイプごとにDirection/Apply Modeを細かく制御できます。
|
|
|
87
87
|
|
|
88
88
|
| アクション | 説明 | 主な引数 |
|
|
89
89
|
|------|------|-----------|
|
|
90
|
-
| `
|
|
90
|
+
| `status_current_place` | 現在接続中のPlaceの同期状態を確認 | `-` |
|
|
91
91
|
| `history` | 変更履歴を取得 | `placeId`, `query.limit`, `query.offset` |
|
|
92
92
|
| `directions` | タイプ別Directionを取得 | `placeId` |
|
|
93
93
|
| `read_file` | 同期ファイルを読み取り | `placeId`, `instancePath` |
|
|
@@ -148,6 +148,6 @@ explorer/
|
|
|
148
148
|
|
|
149
149
|
## 関連ドキュメント
|
|
150
150
|
|
|
151
|
-
- [
|
|
151
|
+
- [WEPPY Sync で `luau-lsp` を使う](./luau-lsp.md)
|
|
152
152
|
- [Tool対応範囲 (Tools Overview)](../tools/overview.md)
|
|
153
153
|
- [Proアップグレードガイド](https://weppyai.com/ja/plans)
|
|
@@ -227,7 +227,7 @@ Syncポリシー:
|
|
|
227
227
|
|
|
228
228
|
| アクション | 説明 | ティア |
|
|
229
229
|
|------------|------|--------|
|
|
230
|
-
| `
|
|
230
|
+
| `status_current_place` | 現在接続中のPlaceの同期状態を取得 | Pro |
|
|
231
231
|
| `history` | 変更履歴を取得 | Pro |
|
|
232
232
|
| `directions` | タイプ別同期方向を取得 | Pro |
|
|
233
233
|
| `read_file` | 同期済みファイルを読み取り | Pro |
|
|
@@ -86,10 +86,10 @@ Edit --play--> Running --stop--> Edit
|
|
|
86
86
|
|
|
87
87
|
### 5. レポート出力
|
|
88
88
|
|
|
89
|
-
レポートとログはローカルの `{projectRoot}/
|
|
89
|
+
レポートとログはローカルの `{projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/` 配下に保存されます。
|
|
90
90
|
|
|
91
91
|
```text
|
|
92
|
-
{projectRoot}/
|
|
92
|
+
{projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/
|
|
93
93
|
├── test-report.md
|
|
94
94
|
└── test-log.txt
|
|
95
95
|
```
|
package/docs/ko/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Roblox MCP — Roblox Studio MCP 서버 | Claude, Codex, Cursor, Gemini로 AI 게임 개발
|
|
2
2
|
|
|
3
|
-
> **
|
|
3
|
+
> **WEPPY**는 AI 코딩 에이전트가 라이브 Roblox Studio 세션을 제어할 수 있게 하는 MCP 서버입니다 — 자연어로 스크립트, 인스턴스, 지형, 조명, 에셋, 오디오, 애니메이션을 생성하고 편집합니다.
|
|
4
4
|
|
|
5
5
|
**액션 기반 통합 도구 · 양방향 Sync · 자동 플레이테스트 · 멀티 Place 지원**
|
|
6
6
|
|
|
@@ -8,11 +8,11 @@
|
|
|
8
8
|
|
|
9
9
|
[](https://youtu.be/puQB4u1VlMw)
|
|
10
10
|
|
|
11
|
-
##
|
|
11
|
+
## WEPPY (Weppy Roblox MCP)를 쓰는 이유
|
|
12
12
|
|
|
13
13
|
Claude, Codex, Gemini 같은 AI 코딩 에이전트는 강력하지만 — Roblox Studio 내부는 볼 수도, 수정할 수도 없습니다. DataModel, 스크립트, 지형, 조명 전부 외부 도구에는 보이지 않습니다. 브릿지 없이는 AI가 코드 조각을 생성해도 직접 붙여넣어야 합니다.
|
|
14
14
|
|
|
15
|
-
**
|
|
15
|
+
**WEPPY**는 AI 에이전트와 Roblox Studio를 연결하는 브릿지입니다. AI가 Studio 안에서 인스턴스, 스크립트, 속성, 지형 등을 직접 생성하고 수정하면, 변경 내용이 Studio와 대시보드에 즉시 반영되어 **무엇이 바뀌었는지 한눈에 확인**할 수 있습니다.
|
|
16
16
|
|
|
17
17
|
코드를 복사해서 붙여넣을 필요 없이, AI가 작업하고 내가 결과를 확인하는 방식입니다.
|
|
18
18
|
|
|
@@ -102,9 +102,9 @@ Studio 플레이테스트를 AI가 직접 제어합니다. F5(Play)/F8(Run) 시
|
|
|
102
102
|
- "SpawnLocation이 지면 위에 있는지 테스트 스크립트를 작성해서 자동 실행해줘."
|
|
103
103
|
- "방금 수정한 스크립트가 에러 없이 동작하는지 플레이테스트로 검증해줘."
|
|
104
104
|
|
|
105
|
-

|
|
106
106
|
|
|
107
|
-
### 4)
|
|
107
|
+
### 4) WEPPY Dashboard: AI 작업을 실시간으로 모니터링
|
|
108
108
|
|
|
109
109
|
MCP 서버가 제공하는 웹 대시보드에서 연결 상태, 도구 실행 기록, 동기화 상태, 게임 변경 이력을 실시간으로 확인합니다.
|
|
110
110
|
|
|
@@ -114,17 +114,17 @@ MCP 서버가 제공하는 웹 대시보드에서 연결 상태, 도구 실행
|
|
|
114
114
|
|
|
115
115
|

|
|
116
116
|
|
|
117
|
-
### 5)
|
|
117
|
+
### 5) WEPPY Roblox Explorer: VSCode에서 Studio 계층 구조 탐색
|
|
118
118
|
|
|
119
119
|
Roblox Studio의 전체 인스턴스 트리를 VSCode 안에서 바로 확인할 수 있습니다. 서비스를 탐색하고, 동기화된 스크립트와 속성 파일을 열고, 동기화 상태를 추적하세요 — Studio로 전환할 필요 없이.
|
|
120
|
-
|
|
120
|
+
WEPPY Roblox Explorer는 WEPPY가 생성한 sync 데이터를 위한 companion VSCode 확장입니다. 기본 트리 탐색은 동기화된 파일만으로 동작하고, 로컬 MCP 서버가 실행 중이면 실시간 sync 상태와 direction 표시가 더 정확하게 반영됩니다.
|
|
121
121
|
설치는 [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer) 또는 [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)에서 할 수 있습니다.
|
|
122
122
|
|
|
123
123
|
- Studio와 동일한 클래스 아이콘으로 직관적 구분
|
|
124
124
|
- 클릭으로 동기화된 스크립트와 속성 파일 열기
|
|
125
125
|
- 동기화 상태 표시를 포함한 멀티 Place 지원
|
|
126
126
|
|
|
127
|
-

|
|
128
128
|
|
|
129
129
|
## 유저가 바로 체감하는 장점
|
|
130
130
|
|
|
@@ -146,8 +146,8 @@ WROX Roblox Explorer는 WROX가 생성한 sync 데이터를 위한 companion VSC
|
|
|
146
146
|
- [설치 가이드](installation/README.md)
|
|
147
147
|
- [Tool 전체 목록](tools/overview.md)
|
|
148
148
|
- [Sync 기능 상세 가이드](sync/overview.md)
|
|
149
|
-
- [
|
|
150
|
-
- [
|
|
149
|
+
- [WEPPY Dashboard 가이드](dashboard/overview.md)
|
|
150
|
+
- [WEPPY Roblox Explorer (VSCode 확장)](installation/roblox-explorer.md)
|
|
151
151
|
- [호환성](../compatibility.md)
|
|
152
152
|
- [문제 해결 가이드](../troubleshooting.md)
|
|
153
153
|
|
|
@@ -70,12 +70,12 @@ GitHub에서 플러그인 파일을 다운로드한 뒤, Roblox Studio의 Plugin
|
|
|
70
70
|
|
|
71
71
|
---
|
|
72
72
|
|
|
73
|
-
## 선택 사항:
|
|
73
|
+
## 선택 사항: WEPPY Roblox Explorer (VSCode 확장) 설치
|
|
74
74
|
|
|
75
75
|
동기화된 인스턴스 트리를 Roblox 클래스 아이콘과 함께 VSCode에서 탐색할 수 있습니다.
|
|
76
|
-
이 확장은 위의 Roblox MCP 설치를 먼저 완료해야 사용할 수 있습니다. Explorer가 프로젝트 루트 아래의 `
|
|
76
|
+
이 확장은 위의 Roblox MCP 설치를 먼저 완료해야 사용할 수 있습니다. Explorer가 프로젝트 루트 아래의 `weppy-project-sync` Sync 데이터를 읽기 때문입니다.
|
|
77
77
|
|
|
78
|
-
👉 [
|
|
78
|
+
👉 [WEPPY Roblox Explorer 설치 가이드](https://weppyai.com/ko/install#explorer)
|
|
79
79
|
|
|
80
80
|
바로 설치:
|
|
81
81
|
- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
|
|
@@ -85,7 +85,7 @@ GitHub에서 플러그인 파일을 다운로드한 뒤, Roblox Studio의 Plugin
|
|
|
85
85
|
|
|
86
86
|
## 설치 완료 후
|
|
87
87
|
|
|
88
|
-
1. **Roblox Studio**를 열고, Plugins 탭에서 **
|
|
88
|
+
1. **Roblox Studio**를 열고, Plugins 탭에서 **WEPPY** → **Connect** 클릭
|
|
89
89
|
2. **AI 앱**에서 다음과 같이 테스트해보세요:
|
|
90
90
|
|
|
91
91
|
```
|
|
@@ -60,7 +60,7 @@ Antigravity에서는 MCP 서버를 **에이전트 패널(Agent pane)**에서 관
|
|
|
60
60
|
|
|
61
61
|
## 연결 테스트
|
|
62
62
|
|
|
63
|
-
1. **Roblox Studio** 실행 → Plugins 탭 → **
|
|
63
|
+
1. **Roblox Studio** 실행 → Plugins 탭 → **WEPPY** → **Connect**
|
|
64
64
|
2. **Antigravity**에서 다음을 입력:
|
|
65
65
|
```
|
|
66
66
|
Roblox Studio에서 현재 선택된 것을 알려줘
|
|
@@ -81,7 +81,7 @@ gemini mcp add weppy-roblox-mcp npx --trust -e HTTP_PORT=3002 -- -y @weppy/roblo
|
|
|
81
81
|
|
|
82
82
|
## 연결 테스트
|
|
83
83
|
|
|
84
|
-
1. **Roblox Studio** 실행 → Plugins 탭 → **
|
|
84
|
+
1. **Roblox Studio** 실행 → Plugins 탭 → **WEPPY** → **Connect**
|
|
85
85
|
2. **Gemini CLI** 실행 후 다음을 입력:
|
|
86
86
|
```
|
|
87
87
|
Roblox Studio에서 현재 선택된 것을 알려줘
|