Verifica el estado y los resultados de las pruebas ejecutadas por la IA y controla el playtest de Studio con la IA.
Resumen
La página Playtest muestra el estado y los resultados de las pruebas ejecutadas por la IA. Solo es accesible cuando el dashboard está en estado Studio conectado.
La IA controla directamente el playtest mediante las acciones play/stop/pause/resume/play_status/run_test de la herramienta system_info.
Playtest Status
Muestra el estado actual del playtest:
| Estado | Significado |
|---|---|
| NotRunning | Playtest no ejecutándose |
| Running | Playtest en ejecución |
| Paused | Playtest en pausa (modo Run) |
Test History
Lista en orden cronológico los resultados de las pruebas ejecutadas por la IA con la acción run_test:
| Elemento | Descripción |
|---|---|
| Timestamp | Hora de ejecución de la prueba |
| Test Report | Enlace al informe de la prueba |
| Mode | Modo de ejecución (play/run) |
| Duration | Tiempo empleado en la prueba |
| Status | Resultado (Passed/Failed) |
Al hacer clic en un informe de prueba puedes ver el informe detallado en formato markdown y los logs.
Flujos de trabajo principales
Control manual del playtest
"Inicia el juego en modo Play (F5)"
"Detén el playtest actual"play → verifica el estado con play_status → termina con stop.
Ejecución de pruebas automáticas (run_test)
"Escribe y ejecuta una prueba que verifique si SpawnLocation está en la posición correcta"run_test inyecta el script de prueba e inicia/recoge/limpia el playtest automáticamente.
Validación estilo CI
"Prueba en modo Run (F8) si el NPC AI llega al punto objetivo y muéstrame los logs si falla"Ejecuta run_test con mode: "run" para realizar pruebas del lado del servidor.
Máquina de estados del playtest
Edit ──play──→ Running ──stop──→ Edit
│ ↑
pause stop
│ │
↓ │
Paused ──resume──→ Running| Estado | Acciones posibles |
|---|---|
edit | play |
running | stop, pause (solo modo Run) |
paused | resume, stop |
- Modo Play (F5): Simulación cliente+servidor. No soporta pause/resume.
- Modo Run (F8): Simulación solo servidor. Soporta pause/resume.
Pipeline de run_test
run_test orquesta automáticamente los siguientes pasos:
1. Preparación
- Consulta información del Place (
place_info) - Inicializa el buffer de logs existentes
2. Inyección del script
- Crea el script de prueba envuelto en
ServerScriptService.__MCP_TestRunner - El wrapper maneja automáticamente las señales START/FINISHED y el traceback de errores
3. Ejecución y monitoreo
- Inicia el playtest (modo Play o Run)
- Sondea logs cada 500ms
- Determina la finalización al recibir la señal
[WEPPY_TEST]:FINISHED - Se detiene automáticamente al superar el tiempo de espera (60 segundos por defecto, máximo 300 segundos)
4. Limpieza
- Detiene automáticamente el playtest
- Elimina el script de prueba inyectado
- Recoge los últimos logs
5. Generación del informe
Los informes y logs se guardan localmente bajo {projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/.
{projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/
├── test-report.md # Resumen de resultados (estado, tiempo, señales)
└── test-log.txt # Log completo (timestamp, secuencia, nivel)Ejemplo de test-report.md:
# Test Report
- Status: passed
- Test Name: spawn_location_test
- Mode: run
- Place ID: 123456
- Duration (ms): 1523
- Total Logs: 12
- Signal Count: 2
## Signals
- START: 2026-03-12T10:30:00.000Z
- FINISHED: 2026-03-12T10:30:01.523ZReferencia de acciones
| Acción | Descripción | Parámetros | Tier |
|---|---|---|---|
play | Inicia el playtest en modo Play (F5) o Run (F8) | mode: “play” | “run” | Pro |
stop | Detiene el playtest actual | — | Pro |
pause | Pausa el playtest en modo Run | — | Pro |
resume | Reanuda el playtest en modo Run pausado | — | Pro |
play_status | Consulta el estado del playtest y las acciones posibles | — | Pro |
run_test | Inyecta script de prueba → ejecuta → recoge logs → genera informe | script (obligatorio), test_name, mode, timeout | Pro |
Parámetros de run_test
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
script | string | ✅ | Cuerpo del código de prueba Luau a ejecutar |
test_name | string | — | Nombre de la prueba que aparece en el informe |
mode | ”play” | “run” | — | Modo del playtest (predeterminado: “play”) |
timeout | number | — | Segundos de tiempo de espera (predeterminado: 60, máximo: 300) |
Casos de uso
Analizar fallos en pruebas
"Quiero encontrar la causa del fallo en la prueba automática que acabo de ejecutar"Busca la prueba con estado Failed en Test History y haz clic en Test Report para ver los logs detallados y la causa del fallo.
Revisar el historial de pruebas
"Quiero ver el estado de éxito/fallo de las pruebas ejecutadas hoy"Revisa el timestamp y el Status en Test History para entender la tendencia de los resultados de las pruebas.