@weppy/roblox-mcp 0.1.9 → 0.1.11

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

@@ -1,6 +1,6 @@
-# Konfigurasi Gemini CLI
+# Pengaturan Gemini CLI
 
-Cara menggunakan Roblox MCP di [Google Gemini CLI](https://github.com/google-gemini/gemini-cli).
+Cara menggunakan Roblox MCP dengan [Google Gemini CLI](https://github.com/google-gemini/gemini-cli).
 
 ## Prasyarat
 
@@ -9,16 +9,32 @@ Cara menggunakan Roblox MCP di [Google Gemini CLI](https://github.com/google-gem
    node --version
    ```
 
-2. **Gemini CLI** sudah terinstal
+2. **Gemini CLI** terinstal
    ```bash
    npm install -g @google/gemini-cli
    ```
 
-3. **Plugin Roblox Studio** sudah terinstal
+3. **Plugin Roblox Studio** terinstal
 
-## Registrasi MCP Server
+## Mendaftarkan Server MCP
 
-### Metode 1: Edit File Konfigurasi (Disarankan)
+### Metode 1: Perintah CLI (Disarankan)
+
+Daftarkan dengan satu perintah di terminal Anda:
+
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -- -y @weppy/roblox-mcp
+```
+
+> Flag `--trust` melewati prompt konfirmasi untuk setiap pemanggilan tool.
+
+Untuk mendaftar secara global, tambahkan `-s user`:
+
+```bash
+gemini mcp add weppy-roblox-mcp npx -s user --trust -- -y @weppy/roblox-mcp
+```
+
+### Metode 2: Edit File Konfigurasi
 
 Tambahkan konten berikut ke file `.gemini/settings.json`:
 
@@ -34,15 +50,21 @@ Tambahkan konten berikut ke file `.gemini/settings.json`:
 ```
 
 **Lokasi file konfigurasi:**
-| Cakupan | Path |
+| Lingkup | Path |
 |---------|------|
 | Proyek | `<proyek>/.gemini/settings.json` |
 | Global | `~/.gemini/settings.json` |
 
-### Metode 2: Menggunakan Environment Variable
+### Metode 3: Menggunakan Variabel Lingkungan
+
+Jika variabel lingkungan tertentu diperlukan:
 
-Jika diperlukan environment variable tertentu:
+**CLI:**
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -e MCP_PORT=3002 -- -y @weppy/roblox-mcp
+```
 
+**File konfigurasi:**
 ```json
 {
   "mcpServers": {
@@ -59,67 +81,38 @@ Jika diperlukan environment variable tertentu:
 
 ## Tes Koneksi
 
-1. Jalankan **Roblox Studio** → Tab Plugins → **W-MCP** → **Connect**
-2. Jalankan **Gemini CLI** lalu masukkan:
+1. Buka **Roblox Studio** → tab Plugins → **W-MCP** → **Connect**
+2. Jalankan **Gemini CLI** dan masukkan:
    ```
-   Beritahu apa yang sedang dipilih di Roblox Studio
+   Beritahu saya apa yang sedang dipilih di Roblox Studio
    ```
 
-## Periksa Status MCP Server
+## Memeriksa Status Server MCP
 
-Anda dapat memeriksa status server yang terhubung dengan perintah `/mcp` di dalam Gemini CLI:
+Anda dapat memeriksa status server yang terhubung dengan perintah `/mcp` di Gemini CLI:
 
 ```
 /mcp
 ```
 
-## Konfigurasi Lanjutan
-
-### Filtering Tools
-
-Anda dapat menggunakan atau mengecualikan tools tertentu:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "excludeTools": ["execute_script"],
-      "includeTools": ["get_selection", "create_instance", "set_property"]
-    }
-  }
-}
-```
-
-> `excludeTools` lebih diprioritaskan daripada `includeTools`.
-
-### Mode Debug
-
-Untuk debugging masalah koneksi:
-
-```bash
-gemini --debug
-```
-
 ## Pemecahan Masalah
 
-### Saat server tidak dimulai
+### Server tidak dapat dimulai
 
-Jalankan MCP server langsung untuk memeriksa error:
+Jalankan server MCP secara langsung untuk memeriksa kesalahan:
 ```bash
 npx -y @weppy/roblox-mcp
 ```
 
 ### Koneksi gagal
 
-- Pastikan plugin Roblox Studio dalam status **Connected**
-- Pastikan port 3002 tidak diblokir oleh firewall
+- Verifikasi bahwa plugin Roblox Studio dalam status **Connected**
+- Periksa apakah port 3002 diblokir oleh firewall
 - Periksa status server dengan perintah `/mcp`
 
-### Konflik tools
+### Konflik tool
 
-Jika ada tools dengan nama yang sama dari beberapa MCP server, akan ditambahkan prefix dalam format `serverAlias__toolName`.
+Jika beberapa server MCP memiliki tool dengan nama yang sama, mereka akan diberi awalan dengan format `serverAlias__toolName`.
 
 ## Referensi
 

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

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

@@ -6,23 +6,21 @@
 
 ## 前提条件
 
-1. **Antigravity** がインストール済み (macOS, Windows, Linux対応)
-2. **Roblox Studioプラグイン** のインストール完了
+1. **Antigravity** がインストール済み（対応OS/要件は公式ドキュメント参照）
+2. **Node.js**（v18.0.0以上、`npx` が利用可能）
+3. **Roblox Studioプラグイン** のインストール完了
 
 ## MCPサーバーの登録
 
-### 方法1: MCP Storeからインストール (推奨)
+AntigravityではMCPサーバーを **エージェントパネル（Agent pane）** で管理します。
 
-1. Antigravityを起動
-2. **Settings** → **MCP** に移動
-3. MCP Storeで `weppy-roblox-mcp` を検索
-4. **Install** をクリック
+### Raw configで手動登録（推奨）
 
-### 方法2: 設定ファイルを直接編集
+1. エージェントパネルで **⋯** → **MCP Servers** → **Manage MCP Servers** → **View raw config** をクリック
 
-1. Antigravityで **⋯** メニュー → **MCP Servers** → **Manage MCP Servers** → **View raw config** をクリック
+![MCP Serversメニューを開く](../../../assets/screenshots/antigravity/antigravity_mcp_services_menu.png)
 
-2. `mcp_config.json` ファイルに以下の内容を追加:
+2. 表示される設定（JSON）に以下の内容を追加/マージ:
 
 ```json
 {
@@ -35,26 +33,15 @@
 }
 ```
 
-3. 保存後、**Manage MCP Servers** で **Refresh** をクリック
+![Raw configを編集](../../../assets/screenshots/antigravity/antigravity_mcp_raw.png)
 
-**設定ファイルの場所:**
+3. 保存後、**Refresh**（またはUIの案内に従って再起動/更新）を実行
 
-| OS | パス |
-|----|------|
-| macOS/Linux | `~/.gemini/antigravity/mcp_config.json` |
-| Windows | `%USERPROFILE%\.gemini\antigravity\mcp_config.json` |
+> 設定ファイルの実際のパス/名前はOSとAntigravityのバージョンによって異なる場合があります。必ず **View raw config** で案内される場所を基準に編集してください。
 
-### 方法3: Agentに依頼
+### オプション: 環境変数でポート/ログを調整
 
-Antigravity Agentに直接依頼することもできます:
-
-```
-Roblox MCP (@weppy/roblox-mcp)をMCPサーバーとして追加して
-```
-
-## 重要: 絶対パスの使用
-
-> **注意**: Antigravityは `${workspaceFolder}` 変数をサポートしていません。必ず**絶対パス**を使用してください。
+デフォルト値（HTTP `127.0.0.1:3002`）のまま利用することを推奨します。必要に応じて以下のように環境変数を設定できます:
 
 ```json
 {
@@ -63,7 +50,9 @@ Roblox MCP (@weppy/roblox-mcp)を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"
       }
     }
   }
@@ -73,29 +62,11 @@ Roblox MCP (@weppy/roblox-mcp)をMCPサーバーとして追加して
 ## 接続テスト
 
 1. **Roblox Studio** を起動 → Pluginsタブ → **W-MCP** → **Connect**
-2. **Antigravity**で以下を入力:
+2. **Antigravity**で次を入力:
    ```
    Roblox Studioで現在選択されているものを教えて
    ```
 
-## Skillsの活用
-
-Antigravityの**Skills**システムと組み合わせることで、より強力なワークフローを構築できます:
-
-- プロジェクト別のRoblox開発ワークフローを定義
-- よく使うタスクをSkillとしてパッケージ化
-- エージェントが自動的にタスクを計画、実行、検証
-
-## サポートモデル
-
-AntigravityでRoblox MCPを使用する際、以下のモデルを選択できます:
-
-| モデル | 特徴 |
-|------|------|
-| **Gemini 3 Pro** | デフォルトモデル、無料で使用可能 |
-| **Claude Sonnet 4.5** | Anthropicモデル対応 |
-| **GPT-OSS** | OpenAIモデル対応 |
-
 ## トラブルシューティング
 
 ### サーバーが起動しない場合
@@ -108,23 +79,11 @@ npx -y @weppy/roblox-mcp
 ### 接続失敗
 
 - Roblox Studioプラグインが **Connected** 状態か確認
-- ポート3002がファイアウォールでブロックされていないか確認
-- Settings → MCPでサーバー状態を確認
-
-### 絶対パスエラー
-
-`${workspaceFolder}` を使用するとエラーが発生します。絶対パスに変更してください:
-
-```json
-// ❌ 間違い
-"args": ["--workspace", "${workspaceFolder}"]
-
-// ✅ 正しい
-"args": ["--workspace", "/absolute/path/to/project"]
-```
+- ポート **3002** がファイアウォールでブロックされていないか確認
+- エージェントパネル **⋯** → **MCP Servers** でサーバー状態を確認
+- (上級) `HTTP_PORT` を変更した場合は、Roblox Studioプラグイン/ブリッジ設定も同じポートを使用するように合わせる必要があります。
 
 ## 参考資料
 
-- [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)
+- [Google Antigravity 紹介](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/)
+- [Antigravity 開始ガイド（Codelab）](https://codelabs.developers.google.com/getting-started-google-antigravity)

package/docs/ja/installation/ai-apps/gemini-cli.md

@@ -1,4 +1,4 @@
-# Gemini CLI 設定
+# Gemini CLI セットアップ
 
 [Google Gemini CLI](https://github.com/google-gemini/gemini-cli)でRoblox MCPを使用する方法です。
 
@@ -9,18 +9,34 @@
    node --version
    ```
 
-2. **Gemini CLI** がインストール済み
+2. **Gemini CLI** インストール済み
    ```bash
    npm install -g @google/gemini-cli
    ```
 
-3. **Roblox Studioプラグイン** のインストール完了
+3. **Roblox Studioプラグイン** インストール完了
 
 ## MCPサーバーの登録
 
-### 方法1: 設定ファイルの編集 (推奨)
+### 方法1: CLIコマンド（推奨）
 
-`.gemini/settings.json` ファイルに以下の内容を追加してください:
+ターミナルで1行で登録できます：
+
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -- -y @weppy/roblox-mcp
+```
+
+> `--trust`フラグは、ツール呼び出し時の確認プロンプトをスキップします。
+
+グローバル設定として登録するには、`-s user`を追加してください：
+
+```bash
+gemini mcp add weppy-roblox-mcp npx -s user --trust -- -y @weppy/roblox-mcp
+```
+
+### 方法2: 設定ファイルの編集
+
+`.gemini/settings.json`ファイルに以下の内容を追加してください：
 
 ```json
 {
@@ -34,15 +50,21 @@
 ```
 
 **設定ファイルの場所:**
-| 範囲 | パス |
-|------|------|
+| スコープ | パス |
+|----------|------|
 | プロジェクト | `<プロジェクト>/.gemini/settings.json` |
 | グローバル | `~/.gemini/settings.json` |
 
-### 方法2: 環境変数の使用
+### 方法3: 環境変数の使用
+
+特定の環境変数が必要な場合：
 
-特定の環境変数が必要な場合:
+**CLI:**
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -e MCP_PORT=3002 -- -y @weppy/roblox-mcp
+```
 
+**設定ファイル:**
 ```json
 {
   "mcpServers": {
@@ -59,67 +81,38 @@
 
 ## 接続テスト
 
-1. **Roblox Studio** を起動 → Pluginsタブ → **W-MCP** → **Connect**
-2. **Gemini CLI** を起動して以下を入力:
+1. **Roblox Studio**を起動 → Pluginsタブ → **W-MCP** → **Connect**
+2. **Gemini CLI**を実行して次のように入力：
    ```
    Roblox Studioで現在選択されているものを教えて
    ```
 
-## MCPサーバー状態の確認
+## MCPサーバーの状態確認
 
-Gemini CLI内で `/mcp` コマンドを使用して接続されているサーバーの状態を確認できます:
+Gemini CLI内で`/mcp`コマンドを使用して、接続されたサーバーの状態を確認できます：
 
 ```
 /mcp
 ```
 
-## 詳細設定
-
-### ツールのフィルタリング
-
-特定のツールのみを使用したり、除外したりできます:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "excludeTools": ["execute_script"],
-      "includeTools": ["get_selection", "create_instance", "set_property"]
-    }
-  }
-}
-```
-
-> `excludeTools` は `includeTools` より優先されます。
-
-### デバッグモード
-
-接続の問題をデバッグするには:
-
-```bash
-gemini --debug
-```
-
 ## トラブルシューティング
 
 ### サーバーが起動しない場合
 
-MCPサーバーを直接実行してエラーを確認してください:
+MCPサーバーを直接実行してエラーを確認してください：
 ```bash
 npx -y @weppy/roblox-mcp
 ```
 
 ### 接続失敗
 
-- Roblox Studioプラグインが **Connected** 状態か確認
+- Roblox Studioプラグインが**Connected**状態であることを確認
 - ポート3002がファイアウォールでブロックされていないか確認
-- `/mcp` コマンドでサーバー状態を確認
+- `/mcp`コマンドでサーバーの状態を確認
 
 ### ツールの競合
 
-複数のMCPサーバーで同じ名前のツールがある場合、`serverAlias__toolName` 形式でプレフィックスが付きます。
+複数のMCPサーバーに同じ名前のツールがある場合、`serverAlias__toolName`形式でプレフィックスが付けられます。
 
 ## 参考資料
 

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

@@ -4,7 +4,7 @@ Roblox StudioでAIエージェントと連携するためのプラグインイ
 
 ## 1. プラグインのダウンロード
 
-1. [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)から `weppy-roblox-mcp-basic.zip` をダウンロードします
+1. [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)から `weppy-roblox-mcp-basic-v{バージョン}.zip` をダウンロードします
 2. ZIPファイルを解凍します — `roblox-plugin/WeppyRobloxMCP.rbxm` ファイルとセットアップガイドが含まれています
 
 ## 2. プラグインのインストール