@weppy/roblox-mcp 0.1.11 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +2 -2
- package/CHANGELOG.md +45 -10
- package/README.md +6 -0
- package/docs/en/installation/roblox-plugin.md +10 -5
- package/docs/en/pro-upgrade.md +36 -30
- package/docs/en/tools/overview.md +255 -95
- package/docs/es/README.md +6 -0
- package/docs/es/installation/README.md +6 -5
- package/docs/es/installation/roblox-plugin.md +29 -24
- package/docs/es/pro-upgrade.md +39 -33
- package/docs/es/tools/overview.md +4 -0
- package/docs/id/README.md +6 -0
- package/docs/id/installation/roblox-plugin.md +28 -23
- package/docs/id/pro-upgrade.md +36 -30
- package/docs/id/tools/overview.md +4 -0
- package/docs/ja/README.md +6 -0
- package/docs/ja/installation/README.md +5 -5
- package/docs/ja/installation/roblox-plugin.md +32 -27
- package/docs/ja/pro-upgrade.md +38 -32
- package/docs/ja/tools/overview.md +4 -0
- package/docs/ko/README.md +6 -0
- package/docs/ko/installation/roblox-plugin.md +10 -5
- package/docs/ko/pro-upgrade.md +36 -30
- package/docs/ko/tools/overview.md +255 -95
- package/docs/pt-br/README.md +6 -0
- package/docs/pt-br/installation/roblox-plugin.md +28 -23
- package/docs/pt-br/pro-upgrade.md +39 -33
- package/docs/pt-br/tools/overview.md +4 -0
- package/package.json +4 -2
- package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json +1 -1
- package/plugins/weppy-roblox-mcp/dist/index.js +70 -98
- package/plugins/weppy-roblox-mcp/skills/roblox-game-dev/SKILL.md +0 -155
- package/plugins/weppy-roblox-mcp/skills/roblox-game-dev/references/animations.json +0 -34
- package/plugins/weppy-roblox-mcp/skills/roblox-game-dev/references/mcp-tools.md +0 -220
- package/plugins/weppy-roblox-mcp/skills/roblox-sync/SKILL.md +0 -492
- package/plugins/weppy-roblox-mcp/skills/roblox-sync/scripts/post-verify.sh +0 -162
- package/plugins/weppy-roblox-mcp/skills/roblox-sync/scripts/pre-check.sh +0 -307
- package/plugins/weppy-roblox-mcp/skills/roblox-sync/scripts/update-metadata.sh +0 -27
|
@@ -6,14 +6,14 @@
|
|
|
6
6
|
},
|
|
7
7
|
"metadata": {
|
|
8
8
|
"description": "Roblox MCP server and tools for AI-powered game development",
|
|
9
|
-
"version": "0.
|
|
9
|
+
"version": "1.0.0"
|
|
10
10
|
},
|
|
11
11
|
"plugins": [
|
|
12
12
|
{
|
|
13
13
|
"name": "weppy-roblox-mcp",
|
|
14
14
|
"source": "./plugins/weppy-roblox-mcp",
|
|
15
15
|
"description": "MCP server for Roblox Studio integration - 132 tools for AI-powered game development with specialized agents and skills",
|
|
16
|
-
"version": "0.
|
|
16
|
+
"version": "1.0.0",
|
|
17
17
|
"author": {
|
|
18
18
|
"name": "hope1026"
|
|
19
19
|
},
|
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,41 @@ All notable changes to this project will be documented in this file.
|
|
|
5
5
|
|
|
6
6
|
|
|
7
7
|
|
|
8
|
+
## [1.0.0] - 2026-02-23
|
|
9
|
+
|
|
10
|
+
### Sync
|
|
11
|
+
|
|
12
|
+
- Implement bidirectional sync between Studio and local files
|
|
13
|
+
- Add per-type sync direction control for Scripts, Values, Containers, Data, and Services
|
|
14
|
+
- Add per-type apply mode (Auto / Manual) per category
|
|
15
|
+
- Add Full Sync and Resync with local file preservation option
|
|
16
|
+
- Add real-time sync progress tracking and place promotion support
|
|
17
|
+
- Add change history with per-change detail view
|
|
18
|
+
- Add multi-place sync with LRU cache (max 3 places) and isolated storage per place
|
|
19
|
+
- Add reverse rescan to detect missed changes on direction switch
|
|
20
|
+
- Add SyncDirectionCard UI with inline descriptions and hover previews
|
|
21
|
+
- Add PreSyncDialog for pre-sync confirmation and local file handling
|
|
22
|
+
- Refactor sync state management with runtime and default config handling
|
|
23
|
+
|
|
24
|
+
### MCP Tools
|
|
25
|
+
|
|
26
|
+
- Add `batch_execute` tool for running multiple commands in one call
|
|
27
|
+
- Add `execute_luau` sandbox with stricter service and path blocking
|
|
28
|
+
- Add tree mutation support for instance rename and move operations
|
|
29
|
+
- Add sibling index support for duplicate-named instances
|
|
30
|
+
- Add per-type sync direction and apply mode to `manage_sync` tool
|
|
31
|
+
- Add `trackToolCall` with action and error type tracking
|
|
32
|
+
- Improve path resolution with robust Roblox path utilities and root confinement
|
|
33
|
+
|
|
34
|
+
### Stability
|
|
35
|
+
|
|
36
|
+
- Add comprehensive MCP flow tests and E2E sync test suite
|
|
37
|
+
- Enhance dynamic endpoint handling, reconnection logic, and error resilience
|
|
38
|
+
- Fix tooltip positioning in widget-local space
|
|
39
|
+
- Refactor settings UI with categories and tooltips
|
|
40
|
+
- Improve AI client detection and connection info display
|
|
41
|
+
|
|
42
|
+
|
|
8
43
|
## [0.1.11] - 2026-02-14
|
|
9
44
|
|
|
10
45
|
### Other Changes
|
|
@@ -23,21 +58,21 @@ All notable changes to this project will be documented in this file.
|
|
|
23
58
|
|
|
24
59
|
### Other Changes
|
|
25
60
|
|
|
26
|
-
-
|
|
27
|
-
- refactor: improve stability
|
|
61
|
+
- Improve stability
|
|
28
62
|
|
|
29
63
|
|
|
30
64
|
## [0.1.8] - 2026-02-08
|
|
31
65
|
|
|
32
66
|
### Fix
|
|
33
|
-
-
|
|
67
|
+
- Improve stability
|
|
34
68
|
|
|
35
69
|
|
|
36
70
|
## [0.1.3] - 2026-02-07
|
|
37
71
|
|
|
38
72
|
### Features
|
|
39
|
-
-
|
|
40
|
-
-
|
|
73
|
+
- Add tool history and statistics tracking system
|
|
74
|
+
- Add version info display in plugin UI
|
|
75
|
+
|
|
41
76
|
|
|
42
77
|
## [0.1.2] - 2026-02-03
|
|
43
78
|
|
|
@@ -48,9 +83,8 @@ All notable changes to this project will be documented in this file.
|
|
|
48
83
|
|
|
49
84
|
First public release of Roblox MCP - AI-powered Roblox Studio integration.
|
|
50
85
|
|
|
51
|
-
####
|
|
86
|
+
#### Basic
|
|
52
87
|
|
|
53
|
-
**Basic (68 tools)**
|
|
54
88
|
- Create, delete, clone, and move parts and models
|
|
55
89
|
- Write and edit scripts with AI assistance
|
|
56
90
|
- Change properties like color, size, and position
|
|
@@ -59,7 +93,8 @@ First public release of Roblox MCP - AI-powered Roblox Studio integration.
|
|
|
59
93
|
- Control camera view and focus
|
|
60
94
|
- View output logs and debug errors
|
|
61
95
|
|
|
62
|
-
|
|
96
|
+
#### Pro
|
|
97
|
+
|
|
63
98
|
- Bulk operations - create or modify hundreds of objects at once
|
|
64
99
|
- Search and insert models from Creator Store
|
|
65
100
|
- Environment controls - lighting, weather, time of day
|
|
@@ -70,8 +105,8 @@ First public release of Roblox MCP - AI-powered Roblox Studio integration.
|
|
|
70
105
|
#### Highlights
|
|
71
106
|
|
|
72
107
|
- **Real-time Studio control** - AI commands execute instantly in Roblox Studio
|
|
73
|
-
- **Works with popular AI apps** - Claude,
|
|
108
|
+
- **Works with popular AI apps** - Claude, Codex CLI, Gemini CLI, and more
|
|
74
109
|
- **Secure by design** - Localhost only, no external network access
|
|
75
|
-
- **Basic tier included** -
|
|
110
|
+
- **Basic tier included** - Essential tools, free forever
|
|
76
111
|
|
|
77
112
|
[0.1.0]: https://github.com/hope1026/roblox-mcp/releases/tag/v0.1.0
|
package/README.md
CHANGED
|
@@ -53,6 +53,12 @@ Installation is complete in two steps:
|
|
|
53
53
|
|
|
54
54
|
Takes just 5 minutes. 👉 [View Installation Guide](docs/en/installation/README.md)
|
|
55
55
|
|
|
56
|
+
## Go Pro
|
|
57
|
+
|
|
58
|
+
Build without limits. Bidirectional Sync, advanced build capabilities, and AI token efficiency — all in one upgrade.
|
|
59
|
+
|
|
60
|
+
👉 [Pro Upgrade Guide](docs/en/pro-upgrade.md)
|
|
61
|
+
|
|
56
62
|
## Links
|
|
57
63
|
|
|
58
64
|
- [GitHub](https://github.com/hope1026/roblox-mcp)
|
|
@@ -4,8 +4,13 @@ How to install the plugin to connect AI agents with Roblox Studio.
|
|
|
4
4
|
|
|
5
5
|
## 1. Download Plugin
|
|
6
6
|
|
|
7
|
-
1.
|
|
8
|
-
2.
|
|
7
|
+
1. Open [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
|
|
8
|
+
2. Download `weppy-roblox-mcp-v{version}.zip`
|
|
9
|
+
3. Extract the ZIP file - you will find `roblox-plugin/WeppyRobloxMCP.rbxm` and setup guides
|
|
10
|
+
|
|
11
|
+
Note:
|
|
12
|
+
- Basic users install the same plugin package and use Basic policy (Studio -> Local one-way sync)
|
|
13
|
+
- Pro subscribers unlock bidirectional sync and broader advanced tools after license activation
|
|
9
14
|
|
|
10
15
|
## 2. Install Plugin
|
|
11
16
|
|
|
@@ -42,15 +47,15 @@ The MCP server must be installed. Complete the guide for your AI app first:
|
|
|
42
47
|
### Connecting
|
|
43
48
|
|
|
44
49
|
1. Open any project in **Roblox Studio**
|
|
45
|
-
2. Go to **Plugins** tab
|
|
50
|
+
2. Go to **Plugins** tab -> **W-MCP**
|
|
46
51
|
3. Click the **Connect** button in the plugin window
|
|
47
|
-
4. Once **"Connected"** status is displayed, you're ready
|
|
52
|
+
4. Once **"Connected"** status is displayed, you're ready
|
|
48
53
|
|
|
49
54
|

|
|
50
55
|
|
|
51
56
|
## 5. Settings (Optional)
|
|
52
57
|
|
|
53
|
-
Click the settings button in the top right of the plugin to change
|
|
58
|
+
Click the settings button in the top right of the plugin to change options.
|
|
54
59
|
|
|
55
60
|

|
|
56
61
|
|
package/docs/en/pro-upgrade.md
CHANGED
|
@@ -2,50 +2,56 @@
|
|
|
2
2
|
|
|
3
3
|
## Why Pro?
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
### Bidirectional Sync built for real development workflows
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
Pro Sync goes beyond one-way export. Edit scripts locally and push them to Studio. Make changes in Studio and pull them back to disk. Pro keeps both sides in sync.
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
- **Bidirectional Sync** — Changes flow in both directions between Studio and local files.
|
|
10
|
+
- **Per-type Direction** — Set direction independently for Scripts, Values, Containers, Data, and Services.
|
|
11
|
+
- **Per-type Apply Mode** — Choose Auto or Manual per type to balance speed and control.
|
|
12
|
+
- **Full Sync / Resync** — Rebuild clean project state on demand after large changes or reconnects.
|
|
13
|
+
- **Change History** — Track what changed, when, and in which direction before applying.
|
|
14
|
+
- **Multi-place Sync** — Sync up to 3 Roblox Places simultaneously, each with isolated storage and its own change history.
|
|
10
15
|
|
|
11
|
-
|
|
12
|
-
|----------|-----------------|
|
|
13
|
-
| **Bulk Operations** | Create 100 trees with one command. Modify all parts at once. |
|
|
14
|
-
| **Terrain Generation** | Generate mountains, caves, and landscapes procedurally. |
|
|
15
|
-
| **Asset Management** | Search Creator Store and insert models directly. |
|
|
16
|
-
| **Raycast & Spatial** | Find spawn positions, detect collisions, analyze walkable areas. |
|
|
17
|
-
| **Environment Control** | Set lighting, atmosphere, sky, and time of day. |
|
|
18
|
-
| **Visualization** | Show areas, create markers, highlight regions. |
|
|
16
|
+
### Save AI tokens with high-leverage workflows
|
|
19
17
|
|
|
20
|
-
|
|
18
|
+
Bulk and advanced actions reduce repetitive round trips — do more per prompt.
|
|
21
19
|
|
|
22
|
-
###
|
|
20
|
+
### Broader advanced capabilities
|
|
23
21
|
|
|
24
|
-
|
|
25
|
-
2. Download the plugin
|
|
22
|
+
Terrain generation, asset search, spatial analysis, animation, audio, and production-scale automation.
|
|
26
23
|
|
|
27
|
-
|
|
24
|
+
## Subscription & Download
|
|
28
25
|
|
|
29
|
-
1
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
26
|
+
### Step 1: Subscribe on Gumroad
|
|
27
|
+
|
|
28
|
+
1. Go to [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/faccjs?utm_source=github&utm_medium=repo&utm_campaign=pro_upgrade_md)
|
|
29
|
+
2. Complete your Pro subscription license purchase
|
|
30
|
+
|
|
31
|
+
### Step 2: Download from GitHub Releases
|
|
32
|
+
|
|
33
|
+
1. Open [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
|
|
34
|
+
2. Download `weppy-roblox-mcp-v{version}.zip`
|
|
35
|
+
3. Extract and copy `roblox-plugin/WeppyRobloxMCP.rbxm` to your Roblox Plugins folder
|
|
34
36
|
|
|
35
37
|
### Step 3: Verify
|
|
36
38
|
|
|
37
|
-
1. Open
|
|
38
|
-
2.
|
|
39
|
-
3.
|
|
39
|
+
1. Open W-MCP in Roblox Studio
|
|
40
|
+
2. Confirm the Pro badge is visible
|
|
41
|
+
3. Run a Pro action (for example: `manage_sync` or bulk operations)
|
|
40
42
|
|
|
41
43
|
## Feature Comparison
|
|
42
44
|
|
|
43
45
|
| Feature | Basic | Pro |
|
|
44
46
|
|---------|:-----:|:---:|
|
|
45
|
-
|
|
|
47
|
+
| Script, Instance, Property management | ✅ Full access | ✅ Full access |
|
|
46
48
|
| Selection, Tag, Camera, Log | ✅ Full access | ✅ Full access |
|
|
47
|
-
|
|
|
48
|
-
|
|
|
49
|
-
|
|
|
50
|
-
|
|
|
51
|
-
|
|
|
49
|
+
| Sync Direction | Studio → Local (one-way) | Bidirectional |
|
|
50
|
+
| Per-type Sync Direction | ❌ | ✅ Scripts / Values / Containers / Data / Services |
|
|
51
|
+
| Per-type Apply Mode | ❌ | ✅ Auto / Manual |
|
|
52
|
+
| Full Sync | ❌ | ✅ |
|
|
53
|
+
| Resync / Rebuild state | ❌ | ✅ |
|
|
54
|
+
| Change History | ❌ | ✅ |
|
|
55
|
+
| Multi-place Sync | ❌ | ✅ Up to 3 places, each with isolated storage |
|
|
56
|
+
| Advanced tool coverage | Core set | Broader advanced set |
|
|
57
|
+
| AI token efficiency | Standard | Better with bulk / high-leverage actions |
|
|
@@ -1,95 +1,255 @@
|
|
|
1
|
-
# Roblox MCP
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
1
|
+
# Roblox MCP Tools
|
|
2
|
+
|
|
3
|
+
For detailed parameters, check MCP tool definitions directly.
|
|
4
|
+
|
|
5
|
+
Sync policy:
|
|
6
|
+
- Basic: Studio -> Local one-way sync
|
|
7
|
+
- Pro: Bidirectional sync + broader advanced action coverage (better AI token efficiency with bulk workflows)
|
|
8
|
+
|
|
9
|
+
## Query Instances (Mixed)
|
|
10
|
+
|
|
11
|
+
| Action | Description | Tier |
|
|
12
|
+
|--------|-------------|------|
|
|
13
|
+
| `get` | Get instance properties by path | Basic |
|
|
14
|
+
| `children` | Get immediate children or all descendants | Basic |
|
|
15
|
+
| `find_child` | Find first child by name and optional class filter | Basic |
|
|
16
|
+
| `find_descendant` | Find first descendant by name | Basic |
|
|
17
|
+
| `wait_for_child` | Wait for child to appear (with timeout) | Basic |
|
|
18
|
+
| `class_info` | Get class information and valid properties | Basic |
|
|
19
|
+
| `search_name` | Search instances by name pattern (supports wildcards) | Basic |
|
|
20
|
+
| `search_class` | Search instances by class name | Basic |
|
|
21
|
+
| `file_tree` | Get file tree structure from root | Pro |
|
|
22
|
+
| `project_structure` | Get complete project structure | Pro |
|
|
23
|
+
| `descendants` | Get all descendants of an instance | Pro |
|
|
24
|
+
| `ancestors` | Get all ancestors of an instance | Pro |
|
|
25
|
+
| `search_property` | Search instances by property value | Pro |
|
|
26
|
+
| `search_tag` | Search instances by tag | Pro |
|
|
27
|
+
|
|
28
|
+
## Mutate Instances (Mixed)
|
|
29
|
+
|
|
30
|
+
| Action | Description | Tier |
|
|
31
|
+
|--------|-------------|------|
|
|
32
|
+
| `create` | Create a new instance | Basic |
|
|
33
|
+
| `create_with_props` | Create instance with initial properties | Basic |
|
|
34
|
+
| `delete` | Delete an instance | Basic |
|
|
35
|
+
| `clone` | Clone an instance | Basic |
|
|
36
|
+
| `move` | Move instance to new parent | Basic |
|
|
37
|
+
| `rename` | Rename an instance | Basic |
|
|
38
|
+
| `pivot` | Set pivot position or CFrame | Basic |
|
|
39
|
+
| `create_tree` | Create hierarchical instance tree | Pro |
|
|
40
|
+
| `mass_create` | Create multiple instances at once | Pro |
|
|
41
|
+
| `mass_delete` | Delete multiple instances | Pro |
|
|
42
|
+
| `mass_duplicate` | Duplicate multiple instances | Pro |
|
|
43
|
+
| `smart_duplicate` | Duplicate with spacing and count | Pro |
|
|
44
|
+
|
|
45
|
+
## Manage Properties (Mixed)
|
|
46
|
+
|
|
47
|
+
| Action | Description | Tier |
|
|
48
|
+
|--------|-------------|------|
|
|
49
|
+
| `get` | Get a single property value | Basic |
|
|
50
|
+
| `set` | Set a single property value | Basic |
|
|
51
|
+
| `get_all` | Get all properties of an instance | Basic |
|
|
52
|
+
| `set_multiple` | Set multiple properties at once | Basic |
|
|
53
|
+
| `get_attr` | Get attribute value | Basic |
|
|
54
|
+
| `set_attr` | Set attribute value | Basic |
|
|
55
|
+
| `get_all_attrs` | Get all attributes | Basic |
|
|
56
|
+
| `delete_attr` | Delete an attribute | Basic |
|
|
57
|
+
| `add_tag` | Add a tag to instance | Basic |
|
|
58
|
+
| `remove_tag` | Remove a tag from instance | Basic |
|
|
59
|
+
| `check_tag` | Check if instance has a tag | Basic |
|
|
60
|
+
| `get_tags` | Get all tags on an instance | Basic |
|
|
61
|
+
| `get_tagged` | Get all instances with a specific tag | Basic |
|
|
62
|
+
| `set_calculated` | Set property using mathematical expression | Pro |
|
|
63
|
+
| `set_relative` | Set property relative to current value | Pro |
|
|
64
|
+
| `mass_set` | Set property on multiple instances | Pro |
|
|
65
|
+
| `mass_get` | Get property from multiple instances | Pro |
|
|
66
|
+
| `modify_children` | Modify all children of a parent | Pro |
|
|
67
|
+
|
|
68
|
+
## Manage Scripts (Mixed)
|
|
69
|
+
|
|
70
|
+
| Action | Description | Tier |
|
|
71
|
+
|--------|-------------|------|
|
|
72
|
+
| `get_source` | Get script source code | Basic |
|
|
73
|
+
| `set_source` | Set script source code | Basic |
|
|
74
|
+
| `create` | Create a new script | Basic |
|
|
75
|
+
| `delete` | Delete a script | Basic |
|
|
76
|
+
| `edit_replace` | Replace specific lines in script | Basic |
|
|
77
|
+
| `edit_insert` | Insert lines at position | Basic |
|
|
78
|
+
| `edit_delete` | Delete specific lines | Basic |
|
|
79
|
+
| `search` | Search for text in script | Basic |
|
|
80
|
+
| `get_dependencies` | Get script dependencies | Basic |
|
|
81
|
+
| `replace` | Batch replace across scripts | Pro |
|
|
82
|
+
|
|
83
|
+
## Manage Lighting (Pro)
|
|
84
|
+
|
|
85
|
+
| Action | Description | Tier |
|
|
86
|
+
|--------|-------------|------|
|
|
87
|
+
| `lighting` | Set Lighting service properties | Pro |
|
|
88
|
+
| `atmosphere` | Set Atmosphere properties | Pro |
|
|
89
|
+
| `sky` | Set Sky properties | Pro |
|
|
90
|
+
| `terrain_props` | Set Terrain water/visual properties | Pro |
|
|
91
|
+
| `time` | Set time of day | Pro |
|
|
92
|
+
|
|
93
|
+
## Manage Selection (Mixed)
|
|
94
|
+
|
|
95
|
+
| Action | Description | Tier |
|
|
96
|
+
|--------|-------------|------|
|
|
97
|
+
| `get` | Get current selection | Basic |
|
|
98
|
+
| `set` | Replace current selection | Basic |
|
|
99
|
+
| `clear` | Clear selection | Basic |
|
|
100
|
+
| `cached` | Get cached selection without round-trip | Basic |
|
|
101
|
+
| `context` | Get detailed context with source and properties | Pro |
|
|
102
|
+
| `details` | Get hierarchical details with ancestors/descendants | Pro |
|
|
103
|
+
| `add` | Add items to selection | Pro |
|
|
104
|
+
| `remove` | Remove items from selection | Pro |
|
|
105
|
+
| `watch` | Monitor selection changes | Pro |
|
|
106
|
+
|
|
107
|
+
## Manage Camera (Basic)
|
|
108
|
+
|
|
109
|
+
| Action | Description | Tier |
|
|
110
|
+
|--------|-------------|------|
|
|
111
|
+
| `info` | Get camera position, rotation, FOV, viewport size | Basic |
|
|
112
|
+
| `focus_path` | Move camera to focus on instance | Basic |
|
|
113
|
+
| `focus_position` | Move camera to focus on position | Basic |
|
|
114
|
+
| `suggest` | Get suggested camera view for target | Basic |
|
|
115
|
+
|
|
116
|
+
## Manage Tween (Pro)
|
|
117
|
+
|
|
118
|
+
| Action | Description | Tier |
|
|
119
|
+
|--------|-------------|------|
|
|
120
|
+
| `create` | Create a tween with target properties | Pro |
|
|
121
|
+
| `play` | Play a created tween | Pro |
|
|
122
|
+
| `pause` | Pause a running tween | Pro |
|
|
123
|
+
| `cancel` | Cancel a tween | Pro |
|
|
124
|
+
|
|
125
|
+
## Manage Audio (Pro)
|
|
126
|
+
|
|
127
|
+
| Action | Description | Tier |
|
|
128
|
+
|--------|-------------|------|
|
|
129
|
+
| `play` | Play a sound (creates Sound if needed) | Pro |
|
|
130
|
+
| `stop` | Stop a playing sound | Pro |
|
|
131
|
+
| `pause` | Pause a playing sound | Pro |
|
|
132
|
+
| `resume` | Resume a paused sound | Pro |
|
|
133
|
+
| `set_listener` | Set audio listener type/target | Pro |
|
|
134
|
+
|
|
135
|
+
## Manage Animation (Pro)
|
|
136
|
+
|
|
137
|
+
| Action | Description | Tier |
|
|
138
|
+
|--------|-------------|------|
|
|
139
|
+
| `load` | Load animation on Humanoid/AnimationController | Pro |
|
|
140
|
+
| `play` | Play a loaded animation track | Pro |
|
|
141
|
+
| `stop` | Stop a playing animation | Pro |
|
|
142
|
+
| `get_tracks` | List all loaded animation tracks | Pro |
|
|
143
|
+
|
|
144
|
+
## Manage Physics (Pro)
|
|
145
|
+
|
|
146
|
+
| Action | Description | Tier |
|
|
147
|
+
|--------|-------------|------|
|
|
148
|
+
| `register_group` | Register a collision group | Pro |
|
|
149
|
+
| `set_collidable` | Set whether two groups can collide | Pro |
|
|
150
|
+
| `get_groups` | List all registered collision groups | Pro |
|
|
151
|
+
|
|
152
|
+
## Manage Effects (Pro)
|
|
153
|
+
|
|
154
|
+
| Action | Description | Tier |
|
|
155
|
+
|--------|-------------|------|
|
|
156
|
+
| `emit` | Emit particles from ParticleEmitter | Pro |
|
|
157
|
+
| `clear` | Clear all particles | Pro |
|
|
158
|
+
| `toggle` | Enable or disable effect | Pro |
|
|
159
|
+
|
|
160
|
+
## Manage Terrain (Pro)
|
|
161
|
+
|
|
162
|
+
| Action | Description | Tier |
|
|
163
|
+
|--------|-------------|------|
|
|
164
|
+
| `fill_block` | Fill block-shaped terrain | Pro |
|
|
165
|
+
| `fill_ball` | Fill sphere-shaped terrain | Pro |
|
|
166
|
+
| `fill_cylinder` | Fill cylinder-shaped terrain | Pro |
|
|
167
|
+
| `fill_wedge` | Fill wedge-shaped terrain | Pro |
|
|
168
|
+
| `clear_region` | Clear terrain in region | Pro |
|
|
169
|
+
| `clear_bounds` | Clear terrain in bounds | Pro |
|
|
170
|
+
| `replace_material` | Replace material in region | Pro |
|
|
171
|
+
| `colors_get` | Get material colors | Pro |
|
|
172
|
+
| `colors_set` | Set material colors | Pro |
|
|
173
|
+
| `read_voxel` | Read single voxel data | Pro |
|
|
174
|
+
| `read_voxels` | Read bulk voxel data | Pro |
|
|
175
|
+
| `write_voxels` | Write bulk voxel data | Pro |
|
|
176
|
+
| `generate` | Generate procedural terrain | Pro |
|
|
177
|
+
| `smooth` | Smooth terrain | Pro |
|
|
178
|
+
|
|
179
|
+
## Spatial Query (Pro)
|
|
180
|
+
|
|
181
|
+
| Action | Description | Tier |
|
|
182
|
+
|--------|-------------|------|
|
|
183
|
+
| `raycast` | Cast a single ray | Pro |
|
|
184
|
+
| `find_ground` | Find ground position below point | Pro |
|
|
185
|
+
| `check_placement` | Check if placement is collision-free | Pro |
|
|
186
|
+
| `multi_raycast` | Cast multiple rays in batch | Pro |
|
|
187
|
+
| `scan_area` | Generate heightmap of area | Pro |
|
|
188
|
+
| `find_flat` | Find flat areas for building | Pro |
|
|
189
|
+
| `find_spawn` | Find suitable spawn positions | Pro |
|
|
190
|
+
| `analyze_walkable` | Analyze walkability grid | Pro |
|
|
191
|
+
| `spatial_map` | Get all BasePart positions | Pro |
|
|
192
|
+
| `find_space` | Find empty space for object | Pro |
|
|
193
|
+
| `bounds` | Get bounding box of instances | Pro |
|
|
194
|
+
| `snap_grid` | Snap position to grid | Pro |
|
|
195
|
+
| `collision` | Check AABB collision | Pro |
|
|
196
|
+
|
|
197
|
+
## Manage Assets (Pro)
|
|
198
|
+
|
|
199
|
+
| Action | Description | Tier |
|
|
200
|
+
|--------|-------------|------|
|
|
201
|
+
| `insert` | Insert model by asset ID | Pro |
|
|
202
|
+
| `info` | Get asset metadata | Pro |
|
|
203
|
+
| `search` | Search Creator Store | Pro |
|
|
204
|
+
| `search_insert` | Search and insert first match | Pro |
|
|
205
|
+
| `insert_free` | Insert free model | Pro |
|
|
206
|
+
| `insert_package` | Insert package | Pro |
|
|
207
|
+
| `export` | Export current selection | Pro |
|
|
208
|
+
|
|
209
|
+
## Manage Sync (Pro)
|
|
210
|
+
|
|
211
|
+
| Action | Description | Tier |
|
|
212
|
+
|--------|-------------|------|
|
|
213
|
+
| `status` | Get sync status for a place | Pro |
|
|
214
|
+
| `config` | Get/set sync configuration | Pro |
|
|
215
|
+
| `history` | Get change history | Pro |
|
|
216
|
+
| `directions` | Get/set per-type sync directions | Pro |
|
|
217
|
+
| `read_file` | Read a synced file | Pro |
|
|
218
|
+
| `write_file` | Write to a synced file | Pro |
|
|
219
|
+
|
|
220
|
+
## Workspace State (Pro)
|
|
221
|
+
|
|
222
|
+
| Action | Description | Tier |
|
|
223
|
+
|--------|-------------|------|
|
|
224
|
+
| `sync` | Fetch current Workspace state | Pro |
|
|
225
|
+
| `snapshot` | Get full instance tree structure | Pro |
|
|
226
|
+
| `changes` | Get recent changes | Pro |
|
|
227
|
+
| `viewport` | Get camera and viewport info | Pro |
|
|
228
|
+
|
|
229
|
+
## Manage Logs (Basic)
|
|
230
|
+
|
|
231
|
+
| Action | Description | Tier |
|
|
232
|
+
|--------|-------------|------|
|
|
233
|
+
| `get` | Get filtered logs | Basic |
|
|
234
|
+
| `clear` | Clear log buffer | Basic |
|
|
235
|
+
| `errors` | Get recent errors only | Basic |
|
|
236
|
+
|
|
237
|
+
## System Info (Mixed)
|
|
238
|
+
|
|
239
|
+
| Action | Description | Tier |
|
|
240
|
+
|--------|-------------|------|
|
|
241
|
+
| `ping` | Test connection | Basic |
|
|
242
|
+
| `connection` | Get server/plugin connection info | Basic |
|
|
243
|
+
| `usage` | Get current tier (basic/pro) | Basic |
|
|
244
|
+
| `place_info` | Get place ID, name, creator | Pro |
|
|
245
|
+
| `services` | List all Roblox services | Pro |
|
|
246
|
+
| `studio_settings` | Get Studio preferences | Pro |
|
|
247
|
+
| `run_command` | Execute Studio command | Pro |
|
|
248
|
+
|
|
249
|
+
## Batch Execute (Pro)
|
|
250
|
+
|
|
251
|
+
Execute multiple commands in a single batch. Each command specifies a tool name and arguments. Commands execute sequentially with optional continue-on-error behavior.
|
|
252
|
+
|
|
253
|
+
## Execute Luau (Pro)
|
|
254
|
+
|
|
255
|
+
Execute arbitrary Luau code in Roblox Studio sandbox. Blocked services: HttpService, DataStoreService, MessagingService. Cannot access CoreGui/CorePackages.
|
package/docs/es/README.md
CHANGED
|
@@ -41,6 +41,12 @@ Revisa logs de errores, encuentra problemas y corrige
|
|
|
41
41
|
|
|
42
42
|
Toma solo 5 minutos. 👉 [Ver guía de instalación](installation/README.md)
|
|
43
43
|
|
|
44
|
+
## Comienza con Pro
|
|
45
|
+
|
|
46
|
+
Crea sin límites. Sync bidireccional, capacidades de creación avanzadas y eficiencia de tokens de IA — todo en una sola actualización.
|
|
47
|
+
|
|
48
|
+
👉 [Guía de actualización Pro](pro-upgrade.md)
|
|
49
|
+
|
|
44
50
|
## Enlaces
|
|
45
51
|
- [GitHub](https://github.com/hope1026/roblox-mcp)
|
|
46
52
|
- [Reportar problemas](https://github.com/hope1026/roblox-mcp/issues)
|
|
@@ -22,11 +22,12 @@ Configura el servidor MCP en tu app de IA para que pueda comunicarse con Roblox
|
|
|
22
22
|
|
|
23
23
|
| App de IA | Cómo configurar |
|
|
24
24
|
|-----------|----------------|
|
|
25
|
-
| **Claude Code**
|
|
26
|
-
| **Claude Desktop** | [
|
|
27
|
-
| **
|
|
28
|
-
| **
|
|
29
|
-
| **
|
|
25
|
+
| **Claude Code** | [Instrucciones](ai-apps/claude-code.md) |
|
|
26
|
+
| **Claude Desktop** | [Instrucciones](ai-apps/claude-app.md) |
|
|
27
|
+
| **Codex CLI** | [Instrucciones](ai-apps/codex-cli.md) |
|
|
28
|
+
| **Codex Desktop** | [Instrucciones](ai-apps/codex-app.md) |
|
|
29
|
+
| **Gemini CLI** | [Instrucciones](ai-apps/gemini-cli.md) |
|
|
30
|
+
| **Antigravity** | [Instrucciones](ai-apps/antigravity.md) |
|
|
30
31
|
|
|
31
32
|
> **Nota**: Funciona con cualquier app compatible con MCP. El comando es:
|
|
32
33
|
> ```bash
|