@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.
Files changed (38) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/CHANGELOG.md +45 -10
  3. package/README.md +6 -0
  4. package/docs/en/installation/roblox-plugin.md +10 -5
  5. package/docs/en/pro-upgrade.md +36 -30
  6. package/docs/en/tools/overview.md +255 -95
  7. package/docs/es/README.md +6 -0
  8. package/docs/es/installation/README.md +6 -5
  9. package/docs/es/installation/roblox-plugin.md +29 -24
  10. package/docs/es/pro-upgrade.md +39 -33
  11. package/docs/es/tools/overview.md +4 -0
  12. package/docs/id/README.md +6 -0
  13. package/docs/id/installation/roblox-plugin.md +28 -23
  14. package/docs/id/pro-upgrade.md +36 -30
  15. package/docs/id/tools/overview.md +4 -0
  16. package/docs/ja/README.md +6 -0
  17. package/docs/ja/installation/README.md +5 -5
  18. package/docs/ja/installation/roblox-plugin.md +32 -27
  19. package/docs/ja/pro-upgrade.md +38 -32
  20. package/docs/ja/tools/overview.md +4 -0
  21. package/docs/ko/README.md +6 -0
  22. package/docs/ko/installation/roblox-plugin.md +10 -5
  23. package/docs/ko/pro-upgrade.md +36 -30
  24. package/docs/ko/tools/overview.md +255 -95
  25. package/docs/pt-br/README.md +6 -0
  26. package/docs/pt-br/installation/roblox-plugin.md +28 -23
  27. package/docs/pt-br/pro-upgrade.md +39 -33
  28. package/docs/pt-br/tools/overview.md +4 -0
  29. package/package.json +4 -2
  30. package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json +1 -1
  31. package/plugins/weppy-roblox-mcp/dist/index.js +70 -98
  32. package/plugins/weppy-roblox-mcp/skills/roblox-game-dev/SKILL.md +0 -155
  33. package/plugins/weppy-roblox-mcp/skills/roblox-game-dev/references/animations.json +0 -34
  34. package/plugins/weppy-roblox-mcp/skills/roblox-game-dev/references/mcp-tools.md +0 -220
  35. package/plugins/weppy-roblox-mcp/skills/roblox-sync/SKILL.md +0 -492
  36. package/plugins/weppy-roblox-mcp/skills/roblox-sync/scripts/post-verify.sh +0 -162
  37. package/plugins/weppy-roblox-mcp/skills/roblox-sync/scripts/pre-check.sh +0 -307
  38. 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.1.11"
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.1.11",
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
- - update test
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
- - improve stability
67
+ - Improve stability
34
68
 
35
69
 
36
70
  ## [0.1.3] - 2026-02-07
37
71
 
38
72
  ### Features
39
- - add tool history and statistics tracking system
40
- - add version info display in plugin UI
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
- #### 140 Tools Available
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
- **Pro (72 tools)**
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, Cursor, Codex CLI, Gemini CLI, and more
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** - 68 essential tools free forever
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. Download `weppy-roblox-mcp-basic-v{version}.zip` from [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
8
- 2. Extract the ZIP file — you'll find the `roblox-plugin/WeppyRobloxMCP.rbxm` file and setup guides inside
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 **W-MCP**
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
  ![Plugin Main Screen](../../assets/screenshots/plugin_main.png)
50
55
 
51
56
  ## 5. Settings (Optional)
52
57
 
53
- Click the settings button in the top right of the plugin to change various options.
58
+ Click the settings button in the top right of the plugin to change options.
54
59
 
55
60
  ![Settings Screen](../../assets/screenshots/settings.png)
56
61
 
@@ -2,50 +2,56 @@
2
2
 
3
3
  ## Why Pro?
4
4
 
5
- **Save AI Tokens** - One bulk command replaces dozens of individual operations. Less back-and-forth means lower token usage and faster results.
5
+ ### Bidirectional Sync built for real development workflows
6
6
 
7
- **Build Complete Games** - Terrain, environment, assets, and spatial tools let you create polished game worlds, not just prototypes.
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
- ## What Pro Unlocks
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
- | Category | What you can do |
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
- ## How to Purchase
18
+ Bulk and advanced actions reduce repetitive round trips — do more per prompt.
21
19
 
22
- ### Step 1: Buy on Gumroad
20
+ ### Broader advanced capabilities
23
21
 
24
- 1. Go to [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin)
25
- 2. Download the plugin
22
+ Terrain generation, asset search, spatial analysis, animation, audio, and production-scale automation.
26
23
 
27
- ### Step 2: Install Plugin
24
+ ## Subscription & Download
28
25
 
29
- 1. Open Roblox Studio
30
- 2. Go to Plugins tab → **Plugins Folder**
31
- 3. **Delete** the existing `WeppyRobloxMCP.rbxm` (Basic version)
32
- 4. **Copy** the downloaded `WeppyRobloxMCP-Pro.rbxm` into the folder
33
- 5. Restart Roblox Studio
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 the W-MCP plugin
38
- 2. Check that "Pro" badge is displayed
39
- 3. All tools are now available!
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
- | Instance, Script, Property | ✅ Full access | ✅ Full access |
47
+ | Script, Instance, Property management | ✅ Full access | ✅ Full access |
46
48
  | Selection, Tag, Camera, Log | ✅ Full access | ✅ Full access |
47
- | Bulk Operations | | Unlimited |
48
- | Asset Search & Insert | | ✅ Unlimited |
49
- | Terrain Generation | | ✅ Unlimited |
50
- | Environment, Raycast, Spatial | | ✅ Unlimited |
51
- | Visualization Tools | | ✅ Unlimited |
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 Features
2
-
3
- Connect AI to Roblox Studio and automate various tasks. Here's what you can do by category.
4
-
5
- ---
6
-
7
- ## Basic (Free)
8
-
9
- ### Object Management
10
-
11
- Create, clone, delete, and move game objects like parts, models, and folders. Tasks like "Make a red part" or "Clone this model and place it next to it" are possible.
12
-
13
- ### Property Settings
14
-
15
- Read and change all properties of objects like size, color, position, and material. You can change multiple properties at once or adjust them relatively based on current values.
16
-
17
- ### Scripts
18
-
19
- Create new scripts, read existing code, and modify it. You can edit specific lines, search for text within scripts, or identify dependencies to see which modules are referenced.
20
-
21
- ### Selection
22
-
23
- Check currently selected objects, change selections, and clear selections. Essential for understanding and controlling what you're working with in Studio.
24
-
25
- ### Search
26
-
27
- Find objects in your game by name or class (type).
28
-
29
- ### Tags
30
-
31
- Add or remove tags from objects and find all objects with a specific tag at once. Useful for managing groups of similar objects.
32
-
33
- ### Camera
34
-
35
- Move the camera to specific objects or positions. Convenient for quickly viewing the area you're working on.
36
-
37
- ### Logs
38
-
39
- Check output logs and errors that occurred during game execution. Helps find and fix bugs.
40
-
41
- ### Connection
42
-
43
- Check the connection status and usage between MCP server and Roblox Studio.
44
-
45
- ---
46
-
47
- ## Pro
48
-
49
- Upgrade to Pro if you need more powerful features.
50
-
51
- ### Advanced Selection
52
-
53
- Get detailed selection context with properties and source code, view selection hierarchy, add/remove items from selection, query Place information and game services. Useful for advanced workflows and automation.
54
-
55
- ### Advanced Scripts
56
-
57
- Batch replace content in multiple scripts or execute Luau code instantly. Useful for repetitive code modifications or quick testing.
58
-
59
- ### Advanced Search
60
-
61
- Explore the entire file tree or search for objects by property or tag. Get a complete view of your project structure and query all descendants or ancestors of specific objects.
62
-
63
- ### Bulk Operations
64
-
65
- Create, delete, modify, or duplicate hundreds of objects at once. Quickly handle large-scale tasks like planting trees on a map, changing the color of all parts, or placing objects according to patterns.
66
-
67
- ### Assets
68
-
69
- Search the Roblox Creator Store for free models and insert them instantly. Add assets through conversation like "Find a medieval castle model" or "Insert a weapon model".
70
-
71
- ### Environment Settings
72
-
73
- Configure lighting, sky, fog, terrain properties, and time of day with natural language. Requests like "Change to sunset vibes" or "Set time to midnight" are possible.
74
-
75
- ### State Management
76
-
77
- Save the current state of Workspace as a snapshot, check recent changes and viewport state. Helps understand current state during complex tasks.
78
-
79
- ### Spatial Analysis
80
-
81
- Accurately determine object size and position, find empty spaces, and check for collisions. You can also align objects to a grid.
82
-
83
- ### Raycast
84
-
85
- Shoot invisible rays to find collision points with terrain or objects. Essential for game level design including finding ground positions, checking if objects can be placed, finding spawn locations, and analyzing walkable areas.
86
-
87
- ### Terrain
88
-
89
- Fill, carve, and smooth terrain in various shapes like blocks, spheres, cylinders, and wedges. Change materials and colors, or procedurally generate natural terrain with mountains and rivers.
90
-
91
- ### Visualization
92
-
93
- Display areas, markers, and lines on screen to visually confirm the space you're working in. Useful for debugging and level design review.
94
-
95
- 👉 [Pro Upgrade Guide](../pro-upgrade.md)
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** (Recomendado) | [claude-code.md](ai-apps/claude-code.md) |
26
- | **Claude Desktop** | [claude-desktop.md](ai-apps/claude-desktop.md) |
27
- | **Cline** | [cline.md](ai-apps/cline.md) |
28
- | **Roo Code** | [roo-code.md](ai-apps/roo-code.md) |
29
- | **Cursor** | [cursor.md](ai-apps/cursor.md) |
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