@weppy/roblox-mcp 1.5.4 → 2.0.0

package/docs/en/dashboard/settings.md

@@ -0,0 +1,67 @@
+# Settings
+
+> View and manage license information, server settings, sync settings, and language.
+
+## Overview
+
+The Settings page lets you view license information and server settings, and modify some of them. It is accessible whenever the server is connected (L1 or above).
+
+## License (Read-Only)
+
+Displays the current license status:
+
+| Field | Description |
+|-------|-------------|
+| Status | Status badge (Active/Inactive) |
+| Tier | Current tier (Basic/Pro) |
+| License Key | Masked license key |
+| Provider | License provider information |
+
+## General
+
+| Setting | Description |
+|---------|-------------|
+| Log Level | Log output level |
+| History Recording | Whether tool execution history is saved |
+| Stats Collection | Whether tool statistics are collected |
+| Request Timeout | Request timeout (seconds) |
+
+## Server Environment (Read-Only)
+
+Displays server settings configured via environment variables:
+
+| Environment Variable | Description | Default |
+|---------------------|-------------|---------|
+| `HTTP_PORT` | HTTP port | 3002 |
+| `HTTP_HOST` | HTTP host | 127.0.0.1 |
+| `DASHBOARD_AUTO_OPEN` | Auto-open dashboard | true |
+
+## Sync Settings
+
+| Setting | Description |
+|---------|-------------|
+| Max Depth | Maximum sync depth |
+| Max Instances | Maximum number of synced instances |
+
+## Language
+
+Change the dashboard UI language. 6 languages + Auto (automatic browser language detection) are supported.
+
+| Option | Language |
+|--------|----------|
+| Auto | Automatic browser language detection |
+| English | English |
+| 한국어 | Korean |
+| 日本語 | Japanese |
+| Español | Spanish |
+| Português | Portuguese |
+| Bahasa Indonesia | Indonesian |
+
+## Related Documents
+
+- [Dashboard Overview](overview.md)
+- [Changelog](changelog.md)
+- [Connection](connection.md)
+- [Sync](sync.md)
+- [Playtest](playtest.md)
+- [Tools](tools.md)

package/docs/en/dashboard/sync.md

@@ -0,0 +1,75 @@
+# Sync
+
+> Monitor the current status, direction settings, and logs for Studio <-> local file synchronization.
+
+![Sync — Sync status, direction settings, and logs](../../assets/screenshots/dashboard/dashboard_sync.png)
+
+> For a detailed guide on the Sync feature itself, see the [Sync Deep Dive](../sync/overview.md).
+
+## Overview
+
+The Sync page provides a visual overview of the current state and settings for Studio <-> local file synchronization. It is accessible only when the plugin is connected (L2).
+
+## Sync Status
+
+Displays the current sync state:
+
+| Status | Meaning |
+|--------|---------|
+| **Idle** | Waiting for sync |
+| **Initializing** | Initial sync in progress |
+| **Syncing** | Incremental sync in progress |
+| **Error** | Sync error occurred |
+
+The status card also shows the sync path, number of synced instances, and the current apply mode (Auto/Manual).
+
+## Sync Directions
+
+Shows sync directions by type in a table:
+
+| Column | Description |
+|--------|-------------|
+| Type | Sync target type (Scripts, Values, Instances, Data, Services) |
+| Direction | Sync direction (Local -> Studio, Studio -> Local) |
+| Apply Mode | Apply mode (Auto/Manual) |
+
+Check each type's sync direction to understand which changes are reflected in which direction.
+
+## Sync Config
+
+Displays sync configuration values:
+- Max Depth — Maximum sync depth
+- Max Instances — Maximum number of synced instances
+- Interval — Sync interval
+
+## Sync Log
+
+Displays sync events in chronological order. Each log entry includes a change type tag (create, update, delete, etc.) and the target path.
+
+## Use Cases
+
+### Checking Sync Status
+
+```
+"I want to verify that Sync is working properly"
+```
+
+Confirm that Sync Status is Idle and check the Sync Log to verify that recent changes were recorded normally.
+
+### Understanding Sync Direction
+
+```
+"I want to know which direction script changes are synced"
+```
+
+Check the Direction for the Scripts type in the Sync Directions table.
+
+## Related Documents
+
+- [Dashboard Overview](overview.md)
+- [Changelog](changelog.md)
+- [Connection](connection.md)
+- [Playtest](playtest.md)
+- [Tools](tools.md)
+- [Settings](settings.md)
+- [Sync Deep Dive](../sync/overview.md)

package/docs/en/dashboard/tools.md

@@ -0,0 +1,69 @@
+# Tools
+
+> View the execution history and statistics of MCP tools run by the AI.
+
+![Tools — Tool execution history and statistics](../../assets/screenshots/dashboard/dashboard_tools.png)
+
+## Overview
+
+The Tools page provides the execution history and statistics of MCP tools run by the AI. It consists of two sub-tabs: **History** and **Statistics**. It is accessible whenever the server is connected (L1 or above).
+
+## History Tab
+
+Shows tool execution records in a chronological table:
+
+| Column | Description |
+|--------|-------------|
+| Time | Execution time |
+| Tool.Action | Executed tool and action (e.g., `query_instances.get_instance`) |
+| Duration | Execution duration |
+| Status | Result status (OK/Error) |
+| Tier | Tier used (Basic/Pro) |
+
+Features:
+- **Tool filter** dropdown to show only a specific tool
+- Pagination for browsing large volumes of records
+- New execution records are added in real time
+
+## Statistics Tab
+
+Provides visual analysis of tool usage statistics:
+
+- **Tier distribution** — Basic/Pro tool usage ratio
+- **Per-tool statistics** — Call count and average response time for each tool
+- **Per-action breakdown** — Detailed statistics for each action within a tool
+
+## Basic Tier-Exclusive Features
+
+Additional UI is displayed for Basic tier users:
+
+- **Tier Usage Progress** — Usage progress bar
+- **Basic vs Pro comparison modal** — Information about additional Pro tier features
+
+## Use Cases
+
+### Analyzing Tool Performance
+
+```
+"I want to know which tool takes the longest"
+```
+
+Check the average response time per tool in the Statistics tab.
+
+### Tracking Errors
+
+```
+"I want to find out why the tool I just ran failed"
+```
+
+Find items with an Error status in the History tab to view detailed information.
+
+## Related Documents
+
+- [Dashboard Overview](overview.md)
+- [Changelog](changelog.md)
+- [Connection](connection.md)
+- [Sync](sync.md)
+- [Playtest](playtest.md)
+- [Settings](settings.md)
+- [Full Tool Reference](../tools/overview.md)

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

@@ -21,7 +21,7 @@ Run in Claude Code terminal:
 
 ```bash
 # Add marketplace
-/plugin marketplace add hope1026/roblox-mcp
+/plugin marketplace add hope1026/weppy-roblox-mcp
 
 # Install plugin
 /plugin install weppy-roblox-mcp@hope1026-roblox-mcp

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

@@ -13,7 +13,7 @@ Roblox Studio Explorer-like tree view for VSCode. Browse synced instance trees,
 
 ### 1. Download VSIX
 
-Go to the [Releases](https://github.com/hope1026/roblox-mcp/releases) page and download the latest `weppy-roblox-explorer-*.vsix` file.
+Go to the [Releases](https://github.com/hope1026/weppy-roblox-mcp/releases) page and download the latest `weppy-roblox-explorer-*.vsix` file.
 
 > The VSIX file is attached as a release asset alongside the plugin ZIP.
 
@@ -60,7 +60,7 @@ Go to the [Releases](https://github.com/hope1026/roblox-mcp/releases) page and d
 
 ## Updating
 
-Download the latest `.vsix` from [Releases](https://github.com/hope1026/roblox-mcp/releases) and repeat the installation steps. VSCode will replace the existing version.
+Download the latest `.vsix` from [Releases](https://github.com/hope1026/weppy-roblox-mcp/releases) and repeat the installation steps. VSCode will replace the existing version.
 
 ## Related
 

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

@@ -4,7 +4,7 @@ How to install the plugin to connect AI agents with Roblox Studio.
 
 ## 1. Download Plugin
 
-1. Open [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+1. Open [GitHub Releases](https://github.com/hope1026/weppy-roblox-mcp/releases/latest)
 2. Download `weppy-roblox-mcp-v{version}.zip`
 3. Extract the ZIP file - you will find `roblox-plugin/WeppyRobloxMCP.rbxm` and setup guides
 

package/docs/en/pro-upgrade.md

@@ -30,7 +30,7 @@ Terrain generation, asset search, spatial analysis, animation, audio, and produc
 
 ### Step 2: Download from GitHub Releases
 
-1. Open [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+1. Open [GitHub Releases](https://github.com/hope1026/weppy-roblox-mcp/releases/latest)
 2. Download `weppy-roblox-mcp-v{version}.zip`
 3. Extract and copy `roblox-plugin/WeppyRobloxMCP.rbxm` to your Roblox Plugins folder
 

package/docs/es/README.md

@@ -1,10 +1,12 @@
-# Roblox MCP
+# Roblox MCP — Servidor MCP para Roblox Studio | Desarrollo de juegos con IA usando Claude, Codex, Cursor y Gemini
 
-> Servidor MCP y plugin para Roblox Studio — controla scripts, terrain, assets e iluminacion con Claude Code, Cursor, Codex y Gemini.
+> **Weppy Roblox MCP** 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.
+
+**21 herramientas consolidadas · 140+ 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](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
+[![Demo — IA creando un juego Roblox en tiempo real](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
 
 ## Instalacion rapida (5 minutos)
 
@@ -64,7 +66,17 @@ 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."
 
-### 4) Roblox Explorer: explora la jerarquia de Studio en VSCode
+### 4) 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.
+
+![Dashboard Overview — estado del servidor, cambios recientes y resumen de sesion](../assets/screenshots/dashboard/dashboard_overview.png)
+
+- 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
+
+### 5) 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.
 
@@ -86,6 +98,7 @@ Visualiza el arbol completo de instancias de tu lugar en Roblox Studio directame
 - [Guia de instalacion](../en/installation/README.md)
 - [Lista completa de tools](tools/overview.md)
 - [Guia detallada de Sync](sync/overview.md)
+- [Guia del Dashboard](dashboard/overview.md)
 - [Roblox Explorer (Extension VSCode)](../en/installation/roblox-explorer.md)
 - [Compatibilidad](../compatibility.md)
 - [Solucion de problemas](../troubleshooting.md)
@@ -107,4 +120,4 @@ Sync bidireccional, capacidades de creacion avanzadas y eficiencia de tokens de
 
 ---
 
-[GitHub Issues](https://github.com/hope1026/roblox-mcp/issues) · [Discussions](https://github.com/hope1026/roblox-mcp/discussions) · [npm](https://www.npmjs.com/package/@weppy/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

@@ -0,0 +1,114 @@
+# 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
+
+- [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

@@ -0,0 +1,77 @@
+# 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 servidor este conectado (L1 o superior).
+
+## 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
+
+- [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

@@ -0,0 +1,95 @@
+# 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.
+
+![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, configuracion de Sync, 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)).
+
+## Niveles de conexion
+
+El Dashboard ofrece diferentes funciones segun el estado de conexion:
+
+| Nivel | Condicion | Paginas disponibles |
+|:-----:|-----------|---------------------|
+| **L0** | Servidor no conectado | Solo se muestra la pantalla de espera de reconexion |
+| **L1** | Servidor conectado, plugin no conectado | Connection, Tools, Settings |
+| **L2** | Servidor + plugin ambos conectados | Todas las paginas |
+
+Cuando el plugin no esta conectado (L1), 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

@@ -0,0 +1,61 @@
+# 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 plugin esta conectado (L2).
+
+## 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
+
+- [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)