@weppy/roblox-mcp 2.4.1 → 2.5.1

package/docs/en/sync/luau-lsp.md

@@ -1,19 +1,19 @@
-# Use `luau-lsp` with WROX Sync
+# Use `luau-lsp` with WEPPY Sync
 
-WROX Sync can generate the sourcemap files that `luau-lsp` needs, so you can enable Roblox-aware editor features without setting up a separate Rojo project.
+WEPPY Sync can generate the sourcemap files that `luau-lsp` needs, so you can enable Roblox-aware editor features without setting up a separate Rojo project.
 
-## What WROX writes
+## What WEPPY writes
 
-After Full Sync finishes, WROX writes:
+After Full Sync finishes, WEPPY writes:
 
-- Place sourcemap: `wrox-project-sync/place_<id>/sourcemap.json`
-- Root representative file: `wrox-project-sync/sourcemap.json`
+- Place sourcemap: `weppy-project-sync/place_<id>/sourcemap.json`
+- Root representative file: `weppy-project-sync/sourcemap.json`
 
-For most users, the recommended path is `wrox-project-sync/sourcemap.json`.
+For most users, the recommended path is `weppy-project-sync/sourcemap.json`.
 
 ## Why this helps
 
-Pointing `luau-lsp` at the WROX sourcemap improves:
+Pointing `luau-lsp` at the WEPPY sourcemap improves:
 
 - `game.*` autocomplete
 - Navigation across synced scripts
@@ -21,8 +21,8 @@ Pointing `luau-lsp` at the WROX sourcemap improves:
 
 ## Recommended setup
 
-1. Run Full Sync once so WROX creates `wrox-project-sync/sourcemap.json`.
-2. Point your editor's `luau-lsp` sourcemap setting to `wrox-project-sync/sourcemap.json`.
+1. Run Full Sync once so WEPPY creates `weppy-project-sync/sourcemap.json`.
+2. Point your editor's `luau-lsp` sourcemap setting to `weppy-project-sync/sourcemap.json`.
 3. If your client can disable automatic Rojo generation, set `luau-lsp.sourcemap.autogenerate` to `false`.
 
 Example VSCode settings:
@@ -31,11 +31,11 @@ Example VSCode settings:
 {
   "luau-lsp.sourcemap.enabled": true,
   "luau-lsp.sourcemap.autogenerate": false,
-  "luau-lsp.sourcemap.sourcemapFile": "wrox-project-sync/sourcemap.json"
+  "luau-lsp.sourcemap.sourcemapFile": "weppy-project-sync/sourcemap.json"
 }
 ```
 
 ## Multi-place note
 
-`wrox-project-sync/sourcemap.json` follows the current representative place for the project.
-If you need a fixed place instead, point `luau-lsp` directly to that place's `wrox-project-sync/place_<id>/sourcemap.json`.
+`weppy-project-sync/sourcemap.json` follows the current representative place for the project.
+If you need a fixed place instead, point `luau-lsp` directly to that place's `weppy-project-sync/place_<id>/sourcemap.json`.

package/docs/en/sync/overview.md

@@ -18,16 +18,16 @@ Without Sync, AI only sees snippets pasted into chat. With Sync enabled, AI work
 2. Incremental Sync: continuous update of new changes
 3. History/Status tracking: inspect what changed, when, and in which direction
 
-Sync data is stored under `{projectRoot}/wrox-project-sync/place_{placeId}/explorer`.
-WROX also writes a place sourcemap to `{projectRoot}/wrox-project-sync/place_{placeId}/sourcemap.json` and keeps the recommended root representative file at `{projectRoot}/wrox-project-sync/sourcemap.json`.
-Use the root path for editor integrations such as `luau-lsp`. Setup steps are covered in [Use `luau-lsp` with WROX Sync](./luau-lsp.md).
+Sync data is stored under `{projectRoot}/weppy-project-sync/place_{placeId}/explorer`.
+WEPPY also writes a place sourcemap to `{projectRoot}/weppy-project-sync/place_{placeId}/sourcemap.json` and keeps the recommended root representative file at `{projectRoot}/weppy-project-sync/sourcemap.json`.
+Use the root path for editor integrations such as `luau-lsp`. Setup steps are covered in [Use `luau-lsp` with WEPPY Sync](./luau-lsp.md).
 
 ### Browse sync data in VSCode
 
-Install the [WROX Roblox Explorer](../installation/roblox-explorer.md) extension to browse the synced instance tree in VSCode, just like in Roblox Studio.
+Install the [WEPPY Roblox Explorer](../explorer/overview.md) extension to browse the synced instance tree in VSCode, just like in Roblox Studio.
 Explorer reads the sync files generated here, and it can show additional live sync state or direction details when the local MCP server is running.
 
-![WROX Roblox Explorer — browse synced instance tree in VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+![WEPPY Roblox Explorer — browse synced instance tree in VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 
 - Service/instance tree with Roblox class icons
 - Click a script to open it for editing
@@ -40,7 +40,7 @@ Explorer reads the sync files generated here, and it can show additional live sy
 | Sync direction | Studio -> Local | Bidirectional |
 | Per-type Direction | Not supported | Supported (Scripts / Values / Containers / Data / Services) |
 | Per-type Apply Mode | Not supported | Supported (Auto / Manual) |
-| Status/history APIs | Not supported | Supported (`status`, `history`, `progress`) |
+| Status/history APIs | Not supported | Supported (`status_current_place`, `history`, `progress`) |
 | `manage_sync` tool | Not supported | Supported |
 | Multi-place sync | Not supported | Supported (up to 3 places) |
 
@@ -87,7 +87,7 @@ In Pro, Direction and Apply Mode can be controlled per type.
 
 | Action | Description | Key params |
 |------|------|-----------|
-| `status` | Check current sync state for a place | `placeId` |
+| `status_current_place` | Check current sync state for the currently connected place | `-` |
 | `history` | Query change history | `placeId`, `query.limit`, `query.offset` |
 | `directions` | Get per-type direction settings | `placeId` |
 | `read_file` | Read a synced file | `placeId`, `instancePath` |
@@ -148,6 +148,6 @@ Names containing `~` are escaped to `~~` (e.g. `Part~2` becomes `Part~~2/`). The
 
 ## Related docs
 
-- [Use `luau-lsp` with WROX Sync](./luau-lsp.md)
+- [Use `luau-lsp` with WEPPY Sync](./luau-lsp.md)
 - [Tools Overview](../tools/overview.md)
 - [Pro Upgrade Guide](https://weppyai.com/en/plans)

package/docs/en/tools/overview.md

@@ -227,7 +227,7 @@ Sync policy:
 
 | Action | Description | Tier |
 |--------|-------------|------|
-| `status` | Get sync status for a place | Pro |
+| `status_current_place` | Get sync status for the current connected place | Pro |
 | `history` | Get change history | Pro |
 | `directions` | Get per-type sync directions | Pro |
 | `read_file` | Read a synced file | Pro |

package/docs/en/tools/playtest.md

@@ -86,10 +86,10 @@ Edit --play--> Running --stop--> Edit
 
 ### 5. Write reports
 
-Reports and logs are written under `{projectRoot}/wrox-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/`.
+Reports and logs are written under `{projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/`.
 
 ```text
-{projectRoot}/wrox-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/
+{projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/
 ├── test-report.md
 └── test-log.txt
 ```

package/docs/es/README.md

@@ -1,6 +1,6 @@
 # Roblox MCP — Servidor MCP para Roblox Studio | Desarrollo de juegos con IA usando Claude, Codex, Cursor y Gemini
 
-> **WROX** es un servidor MCP que permite a los agentes de codificacion IA controlar una sesion en vivo de Roblox Studio — crea y edita scripts, instancias, terrain, iluminacion, assets, audio y animaciones con lenguaje natural.
+> **WEPPY** es un servidor MCP que permite a los agentes de codificacion IA controlar una sesion en vivo de Roblox Studio — crea y edita scripts, instancias, terrain, iluminacion, assets, audio y animaciones con lenguaje natural.
 
 **Herramientas consolidadas basadas en acciones · Sync bidireccional · Playtest automatizado · Soporte multi-place**
 
@@ -8,11 +8,11 @@
 
 [![Demo — IA creando un juego Roblox en tiempo real](https://img.youtube.com/vi/puQB4u1VlMw/maxresdefault.jpg)](https://youtu.be/puQB4u1VlMw)
 
-## ¿Por qué WROX (Weppy Roblox MCP)?
+## ¿Por qué WEPPY (Weppy Roblox MCP)?
 
 Los agentes de codificación IA como Claude, Codex y Gemini son potentes — pero no pueden ver ni modificar nada dentro de Roblox Studio. El DataModel, los scripts, el terrain y la iluminación son invisibles para las herramientas externas. Sin un puente, la IA solo puede generar fragmentos de código que debes pegar manualmente.
 
-**WROX** es un puente entre los agentes de IA y Roblox Studio. La IA crea y modifica directamente instancias, scripts, propiedades, terrain y más dentro de Studio, y los cambios se reflejan de inmediato en Studio y en el dashboard para que puedas **ver exactamente qué cambió**.
+**WEPPY** es un puente entre los agentes de IA y Roblox Studio. La IA crea y modifica directamente instancias, scripts, propiedades, terrain y más dentro de Studio, y los cambios se reflejan de inmediato en Studio y en el dashboard para que puedas **ver exactamente qué cambió**.
 
 No necesitas copiar ni pegar código. La IA trabaja y tú verificas los resultados.
 
@@ -104,9 +104,9 @@ La IA puede controlar directamente el playtest de Studio. Puede iniciar y detene
 - "Escribe y ejecuta una prueba para confirmar que el SpawnLocation esta sobre el suelo."
 - "Valida con playtest que el script que acabo de cambiar funciona sin errores."
 
-![WROX Playtest Dashboard — historial de pruebas y reporte detallado](../assets/screenshots/dashboard/dashboard_playtest.png)
+![WEPPY Playtest Dashboard — historial de pruebas y reporte detallado](../assets/screenshots/dashboard/dashboard_playtest.png)
 
-### 4) WROX Dashboard: monitorea el trabajo de la IA en tiempo real
+### 4) WEPPY Dashboard: monitorea el trabajo de la IA en tiempo real
 
 El Dashboard web proporcionado por el servidor MCP permite consultar en tiempo real el estado de conexion, el historial de ejecucion de herramientas, el estado de sincronizacion y el historial de cambios del juego.
 
@@ -114,19 +114,19 @@ El Dashboard web proporcionado por el servidor MCP permite consultar en tiempo r
 - Compara todos los cambios realizados por la IA con Before & After en el Changelog
 - Analiza el flujo de trabajo con el historial de ejecucion de herramientas y estadisticas
 
-![WROX WROX Dashboard Overview — estado del servidor, cambios recientes y resumen de sesion](../assets/screenshots/dashboard/dashboard_overview.png)
+![WEPPY WEPPY Dashboard Overview — estado del servidor, cambios recientes y resumen de sesion](../assets/screenshots/dashboard/dashboard_overview.png)
 
-### 5) WROX Roblox Explorer: explora la jerarquia de Studio en VSCode
+### 5) WEPPY Roblox Explorer: explora la jerarquia de Studio en VSCode
 
 Visualiza el arbol completo de instancias de tu lugar en Roblox Studio directamente dentro de VSCode. Navega los servicios, abre scripts y archivos de propiedades sincronizados, y rastrea el estado de sincronizacion — todo sin cambiar a Studio.
-WROX Roblox Explorer es una extension complementaria de VSCode para los datos de sync generados por WROX. El arbol base funciona con los archivos sincronizados en disco, y los indicadores en vivo de estado sync o direction se enriquecen cuando el servidor MCP local esta en ejecucion.
+WEPPY Roblox Explorer es una extension complementaria de VSCode para los datos de sync generados por WEPPY. El arbol base funciona con los archivos sincronizados en disco, y los indicadores en vivo de estado sync o direction se enriquecen cuando el servidor MCP local esta en ejecucion.
 Instálalo desde [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer) o [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer).
 
 - Iconos de clase iguales a Studio para reconocimiento inmediato
 - Clic para abrir scripts y archivos de propiedades sincronizados
 - Soporte multiplace con indicadores de estado de sincronizacion
 
-![WROX Roblox Explorer — arbol de instancias de Studio mostrado en la barra lateral de VSCode](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+![WEPPY Roblox Explorer — arbol de instancias de Studio mostrado en la barra lateral de VSCode](../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 
 ## Valor inmediato para el usuario
 
@@ -149,7 +149,8 @@ Instálalo desde [VS Code Marketplace](https://marketplace.visualstudio.com/item
 - [Lista completa de tools](tools/overview.md)
 - [Guia detallada de Sync](sync/overview.md)
 - [Guia del Dashboard](dashboard/overview.md)
-- [WROX Roblox Explorer (Extension VSCode)](installation/roblox-explorer.md)
+- [Guia detallada de WEPPY Roblox Explorer](explorer/overview.md)
+- [Instalacion de WEPPY Roblox Explorer](installation/roblox-explorer.md)
 - [Compatibilidad](../compatibility.md)
 - [Solucion de problemas](../troubleshooting.md)
 

package/docs/es/dashboard/changelog.md

@@ -106,7 +106,7 @@ Filtra por la categoria Instance en la linea de tiempo y rastrea los cambios de
 
 ## Documentos relacionados
 
-- [WROX Dashboard Overview](overview.md)
+- [WEPPY Dashboard Overview](overview.md)
 - [Connection](connection.md)
 - [Sync](sync.md)
 - [Playtest](playtest.md)

package/docs/es/dashboard/connection.md

@@ -69,7 +69,7 @@ Consulta el nombre, PID y directorio de trabajo del agente actualmente conectado
 
 ## Documentos relacionados
 
-- [WROX Dashboard Overview](overview.md)
+- [WEPPY Dashboard Overview](overview.md)
 - [Changelog](changelog.md)
 - [Sync](sync.md)
 - [Playtest](playtest.md)

package/docs/es/dashboard/overview.md

@@ -2,7 +2,7 @@
 
 > Consulta y gestiona en tiempo real el estado del servidor MCP, las conexiones, la sincronizacion, el historial de ejecucion de herramientas y el registro de cambios del juego desde el navegador web.
 
-![WROX Dashboard Overview — estado del servidor, cambios recientes y resumen de sesion de un vistazo](../../assets/screenshots/dashboard/dashboard_overview.png)
+![WEPPY Dashboard Overview — estado del servidor, cambios recientes y resumen de sesion de un vistazo](../../assets/screenshots/dashboard/dashboard_overview.png)
 
 ## Que es el Dashboard?
 

package/docs/es/dashboard/playtest.md

@@ -52,7 +52,7 @@ Revisa la marca de tiempo y el Status en el Test History para identificar la ten
 
 ## Documentos relacionados
 
-- [WROX Dashboard Overview](overview.md)
+- [WEPPY Dashboard Overview](overview.md)
 - [Changelog](changelog.md)
 - [Connection](connection.md)
 - [Sync](sync.md)

package/docs/es/dashboard/settings.md

@@ -52,7 +52,7 @@ Cambia el idioma de la interfaz del Dashboard. Soporta 6 idiomas + Auto (detecci
 
 ## Documentos relacionados
 
-- [WROX Dashboard Overview](overview.md)
+- [WEPPY Dashboard Overview](overview.md)
 - [Changelog](changelog.md)
 - [Connection](connection.md)
 - [Sync](sync.md)

package/docs/es/dashboard/sync.md

@@ -59,7 +59,7 @@ Consulta la Direction del tipo Scripts en la tabla de Sync Directions.
 
 ## Documentos relacionados
 
-- [WROX Dashboard Overview](overview.md)
+- [WEPPY Dashboard Overview](overview.md)
 - [Changelog](changelog.md)
 - [Connection](connection.md)
 - [Playtest](playtest.md)

package/docs/es/dashboard/tools.md

@@ -60,7 +60,7 @@ Busca los elementos con Status Error en la pestana History para ver la informaci
 
 ## Documentos relacionados
 
-- [WROX Dashboard Overview](overview.md)
+- [WEPPY Dashboard Overview](overview.md)
 - [Changelog](changelog.md)
 - [Connection](connection.md)
 - [Sync](sync.md)

package/docs/es/explorer/overview.md

@@ -0,0 +1,104 @@
+# Guia detallada de WEPPY Roblox Explorer
+
+**WEPPY Roblox Explorer** es una extension complementaria para VSCode / Antigravity que replica el arbol del Explorer de Roblox Studio dentro de tu editor. Explora instancias sincronizadas, abre scripts y edita propiedades sin tener que alternar entre Studio y el editor.
+
+> **Opcional** — Explorer no es obligatorio. El servidor MCP y el plugin de Roblox Studio son suficientes para usar todas las funciones principales. Instala Explorer cuando quieras navegar la estructura del proyecto o revisar y editar propiedades directamente desde tu editor.
+
+![WEPPY Roblox Explorer — arbol de instancias de Studio en la barra lateral de VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+
+## Por que usar Explorer
+
+Los agentes de IA pueden entender el contexto completo del proyecto a partir de los archivos generados por Sync, pero cuando una persona explora el mirror directamente, las rutas de archivo por si solas no siempre dejan clara la jerarquia. Explorer reutiliza los mismos datos de sync y los presenta con la **misma estructura que ves en Roblox Studio**, lo que facilita:
+
+- Ver de un vistazo a que servicio / instancia pertenece cada script
+- Localizar rapidamente instancias entre servicios por nombre o ruta
+- Revisar el estado de sincronizacion por archivo (modified / studio / conflict)
+- Editar propiedades sin tener que abrir Studio
+
+## Requisitos
+
+- VSCode 1.85+ o Antigravity
+- [Roblox MCP](../installation/README.md) instalado con Sync habilitado (Basic o Pro)
+- Un archivo `weppy-project-sync/place_*/.sync-meta.json` generado por Sync bajo la raiz de tu proyecto
+
+Explorer funciona usando solo los archivos de sync en disco. Cuando el servidor MCP local esta en ejecucion, tambien se reflejan el estado de sync en vivo y la informacion de direction.
+
+## Instalacion
+
+Busca **WEPPY Roblox Explorer** en la barra lateral de Extensions (`Ctrl+Shift+X` / `Cmd+Shift+X`) de VSCode o Antigravity y haz clic en **Install**.
+
+Enlaces directos al marketplace:
+
+- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
+- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
+
+## Navegar el arbol de instancias
+
+Despues de la instalacion aparece una vista **WEPPY Explorer** en la Activity Bar de VSCode que detecta automaticamente el directorio de sync desde la raiz del proyecto.
+
+- **Raices de servicios**: Los servicios sincronizados como `Workspace`, `ReplicatedStorage` y `ServerScriptService` aparecen en el nivel superior.
+- **Iconos de clases Roblox**: Mas de 200 iconos al estilo Studio que cambian automaticamente entre tema oscuro y claro.
+- **Multi Place**: Cada Place sincronizado se muestra con su propia raiz de arbol cuando hay mas de uno.
+- **Actualizacion automatica**: El arbol se actualiza con un debounce de 500ms cuando los archivos de sync cambian.
+- **Insignias de estado sync**: Los estados `modified`, `studio` y `conflict` aparecen junto al icono para detectar cambios y conflictos al instante.
+
+Al hacer clic en un elemento del arbol se abre el archivo que respalda la instancia (`.server.luau`, `.client.luau`, `.module.luau`, `.props.json`, ...). El menu contextual permite copiar la ruta de la instancia en formato `game.Workspace.Part` o mostrar el archivo en el explorador predeterminado de VSCode.
+
+## Panel de propiedades
+
+Selecciona una instancia en el arbol del Explorer y ejecuta **Open Properties** para abrir un panel que se ve como la ventana Properties de Studio. Puedes inspeccionar y editar propiedades agrupadas sin tocar directamente el archivo `.props.json`.
+
+![Panel de propiedades — edita propiedades al estilo Studio dentro de VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-property-window.png)
+
+- **Vista agrupada**: Las propiedades se ordenan en los mismos grupos que usa Studio (Appearance, Behavior, Data, Part, Transform, etc.).
+- **Editores por tipo**: Los controles de entrada se adaptan al tipo de la propiedad: numeros, cadenas, booleanos, colores, Vector3, enums y mas.
+- **Edicion basada en archivos**: Los cambios se guardan en el archivo `*.props.json` de la instancia y se propagan a Studio a traves del camino reverso de Sync (Pro, cuando bidirectional esta habilitado).
+- **Editor personalizado**: Abrir un archivo `.props.json` directamente carga el Panel de propiedades en lugar del editor de texto predeterminado.
+
+Si quieres que el Panel de propiedades se abra automaticamente al navegar el arbol, cambia `robloxExplorer.propertyPanel.autoOpen` a `true` en la configuracion.
+
+## Busqueda de instancias
+
+Ejecuta el comando `WEPPY Explorer: Search Instances` (desde el icono del encabezado de la vista o la Command Palette) para abrir un QuickPick que busca a traves de todos los servicios sincronizados.
+
+- Coincidencias parciales sobre los nombres de instancia
+- Seleccionar un resultado enfoca el arbol en el elemento correspondiente
+- Cuando hay varios places sincronizados, los resultados se limitan por place
+
+## Configuracion
+
+| Ajuste | Valor por defecto | Descripcion |
+|--------|-------------------|-------------|
+| `robloxExplorer.mcpBaseUrl` | `""` | URL HTTP base del MCP local. Si esta vacio, Explorer prueba `http://127.0.0.1:3002` y luego `http://127.0.0.1:3003`. |
+| `robloxExplorer.syncRoot` | `""` | Ruta absoluta a la raiz `weppy-project-sync`. Se detecta desde las carpetas del workspace si esta vacia. |
+| `robloxExplorer.hidePropsFiles` | `false` | Oculta los archivos de sync (`.props.json`, `_tree.json`, `.value.json`) en el explorador predeterminado de VSCode. |
+| `robloxExplorer.autoRefresh` | `true` | Actualiza el arbol automaticamente cuando cambian los archivos de sync. |
+| `robloxExplorer.showSyncStatus` | `true` | Muestra decoraciones de estado de sync en los elementos del arbol. |
+| `robloxExplorer.followFocusCue` | `false` | Sigue archivos externos de focus cue para expandir el arbol y abrir archivos relacionados. |
+| `robloxExplorer.propertyPanel.autoOpen` | `false` | Abre automaticamente el Panel de propiedades al seleccionar una instancia en el arbol. |
+
+## Comandos
+
+| Comando | Descripcion |
+|---------|-------------|
+| `WEPPY Explorer: Refresh` | Refresca manualmente el arbol de instancias |
+| `WEPPY Explorer: Search Instances` | Busca instancias a traves de todos los servicios |
+| `WEPPY Explorer: Open Backing File` | Abre el archivo de la instancia seleccionada |
+| `WEPPY Explorer: Open Properties` | Abre el Panel de propiedades de la instancia seleccionada |
+| `WEPPY Explorer: Copy Instance Path` | Copia la ruta completa de la instancia (p. ej. `game.Workspace.Part`) |
+| `WEPPY Explorer: Reveal in Explorer` | Muestra el archivo en el explorador predeterminado de VSCode |
+| `WEPPY Explorer: Collapse All` | Contrae todos los nodos del arbol |
+| `WEPPY Explorer: Open Settings` | Abre la pagina de ajustes de Explorer |
+
+## Resolucion de problemas
+
+- **El arbol esta vacio**: Verifica que exista el directorio `weppy-project-sync/place_*` y que Sync haya completado al menos un Full Sync. Define `robloxExplorer.syncRoot` manualmente si es necesario.
+- **No aparece el estado de sync**: Asegurate de que el servidor MCP local este en ejecucion y prueba a configurar `robloxExplorer.mcpBaseUrl` de forma explicita.
+- **El Panel de propiedades no se abre**: Si un archivo `.props.json` se abre en el editor de texto predeterminado, haz clic derecho sobre el y elige **Reopen Editor With... → WEPPY Property Panel**.
+- **Los iconos se ven rotos**: Vuelve a seleccionar el tema de VSCode o reinicia la ventana para refrescar la cache de iconos.
+
+## Documentos relacionados
+
+- [Guia de instalacion de Roblox MCP](../installation/README.md)
+- [Guia de Sync](../sync/overview.md)
+- [Resumen de herramientas](../tools/overview.md)

package/docs/es/installation/README.md

@@ -63,12 +63,12 @@ Configura el servidor MCP en tu app de IA para que pueda comunicarse con Roblox
 > npx -y @weppy/roblox-mcp
 > ```
 
-## Opcional: Instalar WROX Roblox Explorer (Extensión VSCode)
+## Opcional: Instalar WEPPY Roblox Explorer (Extensión VSCode)
 
 Explora los árboles de instancias sincronizados dentro de VSCode con iconos de clases Roblox.
-Esta extension opcional requiere completar antes la instalacion de Roblox MCP, porque Explorer lee los datos de Sync desde `wrox-project-sync` dentro de la raiz del proyecto.
+Esta extension opcional requiere completar antes la instalacion de Roblox MCP, porque Explorer lee los datos de Sync desde `weppy-project-sync` dentro de la raiz del proyecto.
 
-👉 [Guía de instalación de WROX Roblox Explorer](https://weppyai.com/en/install#explorer)
+👉 [Guía de instalación de WEPPY Roblox Explorer](https://weppyai.com/en/install#explorer)
 
 Instalación directa:
 - [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)

package/docs/es/installation/ai-apps/antigravity.md

@@ -61,7 +61,7 @@ Se recomienda mantener el valor predeterminado (HTTP `127.0.0.1:3002`). Si es ne
 
 ## Prueba de conexión
 
-1. Abre **Roblox Studio** → pestaña Plugins → **WROX** → **Connect**
+1. Abre **Roblox Studio** → pestaña Plugins → **WEPPY** → **Connect**
 2. En **Antigravity**, escribe:
    ```
    Dime qué está seleccionado actualmente en Roblox Studio

package/docs/es/installation/ai-apps/claude-app.md

@@ -46,7 +46,7 @@ Como usar Roblox MCP en [Claude Desktop App](https://claude.ai/download).
 
 ## Probar la Conexion
 
-1. Abre **Roblox Studio** → Pestana Plugins → **WROX** → **Connect**
+1. Abre **Roblox Studio** → Pestana Plugins → **WEPPY** → **Connect**
 2. Inicia una nueva conversacion en **Claude Desktop** y prueba:
    ```
    Crea una parte azul en Roblox Studio

package/docs/es/installation/ai-apps/claude-code.md

@@ -64,7 +64,7 @@ Claude Code gestiona el servidor MCP automaticamente:
 
 ## Probar la Conexion
 
-1. Abre **Roblox Studio** → Pestana Plugins → **WROX** → **Connect**
+1. Abre **Roblox Studio** → Pestana Plugins → **WEPPY** → **Connect**
 2. Prueba en **Claude Code**:
    ```
    Crea una parte azul en Roblox Studio

package/docs/es/installation/ai-apps/codex-app.md

@@ -30,7 +30,7 @@ Command: npx -y @weppy/roblox-mcp
 
 ## Probar la Conexion
 
-1. Abre **Roblox Studio** → Pestana Plugins → **WROX** → **Connect**
+1. Abre **Roblox Studio** → Pestana Plugins → **WEPPY** → **Connect**
 2. Inicia una nueva conversacion en **Codex App** y prueba:
    ```
    Dime que esta seleccionado actualmente en Roblox Studio

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

@@ -40,7 +40,7 @@ args = ["-y", "@weppy/roblox-mcp"]
 
 ## Probar la Conexion
 
-1. Abre **Roblox Studio** → Pestana Plugins → **WROX** → **Connect**
+1. Abre **Roblox Studio** → Pestana Plugins → **WEPPY** → **Connect**
 2. Ejecuta **Codex CLI** e ingresa:
    ```
    Dime que esta seleccionado actualmente en Roblox Studio

package/docs/es/installation/ai-apps/cursor.md

@@ -45,7 +45,7 @@ Después de editar la configuración, recarga la ventana de Cursor o reinicia la
 
 ## Prueba de conexión
 
-1. Abre **Roblox Studio** → pestaña Plugins → **WROX** → **Connect**
+1. Abre **Roblox Studio** → pestaña Plugins → **WEPPY** → **Connect**
 2. En **Cursor**, escribe:
    ```
    Tell me what's currently selected in Roblox Studio

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

@@ -81,7 +81,7 @@ gemini mcp add weppy-roblox-mcp npx --trust -e HTTP_PORT=3002 -- -y @weppy/roblo
 
 ## Prueba de conexión
 
-1. Abra **Roblox Studio** → pestaña Plugins → **WROX** → **Connect**
+1. Abra **Roblox Studio** → pestaña Plugins → **WEPPY** → **Connect**
 2. Ejecute **Gemini CLI** e ingrese:
    ```
    Dime qué está seleccionado actualmente en Roblox Studio

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

@@ -1,19 +1,19 @@
-# WROX Roblox Explorer (Extensión VSCode)
+# WEPPY Roblox Explorer (Extensión VSCode)
 
 Vista de árbol de instancias similar al Explorer de Roblox Studio, dentro de VSCode. Navega instancias sincronizadas, abre scripts directamente y consulta el estado de sincronización sin salir del editor.
-Esta es una extensión complementaria para WROX, no una integración de Roblox independiente.
+Esta es una extensión complementaria para WEPPY, no una integración de Roblox independiente.
 
-![WROX Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+![WEPPY Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 
 ## Requisitos
 
 - VSCode 1.85+
 - [Roblox MCP](../../../README.md) instalado con Sync habilitado (Basic o Pro)
-- Sync ya genero `wrox-project-sync/place_*/.sync-meta.json` dentro de la raiz del proyecto
+- Sync ya genero `weppy-project-sync/place_*/.sync-meta.json` dentro de la raiz del proyecto
 
 ## Instalación
 
-Busca **WROX Roblox Explorer** en la barra lateral de Extensiones de VSCode (`Ctrl+Shift+X` / `Cmd+Shift+X`) y haz clic en **Install**.
+Busca **WEPPY Roblox Explorer** en la barra lateral de Extensiones de VSCode (`Ctrl+Shift+X` / `Cmd+Shift+X`) y haz clic en **Install**.
 
 O instala directamente desde estos marketplaces:
 
@@ -37,7 +37,7 @@ La navegación básica del árbol funciona con los archivos sincronizados en dis
 
 | Configuración | Valor por defecto | Descripción |
 |---------------|-------------------|-------------|
-| `robloxExplorer.syncRoot` | `""` | Ruta absoluta a la raiz de `wrox-project-sync`. Si esta vacia, se detecta automaticamente. WROX usa `{projectRoot}/wrox-project-sync`. |
+| `robloxExplorer.syncRoot` | `""` | Ruta absoluta a la raiz de `weppy-project-sync`. Si esta vacia, se detecta automaticamente. WEPPY usa `{projectRoot}/weppy-project-sync`. |
 | `robloxExplorer.hidePropsFiles` | `false` | Oculta los archivos de Sync (`.props.json`, `_tree.json`, `.value.json`) en el explorador predeterminado de VSCode. |
 | `robloxExplorer.autoRefresh` | `true` | Actualiza automáticamente el árbol cuando cambian los archivos Sync. |
 | `robloxExplorer.showSyncStatus` | `true` | Muestra decoraciones de estado Sync en los elementos del árbol. |
@@ -46,11 +46,11 @@ La navegación básica del árbol funciona con los archivos sincronizados en dis
 
 | Comando | Descripción |
 |---------|-------------|
-| `WROX Explorer: Refresh` | Actualizar manualmente el árbol de instancias |
-| `WROX Explorer: Search Instances` | Buscar instancias en todos los servicios |
-| `WROX Explorer: Open Backing File` | Abrir el archivo de respaldo de una instancia seleccionada |
-| `WROX Explorer: Copy Instance Path` | Copiar la ruta completa de la instancia (ej. `game.Workspace.Part`) |
-| `WROX Explorer: Reveal in Explorer` | Mostrar el archivo en el explorador predeterminado de VSCode |
+| `WEPPY Explorer: Refresh` | Actualizar manualmente el árbol de instancias |
+| `WEPPY Explorer: Search Instances` | Buscar instancias en todos los servicios |
+| `WEPPY Explorer: Open Backing File` | Abrir el archivo de respaldo de una instancia seleccionada |
+| `WEPPY Explorer: Copy Instance Path` | Copiar la ruta completa de la instancia (ej. `game.Workspace.Part`) |
+| `WEPPY Explorer: Reveal in Explorer` | Mostrar el archivo en el explorador predeterminado de VSCode |
 
 ## Relacionado
 

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

@@ -25,9 +25,9 @@ Nota:
 
 ## 3. Verificar la Instalacion
 
-Despues de reiniciar, aparecera el boton **WROX** en Plugins.
+Despues de reiniciar, aparecera el boton **WEPPY** en Plugins.
 
-![Boton WROX](../../assets/screenshots/plugin/installation/toolbar-button.png)
+![Boton WEPPY](../../assets/screenshots/plugin/installation/toolbar-button.png)
 
 ## 4. Conectar con el Agente de IA
 
@@ -48,7 +48,7 @@ El servidor MCP debe estar instalado. Completa primero la guia de tu app de IA:
 ### Conectar
 
 1. Abre cualquier proyecto en **Roblox Studio**
-2. Pestaña **Plugins** -> **WROX**
+2. Pestaña **Plugins** -> **WEPPY**
 3. Clic en **Connect**
 4. Cuando veas **"Connected"**, listo
 

package/docs/es/pro-upgrade.md

@@ -48,7 +48,7 @@ Solo necesitas activar la licencia una vez, ya sea en el plugin o en el dashboar
 
 ### Activar en el plugin
 
-1. Abre **WROX** en Roblox Studio y conéctalo al servidor MCP.
+1. Abre **WEPPY** en Roblox Studio y conéctalo al servidor MCP.
 2. Abre la sección **Settings > License** del plugin.
 3. Pega la clave comprada en el campo `License key`.
 4. Haz clic en **Activate** para activar la licencia.

package/docs/es/sync/luau-lsp.md

@@ -1,19 +1,19 @@
-# Usar `luau-lsp` con WROX Sync
+# Usar `luau-lsp` con WEPPY Sync
 
-WROX Sync puede generar automaticamente los archivos sourcemap que necesita `luau-lsp`, para que puedas activar funciones de editor con contexto de Roblox sin preparar un proyecto Rojo aparte.
+WEPPY Sync puede generar automaticamente los archivos sourcemap que necesita `luau-lsp`, para que puedas activar funciones de editor con contexto de Roblox sin preparar un proyecto Rojo aparte.
 
-## Que escribe WROX
+## Que escribe WEPPY
 
-Despues de que termina Full Sync, WROX escribe:
+Despues de que termina Full Sync, WEPPY escribe:
 
-- Place sourcemap: `wrox-project-sync/place_<id>/sourcemap.json`
-- Archivo representante en la raiz: `wrox-project-sync/sourcemap.json`
+- Place sourcemap: `weppy-project-sync/place_<id>/sourcemap.json`
+- Archivo representante en la raiz: `weppy-project-sync/sourcemap.json`
 
-Para la mayoria de usuarios, la ruta recomendada es `wrox-project-sync/sourcemap.json`.
+Para la mayoria de usuarios, la ruta recomendada es `weppy-project-sync/sourcemap.json`.
 
 ## Que mejora
 
-Cuando `luau-lsp` usa el sourcemap de WROX, mejora:
+Cuando `luau-lsp` usa el sourcemap de WEPPY, mejora:
 
 - Autocomplete de `game.*`
 - Navegacion entre scripts sincronizados
@@ -21,8 +21,8 @@ Cuando `luau-lsp` usa el sourcemap de WROX, mejora:
 
 ## Configuracion recomendada
 
-1. Ejecuta Full Sync una vez para que WROX cree `wrox-project-sync/sourcemap.json`.
-2. Haz que la configuracion de sourcemap de `luau-lsp` en tu editor apunte a `wrox-project-sync/sourcemap.json`.
+1. Ejecuta Full Sync una vez para que WEPPY cree `weppy-project-sync/sourcemap.json`.
+2. Haz que la configuracion de sourcemap de `luau-lsp` en tu editor apunte a `weppy-project-sync/sourcemap.json`.
 3. Si tu cliente puede desactivar la generacion automatica con Rojo, establece `luau-lsp.sourcemap.autogenerate` en `false`.
 
 Ejemplo de configuracion en VSCode:
@@ -31,11 +31,11 @@ Ejemplo de configuracion en VSCode:
 {
   "luau-lsp.sourcemap.enabled": true,
   "luau-lsp.sourcemap.autogenerate": false,
-  "luau-lsp.sourcemap.sourcemapFile": "wrox-project-sync/sourcemap.json"
+  "luau-lsp.sourcemap.sourcemapFile": "weppy-project-sync/sourcemap.json"
 }
 ```
 
 ## Nota sobre Multi-place
 
-`wrox-project-sync/sourcemap.json` sigue el place representante actual del proyecto.
-Si necesitas fijarlo a un place especifico, apunta `luau-lsp` directamente a `wrox-project-sync/place_<id>/sourcemap.json`.
+`weppy-project-sync/sourcemap.json` sigue el place representante actual del proyecto.
+Si necesitas fijarlo a un place especifico, apunta `luau-lsp` directamente a `weppy-project-sync/place_<id>/sourcemap.json`.