Panduan untuk mempersempit masalah koneksi, izin, Sync, dan validasi secara bertahap.
Saat Plugin Tidak Terhubung
Gejala: “Connection failed” atau plugin ditampilkan sebagai tidak terhubung di Roblox Studio.
- Verifikasi server MCP sedang berjalan:
npx -y @weppy/roblox-mcp@latest - Roblox Studio: Tab Plugins → WEPPY → klik Connect
- Pastikan tidak ada firewall, antivirus, atau VPN yang memblokir
localhost:3002 - Restart Roblox Studio dan server MCP keduanya
Saat Klien AI Tidak Mengenali Server MCP
- Verifikasi perintah yang benar digunakan di pengaturan klien AI:
npx -y @weppy/roblox-mcp@latest - Verifikasi Node.js 18 ke atas terinstal:
node --version - Di Windows, jika terjadi error izin, coba jalankan terminal dengan hak administrator
- Periksa panduan instalasi untuk aplikasi AI yang Anda gunakan
Panduan “Fitur Pro yang Diperlukan”
Ketika Anda meminta aksi khusus Pro dari Basic, solusi alternatif akan dicari dan diproses jika memungkinkan. Namun alur alternatif tersebut mengonsumsi token tambahan dan tidak selalu menjamin hasil yang sama.
Selain itu, beberapa alat khusus Pro tidak memiliki alternatif dan tidak dapat dijalankan dari Basic. Jika panduan ini terus muncul, periksa apakah aksi yang diminta tersedia pada paket Anda saat ini.
Saat Sync Tidak Berfungsi
- Periksa status Sync: minta AI untuk
manage_sync status - Pastikan plugin sudah terhubung sebelum memulai Sync
- Jika reverse sync (file → Studio) tidak berfungsi, verifikasi apakah tier Pro aktif
- Pastikan folder sync lokal ada dan memiliki izin tulis
Untuk konfigurasi Sync lebih detail, lihat Sync Dua Arah.
Klien AI yang Kompatibel
| Klien |
|---|
| Claude Code |
| Claude Desktop |
| Cursor |
| Codex CLI |
| Codex Desktop |
| Gemini CLI |
| Aplikasi berdukungan MCP |
Perintah server: npx -y @weppy/roblox-mcp@latest
Persyaratan Sistem
| Item | Minimum |
|---|---|
| Node.js | 18.0.0 ke atas |
| Roblox Studio | Versi terbaru (pertahankan pembaruan otomatis) |
| Sistem Operasi | Windows 10+ atau macOS 12+ |
| Jaringan | Harus dapat mengakses localhost:3002 |
Pesan Error yang Sering Terjadi
| Error | Penyebab | Solusi |
|---|---|---|
ECONNREFUSED localhost:3002 | Server MCP tidak berjalan | Jalankan npx -y @weppy/roblox-mcp@latest |
Timeout waiting for plugin | Plugin Studio tidak terhubung | Klik Connect di panel plugin |
Forbidden path | Mencoba mengakses CoreGui/CorePackages | Gunakan hanya jalur instans yang valid |
Place ID mismatch | Terhubung ke Place yang salah | Hubungkan ulang dari sesi Studio yang benar |
Jika Masih Butuh Bantuan
Jika masalah masih belum terselesaikan, buka GitHub Issue dengan menyertakan informasi berikut:
- Sistem operasi dan versi Node.js
- Klien AI dan versinya
- Pesan error atau log
- Langkah-langkah yang sudah dicoba
Jangan cantumkan license key mentah, tanda terima, alamat email, detail pembayaran, atau data proyek privat di issue publik. Kirim email ke [email protected] jika pertanyaan berisi informasi pembelian, lisensi, email, pembayaran, atau proyek privat.