@weppy/roblox-mcp 0.1.4 → 0.1.6

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Roblox MCP server and tools for AI-powered game development",
-    "version": "0.1.4",
+    "version": "0.1.6",
     "pluginRoot": "./plugins"
   },
   "plugins": [
@@ -14,7 +14,7 @@
       "name": "weppy-roblox-mcp",
       "source": "./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.4",
+      "version": "0.1.6",
       "author": {
         "name": "hope1026"
       },

package/CHANGELOG.md

@@ -3,11 +3,18 @@
 All notable changes to this project will be documented in this file.
 
 
-## [0.1.4] - 2026-02-07
+
+## [0.1.6] - 2026-02-07
+
+### Other Changes
+
+- refactor: improve stability
+
+## [0.1.5] - 2026-02-07
 
 ### Other Changes
 
-- update path
+- update guide
 
 
 ## [0.1.3] - 2026-02-07

package/README.md

@@ -0,0 +1,47 @@
+# Roblox MCP
+
+**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.
+
+[![Demo](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
+
+## Installation
+
+### 1. Install Roblox Plugin
+
+👉 [Plugin Installation Guide](docs/en/installation/roblox-plugin.md)
+
+### 2. Configure MCP Server
+
+Works with any AI app that supports MCP. Choose your AI app:
+
+| 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) |
+
+## Tools
+
+👉 [Full Tools List](docs/en/tools/overview.md)
+
+## Troubleshooting
+
+- **"Not Connected"**: Click Connect button in the plugin again
+- **Port**: Uses port 3002 (localhost only)
+
+## Links
+
+- [GitHub](https://github.com/hope1026/roblox-mcp)
+- [Issue Report](https://github.com/hope1026/roblox-mcp/issues)
+
+## License
+
+Free to use for game development.
+
+✅ **Allowed**: Game development, commercial games, personal projects
+❌ **Not Allowed**: Software resale, creating competing products

package/docs/en/installation/claude-code.md

@@ -24,7 +24,7 @@ Run in Claude Code terminal:
 /plugin marketplace add hope1026/roblox-mcp
 
 # Install plugin
-/plugin install @weppy/roblox-mcp
+/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
 ```
 
 Verify installation:
@@ -77,7 +77,7 @@ Claude Code manages MCP servers automatically:
 ```bash
 # Clear cache and retry
 /plugin cache clear
-/plugin install @weppy/roblox-mcp
+/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
 ```
 
 ### Server won't start

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

@@ -4,7 +4,8 @@ How to install the plugin to connect AI agents with Roblox Studio.
 
 ## 1. Download Plugin
 
-Download the `WeppyRobloxMCP.rbxm` file from [GitHub Releases](https://github.com/hope1026/roblox-mcp/roblox-plugin).
+1. Download `weppy-roblox-mcp-basic.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
 
@@ -14,7 +15,7 @@ Download the `WeppyRobloxMCP.rbxm` file from [GitHub Releases](https://github.co
 
 ![Open Plugins Folder](../../assets/screenshots/plugins_menu.png)
 
-4. **Copy** the downloaded `.rbxm` file into the opened folder
+4. **Copy** the `WeppyRobloxMCP.rbxm` file from the extracted folder into the opened Plugins folder
 5. **Restart Roblox Studio**
 
 ## 3. Verify Installation

package/docs/en/pro-upgrade.md

@@ -21,7 +21,8 @@
 
 ### Step 1: Buy on Gumroad
 
-1. Go to [Gumroad - Weppy Roblox Plugin](https://sunityplugin.gumroad.com/l/chllph)
+1. Go to [Gumroad - Weppy Roblox Plugin](https://sunityplugin.gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin
+)
 2. Download the plugin
 
 ### Step 2: Install Plugin

package/docs/es/installation/claude-code.md

@@ -24,7 +24,7 @@ Ejecuta en la terminal de Claude Code:
 /plugin marketplace add hope1026/roblox-mcp
 
 # Instalar plugin
-/plugin install @weppy/roblox-mcp
+/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
 ```
 
 Verificar instalacion:
@@ -77,7 +77,7 @@ Claude Code gestiona el servidor MCP automaticamente:
 ```bash
 # Limpiar cache y reintentar
 /plugin cache clear
-/plugin install @weppy/roblox-mcp
+/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
 ```
 
 ### El servidor no inicia

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

@@ -4,7 +4,8 @@ Instrucciones para instalar el plugin que conecta Roblox Studio con agentes de I
 
 ## 1. Descargar el Plugin
 
-Descarga el archivo `WeppyRobloxMCP.rbxm` desde [GitHub Releases](https://github.com/hope1026/roblox-mcp/roblox-plugin).
+1. Descarga `weppy-roblox-mcp-basic.zip` desde [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+2. Extrae el archivo ZIP — encontraras el archivo `roblox-plugin/WeppyRobloxMCP.rbxm` y guias de instalacion
 
 ## 2. Instalar el Plugin
 
@@ -14,7 +15,7 @@ Descarga el archivo `WeppyRobloxMCP.rbxm` desde [GitHub Releases](https://github
 
 ![Abrir Plugins Folder](../../assets/screenshots/plugins_menu.png)
 
-4. **Copia** el archivo `.rbxm` descargado a la carpeta abierta
+4. **Copia** el archivo `WeppyRobloxMCP.rbxm` de la carpeta extraida a la carpeta de Plugins abierta
 5. **Reinicia Roblox Studio**
 
 ## 3. Verificar la Instalacion

package/docs/es/pro-upgrade.md

@@ -21,7 +21,8 @@
 
 ### Paso 1: Comprar en Gumroad
 
-1. Visita [Gumroad - Weppy Roblox Plugin](https://sunityplugin.gumroad.com/l/chllph)
+1. Visita [Gumroad - Weppy Roblox Plugin](https://sunityplugin.gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin
+)
 2. Descarga el plugin
 
 ### Paso 2: Instalar el Plugin

package/docs/id/installation/claude-code.md

@@ -24,7 +24,7 @@ Jalankan di terminal Claude Code:
 /plugin marketplace add hope1026/roblox-mcp
 
 # Instal plugin
-/plugin install @weppy/roblox-mcp
+/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
 ```
 
 Verifikasi instalasi:
@@ -77,7 +77,7 @@ Claude Code mengelola MCP server secara otomatis:
 ```bash
 # Bersihkan cache lalu coba lagi
 /plugin cache clear
-/plugin install @weppy/roblox-mcp
+/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
 ```
 
 ### Server tidak dimulai

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

@@ -4,7 +4,8 @@ Panduan instalasi plugin untuk menghubungkan AI agent di Roblox Studio.
 
 ## 1. Unduh Plugin
 
-Unduh file `WeppyRobloxMCP.rbxm` dari [GitHub Releases](https://github.com/hope1026/roblox-mcp/roblox-plugin).
+1. Unduh `weppy-roblox-mcp-basic.zip` dari [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+2. Ekstrak file ZIP — Anda akan menemukan file `roblox-plugin/WeppyRobloxMCP.rbxm` dan panduan instalasi
 
 ## 2. Instal Plugin
 
@@ -14,7 +15,7 @@ Unduh file `WeppyRobloxMCP.rbxm` dari [GitHub Releases](https://github.com/hope1
 
 ![Buka Plugins Folder](../../assets/screenshots/plugins_menu.png)
 
-4. **Salin** file `.rbxm` yang diunduh ke folder yang terbuka
+4. **Salin** file `WeppyRobloxMCP.rbxm` dari folder yang diekstrak ke folder Plugins yang terbuka
 5. **Restart Roblox Studio**
 
 ## 3. Verifikasi Instalasi

package/docs/id/pro-upgrade.md

@@ -21,7 +21,8 @@
 
 ### Langkah 1: Beli di Gumroad
 
-1. Kunjungi [Gumroad - Weppy Roblox Plugin](https://sunityplugin.gumroad.com/l/chllph)
+1. Kunjungi [Gumroad - Weppy Roblox Plugin](https://sunityplugin.gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin
+)
 2. Unduh plugin
 
 ### Langkah 2: Instal Plugin

package/docs/ja/installation/claude-code.md

@@ -24,7 +24,7 @@ Claude Codeターミナルで実行:
 /plugin marketplace add hope1026/roblox-mcp
 
 # プラグインをインストール
-/plugin install @weppy/roblox-mcp
+/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
 ```
 
 インストール確認:
@@ -77,7 +77,7 @@ Claude CodeはMCPサーバーを自動的に管理します:
 ```bash
 # キャッシュをクリアして再試行
 /plugin cache clear
-/plugin install @weppy/roblox-mcp
+/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
 ```
 
 ### サーバーが起動しない

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

@@ -4,7 +4,8 @@ Roblox StudioでAIエージェントと連携するためのプラグインイ
 
 ## 1. プラグインのダウンロード
 
-[GitHub Releases](https://github.com/hope1026/roblox-mcp/roblox-plugin)から `WeppyRobloxMCP.rbxm` ファイルをダウンロードします。
+1. [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)から `weppy-roblox-mcp-basic.zip` をダウンロードします
+2. ZIPファイルを解凍します — `roblox-plugin/WeppyRobloxMCP.rbxm` ファイルとセットアップガイドが含まれています
 
 ## 2. プラグインのインストール
 
@@ -14,7 +15,7 @@ Roblox StudioでAIエージェントと連携するためのプラグインイ
 
 ![Plugins Folderを開く](../../assets/screenshots/plugins_menu.png)
 
-4. 開いたフォルダにダウンロードした `.rbxm` ファイルを**コピー**
+4. 解凍したフォルダから `WeppyRobloxMCP.rbxm` ファイルを開いたPluginsフォルダに**コピー**
 5. **Roblox Studioを再起動**
 
 ## 3. インストール確認

package/docs/ja/pro-upgrade.md

@@ -21,7 +21,8 @@
 
 ### ステップ1: Gumroadで購入
 
-1. [Gumroad - Weppy Roblox Plugin](https://sunityplugin.gumroad.com/l/chllph) にアクセス
+1. [Gumroad - Weppy Roblox Plugin](https://sunityplugin.gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin
+) にアクセス
 2. プラグインをダウンロード
 
 ### ステップ2: プラグインのインストール

package/docs/ko/installation/claude-code.md

@@ -24,7 +24,7 @@ Claude Code 터미널에서 실행:
 /plugin marketplace add hope1026/roblox-mcp
 
 # 플러그인 설치
-/plugin install @weppy/roblox-mcp
+/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
 ```
 
 설치 확인:
@@ -77,7 +77,7 @@ Claude Code는 MCP 서버를 자동으로 관리합니다:
 ```bash
 # 캐시 정리 후 재시도
 /plugin cache clear
-/plugin install @weppy/roblox-mcp
+/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
 ```
 
 ### 서버가 시작되지 않음

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

@@ -4,7 +4,8 @@ Roblox Studio에서 AI 에이전트와 연결하기 위한 플러그인 설치
 
 ## 1. 플러그인 다운로드
 
-[GitHub Releases](https://github.com/hope1026/roblox-mcp/roblox-plugin)에서 `WeppyRobloxMCP.rbxm` 파일을 다운로드합니다.
+1. [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)에서 `weppy-roblox-mcp-basic.zip`을 다운로드합니다
+2. ZIP 파일을 압축 해제합니다 — `roblox-plugin/WeppyRobloxMCP.rbxm` 파일과 설치 가이드가 포함되어 있습니다
 
 ## 2. 플러그인 설치
 
@@ -14,7 +15,7 @@ Roblox Studio에서 AI 에이전트와 연결하기 위한 플러그인 설치
 
 ![Plugins Folder 열기](../../assets/screenshots/plugins_menu.png)
 
-4. 열린 폴더에 다운로드한 `.rbxm` 파일을 **복사**
+4. 압축 해제한 폴더에서 `WeppyRobloxMCP.rbxm` 파일을 열린 Plugins 폴더에 **복사**
 5. **Roblox Studio 재시작**
 
 ## 3. 설치 확인

package/docs/ko/pro-upgrade.md

@@ -21,7 +21,8 @@
 
 ### 1단계: Gumroad에서 구매
 
-1. [Gumroad - Weppy Roblox Plugin](https://sunityplugin.gumroad.com/l/chllph) 접속
+1. [Gumroad - Weppy Roblox Plugin](https://sunityplugin.gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin
+) 접속
 2. 플러그인 다운로드
 
 ### 2단계: 플러그인 설치

package/docs/pt-br/installation/claude-code.md

@@ -24,7 +24,7 @@ Execute no terminal do Claude Code:
 /plugin marketplace add hope1026/roblox-mcp
 
 # Instalar plugin
-/plugin install @weppy/roblox-mcp
+/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
 ```
 
 Verificar instalacao:
@@ -77,7 +77,7 @@ O Claude Code gerencia o servidor MCP automaticamente:
 ```bash
 # Limpe o cache e tente novamente
 /plugin cache clear
-/plugin install @weppy/roblox-mcp
+/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
 ```
 
 ### O servidor nao inicia

package/docs/pt-br/installation/roblox-plugin.md

@@ -4,7 +4,8 @@ Como instalar o plugin para conectar com agentes de IA no Roblox Studio.
 
 ## 1. Baixar o Plugin
 
-Baixe o arquivo `WeppyRobloxMCP.rbxm` em [GitHub Releases](https://github.com/hope1026/roblox-mcp/roblox-plugin).
+1. Baixe `weppy-roblox-mcp-basic.zip` em [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+2. Extraia o arquivo ZIP — voce encontrara o arquivo `roblox-plugin/WeppyRobloxMCP.rbxm` e guias de instalacao
 
 ## 2. Instalar o Plugin
 
@@ -14,7 +15,7 @@ Baixe o arquivo `WeppyRobloxMCP.rbxm` em [GitHub Releases](https://github.com/ho
 
 ![Abrir Plugins Folder](../../assets/screenshots/plugins_menu.png)
 
-4. **Copie** o arquivo `.rbxm` baixado para a pasta aberta
+4. **Copie** o arquivo `WeppyRobloxMCP.rbxm` da pasta extraida para a pasta de Plugins aberta
 5. **Reinicie o Roblox Studio**
 
 ## 3. Verificar a Instalacao

package/docs/pt-br/pro-upgrade.md

@@ -21,7 +21,8 @@
 
 ### Passo 1: Compre no Gumroad
 
-1. Acesse [Gumroad - Weppy Roblox Plugin](https://sunityplugin.gumroad.com/l/chllph)
+1. Acesse [Gumroad - Weppy Roblox Plugin](https://sunityplugin.gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin
+)
 2. Baixe o plugin
 
 ### Passo 2: Instale o Plugin

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weppy/roblox-mcp",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "MCP (Model Context Protocol) server for Roblox Studio integration - enables AI coding agents to interact with Roblox Studio in real-time",
   "main": "plugins/weppy-roblox-mcp/dist/index.js",
   "type": "module",

package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "weppy-roblox-mcp",
   "description": "MCP server for Roblox Studio integration - 130+ tools for AI-powered game development with specialized agents and skills",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "author": {
     "name": "hope1026"
   },
@@ -17,20 +17,12 @@
     "roblox-studio",
     "skills"
   ],
-  "mcp": {
-    "command": "node",
-    "args": [
-      "dist/index.js"
-    ]
-  },
-  "skills": [
-    {
-      "name": "roblox-game-dev",
-      "description": "Master orchestrator for Roblox game development. Handles sync, planning, development, and re-sync in a unified workflow."
-    },
-    {
-      "name": "roblox-sync",
-      "description": "Studio state synchronization with local cache"
+  "mcpServers": {
+    "weppy-roblox-mcp": {
+      "command": "node",
+      "args": [
+        "${CLAUDE_PLUGIN_ROOT}/dist/index.js"
+      ]
     }
-  ]
+  }
 }