@weppy/roblox-mcp 2.0.8 → 2.0.9
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/CHANGELOG.md +9 -1
- package/COMMERCIAL-LICENSE.md +1 -1
- package/README.md +10 -10
- package/TRADEMARKS.md +1 -1
- package/docs/assets/screenshots/plugin_main.png +0 -0
- package/docs/assets/screenshots/plugins_menu.png +0 -0
- package/docs/assets/screenshots/weppy_plugin_toolbar.png +0 -0
- 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 +5 -3
- 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 +9 -9
- package/docs/en/installation/roblox-plugin.md +3 -3
- package/docs/en/pro-upgrade.md +3 -3
- package/docs/en/sync/overview.md +2 -2
- package/docs/es/README.md +7 -7
- 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 +2 -2
- 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 +9 -9
- package/docs/es/installation/roblox-plugin.md +3 -3
- package/docs/es/pro-upgrade.md +1 -1
- package/docs/es/sync/overview.md +2 -2
- package/docs/id/README.md +7 -7
- 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 +3 -3
- 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 +9 -9
- package/docs/id/installation/roblox-plugin.md +3 -3
- package/docs/id/pro-upgrade.md +1 -1
- package/docs/id/sync/overview.md +2 -2
- package/docs/ja/README.md +7 -7
- package/docs/ja/installation/README.md +3 -3
- 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 +9 -9
- package/docs/ja/installation/roblox-plugin.md +3 -3
- package/docs/ja/pro-upgrade.md +1 -1
- package/docs/ja/sync/overview.md +2 -2
- package/docs/ko/README.md +7 -7
- package/docs/ko/installation/README.md +5 -3
- 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 +9 -9
- package/docs/ko/installation/roblox-plugin.md +3 -3
- package/docs/ko/pro-upgrade.md +1 -1
- package/docs/ko/sync/overview.md +2 -2
- package/docs/pt-br/README.md +8 -8
- 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 +3 -3
- 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 +9 -9
- package/docs/pt-br/installation/roblox-plugin.md +3 -3
- package/docs/pt-br/pro-upgrade.md +1 -1
- package/docs/pt-br/sync/overview.md +2 -2
- package/docs/troubleshooting.md +1 -1
- package/install.ps1 +37 -14
- package/install.sh +38 -3
- package/llms-full.txt +7 -7
- 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-D1JOF_uS.js → ChangelogDetailPage-DRPIGDB0.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ChangelogPage-C4ftyN_p.js → ChangelogPage-DVPYTw2L.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ConfirmModal-DPwJWgnH.js → ConfirmModal-Db4rfrTo.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ConnectionPage-CBB0jpB4.js → ConnectionPage-Cv2i3LSr.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{InfoLabel-CYxzWZMs.js → InfoLabel-DzXzzs6Q.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{OverviewPage-DkTqzsFx.js → OverviewPage-FoC28UL8.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{PlaytestPage-qErtShLw.js → PlaytestPage-BjBAsHLz.js} +2 -2
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{PropertyDiff-C4VtcZO2.js → PropertyDiff-BZMdMzMr.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-BKp2VKMW.js +1 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{StatusBadge-Ch9hAD89.js → StatusBadge-DtcYlxe-.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SyncPage-DcELF5_j.js +4 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{TierPromoProgress-DsH0LxDt.js → TierPromoProgress-r5fgmYI5.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ToolsPage-D6x4enqI.js → ToolsPage-Cfau3bX3.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/index-DWRH2iF4.js +129 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{tier-promo-config-DU-2XXTa.js → tier-promo-config-CQFDWwo4.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{useLiveUptime-C7E1-LNV.js → useLiveUptime-5lD1XKnw.js} +1 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/index.html +3 -3
- package/plugins/weppy-roblox-mcp/dashboard/dist/wrox-icon.png +0 -0
- package/plugins/weppy-roblox-mcp/dist/index.js +2 -2
- package/plugins/weppy-roblox-mcp/roblox-plugin/WeppyRobloxMCP.rbxm +0 -0
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SettingsPage-DJLwbREH.js +0 -1
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/SyncPage-CbegjDPX.js +0 -4
- package/plugins/weppy-roblox-mcp/dashboard/dist/assets/index-CQdnwaWW.js +0 -129
|
@@ -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.
|
|
9
|
+
"version": "2.0.9"
|
|
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.
|
|
16
|
+
"version": "2.0.9",
|
|
17
17
|
"author": {
|
|
18
18
|
"name": "hope1026"
|
|
19
19
|
},
|
package/CHANGELOG.md
CHANGED
|
@@ -20,6 +20,14 @@ All notable changes to this project will be documented in this file.
|
|
|
20
20
|
|
|
21
21
|
|
|
22
22
|
|
|
23
|
+
|
|
24
|
+
## [2.0.9] - 2026-03-27
|
|
25
|
+
|
|
26
|
+
### Improved
|
|
27
|
+
|
|
28
|
+
- Enhanced stability and reliability
|
|
29
|
+
|
|
30
|
+
|
|
23
31
|
## [2.0.8] - 2026-03-27
|
|
24
32
|
|
|
25
33
|
### Improved
|
|
@@ -33,7 +41,7 @@ All notable changes to this project will be documented in this file.
|
|
|
33
41
|
|
|
34
42
|
### What's New
|
|
35
43
|
|
|
36
|
-
- Published
|
|
44
|
+
- Published WROX Explorer to VS Code Marketplace and Open VSX Registry. Install directly from your editor's extension marketplace.
|
|
37
45
|
- Updated installation guide to reflect new marketplace links for Roblox Explorer.
|
|
38
46
|
|
|
39
47
|
|
package/COMMERCIAL-LICENSE.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Commercial Licensing
|
|
2
2
|
|
|
3
|
-
|
|
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
|
-
> **
|
|
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
|
[](https://youtu.be/3jrUpBbZPaw)
|
|
10
10
|
|
|
11
|
-
## Why
|
|
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
|
-
**
|
|
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
|
|
|
@@ -101,23 +101,23 @@ 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
|
+
### 4) WROX Dashboard: Monitor AI work in real time
|
|
105
105
|
|
|
106
106
|
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
107
|
|
|
108
|
-

|
|
108
|
+

|
|
109
109
|
|
|
110
110
|
- Server/Plugin/Agent connection status at a glance
|
|
111
111
|
- Compare every change the AI made via Before & After in Changelog
|
|
112
112
|
- Analyze workflow with tool execution history and statistics
|
|
113
113
|
|
|
114
|
-
### 5) Roblox Explorer: Browse Studio hierarchy in VSCode
|
|
114
|
+
### 5) WROX Roblox Explorer: Browse Studio hierarchy in VSCode
|
|
115
115
|
|
|
116
116
|
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
|
|
117
|
+
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
118
|
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
119
|
|
|
120
|
-

|
|
120
|
+

|
|
121
121
|
|
|
122
122
|
- Class icons matching Studio for instant recognition
|
|
123
123
|
- Click to open synced scripts and property files
|
|
@@ -143,8 +143,8 @@ Install from [VS Code Marketplace](https://marketplace.visualstudio.com/items?it
|
|
|
143
143
|
- [Installation Guide](docs/en/installation/README.md)
|
|
144
144
|
- [Tools Reference](docs/en/tools/overview.md)
|
|
145
145
|
- [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)
|
|
146
|
+
- [WROX Dashboard Guide](docs/en/dashboard/overview.md)
|
|
147
|
+
- [WROX Roblox Explorer (VSCode Extension)](docs/en/installation/roblox-explorer.md)
|
|
148
148
|
- [Compatibility](docs/compatibility.md)
|
|
149
149
|
- [Troubleshooting](docs/troubleshooting.md)
|
|
150
150
|
|
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
|
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
@@ -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
|
-

|
|
5
|
+

|
|
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 **
|
|
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 → **
|
|
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 → **
|
|
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 → **
|
|
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 → **
|
|
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 → **
|
|
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 → **
|
|
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 → **
|
|
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
|
-
#
|
|
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
|
|
4
|
+
This is a companion extension for WROX, not a standalone Roblox integration.
|
|
5
5
|
|
|
6
|
-

|
|
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 **
|
|
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
|
-
| `
|
|
50
|
-
| `
|
|
51
|
-
| `
|
|
52
|
-
| `
|
|
53
|
-
| `
|
|
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
|
|
|
@@ -25,9 +25,9 @@ Note:
|
|
|
25
25
|
|
|
26
26
|
## 3. Verify Installation
|
|
27
27
|
|
|
28
|
-
After restarting, the **
|
|
28
|
+
After restarting, the **WROX** button will appear in the Plugins tab.
|
|
29
29
|
|
|
30
|
-

|
|
31
31
|
|
|
32
32
|
## 4. Connect to AI Agent
|
|
33
33
|
|
|
@@ -48,7 +48,7 @@ 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 -> **
|
|
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
|
|
package/docs/en/pro-upgrade.md
CHANGED
|
@@ -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 **
|
|
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
|
-

|
|
51
|
+

|
|
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
|
-

|
|
61
|
+

|
|
62
62
|
|
|
63
63
|
### After activation
|
|
64
64
|
|
package/docs/en/sync/overview.md
CHANGED
|
@@ -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 [
|
|
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
|
-

|
|
29
29
|
|
|
30
30
|
- Service/instance tree with Roblox class icons
|
|
31
31
|
- Click a script to open it for editing
|
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
|
-
> **
|
|
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
|
|
|
@@ -92,23 +92,23 @@ 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
|
+
### 4) WROX Dashboard: monitorea el trabajo de la IA en tiempo real
|
|
96
96
|
|
|
97
97
|
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
98
|
|
|
99
|
-

|
|
99
|
+

|
|
100
100
|
|
|
101
101
|
- Estado de conexion del servidor/plugin/agente de un vistazo
|
|
102
102
|
- Compara todos los cambios realizados por la IA con Before & After en el Changelog
|
|
103
103
|
- Analiza el flujo de trabajo con el historial de ejecucion de herramientas y estadisticas
|
|
104
104
|
|
|
105
|
-
### 5) Roblox Explorer: explora la jerarquia de Studio en VSCode
|
|
105
|
+
### 5) WROX Roblox Explorer: explora la jerarquia de Studio en VSCode
|
|
106
106
|
|
|
107
107
|
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
|
|
108
|
+
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
109
|
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
110
|
|
|
111
|
-

|
|
111
|
+

|
|
112
112
|
|
|
113
113
|
- Iconos de clase iguales a Studio para reconocimiento inmediato
|
|
114
114
|
- Clic para abrir scripts y archivos de propiedades sincronizados
|
|
@@ -127,7 +127,7 @@ Instálalo desde [VS Code Marketplace](https://marketplace.visualstudio.com/item
|
|
|
127
127
|
- [Lista completa de tools](tools/overview.md)
|
|
128
128
|
- [Guia detallada de Sync](sync/overview.md)
|
|
129
129
|
- [Guia del Dashboard](dashboard/overview.md)
|
|
130
|
-
- [Roblox Explorer (Extension VSCode)](installation/roblox-explorer.md)
|
|
130
|
+
- [WROX Roblox Explorer (Extension VSCode)](installation/roblox-explorer.md)
|
|
131
131
|
- [Compatibilidad](../compatibility.md)
|
|
132
132
|
- [Solucion de problemas](../troubleshooting.md)
|
|
133
133
|
|
|
@@ -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
|
-

|
|
5
|
+

|
|
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 → **
|
|
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
|
|
@@ -46,7 +46,7 @@ Como usar Roblox MCP en [Claude Desktop App](https://claude.ai/download).
|
|
|
46
46
|
|
|
47
47
|
## Probar la Conexion
|
|
48
48
|
|
|
49
|
-
1. Abre **Roblox Studio** → Pestana Plugins → **
|
|
49
|
+
1. Abre **Roblox Studio** → Pestana Plugins → **WROX** → **Connect**
|
|
50
50
|
2. Inicia una nueva conversacion en **Claude Desktop** y prueba:
|
|
51
51
|
```
|
|
52
52
|
Crea una parte azul en Roblox Studio
|
|
@@ -64,7 +64,7 @@ Claude Code gestiona el servidor MCP automaticamente:
|
|
|
64
64
|
|
|
65
65
|
## Probar la Conexion
|
|
66
66
|
|
|
67
|
-
1. Abre **Roblox Studio** → Pestana Plugins → **
|
|
67
|
+
1. Abre **Roblox Studio** → Pestana Plugins → **WROX** → **Connect**
|
|
68
68
|
2. Prueba en **Claude Code**:
|
|
69
69
|
```
|
|
70
70
|
Crea una parte azul en Roblox Studio
|
|
@@ -30,7 +30,7 @@ Command: npx -y @weppy/roblox-mcp
|
|
|
30
30
|
|
|
31
31
|
## Probar la Conexion
|
|
32
32
|
|
|
33
|
-
1. Abre **Roblox Studio** → Pestana Plugins → **
|
|
33
|
+
1. Abre **Roblox Studio** → Pestana Plugins → **WROX** → **Connect**
|
|
34
34
|
2. Inicia una nueva conversacion en **Codex App** y prueba:
|
|
35
35
|
```
|
|
36
36
|
Dime que esta seleccionado actualmente en Roblox Studio
|
|
@@ -40,7 +40,7 @@ args = ["-y", "@weppy/roblox-mcp"]
|
|
|
40
40
|
|
|
41
41
|
## Probar la Conexion
|
|
42
42
|
|
|
43
|
-
1. Abre **Roblox Studio** → Pestana Plugins → **
|
|
43
|
+
1. Abre **Roblox Studio** → Pestana Plugins → **WROX** → **Connect**
|
|
44
44
|
2. Ejecuta **Codex CLI** e ingresa:
|
|
45
45
|
```
|
|
46
46
|
Dime que esta seleccionado actualmente en Roblox Studio
|
|
@@ -45,7 +45,7 @@ Después de editar la configuración, recarga la ventana de Cursor o reinicia la
|
|
|
45
45
|
|
|
46
46
|
## Prueba de conexión
|
|
47
47
|
|
|
48
|
-
1. Abre **Roblox Studio** → pestaña Plugins → **
|
|
48
|
+
1. Abre **Roblox Studio** → pestaña Plugins → **WROX** → **Connect**
|
|
49
49
|
2. En **Cursor**, escribe:
|
|
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
|
## Prueba de conexión
|
|
83
83
|
|
|
84
|
-
1. Abra **Roblox Studio** → pestaña Plugins → **
|
|
84
|
+
1. Abra **Roblox Studio** → pestaña Plugins → **WROX** → **Connect**
|
|
85
85
|
2. Ejecute **Gemini CLI** e ingrese:
|
|
86
86
|
```
|
|
87
87
|
Dime qué está seleccionado actualmente en Roblox Studio
|