Membangun dengan alat pengkodean

Panduan ini dan video pendampingnya membimbing Anda untuk menghubungkan alat pengkodean yang mendukung AI ke Roblox Studio melalui MCP, sehingga agen Anda dapat membaca, menulis, dan menguji 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:

1. Editor teks yang didukung AI - Pilihan yang paling populer adalah Visual Studio Code dan Cursor. Cursor memiliki asisten AI terintegrasi, sedangkan VS Code memerlukan ekstensi seperti Claude Code. Keduanya berfungsi dengan baik di sini, jadi gunakan yang paling Anda sukai.
2. Roblox Studio - Unduh dari create.roblox.com.
3. Git - Instal dari git-scm.com.

   • Di Windows, Anda dapat menggunakan WinGet: winget install --id Git.Git -e --source winget.
   • Di macOS, Anda dapat menggunakan Homebrew: brew install git.

Langkah 2: Masuk ke semuanya

1. Editor teks Anda:

   • VS Code — Proses masuk bervariasi sesuai dengan ekstensi. Untuk Claude Code, klik ikon Claude di bilah aktivitas, masuk dengan akun Anthropic Anda, dan konfirmasi panel obrolan terbuka. Penyedia lainnya serupa.
   • Cursor — Buka Cursor, masuk dengan akun Cursor Anda, dan konfirmasi panel obrolan terbuka. Anda dapat menggunakan model apa pun yang Anda pilih.
2. Roblox Studio — Buka Studio, masuk dengan akun Roblox Anda, dan konfirmasi Anda dapat membuat tempat baru.

Langkah 3: Unduh repositori awal

Repositori awal memberi Anda tata letak folder dan file .gitignore sehingga Git hanya mengkomit bagian-bagian proyek Anda yang penting. Sebagian besar pengaturan manual telah selesai untuk Anda.

1. Unduh repositori awal dan ekstrak. Ini sudah berisi folder bernama WaveSurvival.
2. 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 dapat digunakan oleh server dan klien.
   • StarterPlayerScripts/ menyimpan skrip klien yang berjalan 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

1. Buka Roblox Studio dan klik New Experience.
2. Pilih File → Save to File, navigasikan ke folder WaveSurvival Anda, dan simpan tempat sebagai WaveSurvival.rbxlx. File .gitignore repositori awal sudah mengecualikan file .rbxlx dari Git.
3. 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.

1. Dalam Studio, pilih File → Beta Features.
2. Temukan Script Sync, aktifkan, dan klik Save.
3. Nyalakan kembali Studio ketika diminta.

Langkah 6: Hubungkan Script Sync

Anda menghubungkan Script Sync sekali per proyek dengan menghubungkan setiap layanan Studio ke folder yang sesuai di disk.

1. Di Explorer, klik kanan ServerScriptService.
2. Pilih Script Sync → Sync to, lalu telusuri ke folder WaveSurvival Anda.
3. Ulangi untuk ReplicatedStorage dan StarterPlayerScripts.

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:

Di Studio, periksa Explorer. Anda seharusnya melihat Test muncul di bawah ServerScriptService. Anda akan menjalankan pemeriksaan mendalam yang dipandu agen setelah MCP terhubung.

Langkah 8: Aktifkan koneksi MCP

Server MCP Studio memungkinkan agen AI Anda berinteraksi dengan Studio secara langsung, 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.

1. Di Studio, buka jendela Asisten menggunakan tombol Assistant di sudut kanan atas.
2. Klik ⋯ → Manage MCP Servers.
3. Konfirmasi MCP diaktifkan.
4. Di bawah Quick connect, aktifkan Cursor atau Visual Studio Code.

Jika Anda menginstal editor Anda saat Studio terbuka, Anda mungkin perlu menyalakan kembali Studio, editor Anda, atau keduanya untuk membangun koneksi. Untuk detail lebih lanjut, lihat Koneksi ke server MCP Roblox Studio.

Langkah 9: Verifikasi koneksi MCP

Minta agen Anda:

Anda mungkin perlu menyetujui perintah atau menambahkan alat MCP ke daftar izin. Untuk template Baseplate yang baru, respons menggambarkan Camera, Terrain, Baseplate, dan SpawnLocation default dan mengonfirmasi tidak ada konten lain yang ada.

Langkah 10: Jalankan pemeriksaan end-to-end

Minta agen Anda untuk memverifikasi seluruh pengaturan sekaligus:

Saksikan di Studio dan Anda akan melihat agen mulai uji coba untuk mengonfirmasi output.

Langkah 11: Komit ke Git

Anda sekarang memiliki konfigurasi yang bersih dan berfungsi, yang membuat ini menjadi 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 berbicara dengannya secara langsung, dan Anda memiliki repositori Git untuk melacak perubahan dan kemajuan.

Dari sini, Anda dapat menggunakan file WAVE_SURVIVAL.md dari proyek awal sebagai konteks bagi agen Anda untuk membangun permainan bertahan gelombang. Ikuti bersama video pendamping untuk membangun permainan satu fase yang teruji pada satu waktu.