@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
@@ -0,0 +1,44 @@
1
+ # Guía de Instalación
2
+
3
+ Para usar Roblox MCP, necesitas configurar dos cosas:
4
+
5
+ ```
6
+ App de IA (Claude, etc.)
7
+
8
+ Servidor MCP
9
+
10
+ Plugin de Roblox Studio
11
+ ```
12
+
13
+ ## Paso 1: Instalar el Plugin de Roblox Studio
14
+
15
+ El plugin conecta Roblox Studio con la IA.
16
+
17
+ 👉 [Guía de instalación del plugin](roblox-plugin.md)
18
+
19
+ ## Paso 2: Registrar el Servidor MCP en tu App de IA
20
+
21
+ Configura el servidor MCP en tu app de IA para que pueda comunicarse con Roblox Studio.
22
+
23
+ | App de IA | Cómo configurar |
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) |
30
+
31
+ > **Nota**: Funciona con cualquier app compatible con MCP. El comando es:
32
+ > ```bash
33
+ > npx -y @weppy/roblox-mcp
34
+ > ```
35
+
36
+ ## Después de la Instalación
37
+
38
+ Prueba con un comando simple:
39
+
40
+ ```
41
+ Crea una parte azul en Roblox Studio
42
+ ```
43
+
44
+ Si funciona, ¡estás listo para empezar!
@@ -32,12 +32,12 @@ El servidor MCP debe estar instalado. Completa primero la guia correspondiente a
32
32
 
33
33
  | Aplicacion IA | Guia de instalacion |
34
34
  |---------------|---------------------|
35
- | Claude Code | [Como configurar](claude-code.md) |
36
- | Claude Desktop | [Como configurar](claude-app.md) |
37
- | Codex CLI | [Como configurar](codex-cli.md) |
38
- | Codex Desktop | [Como configurar](codex-app.md) |
39
- | Gemini CLI | [Como configurar](gemini-cli.md) |
40
- | Cursor, Windsurf, etc. | [Como configurar](antigravity.md) |
35
+ | Claude Code | [Como configurar](ai-apps/claude-code.md) |
36
+ | Claude Desktop | [Como configurar](ai-apps/claude-app.md) |
37
+ | Codex CLI | [Como configurar](ai-apps/codex-cli.md) |
38
+ | Codex Desktop | [Como configurar](ai-apps/codex-app.md) |
39
+ | Gemini CLI | [Como configurar](ai-apps/gemini-cli.md) |
40
+ | Antigravity | [Como configurar](ai-apps/antigravity.md) |
41
41
 
42
42
  ### Conectar
43
43
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  **Juegos mas completos** - Con herramientas de terreno, entorno, assets y espacio, puedes crear mundos de juego terminados, no solo prototipos.
8
8
 
9
- ## Herramientas que agrega Pro (72)
9
+ ## Herramientas que agrega Pro
10
10
 
11
11
  | Categoria | Funciones |
12
12
  |-----------|-----------|
@@ -21,8 +21,7 @@
21
21
 
22
22
  ### Paso 1: Comprar en Gumroad
23
23
 
24
- 1. Visita [Gumroad - Weppy Roblox Plugin](https://sunityplugin.gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin
25
- )
24
+ 1. Visita [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin)
26
25
  2. Descarga el plugin
27
26
 
28
27
  ### Paso 2: Instalar el Plugin
@@ -37,12 +36,12 @@
37
36
 
38
37
  1. Abre el plugin W-MCP
39
38
  2. Verifica que aparezca la insignia "Pro"
40
- 3. ¡Las 140 herramientas completas estan disponibles!
39
+ 3. Todas las herramientas estan disponibles!
41
40
 
42
41
  ## Comparacion de Funciones
43
42
 
44
- | Funcion | Basic (68) | Pro (140) |
45
- |---------|:----------:|:---------:|
43
+ | Funcion | Basic | Pro |
44
+ |---------|:-----:|:---:|
46
45
  | Instance, Script, Property | ✅ Acceso completo | ✅ Acceso completo |
47
46
  | Selection, Tag, Camera, Log | ✅ Acceso completo | ✅ Acceso completo |
48
47
  | Operaciones masivas (Bulk) | ― | ✅ Ilimitado |
@@ -1,238 +1,95 @@
1
- # Herramientas de Roblox MCP
1
+ # Funciones de Roblox MCP
2
2
 
3
- Para ver los parametros detallados de las herramientas MCP, consulta directamente la definicion de herramientas MCP.
3
+ Conecta la IA con Roblox Studio para automatizar diversas tareas. A continuacion se presenta lo que puedes hacer por categoria.
4
4
 
5
5
  ---
6
6
 
7
- ## Herramientas Basic (68)
8
-
9
- ### Instance (Instancia) - 13
10
-
11
- | Herramienta | Descripcion |
12
- |-------------|-------------|
13
- | `create_instance` | Crear nueva instancia |
14
- | `create_instance_with_properties` | Crear instancia con propiedades |
15
- | `clone_instance` | Clonar instancia existente |
16
- | `delete_instance` | Eliminar instancia |
17
- | `move_instance` | Mover instancia a nuevo padre |
18
- | `rename_instance` | Renombrar instancia |
19
- | `get_instance` | Obtener informacion de instancia |
20
- | `get_instance_children` | Obtener lista de hijos de instancia |
21
- | `find_first_child` | Encontrar primer hijo por nombre |
22
- | `find_first_descendant` | Encontrar primer descendiente por nombre |
23
- | `get_class_info` | Obtener informacion de clase |
24
- | `wait_for_child` | Esperar hasta que aparezca un hijo |
25
- | `pivot_to` | Establecer Pivot CFrame |
26
-
27
- ### Property (Propiedad) - 10
28
-
29
- | Herramienta | Descripcion |
30
- |-------------|-------------|
31
- | `get_property` | Obtener valor de propiedad |
32
- | `set_property` | Establecer valor de propiedad |
33
- | `get_all_properties` | Obtener todas las propiedades |
34
- | `set_multiple_properties` | Establecer multiples propiedades simultaneamente |
35
- | `set_calculated_property` | Establecer propiedad con valor calculado |
36
- | `set_relative_property` | Establecer propiedad con valor relativo |
37
- | `get_attribute` | Obtener valor de atributo |
38
- | `set_attribute` | Establecer valor de atributo |
39
- | `get_all_attributes` | Obtener todos los atributos |
40
- | `delete_attribute` | Eliminar atributo |
41
-
42
- ### Script - 9
43
-
44
- | Herramienta | Descripcion |
45
- |-------------|-------------|
46
- | `create_script` | Crear nuevo script |
47
- | `get_script_source` | Obtener codigo fuente del script |
48
- | `set_script_source` | Actualizar codigo fuente del script |
49
- | `delete_script` | Eliminar script |
50
- | `edit_script_lines` | Editar lineas especificas |
51
- | `insert_script_lines` | Insertar lineas |
52
- | `delete_script_lines` | Eliminar lineas |
53
- | `search_in_scripts` | Buscar en scripts |
54
- | `get_script_dependencies` | Obtener dependencias |
55
-
56
- ### Selection (Seleccion) - 12
57
-
58
- | Herramienta | Descripcion |
59
- |-------------|-------------|
60
- | `get_selection` | Obtener instancias seleccionadas actualmente |
61
- | `get_selection_context` | Obtener seleccion con contexto |
62
- | `get_selection_details` | Obtener detalles de seleccion |
63
- | `set_selection` | Establecer seleccion de instancias |
64
- | `clear_selection` | Limpiar seleccion |
65
- | `add_to_selection` | Agregar a seleccion |
66
- | `remove_from_selection` | Quitar de seleccion |
67
- | `get_place_info` | Obtener informacion del Place |
68
- | `get_services` | Obtener lista de servicios del juego |
69
- | `get_studio_settings` | Obtener configuracion de Studio |
70
- | `run_command` | Ejecutar comando de Studio |
71
- | `watch_selection` | Monitorear cambios de seleccion |
72
-
73
- ### Search (Busqueda) - 2
74
-
75
- | Herramienta | Descripcion |
76
- |-------------|-------------|
77
- | `search_by_name` | Buscar instancias por nombre |
78
- | `search_by_class` | Buscar instancias por clase |
79
-
80
- ### Tag (Etiqueta) - 5
81
-
82
- | Herramienta | Descripcion |
83
- |-------------|-------------|
84
- | `add_tag` | Agregar etiqueta a instancia |
85
- | `remove_tag` | Quitar etiqueta de instancia |
86
- | `get_tags` | Obtener lista de etiquetas de instancia |
87
- | `get_tagged` | Obtener lista de instancias con etiqueta |
88
- | `has_tag` | Verificar si instancia tiene etiqueta |
89
-
90
- ### Camera (Camara) - 4
91
-
92
- | Herramienta | Descripcion |
93
- |-------------|-------------|
94
- | `get_camera_info` | Obtener informacion de camara |
95
- | `get_suggested_camera_view` | Obtener vista de camara sugerida |
96
- | `focus_camera_path` | Enfocar camara en instancia por ruta |
97
- | `focus_camera_position` | Enfocar camara en posicion mundial |
98
-
99
- ### Log (Registro) - 3
100
-
101
- | Herramienta | Descripcion |
102
- |-------------|-------------|
103
- | `get_output_logs` | Obtener registros de salida |
104
- | `clear_output_logs` | Limpiar registros de salida |
105
- | `get_recent_errors` | Obtener errores recientes |
106
-
107
- ### Connection (Conexion) - 2
108
-
109
- | Herramienta | Descripcion |
110
- |-------------|-------------|
111
- | `get_connection_info` | Obtener estado de conexion |
112
- | `get_usage_status` | Obtener estado de uso/cuota |
7
+ ## Basic (Gratis)
8
+
9
+ ### Gestion de Objetos
10
+
11
+ Crea, clona, elimina y mueve objetos del juego como partes, modelos y carpetas. Tareas como "Crea una parte roja" o "Clona este modelo y ponlo al lado" son posibles.
12
+
13
+ ### Propiedades
14
+
15
+ Lee y cambia todas las propiedades de los objetos como tamano, color, posicion y material. Puedes cambiar varias propiedades a la vez o ajustarlas relativamente segun los valores actuales.
16
+
17
+ ### Scripts
18
+
19
+ Crea nuevos scripts, lee el codigo existente y modificalo. Puedes editar lineas especificas, buscar texto dentro de scripts o identificar dependencias para ver que modulos se referencian.
20
+
21
+ ### Seleccion
22
+
23
+ Verifica los objetos seleccionados, cambia la seleccion y limpia la seleccion. Esencial para entender y controlar con que estas trabajando en Studio.
24
+
25
+ ### Busqueda
26
+
27
+ Encuentra objetos en tu juego por nombre o clase (tipo).
28
+
29
+ ### Etiquetas
30
+
31
+ Agrega o quita etiquetas de objetos y encuentra todos los objetos con una etiqueta especifica de una vez. Util para gestionar grupos de objetos similares.
32
+
33
+ ### Camara
34
+
35
+ Mueve la camara a objetos o posiciones especificas. Conveniente para ver rapidamente el area en la que estas trabajando.
36
+
37
+ ### Registros
38
+
39
+ Consulta logs de salida y errores ocurridos durante la ejecucion del juego. Ayuda a encontrar y corregir bugs.
40
+
41
+ ### Conexion
42
+
43
+ Verifica el estado de conexion y uso entre el servidor MCP y Roblox Studio.
113
44
 
114
45
  ---
115
46
 
116
- ## Herramientas Pro (+72)
117
- 👉 [Guia de actualizacion a Pro](pro-upgrade.md)
118
-
119
- ### Script - 2
120
-
121
- | Herramienta | Descripcion |
122
- |-------------|-------------|
123
- | `replace_in_scripts` | Reemplazar contenido en scripts masivamente |
124
- | `execute_script` | Ejecutar codigo Luau directamente |
125
-
126
- ### Search (Busqueda) - 6
127
-
128
- | Herramienta | Descripcion |
129
- |-------------|-------------|
130
- | `get_file_tree` | Obtener arbol de archivos |
131
- | `get_project_structure` | Obtener arbol de estructura del proyecto |
132
- | `search_by_property` | Buscar por propiedad |
133
- | `search_by_tag` | Buscar por etiqueta |
134
- | `get_descendants` | Obtener todos los descendientes |
135
- | `get_ancestors` | Obtener ancestros |
136
-
137
- ### Bulk (Operaciones Masivas) - 8
138
-
139
- | Herramienta | Descripcion |
140
- |-------------|-------------|
141
- | `mass_create_instances` | Crear instancias masivamente |
142
- | `mass_delete_instances` | Eliminar instancias masivamente |
143
- | `mass_set_property` | Establecer propiedades masivamente |
144
- | `mass_get_property` | Obtener propiedades masivamente |
145
- | `mass_duplicate` | Duplicar instancias masivamente |
146
- | `smart_duplicate` | Duplicar inteligentemente con offset |
147
- | `batch_execute` | Ejecutar multiples comandos en lote |
148
- | `modify_children` | Modificar todos los hijos |
149
-
150
- ### Asset (Recurso) - 7
151
-
152
- | Herramienta | Descripcion |
153
- |-------------|-------------|
154
- | `insert_model` | Insertar modelo desde Creator Store |
155
- | `get_asset_info` | Obtener informacion del asset |
156
- | `search_creator_store` | Buscar assets en Creator Store |
157
- | `search_and_insert_model` | Buscar e insertar modelo |
158
- | `insert_free_model` | Insertar modelo gratuito |
159
- | `insert_package` | Insertar paquete |
160
- | `export_selection` | Exportar seleccion |
161
-
162
- ### Environment (Entorno) - 5
163
-
164
- | Herramienta | Descripcion |
165
- |-------------|-------------|
166
- | `set_lighting` | Establecer propiedades de iluminacion |
167
- | `set_atmosphere` | Establecer propiedades de Atmosphere |
168
- | `set_sky` | Establecer propiedades de Sky |
169
- | `set_terrain` | Establecer propiedades de Terrain |
170
- | `set_time_of_day` | Establecer hora del dia |
171
-
172
- ### State (Estado) - 9
173
-
174
- | Herramienta | Descripcion |
175
- |-------------|-------------|
176
- | `sync_workspace_state` | Sincronizar estado del Workspace |
177
- | `get_workspace_snapshot` | Obtener instantanea del Workspace |
178
- | `get_recent_changes` | Obtener cambios recientes |
179
- | `clear_change_history` | Limpiar historial de cambios |
180
- | `get_viewport_info` | Obtener informacion del viewport |
181
- | `get_workspace_metadata` | Obtener metadatos del Workspace |
182
- | `get_script_list` | Obtener lista de scripts |
183
- | `get_selection_info` | Obtener informacion de seleccion |
184
- | `clear_state_cache` | Limpiar cache de estado |
185
-
186
- ### Spatial (Espacio) - 5
187
-
188
- | Herramienta | Descripcion |
189
- |-------------|-------------|
190
- | `get_spatial_map` | Obtener mapa espacial del area |
191
- | `find_empty_space` | Encontrar espacio vacio en el area |
192
- | `get_bounds` | Obtener caja delimitadora de instancia |
193
- | `snap_to_grid` | Ajustar posicion a la cuadricula |
194
- | `check_collision` | Verificar colision entre instancias |
195
-
196
- ### Raycast - 8
197
-
198
- | Herramienta | Descripcion |
199
- |-------------|-------------|
200
- | `raycast` | Ejecutar raycast y obtener informacion de colision |
201
- | `find_ground` | Encontrar posicion del suelo en un punto |
202
- | `check_placement` | Verificar si se puede colocar objeto |
203
- | `multi_raycast` | Realizar multiples raycasts |
204
- | `scan_area` | Escanear area y generar mapa de altura |
205
- | `find_flat_areas` | Encontrar areas planas para colocacion |
206
- | `find_spawn_positions` | Encontrar posiciones de spawn validas |
207
- | `analyze_walkable_area` | Analizar area transitable |
208
-
209
- ### Terrain (Terreno) - 14
210
-
211
- | Herramienta | Descripcion |
212
- |-------------|-------------|
213
- | `terrain_fill_block` | Rellenar terreno en forma de bloque |
214
- | `terrain_fill_ball` | Rellenar terreno en forma de esfera |
215
- | `terrain_fill_cylinder` | Rellenar terreno en forma de cilindro |
216
- | `terrain_fill_wedge` | Rellenar terreno en forma de cuna |
217
- | `terrain_clear` | Eliminar terreno (usando objeto Region) |
218
- | `terrain_clear_region` | Eliminar terreno (usando coordenadas min/max) |
219
- | `terrain_replace_material` | Reemplazar material de terreno |
220
- | `terrain_get_material_color` | Obtener color de material de terreno |
221
- | `terrain_set_material_color` | Establecer color de material de terreno |
222
- | `terrain_read_voxel` | Leer voxel individual |
223
- | `terrain_read_voxels` | Leer datos de voxels |
224
- | `terrain_write_voxels` | Escribir datos de voxels |
225
- | `terrain_generate` | Generar terreno procedural |
226
- | `terrain_smooth` | Suavizar terreno |
227
-
228
- ### Visualization (Visualizacion) - 7
229
-
230
- | Herramienta | Descripcion |
231
- |-------------|-------------|
232
- | `visualization_create_area` | Crear visualizacion de area |
233
- | `visualization_create_marker` | Crear visualizacion de marcador (con vista previa) |
234
- | `visualization_create_line` | Crear visualizacion de linea |
235
- | `visualization_remove` | Eliminar visualizacion |
236
- | `visualization_clear` | Eliminar todas las visualizaciones |
237
- | `visualization_get_status` | Obtener estado de visualizacion |
238
- | `visualization_focus` | Enfocar camara en elemento de visualizacion |
47
+ ## Pro
48
+
49
+ Si necesitas funciones mas potentes, puedes actualizar a Pro.
50
+
51
+ ### Seleccion Avanzada
52
+
53
+ Obtien el contexto detallado de la seleccion con propiedades y codigo fuente, explora la jerarquia de seleccion, agrega/elimina elementos de la seleccion, y consulta informacion del Place y servicios del juego. Util para flujos de trabajo avanzados y automatizacion.
54
+
55
+ ### Scripts Avanzados
56
+
57
+ Reemplaza contenido en multiples scripts de una vez o ejecuta codigo Luau instantaneamente. Util para modificaciones repetitivas de codigo o pruebas rapidas.
58
+
59
+ ### Busqueda Avanzada
60
+
61
+ Explora el arbol de archivos completo o busca objetos por propiedad o etiqueta. Obtien una vista completa de la estructura del proyecto y consulta todos los descendientes o ancestros de objetos especificos.
62
+
63
+ ### Operaciones Masivas
64
+
65
+ Crea, elimina, modifica o duplica cientos de objetos a la vez. Maneja rapidamente tareas a gran escala como plantar arboles en un mapa, cambiar el color de todas las partes o colocar objetos segun patrones.
66
+
67
+ ### Assets
68
+
69
+ Busca modelos gratuitos en Roblox Creator Store e insertarlos instantaneamente. Agrega assets mediante conversacion como "Busca un modelo de castillo medieval" o "Inserta un modelo de arma".
70
+
71
+ ### Entorno
72
+
73
+ Configura iluminacion, cielo, niebla, propiedades del terreno y hora del dia con lenguaje natural. Solicitudes como "Cambia a ambiente de atardecer" o "Pon la hora a medianoche" son posibles.
74
+
75
+ ### Gestion de Estado
76
+
77
+ Guarda el estado actual del Workspace como snapshot y consulta cambios recientes y el estado del viewport. Ayuda a entender el estado actual durante tareas complejas.
78
+
79
+ ### Analisis Espacial
80
+
81
+ Determina con precision el tamano y posicion de objetos, encuentra espacios vacios y verifica colisiones. Tambien puedes alinear objetos a una cuadricula.
82
+
83
+ ### Raycast
84
+
85
+ Lanza rayos invisibles para encontrar puntos de colision con terreno u objetos. Esencial para el diseno de niveles: encontrar posiciones del suelo, verificar si se pueden colocar objetos, buscar ubicaciones de spawn y analizar areas transitables.
86
+
87
+ ### Terreno
88
+
89
+ Rellena, talla y suaviza terreno con diversas formas como bloques, esferas, cilindros y cunas. Cambia materiales y colores, o genera proceduralmente terreno natural con montanas y rios.
90
+
91
+ ### Visualizacion
92
+
93
+ Muestra areas, marcadores y lineas en pantalla para confirmar visualmente el espacio de trabajo. Util para debugging y revision de diseno de niveles.
94
+
95
+ 👉 [Guia de actualizacion a Pro](../pro-upgrade.md)
package/docs/id/README.md CHANGED
@@ -1,47 +1,59 @@
1
1
  # Roblox MCP
2
2
 
3
- [English](../en/README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | [Español](../es/README.md) | [Português](../pt-br/README.md) | **Bahasa Indonesia**
3
+ [English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | [Español](../es/README.md) | [Português](../pt-br/README.md) | **Bahasa Indonesia**
4
4
 
5
- > Kendalikan Roblox Studio dengan AI.
5
+ > Bicara ke AI, langsung dijalankan di Roblox Studio.
6
6
 
7
7
  [![Demo](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
8
8
 
9
- ## Cara Instalasi
9
+ ## Yang Bisa Kamu Lakukan
10
10
 
11
- ### 1. Instal Plugin Roblox
11
+ ### Buat Game Sekaligus
12
12
 
13
- 👉 [Panduan Instalasi Plugin](installation/roblox-plugin.md)
13
+ "Buatkan game survival gaya Minecraft", "Buatkan game puzzle escape room" — AI merancang struktur game dan membuat map, objek, dan script langsung di Studio kamu. Dari ide sederhana langsung jadi game yang bisa dimainkan.
14
14
 
15
- ### 2. Konfigurasi MCP Server
15
+ > **Tip**: Minta "buat rencana dulu" lalu review dan katakan "jalankan" untuk hasil lebih baik.
16
16
 
17
- Dapat digunakan di semua aplikasi AI yang mendukung MCP. Lihat panduan yang sesuai dengan aplikasi AI yang Anda gunakan:
17
+ ### Membuat dan Menempatkan Objek
18
18
 
19
- | Aplikasi AI | Panduan Instalasi |
20
- |-------------|-------------------|
21
- | Claude Code | [Cara Konfigurasi](installation/claude-code.md) |
22
- | Claude Desktop | [Cara Konfigurasi](installation/claude-app.md) |
23
- | Codex CLI | [Cara Konfigurasi](installation/codex-cli.md) |
24
- | Codex Desktop | [Cara Konfigurasi](installation/codex-app.md) |
25
- | Gemini CLI | [Cara Konfigurasi](installation/gemini-cli.md) |
26
- | Cursor, Windsurf, dll | [Cara Konfigurasi](installation/antigravity.md) |
19
+ "Buatkan rumah dari batu bata merah", "Tanam 10 pohon berjajar rapi" — AI langsung membuatnya di Roblox Studio. Bisa satu-satu, bisa ratusan sekaligus.
27
20
 
28
- ## Daftar Tools
21
+ ### Menulis dan Mengedit Script
29
22
 
30
- 👉 [Lihat Daftar Lengkap Tools](tools/overview.md)
23
+ "Kalau player jump, munculkan efek partikel", "Cariin bug di script ini" — AI menulis dan merevisi kode langsung. AI juga bisa menganalisis script yang sudah ada dan memahami dependencies-nya.
31
24
 
32
- ## Pemecahan Masalah
25
+ ### Mengatur Suasana Map
33
26
 
34
- - **"Not Connected"**: Klik tombol Connect lagi di plugin
35
- - **Port**: Menggunakan port 3002 (localhost)
27
+ "Ubah jadi suasana sunset", "Bikin gelap kayak hujan" satu perintah, AI atur lighting, sky, dan fog otomatis.
36
28
 
37
- ## Tautan
29
+ ### Membuat Terrain
38
30
 
39
- - [GitHub](https://github.com/hope1026/roblox-mcp)
40
- - [Laporan Masalah](https://github.com/hope1026/roblox-mcp/issues)
31
+ Gunung, sungai, dataran, gua — semua bisa dibuat lewat chat. Material, warna, ukuran juga bisa diatur sesuka hati.
32
+
33
+ ### Mencari dan Memasukkan Aset
34
+
35
+ Cari model gratis dan aset dari Creator Store, langsung masuk ke game. "Cari model kastil abad pertengahan terus masukin" — sesimpel itu.
36
+
37
+ ### Analisis Ruang dan Penempatan
38
+
39
+ "Cari tempat kosong di area ini", "Analisis area yang bisa dilewati monster" — AI menangani semua urusan spasial.
40
+
41
+ ### Debugging dan Analisis
41
42
 
42
- ## Lisensi
43
+ AI bisa cek log error, cari masalahnya, dan memperbaikinya bareng kamu.
43
44
 
44
- Dapat digunakan gratis untuk pengembangan game.
45
+ > [Lihat daftar lengkap](tools/overview.md)
45
46
 
46
- **Diizinkan**: Pengembangan game, game komersial, proyek pribadi
47
- ❌ **Tidak diizinkan**: Menjual kembali perangkat lunak, mengembangkan produk pesaing
47
+ ## Mulai
48
+
49
+ Instalasi cuma dua langkah:
50
+
51
+ 1. **Install plugin Roblox Studio** — Jembatan antara Studio dan AI
52
+ 2. **Daftarkan MCP server di aplikasi AI** — Biar AI-mu mengenali Roblox MCP
53
+
54
+ 5 menit kelar. 👉 [Lihat panduan instalasi](installation/README.md)
55
+
56
+ ## Link
57
+
58
+ - [GitHub](https://github.com/hope1026/roblox-mcp)
59
+ - [Laporkan Masalah](https://github.com/hope1026/roblox-mcp/issues)
@@ -0,0 +1,51 @@
1
+ # Panduan Instalasi
2
+
3
+ Untuk menggunakan Roblox MCP, kamu perlu install **dua hal**.
4
+
5
+ ```
6
+ Aplikasi AI (Claude, Codex, Gemini, dll)
7
+
8
+ MCP Server ← Mengubah perintah AI jadi format yang Roblox mengerti
9
+
10
+ Plugin Roblox Studio ← Menjalankan perintah di dalam Studio
11
+ ```
12
+
13
+ Ketika aplikasi AI bilang "buatkan part biru", MCP server mengonversi perintah ini, dan plugin Roblox Studio yang benar-benar membuat part tersebut.
14
+
15
+ ---
16
+
17
+ ## Langkah 1: Install Plugin Roblox Studio
18
+
19
+ Download file plugin dari GitHub, lalu taruh di folder Plugins Roblox Studio.
20
+
21
+ 👉 [Panduan Instalasi Plugin](roblox-plugin.md)
22
+
23
+ ---
24
+
25
+ ## Langkah 2: Daftarkan MCP Server di Aplikasi AI
26
+
27
+ Daftarkan MCP server ke aplikasi AI yang kamu pakai. Bisa digunakan di semua aplikasi AI yang mendukung MCP.
28
+
29
+ | Aplikasi AI | Cara Konfigurasi |
30
+ |-------------|------------------|
31
+ | Claude Code | [Lihat caranya](ai-apps/claude-code.md) |
32
+ | Claude Desktop | [Lihat caranya](ai-apps/claude-app.md) |
33
+ | Codex CLI | [Lihat caranya](ai-apps/codex-cli.md) |
34
+ | Codex Desktop | [Lihat caranya](ai-apps/codex-app.md) |
35
+ | Gemini CLI | [Lihat caranya](ai-apps/gemini-cli.md) |
36
+ | Antigravity | [Lihat caranya](ai-apps/antigravity.md) |
37
+
38
+ > Aplikasi AI lain yang mendukung MCP juga bisa dipakai. Command MCP server-nya: `npx -y @weppy/roblox-mcp`
39
+
40
+ ---
41
+
42
+ ## Setelah Instalasi Selesai
43
+
44
+ 1. Buka **Roblox Studio**, di tab Plugins klik **W-MCP** → **Connect**
45
+ 2. Di **aplikasi AI**, coba test:
46
+
47
+ ```
48
+ Buatkan part biru di Roblox Studio
49
+ ```
50
+
51
+ Kalau part-nya berhasil dibuat, berarti instalasi sudah selesai!
@@ -32,12 +32,12 @@ MCP server harus sudah terinstal. Selesaikan panduan yang sesuai dengan aplikasi
32
32
 
33
33
  | Aplikasi AI | Panduan Instalasi |
34
34
  |-------------|-------------------|
35
- | Claude Code | [Cara Konfigurasi](claude-code.md) |
36
- | Claude Desktop | [Cara Konfigurasi](claude-app.md) |
37
- | Codex CLI | [Cara Konfigurasi](codex-cli.md) |
38
- | Codex Desktop | [Cara Konfigurasi](codex-app.md) |
39
- | Gemini CLI | [Cara Konfigurasi](gemini-cli.md) |
40
- | Cursor, Windsurf, dll | [Cara Konfigurasi](antigravity.md) |
35
+ | Claude Code | [Cara Konfigurasi](ai-apps/claude-code.md) |
36
+ | Claude Desktop | [Cara Konfigurasi](ai-apps/claude-app.md) |
37
+ | Codex CLI | [Cara Konfigurasi](ai-apps/codex-cli.md) |
38
+ | Codex Desktop | [Cara Konfigurasi](ai-apps/codex-app.md) |
39
+ | Gemini CLI | [Cara Konfigurasi](ai-apps/gemini-cli.md) |
40
+ | Antigravity | [Cara Konfigurasi](ai-apps/antigravity.md) |
41
41
 
42
42
  ### Menghubungkan
43
43
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  **Game yang Lebih Lengkap** - Dengan tools terrain, environment, asset, dan spatial, Anda dapat membuat dunia game yang lengkap, bukan hanya prototipe.
8
8
 
9
- ## Tools yang Ditambahkan Pro (72)
9
+ ## Tools yang Ditambahkan Pro
10
10
 
11
11
  | Kategori | Fungsi |
12
12
  |----------|--------|
@@ -21,8 +21,7 @@
21
21
 
22
22
  ### Langkah 1: Beli di Gumroad
23
23
 
24
- 1. Kunjungi [Gumroad - Weppy Roblox Plugin](https://sunityplugin.gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin
25
- )
24
+ 1. Kunjungi [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin)
26
25
  2. Unduh plugin
27
26
 
28
27
  ### Langkah 2: Instal Plugin
@@ -37,12 +36,12 @@
37
36
 
38
37
  1. Buka plugin W-MCP
39
38
  2. Periksa apakah badge "Pro" ditampilkan
40
- 3. Semua 140 tools dapat digunakan!
39
+ 3. Semua tools dapat digunakan!
41
40
 
42
41
  ## Perbandingan Fitur
43
42
 
44
- | Fitur | Basic (68) | Pro (140) |
45
- |-------|:----------:|:---------:|
43
+ | Fitur | Basic | Pro |
44
+ |-------|:-----:|:---:|
46
45
  | Instance, Script, Property | ✅ Akses penuh | ✅ Akses penuh |
47
46
  | Selection, Tag, Camera, Log | ✅ Akses penuh | ✅ Akses penuh |
48
47
  | Operasi Massal (Bulk) | ― | ✅ Tanpa batas |