@weppy/roblox-mcp 0.1.10 → 1.0.0

package/docs/en/tools/overview.md

@@ -1,95 +1,255 @@
-# Roblox MCP Features
-
-Connect AI to Roblox Studio and automate various tasks. Here's what you can do by category.
-
----
-
-## Basic (Free)
-
-### Object Management
-
-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.
-
-### Property Settings
-
-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.
-
-### Scripts
-
-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.
-
-### Selection
-
-Check currently selected objects, change selections, and clear selections. Essential for understanding and controlling what you're working with in Studio.
-
-### Search
-
-Find objects in your game by name or class (type).
-
-### Tags
-
-Add or remove tags from objects and find all objects with a specific tag at once. Useful for managing groups of similar objects.
-
-### Camera
-
-Move the camera to specific objects or positions. Convenient for quickly viewing the area you're working on.
-
-### Logs
-
-Check output logs and errors that occurred during game execution. Helps find and fix bugs.
-
-### Connection
-
-Check the connection status and usage between MCP server and Roblox Studio.
-
----
-
-## Pro
-
-Upgrade to Pro if you need more powerful features.
-
-### Advanced Selection
-
-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.
-
-### Advanced Scripts
-
-Batch replace content in multiple scripts or execute Luau code instantly. Useful for repetitive code modifications or quick testing.
-
-### Advanced Search
-
-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.
-
-### Bulk Operations
-
-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.
-
-### Assets
-
-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".
-
-### Environment Settings
-
-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.
-
-### State Management
-
-Save the current state of Workspace as a snapshot, check recent changes and viewport state. Helps understand current state during complex tasks.
-
-### Spatial Analysis
-
-Accurately determine object size and position, find empty spaces, and check for collisions. You can also align objects to a grid.
-
-### Raycast
-
-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.
-
-### Terrain
-
-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.
-
-### Visualization
-
-Display areas, markers, and lines on screen to visually confirm the space you're working in. Useful for debugging and level design review.
-
-👉 [Pro Upgrade Guide](../pro-upgrade.md)
+# Roblox MCP Tools
+
+For detailed parameters, check MCP tool definitions directly.
+
+Sync policy:
+- Basic: Studio -> Local one-way sync
+- Pro: Bidirectional sync + broader advanced action coverage (better AI token efficiency with bulk workflows)
+
+## Query Instances (Mixed)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `get` | Get instance properties by path | Basic |
+| `children` | Get immediate children or all descendants | Basic |
+| `find_child` | Find first child by name and optional class filter | Basic |
+| `find_descendant` | Find first descendant by name | Basic |
+| `wait_for_child` | Wait for child to appear (with timeout) | Basic |
+| `class_info` | Get class information and valid properties | Basic |
+| `search_name` | Search instances by name pattern (supports wildcards) | Basic |
+| `search_class` | Search instances by class name | Basic |
+| `file_tree` | Get file tree structure from root | Pro |
+| `project_structure` | Get complete project structure | Pro |
+| `descendants` | Get all descendants of an instance | Pro |
+| `ancestors` | Get all ancestors of an instance | Pro |
+| `search_property` | Search instances by property value | Pro |
+| `search_tag` | Search instances by tag | Pro |
+
+## Mutate Instances (Mixed)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `create` | Create a new instance | Basic |
+| `create_with_props` | Create instance with initial properties | Basic |
+| `delete` | Delete an instance | Basic |
+| `clone` | Clone an instance | Basic |
+| `move` | Move instance to new parent | Basic |
+| `rename` | Rename an instance | Basic |
+| `pivot` | Set pivot position or CFrame | Basic |
+| `create_tree` | Create hierarchical instance tree | Pro |
+| `mass_create` | Create multiple instances at once | Pro |
+| `mass_delete` | Delete multiple instances | Pro |
+| `mass_duplicate` | Duplicate multiple instances | Pro |
+| `smart_duplicate` | Duplicate with spacing and count | Pro |
+
+## Manage Properties (Mixed)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `get` | Get a single property value | Basic |
+| `set` | Set a single property value | Basic |
+| `get_all` | Get all properties of an instance | Basic |
+| `set_multiple` | Set multiple properties at once | Basic |
+| `get_attr` | Get attribute value | Basic |
+| `set_attr` | Set attribute value | Basic |
+| `get_all_attrs` | Get all attributes | Basic |
+| `delete_attr` | Delete an attribute | Basic |
+| `add_tag` | Add a tag to instance | Basic |
+| `remove_tag` | Remove a tag from instance | Basic |
+| `check_tag` | Check if instance has a tag | Basic |
+| `get_tags` | Get all tags on an instance | Basic |
+| `get_tagged` | Get all instances with a specific tag | Basic |
+| `set_calculated` | Set property using mathematical expression | Pro |
+| `set_relative` | Set property relative to current value | Pro |
+| `mass_set` | Set property on multiple instances | Pro |
+| `mass_get` | Get property from multiple instances | Pro |
+| `modify_children` | Modify all children of a parent | Pro |
+
+## Manage Scripts (Mixed)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `get_source` | Get script source code | Basic |
+| `set_source` | Set script source code | Basic |
+| `create` | Create a new script | Basic |
+| `delete` | Delete a script | Basic |
+| `edit_replace` | Replace specific lines in script | Basic |
+| `edit_insert` | Insert lines at position | Basic |
+| `edit_delete` | Delete specific lines | Basic |
+| `search` | Search for text in script | Basic |
+| `get_dependencies` | Get script dependencies | Basic |
+| `replace` | Batch replace across scripts | Pro |
+
+## Manage Lighting (Pro)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `lighting` | Set Lighting service properties | Pro |
+| `atmosphere` | Set Atmosphere properties | Pro |
+| `sky` | Set Sky properties | Pro |
+| `terrain_props` | Set Terrain water/visual properties | Pro |
+| `time` | Set time of day | Pro |
+
+## Manage Selection (Mixed)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `get` | Get current selection | Basic |
+| `set` | Replace current selection | Basic |
+| `clear` | Clear selection | Basic |
+| `cached` | Get cached selection without round-trip | Basic |
+| `context` | Get detailed context with source and properties | Pro |
+| `details` | Get hierarchical details with ancestors/descendants | Pro |
+| `add` | Add items to selection | Pro |
+| `remove` | Remove items from selection | Pro |
+| `watch` | Monitor selection changes | Pro |
+
+## Manage Camera (Basic)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `info` | Get camera position, rotation, FOV, viewport size | Basic |
+| `focus_path` | Move camera to focus on instance | Basic |
+| `focus_position` | Move camera to focus on position | Basic |
+| `suggest` | Get suggested camera view for target | Basic |
+
+## Manage Tween (Pro)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `create` | Create a tween with target properties | Pro |
+| `play` | Play a created tween | Pro |
+| `pause` | Pause a running tween | Pro |
+| `cancel` | Cancel a tween | Pro |
+
+## Manage Audio (Pro)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `play` | Play a sound (creates Sound if needed) | Pro |
+| `stop` | Stop a playing sound | Pro |
+| `pause` | Pause a playing sound | Pro |
+| `resume` | Resume a paused sound | Pro |
+| `set_listener` | Set audio listener type/target | Pro |
+
+## Manage Animation (Pro)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `load` | Load animation on Humanoid/AnimationController | Pro |
+| `play` | Play a loaded animation track | Pro |
+| `stop` | Stop a playing animation | Pro |
+| `get_tracks` | List all loaded animation tracks | Pro |
+
+## Manage Physics (Pro)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `register_group` | Register a collision group | Pro |
+| `set_collidable` | Set whether two groups can collide | Pro |
+| `get_groups` | List all registered collision groups | Pro |
+
+## Manage Effects (Pro)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `emit` | Emit particles from ParticleEmitter | Pro |
+| `clear` | Clear all particles | Pro |
+| `toggle` | Enable or disable effect | Pro |
+
+## Manage Terrain (Pro)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `fill_block` | Fill block-shaped terrain | Pro |
+| `fill_ball` | Fill sphere-shaped terrain | Pro |
+| `fill_cylinder` | Fill cylinder-shaped terrain | Pro |
+| `fill_wedge` | Fill wedge-shaped terrain | Pro |
+| `clear_region` | Clear terrain in region | Pro |
+| `clear_bounds` | Clear terrain in bounds | Pro |
+| `replace_material` | Replace material in region | Pro |
+| `colors_get` | Get material colors | Pro |
+| `colors_set` | Set material colors | Pro |
+| `read_voxel` | Read single voxel data | Pro |
+| `read_voxels` | Read bulk voxel data | Pro |
+| `write_voxels` | Write bulk voxel data | Pro |
+| `generate` | Generate procedural terrain | Pro |
+| `smooth` | Smooth terrain | Pro |
+
+## Spatial Query (Pro)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `raycast` | Cast a single ray | Pro |
+| `find_ground` | Find ground position below point | Pro |
+| `check_placement` | Check if placement is collision-free | Pro |
+| `multi_raycast` | Cast multiple rays in batch | Pro |
+| `scan_area` | Generate heightmap of area | Pro |
+| `find_flat` | Find flat areas for building | Pro |
+| `find_spawn` | Find suitable spawn positions | Pro |
+| `analyze_walkable` | Analyze walkability grid | Pro |
+| `spatial_map` | Get all BasePart positions | Pro |
+| `find_space` | Find empty space for object | Pro |
+| `bounds` | Get bounding box of instances | Pro |
+| `snap_grid` | Snap position to grid | Pro |
+| `collision` | Check AABB collision | Pro |
+
+## Manage Assets (Pro)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `insert` | Insert model by asset ID | Pro |
+| `info` | Get asset metadata | Pro |
+| `search` | Search Creator Store | Pro |
+| `search_insert` | Search and insert first match | Pro |
+| `insert_free` | Insert free model | Pro |
+| `insert_package` | Insert package | Pro |
+| `export` | Export current selection | Pro |
+
+## Manage Sync (Pro)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `status` | Get sync status for a place | Pro |
+| `config` | Get/set sync configuration | Pro |
+| `history` | Get change history | Pro |
+| `directions` | Get/set per-type sync directions | Pro |
+| `read_file` | Read a synced file | Pro |
+| `write_file` | Write to a synced file | Pro |
+
+## Workspace State (Pro)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `sync` | Fetch current Workspace state | Pro |
+| `snapshot` | Get full instance tree structure | Pro |
+| `changes` | Get recent changes | Pro |
+| `viewport` | Get camera and viewport info | Pro |
+
+## Manage Logs (Basic)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `get` | Get filtered logs | Basic |
+| `clear` | Clear log buffer | Basic |
+| `errors` | Get recent errors only | Basic |
+
+## System Info (Mixed)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `ping` | Test connection | Basic |
+| `connection` | Get server/plugin connection info | Basic |
+| `usage` | Get current tier (basic/pro) | Basic |
+| `place_info` | Get place ID, name, creator | Pro |
+| `services` | List all Roblox services | Pro |
+| `studio_settings` | Get Studio preferences | Pro |
+| `run_command` | Execute Studio command | Pro |
+
+## Batch Execute (Pro)
+
+Execute multiple commands in a single batch. Each command specifies a tool name and arguments. Commands execute sequentially with optional continue-on-error behavior.
+
+## Execute Luau (Pro)
+
+Execute arbitrary Luau code in Roblox Studio sandbox. Blocked services: HttpService, DataStoreService, MessagingService. Cannot access CoreGui/CorePackages.

package/docs/es/README.md

@@ -41,6 +41,12 @@ Revisa logs de errores, encuentra problemas y corrige
 
 Toma solo 5 minutos. 👉 [Ver guía de instalación](installation/README.md)
 
+## Comienza con Pro
+
+Crea sin límites. Sync bidireccional, capacidades de creación avanzadas y eficiencia de tokens de IA — todo en una sola actualización.
+
+👉 [Guía de actualización Pro](pro-upgrade.md)
+
 ## Enlaces
 - [GitHub](https://github.com/hope1026/roblox-mcp)
 - [Reportar problemas](https://github.com/hope1026/roblox-mcp/issues)

package/docs/es/installation/README.md

@@ -22,11 +22,12 @@ Configura el servidor MCP en tu app de IA para que pueda comunicarse con Roblox
 
 | App de IA | Cómo configurar |
 |-----------|----------------|
-| **Claude Code** (Recomendado) | [claude-code.md](ai-apps/claude-code.md) |
-| **Claude Desktop** | [claude-desktop.md](ai-apps/claude-desktop.md) |
-| **Cline** | [cline.md](ai-apps/cline.md) |
-| **Roo Code** | [roo-code.md](ai-apps/roo-code.md) |
-| **Cursor** | [cursor.md](ai-apps/cursor.md) |
+| **Claude Code** | [Instrucciones](ai-apps/claude-code.md) |
+| **Claude Desktop** | [Instrucciones](ai-apps/claude-app.md) |
+| **Codex CLI** | [Instrucciones](ai-apps/codex-cli.md) |
+| **Codex Desktop** | [Instrucciones](ai-apps/codex-app.md) |
+| **Gemini CLI** | [Instrucciones](ai-apps/gemini-cli.md) |
+| **Antigravity** | [Instrucciones](ai-apps/antigravity.md) |
 
 > **Nota**: Funciona con cualquier app compatible con MCP. El comando es:
 > ```bash

package/docs/es/installation/ai-apps/gemini-cli.md

@@ -1,8 +1,8 @@
-# Configuracion de Gemini CLI
+# Configuración de Gemini CLI
 
-Como usar Roblox MCP en [Google Gemini CLI](https://github.com/google-gemini/gemini-cli).
+Cómo usar Roblox MCP con [Google Gemini CLI](https://github.com/google-gemini/gemini-cli).
 
-## Requisitos Previos
+## Requisitos previos
 
 1. **Node.js** (v18.0.0 o superior)
    ```bash
@@ -16,11 +16,27 @@ Como usar Roblox MCP en [Google Gemini CLI](https://github.com/google-gemini/gem
 
 3. **Plugin de Roblox Studio** instalado
 
-## Registrar el Servidor MCP
+## Registrar el servidor MCP
 
-### Metodo 1: Editar archivo de configuracion (Recomendado)
+### Método 1: Comando CLI (Recomendado)
 
-Agrega el siguiente contenido al archivo `.gemini/settings.json`:
+Puede registrarse con un solo comando en su terminal:
+
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -- -y @weppy/roblox-mcp
+```
+
+> La bandera `--trust` omite las solicitudes de confirmación para cada llamada de herramienta.
+
+Para registrar globalmente, agregue `-s user`:
+
+```bash
+gemini mcp add weppy-roblox-mcp npx -s user --trust -- -y @weppy/roblox-mcp
+```
+
+### Método 2: Editar archivo de configuración
+
+Agregue el siguiente contenido al archivo `.gemini/settings.json`:
 
 ```json
 {
@@ -33,16 +49,22 @@ Agrega el siguiente contenido al archivo `.gemini/settings.json`:
 }
 ```
 
-**Ubicacion del archivo de configuracion:**
-| Alcance | Ruta |
-|---------|------|
+**Ubicaciones del archivo de configuración:**
+| Ámbito | Ruta |
+|--------|------|
 | Proyecto | `<proyecto>/.gemini/settings.json` |
 | Global | `~/.gemini/settings.json` |
 
-### Metodo 2: Usar variables de entorno
+### Método 3: Uso de variables de entorno
+
+Si se necesitan variables de entorno específicas:
 
-Si necesitas variables de entorno especificas:
+**CLI:**
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -e MCP_PORT=3002 -- -y @weppy/roblox-mcp
+```
 
+**Archivo de configuración:**
 ```json
 {
   "mcpServers": {
@@ -57,71 +79,42 @@ Si necesitas variables de entorno especificas:
 }
 ```
 
-## Probar la Conexion
+## Prueba de conexión
 
-1. Abre **Roblox Studio** → Pestana Plugins → **W-MCP** → **Connect**
-2. Ejecuta **Gemini CLI** e ingresa:
+1. Abra **Roblox Studio** → pestaña Plugins → **W-MCP** → **Connect**
+2. Ejecute **Gemini CLI** e ingrese:
    ```
-   Dime que esta seleccionado actualmente en Roblox Studio
+   Dime qué está seleccionado actualmente en Roblox Studio
    ```
 
-## Verificar Estado del Servidor MCP
+## Verificar el estado del servidor MCP
 
-Puedes verificar el estado de los servidores conectados con el comando `/mcp` dentro de Gemini CLI:
+Puede verificar el estado de los servidores conectados con el comando `/mcp` en Gemini CLI:
 
 ```
 /mcp
 ```
 
-## Configuracion Avanzada
-
-### Filtrado de herramientas
-
-Puedes usar o excluir herramientas especificas:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "excludeTools": ["execute_script"],
-      "includeTools": ["get_selection", "create_instance", "set_property"]
-    }
-  }
-}
-```
-
-> `excludeTools` tiene prioridad sobre `includeTools`.
-
-### Modo debug
-
-Para depurar problemas de conexion:
-
-```bash
-gemini --debug
-```
-
-## Solucion de Problemas
+## Solución de problemas
 
-### El servidor no inicia
+### El servidor no se inicia
 
-Ejecuta el servidor MCP directamente para ver los errores:
+Ejecute el servidor MCP directamente para verificar errores:
 ```bash
 npx -y @weppy/roblox-mcp
 ```
 
-### Fallo de conexion
+### Conexión fallida
 
-- Verifica que el plugin de Roblox Studio este en estado **Connected**
-- Verifica que el puerto 3002 no este bloqueado por el firewall
-- Verifica el estado del servidor con el comando `/mcp`
+- Verifique que el plugin de Roblox Studio esté en estado **Connected**
+- Verifique si el puerto 3002 está bloqueado por un firewall
+- Verifique el estado del servidor con el comando `/mcp`
 
-### Conflicto de herramientas
+### Conflictos de herramientas
 
-Si varias servidores MCP tienen herramientas con el mismo nombre, se les agregara un prefijo en formato `serverAlias__toolName`.
+Si varios servidores MCP tienen herramientas con el mismo nombre, se les agregará el prefijo con el formato `serverAlias__toolName`.
 
-## Recursos
+## Referencias
 
-- [Documentacion oficial de Gemini CLI MCP](https://geminicli.com/docs/tools/mcp-server/)
-- [Guia de configuracion de Gemini CLI](https://geminicli.com/docs/get-started/configuration/)
+- [Documentación oficial de Gemini CLI MCP](https://geminicli.com/docs/tools/mcp-server/)
+- [Guía de configuración de Gemini CLI](https://geminicli.com/docs/get-started/configuration/)

package/docs/es/installation/roblox-plugin.md

@@ -4,23 +4,28 @@ Instrucciones para instalar el plugin que conecta Roblox Studio con agentes de I
 
 ## 1. Descargar el Plugin
 
-1. Descarga `weppy-roblox-mcp-basic-v{versión}.zip` desde [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
-2. Extrae el archivo ZIP — encontraras el archivo `roblox-plugin/WeppyRobloxMCP.rbxm` y guias de instalacion
+1. Abre [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+2. Descarga `weppy-roblox-mcp-v{version}.zip`
+3. Extrae el ZIP - encontraras `roblox-plugin/WeppyRobloxMCP.rbxm` y guias de instalacion
+
+Nota:
+- Basic usa el mismo paquete del plugin con politica Basic (Studio -> Local, una via)
+- Con licencia Pro por suscripcion se habilita sync bidireccional y funciones avanzadas mas amplias
 
 ## 2. Instalar el Plugin
 
 1. Abre **Roblox Studio**
-2. Clic en la pestana **Plugins** en el menu superior
-3. Clic en el boton **Plugins Folder**
+2. Clic en la pestana **Plugins**
+3. Clic en **Plugins Folder**
 
 ![Abrir Plugins Folder](../../assets/screenshots/plugins_menu.png)
 
-4. **Copia** el archivo `WeppyRobloxMCP.rbxm` de la carpeta extraida a la carpeta de Plugins abierta
+4. **Copia** `WeppyRobloxMCP.rbxm` a la carpeta abierta de Plugins
 5. **Reinicia Roblox Studio**
 
 ## 3. Verificar la Instalacion
 
-Despues de reiniciar, aparecera el boton **W-MCP** en la pestana Plugins.
+Despues de reiniciar, aparecera el boton **W-MCP** en Plugins.
 
 ![Boton W-MCP](../../assets/screenshots/weppy_plugin_toolbar.png)
 
@@ -28,7 +33,7 @@ Despues de reiniciar, aparecera el boton **W-MCP** en la pestana Plugins.
 
 ### Requisitos Previos
 
-El servidor MCP debe estar instalado. Completa primero la guia correspondiente a tu aplicacion de IA:
+El servidor MCP debe estar instalado. Completa primero la guia de tu app de IA:
 
 | Aplicacion IA | Guia de instalacion |
 |---------------|---------------------|
@@ -42,38 +47,38 @@ El servidor MCP debe estar instalado. Completa primero la guia correspondiente a
 ### Conectar
 
 1. Abre cualquier proyecto en **Roblox Studio**
-2. Pestana **Plugins** superior → Clic en **W-MCP**
-3. Clic en el boton **Connect** en la ventana del plugin
-4. ¡Conexion completada cuando aparece el estado **"Connected"**!
+2. Pestaña **Plugins** -> **W-MCP**
+3. Clic en **Connect**
+4. Cuando veas **"Connected"**, listo
 
 ![Pantalla principal del plugin](../../assets/screenshots/plugin_main.png)
 
 ## 5. Configuracion (Opcional)
 
-Haz clic en el boton de configuracion en la esquina superior derecha del plugin para cambiar varias opciones.
+Usa el boton de configuracion en la esquina superior derecha.
 
 ![Pantalla de configuracion](../../assets/screenshots/settings.png)
 
-- **Conexion automatica**: Conecta automaticamente al servidor MCP al iniciar Studio
-- **Reconexion automatica**: Intenta reconectar automaticamente si se pierde la conexion
-- **Enfoque automatico de camara**: Mueve la camara automaticamente hacia los objetos creados
-- **Idioma**: Cambia el idioma de la interfaz del plugin
+- **Conexion automatica**
+- **Reconexion automatica**
+- **Enfoque automatico de camara**
+- **Idioma**
 
 ## Solucion de Problemas
 
 ### El plugin no aparece
 
-- Cierra completamente Roblox Studio y reinicia
-- Verifica que el archivo se haya copiado correctamente a la carpeta Plugins
-- Verifica que el archivo `.rbxm` no este danado
+- Reinicia Roblox Studio por completo
+- Verifica que el archivo fue copiado correctamente
+- Verifica que `.rbxm` no este dañado
 
 ### No se puede conectar
 
-- Verifica que el servidor MCP este ejecutandose en la aplicacion de IA
-- Haz clic nuevamente en el boton **Connect** en el plugin
-- Verifica que el puerto 3002 no este siendo usado por otro programa
+- Verifica que el servidor MCP esta en ejecucion
+- Pulsa **Connect** otra vez
+- Verifica conflicto en el puerto 3002
 
-### La conexion se pierde frecuentemente
+### La conexion se corta seguido
 
-- Activa la opcion **Reconexion automatica** en la configuracion
-- Intenta reiniciar la aplicacion de IA
+- Activa **Reconexion automatica**
+- Reinicia tu app de IA