@weppy/roblox-mcp 2.0.0 → 2.0.2

package/README.md

@@ -16,7 +16,25 @@ AI coding agents like Claude, Codex, and Gemini are powerful — but they cannot
 
 This is not just code generation. It is **executable, production-oriented actions** running directly in Studio.
 
-## Quick Install (5 minutes)
+## Quick Install
+
+**One-line install** — installs the MCP server, Roblox Studio plugin, and registers with your AI apps:
+
+```bash
+# macOS / Linux
+curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+
+# Windows (PowerShell)
+irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
+```
+
+Then restart Roblox Studio — done!
+
+If PowerShell execution is blocked on Windows, use the manual install path below. If you're using the ZIP package, you can also use `setup-plugin.bat` and `setup-mcp.bat`.
+
+### Manual Install
+
+If the one-line install does not work, or automatic installation is not available in your environment, use the manual install path below.
 
 **Step 1** — Install the Roblox Studio plugin (bridge between Studio and AI):
 [Plugin Installation Guide](docs/en/installation/roblox-plugin.md)
@@ -31,6 +49,7 @@ npx -y @weppy/roblox-mcp
 |--------|-------|
 | Claude Code | [Setup](docs/en/installation/ai-apps/claude-code.md) |
 | Claude Desktop | [Setup](docs/en/installation/ai-apps/claude-app.md) |
+| Cursor | [Setup](docs/en/installation/ai-apps/cursor.md) |
 | Codex CLI | [Setup](docs/en/installation/ai-apps/codex-cli.md) |
 | Codex Desktop | [Setup](docs/en/installation/ai-apps/codex-app.md) |
 | Gemini CLI | [Setup](docs/en/installation/ai-apps/gemini-cli.md) |
@@ -138,7 +157,7 @@ Install the Roblox Studio plugin, then register the MCP server (`npx -y @weppy/r
 Install the plugin, then add the MCP server config to Codex CLI. See [Codex CLI Setup](docs/en/installation/ai-apps/codex-cli.md).
 
 ### Does Roblox MCP work with Cursor?
-Yes. Any MCP-compatible AI client works. Setup guides are provided for Claude Code, Claude Desktop, Cursor, Codex CLI, Codex Desktop, Gemini CLI, and Antigravity.
+Yes. See [Cursor Setup](docs/en/installation/ai-apps/cursor.md). Any MCP-compatible AI client works.
 
 ### Can AI build Roblox games with this?
 Yes. AI can create instances, write scripts, generate terrain, set up lighting, insert assets, configure physics, and more — all inside a live Roblox Studio session. It goes beyond code generation to executable actions.
@@ -158,8 +177,18 @@ Bidirectional Sync, advanced build capabilities, and AI token efficiency — all
 
 [Pro Upgrade Guide](docs/en/pro-upgrade.md)
 
+## License
+
+This repository is licensed under `AGPL-3.0`.
+
+Commercial licensing is available separately. See [COMMERCIAL-LICENSE.md](COMMERCIAL-LICENSE.md).
+
+Use of the Weppy name and logos is governed by [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/TRADEMARKS.md

@@ -0,0 +1,18 @@
+# Trademarks
+
+`Weppy`, `Weppy Roblox MCP`, and related logos, product names, and branding are trademarks or brand identifiers of the maintainer.
+
+The open-source software license for this repository does not grant trademark rights.
+
+You may:
+
+- Use the project name to make factual, nominative references to this project
+- State that your software is compatible with or derived from this project
+
+You may not:
+
+- Use the Weppy name or branding in a way that suggests endorsement, affiliation, or official status
+- Redistribute modified versions under the same branding in a way that could confuse users about origin
+
+If you publish a fork or modified distribution, use distinct branding unless you have separate written permission.
+

package/docs/assets/screenshots/license/license-dashboard.png

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:07a0681c478cfdec10824a9be8a65f7b49fda140f863fe6a3b22fdee0b440785
+size 81021

package/docs/assets/screenshots/license/license-plugin.png

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:12777be7978ec36ebfcb8ae68b5342442bf6f419e6b8c9e67c39ff2d1a7febe1
+size 19948

package/docs/compatibility.md

@@ -6,7 +6,7 @@
 |--------|:-----:|:---:|-------------|
 | Claude Code | ✅ | ✅ | [Guide](en/installation/ai-apps/claude-code.md) |
 | Claude Desktop | ✅ | ✅ | [Guide](en/installation/ai-apps/claude-app.md) |
-| Cursor | ✅ | ✅ | MCP config: `npx -y @weppy/roblox-mcp` |
+| Cursor | ✅ | ✅ | [Guide](en/installation/ai-apps/cursor.md) |
 | Codex CLI | ✅ | ✅ | [Guide](en/installation/ai-apps/codex-cli.md) |
 | Codex Desktop | ✅ | ✅ | [Guide](en/installation/ai-apps/codex-app.md) |
 | Gemini CLI | ✅ | ✅ | [Guide](en/installation/ai-apps/gemini-cli.md) |

package/docs/en/installation/README.md

@@ -14,7 +14,29 @@ When an AI app says "Create a blue part", the MCP server converts this request,
 
 ---
 
-## Step 1: Install Roblox Studio Plugin
+## One-Line Install (Recommended)
+
+Installs the MCP server, Roblox Studio plugin, and registers with your AI apps in one step:
+
+```bash
+# macOS / Linux
+curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+
+# Windows (PowerShell)
+irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
+```
+
+Then restart Roblox Studio — done!
+
+If PowerShell execution is blocked on Windows, use the manual install path below. If you're using the ZIP package, you can also run `setup-plugin.bat` and `setup-mcp.bat`.
+
+---
+
+## Manual Install
+
+If the one-line install does not work, or automatic installation is not available in your environment, use the manual install path below as an alternative.
+
+### Step 1: Install Roblox Studio Plugin
 
 Download the plugin file from GitHub, then place it in Roblox Studio's Plugins folder.
 
@@ -22,7 +44,7 @@ Download the plugin file from GitHub, then place it in Roblox Studio's Plugins f
 
 ---
 
-## Step 2: Register MCP Server with AI App
+### Step 2: Register MCP Server with AI App
 
 Register the MCP server with your AI app. You can use it with any AI app that supports MCP.
 
@@ -30,6 +52,7 @@ Register the MCP server with your AI app. You can use it with any AI app that su
 |--------|-------------------|
 | Claude Code | [Setup Instructions](ai-apps/claude-code.md) |
 | Claude Desktop | [Setup Instructions](ai-apps/claude-app.md) |
+| Cursor | [Setup Instructions](ai-apps/cursor.md) |
 | Codex CLI | [Setup Instructions](ai-apps/codex-cli.md) |
 | Codex Desktop | [Setup Instructions](ai-apps/codex-app.md) |
 | Gemini CLI | [Setup Instructions](ai-apps/gemini-cli.md) |

package/docs/en/installation/ai-apps/cursor.md

@@ -0,0 +1,77 @@
+# Cursor Setup
+
+How to use Roblox MCP with [Cursor](https://cursor.com/).
+
+## Prerequisites
+
+- **Cursor** installed
+- **Node.js** (v18.0.0 or higher)
+- **Roblox Studio Plugin** installed
+
+## Register MCP Server
+
+### Method 1: Project Configuration
+
+Add the following to `.cursor/mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "weppy-roblox-mcp": {
+      "command": "npx",
+      "args": ["-y", "@weppy/roblox-mcp"]
+    }
+  }
+}
+```
+
+### Method 2: Global Configuration
+
+Add the same content to your global Cursor MCP config file.
+
+**Configuration file locations:**
+
+| Scope | Path |
+|-------|------|
+| Project | `<project>/.cursor/mcp.json` |
+| Global (macOS/Linux) | `~/.cursor/mcp.json` |
+| Global (Windows) | `%USERPROFILE%\\.cursor\\mcp.json` |
+
+> If the file already exists, merge the `weppy-roblox-mcp` entry into the existing `mcpServers` object.
+
+### Apply Changes
+
+After editing the config, reload the Cursor window or restart the app.
+
+## Connection Test
+
+1. Open **Roblox Studio** → Plugins tab → **W-MCP** → **Connect**
+2. In **Cursor**, enter:
+   ```
+   Tell me what's currently selected in Roblox Studio
+   ```
+
+## Troubleshooting
+
+### MCP server not showing up
+
+- Check that the config file path is correct
+- Verify the JSON syntax is valid
+- Reload Cursor after editing the config
+
+### Server won't start
+
+Run the MCP server directly to check for errors:
+
+```bash
+npx -y @weppy/roblox-mcp
+```
+
+### Connection failed
+
+- Verify the Roblox Studio plugin is in **Connected** state
+- Check if port 3002 is blocked by a firewall
+
+## Reference
+
+- [Cursor MCP Documentation](https://docs.cursor.com/context/model-context-protocol)

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

@@ -11,11 +11,11 @@ Roblox Studio Explorer-like tree view for VSCode. Browse synced instance trees,
 
 ## Installation
 
-### 1. Download VSIX
+### 1. Download Release Package
 
-Go to the [Releases](https://github.com/hope1026/weppy-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-v*.zip` file.
 
-> The VSIX file is attached as a release asset alongside the plugin ZIP.
+> The ZIP package contains the `weppy-roblox-explorer-*.vsix` file you will install in VSCode.
 
 ### 2. Install in VSCode
 
@@ -25,7 +25,7 @@ Go to the [Releases](https://github.com/hope1026/weppy-roblox-mcp/releases) page
 
 ![Install from VSIX](../../assets/screenshots/roblox-explorer/install-from-vsix.png)
 
-4. Select the downloaded `.vsix` file
+4. Extract the ZIP package and select the included `.vsix` file
 5. Reload VSCode when prompted
 
 ## Features
@@ -60,7 +60,7 @@ Go to the [Releases](https://github.com/hope1026/weppy-roblox-mcp/releases) page
 
 ## Updating
 
-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.
+Download the latest `weppy-roblox-explorer-v*.zip` from [Releases](https://github.com/hope1026/weppy-roblox-mcp/releases), extract the `.vsix`, and repeat the installation steps. VSCode will replace the existing version.
 
 ## Related
 

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

@@ -39,6 +39,7 @@ The MCP server must be installed. Complete the guide for your AI app first:
 |--------|-------------------|
 | Claude Code | [Setup Guide](ai-apps/claude-code.md) |
 | Claude Desktop | [Setup Guide](ai-apps/claude-app.md) |
+| Cursor | [Setup Guide](ai-apps/cursor.md) |
 | Codex CLI | [Setup Guide](ai-apps/codex-cli.md) |
 | Codex Desktop | [Setup Guide](ai-apps/codex-app.md) |
 | Gemini CLI | [Setup Guide](ai-apps/gemini-cli.md) |

package/docs/en/pro-upgrade.md

@@ -17,28 +17,54 @@ Pro Sync goes beyond one-way export. Edit scripts locally and push them to Studi
 
 Bulk and advanced actions reduce repetitive round trips — do more per prompt.
 
+### Let AI run and verify playtests directly
+
+AI can control Roblox Studio playtests directly. It can start and stop Play (F5) or Run (F8), inject test scripts, collect logs, and generate local reports automatically.
+
+- "Start a Run-mode playtest and check whether the NPC reaches the target."
+- "Write a test that verifies the SpawnLocation is above the ground and run it."
+- "Validate that the script I just changed runs without errors in playtest."
+
 ### Broader advanced capabilities
 
 Terrain generation, asset search, spatial analysis, animation, audio, and production-scale automation.
 
-## Subscription & Download
+## Buy and Activate
 
-### Step 1: Subscribe on Gumroad
+### Step 1: Buy a Pro subscription license on Gumroad
 
 1. Go to [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/faccjs?utm_source=github&utm_medium=repo&utm_campaign=pro_upgrade_md)
 2. Complete your Pro subscription license purchase
+3. Copy the license key you receive after purchase
+
+You only need to activate the license once, either in the plugin or in the dashboard. Both surfaces share the same MCP local license state, so once you activate in one place, the same status appears in the other.
+
+### Activate in the plugin
+
+1. Open **W-MCP** in Roblox Studio and connect to the MCP server.
+2. Open **Settings > License** in the plugin.
+3. Paste your purchased key into the `License key` field.
+4. Click **Activate** to activate the license.
+5. If the status does not update immediately, click **Refresh**.
+6. When activation succeeds, the status changes from Basic to Pro and Pro features become available.
+
+![Plugin license activation screen](../assets/screenshots/license/license-plugin.png)
+
+### Activate in the dashboard
 
-### Step 2: Download from GitHub Releases
+1. Start the MCP server, then open **Settings > License** in the dashboard.
+2. Confirm that the provider is set to `gumroad`.
+3. Paste your purchased key into the `License Key` field.
+4. Click **Activate License** to activate the license.
+5. If needed, use **Refresh License** to fetch the latest status.
 
-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
+![Dashboard license activation screen](../assets/screenshots/license/license-dashboard.png)
 
-### Step 3: Verify
+### After activation
 
-1. Open W-MCP in Roblox Studio
-2. Confirm the Pro badge is visible
-3. Run a Pro action (for example: `manage_sync` or bulk operations)
+- If the license status is shown as `active` or `grace`, Pro features are available.
+- The plugin and dashboard share the same license state, so activating in one place is reflected in the other.
+- Use **Refresh** or **Refresh License** whenever you want to check the latest status again.
 
 ## Feature Comparison
 
@@ -49,8 +75,6 @@ Terrain generation, asset search, spatial analysis, animation, audio, and produc
 | Sync Direction | Studio → Local (one-way) | Bidirectional |
 | Per-type Sync Direction | ❌ | ✅ Scripts / Values / Containers / Data / Services |
 | Per-type Apply Mode | ❌ | ✅ Auto / Manual |
-| Full Sync | ❌ | ✅ |
-| Resync / Rebuild state | ❌ | ✅ |
 | Change History | ❌ | ✅ |
 | Multi-place Sync | ❌ | ✅ Up to 3 places, each with isolated storage |
 | Playtest Control (Play/Stop/Pause/Resume) | ❌ | ✅ |

package/docs/es/README.md

@@ -8,10 +8,28 @@
 
 [![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)
+## Instalacion rapida
+
+**Instalacion en un solo comando** — Instala el servidor MCP, el plugin de Roblox Studio y registra tus apps de IA en un solo paso:
+
+```bash
+# macOS / Linux
+curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+
+# Windows (PowerShell)
+irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
+```
+
+¡Reinicia Roblox Studio y listo!
+
+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 instalación en un solo comando no funciona, o si no puedes usar la instalación automática en tu entorno, usa la instalación manual de abajo como alternativa.
 
 **Paso 1** — Instala el plugin de Roblox Studio (puente entre Studio e IA):
-[Guia de instalacion del plugin](../en/installation/roblox-plugin.md)
+[Guia de instalacion del plugin](installation/roblox-plugin.md)
 
 **Paso 2** — Registra el servidor MCP en tu app de IA:
 
@@ -21,11 +39,12 @@ npx -y @weppy/roblox-mcp
 
 | App de IA | Guia |
 |-----------|------|
-| Claude Code | [Configuracion](../en/installation/ai-apps/claude-code.md) |
-| Claude Desktop | [Configuracion](../en/installation/ai-apps/claude-app.md) |
-| Codex CLI | [Configuracion](../en/installation/ai-apps/codex-cli.md) |
-| Codex Desktop | [Configuracion](../en/installation/ai-apps/codex-app.md) |
-| Gemini CLI | [Configuracion](../en/installation/ai-apps/gemini-cli.md) |
+| 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) |
 
 > Funciona con cualquier cliente MCP compatible. El comando del servidor es `npx -y @weppy/roblox-mcp`.
 
@@ -95,11 +114,11 @@ Visualiza el arbol completo de instancias de tu lugar en Roblox Studio directame
 
 ## Documentacion detallada
 
-- [Guia de instalacion](../en/installation/README.md)
+- [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)
-- [Roblox Explorer (Extension VSCode)](../en/installation/roblox-explorer.md)
+- [Roblox Explorer (Extension VSCode)](installation/roblox-explorer.md)
 - [Compatibilidad](../compatibility.md)
 - [Solucion de problemas](../troubleshooting.md)
 
@@ -116,7 +135,7 @@ Visualiza el arbol completo de instancias de tu lugar en Roblox Studio directame
 
 Sync bidireccional, capacidades de creacion avanzadas y eficiencia de tokens de IA — todo en una sola actualizacion.
 
-[Guia de actualizacion Pro](../en/pro-upgrade.md)
+[Guia de actualizacion Pro](pro-upgrade.md)
 
 ---
 

package/docs/es/installation/README.md

@@ -10,13 +10,35 @@ App de IA (Claude, etc.)
 Plugin de Roblox Studio
 ```
 
-## Paso 1: Instalar el Plugin de Roblox Studio
+## Instalación en un solo comando (Recomendado)
+
+Instala el servidor MCP, el plugin de Roblox Studio y registra tus apps de IA en un solo paso:
+
+```bash
+# macOS / Linux
+curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+
+# Windows (PowerShell)
+irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
+```
+
+¡Reinicia Roblox Studio y listo!
+
+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 ejecutar `setup-plugin.bat` y `setup-mcp.bat`.
+
+---
+
+## Instalación manual
+
+Este es el método alternativo cuando la instalación en un solo comando no funciona, o cuando no puedes usar la instalación automática en tu entorno.
+
+### Paso 1: Instalar el Plugin de Roblox Studio
 
 El plugin conecta Roblox Studio con la IA.
 
 👉 [Guía de instalación del plugin](roblox-plugin.md)
 
-## Paso 2: Registrar el Servidor MCP en tu App de IA
+### Paso 2: Registrar el Servidor MCP en tu App de IA
 
 Configura el servidor MCP en tu app de IA para que pueda comunicarse con Roblox Studio.
 
@@ -24,6 +46,7 @@ Configura el servidor MCP en tu app de IA para que pueda comunicarse con Roblox
 |-----------|----------------|
 | **Claude Code** | [Instrucciones](ai-apps/claude-code.md) |
 | **Claude Desktop** | [Instrucciones](ai-apps/claude-app.md) |
+| **Cursor** | [Instrucciones](ai-apps/cursor.md) |
 | **Codex CLI** | [Instrucciones](ai-apps/codex-cli.md) |
 | **Codex Desktop** | [Instrucciones](ai-apps/codex-app.md) |
 | **Gemini CLI** | [Instrucciones](ai-apps/gemini-cli.md) |

package/docs/es/installation/ai-apps/cursor.md

@@ -0,0 +1,77 @@
+# Configuración de Cursor
+
+Cómo usar Roblox MCP con [Cursor](https://cursor.com/).
+
+## Requisitos previos
+
+- **Cursor** instalado
+- **Node.js** (v18.0.0 o superior)
+- **Plugin de Roblox Studio** instalado
+
+## Registrar el servidor MCP
+
+### Método 1: Configuración del proyecto
+
+Agrega lo siguiente a `.cursor/mcp.json` dentro de tu proyecto:
+
+```json
+{
+  "mcpServers": {
+    "weppy-roblox-mcp": {
+      "command": "npx",
+      "args": ["-y", "@weppy/roblox-mcp"]
+    }
+  }
+}
+```
+
+### Método 2: Configuración global
+
+Agrega el mismo contenido al archivo de configuración global de Cursor.
+
+**Ubicaciones del archivo de configuración:**
+
+| Alcance | Ruta |
+|---------|------|
+| Proyecto | `<proyecto>/.cursor/mcp.json` |
+| Global (macOS/Linux) | `~/.cursor/mcp.json` |
+| Global (Windows) | `%USERPROFILE%\\.cursor\\mcp.json` |
+
+> Si el archivo ya existe, fusiona la entrada `weppy-roblox-mcp` dentro del objeto `mcpServers`.
+
+### Aplicar cambios
+
+Después de editar la configuración, recarga la ventana de Cursor o reinicia la aplicación.
+
+## Prueba de conexión
+
+1. Abre **Roblox Studio** → pestaña Plugins → **W-MCP** → **Connect**
+2. En **Cursor**, escribe:
+   ```
+   Tell me what's currently selected in Roblox Studio
+   ```
+
+## Solución de problemas
+
+### El servidor MCP no aparece
+
+- Verifica que la ruta del archivo de configuración sea correcta
+- Comprueba que la sintaxis JSON sea válida
+- Recarga Cursor después de editar la configuración
+
+### El servidor no inicia
+
+Ejecuta el servidor MCP directamente para revisar errores:
+
+```bash
+npx -y @weppy/roblox-mcp
+```
+
+### La conexión falla
+
+- Verifica que el plugin de Roblox Studio esté en estado **Connected**
+- Revisa si el puerto 3002 está bloqueado por el firewall
+
+## Referencia
+
+- [Documentación de Cursor MCP](https://docs.cursor.com/context/model-context-protocol)

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

@@ -39,6 +39,7 @@ El servidor MCP debe estar instalado. Completa primero la guia de tu app de IA:
 |---------------|---------------------|
 | 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) |

package/docs/es/pro-upgrade.md

@@ -17,28 +17,54 @@ Pro Sync va más allá del simple export. Edita scripts localmente y súbelos a
 
 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."
+
 ### Capacidades avanzadas más amplias
 
 Generación de terreno, búsqueda de assets, análisis espacial, animación, audio y automatización a escala de producción.
 
-## Suscripcion y descarga
+## Compra y activación
 
-### Paso 1: Suscribirte en Gumroad
+### 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 licencia Pro por suscripcion
+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 **W-MCP** 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/license/license-plugin.png)
+
+### Activar en el dashboard
 
-### Paso 2: Descargar desde GitHub Releases
+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.
 
-1. Abre [GitHub Releases](https://github.com/hope1026/weppy-roblox-mcp/releases/latest)
-2. Descarga `weppy-roblox-mcp-v{version}.zip`
-3. Extrae y copia `roblox-plugin/WeppyRobloxMCP.rbxm` a tu carpeta de Plugins de Roblox
+![Pantalla de activación de licencia en el dashboard](../assets/screenshots/license/license-dashboard.png)
 
-### Paso 3: Verificar
+### Después de activar
 
-1. Abre W-MCP en Roblox Studio
-2. Confirma que aparece la insignia Pro
-3. Ejecuta una accion Pro (por ejemplo: `manage_sync` u operaciones masivas)
+- 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
 
@@ -49,8 +75,6 @@ Generación de terreno, búsqueda de assets, análisis espacial, animación, aud
 | Dirección de Sync | Studio → Local (una vía) | Bidireccional |
 | Sync Direction por tipo | ❌ | ✅ Scripts / Values / Containers / Data / Services |
 | Apply Mode por tipo | ❌ | ✅ Auto / Manual |
-| Full Sync | ❌ | ✅ |
-| Resync / Reconstruir estado | ❌ | ✅ |
 | Historial de cambios | ❌ | ✅ |
 | Sync multi-place | ❌ | ✅ Hasta 3 places con almacenamiento aislado |
 | Control de Playtest (Reproducir/Detener/Pausar/Reanudar) | ❌ | ✅ |