@weppy/roblox-mcp 0.1.8 → 0.1.10

package/docs/en/installation/antigravity.md

@@ -1,130 +0,0 @@
-# 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 navigate between code editing, terminal, and browser to perform complex tasks.
-
-## Prerequisites
-
-1. **Antigravity** installed (supports macOS, Windows, Linux)
-2. **Roblox Studio Plugin** installed
-
-## Register MCP Server
-
-### Method 1: Install from MCP Store (Recommended)
-
-1. Open Antigravity
-2. Go to **Settings** → **MCP**
-3. Search for `weppy-roblox-mcp` in the MCP Store
-4. Click **Install**
-
-### Method 2: Edit Configuration File Directly
-
-1. In Antigravity, click **...** menu → **MCP Servers** → **Manage MCP Servers** → **View raw config**
-
-2. Add the following content to the `mcp_config.json` file:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-3. After saving, click **Refresh** in **Manage MCP Servers**
-
-**Configuration file locations:**
-
-| OS | Path |
-|----|------|
-| macOS/Linux | `~/.gemini/antigravity/mcp_config.json` |
-| Windows | `%USERPROFILE%\.gemini\antigravity\mcp_config.json` |
-
-### Method 3: Ask the Agent
-
-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**.
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "env": {
-        "PROJECT_ROOT": "/Users/username/projects/my-roblox-game"
-      }
-    }
-  }
-}
-```
-
-## Connection Test
-
-1. Open **Roblox Studio** → Plugins tab → **W-MCP** → **Connect**
-2. Enter in **Antigravity**:
-   ```
-   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
-
-Run the MCP server directly to check for errors:
-```bash
-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"]
-```
-
-## Reference
-
-- [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)

package/docs/es/installation/antigravity.md

@@ -1,130 +0,0 @@
-# Configuracion de Antigravity
-
-Como usar Roblox MCP en [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.
-
-## Requisitos Previos
-
-1. **Antigravity** instalado (compatible con macOS, Windows, Linux)
-2. **Plugin de Roblox Studio** instalado
-
-## Registrar el Servidor MCP
-
-### Metodo 1: Instalar desde MCP Store (Recomendado)
-
-1. Abre Antigravity
-2. Ve a **Settings** → **MCP**
-3. Busca `weppy-roblox-mcp` en MCP Store
-4. Clic en **Install**
-
-### Metodo 2: Editar archivo de configuracion directamente
-
-1. En Antigravity, clic en menu **⋯** → **MCP Servers** → **Manage MCP Servers** → **View raw config**
-
-2. Agrega el siguiente contenido al archivo `mcp_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-3. Guarda y clic en **Refresh** en **Manage MCP Servers**
-
-**Ubicacion del archivo de configuracion:**
-
-| SO | Ruta |
-|----|------|
-| macOS/Linux | `~/.gemini/antigravity/mcp_config.json` |
-| Windows | `%USERPROFILE%\.gemini\antigravity\mcp_config.json` |
-
-### Metodo 3: Pedir al Agente
-
-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**.
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "env": {
-        "PROJECT_ROOT": "/Users/username/projects/my-roblox-game"
-      }
-    }
-  }
-}
-```
-
-## Probar la Conexion
-
-1. Abre **Roblox Studio** → Pestana Plugins → **W-MCP** → **Connect**
-2. Ingresa en **Antigravity**:
-   ```
-   Dime que esta 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:
-
-| 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 |
-
-## Solucion de Problemas
-
-### El servidor no inicia
-
-Ejecuta el servidor MCP directamente para ver los errores:
-```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
-
-Al usar `${workspaceFolder}` se produce un error. Cambia a una ruta absoluta:
-
-```json
-// ❌ Incorrecto
-"args": ["--workspace", "${workspaceFolder}"]
-
-// ✅ Correcto
-"args": ["--workspace", "/absolute/path/to/project"]
-```
-
-## Recursos
-
-- [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)

package/docs/id/installation/antigravity.md

@@ -1,130 +0,0 @@
-# Konfigurasi Antigravity
-
-Cara menggunakan Roblox MCP di [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.
-
-## Prasyarat
-
-1. **Antigravity** sudah terinstal (mendukung macOS, Windows, Linux)
-2. **Plugin Roblox Studio** sudah terinstal
-
-## Registrasi MCP Server
-
-### Metode 1: Instal dari MCP Store (Disarankan)
-
-1. Jalankan Antigravity
-2. Buka **Settings** → **MCP**
-3. Cari `weppy-roblox-mcp` di MCP Store
-4. Klik **Install**
-
-### Metode 2: Edit File Konfigurasi Langsung
-
-1. Di Antigravity, klik menu **⋯** → **MCP Servers** → **Manage MCP Servers** → **View raw config**
-
-2. Tambahkan konten berikut ke file `mcp_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-3. Simpan lalu klik **Refresh** di **Manage MCP Servers**
-
-**Lokasi file konfigurasi:**
-
-| OS | Path |
-|----|------|
-| macOS/Linux | `~/.gemini/antigravity/mcp_config.json` |
-| Windows | `%USERPROFILE%\.gemini\antigravity\mcp_config.json` |
-
-### Metode 3: Minta Agent
-
-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**.
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "env": {
-        "PROJECT_ROOT": "/Users/username/projects/my-roblox-game"
-      }
-    }
-  }
-}
-```
-
-## Tes Koneksi
-
-1. Jalankan **Roblox Studio** → Tab Plugins → **W-MCP** → **Connect**
-2. Masukkan di **Antigravity**:
-   ```
-   Beritahu apa yang sedang dipilih di Roblox Studio
-   ```
-
-## 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:
-
-| Model | Karakteristik |
-|-------|---------------|
-| **Gemini 3 Pro** | Model default, tersedia gratis |
-| **Claude Sonnet 4.5** | Dukungan model Anthropic |
-| **GPT-OSS** | Dukungan model OpenAI |
-
-## Pemecahan Masalah
-
-### Saat server tidak dimulai
-
-Jalankan MCP server langsung untuk memeriksa 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
-
-Error terjadi saat menggunakan `${workspaceFolder}`. Ubah ke path absolut:
-
-```json
-// ❌ Salah
-"args": ["--workspace", "${workspaceFolder}"]
-
-// ✅ Benar
-"args": ["--workspace", "/absolute/path/to/project"]
-```
-
-## 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)

package/docs/ja/installation/antigravity.md

@@ -1,130 +0,0 @@
-# Antigravity 設定
-
-[Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/)でRoblox MCPを使用する方法です。
-
-> **Antigravity**はGoogleのエージェントベース開発プラットフォームで、AIエージェントがコード編集、ターミナル、ブラウザを横断して複雑なタスクを自律的に実行します。
-
-## 前提条件
-
-1. **Antigravity** がインストール済み (macOS, Windows, Linux対応)
-2. **Roblox Studioプラグイン** のインストール完了
-
-## MCPサーバーの登録
-
-### 方法1: MCP Storeからインストール (推奨)
-
-1. Antigravityを起動
-2. **Settings** → **MCP** に移動
-3. MCP Storeで `weppy-roblox-mcp` を検索
-4. **Install** をクリック
-
-### 方法2: 設定ファイルを直接編集
-
-1. Antigravityで **⋯** メニュー → **MCP Servers** → **Manage MCP Servers** → **View raw config** をクリック
-
-2. `mcp_config.json` ファイルに以下の内容を追加:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-3. 保存後、**Manage MCP Servers** で **Refresh** をクリック
-
-**設定ファイルの場所:**
-
-| OS | パス |
-|----|------|
-| macOS/Linux | `~/.gemini/antigravity/mcp_config.json` |
-| Windows | `%USERPROFILE%\.gemini\antigravity\mcp_config.json` |
-
-### 方法3: Agentに依頼
-
-Antigravity Agentに直接依頼することもできます:
-
-```
-Roblox MCP (@weppy/roblox-mcp)をMCPサーバーとして追加して
-```
-
-## 重要: 絶対パスの使用
-
-> **注意**: Antigravityは `${workspaceFolder}` 変数をサポートしていません。必ず**絶対パス**を使用してください。
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "env": {
-        "PROJECT_ROOT": "/Users/username/projects/my-roblox-game"
-      }
-    }
-  }
-}
-```
-
-## 接続テスト
-
-1. **Roblox Studio** を起動 → Pluginsタブ → **W-MCP** → **Connect**
-2. **Antigravity**で以下を入力:
-   ```
-   Roblox Studioで現在選択されているものを教えて
-   ```
-
-## Skillsの活用
-
-Antigravityの**Skills**システムと組み合わせることで、より強力なワークフローを構築できます:
-
-- プロジェクト別のRoblox開発ワークフローを定義
-- よく使うタスクをSkillとしてパッケージ化
-- エージェントが自動的にタスクを計画、実行、検証
-
-## サポートモデル
-
-AntigravityでRoblox MCPを使用する際、以下のモデルを選択できます:
-
-| モデル | 特徴 |
-|------|------|
-| **Gemini 3 Pro** | デフォルトモデル、無料で使用可能 |
-| **Claude Sonnet 4.5** | Anthropicモデル対応 |
-| **GPT-OSS** | OpenAIモデル対応 |
-
-## トラブルシューティング
-
-### サーバーが起動しない場合
-
-MCPサーバーを直接実行してエラーを確認してください:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### 接続失敗
-
-- Roblox Studioプラグインが **Connected** 状態か確認
-- ポート3002がファイアウォールでブロックされていないか確認
-- Settings → MCPでサーバー状態を確認
-
-### 絶対パスエラー
-
-`${workspaceFolder}` を使用するとエラーが発生します。絶対パスに変更してください:
-
-```json
-// ❌ 間違い
-"args": ["--workspace", "${workspaceFolder}"]
-
-// ✅ 正しい
-"args": ["--workspace", "/absolute/path/to/project"]
-```
-
-## 参考資料
-
-- [Antigravity入門ガイド](https://codelabs.developers.google.com/getting-started-google-antigravity)
-- [Antigravity MCP連携ガイド](https://composio.dev/blog/howto-mcp-antigravity)
-- [Antigravity Skillsコレクション](https://github.com/sickn33/antigravity-awesome-skills)

package/docs/ko/installation/antigravity.md

@@ -1,130 +0,0 @@
-# Antigravity 설정
-
-[Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/)에서 Roblox MCP를 사용하는 방법입니다.
-
-> **Antigravity**는 Google의 에이전트 기반 개발 플랫폼으로, AI 에이전트가 코드 편집, 터미널, 브라우저를 넘나들며 복잡한 작업을 자율적으로 수행합니다.
-
-## 사전 요구사항
-
-1. **Antigravity** 설치됨 (macOS, Windows, Linux 지원)
-2. **Roblox Studio 플러그인** 설치 완료
-
-## MCP 서버 등록
-
-### 방법 1: MCP Store에서 설치 (권장)
-
-1. Antigravity 실행
-2. **Settings** → **MCP** 이동
-3. MCP Store에서 `weppy-roblox-mcp` 검색
-4. **Install** 클릭
-
-### 방법 2: 설정 파일 직접 편집
-
-1. Antigravity에서 **⋯** 메뉴 → **MCP Servers** → **Manage MCP Servers** → **View raw config** 클릭
-
-2. `mcp_config.json` 파일에 아래 내용을 추가:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-3. 저장 후 **Manage MCP Servers**에서 **Refresh** 클릭
-
-**설정 파일 위치:**
-
-| OS | 경로 |
-|----|------|
-| macOS/Linux | `~/.gemini/antigravity/mcp_config.json` |
-| Windows | `%USERPROFILE%\.gemini\antigravity\mcp_config.json` |
-
-### 방법 3: Agent에게 요청
-
-Antigravity Agent에게 직접 요청할 수도 있습니다:
-
-```
-Roblox MCP (@weppy/roblox-mcp)를 MCP 서버로 추가해줘
-```
-
-## 중요: 절대 경로 사용
-
-> **주의**: Antigravity는 `${workspaceFolder}` 변수를 지원하지 않습니다. 반드시 **절대 경로**를 사용하세요.
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "env": {
-        "PROJECT_ROOT": "/Users/username/projects/my-roblox-game"
-      }
-    }
-  }
-}
-```
-
-## 연결 테스트
-
-1. **Roblox Studio** 실행 → Plugins 탭 → **W-MCP** → **Connect**
-2. **Antigravity**에서 다음을 입력:
-   ```
-   Roblox Studio에서 현재 선택된 것을 알려줘
-   ```
-
-## Skills 활용
-
-Antigravity의 **Skills** 시스템과 함께 사용하면 더 강력한 워크플로우를 구성할 수 있습니다:
-
-- 프로젝트별 Roblox 개발 워크플로우 정의
-- 자주 사용하는 작업을 Skill로 패키징
-- 에이전트가 자동으로 작업을 계획, 실행, 검증
-
-## 지원 모델
-
-Antigravity에서 Roblox MCP를 사용할 때 다음 모델을 선택할 수 있습니다:
-
-| 모델 | 특징 |
-|------|------|
-| **Gemini 3 Pro** | 기본 모델, 무료 사용 가능 |
-| **Claude Sonnet 4.5** | Anthropic 모델 지원 |
-| **GPT-OSS** | OpenAI 모델 지원 |
-
-## 문제 해결
-
-### 서버가 시작되지 않을 때
-
-MCP 서버를 직접 실행하여 오류를 확인하세요:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### 연결 실패
-
-- Roblox Studio 플러그인이 **Connected** 상태인지 확인
-- 포트 3002가 방화벽에 의해 차단되지 않았는지 확인
-- Settings → MCP에서 서버 상태 확인
-
-### 절대 경로 오류
-
-`${workspaceFolder}` 사용 시 오류가 발생합니다. 절대 경로로 변경하세요:
-
-```json
-// ❌ 잘못됨
-"args": ["--workspace", "${workspaceFolder}"]
-
-// ✅ 올바름
-"args": ["--workspace", "/absolute/path/to/project"]
-```
-
-## 참고 자료
-
-- [Antigravity 시작 가이드](https://codelabs.developers.google.com/getting-started-google-antigravity)
-- [Antigravity MCP 연동 가이드](https://composio.dev/blog/howto-mcp-antigravity)
-- [Antigravity Skills 컬렉션](https://github.com/sickn33/antigravity-awesome-skills)