@weppy/roblox-mcp 0.1.8 → 0.1.10

package/.claude-plugin/marketplace.json

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

package/CHANGELOG.md

@@ -3,6 +3,23 @@
 All notable changes to this project will be documented in this file.
 
 
+
+
+## [0.1.10] - 2026-02-11
+
+### Bug Fixes
+
+- Fix MCP server registration error in Antigravity
+
+
+## [0.1.9] - 2026-02-08
+
+### Other Changes
+
+- update test
+- refactor: improve stability
+
+
 ## [0.1.8] - 2026-02-08
 
 ### Fix

package/README.md

@@ -2,46 +2,58 @@
 
 **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)
 
-> Control Roblox Studio with AI.
+> Tell AI what you want, and it happens in Roblox Studio.
 
 [![Demo](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
 
-## Installation
+## What You Can Do
 
-### 1. Install Roblox Plugin
+### Create Complete Games
 
-👉 [Plugin Installation Guide](docs/en/installation/roblox-plugin.md)
+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.
 
-### 2. Configure MCP Server
+> **Tip**: Ask "Make a plan first", review it, then say "Execute it" for better results.
 
-Works with any AI app that supports MCP. Choose your AI app:
+### Create and Place Objects
 
-| AI App | Setup Guide |
-|--------|-------------|
-| Claude Code | [Setup](docs/en/installation/claude-code.md) |
-| Claude Desktop | [Setup](docs/en/installation/claude-app.md) |
-| Codex CLI | [Setup](docs/en/installation/codex-cli.md) |
-| Codex Desktop | [Setup](docs/en/installation/codex-app.md) |
-| Gemini CLI | [Setup](docs/en/installation/gemini-cli.md) |
-| Cursor, Windsurf, etc. | [Setup](docs/en/installation/antigravity.md) |
+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.
 
-## Tools
+### Write and Modify Scripts
 
-👉 [Full Tools List](docs/en/tools/overview.md)
+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.
 
-## Troubleshooting
+### Set Scene Atmosphere
 
-- **"Not Connected"**: Click Connect button in the plugin again
-- **Port**: Uses port 3002 (localhost only)
+Just say "Change to sunset vibes" or "Make it dark like a rainy day" and AI automatically adjusts lighting, sky, and fog.
 
-## Links
+### Generate Terrain
 
-- [GitHub](https://github.com/hope1026/roblox-mcp)
-- [Issue Report](https://github.com/hope1026/roblox-mcp/issues)
+Create natural landscapes like mountains, rivers, plains, and caves through conversation. Customize materials, colors, and sizes freely.
+
+### Search and Insert Assets
+
+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".
+
+### Spatial Analysis and Placement
+
+AI handles spatial tasks like "Find empty space in this area" or "Analyze where monsters can walk".
+
+### Debugging and Analysis
 
-## License
+Check game error logs, find problems, and fix them together with AI.
 
-Free to use for game development.
+> [View all features](docs/en/tools/overview.md)
 
-✅ **Allowed**: Game development, commercial games, personal projects
-❌ **Not Allowed**: Software resale, creating competing products
+## Getting Started
+
+Installation is complete in two steps:
+
+1. **Install Roblox Studio Plugin** — Acts as a bridge between Studio and AI
+2. **Register MCP Server with AI App** — Configure your AI app to recognize Roblox MCP
+
+Takes just 5 minutes. 👉 [View Installation Guide](docs/en/installation/README.md)
+
+## Links
+
+- [GitHub](https://github.com/hope1026/roblox-mcp)
+- [Issue Reports](https://github.com/hope1026/roblox-mcp/issues)

package/docs/assets/screenshots/antigravity/antigravity_mcp_raw.png

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f2969a3e379d03c818fb7347c46dfb6c4bb64229b374395dbc743e8d14d377a5
+size 102777

package/docs/assets/screenshots/antigravity/antigravity_mcp_services_menu.png

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:eb0067cc7dc03f6711158dc8bf530e63ff7367cc0e776aa3e766ec4856130ebb
+size 21639

package/docs/assets/screenshots/antigravity/antigravity_raw_config_menu.png

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ea06a903234bd187597776f55c0bb1caf4c838b368573c69fc631e1e926707ac
+size 70486

package/docs/en/installation/README.md

@@ -0,0 +1,51 @@
+# Installation Guide
+
+To use Roblox MCP, you need to install **two things**.
+
+```
+AI App (Claude, Codex, Gemini, etc.)
+       │
+   MCP Server ← Converts AI commands into a format Roblox understands
+       │
+Roblox Studio Plugin ← Executes commands inside Studio
+```
+
+When an AI app says "Create a blue part", the MCP server converts this request, and the Roblox Studio plugin actually creates the part.
+
+---
+
+## Step 1: Install Roblox Studio Plugin
+
+Download the plugin file from GitHub, then place it in Roblox Studio's Plugins folder.
+
+👉 [Plugin Installation Guide](roblox-plugin.md)
+
+---
+
+## Step 2: Register MCP Server with AI App
+
+Register the MCP server with your AI app. You can use it with any AI app that supports MCP.
+
+| AI App | Installation Guide |
+|--------|-------------------|
+| Claude Code | [Setup Instructions](ai-apps/claude-code.md) |
+| Claude Desktop | [Setup Instructions](ai-apps/claude-app.md) |
+| Codex CLI | [Setup Instructions](ai-apps/codex-cli.md) |
+| Codex Desktop | [Setup Instructions](ai-apps/codex-app.md) |
+| Gemini CLI | [Setup Instructions](ai-apps/gemini-cli.md) |
+| Antigravity | [Setup Instructions](ai-apps/antigravity.md) |
+
+> Even if your AI app isn't listed above, you can use it if it supports MCP. The MCP server command is `npx -y @weppy/roblox-mcp`.
+
+---
+
+## After Installation
+
+1. Open **Roblox Studio**, go to Plugins tab and click **W-MCP** → **Connect**
+2. Test in your **AI app** with:
+
+```
+Create a blue part in Roblox Studio
+```
+
+If the part is created successfully, installation is complete!

package/docs/en/installation/ai-apps/antigravity.md

@@ -0,0 +1,89 @@
+# Antigravity Setup
+
+How to use Roblox MCP with [Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/).
+
+> **Antigravity** is Google's agentic development platform where AI agents autonomously move between code editing, terminal, and browser to carry out complex tasks.
+
+## Prerequisites
+
+1. **Antigravity** installed (see official docs for supported OS/requirements)
+2. **Node.js** (v18.0.0 or later, `npx` available)
+3. **Roblox Studio plugin** installed
+
+## Register MCP Server
+
+In Antigravity, MCP servers are managed in the **agent pane (Agent pane)**.
+
+### Manual registration via raw config (recommended)
+
+1. In the agent pane, click **⋯** → **MCP Servers** → **Manage MCP Servers** → **View raw config**
+
+![Open MCP Servers menu](../../../assets/screenshots/antigravity/antigravity_mcp_services_menu.png)
+
+2. Add/merge the following into the displayed config (JSON):
+
+```json
+{
+  "mcpServers": {
+    "weppy-roblox-mcp": {
+      "command": "npx",
+      "args": ["-y", "@weppy/roblox-mcp"]
+    }
+  }
+}
+```
+
+![Edit raw config](../../../assets/screenshots/antigravity/antigravity_mcp_raw.png)
+
+3. After saving, do **Refresh** (or restart/refresh per the UI guidance)
+
+> The actual path/name of the config file can vary by OS and Antigravity version, so always edit based on the location shown in **View raw config**.
+
+### Optional: Adjust port/logs with environment variables
+
+We recommend keeping the defaults (HTTP `127.0.0.1:3002`). If needed, you can set environment variables like this:
+
+```json
+{
+  "mcpServers": {
+    "weppy-roblox-mcp": {
+      "command": "npx",
+      "args": ["-y", "@weppy/roblox-mcp"],
+      "env": {
+        "HTTP_HOST": "127.0.0.1",
+        "HTTP_PORT": "3002",
+        "LOG_LEVEL": "INFO"
+      }
+    }
+  }
+}
+```
+
+## Connection Test
+
+1. Open **Roblox Studio** → Plugins tab → **W-MCP** → **Connect**
+2. In **Antigravity**, enter:
+   ```
+   Tell me what's currently selected in Roblox Studio
+   ```
+
+## Troubleshooting
+
+### When the server won't start
+
+Run the MCP server directly to check for errors:
+```bash
+npx -y @weppy/roblox-mcp
+```
+
+### Connection failed
+
+- Verify the Roblox Studio plugin is **Connected**
+- Check whether port **3002** is blocked by a firewall
+- Check server status in the agent pane **⋯** → **MCP Servers**
+- (Advanced) If you changed `HTTP_PORT`, the Roblox Studio plugin/bridge must be configured to use the same port.
+
+## References
+
+- [Google Antigravity introduction](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/)
+- [Antigravity Getting Started Guide (Codelab)](https://codelabs.developers.google.com/getting-started-google-antigravity)

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

@@ -4,7 +4,7 @@ How to install the plugin to connect AI agents with Roblox Studio.
 
 ## 1. Download Plugin
 
-1. Download `weppy-roblox-mcp-basic.zip` from [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+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
 
 ## 2. Install Plugin
@@ -32,12 +32,12 @@ The MCP server must be installed. Complete the guide for your AI app first:
 
 | AI App | Installation Guide |
 |--------|-------------------|
-| Claude Code | [Setup Guide](claude-code.md) |
-| Claude Desktop | [Setup Guide](claude-app.md) |
-| Codex CLI | [Setup Guide](codex-cli.md) |
-| Codex Desktop | [Setup Guide](codex-app.md) |
-| Gemini CLI | [Setup Guide](gemini-cli.md) |
-| Cursor, Windsurf, etc. | [Setup Guide](antigravity.md) |
+| Claude Code | [Setup Guide](ai-apps/claude-code.md) |
+| Claude Desktop | [Setup Guide](ai-apps/claude-app.md) |
+| Codex CLI | [Setup Guide](ai-apps/codex-cli.md) |
+| Codex Desktop | [Setup Guide](ai-apps/codex-app.md) |
+| Gemini CLI | [Setup Guide](ai-apps/gemini-cli.md) |
+| Antigravity | [Setup Guide](ai-apps/antigravity.md) |
 
 ### Connecting
 

package/docs/en/pro-upgrade.md

@@ -6,7 +6,7 @@
 
 **Build Complete Games** - Terrain, environment, assets, and spatial tools let you create polished game worlds, not just prototypes.
 
-## What Pro Unlocks (72 additional tools)
+## What Pro Unlocks
 
 | Category | What you can do |
 |----------|-----------------|
@@ -21,8 +21,7 @@
 
 ### Step 1: Buy on Gumroad
 
-1. Go to [Gumroad - Weppy Roblox Plugin](https://sunityplugin.gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin
-)
+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
 
 ### Step 2: Install Plugin
@@ -37,12 +36,12 @@
 
 1. Open the W-MCP plugin
 2. Check that "Pro" badge is displayed
-3. All 140 tools are now available!
+3. All tools are now available!
 
 ## Feature Comparison
 
-| Feature | Basic (68 tools) | Pro (140 tools) |
-|---------|:----------------:|:---------------:|
+| Feature | Basic | Pro |
+|---------|:-----:|:---:|
 | Instance, Script, Property | ✅ Full access | ✅ Full access |
 | Selection, Tag, Camera, Log | ✅ Full access | ✅ Full access |
 | Bulk Operations | ― | ✅ Unlimited |