@weppy/roblox-mcp 0.1.9 → 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.9"
+    "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.9",
+      "version": "0.1.10",
       "author": {
         "name": "hope1026"
       },

package/CHANGELOG.md

@@ -4,6 +4,14 @@ 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

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/ai-apps/antigravity.md

@@ -2,27 +2,25 @@
 
 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 navigate between code editing, terminal, and browser to perform complex tasks.
+> **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 (supports macOS, Windows, Linux)
-2. **Roblox Studio Plugin** installed
+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
 
-### Method 1: Install from MCP Store (Recommended)
+In Antigravity, MCP servers are managed in the **agent pane (Agent pane)**.
 
-1. Open Antigravity
-2. Go to **Settings** → **MCP**
-3. Search for `weppy-roblox-mcp` in the MCP Store
-4. Click **Install**
+### Manual registration via raw config (recommended)
 
-### Method 2: Edit Configuration File Directly
+1. In the agent pane, click **⋯** → **MCP Servers** → **Manage MCP Servers** → **View raw config**
 
-1. In Antigravity, click **...** menu → **MCP Servers** → **Manage MCP Servers** → **View raw config**
+![Open MCP Servers menu](../../../assets/screenshots/antigravity/antigravity_mcp_services_menu.png)
 
-2. Add the following content to the `mcp_config.json` file:
+2. Add/merge the following into the displayed config (JSON):
 
 ```json
 {
@@ -35,26 +33,15 @@ How to use Roblox MCP with [Google Antigravity](https://developers.googleblog.co
 }
 ```
 
-3. After saving, click **Refresh** in **Manage MCP Servers**
+![Edit raw config](../../../assets/screenshots/antigravity/antigravity_mcp_raw.png)
 
-**Configuration file locations:**
+3. After saving, do **Refresh** (or restart/refresh per the UI guidance)
 
-| OS | Path |
-|----|------|
-| macOS/Linux | `~/.gemini/antigravity/mcp_config.json` |
-| Windows | `%USERPROFILE%\.gemini\antigravity\mcp_config.json` |
+> 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**.
 
-### Method 3: Ask the Agent
+### Optional: Adjust port/logs with environment variables
 
-You can also ask the Antigravity Agent directly:
-
-```
-Add Roblox MCP (@weppy/roblox-mcp) as an MCP server
-```
-
-## Important: Use Absolute Paths
-
-> **Note**: Antigravity does not support the `${workspaceFolder}` variable. You must use **absolute paths**.
+We recommend keeping the defaults (HTTP `127.0.0.1:3002`). If needed, you can set environment variables like this:
 
 ```json
 {
@@ -63,7 +50,9 @@ Add Roblox MCP (@weppy/roblox-mcp) as an MCP server
       "command": "npx",
       "args": ["-y", "@weppy/roblox-mcp"],
       "env": {
-        "PROJECT_ROOT": "/Users/username/projects/my-roblox-game"
+        "HTTP_HOST": "127.0.0.1",
+        "HTTP_PORT": "3002",
+        "LOG_LEVEL": "INFO"
       }
     }
   }
@@ -73,32 +62,14 @@ Add Roblox MCP (@weppy/roblox-mcp) as an MCP server
 ## Connection Test
 
 1. Open **Roblox Studio** → Plugins tab → **W-MCP** → **Connect**
-2. Enter in **Antigravity**:
+2. In **Antigravity**, enter:
    ```
    Tell me what's currently selected in Roblox Studio
    ```
 
-## Using Skills
-
-Combined with Antigravity's **Skills** system, you can create more powerful workflows:
-
-- Define Roblox development workflows per project
-- Package frequently used tasks as Skills
-- Agent automatically plans, executes, and verifies tasks
-
-## Supported Models
-
-You can choose from the following models when using Roblox MCP in Antigravity:
-
-| Model | Features |
-|-------|----------|
-| **Gemini 3 Pro** | Default model, free to use |
-| **Claude Sonnet 4.5** | Anthropic model support |
-| **GPT-OSS** | OpenAI model support |
-
 ## Troubleshooting
 
-### Server won't start
+### When the server won't start
 
 Run the MCP server directly to check for errors:
 ```bash
@@ -107,24 +78,12 @@ npx -y @weppy/roblox-mcp
 
 ### Connection failed
 
-- Verify the Roblox Studio plugin is in **Connected** state
-- Check if port 3002 is blocked by a firewall
-- Check server status in Settings → MCP
-
-### Absolute path error
-
-Using `${workspaceFolder}` will cause errors. Change to absolute paths:
-
-```json
-// Wrong
-"args": ["--workspace", "${workspaceFolder}"]
-
-// Correct
-"args": ["--workspace", "/absolute/path/to/project"]
-```
+- 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.
 
-## Reference
+## References
 
-- [Antigravity Getting Started Guide](https://codelabs.developers.google.com/getting-started-google-antigravity)
-- [Antigravity MCP Integration Guide](https://composio.dev/blog/howto-mcp-antigravity)
-- [Antigravity Skills Collection](https://github.com/sickn33/antigravity-awesome-skills)
+- [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

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

@@ -1,28 +1,26 @@
-# Configuracion de Antigravity
+# Configuración de Antigravity
 
-Como usar Roblox MCP en [Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/).
+Cómo usar Roblox MCP con [Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/).
 
-> **Antigravity** es la plataforma de desarrollo basada en agentes de Google, donde los agentes de IA realizan tareas complejas de forma autonoma navegando entre el editor de codigo, la terminal y el navegador.
+> **Antigravity** es la plataforma de desarrollo basada en agentes de Google, donde los agentes de IA se mueven entre la edición de código, la terminal y el navegador para realizar tareas complejas de forma autónoma.
 
-## Requisitos Previos
+## Requisitos previos
 
-1. **Antigravity** instalado (compatible con macOS, Windows, Linux)
-2. **Plugin de Roblox Studio** instalado
+1. **Antigravity** instalado (consulta la documentación oficial para SO compatibles y requisitos)
+2. **Node.js** (v18.0.0 o superior, `npx` disponible)
+3. **Plugin de Roblox Studio** instalado
 
-## Registrar el Servidor MCP
+## Registrar servidor MCP
 
-### Metodo 1: Instalar desde MCP Store (Recomendado)
+En Antigravity, los servidores MCP se administran en el **panel de agente (Agent pane)**.
 
-1. Abre Antigravity
-2. Ve a **Settings** → **MCP**
-3. Busca `weppy-roblox-mcp` en MCP Store
-4. Clic en **Install**
+### Registro manual mediante raw config (recomendado)
 
-### Metodo 2: Editar archivo de configuracion directamente
+1. En el panel de agente, haz clic en **⋯** → **MCP Servers** → **Manage MCP Servers** → **View raw config**
 
-1. En Antigravity, clic en menu **⋯** → **MCP Servers** → **Manage MCP Servers** → **View raw config**
+![Abrir menú de MCP Servers](../../../assets/screenshots/antigravity/antigravity_mcp_services_menu.png)
 
-2. Agrega el siguiente contenido al archivo `mcp_config.json`:
+2. En la configuración (JSON) que se muestra, agrega/fusiona lo siguiente:
 
 ```json
 {
@@ -35,26 +33,15 @@ Como usar Roblox MCP en [Google Antigravity](https://developers.googleblog.com/b
 }
 ```
 
-3. Guarda y clic en **Refresh** en **Manage MCP Servers**
+![Editar raw config](../../../assets/screenshots/antigravity/antigravity_mcp_raw.png)
 
-**Ubicacion del archivo de configuracion:**
+3. Guarda y ejecuta **Refresh** (o reinicia/actualiza según lo indique la UI)
 
-| SO | Ruta |
-|----|------|
-| macOS/Linux | `~/.gemini/antigravity/mcp_config.json` |
-| Windows | `%USERPROFILE%\.gemini\antigravity\mcp_config.json` |
+> La ruta/nombre real del archivo de configuración puede variar según el SO y la versión de Antigravity, así que edita siempre la ubicación indicada en **View raw config**.
 
-### Metodo 3: Pedir al Agente
+### Opción: Ajustar puerto/logs con variables de entorno
 
-Tambien puedes pedirlo directamente al Agente de Antigravity:
-
-```
-Agrega Roblox MCP (@weppy/roblox-mcp) como servidor MCP
-```
-
-## Importante: Usar Rutas Absolutas
-
-> **Atencion**: Antigravity no soporta la variable `${workspaceFolder}`. Asegurate de usar **rutas absolutas**.
+Se recomienda mantener el valor predeterminado (HTTP `127.0.0.1:3002`). Si es necesario, puedes establecer variables de entorno así:
 
 ```json
 {
@@ -63,68 +50,40 @@ Agrega Roblox MCP (@weppy/roblox-mcp) como servidor MCP
       "command": "npx",
       "args": ["-y", "@weppy/roblox-mcp"],
       "env": {
-        "PROJECT_ROOT": "/Users/username/projects/my-roblox-game"
+        "HTTP_HOST": "127.0.0.1",
+        "HTTP_PORT": "3002",
+        "LOG_LEVEL": "INFO"
       }
     }
   }
 }
 ```
 
-## Probar la Conexion
+## Prueba de conexión
 
-1. Abre **Roblox Studio** → Pestana Plugins → **W-MCP** → **Connect**
-2. Ingresa en **Antigravity**:
+1. Abre **Roblox Studio** → pestaña Plugins → **W-MCP** → **Connect**
+2. En **Antigravity**, escribe:
    ```
-   Dime que esta seleccionado actualmente en Roblox Studio
+   Dime qué está seleccionado actualmente en Roblox Studio
    ```
 
-## Uso de Skills
-
-Combinado con el sistema de **Skills** de Antigravity, puedes configurar flujos de trabajo mas potentes:
-
-- Define flujos de trabajo de desarrollo Roblox por proyecto
-- Empaqueta tareas frecuentes como Skills
-- El agente planifica, ejecuta y verifica tareas automaticamente
-
-## Modelos Soportados
-
-Puedes elegir los siguientes modelos al usar Roblox MCP en Antigravity:
+## Solución de problemas
 
-| Modelo | Caracteristicas |
-|--------|-----------------|
-| **Gemini 3 Pro** | Modelo predeterminado, uso gratuito |
-| **Claude Sonnet 4.5** | Soporte para modelos de Anthropic |
-| **GPT-OSS** | Soporte para modelos de OpenAI |
+### Cuando el servidor no inicia
 
-## Solucion de Problemas
-
-### El servidor no inicia
-
-Ejecuta el servidor MCP directamente para ver los errores:
+Ejecuta el servidor MCP directamente para ver el error:
 ```bash
 npx -y @weppy/roblox-mcp
 ```
 
-### Fallo de conexion
-
-- Verifica que el plugin de Roblox Studio este en estado **Connected**
-- Verifica que el puerto 3002 no este bloqueado por el firewall
-- Verifica el estado del servidor en Settings → MCP
-
-### Error de ruta absoluta
+### Falla de conexión
 
-Al usar `${workspaceFolder}` se produce un error. Cambia a una ruta absoluta:
-
-```json
-// ❌ Incorrecto
-"args": ["--workspace", "${workspaceFolder}"]
-
-// ✅ Correcto
-"args": ["--workspace", "/absolute/path/to/project"]
-```
+- Verifica que el plugin de Roblox Studio esté en estado **Connected**
+- Verifica que el puerto **3002** no esté bloqueado por el firewall
+- Revisa el estado del servidor en el panel de agente **⋯** → **MCP Servers**
+- (Avanzado) Si cambiaste `HTTP_PORT`, el plugin/bridge de Roblox Studio también debe usar el mismo puerto.
 
-## Recursos
+## Referencias
 
-- [Guia de inicio de Antigravity](https://codelabs.developers.google.com/getting-started-google-antigravity)
-- [Guia de integracion MCP de Antigravity](https://composio.dev/blog/howto-mcp-antigravity)
-- [Coleccion de Skills de Antigravity](https://github.com/sickn33/antigravity-awesome-skills)
+- [Introducción a Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/)
+- [Guía de inicio de Antigravity (Codelab)](https://codelabs.developers.google.com/getting-started-google-antigravity)

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

@@ -4,7 +4,7 @@ Instrucciones para instalar el plugin que conecta Roblox Studio con agentes de I
 
 ## 1. Descargar el Plugin
 
-1. Descarga `weppy-roblox-mcp-basic.zip` desde [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+1. Descarga `weppy-roblox-mcp-basic-v{versión}.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

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

@@ -1,28 +1,26 @@
-# Konfigurasi Antigravity
+# Pengaturan Antigravity
 
-Cara menggunakan Roblox MCP di [Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/).
+Cara menggunakan Roblox MCP dengan [Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/).
 
-> **Antigravity** adalah platform pengembangan berbasis agent dari Google, di mana AI agent dapat melakukan tugas kompleks secara otonom melintasi editor kode, terminal, dan browser.
+> **Antigravity** adalah platform pengembangan berbasis agen dari Google, di mana agen AI secara otonom berpindah antara pengeditan kode, terminal, dan browser untuk menjalankan tugas yang kompleks.
 
 ## Prasyarat
 
-1. **Antigravity** sudah terinstal (mendukung macOS, Windows, Linux)
-2. **Plugin Roblox Studio** sudah terinstal
+1. **Antigravity** sudah terinstal (lihat dokumentasi resmi untuk OS yang didukung/persyaratan)
+2. **Node.js** (v18.0.0 atau lebih baru, `npx` tersedia)
+3. **Plugin Roblox Studio** sudah terinstal
 
-## Registrasi MCP Server
+## Mendaftarkan server MCP
 
-### Metode 1: Instal dari MCP Store (Disarankan)
+Di Antigravity, server MCP dikelola di **panel agen (Agent pane)**.
 
-1. Jalankan Antigravity
-2. Buka **Settings** → **MCP**
-3. Cari `weppy-roblox-mcp` di MCP Store
-4. Klik **Install**
+### Pendaftaran manual lewat raw config (disarankan)
 
-### Metode 2: Edit File Konfigurasi Langsung
+1. Di panel agen, klik **⋯** → **MCP Servers** → **Manage MCP Servers** → **View raw config**
 
-1. Di Antigravity, klik menu **⋯** → **MCP Servers** → **Manage MCP Servers** → **View raw config**
+![Buka menu MCP Servers](../../../assets/screenshots/antigravity/antigravity_mcp_services_menu.png)
 
-2. Tambahkan konten berikut ke file `mcp_config.json`:
+2. Pada konfigurasi (JSON) yang ditampilkan, tambahkan/gabungkan isi berikut:
 
 ```json
 {
@@ -35,26 +33,15 @@ Cara menggunakan Roblox MCP di [Google Antigravity](https://developers.googleblo
 }
 ```
 
-3. Simpan lalu klik **Refresh** di **Manage MCP Servers**
+![Edit raw config](../../../assets/screenshots/antigravity/antigravity_mcp_raw.png)
 
-**Lokasi file konfigurasi:**
+3. Setelah menyimpan, lakukan **Refresh** (atau restart/refresh sesuai petunjuk UI)
 
-| OS | Path |
-|----|------|
-| macOS/Linux | `~/.gemini/antigravity/mcp_config.json` |
-| Windows | `%USERPROFILE%\.gemini\antigravity\mcp_config.json` |
+> Lokasi/nama file konfigurasi yang sebenarnya bisa berbeda tergantung OS dan versi Antigravity, jadi selalu edit berdasarkan lokasi yang ditunjukkan di **View raw config**.
 
-### Metode 3: Minta Agent
+### Opsi: Atur port/log lewat variabel lingkungan
 
-Anda juga dapat meminta Antigravity Agent langsung:
-
-```
-Tambahkan Roblox MCP (@weppy/roblox-mcp) sebagai MCP server
-```
-
-## Penting: Gunakan Path Absolut
-
-> **Perhatian**: Antigravity tidak mendukung variabel `${workspaceFolder}`. Anda **harus** menggunakan **path absolut**.
+Disarankan untuk mempertahankan nilai default (HTTP `127.0.0.1:3002`). Jika diperlukan, Anda dapat mengatur variabel lingkungan seperti berikut:
 
 ```json
 {
@@ -63,68 +50,40 @@ Tambahkan Roblox MCP (@weppy/roblox-mcp) sebagai MCP server
       "command": "npx",
       "args": ["-y", "@weppy/roblox-mcp"],
       "env": {
-        "PROJECT_ROOT": "/Users/username/projects/my-roblox-game"
+        "HTTP_HOST": "127.0.0.1",
+        "HTTP_PORT": "3002",
+        "LOG_LEVEL": "INFO"
       }
     }
   }
 }
 ```
 
-## Tes Koneksi
+## Uji koneksi
 
-1. Jalankan **Roblox Studio** → Tab Plugins → **W-MCP** → **Connect**
-2. Masukkan di **Antigravity**:
+1. Jalankan **Roblox Studio** → tab Plugins → **W-MCP** → **Connect**
+2. Di **Antigravity**, masukkan:
    ```
-   Beritahu apa yang sedang dipilih di Roblox Studio
+   Beri tahu saya apa yang sedang dipilih di Roblox Studio saat ini
    ```
 
-## Memanfaatkan Skills
-
-Anda dapat membuat workflow yang lebih powerful dengan menggunakan sistem **Skills** Antigravity:
-
-- Definisikan workflow pengembangan Roblox per proyek
-- Paket tugas yang sering digunakan sebagai Skill
-- Agent secara otomatis merencanakan, mengeksekusi, dan memverifikasi tugas
-
-## Model yang Didukung
-
-Anda dapat memilih model berikut saat menggunakan Roblox MCP di Antigravity:
+## Pemecahan masalah
 
-| Model | Karakteristik |
-|-------|---------------|
-| **Gemini 3 Pro** | Model default, tersedia gratis |
-| **Claude Sonnet 4.5** | Dukungan model Anthropic |
-| **GPT-OSS** | Dukungan model OpenAI |
+### Jika server tidak dapat dijalankan
 
-## Pemecahan Masalah
-
-### Saat server tidak dimulai
-
-Jalankan MCP server langsung untuk memeriksa error:
+Jalankan server MCP secara langsung untuk melihat error:
 ```bash
 npx -y @weppy/roblox-mcp
 ```
 
-### Koneksi gagal
-
-- Pastikan plugin Roblox Studio dalam status **Connected**
-- Pastikan port 3002 tidak diblokir oleh firewall
-- Periksa status server di Settings → MCP
-
-### Error path absolut
+### Gagal terhubung
 
-Error terjadi saat menggunakan `${workspaceFolder}`. Ubah ke path absolut:
-
-```json
-// ❌ Salah
-"args": ["--workspace", "${workspaceFolder}"]
-
-// ✅ Benar
-"args": ["--workspace", "/absolute/path/to/project"]
-```
+- Pastikan plugin Roblox Studio berstatus **Connected**
+- Pastikan port **3002** tidak diblokir oleh firewall
+- Cek status server di panel agen **⋯** → **MCP Servers**
+- (Lanjutan) Jika Anda mengubah `HTTP_PORT`, pastikan pengaturan plugin/bridge Roblox Studio juga menggunakan port yang sama.
 
 ## Referensi
 
-- [Panduan Memulai Antigravity](https://codelabs.developers.google.com/getting-started-google-antigravity)
-- [Panduan Integrasi MCP Antigravity](https://composio.dev/blog/howto-mcp-antigravity)
-- [Koleksi Skills Antigravity](https://github.com/sickn33/antigravity-awesome-skills)
+- [Pengenalan Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/)
+- [Panduan memulai Antigravity (Codelab)](https://codelabs.developers.google.com/getting-started-google-antigravity)

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

@@ -4,7 +4,7 @@ Panduan instalasi plugin untuk menghubungkan AI agent di Roblox Studio.
 
 ## 1. Unduh Plugin
 
-1. Unduh `weppy-roblox-mcp-basic.zip` dari [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+1. Unduh `weppy-roblox-mcp-basic-v{versi}.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