@weppy/roblox-mcp 2.5.1 → 2.6.0

package/docs/id/installation/README.md

@@ -1,93 +0,0 @@
-# Panduan Instalasi
-
-Untuk menggunakan Roblox MCP, kamu perlu install **dua hal**.
-
-```
-Aplikasi AI (Claude, Codex, Gemini, dll)
-       │
-   MCP Server ← Mengubah perintah AI jadi format yang Roblox mengerti
-       │
-Plugin Roblox Studio ← Menjalankan perintah di dalam Studio
-```
-
-Ketika aplikasi AI bilang "buatkan part biru", MCP server mengonversi perintah ini, dan plugin Roblox Studio yang benar-benar membuat part tersebut.
-
----
-
-## Instalasi Satu Perintah (Direkomendasikan)
-
-Install semuanya dengan satu perintah:
-
-**macOS / Linux**
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
-```
-
-**Windows (PowerShell)**
-
-```powershell
-irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
-```
-
-Restart Roblox Studio — selesai!
-
-Pendaftaran MCP otomatis mendukung **Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI, dan Antigravity**.
-
-Jika eksekusi PowerShell diblokir di Windows, lanjutkan dengan instalasi manual di bawah. Jika kamu memakai paket ZIP, kamu juga bisa menjalankan `setup-plugin.bat` dan `setup-mcp.bat`.
-
----
-
-## Instalasi Manual
-
-Jika instalasi satu perintah tidak berjalan, atau jika instalasi otomatis tidak bisa dipakai di lingkunganmu, gunakan instalasi manual di bawah sebagai alternatif.
-
-### Langkah 1: Install Plugin Roblox Studio
-
-Download file plugin dari GitHub, lalu taruh di folder Plugins Roblox Studio.
-
-👉 [Panduan Instalasi Plugin](https://weppyai.com/en/install#plugin)
-
----
-
-### Langkah 2: Daftarkan MCP Server di Aplikasi AI
-
-Daftarkan MCP server ke aplikasi AI yang kamu pakai. Bisa digunakan di semua aplikasi AI yang mendukung MCP.
-
-| Aplikasi AI | Cara Konfigurasi |
-|-------------|------------------|
-| Claude Code | [Lihat caranya](ai-apps/claude-code.md) |
-| Claude Desktop | [Lihat caranya](ai-apps/claude-app.md) |
-| Cursor | [Lihat caranya](ai-apps/cursor.md) |
-| Codex CLI | [Lihat caranya](ai-apps/codex-cli.md) |
-| Codex Desktop | [Lihat caranya](ai-apps/codex-app.md) |
-| Gemini CLI | [Lihat caranya](ai-apps/gemini-cli.md) |
-| Antigravity | [Lihat caranya](ai-apps/antigravity.md) |
-
-> Aplikasi AI lain yang mendukung MCP juga bisa dipakai. Command MCP server-nya: `npx -y @weppy/roblox-mcp`
-
----
-
-## Opsional: Install WEPPY Roblox Explorer (Ekstensi VSCode)
-
-Jelajahi tree instance yang sudah disinkronkan di dalam VSCode dengan ikon kelas Roblox.
-Ekstensi opsional ini mengharuskan setup Roblox MCP di atas sudah selesai lebih dulu, karena Explorer membaca data Sync dari `weppy-project-sync` di bawah root proyek.
-
-👉 [Panduan Instalasi WEPPY Roblox Explorer](https://weppyai.com/en/install#explorer)
-
-Instal langsung:
-- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
-- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
-
----
-
-## Setelah Instalasi Selesai
-
-1. Buka **Roblox Studio**, di tab Plugins klik **WEPPY** → **Connect**
-2. Di **aplikasi AI**, coba test:
-
-```
-Buatkan part biru di Roblox Studio
-```
-
-Kalau part-nya berhasil dibuat, berarti instalasi sudah selesai!

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

@@ -1,89 +0,0 @@
-# Pengaturan Antigravity
-
-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 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 (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
-
-## Mendaftarkan server MCP
-
-Di Antigravity, server MCP dikelola di **panel agen (Agent pane)**.
-
-### Pendaftaran manual lewat raw config (disarankan)
-
-1. Di panel agen, klik **⋯** → **MCP Servers** → **Manage MCP Servers** → **View raw config**
-
-![Buka menu MCP Servers](../../../assets/screenshots/antigravity/antigravity_mcp_services_menu.png)
-
-2. Pada konfigurasi (JSON) yang ditampilkan, tambahkan/gabungkan isi berikut:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-![Edit raw config](../../../assets/screenshots/antigravity/antigravity_mcp_raw.png)
-
-3. Setelah menyimpan, lakukan **Refresh** (atau restart/refresh sesuai petunjuk UI)
-
-> Lokasi/nama file konfigurasi yang sebenarnya bisa berbeda tergantung OS dan versi Antigravity, jadi selalu edit berdasarkan lokasi yang ditunjukkan di **View raw config**.
-
-### Opsi: Atur port/log lewat variabel lingkungan
-
-Disarankan untuk mempertahankan nilai default (HTTP `127.0.0.1:3002`). Jika diperlukan, Anda dapat mengatur variabel lingkungan seperti berikut:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "env": {
-        "HTTP_HOST": "127.0.0.1",
-        "HTTP_PORT": "3002",
-        "LOG_LEVEL": "INFO"
-      }
-    }
-  }
-}
-```
-
-## Uji koneksi
-
-1. Jalankan **Roblox Studio** → tab Plugins → **WEPPY** → **Connect**
-2. Di **Antigravity**, masukkan:
-   ```
-   Beri tahu saya apa yang sedang dipilih di Roblox Studio saat ini
-   ```
-
-## Pemecahan masalah
-
-### Jika server tidak dapat dijalankan
-
-Jalankan server MCP secara langsung untuk melihat error:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### Gagal terhubung
-
-- 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
-
-- [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/claude-app.md

@@ -1,78 +0,0 @@
-# Konfigurasi Claude Desktop App
-
-Cara menggunakan Roblox MCP di [Claude Desktop App](https://claude.ai/download).
-
-## Prasyarat
-
-- **Claude Desktop App** sudah terinstal
-- **Node.js** (v18.0.0 atau lebih tinggi)
-- **Plugin Roblox Studio** sudah terinstal
-
-## Registrasi MCP Server
-
-### Metode 1: Desktop Extensions (Disarankan)
-
-> Mulai 2026, instalasi sekali klik tersedia seperti ekstensi browser
-
-1. Claude Desktop → **Settings** → **Extensions**
-2. Cari `weppy-roblox-mcp`
-3. Klik **Install**
-
-### Metode 2: Edit File Konfigurasi Langsung
-
-1. Claude Desktop → **Settings** → **Developers** → Klik **Edit Config**
-
-2. Tambahkan konten berikut ke file `claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-3. **Tutup sepenuhnya** Claude Desktop lalu restart
-
-**Lokasi file konfigurasi:**
-
-| OS | Path |
-|----|------|
-| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
-| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
-
-## Tes Koneksi
-
-1. Jalankan **Roblox Studio** → Tab Plugins → **WEPPY** → **Connect**
-2. Mulai percakapan baru di **Claude Desktop** dan tes:
-   ```
-   Buatkan part biru di Roblox Studio
-   ```
-
-## Pemecahan Masalah
-
-### MCP server tidak dimuat
-
-1. **Periksa sintaks JSON**: Validasi file konfigurasi dengan JSON validator online
-2. **Restart Claude Desktop sepenuhnya**: Setelah mengubah konfigurasi, pastikan untuk menutup aplikasi sepenuhnya lalu restart
-3. **Periksa path**: Pastikan command dan args sudah benar
-
-### 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
-
-## Referensi
-
-- [Panduan Resmi MCP Claude Desktop](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop)
-- [Panduan Koneksi MCP Server](https://modelcontextprotocol.io/docs/develop/connect-local-servers)

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

@@ -1,104 +0,0 @@
-# Konfigurasi Claude Code
-
-Cara menggunakan Roblox MCP di [Claude Code](https://claude.ai/code) (tools coding AI berbasis terminal).
-
-## Prasyarat
-
-- **Claude Code** sudah terinstal
-- **Plugin Roblox Studio** sudah terinstal
-
-## Instalasi
-
-```bash
-npm install -g @anthropic-ai/claude-code
-```
-
-## Registrasi MCP Server
-
-### Metode 1: Instal dari Marketplace (Disarankan)
-
-Jalankan di terminal Claude Code:
-
-```bash
-# Tambah marketplace
-/plugin marketplace add hope1026/weppy-roblox-mcp
-
-# Instal plugin
-/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
-```
-
-Verifikasi instalasi:
-```bash
-/plugin list
-```
-
-### Metode 2: Edit File Konfigurasi Langsung
-
-Buat file `.mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-**Lokasi file konfigurasi:**
-
-| Cakupan | Path |
-|---------|------|
-| Proyek | `<proyek>/.mcp.json` |
-| Global | `~/.claude/mcp.json` |
-
-## Manajemen Server Otomatis
-
-Claude Code mengelola MCP server secara otomatis:
-
-- Dimulai otomatis saat diperlukan
-- Berhenti otomatis saat sesi berakhir
-- Tidak perlu konfigurasi tambahan
-
-## Tes Koneksi
-
-1. Jalankan **Roblox Studio** → Tab Plugins → **WEPPY** → **Connect**
-2. Tes di **Claude Code**:
-   ```
-   Buatkan part biru di Roblox Studio
-   ```
-
-## Pemecahan Masalah
-
-### Instalasi plugin gagal
-
-```bash
-# Bersihkan cache lalu coba lagi
-/plugin cache clear
-/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
-```
-
-### Server tidak dimulai
-
-1. Periksa versi Node.js (minimal 18.0):
-   ```bash
-   node --version
-   ```
-
-2. Tes jalankan server secara manual:
-   ```bash
-   npx -y @weppy/roblox-mcp
-   ```
-
-### Tools MCP tidak terlihat
-
-Periksa di Claude Code:
-```
-Tampilkan daftar tools MCP yang tersedia
-```
-
-## Referensi
-
-- [Dokumentasi Resmi Claude Code](https://docs.anthropic.com/claude-code)

package/docs/id/installation/ai-apps/codex-app.md

@@ -1,56 +0,0 @@
-# Konfigurasi Codex App
-
-Cara menggunakan Roblox MCP di [OpenAI Codex App](https://openai.com/codex/) (macOS).
-
-> **Dirilis 2 Februari 2026** - Aplikasi native macOS yang mendukung workflow multi-agent
-
-## Prasyarat
-
-- **Codex App** sudah terinstal (macOS)
-- **Plugin Roblox Studio** sudah terinstal
-
-## Registrasi MCP Server
-
-### Sinkronisasi Otomatis dari Konfigurasi Codex CLI
-
-Jika Anda sudah mengkonfigurasi MCP di Codex CLI, Anda dapat langsung menggunakannya di aplikasi **tanpa konfigurasi tambahan**.
-
-```
-Riwayat sesi CLI dan konfigurasi secara otomatis disinkronkan ke aplikasi.
-```
-
-### Untuk Konfigurasi Baru
-
-Tambahkan di **Settings** → **MCP Servers** dalam aplikasi:
-
-```
-Server name: weppy-roblox-mcp
-Command: npx -y @weppy/roblox-mcp
-```
-
-## Tes Koneksi
-
-1. Jalankan **Roblox Studio** → Tab Plugins → **WEPPY** → **Connect**
-2. Mulai percakapan baru di **Codex App** dan tes:
-   ```
-   Beritahu apa yang sedang dipilih di Roblox Studio
-   ```
-
-## 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
-
-## Referensi
-
-- [Pengenalan Codex App](https://openai.com/index/introducing-the-codex-app/)
-- [Dokumentasi Resmi Codex MCP](https://developers.openai.com/codex/mcp/)

package/docs/id/installation/ai-apps/codex-cli.md

@@ -1,67 +0,0 @@
-# Konfigurasi Codex CLI
-
-Cara menggunakan Roblox MCP di [OpenAI Codex CLI](https://github.com/openai/codex) (tools coding AI berbasis terminal).
-
-## Prasyarat
-
-- **Node.js** (v18.0.0 atau lebih tinggi)
-- **Plugin Roblox Studio** sudah terinstal
-
-## Instalasi
-
-```bash
-npm install -g @openai/codex
-```
-
-## Registrasi MCP Server
-
-### Metode 1: Perintah CLI (Disarankan)
-
-```bash
-codex mcp add weppy-roblox-mcp -- npx -y @weppy/roblox-mcp
-```
-
-### Metode 2: Edit File Konfigurasi Langsung
-
-Tambahkan konten berikut ke file `~/.codex/config.toml`:
-
-```toml
-[mcp_servers.weppy-roblox-mcp]
-command = "npx"
-args = ["-y", "@weppy/roblox-mcp"]
-```
-
-**Lokasi file konfigurasi:**
-
-| OS | Path |
-|----|------|
-| macOS/Linux | `~/.codex/config.toml` |
-| Windows | `%USERPROFILE%\.codex\config.toml` |
-
-## Tes Koneksi
-
-1. Jalankan **Roblox Studio** → Tab Plugins → **WEPPY** → **Connect**
-2. Jalankan **Codex CLI** lalu masukkan:
-   ```
-   Beritahu apa yang sedang dipilih di Roblox Studio
-   ```
-
-## 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
-
-## Referensi
-
-- [Codex CLI GitHub](https://github.com/openai/codex)
-- [Dokumentasi Resmi Codex MCP](https://developers.openai.com/codex/mcp/)
-- [Referensi Konfigurasi Codex](https://developers.openai.com/codex/config-reference/)

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

@@ -1,77 +0,0 @@
-# Pengaturan Cursor
-
-Cara menggunakan Roblox MCP dengan [Cursor](https://cursor.com/).
-
-## Prasyarat
-
-- **Cursor** sudah terpasang
-- **Node.js** (v18.0.0 atau lebih baru)
-- **Plugin Roblox Studio** sudah terpasang
-
-## Mendaftarkan server MCP
-
-### Metode 1: Konfigurasi proyek
-
-Tambahkan isi berikut ke `.cursor/mcp.json` di proyek Anda:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-### Metode 2: Konfigurasi global
-
-Tambahkan isi yang sama ke file konfigurasi global Cursor.
-
-**Lokasi file konfigurasi:**
-
-| Cakupan | Path |
-|---------|------|
-| Proyek | `<proyek>/.cursor/mcp.json` |
-| Global (macOS/Linux) | `~/.cursor/mcp.json` |
-| Global (Windows) | `%USERPROFILE%\\.cursor\\mcp.json` |
-
-> Jika file sudah ada, gabungkan entri `weppy-roblox-mcp` ke dalam objek `mcpServers` yang sudah ada.
-
-### Terapkan perubahan
-
-Setelah mengubah konfigurasi, muat ulang jendela Cursor atau mulai ulang aplikasinya.
-
-## Uji koneksi
-
-1. Buka **Roblox Studio** → tab Plugins → **WEPPY** → **Connect**
-2. Di **Cursor**, masukkan:
-   ```
-   Tell me what's currently selected in Roblox Studio
-   ```
-
-## Pemecahan masalah
-
-### Server MCP tidak muncul
-
-- Pastikan path file konfigurasi sudah benar
-- Pastikan sintaks JSON valid
-- Muat ulang Cursor setelah mengubah konfigurasi
-
-### Server tidak bisa dijalankan
-
-Jalankan server MCP secara langsung untuk memeriksa error:
-
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### Koneksi gagal
-
-- Pastikan plugin Roblox Studio berada dalam status **Connected**
-- Periksa apakah port 3002 diblokir firewall
-
-## Referensi
-
-- [Dokumentasi Cursor MCP](https://docs.cursor.com/context/model-context-protocol)

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

@@ -1,120 +0,0 @@
-# Pengaturan Gemini CLI
-
-Cara menggunakan Roblox MCP dengan [Google Gemini CLI](https://github.com/google-gemini/gemini-cli).
-
-## Prasyarat
-
-1. **Node.js** (v18.0.0 atau lebih tinggi)
-   ```bash
-   node --version
-   ```
-
-2. **Gemini CLI** terinstal
-   ```bash
-   npm install -g @google/gemini-cli
-   ```
-
-3. **Plugin Roblox Studio** terinstal
-
-## Mendaftarkan Server MCP
-
-### 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`:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-**Lokasi file konfigurasi:**
-| Lingkup | Path |
-|---------|------|
-| Proyek | `<proyek>/.gemini/settings.json` |
-| Global | `~/.gemini/settings.json` |
-
-### Metode 3: Menggunakan Variabel Lingkungan
-
-Jika variabel lingkungan tertentu diperlukan:
-
-**CLI:**
-```bash
-gemini mcp add weppy-roblox-mcp npx --trust -e HTTP_PORT=3002 -- -y @weppy/roblox-mcp
-```
-
-**File konfigurasi:**
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "env": {
-        "HTTP_PORT": "3002"
-      }
-    }
-  }
-}
-```
-
-## Tes Koneksi
-
-1. Buka **Roblox Studio** → tab Plugins → **WEPPY** → **Connect**
-2. Jalankan **Gemini CLI** dan masukkan:
-   ```
-   Beritahu saya apa yang sedang dipilih di Roblox Studio
-   ```
-
-## Memeriksa Status Server MCP
-
-Anda dapat memeriksa status server yang terhubung dengan perintah `/mcp` di Gemini CLI:
-
-```
-/mcp
-```
-
-## Pemecahan Masalah
-
-### Server tidak dapat dimulai
-
-Jalankan server MCP secara langsung untuk memeriksa kesalahan:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### Koneksi gagal
-
-- Verifikasi bahwa plugin Roblox Studio dalam status **Connected**
-- Periksa apakah port 3002 diblokir oleh firewall
-- Periksa status server dengan perintah `/mcp`
-
-### Konflik tool
-
-Jika beberapa server MCP memiliki tool dengan nama yang sama, mereka akan diberi awalan dengan format `serverAlias__toolName`.
-
-## Referensi
-
-- [Dokumentasi Resmi Gemini CLI MCP](https://geminicli.com/docs/tools/mcp-server/)
-- [Panduan Konfigurasi Gemini CLI](https://geminicli.com/docs/get-started/configuration/)