@weppy/roblox-mcp 2.3.0 → 2.4.0

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Weppy Roblox MCP — MCP server that lets AI coding agents control a live Roblox Studio session with 21 tools, 140+ actions, bidirectional sync, automated playtest, and multi-place support",
-    "version": "2.3.0"
+    "version": "2.4.0"
   },
   "plugins": [
     {
       "name": "weppy-roblox-mcp",
       "source": "./plugins/weppy-roblox-mcp",
       "description": "Weppy Roblox MCP — MCP server that lets AI coding agents control a live Roblox Studio session with 21 tools, 140+ actions, bidirectional sync, automated playtest, and multi-place support",
-      "version": "2.3.0",
+      "version": "2.4.0",
       "author": {
         "name": "hope1026"
       },

package/.github/workflows/install-test.yml

@@ -0,0 +1,108 @@
+name: Install Script E2E Test
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  test-bash:
+    name: E2E — install.sh (ubuntu)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install Claude Code CLI (app detection용)
+        run: npm install -g @anthropic-ai/claude-code
+
+      - name: Run install.sh (CI mode)
+        env:
+          CI: true
+        run: bash install.sh
+
+      - name: Verify — npm global install
+        run: |
+          result=$(npm list -g @weppy/roblox-mcp --depth=0 2>&1)
+          if ! echo "$result" | grep -q '@weppy/roblox-mcp'; then
+            echo "❌ @weppy/roblox-mcp not installed globally"
+            exit 1
+          fi
+          echo "✓ @weppy/roblox-mcp installed"
+
+      - name: Verify — plugin file exists
+        run: |
+          PLUGIN_PATH="$HOME/Documents/Roblox/Plugins/WeppyRobloxMCP.rbxm"
+          if [ ! -f "$PLUGIN_PATH" ]; then
+            echo "❌ Plugin not found: $PLUGIN_PATH"
+            exit 1
+          fi
+          echo "✓ Plugin found: $PLUGIN_PATH"
+
+      - name: Verify — Claude Code config registered
+        run: |
+          result=$(claude mcp list 2>&1)
+          if ! echo "$result" | grep -q 'weppy-roblox-mcp'; then
+            echo "❌ weppy-roblox-mcp not found in claude mcp list"
+            echo "Output: $result"
+            exit 1
+          fi
+          echo "✓ weppy-roblox-mcp registered"
+
+  test-powershell:
+    name: E2E — install.ps1 (windows)
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install Claude Code CLI (app detection용)
+        run: npm install -g @anthropic-ai/claude-code
+
+      - name: Run install.ps1 (CI mode)
+        env:
+          CI: true
+        shell: pwsh
+        run: pwsh install.ps1
+
+      - name: Verify — npm global install
+        shell: pwsh
+        run: |
+          $result = npm list -g @weppy/roblox-mcp --depth=0 2>&1
+          if (-not ($result -match '@weppy/roblox-mcp')) {
+            Write-Error "❌ @weppy/roblox-mcp not installed globally"
+            exit 1
+          }
+          Write-Host "✓ @weppy/roblox-mcp installed"
+
+      - name: Verify — plugin file exists
+        shell: pwsh
+        run: |
+          $pluginPath = Join-Path $env:LOCALAPPDATA "Roblox\Plugins\WeppyRobloxMCP.rbxm"
+          if (-not (Test-Path $pluginPath)) {
+            Write-Error "❌ Plugin not found: $pluginPath"
+            exit 1
+          }
+          Write-Host "✓ Plugin found: $pluginPath"
+
+      - name: Verify — Claude Code config registered
+        shell: pwsh
+        run: |
+          # claude mcp add는 ~/.claude.json에, 폴백은 ~/.claude/mcp.json에 씁니다
+          $found = $false
+          @("$env:USERPROFILE\.claude.json", "$env:USERPROFILE\.claude\mcp.json") | ForEach-Object {
+            if ((Test-Path $_) -and ((Get-Content $_ -Raw) -match 'weppy-roblox-mcp')) {
+              $found = $true
+            }
+          }
+          if (-not $found) {
+            Write-Error "❌ weppy-roblox-mcp not found in claude config files"
+            exit 1
+          }
+          Write-Host "✓ weppy-roblox-mcp registered"

package/CHANGELOG.md

@@ -6,6 +6,38 @@ All notable changes to this project will be documented in this file.
 
 
 
+
+
+## [2.4.0] - 2026-04-10
+
+### ⚠️ BREAKING CHANGES
+
+- **Tool statistics and changelog history format updated** — The internal storage format for tool execution statistics (`tool-stats.json`) and changelog history has changed. Existing data will be automatically reset on first launch after upgrading. You will start with fresh statistics — previous history is not migrated.
+
+### Features
+
+- **Dashboard "What's New" page** — A new announcements page in the dashboard keeps you informed about important changes, breaking updates, and tips. Accessible via the bell icon in the sidebar, with unread indicators for new announcements.
+- **Improved blocked-tool feedback** — When a Pro-only tool is used on Basic tier, the dashboard and plugin now show clearer outcome details (fallback, unsupported, failed) instead of generic error labels.
+- **Connection stability improvements** — Added handshake timeout, connection cancel button, and license reconnect race condition fixes for more reliable Studio connections.
+
+### Bug Fixes
+
+- **Fix `ws` module not found on install** — Replaced dynamic `require("ws")` with a static import, resolving installation failures where the `ws` dependency could not be located by the bundler.
+
+
+## [2.3.1] - 2026-04-07
+
+### Features
+
+- **WROX Sourcemap support** — Added sourcemap builder that generates and refreshes sourcemaps automatically after sync, enabling luau-lsp integration for WROX users
+- **Dashboard improvements** — Added agent activity indicators, last-seen/last-command columns, process termination, and active place path display to the connection and sync dashboards
+
+### Stability
+
+- **Sourcemap generation hardened** — Fixed multiple edge cases around sourcemap refresh timing, redundant rebuilds, and state persistence to ensure reliable sourcemap output
+- **Sync reliability improvements** — Improved sync history diff recording, collision index mapping, and error handling across sync and camera operations
+
+
 ## [2.3.0] - 2026-04-05
 
 ### Performance

package/README.md

@@ -6,7 +6,7 @@
 
 **English** | [한국어](docs/ko/README.md) | [日本語](docs/ja/README.md) | [Español](docs/es/README.md) | [Português](docs/pt-br/README.md) | [Bahasa Indonesia](docs/id/README.md)
 
-[![Demo — AI building a Roblox game in real time](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
+[![Demo — AI building a Roblox game in real time](https://img.youtube.com/vi/puQB4u1VlMw/maxresdefault.jpg)](https://youtu.be/puQB4u1VlMw)
 
 ## Why WROX (Weppy Roblox MCP)?
 
@@ -18,6 +18,14 @@ No copy-pasting code. AI does the work, you review the results.
 
 ## Quick Install
 
+Install with the guided web page.
+
+👉 **[Install Page](https://weppyai.com/en/install)**
+
+### Terminal One-Line Install
+
+If you're comfortable with the terminal, install everything in one line.
+
 **macOS / Linux**
 
 ```bash
@@ -34,13 +42,11 @@ Then reopen your AI app and restart Roblox Studio.
 
 Automatic MCP registration supports **Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI, and Antigravity**.
 
-If PowerShell execution is blocked on Windows, use the installation guide below. If you're using the ZIP package, you can run `setup-plugin.sh` / `setup-mcp.sh` on macOS or Linux, or `setup-plugin.bat` / `setup-mcp.bat` on Windows.
-
 ### Manual Install
 
-If the one-line install does not work, or automatic installation is not available in your environment, use the installation guide below.
+If the one-line install does not work, or automatic installation is not available in your environment:
 
-**Step 1** — Install the Roblox Studio plugin (bridge between Studio and AI):
+**Step 1** — Install the Roblox Studio plugin:
 [Plugin Installation Guide](docs/en/installation/roblox-plugin.md)
 
 **Step 2** — Register the MCP server with your AI app:
@@ -171,7 +177,7 @@ Yes. See [Cursor Setup](docs/en/installation/ai-apps/cursor.md). Any MCP-compati
 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.
 
 ### What is the difference between Basic and Pro?
-Basic (Free) includes MCP tool execution and one-way sync (Studio -> Local). Pro adds bidirectional sync, bulk operations, terrain generation, spatial analysis, audio/animation control, and multi-place support. See the [Pro Upgrade Guide](docs/en/pro-upgrade.md).
+Basic (Free) includes MCP tool execution and one-way sync (Studio -> Local). Pro adds bidirectional sync, bulk operations, terrain generation, spatial analysis, audio/animation control, and multi-place support. See the [Pro Upgrade Guide](https://weppyai.com/en/plans).
 
 ### How is Weppy different from other Roblox MCP servers?
 Weppy uses action-based dispatching instead of separate tools for each function. This reduces AI token consumption significantly. It also provides bidirectional project sync and multi-place support, which most alternatives lack.
@@ -183,7 +189,7 @@ The server runs on localhost only (127.0.0.1:3002). Forbidden paths (CoreGui, Co
 
 Bidirectional Sync, advanced build capabilities, and AI token efficiency — all in one upgrade.
 
-[Pro Upgrade Guide](docs/en/pro-upgrade.md)
+[Pro Upgrade Guide](https://weppyai.com/en/plans)
 
 ## License
 

package/docs/en/installation/README.md

@@ -48,7 +48,7 @@ If the one-line install does not work, or automatic installation is not availabl
 
 Download the plugin file from GitHub, then place it in Roblox Studio's Plugins folder.
 
-👉 [Plugin Installation Guide](roblox-plugin.md)
+👉 [Plugin Installation Guide](https://weppyai.com/en/install#plugin)
 
 ---
 
@@ -75,7 +75,7 @@ Register the MCP server with your AI app. You can use it with any AI app that su
 Browse synced instance trees inside VSCode with Roblox class icons.
 This optional extension requires the Roblox MCP setup above, because it reads sync data from `wrox-project-sync` under your project root.
 
-👉 [WROX Roblox Explorer Installation Guide](roblox-explorer.md)
+👉 [WROX Roblox Explorer Installation Guide](https://weppyai.com/en/install#explorer)
 
 Direct listings:
 - [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)

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

@@ -1,18 +1,22 @@
-# WROX Roblox Explorer (VSCode Extension)
+# WROX Roblox Explorer (VSCode · Antigravity Extension)
 
-Roblox Studio Explorer-like tree view for VSCode. Browse synced instance trees, open scripts directly, and track sync status — all inside your editor.
+> **Optional** — Explorer is not required. All core features work with just MCP and the plugin. Install it when you want to browse the project structure in your editor.
+
+Roblox Studio Explorer-like tree view for your editor. Browse synced instance trees, open scripts directly, and track sync status — all inside your editor.
 This is a companion extension for WROX, not a standalone Roblox integration.
 
 ![WROX Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 
 ## Requirements
 
-- VSCode 1.85+
+- VSCode 1.85+ or Antigravity
 - [Roblox MCP](../../../README.md) installed with Sync enabled (Basic or Pro)
 - Sync has already generated `wrox-project-sync/place_*/.sync-meta.json` under your project root
 
 ## Installation
 
+### VSCode
+
 Search for **WROX Roblox Explorer** in the VSCode Extensions sidebar (`Ctrl+Shift+X` / `Cmd+Shift+X`) and click **Install**.
 
 Or install directly from:
@@ -20,6 +24,12 @@ Or install directly from:
 - [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
 - [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
 
+### Antigravity
+
+Antigravity is VSCode-based, so the same extension works. Search for **WROX Roblox Explorer** in the Antigravity Extensions tab and click **Install**.
+
+---
+
 Core tree browsing works from synced files on disk. Live sync state, direction indicators, and Explorer telemetry forwarding are available when the local MCP server is reachable.
 
 ## Features

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

@@ -2,17 +2,42 @@
 
 How to install the plugin to connect AI agents with Roblox Studio.
 
-## 1. Download Plugin
+## Automatic Installation (Recommended)
+
+If the MCP server setup is complete, the plugin is **installed automatically**. No manual download or file copy is needed.
+
+### How it works
+
+1. When the MCP server runs for the first time, it places the plugin file (`WeppyRobloxMCP.rbxm`) into the Roblox Studio Plugins folder automatically.
+2. When you start Roblox Studio, the **WROX** button appears in the Plugins tab.
+
+### Connecting
+
+1. Open any project in **Roblox Studio**
+2. Go to **Plugins** tab → **WROX**
+
+![WROX Button](../../assets/screenshots/plugin/installation/toolbar-button.png)
+
+3. Click the **Connect** button in the plugin window
+4. Once **"Connected"** status is displayed, you're ready
+
+![Plugin Main Screen](../../assets/screenshots/plugin/installation/main-screen.png)
+
+> If automatic installation did not work, follow the manual installation below.
+
+---
+
+## Manual Installation
+
+Use this if automatic installation didn't work or you need to install a specific version.
+
+### 1. Download Plugin
 
 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
-
-Note:
-- Basic users install the same plugin package and use Basic policy (Studio -> Local one-way sync)
-- Pro subscribers unlock bidirectional sync and broader advanced tools after license activation
+3. Extract the ZIP file — you will find `roblox-plugin/WeppyRobloxMCP.rbxm`
 
-## 2. Install Plugin
+### 2. Install Plugin
 
 1. Open **Roblox Studio**
 2. Click the **Plugins** tab in the top menu
@@ -23,38 +48,19 @@ Note:
 4. **Copy** the `WeppyRobloxMCP.rbxm` file from the extracted folder into the opened Plugins folder
 5. **Restart Roblox Studio**
 
-## 3. Verify Installation
+### 3. Verify Installation
 
 After restarting, the **WROX** button will appear in the Plugins tab.
 
 ![WROX Button](../../assets/screenshots/plugin/installation/toolbar-button.png)
 
-## 4. Connect to AI Agent
+### 4. Connect
 
-### Prerequisites
+Follow the same "Connecting" steps above — click Connect in the plugin.
 
-The MCP server must be installed. Complete the guide for your AI app first:
+---
 
-| AI App | Installation Guide |
-|--------|-------------------|
-| 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) |
-| Antigravity | [Setup Guide](ai-apps/antigravity.md) |
-
-### Connecting
-
-1. Open any project in **Roblox Studio**
-2. Go to **Plugins** tab -> **WROX**
-3. Click the **Connect** button in the plugin window
-4. Once **"Connected"** status is displayed, you're ready
-
-![Plugin Main Screen](../../assets/screenshots/plugin/installation/main-screen.png)
-
-## 5. Settings (Optional)
+## Settings (Optional)
 
 Click the settings button in the top right of the plugin to change options.
 
@@ -65,6 +71,11 @@ Click the settings button in the top right of the plugin to change options.
 - **Auto Camera Focus**: Automatically move camera to created objects
 - **Language**: Change the plugin UI language
 
+## Tier Information
+
+- Basic users install the same plugin package and use Basic policy (Studio → Local one-way sync).
+- Pro subscribers unlock bidirectional sync and broader advanced tools after license activation.
+
 ## Troubleshooting
 
 ### Plugin not visible

package/docs/en/pro-upgrade.md

@@ -25,9 +25,16 @@ AI can control Roblox Studio playtests directly. It can start and stop Play (F5)
 - "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
+### More Pro-only features
 
-Terrain generation, asset search, spatial analysis, animation, audio, and production-scale automation.
+Pro unlocks additional features beyond the core workflow.
+
+- **Bulk operations** — Create, modify, or delete multiple instances in a single request
+- **Terrain generation** — Fill with block, ball, cylinder, wedge, and replace materials
+- **Asset search/insert** — Search the Roblox marketplace and insert assets directly
+- **Spatial analysis** — Raycast, find ground, flat area search, collision checks
+- **Environment control** — Lighting, atmosphere, sky, and time-of-day settings
+- **Audio/Animation** — Sound playback and animation load/play
 
 ## Buy and Activate
 
@@ -70,13 +77,20 @@ You only need to activate the license once, either in the plugin or in the dashb
 
 | Feature | Basic | Pro |
 |---------|:-----:|:---:|
-| Script, Instance, Property management | ✅ Full access | ✅ Full access |
-| Selection, Tag, Camera, Log | ✅ Full access | ✅ Full access |
-| Sync Direction | Studio → Local (one-way) | Bidirectional |
-| Per-type Sync Direction | ❌ | ✅ Scripts / Values / Containers / Data / Services |
-| Per-type Apply Mode | ❌ | ✅ Auto / Manual |
-| Change History | ❌ | ✅ |
-| Multi-place Sync | ❌ | ✅ Up to 3 places, each with isolated storage |
-| Playtest Control (Play/Stop/Pause/Resume) | ❌ | ✅ |
-| Advanced tool coverage | Core set | Broader advanced set |
-| AI token efficiency | Standard | Better with bulk / high-leverage actions |
+| Script create/edit | ✅ | ✅ |
+| Instance create/delete/move | ✅ | ✅ + bulk operations |
+| Property read/write | ✅ | ✅ + bulk changes |
+| Selection, tags, search | ✅ | ✅ |
+| Camera control | ✅ | ✅ |
+| Log monitoring | ✅ | ✅ |
+| Luau code execution | ✅ | ✅ |
+| Project sync | Studio → Local one-way | Bidirectional + per-type direction/mode |
+| Multi-place sync | — | Up to 3 Places simultaneously |
+| Change history | — | Track changes before applying |
+| Playtest control | — | Play / stop / pause / resume + automated tests |
+| Terrain generation/editing | — | Block, ball, cylinder, wedge, material replace |
+| Asset search/insert | — | Search Roblox marketplace and insert directly |
+| Spatial analysis | — | Raycast, find ground, collision checks |
+| Environment control | — | Lighting, atmosphere, sky, time of day |
+| Audio / Animation | — | Sound playback, animation load/play |
+| AI token efficiency | Per-action calls | Fewer calls with bulk actions |

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

@@ -0,0 +1,41 @@
+# Use `luau-lsp` with WROX Sync
+
+WROX Sync can generate the sourcemap files that `luau-lsp` needs, so you can enable Roblox-aware editor features without setting up a separate Rojo project.
+
+## What WROX writes
+
+After Full Sync finishes, WROX writes:
+
+- Place sourcemap: `wrox-project-sync/place_<id>/sourcemap.json`
+- Root representative file: `wrox-project-sync/sourcemap.json`
+
+For most users, the recommended path is `wrox-project-sync/sourcemap.json`.
+
+## Why this helps
+
+Pointing `luau-lsp` at the WROX sourcemap improves:
+
+- `game.*` autocomplete
+- Navigation across synced scripts
+- `require` resolution between synced scripts
+
+## Recommended setup
+
+1. Run Full Sync once so WROX creates `wrox-project-sync/sourcemap.json`.
+2. Point your editor's `luau-lsp` sourcemap setting to `wrox-project-sync/sourcemap.json`.
+3. If your client can disable automatic Rojo generation, set `luau-lsp.sourcemap.autogenerate` to `false`.
+
+Example VSCode settings:
+
+```json
+{
+  "luau-lsp.sourcemap.enabled": true,
+  "luau-lsp.sourcemap.autogenerate": false,
+  "luau-lsp.sourcemap.sourcemapFile": "wrox-project-sync/sourcemap.json"
+}
+```
+
+## Multi-place note
+
+`wrox-project-sync/sourcemap.json` follows the current representative place for the project.
+If you need a fixed place instead, point `luau-lsp` directly to that place's `wrox-project-sync/place_<id>/sourcemap.json`.

package/docs/en/sync/overview.md

@@ -19,6 +19,8 @@ Without Sync, AI only sees snippets pasted into chat. With Sync enabled, AI work
 3. History/Status tracking: inspect what changed, when, and in which direction
 
 Sync data is stored under `{projectRoot}/wrox-project-sync/place_{placeId}/explorer`.
+WROX also writes a place sourcemap to `{projectRoot}/wrox-project-sync/place_{placeId}/sourcemap.json` and keeps the recommended root representative file at `{projectRoot}/wrox-project-sync/sourcemap.json`.
+Use the root path for editor integrations such as `luau-lsp`. Setup steps are covered in [Use `luau-lsp` with WROX Sync](./luau-lsp.md).
 
 ### Browse sync data in VSCode
 
@@ -146,5 +148,6 @@ Names containing `~` are escaped to `~~` (e.g. `Part~2` becomes `Part~~2/`). The
 
 ## Related docs
 
+- [Use `luau-lsp` with WROX Sync](./luau-lsp.md)
 - [Tools Overview](../tools/overview.md)
-- [Pro Upgrade Guide](../pro-upgrade.md)
+- [Pro Upgrade Guide](https://weppyai.com/en/plans)

package/docs/es/README.md

@@ -6,7 +6,7 @@
 
 [English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | **Español** | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
 
-[![Demo — IA creando un juego Roblox en tiempo real](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/puQB4u1VlMw/maxresdefault.jpg)](https://youtu.be/puQB4u1VlMw)
 
 ## ¿Por qué WROX (Weppy Roblox MCP)?
 
@@ -18,6 +18,14 @@ No necesitas copiar ni pegar código. La IA trabaja y tú verificas los resultad
 
 ## Instalacion rapida
 
+Instala siguiendo la guia en la pagina web.
+
+👉 **[Pagina de instalacion](https://weppyai.com/en/install)**
+
+### Instalacion por terminal
+
+Si prefieres la terminal, instala todo en una linea.
+
 **macOS / Linux**
 
 ```bash
@@ -40,7 +48,7 @@ Si la ejecución de PowerShell está bloqueada en Windows, continúa con la inst
 
 Si la instalacion en un solo comando no funciona, o si no puedes usar la instalacion automatica en tu entorno, usa la instalacion manual de abajo como alternativa.
 
-**Paso 1** — Instala el plugin de Roblox Studio (puente entre Studio e IA):
+**Paso 1** — Instala el plugin de Roblox Studio:
 [Guia de instalacion del plugin](installation/roblox-plugin.md)
 
 **Paso 2** — Registra el servidor MCP en tu app de IA:
@@ -169,7 +177,7 @@ Sí. Consulta [Configuración de Cursor](installation/ai-apps/cursor.md). Cualqu
 Sí. La IA puede crear instancias, escribir scripts, generar terrain, configurar iluminación, insertar assets, configurar física y más — todo dentro de una sesión de Studio en vivo. Va más allá de la generación de código hacia acciones ejecutables.
 
 ### ¿Cuál es la diferencia entre Basic y Pro?
-Basic (gratuito) incluye ejecución de herramientas MCP y sincronización unidireccional (Studio -> Local). Pro agrega sincronización bidireccional, operaciones masivas, generación de terrain, análisis espacial, control de audio/animación y soporte multi-place. Consulta la [Guía de actualización Pro](pro-upgrade.md).
+Basic (gratuito) incluye ejecución de herramientas MCP y sincronización unidireccional (Studio -> Local). Pro agrega sincronización bidireccional, operaciones masivas, generación de terrain, análisis espacial, control de audio/animación y soporte multi-place. Consulta la [Guía de actualización Pro](https://weppyai.com/en/plans).
 
 ### ¿Cómo se diferencia Weppy de otros servidores MCP para Roblox?
 Weppy usa despacho basado en acciones en lugar de herramientas separadas para cada función. Esto reduce significativamente el consumo de tokens de IA. También proporciona sincronización bidireccional de proyecto y soporte multi-place, que la mayoría de las alternativas no tienen.
@@ -181,7 +189,7 @@ El servidor se ejecuta solo en localhost (127.0.0.1:3002). Las rutas prohibidas
 
 Sync bidireccional, capacidades de creacion avanzadas y eficiencia de tokens de IA — todo en una sola actualizacion.
 
-[Guia de actualizacion Pro](pro-upgrade.md)
+[Guia de actualizacion Pro](https://weppyai.com/en/plans)
 
 ## Licencia
 

package/docs/es/installation/README.md

@@ -42,7 +42,7 @@ Si la instalacion en un solo comando no funciona, o cuando no puedes usar la ins
 
 El plugin conecta Roblox Studio con la IA.
 
-👉 [Guía de instalación del plugin](roblox-plugin.md)
+👉 [Guía de instalación del plugin](https://weppyai.com/en/install#plugin)
 
 ### Paso 2: Registrar el Servidor MCP en tu App de IA
 
@@ -68,7 +68,7 @@ Configura el servidor MCP en tu app de IA para que pueda comunicarse con Roblox
 Explora los árboles de instancias sincronizados dentro de VSCode con iconos de clases Roblox.
 Esta extension opcional requiere completar antes la instalacion de Roblox MCP, porque Explorer lee los datos de Sync desde `wrox-project-sync` dentro de la raiz del proyecto.
 
-👉 [Guía de instalación de WROX Roblox Explorer](roblox-explorer.md)
+👉 [Guía de instalación de WROX Roblox Explorer](https://weppyai.com/en/install#explorer)
 
 Instalación directa:
 - [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)

package/docs/es/pro-upgrade.md

@@ -25,9 +25,16 @@ La IA puede controlar los playtests de Roblox Studio de forma directa. Puede ini
 - "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
+### Más funciones exclusivas de Pro
 
-Generación de terreno, búsqueda de assets, análisis espacial, animación, audio y automatización a escala de producción.
+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
 
@@ -70,13 +77,20 @@ Solo necesitas activar la licencia una vez, ya sea en el plugin o en el dashboar
 
 | Función | Basic | Pro |
 |---------|:-----:|:---:|
-| Gestión de Script, Instance, Property | ✅ Acceso completo | ✅ Acceso completo |
-| Selection, Tag, Camera, Log | ✅ Acceso completo | ✅ Acceso completo |
-| 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 |
-| 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 |
+| 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 |