@weppy/roblox-mcp 2.5.0 → 2.6.0

package/docs/es/dashboard/sync.md

@@ -1,68 +0,0 @@
-# Sync
-
-> Monitorea el estado actual, la configuracion de direccion y los logs de la sincronizacion Studio <-> archivos locales.
-
-![Sync — estado de sincronizacion, configuracion de direccion, logs](../../assets/screenshots/dashboard/dashboard_sync.png)
-
-> Para la guia detallada de la funcion Sync en si, consulta la [Guia detallada de Sync](../sync/overview.md).
-
-## Descripcion general
-
-La pagina Sync muestra visualmente el estado actual y la configuracion de la sincronizacion Studio <-> archivos locales. Solo es accesible cuando el dashboard esta en estado **Studio conectado**.
-
-## Sync Status
-
-Muestra el estado actual de sincronizacion:
-
-| Estado | Significado |
-|--------|-------------|
-| **Idle** | En espera de sincronizacion |
-| **Initializing** | Sincronizacion inicial en progreso |
-| **Syncing** | Sincronizacion incremental en progreso |
-| **Error** | Error de sincronizacion |
-
-La tarjeta de estado tambien muestra la ruta de sincronizacion, el numero de instancias sincronizadas y el modo de aplicacion actual (Auto/Manual).
-
-## Sync Directions
-
-Muestra en una tabla la direccion de sincronizacion por tipo:
-
-| Columna | Descripcion |
-|---------|-------------|
-| Type | Tipo de objetivo de sincronizacion (Scripts, Values, Instances, Data, Services) |
-| Direction | Direccion de sincronizacion (Local -> Studio, Studio -> Local) |
-| Apply Mode | Modo de aplicacion (Auto/Manual) |
-
-Permite verificar la direccion de sincronizacion de cada tipo para entender en que direccion se reflejan los cambios.
-
-## Sync Log
-
-Muestra los eventos de sincronizacion en orden cronologico. Cada entrada del log incluye una etiqueta de tipo de cambio (create, update, delete, etc.) y la ruta del objetivo.
-
-## Casos de uso
-
-### Verificar el estado de sincronizacion
-
-```
-"Quiero comprobar si el Sync esta funcionando correctamente"
-```
-
-Verifica que el Sync Status este en Idle y que los cambios recientes se hayan registrado correctamente en el Sync Log.
-
-### Identificar la direccion de sincronizacion
-
-```
-"Quiero saber en que direccion se sincronizan los cambios de scripts"
-```
-
-Consulta la Direction del tipo Scripts en la tabla de Sync Directions.
-
-## Documentos relacionados
-
-- [WEPPY Dashboard Overview](overview.md)
-- [Changelog](changelog.md)
-- [Connection](connection.md)
-- [Playtest](playtest.md)
-- [Tools](tools.md)
-- [Settings](settings.md)
-- [Guia detallada de Sync](../sync/overview.md)

package/docs/es/dashboard/tools.md

@@ -1,69 +0,0 @@
-# Tools
-
-> Consulta el historial de ejecucion y las estadisticas de las herramientas MCP ejecutadas por la IA.
-
-![Tools — historial de ejecucion de herramientas y estadisticas](../../assets/screenshots/dashboard/dashboard_tools.png)
-
-## Descripcion general
-
-La pagina Tools proporciona el historial de ejecucion y las estadisticas de las herramientas MCP ejecutadas por la IA. Se compone de dos sub-pestanas: **History** y **Statistics**. Es accesible siempre que el dashboard este en estado **Servidor conectado** o **Studio conectado**.
-
-## Pestana History
-
-Muestra el historial de ejecucion de herramientas en una tabla ordenada cronologicamente:
-
-| Columna | Descripcion |
-|---------|-------------|
-| Time | Hora de ejecucion |
-| Tool.Action | Herramienta y accion ejecutada (ej: `query_instances.get_instance`) |
-| Duration | Tiempo de ejecucion |
-| Status | Estado del resultado (OK/Error) |
-| Tier | Tier utilizado (Basic/Pro) |
-
-Funcionalidades:
-- Desplegable de **filtro por Tool** para filtrar una herramienta especifica
-- Paginacion para explorar grandes volumenes de registros
-- Adicion de nuevos registros de ejecucion en tiempo real
-
-## Pestana Statistics
-
-Analiza visualmente las estadisticas de uso de herramientas:
-
-- **Distribucion por tier** — proporcion de uso de herramientas Basic/Pro
-- **Estadisticas por herramienta** — numero de llamadas y tiempo medio de respuesta de cada herramienta
-- **Analisis por accion** — estadisticas detalladas por accion dentro de cada herramienta
-
-## Funciones exclusivas del tier Basic
-
-Los usuarios del tier Basic ven elementos de UI adicionales:
-
-- **Tier Usage Progress** — barra de progreso de uso
-- **Modal comparativo Basic vs Pro** — informacion sobre las funciones adicionales del tier Pro
-
-## Casos de uso
-
-### Analisis de rendimiento de herramientas
-
-```
-"Quiero saber que herramienta tarda mas tiempo"
-```
-
-Consulta el tiempo medio de respuesta por herramienta en la pestana Statistics.
-
-### Seguimiento de errores
-
-```
-"Quiero saber por que fallo la herramienta que acabo de ejecutar"
-```
-
-Busca los elementos con Status Error en la pestana History para ver la informacion detallada.
-
-## Documentos relacionados
-
-- [WEPPY Dashboard Overview](overview.md)
-- [Changelog](changelog.md)
-- [Connection](connection.md)
-- [Sync](sync.md)
-- [Playtest](playtest.md)
-- [Settings](settings.md)
-- [Lista completa de herramientas](../tools/overview.md)

package/docs/es/installation/README.md

@@ -1,87 +0,0 @@
-# Guía de Instalación
-
-Para usar Roblox MCP, necesitas configurar dos cosas:
-
-```
-App de IA (Claude, etc.)
-         ↓
-    Servidor MCP
-         ↓
-Plugin de Roblox Studio
-```
-
-## Instalación en un solo comando (Recomendado)
-
-Instala todo con un solo comando:
-
-**macOS / Linux**
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
-```
-
-**Windows (PowerShell)**
-
-```powershell
-irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
-```
-
-¡Reinicia Roblox Studio y listo!
-
-El registro automático de MCP es compatible con **Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI y Antigravity**.
-
-Si la ejecución de PowerShell está bloqueada en Windows, continúa con la instalación manual de abajo. Si usas el paquete ZIP, también puedes ejecutar `setup-plugin.bat` y `setup-mcp.bat`.
-
----
-
-## Instalación manual
-
-Si la instalacion en un solo comando no funciona, o cuando no puedes usar la instalacion automatica en tu entorno, usa la instalacion manual de abajo como alternativa.
-
-### Paso 1: Instalar el Plugin de Roblox Studio
-
-El plugin conecta Roblox Studio con la IA.
-
-👉 [Guía de instalación del plugin](https://weppyai.com/en/install#plugin)
-
-### Paso 2: Registrar el Servidor MCP en tu App de IA
-
-Configura el servidor MCP en tu app de IA para que pueda comunicarse con Roblox Studio.
-
-| App de IA | Cómo configurar |
-|-----------|----------------|
-| **Claude Code** | [Instrucciones](ai-apps/claude-code.md) |
-| **Claude Desktop** | [Instrucciones](ai-apps/claude-app.md) |
-| **Cursor** | [Instrucciones](ai-apps/cursor.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
-> npx -y @weppy/roblox-mcp
-> ```
-
-## 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 `weppy-project-sync` dentro de la raiz del proyecto.
-
-👉 [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)
-- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
-
----
-
-## Después de la Instalación
-
-Prueba con un comando simple:
-
-```
-Crea una parte azul en Roblox Studio
-```
-
-Si funciona, ¡estás listo para empezar!

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

@@ -1,89 +0,0 @@
-# Configuración de Antigravity
-
-Cómo usar Roblox MCP con [Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/).
-
-> **Antigravity** es la plataforma de desarrollo basada en agentes de Google, donde los agentes de IA se mueven entre la edición de código, la terminal y el navegador para realizar tareas complejas de forma autónoma.
-
-## Requisitos previos
-
-1. **Antigravity** instalado (consulta la documentación oficial para SO compatibles y requisitos)
-2. **Node.js** (v18.0.0 o superior, `npx` disponible)
-3. **Plugin de Roblox Studio** instalado
-
-## Registrar servidor MCP
-
-En Antigravity, los servidores MCP se administran en el **panel de agente (Agent pane)**.
-
-### Registro manual mediante raw config (recomendado)
-
-1. En el panel de agente, haz clic en **⋯** → **MCP Servers** → **Manage MCP Servers** → **View raw config**
-
-![Abrir menú de MCP Servers](../../../assets/screenshots/antigravity/antigravity_mcp_services_menu.png)
-
-2. En la configuración (JSON) que se muestra, agrega/fusiona lo siguiente:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-![Editar raw config](../../../assets/screenshots/antigravity/antigravity_mcp_raw.png)
-
-3. Guarda y ejecuta **Refresh** (o reinicia/actualiza según lo indique la UI)
-
-> La ruta/nombre real del archivo de configuración puede variar según el SO y la versión de Antigravity, así que edita siempre la ubicación indicada en **View raw config**.
-
-### Opción: Ajustar puerto/logs con variables de entorno
-
-Se recomienda mantener el valor predeterminado (HTTP `127.0.0.1:3002`). Si es necesario, puedes establecer variables de entorno así:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "env": {
-        "HTTP_HOST": "127.0.0.1",
-        "HTTP_PORT": "3002",
-        "LOG_LEVEL": "INFO"
-      }
-    }
-  }
-}
-```
-
-## Prueba de conexión
-
-1. Abre **Roblox Studio** → pestaña Plugins → **WEPPY** → **Connect**
-2. En **Antigravity**, escribe:
-   ```
-   Dime qué está seleccionado actualmente en Roblox Studio
-   ```
-
-## Solución de problemas
-
-### Cuando el servidor no inicia
-
-Ejecuta el servidor MCP directamente para ver el error:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### Falla de conexión
-
-- Verifica que el plugin de Roblox Studio esté en estado **Connected**
-- Verifica que el puerto **3002** no esté bloqueado por el firewall
-- Revisa el estado del servidor en el panel de agente **⋯** → **MCP Servers**
-- (Avanzado) Si cambiaste `HTTP_PORT`, el plugin/bridge de Roblox Studio también debe usar el mismo puerto.
-
-## Referencias
-
-- [Introducción a Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/)
-- [Guía de inicio de Antigravity (Codelab)](https://codelabs.developers.google.com/getting-started-google-antigravity)

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

@@ -1,78 +0,0 @@
-# Configuracion de Claude Desktop App
-
-Como usar Roblox MCP en [Claude Desktop App](https://claude.ai/download).
-
-## Requisitos Previos
-
-- **Claude Desktop App** instalado
-- **Node.js** (v18.0.0 o superior)
-- **Plugin de Roblox Studio** instalado
-
-## Registrar el Servidor MCP
-
-### Metodo 1: Desktop Extensions (Recomendado)
-
-> Desde 2026, instalacion con un clic como las extensiones del navegador
-
-1. Claude Desktop → **Settings** → **Extensions**
-2. Busca `weppy-roblox-mcp`
-3. Clic en **Install**
-
-### Metodo 2: Editar archivo de configuracion directamente
-
-1. Claude Desktop → **Settings** → **Developers** → Clic en **Edit Config**
-
-2. Agrega el siguiente contenido al archivo `claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-3. **Cierra completamente** Claude Desktop y reinicia
-
-**Ubicacion del archivo de configuracion:**
-
-| SO | Ruta |
-|----|------|
-| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
-| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
-
-## Probar la Conexion
-
-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
-   ```
-
-## Solucion de Problemas
-
-### El servidor MCP no carga
-
-1. **Verifica la sintaxis JSON**: Valida el archivo de configuracion con un validador JSON en linea
-2. **Reinicia completamente Claude Desktop**: Despues de cambiar la configuracion, asegurate de cerrar completamente la aplicacion y reiniciar
-3. **Verifica las rutas**: Asegurate de que command y args sean correctos
-
-### El servidor no inicia
-
-Ejecuta el servidor MCP directamente para ver los errores:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### Fallo de conexion
-
-- Verifica que el plugin de Roblox Studio este en estado **Connected**
-- Verifica que el puerto 3002 no este bloqueado por el firewall
-
-## Recursos
-
-- [Guia oficial de MCP para Claude Desktop](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop)
-- [Guia de conexion de servidores MCP](https://modelcontextprotocol.io/docs/develop/connect-local-servers)

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

@@ -1,104 +0,0 @@
-# Configuracion de Claude Code
-
-Como usar Roblox MCP en [Claude Code](https://claude.ai/code) (herramienta de codificacion IA basada en terminal).
-
-## Requisitos Previos
-
-- **Claude Code** instalado
-- **Plugin de Roblox Studio** instalado
-
-## Instalacion
-
-```bash
-npm install -g @anthropic-ai/claude-code
-```
-
-## Registrar el Servidor MCP
-
-### Metodo 1: Instalar desde el Marketplace (Recomendado)
-
-Ejecuta en la terminal de Claude Code:
-
-```bash
-# Agregar marketplace
-/plugin marketplace add hope1026/weppy-roblox-mcp
-
-# Instalar plugin
-/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
-```
-
-Verificar instalacion:
-```bash
-/plugin list
-```
-
-### Metodo 2: Editar archivo de configuracion directamente
-
-Crea el archivo `.mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-**Ubicacion del archivo de configuracion:**
-
-| Alcance | Ruta |
-|---------|------|
-| Proyecto | `<proyecto>/.mcp.json` |
-| Global | `~/.claude/mcp.json` |
-
-## Gestion Automatica del Servidor
-
-Claude Code gestiona el servidor MCP automaticamente:
-
-- Inicia automaticamente cuando es necesario
-- Se detiene automaticamente al terminar la sesion
-- No requiere configuracion adicional
-
-## Probar la Conexion
-
-1. Abre **Roblox Studio** → Pestana Plugins → **WEPPY** → **Connect**
-2. Prueba en **Claude Code**:
-   ```
-   Crea una parte azul en Roblox Studio
-   ```
-
-## Solucion de Problemas
-
-### Fallo en la instalacion del plugin
-
-```bash
-# Limpiar cache y reintentar
-/plugin cache clear
-/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
-```
-
-### El servidor no inicia
-
-1. Verifica la version de Node.js (requiere 18.0 o superior):
-   ```bash
-   node --version
-   ```
-
-2. Prueba iniciar el servidor manualmente:
-   ```bash
-   npx -y @weppy/roblox-mcp
-   ```
-
-### Las herramientas MCP no aparecen
-
-Verifica en Claude Code:
-```
-Muestrame la lista de herramientas MCP disponibles
-```
-
-## Recursos
-
-- [Documentacion oficial de Claude Code](https://docs.anthropic.com/claude-code)

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

@@ -1,56 +0,0 @@
-# Configuracion de Codex App
-
-Como usar Roblox MCP en [OpenAI Codex App](https://openai.com/codex/) (macOS).
-
-> **Lanzado el 2 de febrero de 2026** - Aplicacion nativa para macOS que soporta flujos de trabajo multi-agente
-
-## Requisitos Previos
-
-- **Codex App** instalado (macOS)
-- **Plugin de Roblox Studio** instalado
-
-## Registrar el Servidor MCP
-
-### Sincronizacion Automatica con Codex CLI
-
-Si ya configuraste MCP en Codex CLI, puedes usarlo **directamente en la aplicacion sin configuracion adicional**.
-
-```
-El historial de sesiones y la configuracion del CLI se sincronizan automaticamente con la aplicacion.
-```
-
-### Si es una nueva configuracion
-
-Agrega en **Settings** → **MCP Servers** dentro de la aplicacion:
-
-```
-Server name: weppy-roblox-mcp
-Command: npx -y @weppy/roblox-mcp
-```
-
-## Probar la Conexion
-
-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
-   ```
-
-## Solucion de Problemas
-
-### El servidor no inicia
-
-Ejecuta el servidor MCP directamente para ver los errores:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### Fallo de conexion
-
-- Verifica que el plugin de Roblox Studio este en estado **Connected**
-- Verifica que el puerto 3002 no este bloqueado por el firewall
-
-## Recursos
-
-- [Introduccion a Codex App](https://openai.com/index/introducing-the-codex-app/)
-- [Documentacion oficial de Codex MCP](https://developers.openai.com/codex/mcp/)

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

@@ -1,67 +0,0 @@
-# Configuracion de Codex CLI
-
-Como usar Roblox MCP en [OpenAI Codex CLI](https://github.com/openai/codex) (herramienta de codificacion IA basada en terminal).
-
-## Requisitos Previos
-
-- **Node.js** (v18.0.0 o superior)
-- **Plugin de Roblox Studio** instalado
-
-## Instalacion
-
-```bash
-npm install -g @openai/codex
-```
-
-## Registrar el Servidor MCP
-
-### Metodo 1: Comando CLI (Recomendado)
-
-```bash
-codex mcp add weppy-roblox-mcp -- npx -y @weppy/roblox-mcp
-```
-
-### Metodo 2: Editar archivo de configuracion directamente
-
-Agrega el siguiente contenido al archivo `~/.codex/config.toml`:
-
-```toml
-[mcp_servers.weppy-roblox-mcp]
-command = "npx"
-args = ["-y", "@weppy/roblox-mcp"]
-```
-
-**Ubicacion del archivo de configuracion:**
-
-| SO | Ruta |
-|----|------|
-| macOS/Linux | `~/.codex/config.toml` |
-| Windows | `%USERPROFILE%\.codex\config.toml` |
-
-## Probar la Conexion
-
-1. Abre **Roblox Studio** → Pestana Plugins → **WEPPY** → **Connect**
-2. Ejecuta **Codex CLI** e ingresa:
-   ```
-   Dime que esta seleccionado actualmente en Roblox Studio
-   ```
-
-## Solucion de Problemas
-
-### El servidor no inicia
-
-Ejecuta el servidor MCP directamente para ver los errores:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### Fallo de conexion
-
-- Verifica que el plugin de Roblox Studio este en estado **Connected**
-- Verifica que el puerto 3002 no este bloqueado por el firewall
-
-## Recursos
-
-- [Codex CLI GitHub](https://github.com/openai/codex)
-- [Documentacion oficial de Codex MCP](https://developers.openai.com/codex/mcp/)
-- [Referencia de configuracion de Codex](https://developers.openai.com/codex/config-reference/)

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

@@ -1,77 +0,0 @@
-# Configuración de Cursor
-
-Cómo usar Roblox MCP con [Cursor](https://cursor.com/).
-
-## Requisitos previos
-
-- **Cursor** instalado
-- **Node.js** (v18.0.0 o superior)
-- **Plugin de Roblox Studio** instalado
-
-## Registrar el servidor MCP
-
-### Método 1: Configuración del proyecto
-
-Agrega lo siguiente a `.cursor/mcp.json` dentro de tu proyecto:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-### Método 2: Configuración global
-
-Agrega el mismo contenido al archivo de configuración global de Cursor.
-
-**Ubicaciones del archivo de configuración:**
-
-| Alcance | Ruta |
-|---------|------|
-| Proyecto | `<proyecto>/.cursor/mcp.json` |
-| Global (macOS/Linux) | `~/.cursor/mcp.json` |
-| Global (Windows) | `%USERPROFILE%\\.cursor\\mcp.json` |
-
-> Si el archivo ya existe, fusiona la entrada `weppy-roblox-mcp` dentro del objeto `mcpServers`.
-
-### Aplicar cambios
-
-Después de editar la configuración, recarga la ventana de Cursor o reinicia la aplicación.
-
-## Prueba de conexión
-
-1. Abre **Roblox Studio** → pestaña Plugins → **WEPPY** → **Connect**
-2. En **Cursor**, escribe:
-   ```
-   Tell me what's currently selected in Roblox Studio
-   ```
-
-## Solución de problemas
-
-### El servidor MCP no aparece
-
-- Verifica que la ruta del archivo de configuración sea correcta
-- Comprueba que la sintaxis JSON sea válida
-- Recarga Cursor después de editar la configuración
-
-### El servidor no inicia
-
-Ejecuta el servidor MCP directamente para revisar errores:
-
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### La conexión falla
-
-- Verifica que el plugin de Roblox Studio esté en estado **Connected**
-- Revisa si el puerto 3002 está bloqueado por el firewall
-
-## Referencia
-
-- [Documentación de Cursor MCP](https://docs.cursor.com/context/model-context-protocol)