@weppy/roblox-mcp 0.1.11 → 1.0.1

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Roblox MCP server and tools for AI-powered game development",
-    "version": "0.1.11"
+    "version": "1.0.1"
   },
   "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.11",
+      "version": "1.0.1",
       "author": {
         "name": "hope1026"
       },

package/CHANGELOG.md

@@ -5,6 +5,49 @@ All notable changes to this project will be documented in this file.
 
 
 
+
+## [1.0.1] - 2026-02-23
+
+### Other Changes
+
+- refactor: standardize data directory path logic across modules
+
+
+## [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
@@ -23,21 +66,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
 
@@ -48,9 +91,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
@@ -59,7 +101,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
@@ -70,8 +113,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

@@ -8,41 +8,65 @@
 
 ## What You Can Do
 
-### Create Complete Games
+### From One Idea to a Playable Game
 
-Just ask "Make a Minecraft-style survival game" or "Create an escape room puzzle game", and AI will design the game structure, build the map, create objects, and write scripts for you. Turn a simple idea into a playable game.
+"Make a Minecraft-style survival game with day/night, crafting, and wave defense." — One sentence and AI designs the game structure, builds the map, creates objects, and writes every script.
 
 > **Tip**: Ask "Make a plan first", review it, then say "Execute it" for better results.
 
-### Create and Place Objects
+### An AI That Has Read Your Entire Project
 
-Say "Make a red brick house" or "Plant 10 trees in a row" and AI creates them directly in Roblox Studio. Create one object or hundreds at once.
+AI syncs your Roblox project to local files, learning every script, object, and structure. Dozens of files understood at once, changed consistently.
 
-### Write and Modify Scripts
+- "Find every place that uses RemoteEvents and map out the call flow."
+- "Refactor all enemy AI scripts to use a unified state machine."
+- "Summarize only the risky changes made since yesterday."
 
-Ask "Make particles appear when players jump" or "Find the bug in this script" and AI writes and fixes code for you. It analyzes existing scripts and understands dependencies too.
+Manage multiple Places simultaneously. Track the full history of changes.
 
-### Set Scene Atmosphere
+### Scripts: Write, Refactor, Debug — Across Related Files
 
-Just say "Change to sunset vibes" or "Make it dark like a rainy day" and AI automatically adjusts lighting, sky, and fog.
+Not just the file you point at. AI handles the whole dependency chain.
 
-### Generate Terrain
+- "When the player jumps, add particles, a sound, and a cooldown."
+- "Find all event connections that could leak memory and fix them safely."
+- "Change this module's interface and update every script that references it."
 
-Create natural landscapes like mountains, rivers, plains, and caves through conversation. Customize materials, colors, and sizes freely.
+### Build and Place Objects — Hundreds at Once
 
-### Search and Insert Assets
+"Line up 50 street lights along this road", "Place 20 brick houses across the district with random rotations" — AI creates them directly in Studio. Batch-update properties across any number of objects with a single command.
 
-Search the Creator Store for free models and assets, then add them to your game instantly. Just say "Find a medieval castle model and insert it".
+### Lighting, Weather, and Atmosphere in One Sentence
 
-### Spatial Analysis and Placement
+"Change to a dusty desert at sunset", "Make it a stormy night where lightning briefly illuminates the area" — one sentence and lighting, sky, atmosphere, and fog all update at once.
 
-AI handles spatial tasks like "Find empty space in this area" or "Analyze where monsters can walk".
+### Sculpt Terrain Through Conversation
 
-### Debugging and Analysis
+"Mountains in the north, a river through the center, open plains in the south" — generate any landscape through conversation. Control material, color, height, and smoothing. Build entire maps without touching the terrain editor.
 
-Check game error logs, find problems, and fix them together with AI.
+### Search Creator Store and Place Instantly
 
-> [View all features](docs/en/tools/overview.md)
+"Find a medieval castle model, place it at the map center, and scale it up 1.5x" — search free assets and insert them directly into your project.
+
+### Spatial Intelligence for Level Design
+
+"Find open space for a new boss arena", "Show only the areas where monsters can actually patrol" — AI handles complex spatial reasoning and placement logic.
+
+### Animations, Physics, and Audio as Connected Systems
+
+- "While the dash animation plays, change the player-enemy collision rules."
+- "Fade in the boss BGM when the ultimate activates, and smoothly return when it ends."
+
+Characters, collision, and sound working together as a game system, not separate tools.
+
+### Run Any Roblox Code Directly
+
+When built-in tools aren't enough, AI executes arbitrary Luau in Studio.
+
+- "Find every Part in the Workspace with Anchored=false and list them."
+- "Batch-update matching objects and log every change."
+
+> [View all tools](docs/en/tools/overview.md)
 
 ## Getting Started
 
@@ -53,6 +77,12 @@ Installation is complete in two steps:
 
 Takes just 5 minutes. 👉 [View Installation Guide](docs/en/installation/README.md)
 
+## Pro Upgrade
+
+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/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 |