@weppy/roblox-mcp 2.5.0 → 2.6.0

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

@@ -1,120 +0,0 @@
-# Configuración de Gemini CLI
-
-Cómo usar Roblox MCP con [Google Gemini CLI](https://github.com/google-gemini/gemini-cli).
-
-## Requisitos previos
-
-1. **Node.js** (v18.0.0 o superior)
-   ```bash
-   node --version
-   ```
-
-2. **Gemini CLI** instalado
-   ```bash
-   npm install -g @google/gemini-cli
-   ```
-
-3. **Plugin de Roblox Studio** instalado
-
-## Registrar el servidor MCP
-
-### Método 1: Comando CLI (Recomendado)
-
-Puede registrarse con un solo comando en su terminal:
-
-```bash
-gemini mcp add weppy-roblox-mcp npx --trust -- -y @weppy/roblox-mcp
-```
-
-> La bandera `--trust` omite las solicitudes de confirmación para cada llamada de herramienta.
-
-Para registrar globalmente, agregue `-s user`:
-
-```bash
-gemini mcp add weppy-roblox-mcp npx -s user --trust -- -y @weppy/roblox-mcp
-```
-
-### Método 2: Editar archivo de configuración
-
-Agregue el siguiente contenido al archivo `.gemini/settings.json`:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-**Ubicaciones del archivo de configuración:**
-| Ámbito | Ruta |
-|--------|------|
-| Proyecto | `<proyecto>/.gemini/settings.json` |
-| Global | `~/.gemini/settings.json` |
-
-### Método 3: Uso de variables de entorno
-
-Si se necesitan variables de entorno específicas:
-
-**CLI:**
-```bash
-gemini mcp add weppy-roblox-mcp npx --trust -e HTTP_PORT=3002 -- -y @weppy/roblox-mcp
-```
-
-**Archivo de configuración:**
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "env": {
-        "HTTP_PORT": "3002"
-      }
-    }
-  }
-}
-```
-
-## Prueba de conexión
-
-1. Abra **Roblox Studio** → pestaña Plugins → **WEPPY** → **Connect**
-2. Ejecute **Gemini CLI** e ingrese:
-   ```
-   Dime qué está seleccionado actualmente en Roblox Studio
-   ```
-
-## Verificar el estado del servidor MCP
-
-Puede verificar el estado de los servidores conectados con el comando `/mcp` en Gemini CLI:
-
-```
-/mcp
-```
-
-## Solución de problemas
-
-### El servidor no se inicia
-
-Ejecute el servidor MCP directamente para verificar errores:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### Conexión fallida
-
-- Verifique que el plugin de Roblox Studio esté en estado **Connected**
-- Verifique si el puerto 3002 está bloqueado por un firewall
-- Verifique el estado del servidor con el comando `/mcp`
-
-### Conflictos de herramientas
-
-Si varios servidores MCP tienen herramientas con el mismo nombre, se les agregará el prefijo con el formato `serverAlias__toolName`.
-
-## Referencias
-
-- [Documentación oficial de Gemini CLI MCP](https://geminicli.com/docs/tools/mcp-server/)
-- [Guía de configuración de Gemini CLI](https://geminicli.com/docs/get-started/configuration/)

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

@@ -1,58 +0,0 @@
-# WEPPY Roblox Explorer (Extensión VSCode)
-
-Vista de árbol de instancias similar al Explorer de Roblox Studio, dentro de VSCode. Navega instancias sincronizadas, abre scripts directamente y consulta el estado de sincronización sin salir del editor.
-Esta es una extensión complementaria para WEPPY, no una integración de Roblox independiente.
-
-![WEPPY Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
-
-## Requisitos
-
-- VSCode 1.85+
-- [Roblox MCP](../../../README.md) instalado con Sync habilitado (Basic o Pro)
-- Sync ya genero `weppy-project-sync/place_*/.sync-meta.json` dentro de la raiz del proyecto
-
-## Instalación
-
-Busca **WEPPY Roblox Explorer** en la barra lateral de Extensiones de VSCode (`Ctrl+Shift+X` / `Cmd+Shift+X`) y haz clic en **Install**.
-
-O instala directamente desde estos marketplaces:
-
-- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
-- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
-
-La navegación básica del árbol funciona con los archivos sincronizados en disco. El estado sync en vivo, los indicadores de direction y el reenvío de telemetría del Explorer están disponibles cuando el servidor MCP local es accesible.
-
-## Características
-
-- **Árbol de instancias**: Jerarquía de servicios/instancias idéntica a Roblox Studio
-- **Iconos de clases Roblox**: Más de 200 iconos con soporte de tema oscuro/claro
-- **Multi-Place**: Raíces de árbol separadas por cada Place sincronizado
-- **Abrir al hacer clic**: Abre archivos de respaldo (`.server.luau`, `.client.luau`, `.module.luau`, `.props.json`)
-- **Búsqueda de instancias**: Búsqueda QuickPick en todos los servicios
-- **Insignias de estado Sync**: Visualiza los estados `modified`, `studio`, `conflict` de un vistazo
-- **Actualización automática**: El árbol se actualiza automáticamente cuando cambian los archivos Sync (debounce 500ms)
-- **Copiar ruta de instancia**: Clic derecho para copiar rutas tipo `game.Workspace.Part`
-
-## Configuración
-
-| Configuración | Valor por defecto | Descripción |
-|---------------|-------------------|-------------|
-| `robloxExplorer.syncRoot` | `""` | Ruta absoluta a la raiz de `weppy-project-sync`. Si esta vacia, se detecta automaticamente. WEPPY usa `{projectRoot}/weppy-project-sync`. |
-| `robloxExplorer.hidePropsFiles` | `false` | Oculta los archivos de Sync (`.props.json`, `_tree.json`, `.value.json`) en el explorador predeterminado de VSCode. |
-| `robloxExplorer.autoRefresh` | `true` | Actualiza automáticamente el árbol cuando cambian los archivos Sync. |
-| `robloxExplorer.showSyncStatus` | `true` | Muestra decoraciones de estado Sync en los elementos del árbol. |
-
-## Comandos
-
-| Comando | Descripción |
-|---------|-------------|
-| `WEPPY Explorer: Refresh` | Actualizar manualmente el árbol de instancias |
-| `WEPPY Explorer: Search Instances` | Buscar instancias en todos los servicios |
-| `WEPPY Explorer: Open Backing File` | Abrir el archivo de respaldo de una instancia seleccionada |
-| `WEPPY Explorer: Copy Instance Path` | Copiar la ruta completa de la instancia (ej. `game.Workspace.Part`) |
-| `WEPPY Explorer: Reveal in Explorer` | Mostrar el archivo en el explorador predeterminado de VSCode |
-
-## Relacionado
-
-- [Guía detallada de Sync](../sync/overview.md)
-- [Guía de instalación](README.md)

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

@@ -1,85 +0,0 @@
-# Instalacion del Plugin de Roblox
-
-Instrucciones para instalar el plugin que conecta Roblox Studio con agentes de IA.
-
-## 1. Descargar el Plugin
-
-1. Abre [GitHub Releases](https://github.com/hope1026/weppy-roblox-mcp/releases/latest)
-2. Descarga `weppy-roblox-mcp-v{version}.zip`
-3. Extrae el ZIP - encontraras `roblox-plugin/WeppyRobloxMCP.rbxm` y guias de instalacion
-
-Nota:
-- Basic usa el mismo paquete del plugin con politica Basic (Studio -> Local, una via)
-- Con licencia Pro por suscripcion se habilita sync bidireccional y funciones avanzadas mas amplias
-
-## 2. Instalar el Plugin
-
-1. Abre **Roblox Studio**
-2. Clic en la pestana **Plugins**
-3. Clic en **Plugins Folder**
-
-![Abrir Plugins Folder](../../assets/screenshots/plugin/installation/plugins-menu.png)
-
-4. **Copia** `WeppyRobloxMCP.rbxm` a la carpeta abierta de Plugins
-5. **Reinicia Roblox Studio**
-
-## 3. Verificar la Instalacion
-
-Despues de reiniciar, aparecera el boton **WEPPY** en Plugins.
-
-![Boton WEPPY](../../assets/screenshots/plugin/installation/toolbar-button.png)
-
-## 4. Conectar con el Agente de IA
-
-### Requisitos Previos
-
-El servidor MCP debe estar instalado. Completa primero la guia de tu app de IA:
-
-| Aplicacion IA | Guia de instalacion |
-|---------------|---------------------|
-| Claude Code | [Como configurar](ai-apps/claude-code.md) |
-| Claude Desktop | [Como configurar](ai-apps/claude-app.md) |
-| Cursor | [Como configurar](ai-apps/cursor.md) |
-| Codex CLI | [Como configurar](ai-apps/codex-cli.md) |
-| Codex Desktop | [Como configurar](ai-apps/codex-app.md) |
-| Gemini CLI | [Como configurar](ai-apps/gemini-cli.md) |
-| Antigravity | [Como configurar](ai-apps/antigravity.md) |
-
-### Conectar
-
-1. Abre cualquier proyecto en **Roblox Studio**
-2. Pestaña **Plugins** -> **WEPPY**
-3. Clic en **Connect**
-4. Cuando veas **"Connected"**, listo
-
-![Pantalla principal del plugin](../../assets/screenshots/plugin/installation/main-screen.png)
-
-## 5. Configuracion (Opcional)
-
-Usa el boton de configuracion en la esquina superior derecha.
-
-![Pantalla de configuracion](../../assets/screenshots/plugin/installation/settings-screen.png)
-
-- **Conexion automatica**
-- **Reconexion automatica**
-- **Enfoque automatico de camara**
-- **Idioma**
-
-## Solucion de Problemas
-
-### El plugin no aparece
-
-- Reinicia Roblox Studio por completo
-- Verifica que el archivo fue copiado correctamente
-- Verifica que `.rbxm` no este dañado
-
-### No se puede conectar
-
-- Verifica que el servidor MCP esta en ejecucion
-- Pulsa **Connect** otra vez
-- Verifica conflicto en el puerto 3002
-
-### La conexion se corta seguido
-
-- Activa **Reconexion automatica**
-- Reinicia tu app de IA

package/docs/es/pro-upgrade.md

@@ -1,96 +0,0 @@
-# Guia de Actualizacion a Pro
-
-## ¿Por qué Pro?
-
-### Sync bidireccional para flujos de desarrollo reales
-
-Pro Sync va más allá del simple export. Edita scripts localmente y súbelos a Studio. Haz cambios en Studio y tráelos de vuelta al disco. Pro mantiene ambos lados sincronizados.
-
-- **Sync bidireccional** — Los cambios fluyen en ambas direcciones entre Studio y los archivos locales.
-- **Direction por tipo** — Configura la dirección de forma independiente para Scripts, Values, Containers, Data y Services.
-- **Apply Mode por tipo** — Elige Auto o Manual por tipo para equilibrar velocidad y control.
-- **Full Sync / Resync** — Reconstruye el estado limpio del proyecto tras cambios grandes o reconexiones.
-- **Historial de cambios** — Rastrea qué cambió, cuándo y en qué dirección antes de aplicar.
-- **Sync multi-place** — Sincroniza hasta 3 Roblox Places a la vez, cada uno con almacenamiento aislado e historial de cambios propio.
-
-### Ahorra tokens de IA con flujos de alto impacto
-
-Las acciones masivas y avanzadas reducen las llamadas repetitivas — haz más por cada prompt.
-
-### IA que controla los playtests directamente
-
-La IA puede controlar los playtests de Roblox Studio de forma directa. Puede iniciar y detener Play (F5) o Run (F8), inyectar scripts de prueba, recopilar logs y generar reportes automáticamente.
-
-- "Inicia un playtest en modo Run y verifica si el NPC llega al objetivo."
-- "Escribe un test que compruebe si el SpawnLocation está sobre el suelo y ejecútalo."
-- "Valida que el script que acabo de cambiar funciona sin errores en el playtest."
-
-### Más funciones exclusivas de Pro
-
-Pro desbloquea funciones adicionales más allá del flujo de trabajo principal.
-
-- **Operaciones masivas** — Crear, modificar o eliminar múltiples instancias en una sola solicitud
-- **Generación de terreno** — Rellenar con bloque, esfera, cilindro, cuña y reemplazar materiales
-- **Búsqueda/inserción de assets** — Buscar en el marketplace de Roblox e insertar assets directamente
-- **Análisis espacial** — Raycast, encontrar suelo, búsqueda de área plana, detección de colisiones
-- **Control de entorno** — Iluminación, atmósfera, cielo y hora del día
-- **Audio/Animación** — Reproducción de sonido y carga/reproducción de animaciones
-
-## Compra y activación
-
-### Paso 1: Compra una licencia de suscripción Pro en Gumroad
-
-1. Ve a [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/faccjs?utm_source=github&utm_medium=repo&utm_campaign=pro_upgrade_md)
-2. Completa la compra de la licencia de suscripción Pro
-3. Copia la clave de licencia que recibes después de la compra
-
-Solo necesitas activar la licencia una vez, ya sea en el plugin o en el dashboard. Ambas superficies comparten el mismo estado local de licencia del MCP, así que al activarla en un lugar, el mismo estado aparecerá en el otro.
-
-### Activar en el plugin
-
-1. Abre **WEPPY** en Roblox Studio y conéctalo al servidor MCP.
-2. Abre la sección **Settings > License** del plugin.
-3. Pega la clave comprada en el campo `License key`.
-4. Haz clic en **Activate** para activar la licencia.
-5. Si el estado no se actualiza de inmediato, haz clic en **Refresh**.
-6. Cuando la activación se complete, el estado cambiará de Basic a Pro y las funciones Pro quedarán disponibles.
-
-![Pantalla de activación de licencia en el plugin](../assets/screenshots/plugin/license/plugin-license-screen.png)
-
-### Activar en el dashboard
-
-1. Inicia el servidor MCP y abre **Settings > License** en el dashboard.
-2. Confirma que el proveedor esté configurado como `gumroad`.
-3. Pega la clave comprada en el campo `License Key`.
-4. Haz clic en **Activate License** para activar la licencia.
-5. Si hace falta, usa **Refresh License** para obtener el estado más reciente.
-
-![Pantalla de activación de licencia en el dashboard](../assets/screenshots/plugin/license/dashboard-license-screen.png)
-
-### Después de activar
-
-- Si el estado de la licencia aparece como `active` o `grace`, las funciones Pro ya están disponibles.
-- El plugin y el dashboard comparten el mismo estado de licencia, así que la activación hecha en uno se refleja en el otro.
-- Usa **Refresh** o **Refresh License** cuando quieras volver a comprobar el estado más reciente.
-
-## Comparación de Funciones
-
-| Función | Basic | Pro |
-|---------|:-----:|:---:|
-| Creación/edición de scripts | ✅ | ✅ |
-| Crear/eliminar/mover instancias | ✅ | ✅ + operaciones masivas |
-| Leer/modificar propiedades | ✅ | ✅ + cambios masivos |
-| Selección, tags, búsqueda | ✅ | ✅ |
-| Control de cámara | ✅ | ✅ |
-| Monitoreo de logs | ✅ | ✅ |
-| Ejecución de código Luau | ✅ | ✅ |
-| Sincronización de proyecto | Studio → Local una vía | Bidireccional + dirección/modo por tipo |
-| Sync multi-place | — | Hasta 3 Places simultáneamente |
-| Historial de cambios | — | Rastreo de cambios antes de aplicar |
-| Control de playtest | — | Reproducir / detener / pausar / reanudar + tests automáticos |
-| Generación/edición de terreno | — | Bloque, esfera, cilindro, cuña, reemplazo de material |
-| Búsqueda/inserción de assets | — | Buscar en marketplace de Roblox e insertar directamente |
-| Análisis espacial | — | Raycast, encontrar suelo, detección de colisiones |
-| Control de entorno | — | Iluminación, atmósfera, cielo, hora del día |
-| Audio / Animación | — | Reproducción de sonido, carga/reproducción de animaciones |
-| Eficiencia de tokens IA | Acciones individuales | Menos llamadas con acciones masivas |

package/docs/es/sync/luau-lsp.md

@@ -1,41 +0,0 @@
-# Usar `luau-lsp` con WEPPY Sync
-
-WEPPY Sync puede generar automaticamente los archivos sourcemap que necesita `luau-lsp`, para que puedas activar funciones de editor con contexto de Roblox sin preparar un proyecto Rojo aparte.
-
-## Que escribe WEPPY
-
-Despues de que termina Full Sync, WEPPY escribe:
-
-- Place sourcemap: `weppy-project-sync/place_<id>/sourcemap.json`
-- Archivo representante en la raiz: `weppy-project-sync/sourcemap.json`
-
-Para la mayoria de usuarios, la ruta recomendada es `weppy-project-sync/sourcemap.json`.
-
-## Que mejora
-
-Cuando `luau-lsp` usa el sourcemap de WEPPY, mejora:
-
-- Autocomplete de `game.*`
-- Navegacion entre scripts sincronizados
-- Resolucion de `require` entre scripts sincronizados
-
-## Configuracion recomendada
-
-1. Ejecuta Full Sync una vez para que WEPPY cree `weppy-project-sync/sourcemap.json`.
-2. Haz que la configuracion de sourcemap de `luau-lsp` en tu editor apunte a `weppy-project-sync/sourcemap.json`.
-3. Si tu cliente puede desactivar la generacion automatica con Rojo, establece `luau-lsp.sourcemap.autogenerate` en `false`.
-
-Ejemplo de configuracion en VSCode:
-
-```json
-{
-  "luau-lsp.sourcemap.enabled": true,
-  "luau-lsp.sourcemap.autogenerate": false,
-  "luau-lsp.sourcemap.sourcemapFile": "weppy-project-sync/sourcemap.json"
-}
-```
-
-## Nota sobre Multi-place
-
-`weppy-project-sync/sourcemap.json` sigue el place representante actual del proyecto.
-Si necesitas fijarlo a un place especifico, apunta `luau-lsp` directamente a `weppy-project-sync/place_<id>/sourcemap.json`.

package/docs/es/sync/overview.md

@@ -1,153 +0,0 @@
-# Guia detallada de Sync en Roblox MCP
-
-Sync conecta el estado de Roblox Studio con archivos locales para que la IA pueda leer y modificar el contexto completo del proyecto de forma confiable.
-
-## Por que Sync es importante
-
-Sin Sync, la IA solo ve fragmentos pegados en el chat. Con Sync activo, trabaja sobre todo el proyecto.
-
-- Aplicar refactors de forma consistente en multiples scripts
-- Revisar cambios riesgosos rapidamente usando historial
-- Mantener clara la fuente de verdad entre Studio y archivos locales
-
-## Como funciona
-
-![Flujo de Sync — arbol de Studio reflejado en archivos locales](../../assets/screenshots/plugin/sync/sync-overview.png)
-
-1. Full Sync: espejo inicial del arbol/instancias de Studio a local
-2. Incremental Sync: reflejo continuo de cambios nuevos
-3. Seguimiento de History/Status: ver que cambio, cuando y en que direccion
-
-Los datos de Sync se guardan en `{projectRoot}/weppy-project-sync/place_{placeId}/explorer`.
-Ademas, WEPPY escribe un sourcemap por place en `{projectRoot}/weppy-project-sync/place_{placeId}/sourcemap.json` y mantiene el archivo representante recomendado en la raiz en `{projectRoot}/weppy-project-sync/sourcemap.json`.
-Para integraciones de editor como `luau-lsp`, se recomienda usar la ruta de la raiz. Los pasos de configuracion estan en [Usar `luau-lsp` con WEPPY Sync](./luau-lsp.md).
-
-### Explorar datos sincronizados en VSCode
-
-Instala la extension [WEPPY Roblox Explorer](../installation/roblox-explorer.md) para explorar el arbol de instancias sincronizado en VSCode, igual que en Roblox Studio.
-Explorer lee los archivos sync generados aqui, y puede mostrar ademas estado sync en vivo e informacion de direction cuando el servidor MCP local esta en ejecucion.
-
-![WEPPY Roblox Explorer — explorar el arbol de instancias sincronizado en VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
-
-- Arbol de servicios/instancias con iconos de clases Roblox
-- Haz clic en un script para abrirlo y editarlo
-- Badges de estado de sync muestran el estado modificado/conflicto
-
-## Basic vs Pro
-
-| Item | Basic | Pro |
-|------|------|-----|
-| Direccion de sync | Studio -> Local | Bidireccional |
-| Direction por tipo | No soportado | Soportado (Scripts / Values / Containers / Data / Services) |
-| Apply Mode por tipo | No soportado | Soportado (Auto / Manual) |
-| APIs de estado/historial | No soportado | Soportado (`status_current_place`, `history`, `progress`) |
-| Herramienta `manage_sync` | No soportado | Soportado |
-| Sync multiplace | No soportado | Soportado (hasta 3 places) |
-
-## Objetivos de sync y exclusiones por defecto
-
-Servicios sincronizables por defecto:
-
-- `Workspace`
-- `Lighting`
-- `ReplicatedStorage`
-- `ServerStorage`
-- `ServerScriptService`
-- `StarterGui`
-- `StarterPlayer`
-- `StarterPack`
-- `ReplicatedFirst`
-- `SoundService`
-- `Chat`
-- `LocalizationService`
-
-Exclusiones por defecto:
-
-- Clases: `Terrain`, `Camera`
-- Rutas restringidas por seguridad: `CoreGui`, `CorePackages`, `RobloxScript`, `RobloxScriptSecurity`
-
-## Direction y Apply Mode
-
-### Direction (direccion por tipo)
-
-- `forward`: Studio -> Local
-- `reverse`: Local -> Studio
-- `bidirectional`: ambas direcciones
-
-Los tipos se gestionan por separado: `scripts`, `values`, `containers`, `data`, `services`.
-
-### Apply Mode (como se aplican cambios reverse)
-
-- `manual`: el usuario confirma antes de aplicar a Studio
-- `auto`: los cambios detectados se aplican automaticamente
-
-En Pro puedes controlar Direction y Apply Mode por tipo.
-
-## Guia de acciones `manage_sync` (Pro)
-
-| Accion | Descripcion | Parametros clave |
-|------|------|-----------|
-| `status_current_place` | Consultar el estado actual de sync del place conectado | `-` |
-| `history` | Consultar historial de cambios | `placeId`, `query.limit`, `query.offset` |
-| `directions` | Obtener direcciones por tipo | `placeId` |
-| `read_file` | Leer archivo sincronizado | `placeId`, `instancePath` |
-| `write_file` | Escribir archivo sincronizado | `placeId`, `instancePath`, `content` |
-| `progress` | Obtener progreso/throughput en tiempo real | `placeId` |
-
-## Flujo recomendado
-
-### 1) Empezar con seguridad
-
-- Completa Full Sync primero para establecer una base estable
-- Empieza con modo `manual` para reducir riesgo
-
-### 2) Trabajar con IA
-
-- "Revisa el estado de sync y resume solo cambios riesgosos del historial reciente"
-- "Refactoriza primero scripts de `ServerScriptService` y deja registro en historial"
-
-### 3) Resolver conflictos
-
-Cuando se detectan cambios tanto en Studio como en local durante la sincronizacion bidireccional, aparece un dialogo de resolucion de conflictos.
-
-![Local Changes Detected — opciones de resolucion de conflictos (Studio Priority / Local Priority / Per-File)](../../assets/screenshots/plugin/sync/sync-conflict.png)
-
-- **Studio Priority**: sobrescribir usando el estado de Studio como fuente de verdad
-- **Local Priority**: aplicar los archivos locales a Studio
-- **Per-File**: elegir que lado tiene prioridad para cada archivo individualmente
-
-### 4) Recuperar cuando sea necesario
-
-- Sigue cambios recientes con `history`
-- Inspecciona archivo objetivo con `read_file`
-- Restaura contenido con `write_file` y verifica en Studio
-
-## Formato de archivos (v2 nested directory)
-
-Cada instancia de Roblox se almacena como su propio directorio con archivos meta dentro:
-
-```
-explorer/
-├── Workspace/
-│   ├── _tree.json
-│   ├── Part/
-│   │   └── Part.props.json
-│   ├── MyScript/
-│   │   └── MyScript.server.luau
-│   └── Coins/
-│       └── Coins.value.json
-```
-
-Convenciones de nombres:
-- Propiedades: `{Name}/{Name}.props.json`
-- Scripts: `{Name}/{Name}.server.luau` / `.client.luau` / `.module.luau`
-- Valores: `{Name}/{Name}.value.json`
-
-Las instancias con nombre duplicado usan el sufijo `~N` en el directorio (ej. `Part~2/Part.props.json`).
-Los nombres que contienen `~` se escapan como `~~` (ej. `Part~2` → `Part~~2/`). Regla Odd-Count Tilde: un `~+N` final se interpreta como sufijo de colisión solo cuando la cantidad de tildes es impar.
-
-## Documentos relacionados
-
-- [Usar `luau-lsp` con WEPPY Sync](./luau-lsp.md)
-- [Cobertura de herramientas (Tools Overview)](../tools/overview.md)
-- [Guia de upgrade Pro](https://weppyai.com/en/plans)

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

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