@weppy/roblox-mcp 2.2.2 → 2.3.1

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.2.2"
+    "version": "2.3.1"
   },
   "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.2.2",
+      "version": "2.3.1",
       "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

@@ -5,6 +5,37 @@ All notable changes to this project will be documented in this file.
 
 
 
+
+
+## [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
+
+- **Dramatically faster tool action execution** — Switched MCP ↔ Plugin communication from polling to streaming, eliminating round-trip latency and significantly improving response throughput
+
+### Stability
+
+- **Hardened connection management** — Streaming-based transport replaces polling with a real-time bidirectional channel, reducing dropped connections and improving reconnect resilience
+
+### Bug Fixes
+
+- **Prevent OOM on large history files** — Tool history and sync changelog reads now use reverse-chunk tail scanning instead of loading the full file into memory, preventing out-of-memory crashes on long-running sessions
+- **Auto-trim history files** — History files are now automatically trimmed when they exceed 2 MB, keeping disk usage bounded without manual cleanup
+
+
 ## [2.2.2] - 2026-04-03
 
 ### Features

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,7 +18,13 @@ No copy-pasting code. AI does the work, you review the results.
 
 ## Quick Install
 
-**One-line install** — installs the MCP server, Roblox Studio plugin, and registers with your AI apps:
+Install with the guided web page.
+
+👉 **[Install Page](https://weppy-web.pages.dev/en/install)**
+
+### Terminal One-Line Install
+
+If you're comfortable with the terminal, install everything in one line.
 
 **macOS / Linux**
 
@@ -32,18 +38,16 @@ curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/inst
 irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
 ```
 
-Then restart Roblox Studio — done!
+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 manual install path 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 manual install path 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):
-[Plugin Installation Guide](docs/en/installation/roblox-plugin.md)
+**Step 1** — Install the Roblox Studio plugin:
+[Plugin Installation Guide](https://weppy-web.pages.dev/en/install#plugin)
 
 **Step 2** — Register the MCP server with your AI app:
 
@@ -173,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://weppy-web.pages.dev/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.
@@ -185,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://weppy-web.pages.dev/en/plans)
 
 ## License
 

package/docs/en/installation/README.md

@@ -16,7 +16,7 @@ When an AI app says "Create a blue part", the MCP server converts this request,
 
 ## One-Line Install (Recommended)
 
-Installs the MCP server, Roblox Studio plugin, and registers with your AI apps in one step:
+Install everything in one command:
 
 **macOS / Linux**
 
@@ -30,7 +30,7 @@ curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/inst
 irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
 ```
 
-Then restart Roblox Studio — done!
+Then reopen your AI app and restart Roblox Studio.
 
 If the installer fails, it writes an error log to a temporary file and keeps the console open in interactive runs so you can read the reason before exiting.
 
@@ -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://weppy-web.pages.dev/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://weppy-web.pages.dev/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://weppy-web.pages.dev/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,7 +18,13 @@ No necesitas copiar ni pegar código. La IA trabaja y tú verificas los resultad
 
 ## 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:
+Instala siguiendo la guia en la pagina web.
+
+👉 **[Pagina de instalacion](https://weppy-web.pages.dev/en/install)**
+
+### Instalacion por terminal
+
+Si prefieres la terminal, instala todo en una linea.
 
 **macOS / Linux**
 
@@ -40,10 +46,10 @@ Si la ejecución de PowerShell está bloqueada en Windows, continúa con la inst
 
 ### 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.
+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):
-[Guia de instalacion del plugin](installation/roblox-plugin.md)
+**Paso 1** — Instala el plugin de Roblox Studio:
+[Guia de instalacion del plugin](https://weppy-web.pages.dev/en/install#plugin)
 
 **Paso 2** — Registra el servidor MCP en tu app de IA:
 
@@ -171,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://weppy-web.pages.dev/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.
@@ -183,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://weppy-web.pages.dev/en/plans)
 
 ## Licencia
 

package/docs/es/installation/README.md

@@ -12,7 +12,7 @@ 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:
+Instala todo con un solo comando:
 
 **macOS / Linux**
 
@@ -36,13 +36,13 @@ Si la ejecución de PowerShell está bloqueada en Windows, continúa con la inst
 
 ## 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.
+Si la instalacion en un solo comando no funciona, o cuando no puedes usar la instalacion automatica en tu entorno, usa la instalacion manual de abajo como alternativa.
 
 ### 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)
+👉 [Guía de instalación del plugin](https://weppy-web.pages.dev/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://weppy-web.pages.dev/en/install#explorer)
 
 Instalación directa:
 - [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)