@weppy/roblox-mcp 2.0.8 → 2.0.10

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 (155) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/CHANGELOG.md +18 -1
  3. package/COMMERCIAL-LICENSE.md +1 -1
  4. package/README.md +13 -11
  5. package/TRADEMARKS.md +1 -1
  6. package/docs/assets/screenshots/dashboard/dashboard_playtest.png +0 -0
  7. package/docs/assets/screenshots/plugin/installation/main-screen.png +0 -0
  8. package/docs/assets/screenshots/plugin/installation/plugins-menu.png +0 -0
  9. package/docs/assets/screenshots/plugin/installation/toolbar-button.png +0 -0
  10. package/docs/assets/screenshots/plugin/sync/sync-overview.png +0 -0
  11. package/docs/en/dashboard/changelog.md +1 -1
  12. package/docs/en/dashboard/connection.md +1 -1
  13. package/docs/en/dashboard/overview.md +1 -1
  14. package/docs/en/dashboard/playtest.md +1 -1
  15. package/docs/en/dashboard/settings.md +1 -1
  16. package/docs/en/dashboard/sync.md +1 -1
  17. package/docs/en/dashboard/tools.md +1 -1
  18. package/docs/en/installation/README.md +5 -3
  19. package/docs/en/installation/ai-apps/antigravity.md +1 -1
  20. package/docs/en/installation/ai-apps/claude-app.md +1 -1
  21. package/docs/en/installation/ai-apps/claude-code.md +1 -1
  22. package/docs/en/installation/ai-apps/codex-app.md +1 -1
  23. package/docs/en/installation/ai-apps/codex-cli.md +1 -1
  24. package/docs/en/installation/ai-apps/cursor.md +1 -1
  25. package/docs/en/installation/ai-apps/gemini-cli.md +1 -1
  26. package/docs/en/installation/roblox-explorer.md +9 -9
  27. package/docs/en/installation/roblox-plugin.md +6 -6
  28. package/docs/en/pro-upgrade.md +3 -3
  29. package/docs/en/sync/overview.md +4 -4
  30. package/docs/es/README.md +10 -8
  31. package/docs/es/dashboard/changelog.md +1 -1
  32. package/docs/es/dashboard/connection.md +1 -1
  33. package/docs/es/dashboard/overview.md +1 -1
  34. package/docs/es/dashboard/playtest.md +1 -1
  35. package/docs/es/dashboard/settings.md +1 -1
  36. package/docs/es/dashboard/sync.md +1 -1
  37. package/docs/es/dashboard/tools.md +1 -1
  38. package/docs/es/installation/README.md +2 -2
  39. package/docs/es/installation/ai-apps/antigravity.md +1 -1
  40. package/docs/es/installation/ai-apps/claude-app.md +1 -1
  41. package/docs/es/installation/ai-apps/claude-code.md +1 -1
  42. package/docs/es/installation/ai-apps/codex-app.md +1 -1
  43. package/docs/es/installation/ai-apps/codex-cli.md +1 -1
  44. package/docs/es/installation/ai-apps/cursor.md +1 -1
  45. package/docs/es/installation/ai-apps/gemini-cli.md +1 -1
  46. package/docs/es/installation/roblox-explorer.md +9 -9
  47. package/docs/es/installation/roblox-plugin.md +6 -6
  48. package/docs/es/pro-upgrade.md +3 -3
  49. package/docs/es/sync/overview.md +4 -4
  50. package/docs/id/README.md +10 -8
  51. package/docs/id/dashboard/changelog.md +1 -1
  52. package/docs/id/dashboard/connection.md +1 -1
  53. package/docs/id/dashboard/overview.md +1 -1
  54. package/docs/id/dashboard/playtest.md +1 -1
  55. package/docs/id/dashboard/settings.md +1 -1
  56. package/docs/id/dashboard/sync.md +1 -1
  57. package/docs/id/dashboard/tools.md +1 -1
  58. package/docs/id/installation/README.md +3 -3
  59. package/docs/id/installation/ai-apps/antigravity.md +1 -1
  60. package/docs/id/installation/ai-apps/claude-app.md +1 -1
  61. package/docs/id/installation/ai-apps/claude-code.md +1 -1
  62. package/docs/id/installation/ai-apps/codex-app.md +1 -1
  63. package/docs/id/installation/ai-apps/codex-cli.md +1 -1
  64. package/docs/id/installation/ai-apps/cursor.md +1 -1
  65. package/docs/id/installation/ai-apps/gemini-cli.md +1 -1
  66. package/docs/id/installation/roblox-explorer.md +9 -9
  67. package/docs/id/installation/roblox-plugin.md +6 -6
  68. package/docs/id/pro-upgrade.md +3 -3
  69. package/docs/id/sync/overview.md +4 -4
  70. package/docs/ja/README.md +10 -8
  71. package/docs/ja/installation/README.md +3 -3
  72. package/docs/ja/installation/ai-apps/antigravity.md +1 -1
  73. package/docs/ja/installation/ai-apps/claude-app.md +1 -1
  74. package/docs/ja/installation/ai-apps/claude-code.md +1 -1
  75. package/docs/ja/installation/ai-apps/codex-app.md +1 -1
  76. package/docs/ja/installation/ai-apps/codex-cli.md +1 -1
  77. package/docs/ja/installation/ai-apps/cursor.md +1 -1
  78. package/docs/ja/installation/ai-apps/gemini-cli.md +1 -1
  79. package/docs/ja/installation/roblox-explorer.md +9 -9
  80. package/docs/ja/installation/roblox-plugin.md +6 -6
  81. package/docs/ja/pro-upgrade.md +3 -3
  82. package/docs/ja/sync/overview.md +4 -4
  83. package/docs/ko/README.md +10 -8
  84. package/docs/ko/installation/README.md +5 -3
  85. package/docs/ko/installation/ai-apps/antigravity.md +1 -1
  86. package/docs/ko/installation/ai-apps/claude-app.md +1 -1
  87. package/docs/ko/installation/ai-apps/claude-code.md +1 -1
  88. package/docs/ko/installation/ai-apps/codex-app.md +1 -1
  89. package/docs/ko/installation/ai-apps/codex-cli.md +1 -1
  90. package/docs/ko/installation/ai-apps/cursor.md +1 -1
  91. package/docs/ko/installation/ai-apps/gemini-cli.md +1 -1
  92. package/docs/ko/installation/roblox-explorer.md +9 -9
  93. package/docs/ko/installation/roblox-plugin.md +6 -6
  94. package/docs/ko/pro-upgrade.md +3 -3
  95. package/docs/ko/sync/overview.md +4 -4
  96. package/docs/pt-br/README.md +11 -9
  97. package/docs/pt-br/dashboard/changelog.md +1 -1
  98. package/docs/pt-br/dashboard/connection.md +1 -1
  99. package/docs/pt-br/dashboard/overview.md +1 -1
  100. package/docs/pt-br/dashboard/playtest.md +1 -1
  101. package/docs/pt-br/dashboard/settings.md +1 -1
  102. package/docs/pt-br/dashboard/sync.md +1 -1
  103. package/docs/pt-br/dashboard/tools.md +1 -1
  104. package/docs/pt-br/installation/README.md +3 -3
  105. package/docs/pt-br/installation/ai-apps/antigravity.md +1 -1
  106. package/docs/pt-br/installation/ai-apps/claude-app.md +1 -1
  107. package/docs/pt-br/installation/ai-apps/claude-code.md +1 -1
  108. package/docs/pt-br/installation/ai-apps/codex-app.md +1 -1
  109. package/docs/pt-br/installation/ai-apps/codex-cli.md +1 -1
  110. package/docs/pt-br/installation/ai-apps/cursor.md +1 -1
  111. package/docs/pt-br/installation/ai-apps/gemini-cli.md +1 -1
  112. package/docs/pt-br/installation/roblox-explorer.md +9 -9
  113. package/docs/pt-br/installation/roblox-plugin.md +6 -6
  114. package/docs/pt-br/pro-upgrade.md +3 -3
  115. package/docs/pt-br/sync/overview.md +4 -4
  116. package/docs/troubleshooting.md +1 -1
  117. package/install.ps1 +37 -14
  118. package/install.sh +38 -3
  119. package/llms-full.txt +7 -7
  120. package/llms.txt +4 -4
  121. package/package.json +1 -1
  122. package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json +1 -1
  123. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ChangelogDetailPage-D1JOF_uS.js → ChangelogDetailPage-DRPIGDB0.js} +1 -1
  124. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ChangelogPage-C4ftyN_p.js → ChangelogPage-DVPYTw2L.js} +1 -1
  125. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ConfirmModal-DPwJWgnH.js → ConfirmModal-Db4rfrTo.js} +1 -1
  126. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ConnectionPage-CBB0jpB4.js → ConnectionPage-Cv2i3LSr.js} +1 -1
  127. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{InfoLabel-CYxzWZMs.js → InfoLabel-DzXzzs6Q.js} +1 -1
  128. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{OverviewPage-DkTqzsFx.js → OverviewPage-FoC28UL8.js} +1 -1
  129. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{PlaytestPage-qErtShLw.js → PlaytestPage-BjBAsHLz.js} +2 -2
  130. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{PropertyDiff-C4VtcZO2.js → PropertyDiff-BZMdMzMr.js} +1 -1
  131. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-BKp2VKMW.js +1 -0
  132. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{StatusBadge-Ch9hAD89.js → StatusBadge-DtcYlxe-.js} +1 -1
  133. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SyncPage-DcELF5_j.js +4 -0
  134. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{TierPromoProgress-DsH0LxDt.js → TierPromoProgress-r5fgmYI5.js} +1 -1
  135. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ToolsPage-D6x4enqI.js → ToolsPage-Cfau3bX3.js} +1 -1
  136. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/index-DWRH2iF4.js +129 -0
  137. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{tier-promo-config-DU-2XXTa.js → tier-promo-config-CQFDWwo4.js} +1 -1
  138. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{useLiveUptime-C7E1-LNV.js → useLiveUptime-5lD1XKnw.js} +1 -1
  139. package/plugins/weppy-roblox-mcp/dashboard/dist/index.html +3 -3
  140. package/plugins/weppy-roblox-mcp/dashboard/dist/wrox-icon.png +0 -0
  141. package/plugins/weppy-roblox-mcp/dist/index.js +2 -2
  142. package/plugins/weppy-roblox-mcp/roblox-plugin/WeppyRobloxMCP.rbxm +0 -0
  143. package/docs/assets/screenshots/connection_popup.png +0 -0
  144. package/docs/assets/screenshots/plugin_main.png +0 -0
  145. package/docs/assets/screenshots/plugins_menu.png +0 -0
  146. package/docs/assets/screenshots/sync.png +0 -0
  147. package/docs/assets/screenshots/weppy_plugin_toolbar.png +0 -0
  148. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-DJLwbREH.js +0 -1
  149. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SyncPage-CbegjDPX.js +0 -4
  150. package/plugins/weppy-roblox-mcp/dashboard/dist/assets/index-CQdnwaWW.js +0 -129
  151. /package/docs/assets/screenshots/{connection_guide.png → plugin/connection/connection-guide.png} +0 -0
  152. /package/docs/assets/screenshots/{settings.png → plugin/installation/settings-screen.png} +0 -0
  153. /package/docs/assets/screenshots/{license/license-dashboard.png → plugin/license/dashboard-license-screen.png} +0 -0
  154. /package/docs/assets/screenshots/{license/license-plugin.png → plugin/license/plugin-license-screen.png} +0 -0
  155. /package/docs/assets/screenshots/{sync_conflict.png → plugin/sync/sync-conflict.png} +0 -0
@@ -6,14 +6,14 @@
6
6
  },
7
7
  "metadata": {
8
8
  "description": "Weppy Roblox MCP — MCP server that lets AI coding agents control a live Roblox Studio session with 21 tools, 140+ actions, bidirectional sync, automated playtest, and multi-place support",
9
- "version": "2.0.8"
9
+ "version": "2.0.10"
10
10
  },
11
11
  "plugins": [
12
12
  {
13
13
  "name": "weppy-roblox-mcp",
14
14
  "source": "./plugins/weppy-roblox-mcp",
15
15
  "description": "Weppy Roblox MCP — MCP server that lets AI coding agents control a live Roblox Studio session with 21 tools, 140+ actions, bidirectional sync, automated playtest, and multi-place support",
16
- "version": "2.0.8",
16
+ "version": "2.0.10",
17
17
  "author": {
18
18
  "name": "hope1026"
19
19
  },
package/CHANGELOG.md CHANGED
@@ -20,6 +20,23 @@ All notable changes to this project will be documented in this file.
20
20
 
21
21
 
22
22
 
23
+
24
+
25
+ ## [2.0.10] - 2026-03-28
26
+
27
+ ### Improved
28
+
29
+ - Improved sync logic with play mode detection, suppression, and post-play reconciliation.
30
+ - Enhanced plugin UI for sync collision resolution.
31
+
32
+
33
+ ## [2.0.9] - 2026-03-27
34
+
35
+ ### Improved
36
+
37
+ - Enhanced stability and reliability
38
+
39
+
23
40
  ## [2.0.8] - 2026-03-27
24
41
 
25
42
  ### Improved
@@ -33,7 +50,7 @@ All notable changes to this project will be documented in this file.
33
50
 
34
51
  ### What's New
35
52
 
36
- - Published Weppy Roblox Explorer to VS Code Marketplace and Open VSX Registry. Install directly from your editor's extension marketplace.
53
+ - Published WROX Explorer to VS Code Marketplace and Open VSX Registry. Install directly from your editor's extension marketplace.
37
54
  - Updated installation guide to reflect new marketplace links for Roblox Explorer.
38
55
 
39
56
 
@@ -1,6 +1,6 @@
1
1
  # Commercial Licensing
2
2
 
3
- Weppy Roblox MCP is available under the GNU Affero General Public License v3.0 in this repository.
3
+ WROX is available under the GNU Affero General Public License v3.0 in this repository.
4
4
 
5
5
  If you need commercial terms that differ from AGPL-3.0, including closed-source distribution or custom contractual support, contact the maintainer to discuss a separate commercial license.
6
6
 
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Roblox MCP — MCP Server for Roblox Studio | AI Game Development with Claude, Codex, Cursor & Gemini
2
2
 
3
- > **Weppy Roblox MCP** is an MCP server that lets AI coding agents control a live Roblox Studio session — create and edit scripts, instances, terrain, lighting, assets, audio, and animations via natural language.
3
+ > **WROX** is an MCP server that lets AI coding agents control a live Roblox Studio session — create and edit scripts, instances, terrain, lighting, assets, audio, and animations via natural language.
4
4
 
5
5
  **Action-based tool surface · Bidirectional sync · Automated playtest · Multi-place support**
6
6
 
@@ -8,11 +8,11 @@
8
8
 
9
9
  [![Demo — AI building a Roblox game in real time](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
10
10
 
11
- ## Why Weppy Roblox MCP?
11
+ ## Why WROX?
12
12
 
13
13
  AI coding agents like Claude, Codex, and Gemini are powerful — but they cannot see or modify anything inside Roblox Studio. The DataModel, scripts, terrain, and lighting are all invisible to external tools. Without a bridge, AI can only generate code snippets that you must paste manually.
14
14
 
15
- **Weppy Roblox MCP** provides a real-time bridge between AI agents and the Roblox Studio DataModel. It exposes the full Roblox API surface as executable MCP tools, so AI can **directly create, read, modify, and delete** instances, scripts, properties, terrain, and more — inside a live Studio session.
15
+ **WROX** provides a real-time bridge between AI agents and the Roblox Studio DataModel. It exposes the full Roblox API surface as executable MCP tools, so AI can **directly create, read, modify, and delete** instances, scripts, properties, terrain, and more — inside a live Studio session.
16
16
 
17
17
  This is not just code generation. It is **executable, production-oriented actions** running directly in Studio.
18
18
 
@@ -88,7 +88,7 @@ AI can directly handle scripts, instances, properties, terrain, lighting, assets
88
88
 
89
89
  AI works from a synchronized local mirror, so multi-file updates stay consistent.
90
90
 
91
- ![Sync workflow — Studio and local files synchronized in real time](docs/assets/screenshots/sync.png)
91
+ ![Sync workflow — Studio and local files synchronized in real time](docs/assets/screenshots/plugin/sync/sync-overview.png)
92
92
 
93
93
  - Basic: one-way sync (Studio -> Local)
94
94
  - Pro: bidirectional sync + per-type Direction/Apply Mode + history + multi-place
@@ -101,23 +101,25 @@ AI can control Roblox Studio playtests directly. It can start and stop Play (F5)
101
101
  - "Write a test that verifies the SpawnLocation is above the ground and run it."
102
102
  - "Validate that the script I just changed runs without errors in playtest."
103
103
 
104
- ### 4) Dashboard: Monitor AI work in real time
104
+ ![WROX Playtest Dashboard Test history and detailed report](docs/assets/screenshots/dashboard/dashboard_playtest.png)
105
+
106
+ ### 4) WROX Dashboard: Monitor AI work in real time
105
107
 
106
108
  The MCP server provides a web dashboard where you can check connection status, tool execution history, sync state, and game change logs in real time.
107
109
 
108
- ![Dashboard Overview — Server status, recent changes, and session summary](docs/assets/screenshots/dashboard/dashboard_overview.png)
110
+ ![WROX WROX Dashboard Overview — Server status, recent changes, and session summary](docs/assets/screenshots/dashboard/dashboard_overview.png)
109
111
 
110
112
  - Server/Plugin/Agent connection status at a glance
111
113
  - Compare every change the AI made via Before & After in Changelog
112
114
  - Analyze workflow with tool execution history and statistics
113
115
 
114
- ### 5) Roblox Explorer: Browse Studio hierarchy in VSCode
116
+ ### 5) WROX Roblox Explorer: Browse Studio hierarchy in VSCode
115
117
 
116
118
  View the full instance tree of your Roblox Studio place directly inside VSCode. Navigate services, open synced scripts and property files, and track sync status — all without switching to Studio.
117
- Roblox Explorer is a companion VSCode extension for sync data generated by Weppy Roblox MCP. Tree browsing works from synced files, and live sync state or direction indicators are enhanced when the local MCP server is running.
119
+ WROX Roblox Explorer is a companion VSCode extension for sync data generated by WROX. Tree browsing works from synced files, and live sync state or direction indicators are enhanced when the local MCP server is running.
118
120
  Install from [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer) or [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer).
119
121
 
120
- ![Roblox Explorer — Studio instance tree displayed in VSCode sidebar](docs/assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
122
+ ![WROX Roblox Explorer — Studio instance tree displayed in VSCode sidebar](docs/assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
121
123
 
122
124
  - Class icons matching Studio for instant recognition
123
125
  - Click to open synced scripts and property files
@@ -143,8 +145,8 @@ Install from [VS Code Marketplace](https://marketplace.visualstudio.com/items?it
143
145
  - [Installation Guide](docs/en/installation/README.md)
144
146
  - [Tools Reference](docs/en/tools/overview.md)
145
147
  - [Sync Deep Dive](docs/en/sync/overview.md)
146
- - [Dashboard Guide](docs/en/dashboard/overview.md)
147
- - [Roblox Explorer (VSCode Extension)](docs/en/installation/roblox-explorer.md)
148
+ - [WROX Dashboard Guide](docs/en/dashboard/overview.md)
149
+ - [WROX Roblox Explorer (VSCode Extension)](docs/en/installation/roblox-explorer.md)
148
150
  - [Compatibility](docs/compatibility.md)
149
151
  - [Troubleshooting](docs/troubleshooting.md)
150
152
 
package/TRADEMARKS.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Trademarks
2
2
 
3
- `Weppy`, `Weppy Roblox MCP`, and related logos, product names, and branding are trademarks or brand identifiers of the maintainer.
3
+ `Weppy`, `WROX`, `Weppy Roblox MCP`, and related logos, product names, and branding are trademarks or brand identifiers of the maintainer.
4
4
 
5
5
  The open-source software license for this repository does not grant trademark rights.
6
6
 
@@ -106,7 +106,7 @@ Filter the timeline by the Instance category and trace delete-type changes chron
106
106
 
107
107
  ## Related Documents
108
108
 
109
- - [Dashboard Overview](overview.md)
109
+ - [WROX Dashboard Overview](overview.md)
110
110
  - [Connection](connection.md)
111
111
  - [Sync](sync.md)
112
112
  - [Playtest](playtest.md)
@@ -69,7 +69,7 @@ Check the name, PID, and working directory of connected agents in the AI Agents
69
69
 
70
70
  ## Related Documents
71
71
 
72
- - [Dashboard Overview](overview.md)
72
+ - [WROX Dashboard Overview](overview.md)
73
73
  - [Changelog](changelog.md)
74
74
  - [Sync](sync.md)
75
75
  - [Playtest](playtest.md)
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Monitor and manage the MCP server's status, connections, sync state, tool execution history, and game change log in real time from your web browser.
4
4
 
5
- ![Dashboard Overview — Server status, recent changes, and session summary at a glance](../../assets/screenshots/dashboard/dashboard_overview.png)
5
+ ![WROX Dashboard Overview — Server status, recent changes, and session summary at a glance](../../assets/screenshots/dashboard/dashboard_overview.png)
6
6
 
7
7
  ## What Is the Dashboard?
8
8
 
@@ -52,7 +52,7 @@ Check the timestamps and Status in Test History to track test result trends.
52
52
 
53
53
  ## Related Documents
54
54
 
55
- - [Dashboard Overview](overview.md)
55
+ - [WROX Dashboard Overview](overview.md)
56
56
  - [Changelog](changelog.md)
57
57
  - [Connection](connection.md)
58
58
  - [Sync](sync.md)
@@ -59,7 +59,7 @@ Change the dashboard UI language. 6 languages + Auto (automatic browser language
59
59
 
60
60
  ## Related Documents
61
61
 
62
- - [Dashboard Overview](overview.md)
62
+ - [WROX Dashboard Overview](overview.md)
63
63
  - [Changelog](changelog.md)
64
64
  - [Connection](connection.md)
65
65
  - [Sync](sync.md)
@@ -66,7 +66,7 @@ Check the Direction for the Scripts type in the Sync Directions table.
66
66
 
67
67
  ## Related Documents
68
68
 
69
- - [Dashboard Overview](overview.md)
69
+ - [WROX Dashboard Overview](overview.md)
70
70
  - [Changelog](changelog.md)
71
71
  - [Connection](connection.md)
72
72
  - [Playtest](playtest.md)
@@ -60,7 +60,7 @@ Find items with an Error status in the History tab to view detailed information.
60
60
 
61
61
  ## Related Documents
62
62
 
63
- - [Dashboard Overview](overview.md)
63
+ - [WROX Dashboard Overview](overview.md)
64
64
  - [Changelog](changelog.md)
65
65
  - [Connection](connection.md)
66
66
  - [Sync](sync.md)
@@ -32,6 +32,8 @@ irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1
32
32
 
33
33
  Then restart Roblox Studio — done!
34
34
 
35
+ If the installer fails, it writes an error log to a temporary file and keeps the console open in interactive runs so you can read the reason before exiting.
36
+
35
37
  Automatic MCP registration currently supports **Claude Code, Claude Desktop, Cursor, Codex CLI, and Gemini CLI**.
36
38
  **Codex App** and **Antigravity** still require manual setup after the script finishes.
37
39
 
@@ -69,12 +71,12 @@ Register the MCP server with your AI app. You can use it with any AI app that su
69
71
 
70
72
  ---
71
73
 
72
- ## Optional: Install Roblox Explorer (VSCode Extension)
74
+ ## Optional: Install WROX Roblox Explorer (VSCode Extension)
73
75
 
74
76
  Browse synced instance trees inside VSCode with Roblox class icons.
75
77
  This optional extension requires the Roblox MCP setup above, because it reads `roblox-project-sync` data generated by Sync.
76
78
 
77
- 👉 [Roblox Explorer Installation Guide](roblox-explorer.md)
79
+ 👉 [WROX Roblox Explorer Installation Guide](roblox-explorer.md)
78
80
 
79
81
  Direct listings:
80
82
  - [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
@@ -84,7 +86,7 @@ Direct listings:
84
86
 
85
87
  ## After Installation
86
88
 
87
- 1. Open **Roblox Studio**, go to Plugins tab and click **W-MCP** → **Connect**
89
+ 1. Open **Roblox Studio**, go to Plugins tab and click **WROX** → **Connect**
88
90
  2. Test in your **AI app** with:
89
91
 
90
92
  ```
@@ -61,7 +61,7 @@ We recommend keeping the defaults (HTTP `127.0.0.1:3002`). If needed, you can se
61
61
 
62
62
  ## Connection Test
63
63
 
64
- 1. Open **Roblox Studio** → Plugins tab → **W-MCP** → **Connect**
64
+ 1. Open **Roblox Studio** → Plugins tab → **WROX** → **Connect**
65
65
  2. In **Antigravity**, enter:
66
66
  ```
67
67
  Tell me what's currently selected in Roblox Studio
@@ -46,7 +46,7 @@ How to use Roblox MCP with [Claude Desktop App](https://claude.ai/download).
46
46
 
47
47
  ## Connection Test
48
48
 
49
- 1. Open **Roblox Studio** → Plugins tab → **W-MCP** → **Connect**
49
+ 1. Open **Roblox Studio** → Plugins tab → **WROX** → **Connect**
50
50
  2. Start a new conversation in **Claude Desktop** and test:
51
51
  ```
52
52
  Create a blue part in Roblox Studio
@@ -64,7 +64,7 @@ Claude Code manages MCP servers automatically:
64
64
 
65
65
  ## Connection Test
66
66
 
67
- 1. Open **Roblox Studio** → Plugins tab → **W-MCP** → **Connect**
67
+ 1. Open **Roblox Studio** → Plugins tab → **WROX** → **Connect**
68
68
  2. Test in **Claude Code**:
69
69
  ```
70
70
  Create a blue part in Roblox Studio
@@ -30,7 +30,7 @@ Command: npx -y @weppy/roblox-mcp
30
30
 
31
31
  ## Connection Test
32
32
 
33
- 1. Open **Roblox Studio** → Plugins tab → **W-MCP** → **Connect**
33
+ 1. Open **Roblox Studio** → Plugins tab → **WROX** → **Connect**
34
34
  2. Start a new conversation in **Codex App** and test:
35
35
  ```
36
36
  Tell me what's currently selected in Roblox Studio
@@ -40,7 +40,7 @@ args = ["-y", "@weppy/roblox-mcp"]
40
40
 
41
41
  ## Connection Test
42
42
 
43
- 1. Open **Roblox Studio** → Plugins tab → **W-MCP** → **Connect**
43
+ 1. Open **Roblox Studio** → Plugins tab → **WROX** → **Connect**
44
44
  2. Run **Codex CLI** and enter:
45
45
  ```
46
46
  Tell me what's currently selected in Roblox Studio
@@ -45,7 +45,7 @@ After editing the config, reload the Cursor window or restart the app.
45
45
 
46
46
  ## Connection Test
47
47
 
48
- 1. Open **Roblox Studio** → Plugins tab → **W-MCP** → **Connect**
48
+ 1. Open **Roblox Studio** → Plugins tab → **WROX** → **Connect**
49
49
  2. In **Cursor**, enter:
50
50
  ```
51
51
  Tell me what's currently selected in 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
  ## Connection Test
83
83
 
84
- 1. Open **Roblox Studio** → Plugins tab → **W-MCP** → **Connect**
84
+ 1. Open **Roblox Studio** → Plugins tab → **WROX** → **Connect**
85
85
  2. Run **Gemini CLI** and enter:
86
86
  ```
87
87
  Tell me what's currently selected in Roblox Studio
@@ -1,9 +1,9 @@
1
- # Weppy Roblox Explorer (VSCode Extension)
1
+ # WROX Roblox Explorer (VSCode Extension)
2
2
 
3
3
  Roblox Studio Explorer-like tree view for VSCode. Browse synced instance trees, open scripts directly, and track sync status — all inside your editor.
4
- This is a companion extension for Weppy Roblox MCP, not a standalone Roblox integration.
4
+ This is a companion extension for WROX, not a standalone Roblox integration.
5
5
 
6
- ![Weppy Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
6
+ ![WROX Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
7
7
 
8
8
  ## Requirements
9
9
 
@@ -13,7 +13,7 @@ This is a companion extension for Weppy Roblox MCP, not a standalone Roblox inte
13
13
 
14
14
  ## Installation
15
15
 
16
- Search for **Weppy Roblox Explorer** in the VSCode Extensions sidebar (`Ctrl+Shift+X` / `Cmd+Shift+X`) and click **Install**.
16
+ Search for **WROX Roblox Explorer** in the VSCode Extensions sidebar (`Ctrl+Shift+X` / `Cmd+Shift+X`) and click **Install**.
17
17
 
18
18
  Or install directly from:
19
19
 
@@ -46,11 +46,11 @@ Core tree browsing works from synced files on disk. Live sync state, direction i
46
46
 
47
47
  | Command | Description |
48
48
  |---------|-------------|
49
- | `Weppy Roblox Explorer: Refresh` | Manually refresh the instance tree |
50
- | `Weppy Roblox Explorer: Search Instances` | Search instances across all services |
51
- | `Weppy Roblox Explorer: Open Backing File` | Open the file backing a selected instance |
52
- | `Weppy Roblox Explorer: Copy Instance Path` | Copy the full instance path (e.g. `game.Workspace.Part`) |
53
- | `Weppy Roblox Explorer: Reveal in Explorer` | Show the backing file in the default VSCode explorer |
49
+ | `WROX Explorer: Refresh` | Manually refresh the instance tree |
50
+ | `WROX Explorer: Search Instances` | Search instances across all services |
51
+ | `WROX Explorer: Open Backing File` | Open the file backing a selected instance |
52
+ | `WROX Explorer: Copy Instance Path` | Copy the full instance path (e.g. `game.Workspace.Part`) |
53
+ | `WROX Explorer: Reveal in Explorer` | Show the backing file in the default VSCode explorer |
54
54
 
55
55
  ## Related
56
56
 
@@ -18,16 +18,16 @@ Note:
18
18
  2. Click the **Plugins** tab in the top menu
19
19
  3. Click the **Plugins Folder** button
20
20
 
21
- ![Open Plugins Folder](../../assets/screenshots/plugins_menu.png)
21
+ ![Open Plugins Folder](../../assets/screenshots/plugin/installation/plugins-menu.png)
22
22
 
23
23
  4. **Copy** the `WeppyRobloxMCP.rbxm` file from the extracted folder into the opened Plugins folder
24
24
  5. **Restart Roblox Studio**
25
25
 
26
26
  ## 3. Verify Installation
27
27
 
28
- After restarting, the **W-MCP** button will appear in the Plugins tab.
28
+ After restarting, the **WROX** button will appear in the Plugins tab.
29
29
 
30
- ![W-MCP Button](../../assets/screenshots/weppy_plugin_toolbar.png)
30
+ ![WROX Button](../../assets/screenshots/plugin/installation/toolbar-button.png)
31
31
 
32
32
  ## 4. Connect to AI Agent
33
33
 
@@ -48,17 +48,17 @@ The MCP server must be installed. Complete the guide for your AI app first:
48
48
  ### Connecting
49
49
 
50
50
  1. Open any project in **Roblox Studio**
51
- 2. Go to **Plugins** tab -> **W-MCP**
51
+ 2. Go to **Plugins** tab -> **WROX**
52
52
  3. Click the **Connect** button in the plugin window
53
53
  4. Once **"Connected"** status is displayed, you're ready
54
54
 
55
- ![Plugin Main Screen](../../assets/screenshots/plugin_main.png)
55
+ ![Plugin Main Screen](../../assets/screenshots/plugin/installation/main-screen.png)
56
56
 
57
57
  ## 5. Settings (Optional)
58
58
 
59
59
  Click the settings button in the top right of the plugin to change options.
60
60
 
61
- ![Settings Screen](../../assets/screenshots/settings.png)
61
+ ![Settings Screen](../../assets/screenshots/plugin/installation/settings-screen.png)
62
62
 
63
63
  - **Auto Connect**: Automatically connect to MCP server when Studio starts
64
64
  - **Auto Reconnect**: Automatically attempt to reconnect when connection is lost
@@ -41,14 +41,14 @@ You only need to activate the license once, either in the plugin or in the dashb
41
41
 
42
42
  ### Activate in the plugin
43
43
 
44
- 1. Open **W-MCP** in Roblox Studio and connect to the MCP server.
44
+ 1. Open **WROX** in Roblox Studio and connect to the MCP server.
45
45
  2. Open **Settings > License** in the plugin.
46
46
  3. Paste your purchased key into the `License key` field.
47
47
  4. Click **Activate** to activate the license.
48
48
  5. If the status does not update immediately, click **Refresh**.
49
49
  6. When activation succeeds, the status changes from Basic to Pro and Pro features become available.
50
50
 
51
- ![Plugin license activation screen](../assets/screenshots/license/license-plugin.png)
51
+ ![WROX Plugin license activation screen](../assets/screenshots/plugin/license/plugin-license-screen.png)
52
52
 
53
53
  ### Activate in the dashboard
54
54
 
@@ -58,7 +58,7 @@ You only need to activate the license once, either in the plugin or in the dashb
58
58
  4. Click **Activate License** to activate the license.
59
59
  5. If needed, use **Refresh License** to fetch the latest status.
60
60
 
61
- ![Dashboard license activation screen](../assets/screenshots/license/license-dashboard.png)
61
+ ![WROX Dashboard license activation screen](../assets/screenshots/plugin/license/dashboard-license-screen.png)
62
62
 
63
63
  ### After activation
64
64
 
@@ -12,7 +12,7 @@ Without Sync, AI only sees snippets pasted into chat. With Sync enabled, AI work
12
12
 
13
13
  ## How it works
14
14
 
15
- ![Sync workflow — Studio tree mirrored to local files](../../assets/screenshots/sync.png)
15
+ ![Sync workflow — Studio tree mirrored to local files](../../assets/screenshots/plugin/sync/sync-overview.png)
16
16
 
17
17
  1. Full Sync: initial mirror from Studio tree/instances to local files
18
18
  2. Incremental Sync: continuous update of new changes
@@ -22,10 +22,10 @@ Default local path is `roblox-project-sync/place_{placeId}/explorer`.
22
22
 
23
23
  ### Browse sync data in VSCode
24
24
 
25
- Install the [Weppy Roblox Explorer](../installation/roblox-explorer.md) extension to browse the synced instance tree in VSCode, just like in Roblox Studio.
25
+ Install the [WROX Roblox Explorer](../installation/roblox-explorer.md) extension to browse the synced instance tree in VSCode, just like in Roblox Studio.
26
26
  Explorer reads the sync files generated here, and it can show additional live sync state or direction details when the local MCP server is running.
27
27
 
28
- ![Weppy Roblox Explorer — browse synced instance tree in VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
28
+ ![WROX Roblox Explorer — browse synced instance tree in VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
29
29
 
30
30
  - Service/instance tree with Roblox class icons
31
31
  - Click a script to open it for editing
@@ -109,7 +109,7 @@ In Pro, Direction and Apply Mode can be controlled per type.
109
109
 
110
110
  When changes are detected on both Studio and local sides during bidirectional sync, a conflict resolution dialog appears.
111
111
 
112
- ![Local Changes Detected — conflict resolution options (Studio Priority / Local Priority / Per-File)](../../assets/screenshots/sync_conflict.png)
112
+ ![Local Changes Detected — conflict resolution options (Studio Priority / Local Priority / Per-File)](../../assets/screenshots/plugin/sync/sync-conflict.png)
113
113
 
114
114
  - **Studio Priority**: overwrite with Studio state as the source of truth
115
115
  - **Local Priority**: apply local files to Studio
package/docs/es/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Roblox MCP — Servidor MCP para Roblox Studio | Desarrollo de juegos con IA usando Claude, Codex, Cursor y Gemini
2
2
 
3
- > **Weppy Roblox MCP** es un servidor MCP que permite a los agentes de codificacion IA controlar una sesion en vivo de Roblox Studio — crea y edita scripts, instancias, terrain, iluminacion, assets, audio y animaciones con lenguaje natural.
3
+ > **WROX** es un servidor MCP que permite a los agentes de codificacion IA controlar una sesion en vivo de Roblox Studio — crea y edita scripts, instancias, terrain, iluminacion, assets, audio y animaciones con lenguaje natural.
4
4
 
5
5
  **21 herramientas consolidadas · 140+ acciones · Sync bidireccional · Playtest automatizado · Soporte multi-place**
6
6
 
@@ -79,7 +79,7 @@ No es solo generacion de codigo. Son **acciones ejecutables orientadas a producc
79
79
 
80
80
  La IA trabaja sobre un espejo local sincronizado, asi que los cambios en multiples archivos se mantienen consistentes.
81
81
 
82
- ![Flujo de Sync — Studio y archivos locales sincronizados en tiempo real](../assets/screenshots/sync.png)
82
+ ![Flujo de Sync — Studio y archivos locales sincronizados en tiempo real](../assets/screenshots/plugin/sync/sync-overview.png)
83
83
 
84
84
  - Basic: sincronizacion unidireccional (Studio -> Local)
85
85
  - Pro: sincronizacion bidireccional + Direction/Apply Mode por tipo + historial + multiplace
@@ -92,23 +92,25 @@ La IA puede controlar directamente el playtest de Studio. Puede iniciar y detene
92
92
  - "Escribe y ejecuta una prueba para confirmar que el SpawnLocation esta sobre el suelo."
93
93
  - "Valida con playtest que el script que acabo de cambiar funciona sin errores."
94
94
 
95
- ### 4) Dashboard: monitorea el trabajo de la IA en tiempo real
95
+ ![WROX Playtest Dashboard historial de pruebas y reporte detallado](../assets/screenshots/dashboard/dashboard_playtest.png)
96
+
97
+ ### 4) WROX Dashboard: monitorea el trabajo de la IA en tiempo real
96
98
 
97
99
  El Dashboard web proporcionado por el servidor MCP permite consultar en tiempo real el estado de conexion, el historial de ejecucion de herramientas, el estado de sincronizacion y el historial de cambios del juego.
98
100
 
99
- ![Dashboard Overview — estado del servidor, cambios recientes y resumen de sesion](../assets/screenshots/dashboard/dashboard_overview.png)
101
+ ![WROX WROX Dashboard Overview — estado del servidor, cambios recientes y resumen de sesion](../assets/screenshots/dashboard/dashboard_overview.png)
100
102
 
101
103
  - Estado de conexion del servidor/plugin/agente de un vistazo
102
104
  - Compara todos los cambios realizados por la IA con Before & After en el Changelog
103
105
  - Analiza el flujo de trabajo con el historial de ejecucion de herramientas y estadisticas
104
106
 
105
- ### 5) Roblox Explorer: explora la jerarquia de Studio en VSCode
107
+ ### 5) WROX Roblox Explorer: explora la jerarquia de Studio en VSCode
106
108
 
107
109
  Visualiza el arbol completo de instancias de tu lugar en Roblox Studio directamente dentro de VSCode. Navega los servicios, abre scripts y archivos de propiedades sincronizados, y rastrea el estado de sincronizacion — todo sin cambiar a Studio.
108
- Roblox Explorer es una extension complementaria de VSCode para los datos de sync generados por Weppy Roblox MCP. El arbol base funciona con los archivos sincronizados en disco, y los indicadores en vivo de estado sync o direction se enriquecen cuando el servidor MCP local esta en ejecucion.
110
+ WROX Roblox Explorer es una extension complementaria de VSCode para los datos de sync generados por WROX. El arbol base funciona con los archivos sincronizados en disco, y los indicadores en vivo de estado sync o direction se enriquecen cuando el servidor MCP local esta en ejecucion.
109
111
  Instálalo desde [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer) o [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer).
110
112
 
111
- ![Roblox Explorer — arbol de instancias de Studio mostrado en la barra lateral de VSCode](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
113
+ ![WROX Roblox Explorer — arbol de instancias de Studio mostrado en la barra lateral de VSCode](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
112
114
 
113
115
  - Iconos de clase iguales a Studio para reconocimiento inmediato
114
116
  - Clic para abrir scripts y archivos de propiedades sincronizados
@@ -127,7 +129,7 @@ Instálalo desde [VS Code Marketplace](https://marketplace.visualstudio.com/item
127
129
  - [Lista completa de tools](tools/overview.md)
128
130
  - [Guia detallada de Sync](sync/overview.md)
129
131
  - [Guia del Dashboard](dashboard/overview.md)
130
- - [Roblox Explorer (Extension VSCode)](installation/roblox-explorer.md)
132
+ - [WROX Roblox Explorer (Extension VSCode)](installation/roblox-explorer.md)
131
133
  - [Compatibilidad](../compatibility.md)
132
134
  - [Solucion de problemas](../troubleshooting.md)
133
135
 
@@ -106,7 +106,7 @@ Filtra por la categoria Instance en la linea de tiempo y rastrea los cambios de
106
106
 
107
107
  ## Documentos relacionados
108
108
 
109
- - [Dashboard Overview](overview.md)
109
+ - [WROX Dashboard Overview](overview.md)
110
110
  - [Connection](connection.md)
111
111
  - [Sync](sync.md)
112
112
  - [Playtest](playtest.md)
@@ -69,7 +69,7 @@ Consulta el nombre, PID y directorio de trabajo del agente actualmente conectado
69
69
 
70
70
  ## Documentos relacionados
71
71
 
72
- - [Dashboard Overview](overview.md)
72
+ - [WROX Dashboard Overview](overview.md)
73
73
  - [Changelog](changelog.md)
74
74
  - [Sync](sync.md)
75
75
  - [Playtest](playtest.md)
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Consulta y gestiona en tiempo real el estado del servidor MCP, las conexiones, la sincronizacion, el historial de ejecucion de herramientas y el registro de cambios del juego desde el navegador web.
4
4
 
5
- ![Dashboard Overview — estado del servidor, cambios recientes y resumen de sesion de un vistazo](../../assets/screenshots/dashboard/dashboard_overview.png)
5
+ ![WROX Dashboard Overview — estado del servidor, cambios recientes y resumen de sesion de un vistazo](../../assets/screenshots/dashboard/dashboard_overview.png)
6
6
 
7
7
  ## Que es el Dashboard?
8
8
 
@@ -52,7 +52,7 @@ Revisa la marca de tiempo y el Status en el Test History para identificar la ten
52
52
 
53
53
  ## Documentos relacionados
54
54
 
55
- - [Dashboard Overview](overview.md)
55
+ - [WROX Dashboard Overview](overview.md)
56
56
  - [Changelog](changelog.md)
57
57
  - [Connection](connection.md)
58
58
  - [Sync](sync.md)
@@ -59,7 +59,7 @@ Cambia el idioma de la interfaz del Dashboard. Soporta 6 idiomas + Auto (detecci
59
59
 
60
60
  ## Documentos relacionados
61
61
 
62
- - [Dashboard Overview](overview.md)
62
+ - [WROX Dashboard Overview](overview.md)
63
63
  - [Changelog](changelog.md)
64
64
  - [Connection](connection.md)
65
65
  - [Sync](sync.md)
@@ -66,7 +66,7 @@ Consulta la Direction del tipo Scripts en la tabla de Sync Directions.
66
66
 
67
67
  ## Documentos relacionados
68
68
 
69
- - [Dashboard Overview](overview.md)
69
+ - [WROX Dashboard Overview](overview.md)
70
70
  - [Changelog](changelog.md)
71
71
  - [Connection](connection.md)
72
72
  - [Playtest](playtest.md)
@@ -60,7 +60,7 @@ Busca los elementos con Status Error en la pestana History para ver la informaci
60
60
 
61
61
  ## Documentos relacionados
62
62
 
63
- - [Dashboard Overview](overview.md)
63
+ - [WROX Dashboard Overview](overview.md)
64
64
  - [Changelog](changelog.md)
65
65
  - [Connection](connection.md)
66
66
  - [Sync](sync.md)
@@ -64,12 +64,12 @@ Configura el servidor MCP en tu app de IA para que pueda comunicarse con Roblox
64
64
  > npx -y @weppy/roblox-mcp
65
65
  > ```
66
66
 
67
- ## Opcional: Instalar Roblox Explorer (Extensión VSCode)
67
+ ## Opcional: Instalar WROX Roblox Explorer (Extensión VSCode)
68
68
 
69
69
  Explora los árboles de instancias sincronizados dentro de VSCode con iconos de clases Roblox.
70
70
  Esta extensión opcional requiere completar antes la instalación de Roblox MCP, porque Explorer lee los datos `roblox-project-sync` generados por Sync.
71
71
 
72
- 👉 [Guía de instalación de Roblox Explorer](roblox-explorer.md)
72
+ 👉 [Guía de instalación de WROX Roblox Explorer](roblox-explorer.md)
73
73
 
74
74
  Instalación directa:
75
75
  - [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
@@ -61,7 +61,7 @@ Se recomienda mantener el valor predeterminado (HTTP `127.0.0.1:3002`). Si es ne
61
61
 
62
62
  ## Prueba de conexión
63
63
 
64
- 1. Abre **Roblox Studio** → pestaña Plugins → **W-MCP** → **Connect**
64
+ 1. Abre **Roblox Studio** → pestaña Plugins → **WROX** → **Connect**
65
65
  2. En **Antigravity**, escribe:
66
66
  ```
67
67
  Dime qué está seleccionado actualmente en Roblox Studio