@weppy/roblox-mcp 2.5.1 → 2.6.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.
Files changed (215) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/.github/workflows/install-test.yml +55 -4
  3. package/CHANGELOG.md +17 -0
  4. package/README.md +29 -46
  5. package/SUPPORT.md +4 -6
  6. package/install.ps1 +7 -5
  7. package/install.sh +4 -2
  8. package/llms-full.txt +8 -688
  9. package/llms.txt +3 -13
  10. package/package.json +1 -1
  11. package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json +1 -1
  12. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ChangelogDetailPage-DRfFUIvC.js → ChangelogDetailPage-C-ROvHGr.js} +1 -1
  13. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ChangelogPage-Dgl8dBt6.js → ChangelogPage-CPm4ft8m.js} +1 -1
  14. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ConfirmModal-DfdyAPrJ.js → ConfirmModal-BSTYLn14.js} +1 -1
  15. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ConnectionPage-LSvSX1_u.js → ConnectionPage-BeJEgfmf.js} +1 -1
  16. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{InfoLabel-DrK7vhO-.js → InfoLabel-BRbbxjjt.js} +1 -1
  17. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{OverviewPage-CXsGuoPu.js → OverviewPage-BHd6yL_8.js} +1 -1
  18. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{PlaytestPage-CgkzRAqQ.js → PlaytestPage-BiNJCh4I.js} +1 -1
  19. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{PropertyDiff-Dy3MffNh.js → PropertyDiff-BKVe7m6g.js} +1 -1
  20. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-Cg33y021.js +1 -0
  21. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{StatusBadge-hJyzgRAl.js → StatusBadge-A72TDL-q.js} +1 -1
  22. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{SyncPage-eX2Rh-Ct.js → SyncPage-R4Qs9Xt3.js} +1 -1
  23. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/TierComparison-CQewH4h_.js +1 -0
  24. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{TierPromoProgress-CLAr1gQq.js → TierPromoProgress-DolZjAqX.js} +1 -1
  25. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ToolsPage-CqzfCxxH.js → ToolsPage-DRX93nSV.js} +1 -1
  26. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/WhatsNewPage-uLdiNHd0.js +1 -0
  27. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{index-BfvSPSNj.js → index-oz4Gtzz9.js} +55 -21
  28. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{useLiveUptime-BeRNzFBh.js → useLiveUptime-CRLLCM8t.js} +1 -1
  29. package/plugins/weppy-roblox-mcp/dashboard/dist/index.html +1 -1
  30. package/plugins/weppy-roblox-mcp/dist/index.js +76 -76
  31. package/plugins/weppy-roblox-mcp/roblox-plugin/WeppyRobloxMCP.rbxm +0 -0
  32. package/docs/compatibility.md +0 -44
  33. package/docs/en/dashboard/changelog.md +0 -114
  34. package/docs/en/dashboard/connection.md +0 -77
  35. package/docs/en/dashboard/overview.md +0 -95
  36. package/docs/en/dashboard/playtest.md +0 -61
  37. package/docs/en/dashboard/settings.md +0 -60
  38. package/docs/en/dashboard/sync.md +0 -68
  39. package/docs/en/dashboard/tools.md +0 -69
  40. package/docs/en/explorer/overview.md +0 -104
  41. package/docs/en/installation/README.md +0 -95
  42. package/docs/en/installation/ai-apps/antigravity.md +0 -89
  43. package/docs/en/installation/ai-apps/claude-app.md +0 -78
  44. package/docs/en/installation/ai-apps/claude-code.md +0 -104
  45. package/docs/en/installation/ai-apps/codex-app.md +0 -56
  46. package/docs/en/installation/ai-apps/codex-cli.md +0 -67
  47. package/docs/en/installation/ai-apps/cursor.md +0 -77
  48. package/docs/en/installation/ai-apps/gemini-cli.md +0 -120
  49. package/docs/en/installation/roblox-explorer.md +0 -68
  50. package/docs/en/installation/roblox-plugin.md +0 -96
  51. package/docs/en/pro-upgrade.md +0 -96
  52. package/docs/en/sync/luau-lsp.md +0 -41
  53. package/docs/en/sync/overview.md +0 -153
  54. package/docs/en/tools/assets-and-effects.md +0 -104
  55. package/docs/en/tools/instances-and-properties.md +0 -104
  56. package/docs/en/tools/overview.md +0 -277
  57. package/docs/en/tools/playtest.md +0 -140
  58. package/docs/en/tools/scripting.md +0 -66
  59. package/docs/en/tools/system-and-debugging.md +0 -93
  60. package/docs/en/tools/world-and-environment.md +0 -102
  61. package/docs/es/README.md +0 -209
  62. package/docs/es/dashboard/changelog.md +0 -114
  63. package/docs/es/dashboard/connection.md +0 -77
  64. package/docs/es/dashboard/overview.md +0 -95
  65. package/docs/es/dashboard/playtest.md +0 -61
  66. package/docs/es/dashboard/settings.md +0 -60
  67. package/docs/es/dashboard/sync.md +0 -68
  68. package/docs/es/dashboard/tools.md +0 -69
  69. package/docs/es/explorer/overview.md +0 -104
  70. package/docs/es/installation/README.md +0 -87
  71. package/docs/es/installation/ai-apps/antigravity.md +0 -89
  72. package/docs/es/installation/ai-apps/claude-app.md +0 -78
  73. package/docs/es/installation/ai-apps/claude-code.md +0 -104
  74. package/docs/es/installation/ai-apps/codex-app.md +0 -56
  75. package/docs/es/installation/ai-apps/codex-cli.md +0 -67
  76. package/docs/es/installation/ai-apps/cursor.md +0 -77
  77. package/docs/es/installation/ai-apps/gemini-cli.md +0 -120
  78. package/docs/es/installation/roblox-explorer.md +0 -58
  79. package/docs/es/installation/roblox-plugin.md +0 -85
  80. package/docs/es/pro-upgrade.md +0 -96
  81. package/docs/es/sync/luau-lsp.md +0 -41
  82. package/docs/es/sync/overview.md +0 -153
  83. package/docs/es/tools/assets-and-effects.md +0 -104
  84. package/docs/es/tools/instances-and-properties.md +0 -104
  85. package/docs/es/tools/overview.md +0 -277
  86. package/docs/es/tools/playtest.md +0 -140
  87. package/docs/es/tools/scripting.md +0 -66
  88. package/docs/es/tools/system-and-debugging.md +0 -93
  89. package/docs/es/tools/world-and-environment.md +0 -102
  90. package/docs/id/README.md +0 -209
  91. package/docs/id/dashboard/changelog.md +0 -114
  92. package/docs/id/dashboard/connection.md +0 -77
  93. package/docs/id/dashboard/overview.md +0 -95
  94. package/docs/id/dashboard/playtest.md +0 -61
  95. package/docs/id/dashboard/settings.md +0 -60
  96. package/docs/id/dashboard/sync.md +0 -68
  97. package/docs/id/dashboard/tools.md +0 -69
  98. package/docs/id/explorer/overview.md +0 -104
  99. package/docs/id/installation/README.md +0 -93
  100. package/docs/id/installation/ai-apps/antigravity.md +0 -89
  101. package/docs/id/installation/ai-apps/claude-app.md +0 -78
  102. package/docs/id/installation/ai-apps/claude-code.md +0 -104
  103. package/docs/id/installation/ai-apps/codex-app.md +0 -56
  104. package/docs/id/installation/ai-apps/codex-cli.md +0 -67
  105. package/docs/id/installation/ai-apps/cursor.md +0 -77
  106. package/docs/id/installation/ai-apps/gemini-cli.md +0 -120
  107. package/docs/id/installation/roblox-explorer.md +0 -58
  108. package/docs/id/installation/roblox-plugin.md +0 -85
  109. package/docs/id/pro-upgrade.md +0 -96
  110. package/docs/id/sync/luau-lsp.md +0 -41
  111. package/docs/id/sync/overview.md +0 -153
  112. package/docs/id/tools/assets-and-effects.md +0 -104
  113. package/docs/id/tools/instances-and-properties.md +0 -104
  114. package/docs/id/tools/overview.md +0 -277
  115. package/docs/id/tools/playtest.md +0 -140
  116. package/docs/id/tools/scripting.md +0 -66
  117. package/docs/id/tools/system-and-debugging.md +0 -93
  118. package/docs/id/tools/world-and-environment.md +0 -102
  119. package/docs/installer/assets/index-Bz0amd7x.js +0 -63
  120. package/docs/installer/assets/index-ei4lRUa6.css +0 -1
  121. package/docs/installer/index.html +0 -14
  122. package/docs/installer/manifest.webmanifest +0 -15
  123. package/docs/installer/sw.js +0 -7
  124. package/docs/installer/weppy-icon.png +0 -0
  125. package/docs/ja/README.md +0 -207
  126. package/docs/ja/dashboard/changelog.md +0 -114
  127. package/docs/ja/dashboard/connection.md +0 -77
  128. package/docs/ja/dashboard/overview.md +0 -95
  129. package/docs/ja/dashboard/playtest.md +0 -61
  130. package/docs/ja/dashboard/settings.md +0 -60
  131. package/docs/ja/dashboard/sync.md +0 -68
  132. package/docs/ja/dashboard/tools.md +0 -69
  133. package/docs/ja/explorer/overview.md +0 -104
  134. package/docs/ja/installation/README.md +0 -93
  135. package/docs/ja/installation/ai-apps/antigravity.md +0 -89
  136. package/docs/ja/installation/ai-apps/claude-app.md +0 -78
  137. package/docs/ja/installation/ai-apps/claude-code.md +0 -104
  138. package/docs/ja/installation/ai-apps/codex-app.md +0 -56
  139. package/docs/ja/installation/ai-apps/codex-cli.md +0 -67
  140. package/docs/ja/installation/ai-apps/cursor.md +0 -77
  141. package/docs/ja/installation/ai-apps/gemini-cli.md +0 -120
  142. package/docs/ja/installation/roblox-explorer.md +0 -58
  143. package/docs/ja/installation/roblox-plugin.md +0 -85
  144. package/docs/ja/pro-upgrade.md +0 -96
  145. package/docs/ja/sync/luau-lsp.md +0 -41
  146. package/docs/ja/sync/overview.md +0 -153
  147. package/docs/ja/tools/assets-and-effects.md +0 -104
  148. package/docs/ja/tools/instances-and-properties.md +0 -104
  149. package/docs/ja/tools/overview.md +0 -277
  150. package/docs/ja/tools/playtest.md +0 -140
  151. package/docs/ja/tools/scripting.md +0 -66
  152. package/docs/ja/tools/system-and-debugging.md +0 -93
  153. package/docs/ja/tools/world-and-environment.md +0 -102
  154. package/docs/ko/README.md +0 -207
  155. package/docs/ko/dashboard/changelog.md +0 -114
  156. package/docs/ko/dashboard/connection.md +0 -77
  157. package/docs/ko/dashboard/overview.md +0 -95
  158. package/docs/ko/dashboard/playtest.md +0 -61
  159. package/docs/ko/dashboard/settings.md +0 -60
  160. package/docs/ko/dashboard/sync.md +0 -68
  161. package/docs/ko/dashboard/tools.md +0 -69
  162. package/docs/ko/explorer/overview.md +0 -104
  163. package/docs/ko/installation/README.md +0 -95
  164. package/docs/ko/installation/ai-apps/antigravity.md +0 -88
  165. package/docs/ko/installation/ai-apps/claude-app.md +0 -78
  166. package/docs/ko/installation/ai-apps/claude-code.md +0 -104
  167. package/docs/ko/installation/ai-apps/codex-app.md +0 -56
  168. package/docs/ko/installation/ai-apps/codex-cli.md +0 -67
  169. package/docs/ko/installation/ai-apps/cursor.md +0 -77
  170. package/docs/ko/installation/ai-apps/gemini-cli.md +0 -120
  171. package/docs/ko/installation/roblox-explorer.md +0 -68
  172. package/docs/ko/installation/roblox-plugin.md +0 -96
  173. package/docs/ko/pro-upgrade.md +0 -96
  174. package/docs/ko/sync/luau-lsp.md +0 -41
  175. package/docs/ko/sync/overview.md +0 -153
  176. package/docs/ko/tools/assets-and-effects.md +0 -104
  177. package/docs/ko/tools/instances-and-properties.md +0 -104
  178. package/docs/ko/tools/overview.md +0 -277
  179. package/docs/ko/tools/playtest.md +0 -134
  180. package/docs/ko/tools/scripting.md +0 -66
  181. package/docs/ko/tools/system-and-debugging.md +0 -93
  182. package/docs/ko/tools/world-and-environment.md +0 -102
  183. package/docs/pt-br/README.md +0 -209
  184. package/docs/pt-br/dashboard/changelog.md +0 -114
  185. package/docs/pt-br/dashboard/connection.md +0 -77
  186. package/docs/pt-br/dashboard/overview.md +0 -95
  187. package/docs/pt-br/dashboard/playtest.md +0 -61
  188. package/docs/pt-br/dashboard/settings.md +0 -60
  189. package/docs/pt-br/dashboard/sync.md +0 -68
  190. package/docs/pt-br/dashboard/tools.md +0 -69
  191. package/docs/pt-br/explorer/overview.md +0 -104
  192. package/docs/pt-br/installation/README.md +0 -93
  193. package/docs/pt-br/installation/ai-apps/antigravity.md +0 -89
  194. package/docs/pt-br/installation/ai-apps/claude-app.md +0 -78
  195. package/docs/pt-br/installation/ai-apps/claude-code.md +0 -104
  196. package/docs/pt-br/installation/ai-apps/codex-app.md +0 -56
  197. package/docs/pt-br/installation/ai-apps/codex-cli.md +0 -67
  198. package/docs/pt-br/installation/ai-apps/cursor.md +0 -77
  199. package/docs/pt-br/installation/ai-apps/gemini-cli.md +0 -120
  200. package/docs/pt-br/installation/roblox-explorer.md +0 -58
  201. package/docs/pt-br/installation/roblox-plugin.md +0 -85
  202. package/docs/pt-br/pro-upgrade.md +0 -96
  203. package/docs/pt-br/sync/luau-lsp.md +0 -41
  204. package/docs/pt-br/sync/overview.md +0 -153
  205. package/docs/pt-br/tools/assets-and-effects.md +0 -104
  206. package/docs/pt-br/tools/instances-and-properties.md +0 -104
  207. package/docs/pt-br/tools/overview.md +0 -277
  208. package/docs/pt-br/tools/playtest.md +0 -140
  209. package/docs/pt-br/tools/scripting.md +0 -66
  210. package/docs/pt-br/tools/system-and-debugging.md +0 -93
  211. package/docs/pt-br/tools/world-and-environment.md +0 -102
  212. package/docs/troubleshooting.md +0 -47
  213. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-D2ZBQ2KF.js +0 -1
  214. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/TierComparison-BwKqP_4s.js +0 -1
  215. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/WhatsNewPage-23o8LmsR.js +0 -1
@@ -1,68 +0,0 @@
1
- # Sync
2
-
3
- > Studio ↔ ローカルファイル同期の現在の状態、方向設定、ログをモニタリングします。
4
-
5
- ![Sync — 同期状態、方向設定、ログ](../../assets/screenshots/dashboard/dashboard_sync.png)
6
-
7
- > Sync機能自体の詳細ガイドは[Sync機能詳細ガイド](../sync/overview.md)をご参照ください。
8
-
9
- ## 概要
10
-
11
- SyncページはStudio ↔ ローカルファイル同期の現在の状態と設定を視覚的に表示します。ダッシュボードが **Studio接続済み** 状態のときのみアクセスできます。
12
-
13
- ## Sync Status
14
-
15
- 現在の同期状態を表示します:
16
-
17
- | 状態 | 意味 |
18
- |------|------|
19
- | **Idle** | 同期待機中 |
20
- | **Initializing** | 初期同期進行中 |
21
- | **Syncing** | 増分同期進行中 |
22
- | **Error** | 同期エラー発生 |
23
-
24
- 状態カードには同期パス、同期されたインスタンス数、現在の適用モード(Auto/Manual)が併せて表示されます。
25
-
26
- ## Sync Directions
27
-
28
- タイプ別の同期方向をテーブルで表示します:
29
-
30
- | 列 | 説明 |
31
- |----|------|
32
- | Type | 同期対象タイプ(Scripts, Values, Instances, Data, Services) |
33
- | Direction | 同期方向(Local → Studio, Studio → Local) |
34
- | Apply Mode | 適用モード(Auto/Manual) |
35
-
36
- 各タイプの同期方向を確認して、どの変更がどの方向に反映されるかを把握できます。
37
-
38
- ## Sync Log
39
-
40
- 同期イベントを時系列で表示します。各ログ項目には変更タイプタグ(create, update, deleteなど)と対象パスが含まれます。
41
-
42
- ## 活用事例
43
-
44
- ### 同期状態の確認
45
-
46
- ```
47
- 「Syncが正しく動作しているか確認したい」
48
- ```
49
-
50
- Sync StatusがIdleであることを確認し、Sync Logで最近の変更が正常に記録されているか確認します。
51
-
52
- ### 同期方向の把握
53
-
54
- ```
55
- 「スクリプトの変更がどの方向に同期されるか知りたい」
56
- ```
57
-
58
- Sync DirectionsテーブルでScriptsタイプのDirectionを確認します。
59
-
60
- ## 関連ドキュメント
61
-
62
- - [ダッシュボード Overview](overview.md)
63
- - [Changelog](changelog.md)
64
- - [Connection](connection.md)
65
- - [Playtest](playtest.md)
66
- - [Tools](tools.md)
67
- - [Settings](settings.md)
68
- - [Sync機能詳細ガイド](../sync/overview.md)
@@ -1,69 +0,0 @@
1
- # Tools
2
-
3
- > AIが実行したMCPツールの履歴と統計を確認します。
4
-
5
- ![Tools — ツール実行履歴と統計](../../assets/screenshots/dashboard/dashboard_tools.png)
6
-
7
- ## 概要
8
-
9
- ToolsページはAIが実行したMCPツールの履歴と統計を提供します。**History**と**Statistics**の2つのサブタブで構成されています。ダッシュボードが **サーバー接続済み** または **Studio接続済み** 状態であれば常にアクセスできます。
10
-
11
- ## Historyタブ
12
-
13
- ツール実行履歴を時系列テーブルで表示します:
14
-
15
- | 列 | 説明 |
16
- |----|------|
17
- | Time | 実行時間 |
18
- | Tool.Action | 実行されたツールとアクション(例:`query_instances.get_instance`) |
19
- | Duration | 実行所要時間 |
20
- | Status | 結果ステータス(OK/Error) |
21
- | Tier | 使用されたティア(Basic/Pro) |
22
-
23
- 機能:
24
- - **Toolフィルター**ドロップダウンで特定のツールのみフィルタリング
25
- - ページネーションで大量の履歴を閲覧
26
- - リアルタイムで新しい実行履歴を追加
27
-
28
- ## Statisticsタブ
29
-
30
- ツール使用統計を視覚的に分析します:
31
-
32
- - **ティア分布** — Basic/Proツール使用比率
33
- - **ツール別統計** — 各ツールの呼び出し回数、平均応答時間
34
- - **アクション別分析** — ツール内のアクション別詳細統計
35
-
36
- ## Basicティア専用機能
37
-
38
- Basicティアユーザーには追加UIが表示されます:
39
-
40
- - **Tier Usage Progress** — 使用量プログレスバー
41
- - **Basic vs Pro比較モーダル** — Proティアの追加機能を案内
42
-
43
- ## 活用事例
44
-
45
- ### ツールパフォーマンス分析
46
-
47
- ```
48
- 「どのツールが最も時間がかかるか知りたい」
49
- ```
50
-
51
- Statisticsタブでツール別の平均応答時間を確認します。
52
-
53
- ### エラー追跡
54
-
55
- ```
56
- 「実行したツールが失敗した理由を知りたい」
57
- ```
58
-
59
- HistoryタブでStatusがErrorの項目を見つけて詳細情報を確認します。
60
-
61
- ## 関連ドキュメント
62
-
63
- - [ダッシュボード Overview](overview.md)
64
- - [Changelog](changelog.md)
65
- - [Connection](connection.md)
66
- - [Sync](sync.md)
67
- - [Playtest](playtest.md)
68
- - [Settings](settings.md)
69
- - [Tool一覧](../tools/overview.md)
@@ -1,104 +0,0 @@
1
- # WEPPY Roblox Explorer 詳細ガイド
2
-
3
- **WEPPY Roblox Explorer** は、Roblox Studio の Explorer ツリーを VSCode / Antigravity などのエディタ内で同じ形で表示する companion 拡張機能です。Studio とローカルを行き来することなく、同期済みインスタンス階層を閲覧し、スクリプトを開き、プロパティを編集できます。
4
-
5
- > **任意** — Explorer は必須ではありません。MCP サーバーと Roblox Studio プラグインだけで、すべてのコア機能を利用できます。エディタ内でプロジェクト構造を閲覧したり、プロパティをすばやく確認・編集したい場合にインストールしてください。
6
-
7
- ![WEPPY Roblox Explorer — VSCode サイドバーに表示される Studio インスタンスツリー](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
8
-
9
- ## なぜ Explorer を使うのか
10
-
11
- Sync が生成するファイルだけで AI はプロジェクト全体の文脈を理解できますが、人間が直接閲覧するときはファイルパスだけでは構造が把握しづらいことがあります。Explorer は同じ sync データを **Roblox Studio と同じ階層構造** で再表示するため、次のような作業が楽になります。
12
-
13
- - スクリプトがどのサービス / インスタンス配下にあるかを一目で把握
14
- - 複数のサービスにまたがるインスタンスを名前・パスですばやく検索
15
- - 同期状態 (modified / studio / conflict) をファイル単位で確認
16
- - Studio に切り替えずにプロパティを編集
17
-
18
- ## 必要要件
19
-
20
- - VSCode 1.85+ または Antigravity
21
- - [Roblox MCP](../installation/README.md) をインストールし Sync を有効化 (Basic または Pro)
22
- - プロジェクトルート以下に Sync が生成した `weppy-project-sync/place_*/.sync-meta.json` が存在すること
23
-
24
- Explorer は基本的にディスク上の sync ファイルだけで動作し、ローカル MCP サーバーが動作中であれば、リアルタイムの sync 状態と direction 情報もあわせて反映されます。
25
-
26
- ## インストール方法
27
-
28
- VSCode または Antigravity の Extensions サイドバー (`Ctrl+Shift+X` / `Cmd+Shift+X`) で **WEPPY Roblox Explorer** を検索し、**Install** をクリックしてください。
29
-
30
- マーケットプレース直接リンク:
31
-
32
- - [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
33
- - [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
34
-
35
- ## インスタンスツリーの閲覧
36
-
37
- インストール後、VSCode の Activity Bar に **WEPPY Explorer** ビューが追加され、プロジェクトルートから sync ディレクトリを自動検出します。
38
-
39
- - **サービスルート**: `Workspace`、`ReplicatedStorage`、`ServerScriptService` など、同期対象のサービスが最上位に表示されます。
40
- - **Roblox クラスアイコン**: 200 以上の Studio アイコンが、ダーク / ライトテーマに応じて自動で切り替わります。
41
- - **マルチ Place**: 複数 Place が同期されている場合、Place ごとに独立したツリールートとして表示されます。
42
- - **自動更新**: sync ファイルが変更されると 500ms のデバウンスでツリーが自動更新されます。
43
- - **Sync 状態バッジ**: `modified`、`studio`、`conflict` の状態がアイコン横に表示され、変更や競合をすぐに確認できます。
44
-
45
- ツリー上でアイテムをクリックすると、そのインスタンスを構成するファイル (`.server.luau`、`.client.luau`、`.module.luau`、`.props.json` など) が開きます。右クリックメニューから `game.Workspace.Part` 形式でインスタンスパスをコピーしたり、デフォルトの VSCode エクスプローラーでファイル位置を表示したりできます。
46
-
47
- ## Property Panel
48
-
49
- Explorer ツリーでインスタンスを選択し、**Open Properties** コマンドを実行すると、Studio の Properties ウィンドウと同じ形式のパネルが開きます。`.props.json` ファイルを直接編集することなく、グループ化された形でプロパティを確認・編集できます。
50
-
51
- ![Property Panel — VSCode 内で Studio と同じプロパティ編集画面を利用](../../assets/screenshots/roblox-explorer/roblox-explorer-property-window.png)
52
-
53
- - **グループ別表示**: Appearance、Behavior、Data、Part、Transform など、Studio と同じ分類でプロパティが整理されます。
54
- - **型対応エディタ**: 数値、文字列、Boolean、Color、Vector3、Enum などプロパティの型に合わせた入力ウィジェットが提供されます。
55
- - **ファイルベース編集**: 変更内容は該当インスタンスの `*.props.json` ファイルに保存され、Sync の reverse 経路を通じて Studio へ反映されます (Pro, bidirectional 設定時)。
56
- - **カスタムエディタ登録**: `.props.json` ファイルを直接開くと、デフォルトのエディタではなく Property Panel が自動的に起動します。
57
-
58
- ツリー操作中に自動で Property Panel を開きたい場合は、設定で `robloxExplorer.propertyPanel.autoOpen` を `true` に変更してください。
59
-
60
- ## インスタンス検索
61
-
62
- `WEPPY Explorer: Search Instances` コマンド (ビュー上部アイコンまたはコマンドパレット) を使うと、すべてのサービスにまたがって QuickPick 検索を実行できます。
63
-
64
- - インスタンス名の部分一致で高速に検索
65
- - 結果を選択するとツリー上の該当項目にフォーカスが移動
66
- - 複数 Place が同期されている場合は Place 単位で検索結果が分離
67
-
68
- ## 設定
69
-
70
- | 設定 | デフォルト | 説明 |
71
- |------|--------|------|
72
- | `robloxExplorer.mcpBaseUrl` | `""` | ローカル MCP HTTP のベース URL。空の場合は `http://127.0.0.1:3002`、`http://127.0.0.1:3003` の順に試行します。 |
73
- | `robloxExplorer.syncRoot` | `""` | `weppy-project-sync` ルートの絶対パス。空の場合はワークスペースフォルダから自動検出します。 |
74
- | `robloxExplorer.hidePropsFiles` | `false` | デフォルトの VSCode エクスプローラーで sync ファイル (`.props.json`、`_tree.json`、`.value.json`) を非表示にします。 |
75
- | `robloxExplorer.autoRefresh` | `true` | sync ファイル変更時にツリーを自動更新します。 |
76
- | `robloxExplorer.showSyncStatus` | `true` | ツリー項目に sync 状態バッジを表示します。 |
77
- | `robloxExplorer.followFocusCue` | `false` | 外部 focus cue ファイルに従ってツリーを自動展開し、関連ファイルを開きます。 |
78
- | `robloxExplorer.propertyPanel.autoOpen` | `false` | ツリーでインスタンスを選択したときに Property Panel を自動で開きます。 |
79
-
80
- ## コマンド
81
-
82
- | コマンド | 説明 |
83
- |--------|------|
84
- | `WEPPY Explorer: Refresh` | インスタンスツリーを手動で更新 |
85
- | `WEPPY Explorer: Search Instances` | すべてのサービスでインスタンスを検索 |
86
- | `WEPPY Explorer: Open Backing File` | 選択したインスタンスの backing ファイルを開く |
87
- | `WEPPY Explorer: Open Properties` | 選択したインスタンスの Property Panel を開く |
88
- | `WEPPY Explorer: Copy Instance Path` | 完全なインスタンスパスをコピー (例: `game.Workspace.Part`) |
89
- | `WEPPY Explorer: Reveal in Explorer` | デフォルトの VSCode エクスプローラーでファイル位置を表示 |
90
- | `WEPPY Explorer: Collapse All` | ツリーのすべてのノードを折りたたむ |
91
- | `WEPPY Explorer: Open Settings` | Explorer 設定ページを開く |
92
-
93
- ## トラブルシューティング
94
-
95
- - **ツリーが空**: `weppy-project-sync/place_*` ディレクトリが存在し、Sync が少なくとも 1 回 Full Sync を完了しているか確認してください。必要であれば `robloxExplorer.syncRoot` を手動で指定します。
96
- - **Sync 状態が表示されない**: ローカル MCP サーバーが動作中か確認し、`robloxExplorer.mcpBaseUrl` を明示的に設定してみてください。
97
- - **Property Panel が開かない**: `.props.json` ファイルがデフォルトエディタで開く場合、ファイルを右クリックして **Reopen Editor With... → WEPPY Property Panel** を選択してください。
98
- - **アイコンが崩れる**: VSCode のテーマを選び直すか、ウィンドウを再起動してアイコンキャッシュを更新してください。
99
-
100
- ## 関連ドキュメント
101
-
102
- - [Roblox MCP インストールガイド](../installation/README.md)
103
- - [Sync ガイド](../sync/overview.md)
104
- - [Tools 概要](../tools/overview.md)
@@ -1,93 +0,0 @@
1
- # インストールガイド
2
-
3
- Roblox MCPを使用するには、**2つ**をインストールする必要があります。
4
-
5
- ```
6
- AIアプリ (Claude、Codex、Geminiなど)
7
-
8
- MCPサーバー ← ここでAIの命令をRobloxが理解できる形式に変換
9
-
10
- Roblox Studioプラグイン ← Studio内で命令を実行
11
- ```
12
-
13
- AIアプリが「青いパーツを作って」と言うと、MCPサーバーがこのリクエストを変換し、Roblox Studioプラグインが実際にパーツを作成します。
14
-
15
- ---
16
-
17
- ## ワンラインインストール(推奨)
18
-
19
- 1つのコマンドで導入できます:
20
-
21
- **macOS / Linux**
22
-
23
- ```bash
24
- curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
25
- ```
26
-
27
- **Windows (PowerShell)**
28
-
29
- ```powershell
30
- irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
31
- ```
32
-
33
- Roblox Studioを再起動したら完了です!
34
-
35
- 自動MCP登録は **Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI, Antigravity** に対応しています。
36
-
37
- WindowsでPowerShellの実行がブロックされる場合は、下の手動インストールに進んでください。ZIPパッケージを使う場合は `setup-plugin.bat` と `setup-mcp.bat` を実行できます。
38
-
39
- ---
40
-
41
- ## 手動インストール
42
-
43
- ワンラインインストールが動作しない場合、または環境上自動インストールを使えない場合に進める代替インストール方法です。
44
-
45
- ### ステップ1: Roblox Studioプラグインのインストール
46
-
47
- GitHubからプラグインファイルをダウンロードして、Roblox StudioのPluginsフォルダに配置します。
48
-
49
- 👉 [プラグインインストールガイド](https://weppyai.com/ja/install#plugin)
50
-
51
- ---
52
-
53
- ### ステップ2: AIアプリにMCPサーバーを登録
54
-
55
- 使用しているAIアプリにMCPサーバーを登録します。MCPをサポートするすべてのAIアプリで使用できます。
56
-
57
- | AIアプリ | 設定方法 |
58
- |---------|---------|
59
- | Claude Code | [設定手順](ai-apps/claude-code.md) |
60
- | Claude Desktop | [設定手順](ai-apps/claude-app.md) |
61
- | Cursor | [設定手順](ai-apps/cursor.md) |
62
- | Codex CLI | [設定手順](ai-apps/codex-cli.md) |
63
- | Codex Desktop | [設定手順](ai-apps/codex-app.md) |
64
- | Gemini CLI | [設定手順](ai-apps/gemini-cli.md) |
65
- | Antigravity | [設定手順](ai-apps/antigravity.md) |
66
-
67
- > 上記のリストにないAIアプリでも、MCPをサポートしていれば使用できます。MCPサーバーコマンド: `npx -y @weppy/roblox-mcp`
68
-
69
- ---
70
-
71
- ## オプション: WEPPY Roblox Explorer (VSCode拡張) のインストール
72
-
73
- 同期されたインスタンスツリーをRobloxクラスアイコン付きでVSCode内で閲覧できます。
74
- この拡張を使うには、先に上記のRoblox MCPセットアップを完了している必要があります。Explorer はプロジェクトルート配下の `weppy-project-sync` にある Sync データを読み取るためです。
75
-
76
- 👉 [WEPPY Roblox Explorerインストールガイド](https://weppyai.com/ja/install#explorer)
77
-
78
- 直接インストール:
79
- - [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
80
- - [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
81
-
82
- ---
83
-
84
- ## インストール後
85
-
86
- 1. **Roblox Studio**を開き、Pluginsタブから **WEPPY** → **Connect** をクリック
87
- 2. **AIアプリ**で次のようにテストしてみてください:
88
-
89
- ```
90
- Roblox Studioに青いパーツを作って
91
- ```
92
-
93
- 正常にパーツが作成されれば、インストール完了です!
@@ -1,89 +0,0 @@
1
- # Antigravity 設定
2
-
3
- [Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/)でRoblox MCPを使用する方法です。
4
-
5
- > **Antigravity**はGoogleのエージェントベース開発プラットフォームで、AIエージェントがコード編集、ターミナル、ブラウザを横断して複雑なタスクを自律的に実行します。
6
-
7
- ## 前提条件
8
-
9
- 1. **Antigravity** がインストール済み(対応OS/要件は公式ドキュメント参照)
10
- 2. **Node.js**(v18.0.0以上、`npx` が利用可能)
11
- 3. **Roblox Studioプラグイン** のインストール完了
12
-
13
- ## MCPサーバーの登録
14
-
15
- AntigravityではMCPサーバーを **エージェントパネル(Agent pane)** で管理します。
16
-
17
- ### Raw configで手動登録(推奨)
18
-
19
- 1. エージェントパネルで **⋯** → **MCP Servers** → **Manage MCP Servers** → **View raw config** をクリック
20
-
21
- ![MCP Serversメニューを開く](../../../assets/screenshots/antigravity/antigravity_mcp_services_menu.png)
22
-
23
- 2. 表示される設定(JSON)に以下の内容を追加/マージ:
24
-
25
- ```json
26
- {
27
- "mcpServers": {
28
- "weppy-roblox-mcp": {
29
- "command": "npx",
30
- "args": ["-y", "@weppy/roblox-mcp"]
31
- }
32
- }
33
- }
34
- ```
35
-
36
- ![Raw configを編集](../../../assets/screenshots/antigravity/antigravity_mcp_raw.png)
37
-
38
- 3. 保存後、**Refresh**(またはUIの案内に従って再起動/更新)を実行
39
-
40
- > 設定ファイルの実際のパス/名前はOSとAntigravityのバージョンによって異なる場合があります。必ず **View raw config** で案内される場所を基準に編集してください。
41
-
42
- ### オプション: 環境変数でポート/ログを調整
43
-
44
- デフォルト値(HTTP `127.0.0.1:3002`)のまま利用することを推奨します。必要に応じて以下のように環境変数を設定できます:
45
-
46
- ```json
47
- {
48
- "mcpServers": {
49
- "weppy-roblox-mcp": {
50
- "command": "npx",
51
- "args": ["-y", "@weppy/roblox-mcp"],
52
- "env": {
53
- "HTTP_HOST": "127.0.0.1",
54
- "HTTP_PORT": "3002",
55
- "LOG_LEVEL": "INFO"
56
- }
57
- }
58
- }
59
- }
60
- ```
61
-
62
- ## 接続テスト
63
-
64
- 1. **Roblox Studio** を起動 → Pluginsタブ → **WEPPY** → **Connect**
65
- 2. **Antigravity**で次を入力:
66
- ```
67
- Roblox Studioで現在選択されているものを教えて
68
- ```
69
-
70
- ## トラブルシューティング
71
-
72
- ### サーバーが起動しない場合
73
-
74
- MCPサーバーを直接実行してエラーを確認してください:
75
- ```bash
76
- npx -y @weppy/roblox-mcp
77
- ```
78
-
79
- ### 接続失敗
80
-
81
- - Roblox Studioプラグインが **Connected** 状態か確認
82
- - ポート **3002** がファイアウォールでブロックされていないか確認
83
- - エージェントパネル **⋯** → **MCP Servers** でサーバー状態を確認
84
- - (上級) `HTTP_PORT` を変更した場合は、Roblox Studioプラグイン/ブリッジ設定も同じポートを使用するように合わせる必要があります。
85
-
86
- ## 参考資料
87
-
88
- - [Google Antigravity 紹介](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/)
89
- - [Antigravity 開始ガイド(Codelab)](https://codelabs.developers.google.com/getting-started-google-antigravity)
@@ -1,78 +0,0 @@
1
- # Claude Desktop App 設定
2
-
3
- [Claude Desktop App](https://claude.ai/download)でRoblox MCPを使用する方法です。
4
-
5
- ## 前提条件
6
-
7
- - **Claude Desktop App** がインストール済み
8
- - **Node.js** (v18.0.0以上)
9
- - **Roblox Studioプラグイン** のインストール完了
10
-
11
- ## MCPサーバーの登録
12
-
13
- ### 方法1: Desktop Extensions (推奨)
14
-
15
- > 2026年からブラウザ拡張機能のようにワンクリックでインストール可能
16
-
17
- 1. Claude Desktop → **Settings** → **Extensions**
18
- 2. `weppy-roblox-mcp` を検索
19
- 3. **Install** をクリック
20
-
21
- ### 方法2: 設定ファイルを直接編集
22
-
23
- 1. Claude Desktop → **Settings** → **Developers** → **Edit Config** をクリック
24
-
25
- 2. `claude_desktop_config.json` ファイルに以下の内容を追加:
26
-
27
- ```json
28
- {
29
- "mcpServers": {
30
- "weppy-roblox-mcp": {
31
- "command": "npx",
32
- "args": ["-y", "@weppy/roblox-mcp"]
33
- }
34
- }
35
- }
36
- ```
37
-
38
- 3. Claude Desktopを**完全に終了**してから再起動
39
-
40
- **設定ファイルの場所:**
41
-
42
- | OS | パス |
43
- |----|------|
44
- | macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
45
- | Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
46
-
47
- ## 接続テスト
48
-
49
- 1. **Roblox Studio** を起動 → Pluginsタブ → **WEPPY** → **Connect**
50
- 2. **Claude Desktop**で新しい会話を開始してテスト:
51
- ```
52
- Roblox Studioに青いパーツを作って
53
- ```
54
-
55
- ## トラブルシューティング
56
-
57
- ### MCPサーバーがロードされない
58
-
59
- 1. **JSON構文の確認**: オンラインのJSON validatorで設定ファイルを検証
60
- 2. **Claude Desktopの完全再起動**: 設定変更後は必ずアプリを完全終了してから再起動
61
- 3. **パスの確認**: commandとargsが正しいか確認
62
-
63
- ### サーバーが起動しない場合
64
-
65
- MCPサーバーを直接実行してエラーを確認してください:
66
- ```bash
67
- npx -y @weppy/roblox-mcp
68
- ```
69
-
70
- ### 接続失敗
71
-
72
- - Roblox Studioプラグインが **Connected** 状態か確認
73
- - ポート3002がファイアウォールでブロックされていないか確認
74
-
75
- ## 参考資料
76
-
77
- - [Claude Desktop MCP公式ガイド](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop)
78
- - [MCPサーバー接続ガイド](https://modelcontextprotocol.io/docs/develop/connect-local-servers)
@@ -1,104 +0,0 @@
1
- # Claude Code 設定
2
-
3
- [Claude Code](https://claude.ai/code) (ターミナルベースのAIコーディングツール)でRoblox MCPを使用する方法です。
4
-
5
- ## 前提条件
6
-
7
- - **Claude Code** がインストール済み
8
- - **Roblox Studioプラグイン** のインストール完了
9
-
10
- ## インストール
11
-
12
- ```bash
13
- npm install -g @anthropic-ai/claude-code
14
- ```
15
-
16
- ## MCPサーバーの登録
17
-
18
- ### 方法1: マーケットプレイスからインストール (推奨)
19
-
20
- Claude Codeターミナルで実行:
21
-
22
- ```bash
23
- # マーケットプレイスを追加
24
- /plugin marketplace add hope1026/weppy-roblox-mcp
25
-
26
- # プラグインをインストール
27
- /plugin install weppy-roblox-mcp@hope1026-roblox-mcp
28
- ```
29
-
30
- インストール確認:
31
- ```bash
32
- /plugin list
33
- ```
34
-
35
- ### 方法2: 設定ファイルを直接編集
36
-
37
- `.mcp.json` ファイルを作成:
38
-
39
- ```json
40
- {
41
- "mcpServers": {
42
- "weppy-roblox-mcp": {
43
- "command": "npx",
44
- "args": ["-y", "@weppy/roblox-mcp"]
45
- }
46
- }
47
- }
48
- ```
49
-
50
- **設定ファイルの場所:**
51
-
52
- | 範囲 | パス |
53
- |------|------|
54
- | プロジェクト | `<プロジェクト>/.mcp.json` |
55
- | グローバル | `~/.claude/mcp.json` |
56
-
57
- ## 自動サーバー管理
58
-
59
- Claude CodeはMCPサーバーを自動的に管理します:
60
-
61
- - 必要時に自動起動
62
- - セッション終了時に自動停止
63
- - 追加設定は不要
64
-
65
- ## 接続テスト
66
-
67
- 1. **Roblox Studio** を起動 → Pluginsタブ → **WEPPY** → **Connect**
68
- 2. **Claude Code**でテスト:
69
- ```
70
- Roblox Studioに青いパーツを作って
71
- ```
72
-
73
- ## トラブルシューティング
74
-
75
- ### プラグインのインストール失敗
76
-
77
- ```bash
78
- # キャッシュをクリアして再試行
79
- /plugin cache clear
80
- /plugin install weppy-roblox-mcp@hope1026-roblox-mcp
81
- ```
82
-
83
- ### サーバーが起動しない
84
-
85
- 1. Node.jsのバージョンを確認 (18.0以上が必要):
86
- ```bash
87
- node --version
88
- ```
89
-
90
- 2. 手動でサーバー起動をテスト:
91
- ```bash
92
- npx -y @weppy/roblox-mcp
93
- ```
94
-
95
- ### MCPツールが表示されない
96
-
97
- Claude Codeで確認:
98
- ```
99
- 利用可能なMCPツールの一覧を表示して
100
- ```
101
-
102
- ## 参考資料
103
-
104
- - [Claude Code公式ドキュメント](https://docs.anthropic.com/claude-code)
@@ -1,56 +0,0 @@
1
- # Codex App 設定
2
-
3
- [OpenAI Codex App](https://openai.com/codex/) (macOS)でRoblox MCPを使用する方法です。
4
-
5
- > **2026年2月2日リリース** - マルチエージェントワークフローをサポートするネイティブmacOSアプリ
6
-
7
- ## 前提条件
8
-
9
- - **Codex App** がインストール済み (macOS)
10
- - **Roblox Studioプラグイン** のインストール完了
11
-
12
- ## MCPサーバーの登録
13
-
14
- ### Codex CLI設定の自動同期
15
-
16
- Codex CLIで既にMCPを設定している場合、**追加設定なしで**アプリですぐに使用できます。
17
-
18
- ```
19
- CLIのセッション履歴と設定は自動的にアプリに同期されます。
20
- ```
21
-
22
- ### 新規設定の場合
23
-
24
- アプリ内の **Settings** → **MCP Servers** で追加:
25
-
26
- ```
27
- Server name: weppy-roblox-mcp
28
- Command: npx -y @weppy/roblox-mcp
29
- ```
30
-
31
- ## 接続テスト
32
-
33
- 1. **Roblox Studio** を起動 → Pluginsタブ → **WEPPY** → **Connect**
34
- 2. **Codex App**で新しい会話を開始してテスト:
35
- ```
36
- Roblox Studioで現在選択されているものを教えて
37
- ```
38
-
39
- ## トラブルシューティング
40
-
41
- ### サーバーが起動しない場合
42
-
43
- MCPサーバーを直接実行してエラーを確認してください:
44
- ```bash
45
- npx -y @weppy/roblox-mcp
46
- ```
47
-
48
- ### 接続失敗
49
-
50
- - Roblox Studioプラグインが **Connected** 状態か確認
51
- - ポート3002がファイアウォールでブロックされていないか確認
52
-
53
- ## 参考資料
54
-
55
- - [Codex App紹介](https://openai.com/index/introducing-the-codex-app/)
56
- - [Codex MCP公式ドキュメント](https://developers.openai.com/codex/mcp/)