@weppy/roblox-mcp 2.5.1 → 2.6.0

package/docs/en/tools/world-and-environment.md

@@ -1,102 +0,0 @@
-# World & Environment
-
-> Build and inspect the game world with lighting, terrain, spatial queries, and camera tools.
-
-## Included Tools
-
-| Tool | Tier | Description |
-|------|:----:|-------------|
-| `manage_lighting` | Pro | Configure Lighting, Atmosphere, Sky, and time of day |
-| `manage_terrain` | Pro | Generate and edit terrain, including voxel data |
-| `spatial_query` | Pro | Raycasts, ground checks, placement validation, and heightmaps |
-| `manage_camera` | Basic | Inspect camera state, move focus, and get suggested views |
-
-## Key Workflows
-
-### Set the mood (Pro)
-
-```
-"Switch the map to a sunset mood with orange skies, heavier fog, and 18:00 time."
-```
-
-Use `manage_lighting.time` for the clock, `manage_lighting.atmosphere` for fog, and `manage_lighting.sky` for sky visuals.
-
-### Shape terrain (Pro)
-
-```
-"Create a grassy hill with radius 200 at the center of the map and surround it with water."
-```
-
-Use `manage_terrain.fill_ball` for the hill, then `manage_terrain.fill_block` to place surrounding water.
-
-### Validate placement (Pro)
-
-```
-"Find a flat area where I can place this building."
-```
-
-Use `spatial_query.find_flat` to find candidates, `spatial_query.check_placement` to validate them, and `manage_camera.focus_position` to inspect the result visually.
-
-## Action Reference
-
-### 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 and visual properties | Pro |
-| `time` | Set time of day | 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 a region | Pro |
-| `clear_bounds` | Clear terrain in bounds | Pro |
-| `replace_material` | Replace material in a region | Pro |
-| `colors_get` | Get material colors | Pro |
-| `colors_set` | Set material colors | Pro |
-| `read_voxel` | Read a single voxel | 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 the ground position below a point | Pro |
-| `check_placement` | Check whether a placement is collision-free | Pro |
-| `multi_raycast` | Cast multiple rays in batch | Pro |
-| `scan_area` | Generate a heightmap of an area | Pro |
-| `find_flat` | Find flat areas for building | Pro |
-| `find_spawn` | Find suitable spawn positions | Pro |
-| `analyze_walkable` | Analyze a walkability grid | Pro |
-| `spatial_map` | Get all BasePart positions | Pro |
-| `find_space` | Find empty space for an object | Pro |
-| `bounds` | Get instance bounding boxes | Pro |
-| `snap_grid` | Snap a position to the grid | Pro |
-| `collision` | Check AABB collision | Pro |
-
-### Manage Camera (Basic)
-
-| Action | Description | Tier |
-|--------|-------------|------|
-| `info` | Get camera position, rotation, FOV, and viewport size | Basic |
-| `focus_path` | Move the camera to focus on an instance | Basic |
-| `focus_position` | Move the camera to focus on a position | Basic |
-| `suggest` | Get a suggested camera view for a target | Basic |
-
-## Related Docs
-
-- [Instances & Properties](instances-and-properties.md) - place world objects
-- [Assets & Effects](assets-and-effects.md) - add effects, audio, and animation
-- [Tools Reference](overview.md)

package/docs/es/README.md

@@ -1,209 +0,0 @@
-# Roblox MCP — Servidor MCP para Roblox Studio | Desarrollo de juegos con IA usando Claude, Codex, Cursor y Gemini
-
-> **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**
-
-[English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | **Español** | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
-
-[![Demo — IA creando un juego Roblox en tiempo real](https://img.youtube.com/vi/puQB4u1VlMw/maxresdefault.jpg)](https://youtu.be/puQB4u1VlMw)
-
-## ¿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.
-
-**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.
-
-## Instalacion rapida
-
-Instala siguiendo la guia en la pagina web.
-
-👉 **[Pagina de instalacion](https://weppyai.com/en/install)**
-
-### Instalacion por terminal
-
-Si prefieres la terminal, instala todo en una linea.
-
-**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 usar `setup-plugin.bat` y `setup-mcp.bat`.
-
-### Instalacion manual
-
-Si la instalacion en un solo comando no funciona, o si no puedes usar la instalacion automatica en tu entorno, usa la instalacion manual de abajo como alternativa.
-
-**Paso 1** — Instala el plugin de Roblox Studio:
-[Guia de instalacion del plugin](installation/roblox-plugin.md)
-
-**Paso 2** — Registra el servidor MCP en tu app de IA:
-
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-| App de IA | Guia |
-|-----------|------|
-| Claude Code | [Configuracion](installation/ai-apps/claude-code.md) |
-| Claude Desktop | [Configuracion](installation/ai-apps/claude-app.md) |
-| Cursor | [Configuracion](installation/ai-apps/cursor.md) |
-| Codex CLI | [Configuracion](installation/ai-apps/codex-cli.md) |
-| Codex Desktop | [Configuracion](installation/ai-apps/codex-app.md) |
-| Gemini CLI | [Configuracion](installation/ai-apps/gemini-cli.md) |
-| Antigravity | [Configuracion](installation/ai-apps/antigravity.md) |
-
-> Funciona con cualquier cliente MCP compatible. El comando del servidor es `npx -y @weppy/roblox-mcp`.
-
-## Compatibilidad
-
-| Claude Code | Claude Desktop | Cursor | Codex CLI | Gemini CLI | Antigravity |
-|:-----------:|:--------------:|:------:|:---------:|:----------:|:-----------:|
-| ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
-
-**Requisitos:** Node.js 18+, Roblox Studio, Windows 10+ o macOS 12+
-
-## Funciones principales
-
-### 1) MCP Tool: ejecuta en Studio desde lenguaje natural
-
-La IA puede manejar directamente scripts, instancias, propiedades, terreno, iluminacion, assets, audio y animacion dentro de Studio.
-
-- "Agrega particulas + sonido + cooldown cuando el jugador salte."
-- "Crea una arena de boss en el centro del mapa y coloca spawns sin colision."
-- "Cambia la interfaz de este modulo y actualiza todos los scripts dependientes."
-
-### 2) Sync: mantiene el contexto completo del proyecto
-
-La IA trabaja sobre un espejo local sincronizado, asi que los cambios en multiples archivos se mantienen consistentes.
-
-- Basic: sincronizacion unidireccional (Studio -> Local)
-- Pro: sincronizacion bidireccional + Direction/Apply Mode por tipo + historial + multiplace
-
-![Flujo de Sync — Studio y archivos locales sincronizados en tiempo real](../assets/screenshots/plugin/sync/sync-overview.png)
-
-### 3) Playtest: la IA ejecuta y verifica pruebas automaticamente
-
-La IA puede controlar directamente el playtest de Studio. Puede iniciar y detener Play (F5) o Run (F8), inyectar scripts de prueba, recopilar logs y generar reportes locales automaticamente.
-
-- "Inicia un playtest en modo Run y verifica si el NPC llega al objetivo."
-- "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."
-
-![WEPPY Playtest Dashboard — historial de pruebas y reporte detallado](../assets/screenshots/dashboard/dashboard_playtest.png)
-
-### 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.
-
-- Estado de conexion del servidor/plugin/agente de un vistazo
-- 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
-
-![WEPPY WEPPY Dashboard Overview — estado del servidor, cambios recientes y resumen de sesion](../assets/screenshots/dashboard/dashboard_overview.png)
-
-### 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.
-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
-
-![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
-
-- Comprime trabajo repetitivo: convierte muchas ediciones manuales en una sola instruccion
-- Cambios relacionados en conjunto: no solo un archivo aislado
-- Menor riesgo: decide cambios con estado de sync e historial
-- Mejor eficiencia de tokens (Pro): menos idas y vueltas con acciones masivas
-
-## Casos de uso
-
-- **Prototipado rápido**: Describe una mecánica de juego en lenguaje natural y observa cómo la IA la construye en Studio
-- **Refactorización masiva**: Renombra una interfaz de módulo y actualiza todos los scripts dependientes en una sola solicitud
-- **Terrain y entorno**: Genera terrain procedural, configura iluminación/atmósfera, coloca assets — todo desde un solo prompt
-- **Consistencia multi-archivo**: La IA lee el proyecto completo vía Sync y aplica cambios en scripts relacionados de forma conjunta
-- **Integración de assets**: Busca en el Creator Store, inserta modelos y configura propiedades sin salir de tu editor
-
-## Documentacion detallada
-
-- [Guia de instalacion](installation/README.md)
-- [Lista completa de tools](tools/overview.md)
-- [Guia detallada de Sync](sync/overview.md)
-- [Guia del Dashboard](dashboard/overview.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)
-
-### Guias por flujo
-
-- [Instancias y propiedades](tools/instances-and-properties.md) - busqueda, creacion, edicion y tags
-- [Scripting y ejecucion de codigo](tools/scripting.md) - gestion de scripts y ejecucion de Luau
-- [Mundo y entorno](tools/world-and-environment.md) - iluminacion, terrain y camara
-- [Assets y efectos](tools/assets-and-effects.md) - insercion de modelos, tween y efectos
-- [Playtest y pruebas automatizadas](tools/playtest.md) - control de playtest y validacion automatica
-- [Sistema y depuracion](tools/system-and-debugging.md) - conexion, logs y ejecucion por lotes
-
-## FAQ
-
-### ¿Cómo conecto Claude Code a Roblox Studio?
-Instala el plugin de Roblox Studio y luego registra el servidor MCP (`npx -y @weppy/roblox-mcp`) en Claude Code. Claude podrá leer y escribir scripts directamente dentro de Studio. Consulta [Configuración de Claude Code](installation/ai-apps/claude-code.md).
-
-### ¿Cómo uso Codex CLI con Roblox Studio?
-Instala el plugin y agrega la configuración del servidor MCP a Codex CLI. Consulta [Configuración de Codex CLI](installation/ai-apps/codex-cli.md).
-
-### ¿Roblox MCP funciona con Cursor?
-Sí. Consulta [Configuración de Cursor](installation/ai-apps/cursor.md). Cualquier cliente de IA compatible con MCP funciona.
-
-### ¿Puede la IA crear juegos de Roblox con esto?
-Sí. La IA puede crear instancias, escribir scripts, generar terrain, configurar iluminación, insertar assets, configurar física y más — todo dentro de una sesión de Studio en vivo. Va más allá de la generación de código hacia acciones ejecutables.
-
-### ¿Cuál es la diferencia entre Basic y Pro?
-Basic (gratuito) incluye ejecución de herramientas MCP y sincronización unidireccional (Studio -> Local). Pro agrega sincronización bidireccional, operaciones masivas, generación de terrain, análisis espacial, control de audio/animación y soporte multi-place. Consulta la [Guía de actualización Pro](https://weppyai.com/en/plans).
-
-### ¿Cómo se diferencia Weppy de otros servidores MCP para Roblox?
-Weppy usa despacho basado en acciones en lugar de herramientas separadas para cada función. Esto reduce significativamente el consumo de tokens de IA. También proporciona sincronización bidireccional de proyecto y soporte multi-place, que la mayoría de las alternativas no tienen.
-
-### ¿Es seguro? ¿Puede la IA romper mi juego?
-El servidor se ejecuta solo en localhost (127.0.0.1:3002). Las rutas prohibidas (CoreGui, CorePackages) están bloqueadas. La limitación de velocidad (450 req/min) y los tiempos de espera de 30 segundos previenen operaciones fuera de control. Todos los cambios son rastreables a través del historial de sincronización.
-
-## Upgrade Pro
-
-Sync bidireccional, capacidades de creacion avanzadas y eficiencia de tokens de IA — todo en una sola actualizacion.
-
-[Guia de actualizacion Pro](https://weppyai.com/en/plans)
-
-## Licencia
-
-Este repositorio está licenciado bajo `AGPL-3.0`.
-
-Las licencias comerciales están disponibles por separado. Consulta [COMMERCIAL-LICENSE.md](../../COMMERCIAL-LICENSE.md).
-
-El uso del nombre y los logotipos de Weppy se rige por [TRADEMARKS.md](../../TRADEMARKS.md).
-
----
-
-[![npm version](https://img.shields.io/npm/v/@weppy/roblox-mcp)](https://www.npmjs.com/package/@weppy/roblox-mcp) [![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org/) [![Smithery](https://smithery.ai/badge/@hope1026/weppy-roblox-mcp)](https://smithery.ai/server/@hope1026/weppy-roblox-mcp)
-
-[![Roblox MCP on Glama](https://glama.ai/mcp/servers/hope1026/roblox-mcp/badges/card.svg)](https://glama.ai/mcp/servers/hope1026/roblox-mcp)
-
-[GitHub Issues](https://github.com/hope1026/weppy-roblox-mcp/issues) · [Discussions](https://github.com/hope1026/weppy-roblox-mcp/discussions) · [npm](https://www.npmjs.com/package/@weppy/roblox-mcp)

package/docs/es/dashboard/changelog.md

@@ -1,114 +0,0 @@
-# Changelog
-
-> Registra todos los cambios realizados por la IA en Roblox Studio por sesion, y proporciona resumen de cambios, linea de tiempo y Before & After.
-
-![Changelog — lista de tarjetas de cambios por sesion](../../assets/screenshots/dashboard/dashboard_changelog1.png)
-
-## Descripcion general
-
-Changelog es la pagina que rastrea el historial de cambios del juego realizados por el agente de IA en Studio. Los cambios se agrupan por sesion, y se puede ver de un vistazo cuantos cambios de cada tipo ocurrieron en cada sesion.
-
-## Lista de tarjetas de sesion
-
-La pantalla inicial de Changelog muestra una lista de tarjetas por sesion.
-
-### Estado de sesion
-
-Cada tarjeta de sesion muestra un estado:
-
-| Estado | Significado |
-|--------|-------------|
-| **Active** | Sesion en curso (actualizacion en tiempo real) |
-| **Completed** | Sesion completada |
-| **Bootstrap** | Sesion de sincronizacion inicial |
-
-### Resumen de sesion
-
-Cada tarjeta muestra un resumen del numero de cambios por categoria de la sesion correspondiente:
-
-- Script — numero de scripts creados/modificados
-- Instance — numero de instancias creadas/eliminadas/movidas
-- Property — numero de cambios de propiedades
-- Lighting — numero de cambios de iluminacion/entorno
-- Terrain — numero de cambios de terreno
-- Asset — numero de assets insertados
-
-### Pestanas de filtro
-
-Las pestanas superiores permiten filtrar sesiones:
-- **All** — todas las sesiones
-- **Active** — solo sesiones en curso
-- **Completed** — solo sesiones completadas
-
-## Vista detallada de sesion
-
-Al hacer clic en una tarjeta de sesion se accede a la vista detallada.
-
-![Vista detallada de Changelog — resumen de cambios, linea de tiempo, Before & After](../../assets/screenshots/dashboard/dashboard_changelog2.png)
-
-### Change Summary
-
-Visualiza los cambios de la sesion en 6 tarjetas de categoria:
-
-| Categoria | Icono | Descripcion |
-|-----------|-------|-------------|
-| Scripts | Script | Numero de scripts creados/modificados |
-| Instances | Instancia | Numero de instancias creadas/eliminadas/movidas |
-| Properties | Propiedad | Numero de cambios de propiedades |
-| Lighting | Iluminacion | Numero de cambios de iluminacion/entorno |
-| Terrain | Terreno | Numero de cambios de terreno |
-| Assets | Asset | Numero de assets insertados |
-
-### Change Timeline
-
-Lista todos los cambios de la sesion en orden cronologico.
-
-- Cada elemento muestra marca de tiempo, etiqueta de categoria de cambio y ruta del objetivo
-- El desplegable **Category** permite filtrar por una categoria especifica
-- Al hacer clic en un elemento se despliega la vista comparativa Before & After
-
-### Before & After
-
-Compara los datos antes y despues del cambio. Proporciona diferentes niveles de informacion segun el tipo de cambio:
-
-| Confiabilidad | Significado | Ejemplo |
-|---------------|-------------|---------|
-| **exact** | Los valores antes y despues del cambio estan registrados con exactitud | Cambio de propiedad, modificacion de script |
-| **partial** | Solo se registra informacion parcial | Cambios compuestos |
-| **after-only** | Solo existe el valor posterior al cambio | Creacion de nueva instancia |
-| **intent-only** | Solo se registra la intencion | Eliminacion, etc. |
-
-## Casos de uso
-
-### Verificacion de trabajo
-
-```
-"Quiero comprobar que scripts modifico la IA hace un momento"
-```
-
-Filtrando la categoria Script de la sesion Active en el Changelog, se puede ver la lista de scripts modificados y comparar el codigo antes y despues.
-
-### Seguimiento de cambios
-
-```
-"Quiero revisar como se configuro el Lighting en la sesion de ayer"
-```
-
-Busca la sesion correspondiente en la pestana Completed y filtra por la categoria Lighting para ver el historial de cambios y los valores de configuracion.
-
-### Depuracion de problemas
-
-```
-"Necesito encontrar en que momento se elimino una instancia especifica"
-```
-
-Filtra por la categoria Instance en la linea de tiempo y rastrea los cambios de tipo delete en orden cronologico.
-
-## Documentos relacionados
-
-- [WEPPY Dashboard Overview](overview.md)
-- [Connection](connection.md)
-- [Sync](sync.md)
-- [Playtest](playtest.md)
-- [Tools](tools.md)
-- [Settings](settings.md)

package/docs/es/dashboard/connection.md

@@ -1,77 +0,0 @@
-# Connection
-
-> Monitorea el estado de conexion del servidor, los agentes de IA y el plugin en un solo lugar.
-
-![Connection — estado del servidor, agentes de IA, informacion de conexion del plugin](../../assets/screenshots/dashboard/dashboard_connection.png)
-
-## Descripcion general
-
-La pagina Connection permite monitorear todos los estados de conexion del sistema MCP en un solo lugar. Es accesible siempre que el dashboard este en estado **Servidor conectado** o **Studio conectado**.
-
-## Server Status
-
-Muestra la informacion esencial del servidor:
-
-| Campo | Descripcion |
-|-------|-------------|
-| Status | Indicador de estado de conexion (Online/Offline) |
-| Version | Version del servidor MCP |
-| PID | ID de proceso del servidor |
-| Uptime | Tiempo de actividad del servidor |
-| Session ID | Identificador de la sesion actual |
-| Exec Path | Ruta de ejecucion del servidor |
-
-## AI Agents
-
-Muestra en una tabla la lista de agentes de IA actualmente conectados:
-
-| Columna | Descripcion |
-|---------|-------------|
-| Name | Nombre del agente (ej: Claude Code) |
-| PID | ID de proceso del agente |
-| Working Dir | Directorio de trabajo del agente |
-| Connected | Tiempo transcurrido desde la conexion |
-
-Si hay varios agentes conectados simultaneamente, se muestran todos.
-
-## Plugins
-
-Muestra la lista de plugins de Roblox Studio conectados:
-
-| Columna | Descripcion |
-|---------|-------------|
-| Place | Nombre del Place |
-| Client ID | Identificador del cliente del plugin |
-| Last Seen | Hora de la ultima comunicacion |
-| Version | Version del plugin |
-
-## Connection Log
-
-Muestra los eventos relacionados con la conexion en tiempo real. Los eventos de conexion/desconexion de agentes y plugins se agregan automaticamente a traves de SSE.
-
-## Casos de uso
-
-### Diagnostico de problemas de conexion
-
-```
-"Parece que la IA no se conecta a Studio"
-```
-
-Verifica si el Server Status esta en Online y si el plugin aparece en la tabla de Plugins. Puedes rastrear los eventos de conexion/desconexion en el Connection Log.
-
-### Verificacion de agentes
-
-```
-"Quiero comprobar que IA esta conectada ahora mismo"
-```
-
-Consulta el nombre, PID y directorio de trabajo del agente actualmente conectado en la tabla de AI Agents.
-
-## Documentos relacionados
-
-- [WEPPY Dashboard Overview](overview.md)
-- [Changelog](changelog.md)
-- [Sync](sync.md)
-- [Playtest](playtest.md)
-- [Tools](tools.md)
-- [Settings](settings.md)

package/docs/es/dashboard/overview.md

@@ -1,95 +0,0 @@
-# Dashboard
-
-> 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.
-
-![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?
-
-El Dashboard es una interfaz de monitoreo basada en web proporcionada por el servidor MCP. Se abre automaticamente en el navegador cuando se inicia el servidor MCP, lo que permite rastrear en tiempo real todas las operaciones que el agente de IA realiza en Roblox Studio.
-
-- Visualiza el estado sin necesidad de revisar los logs del terminal
-- Rastrea los cambios realizados por la IA en Studio a traves del historial de cambios
-- Consulta el estado de sincronizacion, el estado de conexion y las estadisticas de ejecucion de herramientas en un solo lugar
-
-## Estructura de paginas
-
-| Pagina | Descripcion | Guia detallada |
-|--------|-------------|----------------|
-| [Overview](#overview) | Tarjetas de estado del servidor/plugin/agente/Sync, feed de cambios recientes | Este documento |
-| [Changelog](changelog.md) | Historial de cambios del juego — tarjetas por sesion, resumen de cambios, linea de tiempo, Before & After | [Guia detallada](changelog.md) |
-| [Connection](connection.md) | Estado del servidor, lista de agentes de IA, informacion de conexion del plugin | [Guia detallada](connection.md) |
-| [Sync](sync.md) | Estado de sincronizacion, configuracion de direccion, logs | [Guia detallada](sync.md) |
-| [Playtest](playtest.md) | Estado del playtest, historial de pruebas | [Guia detallada](playtest.md) |
-| [Tools](tools.md) | Historial de ejecucion de herramientas, estadisticas, distribucion por tier | [Guia detallada](tools.md) |
-| [Settings](settings.md) | Licencia, nivel de log, idioma | [Guia detallada](settings.md) |
-
-## Como acceder
-
-Cuando se inicia el servidor MCP, el Dashboard se abre automaticamente en el navegador. Para acceder manualmente:
-
-```
-http://localhost:3002
-```
-
-> Configura `DASHBOARD_AUTO_OPEN=false` para desactivar la apertura automatica (consulta la pagina de [Settings](settings.md)).
-
-## Estados de conexion
-
-El Dashboard ofrece diferentes funciones segun el estado de conexion:
-
-| Estado | Condicion | Paginas disponibles |
-|--------|-----------|---------------------|
-| **Servidor desconectado** | Servidor no conectado | Solo se muestra la pantalla de espera de reconexion |
-| **Servidor conectado** | Servidor conectado, plugin no conectado | Connection, Tools, Settings |
-| **Studio conectado** | Servidor + plugin ambos conectados | Todas las paginas |
-
-Cuando el dashboard esta en estado **Servidor conectado**, no se puede acceder a las paginas Overview, Changelog, Sync y Playtest.
-
-## Overview
-
-La pagina Overview es la pantalla inicial del Dashboard y muestra el estado general del sistema de un vistazo.
-
-### Tarjetas de estado
-
-| Tarjeta | Informacion mostrada |
-|---------|----------------------|
-| **Server** | Estado de conexion del servidor (Online/Offline) |
-| **Plugin** | Estado de conexion del plugin, informacion del Place |
-| **Agent** | Nombre del agente de IA actualmente conectado |
-| **Sync** | Estado de sincronizacion (Idle/Syncing/Error) |
-
-### Cambios recientes del juego (Recent Game Changes)
-
-Muestra en tiempo real los cambios recientes realizados por la IA en Studio (maximo 20). Cada elemento se muestra con un icono de categoria de cambio, y al hacer clic se navega a la vista detallada en [Changelog](changelog.md).
-
-Iconos de categoria:
-- Script — creacion/modificacion de scripts
-- Instance — creacion/eliminacion/movimiento de instancias
-- Property — cambio de propiedades
-- Lighting — configuracion de iluminacion/entorno
-- Terrain — cambios de terreno
-- Asset — insercion de assets
-
-### Resumen de cambios de sesion (Session Change Summary)
-
-Muestra las estadisticas de cambios de la sesion actual agregadas por categoria (ej: "4 scripts · 3 properties").
-
-## Actualizaciones en tiempo real
-
-El Dashboard utiliza SSE (Server-Sent Events) para actualizar los datos en tiempo real:
-
-- Estado del servidor: polling cada 5 segundos
-- Feed de cambios, eventos de conexion: streaming en tiempo real via SSE
-- Desconexion de SSE: reconexion automatica tras 3 segundos
-
-## Documentos relacionados
-
-- [Changelog](changelog.md) — seguimiento del historial de cambios del juego
-- [Connection](connection.md) — estado de conexion del servidor/agente/plugin
-- [Sync](sync.md) — monitoreo del estado de sincronizacion
-- [Playtest](playtest.md) — historial de playtest
-- [Tools](tools.md) — historial/estadisticas de ejecucion de herramientas
-- [Settings](settings.md) — licencia, configuracion del servidor, idioma
-- [Lista completa de herramientas](../tools/overview.md)
-- [Guia detallada de Sync](../sync/overview.md)

package/docs/es/dashboard/playtest.md

@@ -1,61 +0,0 @@
-# Playtest
-
-> Consulta el estado de los playtests ejecutados por la IA y los resultados de las pruebas.
-
-![Playtest — estado del playtest e historial de pruebas](../../assets/screenshots/dashboard/dashboard_playtest.png)
-
-## Descripcion general
-
-La pagina Playtest muestra el estado de los playtests ejecutados por la IA y los resultados de las pruebas. Solo es accesible cuando el dashboard esta en estado **Studio conectado**.
-
-## Playtest Status
-
-Muestra el estado actual del playtest:
-
-| Estado | Significado |
-|--------|-------------|
-| **NotRunning** | Playtest no ejecutado |
-| **Running** | Playtest en ejecucion |
-| **Paused** | Playtest pausado (modo Run) |
-
-## Test History
-
-Lista en orden cronologico los resultados de las pruebas ejecutadas por la IA mediante la accion `run_test`:
-
-| Campo | Descripcion |
-|-------|-------------|
-| Marca de tiempo | Hora de ejecucion de la prueba |
-| Test Report | Enlace al reporte de prueba |
-| Mode | Modo de ejecucion (play/run) |
-| Duration | Tiempo de duracion de la prueba |
-| Status | Resultado (Passed/Failed) |
-
-Al hacer clic en el reporte de prueba, se puede ver el reporte detallado en formato markdown y los logs.
-
-## Casos de uso
-
-### Analisis de pruebas fallidas
-
-```
-"Quiero encontrar la causa del fallo de la prueba automatica que acabo de ejecutar"
-```
-
-Busca la prueba con estado Failed en el Test History y haz clic en el Test Report para ver los logs detallados y la causa del fallo.
-
-### Consultar historial de pruebas
-
-```
-"Quiero ver el estado de exito/fallo de las pruebas ejecutadas hoy"
-```
-
-Revisa la marca de tiempo y el Status en el Test History para identificar la tendencia de los resultados de las pruebas.
-
-## Documentos relacionados
-
-- [WEPPY Dashboard Overview](overview.md)
-- [Changelog](changelog.md)
-- [Connection](connection.md)
-- [Sync](sync.md)
-- [Tools](tools.md)
-- [Settings](settings.md)
-- [Playtest y pruebas automatizadas (herramientas)](../tools/playtest.md)