Panduan ini dan video yang menyertainya akan memandu Anda melalui proses menghubungkan harness pengkodean yang didukung AI ke Roblox Studio melalui MCP, sehingga agen Anda dapat membaca, menulis, dan melakukan pengujian permainan atas nama Anda.
Pada akhir panduan ini, Anda akan memiliki folder proyek yang disinkronkan ke Studio melalui Script Sync (fitur yang memungkinkan Anda menggunakan editor Anda sendiri untuk menulis kode), koneksi MCP yang memungkinkan agen Anda mengendalikan Studio secara langsung, dan repositori Git yang siap untuk pengembangan.
Langkah 1: Instal prasyarat
Anda akan memerlukan komponen berikut sebelum memulai:
- Editor teks yang didukung AI - Opsi yang paling populer adalah Visual Studio Code dan Cursor. Cursor memiliki asisten AI yang terintegrasi, sementara VS Code memerlukan ekstensi seperti Claude Code. Keduanya bekerja dengan baik di sini, jadi gunakan yang Anda sukai.
- Roblox Studio - Unduh dari create.roblox.com.
- Git - Instal dari git-scm.com.
Langkah 2: Masuk ke semua layanan
- Editor teks Anda:
- VS Code — Proses masuk bervariasi tergantung pada ekstensi. Untuk Claude Code, klik ikon Claude di bilah aktivitas, masuk dengan akun Anthropic Anda, dan pastikan panel obrolan terbuka. Penyedia lain serupa.
- Cursor — Buka Cursor, masuk dengan akun Cursor Anda, dan pastikan panel obrolan terbuka. Anda dapat menggunakan model apa pun yang Anda sukai.
- Roblox Studio — Buka Studio, masuk dengan akun Roblox Anda, dan pastikan Anda dapat membuat tempat baru.
Langkah 3: Unduh repositori pemula
Repositori pemula memberi Anda tata letak folder dan file .gitignore sehingga Git hanya mengkomit bagian proyek Anda yang penting. Sebagian besar pengaturan manual sudah dilakukan untuk Anda.
- Unduh repositori pemula dan ekstrak. Ini sudah berisi folder bernama WaveSurvival.
- Di editor Anda, pilih File → Open Folder dan pilih WaveSurvival. Anda harus melihat tiga folder di dalamnya:
- ServerScriptService/ menyimpan skrip server, seperti logika permainan, AI musuh, dan manajemen gelombang.
- ReplicatedStorage/ menyimpan modul yang dibagikan yang dapat digunakan oleh server dan klien.
- StarterPlayerScripts/ menyimpan skrip klien yang dijalankan untuk setiap pemain.
File .gitkeep di dalam setiap folder adalah placeholder sehingga Git melacak folder saat masih kosong.
Langkah 4: Buat proyek kosong di Roblox Studio
- Buka Roblox Studio dan klik New Experience.
- Pilih File → Save to File, navigasikan ke folder WaveSurvival Anda, dan simpan tempat sebagai WaveSurvival.rbxlx. File .gitignore dari repositori pemula sudah mengecualikan file .rbxlx dari Git.
- Biarkan Studio terbuka. Anda akan membutuhkannya untuk Script Sync dan MCP.
Langkah 5: Aktifkan beta Script Sync
Script Sync adalah fitur beta, jadi Anda perlu mengaktifkannya sebelum dapat menggunakannya.
Studio sering diperbarui. Jika Anda tidak melihat Script Sync dalam daftar, instal versi terbaru Studio dan coba lagi.
- Di Studio, pilih File → Beta Features.
- Temukan Script Sync, aktifkan, dan klik Save.
- Mulai ulang Studio saat diminta.
Langkah 6: Hubungkan Script Sync
Anda menghubungkan Script Sync sekali per proyek dengan mengaitkan setiap layanan Studio ke folder yang sesuai di disk.
- Di Explorer, klik kanan ServerScriptService.
- Pilih Script Sync → Sync to, lalu telusuri ke folder WaveSurvival Anda.
- Ulangi untuk ReplicatedStorage dan StarterPlayerScripts.
Pilih folder WaveSurvival tingkat atas, bukan folder di dalamnya. Karena folder sudah memiliki nama yang benar, Script Sync secara otomatis mencocokkan setiap layanan dengan yang tepat.
Setiap file .luau yang Anda buat di folder tersebut sekarang muncul sebagai skrip di Studio secara otomatis.
Langkah 7: Verifikasi Script Sync
Di panel obrolan editor Anda, minta agen Anda:
Buat skrip uji di ServerScriptService/Test.server.luau yang mencetak 'Hello from Script Sync!' ke output.
Di Studio, periksa Explorer. Anda harus melihat Test muncul di bawah ServerScriptService. Anda akan menjalankan pemeriksaan lebih dalam yang dipandu agen setelah MCP terhubung.
Langkah 8: Aktifkan koneksi MCP
Server MCP Studio memungkinkan agen AI Anda berinteraksi langsung dengan Studio, membaca pohon permainan, membuat objek, menjalankan skrip, dan memeriksa output. Ini mencakup apa pun yang tidak dapat dijangkau oleh Script Sync, seperti StarterGui dan StarterPack.
- Di Studio, buka jendela Asisten menggunakan tombol Assistant di sudut kanan atas.
- Klik ⋯ → Manage MCP Servers.
- Pastikan MCP diaktifkan.
- Di bawah Quick connect, aktifkan Cursor atau Visual Studio Code.
Jika Anda menginstal editor Anda saat Studio terbuka, Anda mungkin perlu memulai ulang Studio, editor Anda, atau keduanya untuk membangun koneksi. Untuk detail lebih lanjut, lihat Connect to the Roblox Studio MCP server.
Langkah 9: Verifikasi koneksi MCP
Minta agen Anda:
Gunakan MCP Roblox untuk membaca pohon permainan saat ini di Roblox Studio. Daftar apa yang ada di Workspace.
Anda mungkin perlu menyetujui perintah atau menambahkan alat MCP ke daftar izin. Untuk template Baseplate yang baru, responsnya menggambarkan Camera, Terrain, Baseplate, dan SpawnLocation default dan mengonfirmasi bahwa belum ada konten lain.
Langkah 10: Jalankan pemeriksaan end-to-end
Minta agen Anda untuk memverifikasi seluruh pengaturan sekaligus:
Gunakan koneksi MCP Roblox untuk memverifikasi Script Sync berfungsi dengan baik. Lakukan beberapa perubahan pada Test.server.luau, tambahkan skrip baru di dua folder lainnya, dan verifikasi output masing-masing. Jalankan game:GetService("InstanceFileSyncService"):GetStatus(instance) di setiap skrip untuk memverifikasi status sinkronisasi. Setelah selesai, hapus ketiga skrip tersebut.
Saksikan di Studio dan Anda akan melihat agen mulai pengujian permainan untuk mengonfirmasi output.
Langkah 11: Komit ke Git
Anda sekarang memiliki konfigurasi yang bersih dan berfungsi, yang menjadikannya momen yang baik untuk melakukan komit. Dari terminal Anda:
git add .
git commit -m "Script sync terhubung dan MCP diverifikasi"Langkah selanjutnya
Proyek Anda sekarang disinkronkan ke Studio, agen AI Anda dapat berkomunikasi langsung dengannya, dan Anda memiliki repositori Git untuk melacak perubahan dan kemajuan.
Dari sini, Anda dapat menggunakan file WAVE_SURVIVAL.md dari proyek pemula sebagai konteks bagi agen Anda untuk membangun permainan bertahan gelombang. Ikuti video pendamping untuk membangun permainan satu fase yang teruji pada satu waktu.