@weppy/roblox-mcp 1.4.2 → 1.5.1

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

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

@@ -56,7 +56,15 @@ La IA trabaja sobre un espejo local sincronizado, asi que los cambios en multipl
 - Basic: sincronizacion unidireccional (Studio -> Local)
 - Pro: sincronizacion bidireccional + Direction/Apply Mode por tipo + historial + multiplace
 
-### 3) Roblox Explorer: explora la jerarquia de Studio en VSCode
+### 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."
+
+### 4) 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.
 
@@ -76,12 +84,21 @@ Visualiza el arbol completo de instancias de tu lugar en Roblox Studio directame
 ## Documentacion detallada
 
 - [Guia de instalacion](../en/installation/README.md)
-- [Cobertura de herramientas](../en/tools/overview.md)
-- [Guia detallada de Sync](../en/sync/overview.md)
+- [Lista completa de tools](tools/overview.md)
+- [Guia detallada de Sync](sync/overview.md)
 - [Roblox Explorer (Extension VSCode)](../en/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
+
 ## Upgrade Pro
 
 Sync bidireccional, capacidades de creacion avanzadas y eficiencia de tokens de IA — todo en una sola actualizacion.

package/docs/es/pro-upgrade.md

@@ -53,5 +53,6 @@ Generación de terreno, búsqueda de assets, análisis espacial, animación, aud
 | Resync / Reconstruir estado | ❌ | ✅ |
 | Historial de cambios | ❌ | ✅ |
 | Sync multi-place | ❌ | ✅ Hasta 3 places con almacenamiento aislado |
+| Control de Playtest (Reproducir/Detener/Pausar/Reanudar) | ❌ | ✅ |
 | Cobertura avanzada de tools | Conjunto base | Conjunto avanzado más amplio |
 | Eficiencia de tokens IA | Estándar | Mejor con acciones masivas / de alto impacto |

package/docs/es/tools/assets-and-effects.md

@@ -0,0 +1,104 @@
+# Assets y efectos
+
+> Inserta assets y controla tween, audio, particulas, animacion y grupos de colision.
+
+## Tools incluidas
+
+| Tool | Tier | Descripcion |
+|------|:----:|-------------|
+| `manage_assets` | Pro | Busca en Creator Store, inserta modelos y paquetes, consulta informacion del asset |
+| `manage_tween` | Pro | Crea, reproduce, pausa y cancela tweens |
+| `manage_animation` | Pro | Carga, reproduce, detiene e inspecciona tracks de animacion |
+| `manage_audio` | Pro | Reproduce, detiene, pausa y reanuda sonidos; configura el listener |
+| `manage_effects` | Pro | Emite particulas, limpia efectos y alterna su estado |
+| `manage_physics` | Pro | Registra grupos de colision y configura colisiones |
+
+## Flujos principales
+
+### Armar una escena con assets
+
+```
+"Busca un modelo de arbol en Creator Store y coloca tres en Workspace."
+```
+
+Usa `manage_assets.search_insert` para buscar e insertar en un solo paso.
+
+### Crear una interaccion visual
+
+```
+"Haz que la puerta se abra con un tween de 3 segundos al hacer clic."
+```
+
+Usa `manage_tween.create` para definir el movimiento y `manage_tween.play` para reproducirlo. Puedes combinarlo con `manage_audio.play` para el sonido.
+
+### Combinar particulas y audio
+
+```
+"Reproduce un sonido de explosion y emite particulas cuando aparezca el boss."
+```
+
+Usa `manage_effects.emit` para las particulas y `manage_audio.play` para el sonido.
+
+## Referencia de acciones
+
+### Manage Assets (Pro)
+
+| Accion | Descripcion | Tier |
+|--------|-------------|------|
+| `insert` | Insertar un modelo por ID de asset | Pro |
+| `info` | Obtener metadatos del asset | Pro |
+| `search` | Buscar en Creator Store | Pro |
+| `search_insert` | Buscar e insertar la primera coincidencia | Pro |
+| `insert_free` | Insertar un modelo gratuito | Pro |
+| `insert_package` | Insertar un paquete | Pro |
+| `export` | Exportar la seleccion actual | Pro |
+
+### Manage Tween (Pro)
+
+| Accion | Descripcion | Tier |
+|--------|-------------|------|
+| `create` | Crear un tween con propiedades objetivo | Pro |
+| `play` | Reproducir un tween creado | Pro |
+| `pause` | Pausar un tween en ejecucion | Pro |
+| `cancel` | Cancelar un tween | Pro |
+
+### Manage Animation (Pro)
+
+| Accion | Descripcion | Tier |
+|--------|-------------|------|
+| `load` | Cargar una animacion en Humanoid o AnimationController | Pro |
+| `play` | Reproducir un track de animacion cargado | Pro |
+| `stop` | Detener una animacion en reproduccion | Pro |
+| `get_tracks` | Listar todos los tracks de animacion cargados | Pro |
+
+### Manage Audio (Pro)
+
+| Accion | Descripcion | Tier |
+|--------|-------------|------|
+| `play` | Reproducir un sonido y crear `Sound` si hace falta | Pro |
+| `stop` | Detener un sonido en reproduccion | Pro |
+| `pause` | Pausar un sonido en reproduccion | Pro |
+| `resume` | Reanudar un sonido pausado | Pro |
+| `set_listener` | Definir el tipo o destino del listener de audio | Pro |
+
+### Manage Effects (Pro)
+
+| Accion | Descripcion | Tier |
+|--------|-------------|------|
+| `emit` | Emitir particulas desde `ParticleEmitter` | Pro |
+| `clear` | Limpiar todas las particulas | Pro |
+| `toggle` | Activar o desactivar un efecto | Pro |
+
+### Manage Physics (Pro)
+
+| Accion | Descripcion | Tier |
+|--------|-------------|------|
+| `register_group` | Registrar un grupo de colision | Pro |
+| `set_collidable` | Definir si dos grupos pueden colisionar | Pro |
+| `get_groups` | Listar todos los grupos de colision registrados | Pro |
+
+## Documentos relacionados
+
+- [Instancias y propiedades](instances-and-properties.md) - crear y colocar objetos
+- [Mundo y entorno](world-and-environment.md) - iluminacion, terrain y camara
+- [Lista completa de tools](overview.md)

package/docs/es/tools/instances-and-properties.md

@@ -0,0 +1,104 @@
+# Instancias y propiedades
+
+> Busca, crea y edita instancias de Roblox Studio mientras administras propiedades, atributos y tags.
+
+## Tools incluidas
+
+| Tool | Tier | Descripcion |
+|------|:----:|-------------|
+| `query_instances` | Mixto | Busca instancias, recorre la jerarquia e inspecciona informacion de clase |
+| `mutate_instances` | Mixto | Crea, elimina, clona, mueve y renombra instancias |
+| `manage_properties` | Mixto | Lee y escribe propiedades, atributos y tags |
+
+## Flujos principales
+
+### Entender la estructura de la escena
+
+```
+"Busca todos los Part dentro de Workspace y dime su posicion y tamano."
+```
+
+Usa `query_instances.search_class` para encontrar los Part y `manage_properties.mass_get` para leer `Position` y `Size` en lote.
+
+### Colocar objetos en lote
+
+```
+"Coloca 4 SpawnLocation en un cuadrado en el centro del mapa y asigna un TeamColor distinto a cada uno."
+```
+
+Usa `mutate_instances.mass_create` para crearlos en una sola solicitud y luego `manage_properties.mass_set` para definir sus propiedades.
+
+### Administrar objetos por tag
+
+```
+"Busca todos los objetos con el tag Collectible y cambia Anchored a true."
+```
+
+Usa `manage_properties.get_tagged` para reunir las instancias y `manage_properties.mass_set` para actualizarlas.
+
+## Referencia de acciones
+
+### Query Instances (Mixto)
+
+| Accion | Descripcion | Tier |
+|--------|-------------|------|
+| `get` | Obtener propiedades de una instancia por path | Basic |
+| `children` | Obtener hijos directos o todos los descendientes | Basic |
+| `find_child` | Buscar el primer hijo por nombre y filtro opcional de clase | Basic |
+| `find_descendant` | Buscar el primer descendiente por nombre | Basic |
+| `wait_for_child` | Esperar a que aparezca un hijo (con timeout) | Basic |
+| `class_info` | Obtener informacion de clase y propiedades validas | Basic |
+| `search_name` | Buscar instancias por patron de nombre (con comodines) | Basic |
+| `search_class` | Buscar instancias por nombre de clase | Basic |
+| `file_tree` | Obtener la estructura de archivos desde la raiz | Pro |
+| `project_structure` | Obtener la estructura completa del proyecto | Pro |
+| `descendants` | Obtener todos los descendientes de una instancia | Pro |
+| `ancestors` | Obtener todos los ancestros de una instancia | Pro |
+| `search_property` | Buscar instancias por valor de propiedad | Pro |
+| `search_tag` | Buscar instancias por tag | Pro |
+
+### Mutate Instances (Mixto)
+
+| Accion | Descripcion | Tier |
+|--------|-------------|------|
+| `create` | Crear una instancia nueva | Basic |
+| `create_with_props` | Crear una instancia con propiedades iniciales | Basic |
+| `delete` | Eliminar una instancia | Basic |
+| `clone` | Clonar una instancia | Basic |
+| `move` | Mover una instancia a un nuevo parent | Basic |
+| `rename` | Renombrar una instancia | Basic |
+| `pivot` | Definir posicion de pivot o CFrame | Basic |
+| `create_tree` | Crear un arbol jerarquico de instancias | Pro |
+| `mass_create` | Crear varias instancias de una vez | Pro |
+| `mass_delete` | Eliminar varias instancias | Pro |
+| `mass_duplicate` | Duplicar varias instancias | Pro |
+| `smart_duplicate` | Duplicar con espaciado y cantidad | Pro |
+
+### Manage Properties (Mixto)
+
+| Accion | Descripcion | Tier |
+|--------|-------------|------|
+| `get` | Obtener el valor de una propiedad | Basic |
+| `set` | Definir el valor de una propiedad | Basic |
+| `get_all` | Obtener todas las propiedades de una instancia | Basic |
+| `set_multiple` | Definir varias propiedades a la vez | Basic |
+| `get_attr` | Obtener el valor de un atributo | Basic |
+| `set_attr` | Definir el valor de un atributo | Basic |
+| `get_all_attrs` | Obtener todos los atributos | Basic |
+| `delete_attr` | Eliminar un atributo | Basic |
+| `add_tag` | Agregar un tag a una instancia | Basic |
+| `remove_tag` | Quitar un tag de una instancia | Basic |
+| `check_tag` | Verificar si una instancia tiene un tag | Basic |
+| `get_tags` | Obtener todos los tags de una instancia | Basic |
+| `get_tagged` | Obtener todas las instancias con un tag especifico | Basic |
+| `set_calculated` | Definir una propiedad usando una expresion matematica | Pro |
+| `set_relative` | Definir una propiedad relativa a su valor actual | Pro |
+| `mass_set` | Definir una propiedad en varias instancias | Pro |
+| `mass_get` | Obtener una propiedad de varias instancias | Pro |
+| `modify_children` | Modificar todos los hijos de un parent | Pro |
+
+## Documentos relacionados
+
+- [Scripting y ejecucion de codigo](scripting.md) - agregar o editar scripts en instancias
+- [Assets y efectos](assets-and-effects.md) - insertar modelos, tween y efectos
+- [Lista completa de tools](overview.md)

package/docs/es/tools/overview.md

@@ -2,6 +2,20 @@
 
 Para parametros detallados, consulte las definiciones de herramientas MCP directamente.
 
+## Guias por flujo
+
+Consulte estas guias orientadas al flujo de trabajo:
+
+| Categoria | Descripcion | Tools incluidas |
+|-----------|-------------|-----------------|
+| [Instancias y propiedades](instances-and-properties.md) | Busqueda, creacion, edicion y tags de instancias | `query_instances`, `mutate_instances`, `manage_properties` |
+| [Scripting y ejecucion de codigo](scripting.md) | Gestion de scripts y ejecucion de Luau | `manage_scripts`, `execute_luau` |
+| [Mundo y entorno](world-and-environment.md) | Iluminacion, terrain, consultas espaciales y camara | `manage_lighting`, `manage_terrain`, `spatial_query`, `manage_camera` |
+| [Assets y efectos](assets-and-effects.md) | Insercion de assets, tween, animacion, audio y efectos | `manage_assets`, `manage_tween`, `manage_animation`, `manage_audio`, `manage_effects`, `manage_physics` |
+| [Playtest y pruebas automatizadas](playtest.md) | Control de playtest y validacion automatica | `system_info` (`play`, `stop`, `pause`, `resume`, `play_status`, `run_test`) |
+| [Sync](../sync/overview.md) | Sincronizacion entre Studio y archivos locales | `manage_sync`, `workspace_state` |
+| [Sistema y depuracion](system-and-debugging.md) | Conexion, logs, seleccion y ejecucion por lotes | `system_info` (`ping`, `connection`, `usage`, ...), `manage_logs`, `manage_selection`, `batch_execute` |
+
 Documentacion relacionada:
 - [Guia detallada de Sync](../sync/overview.md)
 
@@ -248,6 +262,12 @@ Politica de Sync:
 | `place_info` | Obtener Place ID, nombre, creador | Pro |
 | `services` | Listar todos los servicios de Roblox | Pro |
 | `studio_settings` | Obtener preferencias de Studio | Pro |
+| `play` | Iniciar playtest en modo Play (F5) o Run (F8) | Pro |
+| `stop` | Detener el playtest activo | Pro |
+| `pause` | Pausar el playtest activo en modo Run | Pro |
+| `resume` | Reanudar el playtest pausado en modo Run | Pro |
+| `play_status` | Obtener estado del playtest y acciones disponibles | Pro |
+| `run_test` | Inyectar un script temporal de prueba, ejecutar playtest, recopilar logs y escribir reportes locales | Pro |
 
 ## Batch Execute (Pro)
 

package/docs/es/tools/playtest.md

@@ -0,0 +1,140 @@
+# Playtest y pruebas automatizadas
+
+> Controla el playtest de Roblox Studio con IA, inyecta scripts de prueba y genera logs y reportes locales automaticamente.
+
+## Tools incluidas
+
+| Tool | Tier | Descripcion |
+|------|:----:|-------------|
+| `system_info` | Pro | acciones `play`, `stop`, `pause`, `resume`, `play_status`, `run_test` |
+
+> Para otras acciones de `system_info` como `ping`, `connection` y `usage`, consulta [Sistema y depuracion](system-and-debugging.md).
+
+## Flujos principales
+
+### Control manual de playtest
+
+```
+"Inicia el juego en modo Play (F5)."
+"Deten el playtest actual."
+```
+
+Flujo tipico: `play` -> `play_status` -> `stop`.
+
+### Ejecutar una prueba automatizada
+
+```
+"Escribe y ejecuta una prueba que verifique si el SpawnLocation esta bien posicionado."
+```
+
+`run_test` inyecta el script de prueba, inicia el playtest automaticamente, recopila logs y hace la limpieza.
+
+### Verificacion estilo CI
+
+```
+"Ejecuta una prueba en modo Run (F8) que verifique si el NPC llega al objetivo y muestrame los logs si falla."
+```
+
+Usa `run_test` con `mode: "run"` para validaciones enfocadas en el servidor.
+
+## Maquina de estados del playtest
+
+```text
+Edit --play--> Running --stop--> Edit
+                  |               ^
+                pause             |
+                  |               |
+                  v               |
+               Paused --resume--> Running
+```
+
+| Estado | Acciones disponibles |
+|--------|----------------------|
+| `edit` | `play` |
+| `running` | `stop`, `pause` (solo modo Run) |
+| `paused` | `resume`, `stop` |
+
+- Modo Play (F5): simulacion de cliente + servidor, sin pausa ni reanudacion
+- Modo Run (F8): simulacion solo de servidor, con pausa y reanudacion
+
+## Flujo de `run_test`
+
+`run_test` orquesta estos pasos automaticamente:
+
+### 1. Preparacion
+
+- Leer informacion del place con `place_info`
+- Limpiar el buffer de logs existente
+
+### 2. Inyeccion del script
+
+- Crear `ServerScriptService.__MCP_TestRunner` con un script de prueba envuelto
+- El wrapper maneja las senales `START` y `FINISHED` y los tracebacks de error
+
+### 3. Ejecucion y monitoreo
+
+- Iniciar el playtest en modo Play o Run
+- Consultar logs cada 500 ms
+- Finalizar cuando se detecte `[WEPPY_TEST]:FINISHED`
+- Detener automaticamente al llegar al timeout (60 segundos por defecto, 300 maximo)
+
+### 4. Limpieza
+
+- Detener el playtest automaticamente
+- Eliminar el script de prueba inyectado
+- Recoger los logs finales
+
+### 5. Escritura de reportes
+
+Los reportes y logs se escriben en archivos locales:
+
+```text
+roblox-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/
+├── test-report.md
+└── test-log.txt
+```
+
+Ejemplo de `test-report.md`:
+
+```markdown
+# 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.523Z
+```
+
+## Referencia de acciones
+
+| Accion | Descripcion | Parametros | Tier |
+|--------|-------------|------------|------|
+| `play` | Iniciar playtest en modo Play (F5) o Run (F8) | `mode`: `"play"` \| `"run"` | Pro |
+| `stop` | Detener el playtest actual | - | Pro |
+| `pause` | Pausar un playtest en modo Run | - | Pro |
+| `resume` | Reanudar un playtest pausado en modo Run | - | Pro |
+| `play_status` | Obtener el estado del playtest y acciones disponibles | - | Pro |
+| `run_test` | Inyectar script de prueba, ejecutar playtest, recopilar logs y escribir reportes | `script` (obligatorio), `test_name`, `mode`, `timeout` | Pro |
+
+### Parametros de `run_test`
+
+| Parametro | Tipo | Obligatorio | Descripcion |
+|-----------|------|:-----------:|-------------|
+| `script` | string | ✅ | Cuerpo del codigo Luau de prueba a ejecutar |
+| `test_name` | string | - | Nombre mostrado en el reporte |
+| `mode` | `"play"` \| `"run"` | - | Modo de playtest, por defecto `"play"` |
+| `timeout` | number | - | Timeout en segundos, por defecto 60, maximo 300 |
+
+## Documentos relacionados
+
+- [Sistema y depuracion](system-and-debugging.md) - acciones de conexion y gestion de logs
+- [Scripting y ejecucion de codigo](scripting.md) - escribir scripts y ejecutar Luau
+- [Lista completa de tools](overview.md)

package/docs/es/tools/scripting.md

@@ -0,0 +1,66 @@
+# Scripting y ejecucion de codigo
+
+> Administra el codigo fuente de scripts y ejecuta Luau arbitrario dentro de Roblox Studio.
+
+## Tools incluidas
+
+| Tool | Tier | Descripcion |
+|------|:----:|-------------|
+| `manage_scripts` | Mixto | Crear, leer, editar, buscar y analizar dependencias de scripts |
+| `execute_luau` | Pro | Ejecutar Luau arbitrario en el sandbox de Roblox Studio |
+
+## Flujos principales
+
+### Editar un script
+
+```
+"Cambia maxPlayers de 12 a 24 en el script GameManager dentro de ServerScriptService."
+```
+
+Usa `manage_scripts.search` para encontrar la linea correcta y `manage_scripts.edit_replace` para actualizarla.
+
+### Refactorizar varios scripts (Pro)
+
+```
+"Reemplaza OldModule por NewModule en todos los scripts."
+```
+
+Usa `manage_scripts.replace` para aplicar el cambio en varios scripts en una sola solicitud.
+
+### Inspeccionar datos de runtime (Pro)
+
+```
+"Calcula la salud promedio de todos los Humanoid que estan en Workspace."
+```
+
+Usa `execute_luau` para ejecutar Luau personalizado y leer datos del runtime actual.
+
+## Referencia de acciones
+
+### Manage Scripts (Mixto)
+
+| Accion | Descripcion | Tier |
+|--------|-------------|------|
+| `get_source` | Obtener codigo fuente del script | Basic |
+| `set_source` | Definir codigo fuente del script | Basic |
+| `create` | Crear un script nuevo | Basic |
+| `delete` | Eliminar un script | Basic |
+| `edit_replace` | Reemplazar lineas especificas en un script | Basic |
+| `edit_insert` | Insertar lineas en una posicion | Basic |
+| `edit_delete` | Eliminar lineas especificas | Basic |
+| `search` | Buscar texto en scripts | Basic |
+| `get_dependencies` | Obtener dependencias de un script | Basic |
+| `replace` | Reemplazo masivo en scripts | Pro |
+
+### Execute Luau (Pro)
+
+Ejecuta Luau arbitrario dentro del sandbox de Roblox Studio.
+
+- Servicios bloqueados: `HttpService`, `DataStoreService`, `MessagingService`
+- APIs inaccesibles: `CoreGui`, `CorePackages`
+
+## Documentos relacionados
+
+- [Instancias y propiedades](instances-and-properties.md) - crear o mover instancias de script
+- [Playtest y pruebas automatizadas](playtest.md) - inyectar y ejecutar scripts de prueba
+- [Lista completa de tools](overview.md)

package/docs/es/tools/system-and-debugging.md

@@ -0,0 +1,85 @@
+# Sistema y depuracion
+
+> Verifica la conexion, administra logs, controla la seleccion de Studio y ejecuta lotes para flujos de depuracion.
+
+## Tools incluidas
+
+| Tool | Tier | Descripcion |
+|------|:----:|-------------|
+| `system_info` | Mixto | `ping`, `connection`, `usage`, `place_info`, `services`, `studio_settings` |
+| `manage_logs` | Basic | Consultar logs, limpiar buffers y filtrar errores recientes |
+| `manage_selection` | Mixto | Leer, reemplazar y monitorear la seleccion de Studio |
+| `batch_execute` | Pro | Ejecutar varios comandos en un solo lote |
+
+> Para las acciones de playtest de `system_info` como `play`, `stop` y `run_test`, consulta [Playtest y pruebas automatizadas](playtest.md).
+
+## Flujos principales
+
+### Verificar la conexion
+
+```
+"Comprueba si Studio esta conectado correctamente."
+```
+
+Usa `system_info.ping` para una verificacion rapida.
+
+### Depurar errores recientes
+
+```
+"Muestrame los errores mas recientes."
+```
+
+Usa `manage_logs.errors` para obtener solo los errores recientes. `manage_logs.get` tambien soporta consulta incremental con el cursor `sinceSeq`.
+
+### Ejecutar un flujo por lotes (Pro)
+
+```
+"Cambia a rojo todos los Part de Workspace y luego enfoca la camara en el primero."
+```
+
+Usa `batch_execute` para agrupar varios comandos en una sola solicitud.
+
+## Referencia de acciones
+
+### System Info (Mixto)
+
+| Accion | Descripcion | Tier |
+|--------|-------------|------|
+| `ping` | Probar la conexion | Basic |
+| `connection` | Obtener informacion de conexion del servidor y plugin | Basic |
+| `usage` | Obtener el tier actual (`basic` o `pro`) | Basic |
+| `place_info` | Obtener Place ID, nombre y creador | Pro |
+| `services` | Listar todos los servicios de Roblox | Pro |
+| `studio_settings` | Obtener preferencias de Studio | Pro |
+
+### Manage Logs (Basic)
+
+| Accion | Descripcion | Tier |
+|--------|-------------|------|
+| `get` | Obtener logs filtrados con soporte opcional de cursor `sinceSeq` | Basic |
+| `clear` | Limpiar el buffer de logs | Basic |
+| `errors` | Obtener solo errores recientes | Basic |
+
+### Manage Selection (Mixto)
+
+| Accion | Descripcion | Tier |
+|--------|-------------|------|
+| `get` | Obtener la seleccion actual | Basic |
+| `set` | Reemplazar la seleccion actual | Basic |
+| `clear` | Limpiar la seleccion | Basic |
+| `cached` | Obtener la seleccion cacheada sin round-trip | Basic |
+| `context` | Obtener contexto detallado con codigo fuente y propiedades | Pro |
+| `details` | Obtener detalles jerarquicos con ancestros y descendientes | Pro |
+| `add` | Agregar elementos a la seleccion | Pro |
+| `remove` | Quitar elementos de la seleccion | Pro |
+| `watch` | Monitorear cambios de seleccion | Pro |
+
+### Batch Execute (Pro)
+
+Ejecuta varios comandos en un solo lote. Cada comando incluye nombre de tool y argumentos, se ejecuta en orden y puede continuar despues de errores si se configura asi.
+
+## Documentos relacionados
+
+- [Playtest y pruebas automatizadas](playtest.md) - acciones de playtest en `system_info`
+- [Scripting y ejecucion de codigo](scripting.md) - ejecutar Luau para investigacion y depuracion
+- [Lista completa de tools](overview.md)