hope1026/weppy-roblox-mcp releases

⚠️ BREAKING CHANGES

• Project sync folder renamed (wrox-project-sync → weppy-project-sync) — As part of the wrox → weppy rebrand, the default project sync root and the app data directory have been renamed (.wrox-data → .weppy-data). Existing folders are automatically copied to the new location on first launch — no manual migration is required, and your synced files are preserved. The legacy folder is left in place with a .weppy-legacy-path.json marker so you can clean it up at your convenience.

Features

• Property Panel for VSCode Explorer — A new dedicated property panel inside the WEPPY Explorer lets you inspect and edit Roblox instance properties directly from VSCode, without switching back to Studio. Open any instance and you get a Studio-style editor with grouped categories, dropdowns for enum properties, an expandable CFrame editor for position and orientation, per-property tooltips, and dedicated Tags and Attributes sections. Property values stay live with Studio, so edits in VSCode are reflected immediately and vice versa.

Bug Fixes

• Fix installer failing on Node.js 24 — Running the install script (install.sh / install.ps1) on Node.js 24 previously failed with module-type errors and never finished setup. The installer now works correctly across Node 18, 20, 22, and 24, so users on the latest Node.js can install WEPPY without downgrading.
• Fix Property Panel appearing blank in the published Explorer extension — The Property Panel rendered correctly in development but showed up blank when the WEPPY Explorer extension was installed from the VSCode Marketplace. The panel now displays properly in the published extension.

⚠️ 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.

⚠️ BREAKING CHANGES

• Sync directory renamed: roblox-project-sync/ → wrox-project-sync/. All existing sync data will be stored under the new directory. The old roblox-project-sync/ directory is no longer used.
• App data directory renamed: ~/.weppy-roblox-mcp → ~/.wrox-data. The old ~/.weppy-roblox-mcp directory is no longer recognized.
• Project sync resets from Studio: After upgrading, project sync data is re-initialized from Studio as the source of truth. Any local-only changes not yet synced back to Studio will be lost — ensure your Studio state is up to date before upgrading.
• License downgrade requires plugin action: If your license changes from Pro to Basic, you must click "Refresh" in the plugin UI or deactivate and reactivate the plugin for the tier change to take effect. Without this step, the plugin may continue to report the previous tier.

Features

• Dashboard project root switching: Added the ability to change the project root directory directly from the Dashboard overview page, with restart and path migration support.
• Dashboard Place UI improvements: Redesigned the Place summary display for better visual clarity and usability.
• Dashboard place summary API and persistence for active project state
• Sync root switch flow with configurable overrides and path migration

Bug Fixes

• Harden sync-root switching with error handling and fallback resolution
• Preserve and surface dashboard sync-root restart errors
• Normalize observability sync roots and honor override root in runtime paths
• Cover remaining wrox runtime paths

Documentation

• Expand documentation with project rationale, use cases, FAQ, and license details across all locales
• Update sync data path documentation to reflect project-root-based storage

MCP Server / Plugin

BREAKING CHANGES

• ZIP users: Package directory structure has changed. You must re-run setup-mcp.sh (or setup-mcp.bat). The MCP server path in .mcp.json has moved from mcp-server/index.js to plugins/weppy-roblox-mcp/dist/index.js.

Highlights

• Built-in Dashboard: The MCP server now includes an embedded dashboard. Access it at http://127.0.0.1:3002/dashboard — no extra setup required for npm or ZIP installs.
• Unified deploy structure: npm, ZIP, and local dev environments all share the same plugins/weppy-roblox-mcp/dist/index.js runtime layout.

Features

• Built-in dashboard with 7 pages: Overview, Connection, Tools, Sync, Changelog, Playtest, Settings
• Multi-language support (en, ko) with auto-detection
• Real-time SSE updates for connection status and license changes
• Unified tool and sync changelog extraction
• Sync apply modes (auto/manual per content type)

Bug Fixes

• Unified MCP server path across all setup scripts and guides (6 languages)
• Tooltip clipping at viewport edges

Breaking Changes

• Sync file format now uses nested directory structure for all objects — each instance is represented as its own directory (e.g., Part/Part.props.json instead of flat files)
• Duplicate sibling instances are now distinguished using ~N suffix encoding (Odd-Count Tilde Rule) — e.g., Part~1/, Part~2/, Part~3/
• Existing sync data will be regenerated automatically (no migration from v1)

Improvements

• Enhance sync stability and performance for bidirectional file synchronization
• Improve sync child indexing and collision handling
• Refine analytics tracking for tool usage

Bug Fixes

• Improve error handling and resilience during MCP tool execution
• Fix license token cache and Pro auth flow issues
• Resolve sync errors on concurrent file changes
• Fix duplicated instance name handling in sync index
• Fix various edge cases in sync change processing

Plugin

• Improve plugin icons and UI refinements
• Clean up unused files and modules
• General plugin stability improvements