@weppy/roblox-mcp 0.1.7 → 0.1.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.
Files changed (72) hide show
  1. package/.claude-plugin/marketplace.json +3 -3
  2. package/CHANGELOG.md +5 -9
  3. package/README.md +38 -26
  4. package/docs/en/installation/README.md +51 -0
  5. package/docs/en/installation/roblox-plugin.md +6 -6
  6. package/docs/en/pro-upgrade.md +5 -6
  7. package/docs/en/tools/overview.md +87 -230
  8. package/docs/es/README.md +27 -28
  9. package/docs/es/installation/README.md +44 -0
  10. package/docs/es/installation/roblox-plugin.md +6 -6
  11. package/docs/es/pro-upgrade.md +5 -6
  12. package/docs/es/tools/overview.md +88 -231
  13. package/docs/id/README.md +39 -27
  14. package/docs/id/installation/README.md +51 -0
  15. package/docs/id/installation/roblox-plugin.md +6 -6
  16. package/docs/id/pro-upgrade.md +5 -6
  17. package/docs/id/tools/overview.md +88 -231
  18. package/docs/ja/README.md +40 -28
  19. package/docs/ja/installation/README.md +51 -0
  20. package/docs/ja/installation/roblox-plugin.md +6 -6
  21. package/docs/ja/pro-upgrade.md +5 -6
  22. package/docs/ja/tools/overview.md +88 -231
  23. package/docs/ko/README.md +39 -27
  24. package/docs/ko/installation/README.md +51 -0
  25. package/docs/ko/installation/roblox-plugin.md +6 -6
  26. package/docs/ko/pro-upgrade.md +5 -6
  27. package/docs/ko/tools/overview.md +88 -231
  28. package/docs/pt-br/README.md +39 -27
  29. package/docs/pt-br/installation/README.md +51 -0
  30. package/docs/pt-br/installation/roblox-plugin.md +6 -6
  31. package/docs/pt-br/pro-upgrade.md +5 -6
  32. package/docs/pt-br/tools/overview.md +88 -231
  33. package/package.json +1 -1
  34. package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json +1 -1
  35. package/plugins/weppy-roblox-mcp/dist/index.js +1 -1
  36. package/plugins/weppy-roblox-mcp/skills/roblox-game-dev/references/mcp-tools.md +9 -4
  37. /package/docs/en/installation/{antigravity.md → ai-apps/antigravity.md} +0 -0
  38. /package/docs/en/installation/{claude-app.md → ai-apps/claude-app.md} +0 -0
  39. /package/docs/en/installation/{claude-code.md → ai-apps/claude-code.md} +0 -0
  40. /package/docs/en/installation/{codex-app.md → ai-apps/codex-app.md} +0 -0
  41. /package/docs/en/installation/{codex-cli.md → ai-apps/codex-cli.md} +0 -0
  42. /package/docs/en/installation/{gemini-cli.md → ai-apps/gemini-cli.md} +0 -0
  43. /package/docs/es/installation/{antigravity.md → ai-apps/antigravity.md} +0 -0
  44. /package/docs/es/installation/{claude-app.md → ai-apps/claude-app.md} +0 -0
  45. /package/docs/es/installation/{claude-code.md → ai-apps/claude-code.md} +0 -0
  46. /package/docs/es/installation/{codex-app.md → ai-apps/codex-app.md} +0 -0
  47. /package/docs/es/installation/{codex-cli.md → ai-apps/codex-cli.md} +0 -0
  48. /package/docs/es/installation/{gemini-cli.md → ai-apps/gemini-cli.md} +0 -0
  49. /package/docs/id/installation/{antigravity.md → ai-apps/antigravity.md} +0 -0
  50. /package/docs/id/installation/{claude-app.md → ai-apps/claude-app.md} +0 -0
  51. /package/docs/id/installation/{claude-code.md → ai-apps/claude-code.md} +0 -0
  52. /package/docs/id/installation/{codex-app.md → ai-apps/codex-app.md} +0 -0
  53. /package/docs/id/installation/{codex-cli.md → ai-apps/codex-cli.md} +0 -0
  54. /package/docs/id/installation/{gemini-cli.md → ai-apps/gemini-cli.md} +0 -0
  55. /package/docs/ja/installation/{antigravity.md → ai-apps/antigravity.md} +0 -0
  56. /package/docs/ja/installation/{claude-app.md → ai-apps/claude-app.md} +0 -0
  57. /package/docs/ja/installation/{claude-code.md → ai-apps/claude-code.md} +0 -0
  58. /package/docs/ja/installation/{codex-app.md → ai-apps/codex-app.md} +0 -0
  59. /package/docs/ja/installation/{codex-cli.md → ai-apps/codex-cli.md} +0 -0
  60. /package/docs/ja/installation/{gemini-cli.md → ai-apps/gemini-cli.md} +0 -0
  61. /package/docs/ko/installation/{antigravity.md → ai-apps/antigravity.md} +0 -0
  62. /package/docs/ko/installation/{claude-app.md → ai-apps/claude-app.md} +0 -0
  63. /package/docs/ko/installation/{claude-code.md → ai-apps/claude-code.md} +0 -0
  64. /package/docs/ko/installation/{codex-app.md → ai-apps/codex-app.md} +0 -0
  65. /package/docs/ko/installation/{codex-cli.md → ai-apps/codex-cli.md} +0 -0
  66. /package/docs/ko/installation/{gemini-cli.md → ai-apps/gemini-cli.md} +0 -0
  67. /package/docs/pt-br/installation/{antigravity.md → ai-apps/antigravity.md} +0 -0
  68. /package/docs/pt-br/installation/{claude-app.md → ai-apps/claude-app.md} +0 -0
  69. /package/docs/pt-br/installation/{claude-code.md → ai-apps/claude-code.md} +0 -0
  70. /package/docs/pt-br/installation/{codex-app.md → ai-apps/codex-app.md} +0 -0
  71. /package/docs/pt-br/installation/{codex-cli.md → ai-apps/codex-cli.md} +0 -0
  72. /package/docs/pt-br/installation/{gemini-cli.md → ai-apps/gemini-cli.md} +0 -0
@@ -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.7"
9
+ "version": "0.1.9"
10
10
  },
11
11
  "plugins": [
12
12
  {
13
13
  "name": "weppy-roblox-mcp",
14
- "source": ".plugins/weppy-roblox-mcp",
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.7",
16
+ "version": "0.1.9",
17
17
  "author": {
18
18
  "name": "hope1026"
19
19
  },
package/CHANGELOG.md CHANGED
@@ -4,27 +4,23 @@ All notable changes to this project will be documented in this file.
4
4
 
5
5
 
6
6
 
7
-
8
- ## [0.1.7] - 2026-02-07
9
-
10
-
11
- ## [0.1.6] - 2026-02-07
7
+ ## [0.1.9] - 2026-02-08
12
8
 
13
9
  ### Other Changes
14
10
 
11
+ - update test
15
12
  - refactor: improve stability
16
13
 
17
- ## [0.1.5] - 2026-02-07
18
14
 
19
- ### Other Changes
15
+ ## [0.1.8] - 2026-02-08
20
16
 
21
- - update guide
17
+ ### Fix
18
+ - improve stability
22
19
 
23
20
 
24
21
  ## [0.1.3] - 2026-02-07
25
22
 
26
23
  ### Features
27
-
28
24
  - add tool history and statistics tracking system
29
25
  - add version info display in plugin UI
30
26
 
package/README.md CHANGED
@@ -2,46 +2,58 @@
2
2
 
3
3
  **English** | [한국어](docs/ko/README.md) | [日本語](docs/ja/README.md) | [Español](docs/es/README.md) | [Português](docs/pt-br/README.md) | [Bahasa Indonesia](docs/id/README.md)
4
4
 
5
- > Control Roblox Studio with AI.
5
+ > Tell AI what you want, and it happens in Roblox Studio.
6
6
 
7
7
  [![Demo](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
8
8
 
9
- ## Installation
9
+ ## What You Can Do
10
10
 
11
- ### 1. Install Roblox Plugin
11
+ ### Create Complete Games
12
12
 
13
- 👉 [Plugin Installation Guide](docs/en/installation/roblox-plugin.md)
13
+ Just ask "Make a Minecraft-style survival game" or "Create an escape room puzzle game", and AI will design the game structure, build the map, create objects, and write scripts for you. Turn a simple idea into a playable game.
14
14
 
15
- ### 2. Configure MCP Server
15
+ > **Tip**: Ask "Make a plan first", review it, then say "Execute it" for better results.
16
16
 
17
- Works with any AI app that supports MCP. Choose your AI app:
17
+ ### Create and Place Objects
18
18
 
19
- | AI App | Setup Guide |
20
- |--------|-------------|
21
- | Claude Code | [Setup](docs/en/installation/claude-code.md) |
22
- | Claude Desktop | [Setup](docs/en/installation/claude-app.md) |
23
- | Codex CLI | [Setup](docs/en/installation/codex-cli.md) |
24
- | Codex Desktop | [Setup](docs/en/installation/codex-app.md) |
25
- | Gemini CLI | [Setup](docs/en/installation/gemini-cli.md) |
26
- | Cursor, Windsurf, etc. | [Setup](docs/en/installation/antigravity.md) |
19
+ Say "Make a red brick house" or "Plant 10 trees in a row" and AI creates them directly in Roblox Studio. Create one object or hundreds at once.
27
20
 
28
- ## Tools
21
+ ### Write and Modify Scripts
29
22
 
30
- 👉 [Full Tools List](docs/en/tools/overview.md)
23
+ Ask "Make particles appear when players jump" or "Find the bug in this script" and AI writes and fixes code for you. It analyzes existing scripts and understands dependencies too.
31
24
 
32
- ## Troubleshooting
25
+ ### Set Scene Atmosphere
33
26
 
34
- - **"Not Connected"**: Click Connect button in the plugin again
35
- - **Port**: Uses port 3002 (localhost only)
27
+ Just say "Change to sunset vibes" or "Make it dark like a rainy day" and AI automatically adjusts lighting, sky, and fog.
36
28
 
37
- ## Links
29
+ ### Generate Terrain
38
30
 
39
- - [GitHub](https://github.com/hope1026/roblox-mcp)
40
- - [Issue Report](https://github.com/hope1026/roblox-mcp/issues)
31
+ Create natural landscapes like mountains, rivers, plains, and caves through conversation. Customize materials, colors, and sizes freely.
32
+
33
+ ### Search and Insert Assets
34
+
35
+ Search the Creator Store for free models and assets, then add them to your game instantly. Just say "Find a medieval castle model and insert it".
36
+
37
+ ### Spatial Analysis and Placement
38
+
39
+ AI handles spatial tasks like "Find empty space in this area" or "Analyze where monsters can walk".
40
+
41
+ ### Debugging and Analysis
41
42
 
42
- ## License
43
+ Check game error logs, find problems, and fix them together with AI.
43
44
 
44
- Free to use for game development.
45
+ > [View all features](docs/en/tools/overview.md)
45
46
 
46
- **Allowed**: Game development, commercial games, personal projects
47
- ❌ **Not Allowed**: Software resale, creating competing products
47
+ ## Getting Started
48
+
49
+ Installation is complete in two steps:
50
+
51
+ 1. **Install Roblox Studio Plugin** — Acts as a bridge between Studio and AI
52
+ 2. **Register MCP Server with AI App** — Configure your AI app to recognize Roblox MCP
53
+
54
+ Takes just 5 minutes. 👉 [View Installation Guide](docs/en/installation/README.md)
55
+
56
+ ## Links
57
+
58
+ - [GitHub](https://github.com/hope1026/roblox-mcp)
59
+ - [Issue Reports](https://github.com/hope1026/roblox-mcp/issues)
@@ -0,0 +1,51 @@
1
+ # Installation Guide
2
+
3
+ To use Roblox MCP, you need to install **two things**.
4
+
5
+ ```
6
+ AI App (Claude, Codex, Gemini, etc.)
7
+
8
+ MCP Server ← Converts AI commands into a format Roblox understands
9
+
10
+ Roblox Studio Plugin ← Executes commands inside Studio
11
+ ```
12
+
13
+ When an AI app says "Create a blue part", the MCP server converts this request, and the Roblox Studio plugin actually creates the part.
14
+
15
+ ---
16
+
17
+ ## Step 1: Install Roblox Studio Plugin
18
+
19
+ Download the plugin file from GitHub, then place it in Roblox Studio's Plugins folder.
20
+
21
+ 👉 [Plugin Installation Guide](roblox-plugin.md)
22
+
23
+ ---
24
+
25
+ ## Step 2: Register MCP Server with AI App
26
+
27
+ Register the MCP server with your AI app. You can use it with any AI app that supports MCP.
28
+
29
+ | AI App | Installation Guide |
30
+ |--------|-------------------|
31
+ | Claude Code | [Setup Instructions](ai-apps/claude-code.md) |
32
+ | Claude Desktop | [Setup Instructions](ai-apps/claude-app.md) |
33
+ | Codex CLI | [Setup Instructions](ai-apps/codex-cli.md) |
34
+ | Codex Desktop | [Setup Instructions](ai-apps/codex-app.md) |
35
+ | Gemini CLI | [Setup Instructions](ai-apps/gemini-cli.md) |
36
+ | Antigravity | [Setup Instructions](ai-apps/antigravity.md) |
37
+
38
+ > Even if your AI app isn't listed above, you can use it if it supports MCP. The MCP server command is `npx -y @weppy/roblox-mcp`.
39
+
40
+ ---
41
+
42
+ ## After Installation
43
+
44
+ 1. Open **Roblox Studio**, go to Plugins tab and click **W-MCP** → **Connect**
45
+ 2. Test in your **AI app** with:
46
+
47
+ ```
48
+ Create a blue part in Roblox Studio
49
+ ```
50
+
51
+ If the part is created successfully, installation is complete!
@@ -32,12 +32,12 @@ The MCP server must be installed. Complete the guide for your AI app first:
32
32
 
33
33
  | AI App | Installation Guide |
34
34
  |--------|-------------------|
35
- | Claude Code | [Setup Guide](claude-code.md) |
36
- | Claude Desktop | [Setup Guide](claude-app.md) |
37
- | Codex CLI | [Setup Guide](codex-cli.md) |
38
- | Codex Desktop | [Setup Guide](codex-app.md) |
39
- | Gemini CLI | [Setup Guide](gemini-cli.md) |
40
- | Cursor, Windsurf, etc. | [Setup Guide](antigravity.md) |
35
+ | Claude Code | [Setup Guide](ai-apps/claude-code.md) |
36
+ | Claude Desktop | [Setup Guide](ai-apps/claude-app.md) |
37
+ | Codex CLI | [Setup Guide](ai-apps/codex-cli.md) |
38
+ | Codex Desktop | [Setup Guide](ai-apps/codex-app.md) |
39
+ | Gemini CLI | [Setup Guide](ai-apps/gemini-cli.md) |
40
+ | Antigravity | [Setup Guide](ai-apps/antigravity.md) |
41
41
 
42
42
  ### Connecting
43
43
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  **Build Complete Games** - Terrain, environment, assets, and spatial tools let you create polished game worlds, not just prototypes.
8
8
 
9
- ## What Pro Unlocks (72 additional tools)
9
+ ## What Pro Unlocks
10
10
 
11
11
  | Category | What you can do |
12
12
  |----------|-----------------|
@@ -21,8 +21,7 @@
21
21
 
22
22
  ### Step 1: Buy on Gumroad
23
23
 
24
- 1. Go to [Gumroad - Weppy Roblox Plugin](https://sunityplugin.gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin
25
- )
24
+ 1. Go to [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin)
26
25
  2. Download the plugin
27
26
 
28
27
  ### Step 2: Install Plugin
@@ -37,12 +36,12 @@
37
36
 
38
37
  1. Open the W-MCP plugin
39
38
  2. Check that "Pro" badge is displayed
40
- 3. All 140 tools are now available!
39
+ 3. All tools are now available!
41
40
 
42
41
  ## Feature Comparison
43
42
 
44
- | Feature | Basic (68 tools) | Pro (140 tools) |
45
- |---------|:----------------:|:---------------:|
43
+ | Feature | Basic | Pro |
44
+ |---------|:-----:|:---:|
46
45
  | Instance, Script, Property | ✅ Full access | ✅ Full access |
47
46
  | Selection, Tag, Camera, Log | ✅ Full access | ✅ Full access |
48
47
  | Bulk Operations | ― | ✅ Unlimited |
@@ -1,238 +1,95 @@
1
- # Roblox MCP Tools
1
+ # Roblox MCP Features
2
2
 
3
- For detailed parameters, refer to the MCP tool definitions directly.
3
+ Connect AI to Roblox Studio and automate various tasks. Here's what you can do by category.
4
4
 
5
5
  ---
6
6
 
7
- ## Basic Tools (68)
8
-
9
- ### Instance - 13
10
-
11
- | Tool | Description |
12
- |------|-------------|
13
- | `create_instance` | Create a new instance |
14
- | `create_instance_with_properties` | Create instance with properties |
15
- | `clone_instance` | Clone an existing instance |
16
- | `delete_instance` | Delete an instance |
17
- | `move_instance` | Move instance to new parent |
18
- | `rename_instance` | Rename an instance |
19
- | `get_instance` | Get instance information |
20
- | `get_instance_children` | Get children of an instance |
21
- | `find_first_child` | Find first child by name |
22
- | `find_first_descendant` | Find first descendant by name |
23
- | `get_class_info` | Get class information |
24
- | `wait_for_child` | Wait for child to exist |
25
- | `pivot_to` | Set Pivot CFrame |
26
-
27
- ### Property - 10
28
-
29
- | Tool | Description |
30
- |------|-------------|
31
- | `get_property` | Get property value |
32
- | `set_property` | Set property value |
33
- | `get_all_properties` | Get all properties |
34
- | `set_multiple_properties` | Set multiple properties at once |
35
- | `set_calculated_property` | Set property with calculated value |
36
- | `set_relative_property` | Set property with relative value |
37
- | `get_attribute` | Get attribute value |
38
- | `set_attribute` | Set attribute value |
39
- | `get_all_attributes` | Get all attributes |
40
- | `delete_attribute` | Delete an attribute |
41
-
42
- ### Script - 9
43
-
44
- | Tool | Description |
45
- |------|-------------|
46
- | `create_script` | Create a new script |
47
- | `get_script_source` | Get script source code |
48
- | `set_script_source` | Update script source code |
49
- | `delete_script` | Delete a script |
50
- | `edit_script_lines` | Edit specific lines |
51
- | `insert_script_lines` | Insert lines |
52
- | `delete_script_lines` | Delete lines |
53
- | `search_in_scripts` | Search within scripts |
54
- | `get_script_dependencies` | Get dependencies |
55
-
56
- ### Selection - 12
57
-
58
- | Tool | Description |
59
- |------|-------------|
60
- | `get_selection` | Get currently selected instances |
61
- | `get_selection_context` | Get selection with context |
62
- | `get_selection_details` | Get detailed selection info |
63
- | `set_selection` | Set instance selection |
64
- | `clear_selection` | Clear selection |
65
- | `add_to_selection` | Add to selection |
66
- | `remove_from_selection` | Remove from selection |
67
- | `get_place_info` | Get Place information |
68
- | `get_services` | Get game services list |
69
- | `get_studio_settings` | Get Studio settings |
70
- | `run_command` | Execute Studio command |
71
- | `watch_selection` | Watch selection changes |
72
-
73
- ### Search - 2
74
-
75
- | Tool | Description |
76
- |------|-------------|
77
- | `search_by_name` | Search instances by name |
78
- | `search_by_class` | Search instances by class |
79
-
80
- ### Tag - 5
81
-
82
- | Tool | Description |
83
- |------|-------------|
84
- | `add_tag` | Add tag to instance |
85
- | `remove_tag` | Remove tag from instance |
86
- | `get_tags` | Get instance tags |
87
- | `get_tagged` | Get instances with tag |
88
- | `has_tag` | Check if instance has tag |
89
-
90
- ### Camera - 4
91
-
92
- | Tool | Description |
93
- |------|-------------|
94
- | `get_camera_info` | Get camera information |
95
- | `get_suggested_camera_view` | Get suggested camera view |
96
- | `focus_camera_path` | Focus camera on instance by path |
97
- | `focus_camera_position` | Focus camera on world position |
98
-
99
- ### Log - 3
100
-
101
- | Tool | Description |
102
- |------|-------------|
103
- | `get_output_logs` | Get output logs |
104
- | `clear_output_logs` | Clear output logs |
105
- | `get_recent_errors` | Get recent errors |
106
-
107
- ### Connection - 2
108
-
109
- | Tool | Description |
110
- |------|-------------|
111
- | `get_connection_info` | Get connection status |
112
- | `get_usage_status` | Get usage/quota status |
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.
113
44
 
114
45
  ---
115
46
 
116
- ## Pro Tools (+72)
117
- 👉 [Pro Upgrade Guide](../pro-upgrade.md)
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.
118
54
 
119
- ### Script - 2
120
-
121
- | Tool | Description |
122
- |------|-------------|
123
- | `replace_in_scripts` | Batch replace in scripts |
124
- | `execute_script` | Execute Luau code directly |
125
-
126
- ### Search - 6
127
-
128
- | Tool | Description |
129
- |------|-------------|
130
- | `get_file_tree` | Get file tree |
131
- | `get_project_structure` | Get project structure tree |
132
- | `search_by_property` | Search by property |
133
- | `search_by_tag` | Search by tag |
134
- | `get_descendants` | Get all descendants |
135
- | `get_ancestors` | Get ancestors |
136
-
137
- ### Bulk - 8
138
-
139
- | Tool | Description |
140
- |------|-------------|
141
- | `mass_create_instances` | Mass create instances |
142
- | `mass_delete_instances` | Mass delete instances |
143
- | `mass_set_property` | Mass set property |
144
- | `mass_get_property` | Mass get property |
145
- | `mass_duplicate` | Mass duplicate instances |
146
- | `smart_duplicate` | Smart duplicate with offset |
147
- | `batch_execute` | Batch execute commands |
148
- | `modify_children` | Modify all children |
149
-
150
- ### Asset - 7
151
-
152
- | Tool | Description |
153
- |------|-------------|
154
- | `insert_model` | Insert model from Creator Store |
155
- | `get_asset_info` | Get asset information |
156
- | `search_creator_store` | Search Creator Store assets |
157
- | `search_and_insert_model` | Search and insert model |
158
- | `insert_free_model` | Insert free model |
159
- | `insert_package` | Insert package |
160
- | `export_selection` | Export selection |
161
-
162
- ### Environment - 5
163
-
164
- | Tool | Description |
165
- |------|-------------|
166
- | `set_lighting` | Set lighting properties |
167
- | `set_atmosphere` | Set Atmosphere properties |
168
- | `set_sky` | Set Sky properties |
169
- | `set_terrain` | Set Terrain properties |
170
- | `set_time_of_day` | Set time of day |
171
-
172
- ### State - 9
173
-
174
- | Tool | Description |
175
- |------|-------------|
176
- | `sync_workspace_state` | Sync Workspace state |
177
- | `get_workspace_snapshot` | Get Workspace snapshot |
178
- | `get_recent_changes` | Get recent changes |
179
- | `clear_change_history` | Clear change history |
180
- | `get_viewport_info` | Get viewport info |
181
- | `get_workspace_metadata` | Get Workspace metadata |
182
- | `get_script_list` | Get script list |
183
- | `get_selection_info` | Get selection info |
184
- | `clear_state_cache` | Clear state cache |
185
-
186
- ### Spatial - 5
187
-
188
- | Tool | Description |
189
- |------|-------------|
190
- | `get_spatial_map` | Get spatial map of area |
191
- | `find_empty_space` | Find empty space in area |
192
- | `get_bounds` | Get instance bounding box |
193
- | `snap_to_grid` | Snap position to grid |
194
- | `check_collision` | Check collision between instances |
195
-
196
- ### Raycast - 8
197
-
198
- | Tool | Description |
199
- |------|-------------|
200
- | `raycast` | Perform raycast and get hit info |
201
- | `find_ground` | Find ground position at point |
202
- | `check_placement` | Check if placement is valid |
203
- | `multi_raycast` | Perform multiple raycasts |
204
- | `scan_area` | Scan area and generate heightmap |
205
- | `find_flat_areas` | Find flat placement areas |
206
- | `find_spawn_positions` | Find valid spawn positions |
207
- | `analyze_walkable_area` | Analyze walkable area |
208
-
209
- ### Terrain - 14
210
-
211
- | Tool | Description |
212
- |------|-------------|
213
- | `terrain_fill_block` | Fill terrain with block shape |
214
- | `terrain_fill_ball` | Fill terrain with ball shape |
215
- | `terrain_fill_cylinder` | Fill terrain with cylinder shape |
216
- | `terrain_fill_wedge` | Fill terrain with wedge shape |
217
- | `terrain_clear` | Clear terrain (Region object) |
218
- | `terrain_clear_region` | Clear terrain (min/max coords) |
219
- | `terrain_replace_material` | Replace terrain material |
220
- | `terrain_get_material_color` | Get terrain material color |
221
- | `terrain_set_material_color` | Set terrain material color |
222
- | `terrain_read_voxel` | Read single voxel |
223
- | `terrain_read_voxels` | Read voxel data |
224
- | `terrain_write_voxels` | Write voxel data |
225
- | `terrain_generate` | Generate procedural terrain |
226
- | `terrain_smooth` | Smooth terrain |
227
-
228
- ### Visualization - 7
229
-
230
- | Tool | Description |
231
- |------|-------------|
232
- | `visualization_create_area` | Create area visualization |
233
- | `visualization_create_marker` | Create marker visualization (with preview) |
234
- | `visualization_create_line` | Create line visualization |
235
- | `visualization_remove` | Remove visualization |
236
- | `visualization_clear` | Clear all visualizations |
237
- | `visualization_get_status` | Get visualization status |
238
- | `visualization_focus` | Focus camera on visualization |
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)
package/docs/es/README.md CHANGED
@@ -1,47 +1,46 @@
1
1
  # Roblox MCP
2
2
 
3
- [English](../en/README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | **Español** | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
3
+ > Habla con la IA y se ejecuta directamente en Roblox Studio.
4
4
 
5
- > Controla Roblox Studio con IA.
5
+ [English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | **Español** | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
6
6
 
7
7
  [![Demo](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
8
8
 
9
- ## Instrucciones de Instalacion
9
+ ## Qué puedes hacer
10
10
 
11
- ### 1. Instalar el Plugin de Roblox
11
+ ### Crear juegos completos de una vez
12
+ Puedes pedir cosas como "Crea un juego de supervivencia estilo Minecraft" o "Crea un juego de escape room", y la IA diseñará la estructura del juego, creará mapas, objetos y scripts por ti. Con una simple idea, puedes tener un juego jugable.
13
+ > **Tip**: Pide primero "Haz un plan", revísalo y luego di "Ejecútalo" para obtener mejores resultados.
12
14
 
13
- 👉 [Guia de instalacion del plugin](installation/roblox-plugin.md)
15
+ ### Crear y colocar objetos
16
+ "Crea una casa de ladrillos rojos", "Planta 10 árboles en línea"
14
17
 
15
- ### 2. Configuracion del Servidor MCP
18
+ ### Escribir y modificar scripts
19
+ "Haz que salgan partículas cuando el jugador salte", "Encuentra el bug en este script"
16
20
 
17
- Se puede usar con cualquier aplicacion de IA que soporte MCP. Consulta la guia correspondiente a tu aplicacion de IA:
21
+ ### Configurar la atmósfera del mapa
22
+ "Cámbialo a ambiente de atardecer", "Hazlo oscuro como un día lluvioso"
18
23
 
19
- | Aplicacion IA | Guia de instalacion |
20
- |---------------|---------------------|
21
- | Claude Code | [Como configurar](installation/claude-code.md) |
22
- | Claude Desktop | [Como configurar](installation/claude-app.md) |
23
- | Codex CLI | [Como configurar](installation/codex-cli.md) |
24
- | Codex Desktop | [Como configurar](installation/codex-app.md) |
25
- | Gemini CLI | [Como configurar](installation/gemini-cli.md) |
26
- | Cursor, Windsurf, etc. | [Como configurar](installation/antigravity.md) |
24
+ ### Generar terrenos
25
+ Crea terrenos naturales como montañas, ríos, llanuras y cuevas solo con conversación
27
26
 
28
- ## Lista de Herramientas
27
+ ### Buscar e insertar assets
28
+ Busca e inserta modelos gratuitos del Creator Store. "Busca e inserta un modelo de castillo medieval"
29
29
 
30
- 👉 [Ver lista completa de herramientas](tools/overview.md)
30
+ ### Análisis espacial y colocación
31
+ "Encuentra espacios vacíos en esta área", "Analiza el área donde los monstruos pueden caminar"
31
32
 
32
- ## Solucion de Problemas
33
+ ### Depuración y análisis
34
+ Revisa logs de errores, encuentra problemas y corrige
33
35
 
34
- - **"Not Connected"**: Presiona el boton Connect nuevamente en el plugin
35
- - **Puerto**: Usa el puerto 3002 (localhost)
36
+ > [Ver lista completa de funciones](tools/overview.md)
36
37
 
37
- ## Enlaces
38
+ ## Comenzar
39
+ 1. **Instalar el plugin de Roblox Studio** — Conecta Studio con la IA
40
+ 2. **Registrar el servidor MCP en tu app de IA** — Para que la app de IA lo reconozca
41
+
42
+ Toma solo 5 minutos. 👉 [Ver guía de instalación](installation/README.md)
38
43
 
44
+ ## Enlaces
39
45
  - [GitHub](https://github.com/hope1026/roblox-mcp)
40
46
  - [Reportar problemas](https://github.com/hope1026/roblox-mcp/issues)
41
-
42
- ## Licencia
43
-
44
- Uso gratuito para desarrollo de juegos.
45
-
46
- ✅ **Permitido**: Desarrollo de juegos, juegos comerciales, proyectos personales
47
- ❌ **No permitido**: Reventa de software, desarrollo de productos competidores