@weppy/roblox-mcp 2.5.0 → 2.6.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.5.0"
+    "version": "2.6.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.5.0",
+      "version": "2.6.0",
       "author": {
         "name": "hope1026"
       },

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

@@ -19,10 +19,24 @@ jobs:
       - name: Install Claude Code CLI (app detection용)
         run: npm install -g @anthropic-ai/claude-code
 
-      - name: Run install.sh (CI mode)
+      - name: Pre-seed Codex config (force is_codex_config_configured node path)
+        run: |
+          mkdir -p "$HOME/.codex"
+          cat > "$HOME/.codex/config.toml" <<'EOF'
+          [mcp_servers.dummy-server]
+          command = "echo"
+          args = ["hello"]
+          EOF
+
+      - name: Run install.sh (CI mode, pipe — simulates curl | bash)
         env:
           CI: true
-        run: bash install.sh
+        run: |
+          cat install.sh | bash 2>&1 | tee install-output.log
+          if grep -q 'SyntaxError' install-output.log; then
+            echo "❌ SyntaxError detected in install output"
+            exit 1
+          fi
 
       - name: Verify — plugin file exists
         run: |
@@ -43,6 +57,15 @@ jobs:
           fi
           echo "✓ weppy-roblox-mcp registered"
 
+      - name: Verify — Codex config registered
+        run: |
+          if ! grep -q '\[mcp_servers.weppy-roblox-mcp\]' "$HOME/.codex/config.toml"; then
+            echo "❌ weppy-roblox-mcp not found in ~/.codex/config.toml"
+            cat "$HOME/.codex/config.toml"
+            exit 1
+          fi
+          echo "✓ weppy-roblox-mcp registered in Codex config"
+
   test-powershell:
     name: E2E — install.ps1 (windows)
     runs-on: windows-latest
@@ -56,11 +79,28 @@ jobs:
       - name: Install Claude Code CLI (app detection용)
         run: npm install -g @anthropic-ai/claude-code
 
-      - name: Run install.ps1 (CI mode)
+      - name: Pre-seed Codex config (force Test-CodexConfigConfigured node path)
+        shell: pwsh
+        run: |
+          $codexDir = Join-Path $env:USERPROFILE '.codex'
+          New-Item -ItemType Directory -Path $codexDir -Force | Out-Null
+          @'
+          [mcp_servers.dummy-server]
+          command = "echo"
+          args = ["hello"]
+          '@ | Set-Content -Path (Join-Path $codexDir 'config.toml') -Encoding UTF8
+
+      - name: Run install.ps1 (CI mode, pipe — simulates irm | iex)
         env:
           CI: true
         shell: pwsh
-        run: pwsh install.ps1
+        run: |
+          $log = Join-Path $env:RUNNER_TEMP 'install-output.log'
+          Get-Content install.ps1 -Raw | Invoke-Expression *>&1 | Tee-Object -FilePath $log
+          if (Select-String -Path $log -Pattern 'SyntaxError' -Quiet) {
+            Write-Error "❌ SyntaxError detected in install output"
+            exit 1
+          }
 
       - name: Verify — plugin file exists
         shell: pwsh
@@ -87,3 +127,14 @@ jobs:
             exit 1
           }
           Write-Host "✓ weppy-roblox-mcp registered"
+
+      - name: Verify — Codex config registered
+        shell: pwsh
+        run: |
+          $codexConfig = Join-Path $env:USERPROFILE '.codex\config.toml'
+          if (-not ((Get-Content $codexConfig -Raw) -match '\[mcp_servers\.weppy-roblox-mcp\]')) {
+            Write-Error "❌ weppy-roblox-mcp not found in ~/.codex/config.toml"
+            Get-Content $codexConfig
+            exit 1
+          }
+          Write-Host "✓ weppy-roblox-mcp registered in Codex config"

package/CHANGELOG.md

@@ -3,13 +3,38 @@
 All notable changes to this project will be documented in this file.
 
 
+## [2.6.0] - 2026-04-15
 
+### Features
+
+- **Edit-mode screen capture** — AI agents can now capture the Studio viewport directly in Edit mode, so they can see what you see and give feedback on layout, lighting, and placement without entering Playtest.
+- **German (Deutsch) language support** — The dashboard and plugin are now fully available in German. Switch to Deutsch from Settings → Language.
+
+### Stability
+
+- **Improved overall stability** — Tool execution, error messages, sync operations, and the dashboard "What's New" page have all been hardened for a smoother, more reliable experience.
+
+
+## [Unreleased]
+
+### ⚠️ BREAKING CHANGES
 
+- **Legacy sync folder names removed from spec and runtime** — `roblox-project-sync` (the pre-rebrand folder name) is no longer recognized by the MCP server, dashboard, Explorer extension, or playtest/test-report writers. Users who still had sync data under `roblox-project-sync/` must manually rename the folder to `weppy-project-sync/`. The `wrox-project-sync` → `weppy-project-sync` one-shot copy migration remains in place as transitional compat code for users upgrading from v2.5.x but is no longer part of the spec and will be removed in a future release.
 
 
 
 
 
+
+
+
+## [2.5.1] - 2026-04-12
+
+### Bug Fixes
+
+- **Fix installer failing when run from a directory with a local `@weppy/roblox-mcp` package** — If the install script was executed from a folder where `@weppy/roblox-mcp` was already present (for example inside the package itself or under a parent `node_modules`), `npx` could pick up the shadowed local copy instead of fetching the published release, causing setup to misbehave or fail. The installer now runs `npx` inside an isolated temporary working directory, so it always resolves and installs the latest published version regardless of where you run it from.
+
+
 ## [2.5.0] - 2026-04-12
 
 ### ⚠️ BREAKING CHANGES

package/README.md

@@ -1,18 +1,18 @@
-# Roblox MCP — MCP Server for Roblox Studio | AI Game Development with Claude, Codex, Cursor & Gemini
+# Roblox MCP - MCP Server for Roblox Studio | AI Game Development with Claude, Codex, Cursor & Gemini
 
-> **WEPPY** is an MCP server that lets AI coding agents control a live Roblox Studio session — create and edit scripts, instances, terrain, lighting, assets, audio, and animations via natural language.
+> **WEPPY** is an MCP server that lets AI coding agents control a live Roblox Studio session - create and edit scripts, instances, terrain, lighting, assets, audio, and animations through natural language.
 
 **Action-based tool surface · Bidirectional sync · Automated playtest · Multi-place support**
 
-**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)
+**English** | [한국어](https://weppyai.com/ko/docs) | [日本語](https://weppyai.com/ja/docs) | [Español](https://weppyai.com/es/docs) | [Português](https://weppyai.com/pt-br/docs) | [Bahasa Indonesia](https://weppyai.com/id/docs) | [Deutsch](https://weppyai.com/de/docs)
 
-[![Demo — AI building a Roblox game in real time](https://img.youtube.com/vi/puQB4u1VlMw/maxresdefault.jpg)](https://youtu.be/puQB4u1VlMw)
+[![Demo - AI building a Roblox game in real time](https://img.youtube.com/vi/puQB4u1VlMw/maxresdefault.jpg)](https://youtu.be/puQB4u1VlMw)
 
 ## Why WEPPY (Weppy Roblox MCP)?
 
-AI coding agents like Claude, Codex, and Gemini are powerful — but they cannot see or modify anything inside Roblox Studio. The DataModel, scripts, terrain, and lighting are all invisible to external tools. Without a bridge, AI can only generate code snippets that you must paste manually.
+AI coding agents like Claude, Codex, and Gemini are powerful, but they cannot see or modify anything inside Roblox Studio. The DataModel, scripts, terrain, and lighting are invisible to external tools. Without a bridge, AI can only generate code snippets that you must paste manually.
 
-**WEPPY** is a bridge between AI agents and Roblox Studio. AI directly creates and modifies instances, scripts, properties, terrain, and more inside Studio, and the changes are reflected immediately in Studio and the dashboard so you can **see exactly what changed**.
+**WEPPY** bridges AI agents and Roblox Studio. AI directly creates and modifies instances, scripts, properties, terrain, and more inside Studio, and the changes are reflected immediately in Studio and the dashboard so you can see exactly what changed.
 
 No copy-pasting code. AI does the work, you review the results.
 
@@ -40,30 +40,23 @@ irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1
 
 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**.
+Automatic MCP registration supports Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI, and Antigravity.
 
 ### Manual Install
 
 If the one-line install does not work, or automatic installation is not available in your environment:
 
-**Step 1** — Install the Roblox Studio plugin:
-[Plugin Installation Guide](docs/en/installation/roblox-plugin.md)
+**Step 1** - Use the web install page for the Roblox Studio plugin and app-specific setup.
 
-**Step 2** — Register the MCP server with your AI app:
+👉 **[Web Install Docs](https://weppyai.com/ko/docs)**
+
+**Step 2** - Register the MCP server with your AI app:
 
 ```bash
 npx -y @weppy/roblox-mcp
 ```
 
-| AI App | Guide |
-|--------|-------|
-| 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) |
-| Antigravity | [Setup](docs/en/installation/ai-apps/antigravity.md) |
+Supported AI apps are Claude Code, Claude Desktop, Cursor, Codex CLI, Codex App, Gemini CLI, and Antigravity.
 
 > Any MCP-compatible AI client works. The server command is `npx -y @weppy/roblox-mcp`.
 
@@ -94,7 +87,7 @@ AI works from a synchronized local mirror, so multi-file updates stay consistent
 - Basic: one-way sync (Studio -> Local)
 - Pro: bidirectional sync + per-type Direction/Apply Mode + history + multi-place
 
-![Sync workflow — Studio and local files synchronized in real time](docs/assets/screenshots/plugin/sync/sync-overview.png)
+![Sync workflow - Studio and local files synchronized in real time](docs/assets/screenshots/plugin/sync/sync-overview.png)
 
 ### 3) Playtest: Let AI run and verify tests automatically
 
@@ -104,7 +97,7 @@ 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."
 
-![WEPPY Playtest Dashboard — Test history and detailed report](docs/assets/screenshots/dashboard/dashboard_playtest.png)
+![WEPPY Playtest Dashboard - Test history and detailed report](docs/assets/screenshots/dashboard/dashboard_playtest.png)
 
 ### 4) WEPPY Dashboard: Monitor AI work in real time
 
@@ -114,11 +107,11 @@ The MCP server provides a web dashboard where you can check connection status, t
 - Compare every change the AI made via Before & After in Changelog
 - Analyze workflow with tool execution history and statistics
 
-![WEPPY WEPPY Dashboard Overview — Server status, recent changes, and session summary](docs/assets/screenshots/dashboard/dashboard_overview.png)
+![WEPPY Dashboard Overview - Server status, recent changes, and session summary](docs/assets/screenshots/dashboard/dashboard_overview.png)
 
 ### 5) WEPPY Roblox Explorer: Browse Studio hierarchy in VSCode
 
-View the full instance tree of your Roblox Studio place directly inside VSCode. Navigate services, open synced scripts and property files, and track sync status — all without switching to Studio.
+View the full instance tree of your Roblox Studio place directly inside VSCode. Navigate services, open synced scripts and property files, and track sync status - all without switching to Studio.
 WEPPY Roblox Explorer is a companion VSCode extension for sync data generated by WEPPY. Tree browsing works from synced files, and live sync state or direction indicators are enhanced when the local MCP server is running.
 Install from [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer) or [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer).
 
@@ -126,13 +119,13 @@ Install from [VS Code Marketplace](https://marketplace.visualstudio.com/items?it
 - Click to open synced scripts and property files
 - Multi-place support with sync status indicators
 
-![WEPPY Roblox Explorer — Studio instance tree displayed in VSCode sidebar](docs/assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+![WEPPY Roblox Explorer - Studio instance tree displayed in VSCode sidebar](docs/assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 
 ## Use Cases
 
 - **Rapid prototyping**: Describe a game mechanic in natural language and watch AI build it in Studio
 - **Bulk refactoring**: Rename a module interface and update every dependent script in one request
-- **Terrain & environment**: Generate procedural terrain, set lighting/atmosphere, place assets — all from a single prompt
+- **Terrain & environment**: Generate procedural terrain, set lighting/atmosphere, place assets - all from a single prompt
 - **Multi-file consistency**: AI reads the full project via Sync and applies changes across related scripts together
 - **Asset integration**: Search the Creator Store, insert models, and configure properties without leaving your editor
 
@@ -145,39 +138,30 @@ Install from [VS Code Marketplace](https://marketplace.visualstudio.com/items?it
 
 ## Docs
 
-- [Installation Guide](docs/en/installation/README.md)
-- [Tools Reference](docs/en/tools/overview.md)
-- [Sync Deep Dive](docs/en/sync/overview.md)
-- [WEPPY Dashboard Guide](docs/en/dashboard/overview.md)
-- [WEPPY Roblox Explorer (VSCode Extension)](docs/en/installation/roblox-explorer.md)
-- [Compatibility](docs/compatibility.md)
-- [Troubleshooting](docs/troubleshooting.md)
+Detailed guides and app-specific setup now live on the web.
 
-### Workflow Guides
+- [Web Docs Hub](https://weppyai.com/ko/docs)
+- [Install Guide](https://weppyai.com/en/install)
+- [Pro Upgrade](https://weppyai.com/en/plans)
 
-- [Instances & Properties](docs/en/tools/instances-and-properties.md) - search, creation, editing, tags
-- [Scripting & Code Execution](docs/en/tools/scripting.md) - script management and Luau execution
-- [World & Environment](docs/en/tools/world-and-environment.md) - lighting, terrain, camera
-- [Assets & Effects](docs/en/tools/assets-and-effects.md) - asset insertion, tweening, effects
-- [Playtest & Automated Tests](docs/en/tools/playtest.md) - playtest control and automated validation
-- [System & Debugging](docs/en/tools/system-and-debugging.md) - connection, logs, batch execution
+For app setup details, open the web docs hub and choose the relevant AI client guide.
 
 ## FAQ
 
 ### How do I connect Claude Code to Roblox Studio?
-Install the Roblox Studio plugin, then register the MCP server (`npx -y @weppy/roblox-mcp`) in Claude Code. Claude can then directly read and write scripts inside Studio. See [Claude Code Setup](docs/en/installation/ai-apps/claude-code.md).
+Install the Roblox Studio plugin, then register the MCP server (`npx -y @weppy/roblox-mcp`) in Claude Code. Claude can then directly read and write scripts inside Studio.
 
 ### How do I use Codex CLI with Roblox Studio?
-Install the plugin, then add the MCP server config to Codex CLI. See [Codex CLI Setup](docs/en/installation/ai-apps/codex-cli.md).
+Install the plugin, then add the MCP server config to Codex CLI.
 
 ### Does Roblox MCP work with Cursor?
-Yes. See [Cursor Setup](docs/en/installation/ai-apps/cursor.md). Any MCP-compatible AI client works.
+Yes. 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.
+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](https://weppyai.com/en/plans).
+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 page.
 
 ### 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.
@@ -187,7 +171,7 @@ The server runs on localhost only (127.0.0.1:3002). Forbidden paths (CoreGui, Co
 
 ## Pro Upgrade
 
-Bidirectional Sync, advanced build capabilities, and AI token efficiency — all in one upgrade.
+Bidirectional Sync, advanced build capabilities, and AI token efficiency - all in one upgrade.
 
 [Pro Upgrade Guide](https://weppyai.com/en/plans)
 

package/SUPPORT.md

@@ -2,12 +2,10 @@
 
 ## Documentation
 
-- [Installation Guide](docs/en/installation/README.md)
-- [Tools Reference](docs/en/tools/overview.md)
-- [Sync Deep Dive](docs/en/sync/overview.md)
-- [Roblox Explorer (VSCode Extension)](docs/en/installation/roblox-explorer.md)
-- [Compatibility](docs/en/compatibility.md)
-- [Troubleshooting](docs/en/troubleshooting.md)
+- [Web Docs Hub](https://weppyai.com/ko/docs)
+- [Install Page](https://weppyai.com/en/install)
+- [Pro Upgrade](https://weppyai.com/en/plans)
+- [Roblox Explorer (VSCode Extension)](https://weppyai.com/ko/docs)
 
 ## Community Help
 

package/install.ps1

@@ -168,7 +168,7 @@ function Test-CodexConfigConfigured($configPath) {
 
     $env:MCP_CODEX_CONFIG_PATH = $configPath
     try {
-        node --input-type=commonjs -e @'
+        @'
 const fs = require('fs');
 
 const configPath = process.env.MCP_CODEX_CONFIG_PATH;
@@ -301,7 +301,7 @@ function findAllCodexBlocks(source) {
 }
 
 function parseStringAssignment(value, key) {
-  const match = new RegExp('^\\s*' + key + '\\s*=\\s*(["\\'])([^"\\']+)\\1\\s*$').exec(value);
+  const match = new RegExp('^\\s*' + key + '\\s*=\\s*(["\'])([^"\']+)\\1\\s*$').exec(value);
   return match ? match[2] : null;
 }
 
@@ -575,7 +575,7 @@ try {
 } catch {
   process.exit(1);
 }
-'@
+'@ | node --input-type=commonjs
         return $LASTEXITCODE -eq 0
     }
     finally {
@@ -635,11 +635,24 @@ if (Confirm-Action "  Run npx -y @weppy/roblox-mcp --setup?") {
         if (-not (Test-Path $npxPath)) {
             $npxPath = "npx"
         }
-        & $npxPath -y --package=@weppy/roblox-mcp weppy-roblox-mcp --setup
-        if ($LASTEXITCODE -ne 0) {
-            Write-Warn "Setup encountered a warning (non-blocking)"
-        } else {
-            Write-Ok "Setup complete"
+        $setupWorkingDir = Join-Path ([System.IO.Path]::GetTempPath()) ("weppy-setup-" + [System.Guid]::NewGuid().ToString("N"))
+        $previousLocation = Get-Location
+
+        try {
+            New-Item -ItemType Directory -Path $setupWorkingDir -Force | Out-Null
+            Set-Location $setupWorkingDir
+            # stdin을 빈 파이프로 격리: irm|iex 대화형 모드에서 stdio MCP 서버가
+            # pwsh의 터미널 stdin을 상속받아 hang되는 문제를 방지한다
+            $null | & $npxPath -y @weppy/roblox-mcp --setup
+            if ($LASTEXITCODE -ne 0) {
+                Write-Warn "Setup encountered a warning (non-blocking)"
+            } else {
+                Write-Ok "Setup complete"
+            }
+        }
+        finally {
+            Set-Location $previousLocation
+            Remove-Item $setupWorkingDir -Recurse -Force -ErrorAction SilentlyContinue
         }
     }
     catch {
@@ -879,7 +892,7 @@ Write-Host "  3. Click Connect and start building with AI!"
 Write-Host ""
 Write-Host "  Auto registration: Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI, Antigravity"
 Write-Host ""
-Write-Host "  Docs: https://github.com/hope1026/weppy-roblox-mcp" -ForegroundColor DarkGray
+Write-Host "  Docs: https://weppyai.com/en/install" -ForegroundColor DarkGray
 Write-Host ""
 
 Stop-InstallTranscript

package/install.sh

@@ -641,10 +641,25 @@ success "Node.js $(node -v) detected"
 step "1/2" "Setup Roblox Studio Plugin"
 
 if confirm "  Run npx -y @weppy/roblox-mcp --setup?"; then
-  if npx -y --package=@weppy/roblox-mcp weppy-roblox-mcp --setup; then
-    success "Setup complete"
+  setup_tmp_dir=""
+  if setup_tmp_dir=$(mktemp -d "${TMPDIR:-/tmp}/weppy-setup-XXXXXX" 2>/dev/null); then
+    :
+  elif setup_tmp_dir=$(mktemp -d 2>/dev/null); then
+    :
+  fi
+
+  if [ -n "${setup_tmp_dir:-}" ] && [ -d "$setup_tmp_dir" ]; then
+    # stdin을 /dev/null로 격리: curl|bash 파이프 모드에서 stdio MCP 서버가
+    # bash의 남은 스크립트 바이트를 소비해버리는 문제를 방지한다
+    if (cd "$setup_tmp_dir" && npx -y @weppy/roblox-mcp --setup </dev/null); then
+      success "Setup complete"
+    else
+      warn "Setup encountered a warning (non-blocking)"
+    fi
+
+    rm -rf "$setup_tmp_dir"
   else
-    warn "Setup encountered a warning (non-blocking)"
+    warn "Setup encountered a warning (failed to create temp working directory)"
   fi
 else
   warn "Setup skipped"
@@ -876,4 +891,4 @@ printf "  2. Look for the ${BOLD}WEPPY${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/App, Gemini CLI, Antigravity\n\n"
 # shellcheck disable=SC2059
-printf "  ${DIM}Docs: https://github.com/hope1026/weppy-roblox-mcp${NC}\n\n"
+printf "  ${DIM}Docs: https://weppyai.com/en/install${NC}\n\n"