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 - 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 - 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 yang tidak dapat dialihkan sama sekali tidak dapat dieksekusi dari Basic. Jika panduan ini terus muncul berulang kali, pertimbangkan untuk beralih ke Pro.
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 | Basic | Pro |
|---|---|---|
| Claude Code | ✅ | ✅ |
| Claude Desktop | ✅ | ✅ |
| Cursor | ✅ | ✅ |
| Codex CLI | ✅ | ✅ |
| Codex Desktop | ✅ | ✅ |
| Gemini CLI | ✅ | ✅ |
| Aplikasi berdukungan MCP | ✅ | ✅ |
Perintah server: npx -y @weppy/roblox-mcp
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 |
Perbandingan Fitur Basic vs Pro
Basic (gratis) pun dapat menggunakan sebagian besar alur kerja inti coding AI secara langsung. Semua alat inti untuk menangani instans·properti·skrip·seleksi·kamera·log termasuk, serta Sync satu arah Studio → Local dan riwayat eksekusi alat tetap tersedia. Pro menambahkan Sync dua arah, operasi massal, dan paket alat lanjutan seperti terrain·pencahayaan·fisika·audio·animasi.
| Fitur | Basic | Pro |
|---|---|---|
| Cari·buat·hapus·klon·pindahkan instans | ✅ | ✅ |
| Jelajahi pohon·hierarki instans | ✅ | ✅ |
| Baca·tulis properti·tag | ✅ | ✅ |
| Baca·tulis·modifikasi skrip | ✅ | ✅ |
| Manajemen seleksi | ✅ | ✅ |
| Pindahkan·fokuskan kamera | ✅ | ✅ |
| Kueri log | ✅ | ✅ |
| Info sistem·periksa koneksi | ✅ | ✅ |
| Riwayat·statistik eksekusi alat | ✅ | ✅ |
| Sync satu arah Studio → Local | ✅ | ✅ |
| Sync dua arah (Local → Studio) | — | ✅ |
| Direction / Apply Mode per tipe | — | ✅ |
| Riwayat perubahan Sync | — | ✅ |
| Sinkronisasi multi Place (maks. 3) | — | ✅ |
| Operasi massal (buat·modifikasi massal) | — | ✅ |
| Kontrol pencahayaan·atmosfer | — | ✅ |
| Buat·edit terrain | — | ✅ |
| Kontrol tween·animasi | — | ✅ |
| Kontrol audio | — | ✅ |
| Partikel·efek | — | ✅ |
| Grup fisika·tabrakan | — | ✅ |
| Kueri spasial·raycast | — | ✅ |
| Cari·sisipkan·ekspor aset | — | ✅ |
| Tangkap screenshot | — | ✅ |
| Eksekusi otomatis Playtest·injeksi tes | — | ✅ |
| Eksekusi batch·kode Luau arbitrer | — | ✅ |
Ketika Anda meminta fitur khusus Pro dari Basic, solusi alternatif akan diproses dalam batas yang memungkinkan, tetapi konsumsi token meningkat dan beberapa fitur tidak dapat dialihkan. Lihat item Panduan “Fitur Pro yang Diperlukan” di atas untuk informasi lebih lanjut.
Pesan Error yang Sering Terjadi
| Error | Penyebab | Solusi |
|---|---|---|
ECONNREFUSED localhost:3002 | Server MCP tidak berjalan | Jalankan npx -y @weppy/roblox-mcp |
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, hubungi di GitHub Discussions dengan menyertakan informasi berikut:
- Sistem operasi dan versi Node.js
- Klien AI dan versinya
- Pesan error atau log
- Langkah-langkah yang sudah dicoba