@weppy/roblox-mcp 0.1.9 → 0.1.11

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.11"
   },
   "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.11",
       "author": {
         "name": "hope1026"
       },

package/CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to this project will be documented in this file.
 
 
 
+
+## [0.1.11] - 2026-02-14
+
+### Other Changes
+
+- Improve stability
+
+
+## [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/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,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/ai-apps/gemini-cli.md

@@ -1,8 +1,8 @@
-# Configuracion de Gemini CLI
+# Configuración de Gemini CLI
 
-Como usar Roblox MCP en [Google Gemini CLI](https://github.com/google-gemini/gemini-cli).
+Cómo usar Roblox MCP con [Google Gemini CLI](https://github.com/google-gemini/gemini-cli).
 
-## Requisitos Previos
+## Requisitos previos
 
 1. **Node.js** (v18.0.0 o superior)
    ```bash
@@ -16,11 +16,27 @@ Como usar Roblox MCP en [Google Gemini CLI](https://github.com/google-gemini/gem
 
 3. **Plugin de Roblox Studio** instalado
 
-## Registrar el Servidor MCP
+## Registrar el servidor MCP
 
-### Metodo 1: Editar archivo de configuracion (Recomendado)
+### Método 1: Comando CLI (Recomendado)
 
-Agrega el siguiente contenido al archivo `.gemini/settings.json`:
+Puede registrarse con un solo comando en su terminal:
+
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -- -y @weppy/roblox-mcp
+```
+
+> La bandera `--trust` omite las solicitudes de confirmación para cada llamada de herramienta.
+
+Para registrar globalmente, agregue `-s user`:
+
+```bash
+gemini mcp add weppy-roblox-mcp npx -s user --trust -- -y @weppy/roblox-mcp
+```
+
+### Método 2: Editar archivo de configuración
+
+Agregue el siguiente contenido al archivo `.gemini/settings.json`:
 
 ```json
 {
@@ -33,16 +49,22 @@ Agrega el siguiente contenido al archivo `.gemini/settings.json`:
 }
 ```
 
-**Ubicacion del archivo de configuracion:**
-| Alcance | Ruta |
-|---------|------|
+**Ubicaciones del archivo de configuración:**
+| Ámbito | Ruta |
+|--------|------|
 | Proyecto | `<proyecto>/.gemini/settings.json` |
 | Global | `~/.gemini/settings.json` |
 
-### Metodo 2: Usar variables de entorno
+### Método 3: Uso de variables de entorno
+
+Si se necesitan variables de entorno específicas:
 
-Si necesitas variables de entorno especificas:
+**CLI:**
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -e MCP_PORT=3002 -- -y @weppy/roblox-mcp
+```
 
+**Archivo de configuración:**
 ```json
 {
   "mcpServers": {
@@ -57,71 +79,42 @@ Si necesitas variables de entorno especificas:
 }
 ```
 
-## Probar la Conexion
+## Prueba de conexión
 
-1. Abre **Roblox Studio** → Pestana Plugins → **W-MCP** → **Connect**
-2. Ejecuta **Gemini CLI** e ingresa:
+1. Abra **Roblox Studio** → pestaña Plugins → **W-MCP** → **Connect**
+2. Ejecute **Gemini CLI** e ingrese:
    ```
-   Dime que esta seleccionado actualmente en Roblox Studio
+   Dime qué está seleccionado actualmente en Roblox Studio
    ```
 
-## Verificar Estado del Servidor MCP
+## Verificar el estado del servidor MCP
 
-Puedes verificar el estado de los servidores conectados con el comando `/mcp` dentro de Gemini CLI:
+Puede verificar el estado de los servidores conectados con el comando `/mcp` en Gemini CLI:
 
 ```
 /mcp
 ```
 
-## Configuracion Avanzada
-
-### Filtrado de herramientas
-
-Puedes usar o excluir herramientas especificas:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "excludeTools": ["execute_script"],
-      "includeTools": ["get_selection", "create_instance", "set_property"]
-    }
-  }
-}
-```
-
-> `excludeTools` tiene prioridad sobre `includeTools`.
-
-### Modo debug
-
-Para depurar problemas de conexion:
-
-```bash
-gemini --debug
-```
-
-## Solucion de Problemas
+## Solución de problemas
 
-### El servidor no inicia
+### El servidor no se inicia
 
-Ejecuta el servidor MCP directamente para ver los errores:
+Ejecute el servidor MCP directamente para verificar errores:
 ```bash
 npx -y @weppy/roblox-mcp
 ```
 
-### Fallo de conexion
+### Conexión fallida
 
-- 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 con el comando `/mcp`
+- Verifique que el plugin de Roblox Studio esté en estado **Connected**
+- Verifique si el puerto 3002 está bloqueado por un firewall
+- Verifique el estado del servidor con el comando `/mcp`
 
-### Conflicto de herramientas
+### Conflictos de herramientas
 
-Si varias servidores MCP tienen herramientas con el mismo nombre, se les agregara un prefijo en formato `serverAlias__toolName`.
+Si varios servidores MCP tienen herramientas con el mismo nombre, se les agregará el prefijo con el formato `serverAlias__toolName`.
 
-## Recursos
+## Referencias
 
-- [Documentacion oficial de Gemini CLI MCP](https://geminicli.com/docs/tools/mcp-server/)
-- [Guia de configuracion de Gemini CLI](https://geminicli.com/docs/get-started/configuration/)
+- [Documentación oficial de Gemini CLI MCP](https://geminicli.com/docs/tools/mcp-server/)
+- [Guía de configuración de Gemini CLI](https://geminicli.com/docs/get-started/configuration/)

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