@weppy/roblox-mcp 2.0.2 → 2.0.4

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.0.2"
+    "version": "2.0.4"
   },
   "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.0.2",
+      "version": "2.0.4",
       "author": {
         "name": "hope1026"
       },

package/CHANGELOG.md

@@ -16,11 +16,27 @@ All notable changes to this project will be documented in this file.
 
 
 
+
+
+## [2.0.4] - 2026-03-24
+
+### Bug Fixes
+
+- Fix deployment script bug.
+
+
+## [2.0.3] - 2026-03-24
+
+### Bug Fixes
+
+- **Fix install script failures on macOS/Linux**: Resolved a path resolution bug in `install.sh` that caused the installer to fail when the Claude or Cursor config directory did not exist yet. The script now creates the config directory automatically before writing the MCP entry.
+
+
 ## [2.0.2] - 2026-03-24
 
 ### Features
 
-- **New one-line installation method**: Install the MCP server and Roblox Studio plugin with a single command. On macOS/Linux run `curl -fsSL https://weppy.dev/install | bash`, on Windows run `irm https://weppy.dev/install.ps1 | iex`. The installer auto-detects the Claude/Cursor config path, injects the MCP entry, and opens the plugin install page in your browser.
+- **New one-line installation method**: Install the MCP server and Roblox Studio plugin with a single command. On macOS/Linux run `curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash`, on Windows run `irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex`. The installer auto-detects the Claude/Cursor config path, injects the MCP entry, and opens the plugin install page in your browser.
 - **Dashboard data clearing**: Added clear buttons to the web dashboard for connection history, tool execution history, and sync history. Each section can now be reset independently without restarting the server.
 - **Plugin and MCP stability improvements**: Hardened the HTTP polling loop in the Roblox Studio plugin to recover from transient network errors without dropping the connection. The MCP server now retries failed result deliveries and surfaces timeout details in error responses for easier debugging.
 

package/README.md

@@ -20,16 +20,23 @@ This is not just code generation. It is **executable, production-oriented action
 
 **One-line install** — installs the MCP server, Roblox Studio plugin, and registers with your AI apps:
 
+**macOS / Linux**
+
 ```bash
-# macOS / Linux
 curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+```
 
-# Windows (PowerShell)
+**Windows (PowerShell)**
+
+```powershell
 irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
 ```
 
 Then restart Roblox Studio — done!
 
+Automatic MCP registration currently supports **Claude Code, Claude Desktop, Cursor, Codex CLI, and Gemini CLI**.
+**Codex App** and **Antigravity** still require manual setup after the script finishes.
+
 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

package/docs/en/installation/README.md

@@ -18,16 +18,23 @@ When an AI app says "Create a blue part", the MCP server converts this request,
 
 Installs the MCP server, Roblox Studio plugin, and registers with your AI apps in one step:
 
+**macOS / Linux**
+
 ```bash
-# macOS / Linux
 curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+```
 
-# Windows (PowerShell)
+**Windows (PowerShell)**
+
+```powershell
 irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
 ```
 
 Then restart Roblox Studio — done!
 
+Automatic MCP registration currently supports **Claude Code, Claude Desktop, Cursor, Codex CLI, and Gemini CLI**.
+**Codex App** and **Antigravity** still require manual setup after the script finishes.
+
 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`.
 
 ---

package/docs/es/README.md

@@ -12,16 +12,23 @@
 
 **Instalacion en un solo comando** — Instala el servidor MCP, el plugin de Roblox Studio y registra tus apps de IA en un solo paso:
 
+**macOS / Linux**
+
 ```bash
-# macOS / Linux
 curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+```
 
-# Windows (PowerShell)
+**Windows (PowerShell)**
+
+```powershell
 irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
 ```
 
 ¡Reinicia Roblox Studio y listo!
 
+El registro automático de MCP actualmente es compatible con **Claude Code, Claude Desktop, Cursor, Codex CLI y Gemini CLI**.
+**Codex App** y **Antigravity** todavía requieren configuración manual después de que termine el script.
+
 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

package/docs/es/installation/README.md

@@ -14,16 +14,23 @@ Plugin de Roblox Studio
 
 Instala el servidor MCP, el plugin de Roblox Studio y registra tus apps de IA en un solo paso:
 
+**macOS / Linux**
+
 ```bash
-# macOS / Linux
 curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+```
 
-# Windows (PowerShell)
+**Windows (PowerShell)**
+
+```powershell
 irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
 ```
 
 ¡Reinicia Roblox Studio y listo!
 
+El registro automático de MCP actualmente es compatible con **Claude Code, Claude Desktop, Cursor, Codex CLI y Gemini CLI**.
+**Codex App** y **Antigravity** todavía requieren configuración manual después de que termine el script.
+
 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`.
 
 ---

package/docs/id/README.md

@@ -12,16 +12,23 @@
 
 **Instalasi satu perintah** — Install MCP server, plugin Roblox Studio, dan daftarkan ke aplikasi AI dalam satu langkah:
 
+**macOS / Linux**
+
 ```bash
-# macOS / Linux
 curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+```
 
-# Windows (PowerShell)
+**Windows (PowerShell)**
+
+```powershell
 irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
 ```
 
 Restart Roblox Studio — selesai!
 
+Pendaftaran MCP otomatis saat ini mendukung **Claude Code, Claude Desktop, Cursor, Codex CLI, dan Gemini CLI**.
+**Codex App** dan **Antigravity** masih memerlukan pengaturan manual setelah skrip selesai.
+
 Jika eksekusi PowerShell diblokir di Windows, lanjutkan dengan instalasi manual di bawah. Jika kamu memakai paket ZIP, kamu juga bisa memakai `setup-plugin.bat` dan `setup-mcp.bat`.
 
 ### Instalasi Manual

package/docs/id/installation/README.md

@@ -18,16 +18,23 @@ Ketika aplikasi AI bilang "buatkan part biru", MCP server mengonversi perintah i
 
 Install MCP server, plugin Roblox Studio, dan daftarkan ke aplikasi AI dalam satu langkah:
 
+**macOS / Linux**
+
 ```bash
-# macOS / Linux
 curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+```
 
-# Windows (PowerShell)
+**Windows (PowerShell)**
+
+```powershell
 irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
 ```
 
 Restart Roblox Studio — selesai!
 
+Pendaftaran MCP otomatis saat ini mendukung **Claude Code, Claude Desktop, Cursor, Codex CLI, dan Gemini CLI**.
+**Codex App** dan **Antigravity** masih memerlukan pengaturan manual setelah skrip selesai.
+
 Jika eksekusi PowerShell diblokir di Windows, lanjutkan dengan instalasi manual di bawah. Jika kamu memakai paket ZIP, kamu juga bisa menjalankan `setup-plugin.bat` dan `setup-mcp.bat`.
 
 ---

package/docs/ja/README.md

@@ -12,16 +12,23 @@
 
 **ワンラインインストール** — MCPサーバー、Roblox Studioプラグイン、AIアプリへの登録を一度に完了します：
 
+**macOS / Linux**
+
 ```bash
-# macOS / Linux
 curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+```
 
-# Windows (PowerShell)
+**Windows (PowerShell)**
+
+```powershell
 irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
 ```
 
 Roblox Studioを再起動したら完了です！
 
+自動でMCP登録できるのは現在 **Claude Code, Claude Desktop, Cursor, Codex CLI, Gemini CLI** です。
+**Codex App** と **Antigravity** はスクリプト完了後に手動設定が必要です。
+
 WindowsでPowerShellの実行がブロックされる場合は、下の手動インストールに進んでください。ZIPパッケージを使う場合は `setup-plugin.bat` と `setup-mcp.bat` も利用できます。
 
 ### 手動インストール

package/docs/ja/installation/README.md

@@ -18,16 +18,23 @@ AIアプリが「青いパーツを作って」と言うと、MCPサーバーが
 
 MCPサーバー、Roblox Studioプラグイン、AIアプリへの登録を一度に完了します：
 
+**macOS / Linux**
+
 ```bash
-# macOS / Linux
 curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+```
 
-# Windows (PowerShell)
+**Windows (PowerShell)**
+
+```powershell
 irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
 ```
 
 Roblox Studioを再起動したら完了です！
 
+自動でMCP登録できるのは現在 **Claude Code, Claude Desktop, Cursor, Codex CLI, Gemini CLI** です。
+**Codex App** と **Antigravity** はスクリプト完了後に手動設定が必要です。
+
 WindowsでPowerShellの実行がブロックされる場合は、下の手動インストールに進んでください。ZIPパッケージを使う場合は `setup-plugin.bat` と `setup-mcp.bat` を実行できます。
 
 ---

package/docs/ko/README.md

@@ -12,16 +12,23 @@
 
 **원라인 설치** — MCP 서버, Roblox Studio 플러그인, AI 앱 등록을 한 번에 진행합니다:
 
+**macOS / Linux**
+
 ```bash
-# macOS / Linux
 curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+```
 
-# Windows (PowerShell)
+**Windows (PowerShell)**
+
+```powershell
 irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
 ```
 
 Roblox Studio를 재시작하면 완료입니다!
 
+자동 MCP 등록은 현재 **Claude Code, Claude Desktop, Cursor, Codex CLI, Gemini CLI**만 지원합니다.
+**Codex App**과 **Antigravity**는 스크립트 완료 후 수동 설정이 필요합니다.
+
 Windows에서 PowerShell 실행이 차단되면 아래 수동 설치로 진행하세요. ZIP 패키지를 사용하는 경우 `setup-plugin.bat`, `setup-mcp.bat`도 사용할 수 있습니다.
 
 ### 수동 설치

package/docs/ko/installation/README.md

@@ -18,16 +18,23 @@ AI 앱이 "파란 파트를 만들어줘"라고 하면, MCP 서버가 이 요청
 
 MCP 서버, Roblox Studio 플러그인, AI 앱 등록을 한 번에 진행합니다:
 
+**macOS / Linux**
+
 ```bash
-# macOS / Linux
 curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+```
 
-# Windows (PowerShell)
+**Windows (PowerShell)**
+
+```powershell
 irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
 ```
 
 Roblox Studio를 재시작하면 완료입니다!
 
+자동 MCP 등록은 현재 **Claude Code, Claude Desktop, Cursor, Codex CLI, Gemini CLI**만 지원합니다.
+**Codex App**과 **Antigravity**는 스크립트 완료 후 수동 설정이 필요합니다.
+
 Windows에서 PowerShell 실행이 차단되면 아래 수동 설치로 진행하세요. ZIP 패키지를 사용하는 경우 `setup-plugin.bat`, `setup-mcp.bat`를 실행할 수 있습니다.
 
 ---

package/docs/pt-br/README.md

@@ -12,16 +12,23 @@
 
 **Instalacao em um comando** — Instala o servidor MCP, o plugin do Roblox Studio e registra nos apps de IA em um único passo:
 
+**macOS / Linux**
+
 ```bash
-# macOS / Linux
 curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+```
 
-# Windows (PowerShell)
+**Windows (PowerShell)**
+
+```powershell
 irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
 ```
 
 Reinicie o Roblox Studio — pronto!
 
+O registro automático de MCP atualmente suporta **Claude Code, Claude Desktop, Cursor, Codex CLI e Gemini CLI**.
+**Codex App** e **Antigravity** ainda exigem configuração manual depois que o script terminar.
+
 Se a execução do PowerShell estiver bloqueada no Windows, siga a instalação manual abaixo. Se estiver usando o pacote ZIP, você também pode usar `setup-plugin.bat` e `setup-mcp.bat`.
 
 ### Instalacao manual

package/docs/pt-br/installation/README.md

@@ -18,16 +18,23 @@ Quando o app de IA diz "cria uma parte azul", o servidor MCP converte o pedido e
 
 Instala o servidor MCP, o plugin do Roblox Studio e registra nos apps de IA em um único passo:
 
+**macOS / Linux**
+
 ```bash
-# macOS / Linux
 curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
+```
 
-# Windows (PowerShell)
+**Windows (PowerShell)**
+
+```powershell
 irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
 ```
 
 Reinicie o Roblox Studio — pronto!
 
+O registro automático de MCP atualmente suporta **Claude Code, Claude Desktop, Cursor, Codex CLI e Gemini CLI**.
+**Codex App** e **Antigravity** ainda exigem configuração manual depois que o script terminar.
+
 Se a execução do PowerShell estiver bloqueada no Windows, siga a instalação manual abaixo. Se estiver usando o pacote ZIP, você também pode executar `setup-plugin.bat` e `setup-mcp.bat`.
 
 ---

package/install.ps1

@@ -45,6 +45,11 @@ fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
     }
 }
 
+function Test-LfsPointer($filePath) {
+    if (-not (Test-Path $filePath)) { return $false }
+    return Select-String -Path $filePath -Pattern "git-lfs.github.com/spec/v1" -Quiet
+}
+
 # ── Header ──
 Write-Host ""
 Write-Host "Weppy Roblox MCP Installer" -ForegroundColor White -BackgroundColor DarkCyan
@@ -110,6 +115,12 @@ foreach ($p in $searchPaths) {
 }
 
 if ($bundledPlugin) {
+    if (Test-LfsPointer $bundledPlugin) {
+        Write-Fail "Bundled plugin payload is invalid (Git LFS pointer detected)"
+        Write-Info "Install the plugin from the GitHub release ZIP instead"
+        exit 1
+    }
+
     Write-Host "  → $pluginsDir\$pluginName"
     if (Confirm-Action "  Copy plugin to Roblox Plugins folder?") {
         if (-not (Test-Path $pluginsDir)) {
@@ -131,6 +142,8 @@ else {
 # [3/3] Register MCP with AI apps
 # ═══════════════════════════════════
 Write-Step "3/3" "Register MCP with AI apps"
+Write-Host "  Automatic registration: Claude Code, Claude Desktop, Cursor, Codex CLI, Gemini CLI"
+Write-Host "  Manual setup required: Codex App, Antigravity"
 
 $detectedNames = @()
 $detectedTypes = @()
@@ -273,5 +286,8 @@ Write-Host "  1. Restart Roblox Studio"
 Write-Host "  2. Look for the W-MCP button in the Plugins tab"
 Write-Host "  3. Click Connect and start building with AI!"
 Write-Host ""
+Write-Host "  Auto registration: Claude Code, Claude Desktop, Cursor, Codex CLI, Gemini CLI"
+Write-Host "  Manual setup required: Codex App, Antigravity"
+Write-Host ""
 Write-Host "  Docs: https://github.com/hope1026/weppy-roblox-mcp" -ForegroundColor DarkGray
 Write-Host ""

package/install.sh

@@ -65,6 +65,16 @@ fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
 '
 }
 
+is_lfs_pointer() {
+  local file_path="$1"
+
+  if [ ! -f "$file_path" ]; then
+    return 1
+  fi
+
+  grep -q "git-lfs.github.com/spec/v1" "$file_path"
+}
+
 # ── Header ──
 # shellcheck disable=SC2059
 printf "\n${BOLD}Weppy Roblox MCP Installer${NC}\n"
@@ -94,8 +104,7 @@ step "1/3" "Install @weppy/roblox-mcp via npm"
 
 if confirm "  Run npm install -g @weppy/roblox-mcp?"; then
   if npm install -g @weppy/roblox-mcp; then
-    INSTALLED_VERSION=$(npx -y @weppy/roblox-mcp --version 2>/dev/null || echo "unknown")
-    success "Installed @weppy/roblox-mcp (${INSTALLED_VERSION})"
+    success "Installed @weppy/roblox-mcp"
   else
     fail "npm install failed"
     exit 1
@@ -127,6 +136,12 @@ for search_dir in \
 done
 
 if [ -n "$BUNDLED_PLUGIN" ]; then
+  if is_lfs_pointer "$BUNDLED_PLUGIN"; then
+    fail "Bundled plugin payload is invalid (Git LFS pointer detected)"
+    info "Install the plugin from the GitHub release ZIP instead"
+    exit 1
+  fi
+
   printf "  → %s/%s\n" "$PLUGINS_DIR" "$PLUGIN_NAME"
   if confirm "  Copy plugin to Roblox Plugins folder?"; then
     mkdir -p "$PLUGINS_DIR"
@@ -144,6 +159,8 @@ fi
 # [3/3] Register MCP with AI apps
 # ═══════════════════════════════════
 step "3/3" "Register MCP with AI apps"
+printf "  Automatic registration: Claude Code, Claude Desktop, Cursor, Codex CLI, Gemini CLI\n"
+printf "  Manual setup required: Codex App, Antigravity\n"
 
 MCP_COMMAND='npx -y @weppy/roblox-mcp'
 
@@ -303,5 +320,7 @@ printf "  1. Restart Roblox Studio\n"
 # shellcheck disable=SC2059
 printf "  2. Look for the ${BOLD}W-MCP${NC} button in the Plugins tab\n"
 printf "  3. Click Connect and start building with AI!\n\n"
+printf "  Auto registration: Claude Code, Claude Desktop, Cursor, Codex CLI, Gemini CLI\n"
+printf "  Manual setup required: Codex App, Antigravity\n\n"
 # shellcheck disable=SC2059
 printf "  ${DIM}Docs: https://github.com/hope1026/weppy-roblox-mcp${NC}\n\n"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weppy/roblox-mcp",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "description": "MCP (Model Context Protocol) server for Roblox Studio integration - enables AI coding agents to interact with Roblox Studio in real-time",
   "main": "plugins/weppy-roblox-mcp/dist/index.js",
   "type": "module",

package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "weppy-roblox-mcp",
   "description": "MCP server for Roblox Studio integration - AI-powered game development with specialized agents and skills",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "author": {
     "name": "hope1026"
   },