@weppy/roblox-mcp 0.1.10 → 1.0.0

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Roblox MCP server and tools for AI-powered game development",
-    "version": "0.1.10"
+    "version": "1.0.0"
   },
   "plugins": [
     {
       "name": "weppy-roblox-mcp",
       "source": "./plugins/weppy-roblox-mcp",
       "description": "MCP server for Roblox Studio integration - 132 tools for AI-powered game development with specialized agents and skills",
-      "version": "0.1.10",
+      "version": "1.0.0",
       "author": {
         "name": "hope1026"
       },

package/CHANGELOG.md

@@ -5,6 +5,48 @@ All notable changes to this project will be documented in this file.
 
 
 
+## [1.0.0] - 2026-02-23
+
+### Sync
+
+- Implement bidirectional sync between Studio and local files
+- Add per-type sync direction control for Scripts, Values, Containers, Data, and Services
+- Add per-type apply mode (Auto / Manual) per category
+- Add Full Sync and Resync with local file preservation option
+- Add real-time sync progress tracking and place promotion support
+- Add change history with per-change detail view
+- Add multi-place sync with LRU cache (max 3 places) and isolated storage per place
+- Add reverse rescan to detect missed changes on direction switch
+- Add SyncDirectionCard UI with inline descriptions and hover previews
+- Add PreSyncDialog for pre-sync confirmation and local file handling
+- Refactor sync state management with runtime and default config handling
+
+### MCP Tools
+
+- Add `batch_execute` tool for running multiple commands in one call
+- Add `execute_luau` sandbox with stricter service and path blocking
+- Add tree mutation support for instance rename and move operations
+- Add sibling index support for duplicate-named instances
+- Add per-type sync direction and apply mode to `manage_sync` tool
+- Add `trackToolCall` with action and error type tracking
+- Improve path resolution with robust Roblox path utilities and root confinement
+
+### Stability
+
+- Add comprehensive MCP flow tests and E2E sync test suite
+- Enhance dynamic endpoint handling, reconnection logic, and error resilience
+- Fix tooltip positioning in widget-local space
+- Refactor settings UI with categories and tooltips
+- Improve AI client detection and connection info display
+
+
+## [0.1.11] - 2026-02-14
+
+### Other Changes
+
+- Improve stability
+
+
 ## [0.1.10] - 2026-02-11
 
 ### Bug Fixes
@@ -16,21 +58,21 @@ All notable changes to this project will be documented in this file.
 
 ### Other Changes
 
-- update test
-- refactor: improve stability
+- Improve stability
 
 
 ## [0.1.8] - 2026-02-08
 
 ### Fix
-- improve stability
+- Improve stability
 
 
 ## [0.1.3] - 2026-02-07
 
 ### Features
-- add tool history and statistics tracking system
-- add version info display in plugin UI
+- Add tool history and statistics tracking system
+- Add version info display in plugin UI
+
 
 ## [0.1.2] - 2026-02-03
 
@@ -41,9 +83,8 @@ All notable changes to this project will be documented in this file.
 
 First public release of Roblox MCP - AI-powered Roblox Studio integration.
 
-#### 140 Tools Available
+#### Basic
 
-**Basic (68 tools)**
 - Create, delete, clone, and move parts and models
 - Write and edit scripts with AI assistance
 - Change properties like color, size, and position
@@ -52,7 +93,8 @@ First public release of Roblox MCP - AI-powered Roblox Studio integration.
 - Control camera view and focus
 - View output logs and debug errors
 
-**Pro (72 tools)**
+#### Pro
+
 - Bulk operations - create or modify hundreds of objects at once
 - Search and insert models from Creator Store
 - Environment controls - lighting, weather, time of day
@@ -63,8 +105,8 @@ First public release of Roblox MCP - AI-powered Roblox Studio integration.
 #### Highlights
 
 - **Real-time Studio control** - AI commands execute instantly in Roblox Studio
-- **Works with popular AI apps** - Claude, Cursor, Codex CLI, Gemini CLI, and more
+- **Works with popular AI apps** - Claude, Codex CLI, Gemini CLI, and more
 - **Secure by design** - Localhost only, no external network access
-- **Basic tier included** - 68 essential tools free forever
+- **Basic tier included** - Essential tools, free forever
 
 [0.1.0]: https://github.com/hope1026/roblox-mcp/releases/tag/v0.1.0

package/README.md

@@ -53,6 +53,12 @@ Installation is complete in two steps:
 
 Takes just 5 minutes. 👉 [View Installation Guide](docs/en/installation/README.md)
 
+## Go Pro
+
+Build without limits. Bidirectional Sync, advanced build capabilities, and AI token efficiency — all in one upgrade.
+
+👉 [Pro Upgrade Guide](docs/en/pro-upgrade.md)
+
 ## Links
 
 - [GitHub](https://github.com/hope1026/roblox-mcp)

package/docs/en/installation/ai-apps/gemini-cli.md

@@ -18,7 +18,23 @@ How to use Roblox MCP with [Google Gemini CLI](https://github.com/google-gemini/
 
 ## Register MCP Server
 
-### Method 1: Edit Configuration File (Recommended)
+### Method 1: CLI Command (Recommended)
+
+Register with a single command in your terminal:
+
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -- -y @weppy/roblox-mcp
+```
+
+> The `--trust` flag skips confirmation prompts for each tool call.
+
+To register globally, add `-s user`:
+
+```bash
+gemini mcp add weppy-roblox-mcp npx -s user --trust -- -y @weppy/roblox-mcp
+```
+
+### Method 2: Edit Configuration File
 
 Add the following content to `.gemini/settings.json`:
 
@@ -39,10 +55,16 @@ Add the following content to `.gemini/settings.json`:
 | Project | `<project>/.gemini/settings.json` |
 | Global | `~/.gemini/settings.json` |
 
-### Method 2: Using Environment Variables
+### Method 3: Using Environment Variables
 
 If specific environment variables are needed:
 
+**CLI:**
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -e MCP_PORT=3002 -- -y @weppy/roblox-mcp
+```
+
+**Configuration file:**
 ```json
 {
   "mcpServers": {
@@ -73,35 +95,6 @@ You can check connected server status with the `/mcp` command in Gemini CLI:
 /mcp
 ```
 
-## Advanced Configuration
-
-### Tool Filtering
-
-You can include or exclude specific tools:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "excludeTools": ["execute_script"],
-      "includeTools": ["get_selection", "create_instance", "set_property"]
-    }
-  }
-}
-```
-
-> `excludeTools` takes precedence over `includeTools`.
-
-### Debug Mode
-
-To debug connection issues:
-
-```bash
-gemini --debug
-```
-
 ## Troubleshooting
 
 ### Server won't start

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

@@ -4,8 +4,13 @@ How to install the plugin to connect AI agents with Roblox Studio.
 
 ## 1. Download Plugin
 
-1. Download `weppy-roblox-mcp-basic-v{version}.zip` from [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
-2. Extract the ZIP file — you'll find the `roblox-plugin/WeppyRobloxMCP.rbxm` file and setup guides inside
+1. Open [GitHub Releases](https://github.com/hope1026/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
 
 ## 2. Install Plugin
 
@@ -42,15 +47,15 @@ The MCP server must be installed. Complete the guide for your AI app first:
 ### Connecting
 
 1. Open any project in **Roblox Studio**
-2. Go to **Plugins** tab → **W-MCP**
+2. Go to **Plugins** tab -> **W-MCP**
 3. Click the **Connect** button in the plugin window
-4. Once **"Connected"** status is displayed, you're ready!
+4. Once **"Connected"** status is displayed, you're ready
 
 ![Plugin Main Screen](../../assets/screenshots/plugin_main.png)
 
 ## 5. Settings (Optional)
 
-Click the settings button in the top right of the plugin to change various options.
+Click the settings button in the top right of the plugin to change options.
 
 ![Settings Screen](../../assets/screenshots/settings.png)
 

package/docs/en/pro-upgrade.md

@@ -2,50 +2,56 @@
 
 ## Why Pro?
 
-**Save AI Tokens** - One bulk command replaces dozens of individual operations. Less back-and-forth means lower token usage and faster results.
+### Bidirectional Sync built for real development workflows
 
-**Build Complete Games** - Terrain, environment, assets, and spatial tools let you create polished game worlds, not just prototypes.
+Pro Sync goes beyond one-way export. Edit scripts locally and push them to Studio. Make changes in Studio and pull them back to disk. Pro keeps both sides in sync.
 
-## What Pro Unlocks
+- **Bidirectional Sync** — Changes flow in both directions between Studio and local files.
+- **Per-type Direction** — Set direction independently for Scripts, Values, Containers, Data, and Services.
+- **Per-type Apply Mode** — Choose Auto or Manual per type to balance speed and control.
+- **Full Sync / Resync** — Rebuild clean project state on demand after large changes or reconnects.
+- **Change History** — Track what changed, when, and in which direction before applying.
+- **Multi-place Sync** — Sync up to 3 Roblox Places simultaneously, each with isolated storage and its own change history.
 
-| Category | What you can do |
-|----------|-----------------|
-| **Bulk Operations** | Create 100 trees with one command. Modify all parts at once. |
-| **Terrain Generation** | Generate mountains, caves, and landscapes procedurally. |
-| **Asset Management** | Search Creator Store and insert models directly. |
-| **Raycast & Spatial** | Find spawn positions, detect collisions, analyze walkable areas. |
-| **Environment Control** | Set lighting, atmosphere, sky, and time of day. |
-| **Visualization** | Show areas, create markers, highlight regions. |
+### Save AI tokens with high-leverage workflows
 
-## How to Purchase
+Bulk and advanced actions reduce repetitive round trips — do more per prompt.
 
-### Step 1: Buy on Gumroad
+### Broader advanced capabilities
 
-1. Go to [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin)
-2. Download the plugin
+Terrain generation, asset search, spatial analysis, animation, audio, and production-scale automation.
 
-### Step 2: Install Plugin
+## Subscription & Download
 
-1. Open Roblox Studio
-2. Go to Plugins tab → **Plugins Folder**
-3. **Delete** the existing `WeppyRobloxMCP.rbxm` (Basic version)
-4. **Copy** the downloaded `WeppyRobloxMCP-Pro.rbxm` into the folder
-5. Restart Roblox Studio
+### Step 1: Subscribe on Gumroad
+
+1. Go to [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/faccjs?utm_source=github&utm_medium=repo&utm_campaign=pro_upgrade_md)
+2. Complete your Pro subscription license purchase
+
+### Step 2: Download from GitHub Releases
+
+1. Open [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+2. Download `weppy-roblox-mcp-v{version}.zip`
+3. Extract and copy `roblox-plugin/WeppyRobloxMCP.rbxm` to your Roblox Plugins folder
 
 ### Step 3: Verify
 
-1. Open the W-MCP plugin
-2. Check that "Pro" badge is displayed
-3. All tools are now available!
+1. Open W-MCP in Roblox Studio
+2. Confirm the Pro badge is visible
+3. Run a Pro action (for example: `manage_sync` or bulk operations)
 
 ## Feature Comparison
 
 | Feature | Basic | Pro |
 |---------|:-----:|:---:|
-| Instance, Script, Property | ✅ Full access | ✅ Full access |
+| Script, Instance, Property management | ✅ Full access | ✅ Full access |
 | Selection, Tag, Camera, Log | ✅ Full access | ✅ Full access |
-| Bulk Operations | ― | ✅ Unlimited |
-| Asset Search & Insert | ― | ✅ Unlimited |
-| Terrain Generation | ― | ✅ Unlimited |
-| Environment, Raycast, Spatial | ― | ✅ Unlimited |
-| Visualization Tools | ― | ✅ Unlimited |
+| Sync Direction | Studio → Local (one-way) | Bidirectional |
+| Per-type Sync Direction | ❌ | ✅ Scripts / Values / Containers / Data / Services |
+| Per-type Apply Mode | ❌ | ✅ Auto / Manual |
+| Full Sync | ❌ | ✅ |
+| Resync / Rebuild state | ❌ | ✅ |
+| Change History | ❌ | ✅ |
+| Multi-place Sync | ❌ | ✅ Up to 3 places, each with isolated storage |
+| Advanced tool coverage | Core set | Broader advanced set |
+| AI token efficiency | Standard | Better with bulk / high-leverage actions |