Kodlama Araçları ile İnşa Et

Bu kılavuz ve eşlik eden video, ajanın sizin adınıza okuma, yazma ve oyun testi yapabilmesi için MCP aracılığıyla Roblox Studio'ya AI destekli bir kodlama aracı bağlamanızı sağlar.

Sonunda, Script Sync (kendi editörünüzü kullanarak kod yazmanıza olanak tanıyan bir özellik) aracılığıyla Studio ile senkronize olan bir proje klasörüne, ajanın doğrudan Studio'yu kontrol etmesine olanak tanıyan bir MCP bağlantısına ve geliştirme için hazır bir Git deposuna sahip olacaksınız.

Adım 1: Ön koşulları yükleyin

Başlamadan önce aşağıdaki bileşenlere ihtiyacınız olacak:

1. AI destekli bir metin editörü - En popüler seçenekler Visual Studio Code ve Cursordir. Cursor, AI asistanını yerleşik olarak sunarken, VS Code'un Claude Code gibi bir uzantıya ihtiyacı vardır. Her ikisi de burada iyi çalışır, bu yüzden hangisini tercih ederseniz onu kullanın.
2. Roblox Studio - create.roblox.com adresinden indirin.
3. Git - git-scm.com adresinden yükleyin.

   • Windows'ta WinGet kullanabilirsiniz: winget install --id Git.Git -e --source winget.
   • macOS'ta Homebrew kullanabilirsiniz: brew install git.

Adım 2: Her şeye giriş yapın

1. Metin editörünüz:

   • VS Code — Giriş yapma, uzantıya göre değişir. Claude Code için, etkinlik çubuğundaki Claude simgesine tıklayın, Anthropic hesabınızla giriş yapın ve sohbet panelinin açıldığını onaylayın. Diğer sağlayıcılar benzer şekilde çalışır.
   • Cursor — Cursor'u açın, Cursor hesabınızla giriş yapın ve sohbet panelinin açıldığını onaylayın. Tercih ettiğiniz herhangi bir modeli kullanabilirsiniz.
2. Roblox Studio — Studio'yu açın, Roblox hesabınızla giriş yapın ve yeni bir yer oluşturabileceğinizi onaylayın.

Adım 3: Başlangıç deposunu indirin

Başlangıç deposu, klasör düzenini ve Git'in projenizin önemli kısımlarını yalnızca takip etmesi için bir .gitignore dosyasını sağlar. Çoğu manuel ayar sizin için yapılmıştır.

1. başlangıç deposunu indirin ve çıkarın. Zaten WaveSurvival adında bir klasör içerir.
2. Editörünüzde Dosya → Klasör Aç seçeneğini seçin ve WaveSurvival klasörünü seçin. İçinde üç klasör görmelisiniz:

   • ServerScriptService/ oyun mantığı, düşman AI ve dalga yönetimi gibi sunucu betiklerini tutar.
   • ReplicatedStorage/ hem sunucunun hem de istemcinin kullanabileceği paylaşılan modülleri tutar.
   • StarterPlayerScripts/ her oyuncu için çalışan istemci betiklerini tutar.

Her klasörün içindeki .gitkeep dosyaları, Git'in klasörleri boşken bile takip etmesi için yer tutuculardır.

Adım 4: Roblox Studio'da boş bir proje oluşturun

1. Roblox Studio'yu açın ve Yeni Deneyim seçeneğine tıklayın.
2. Dosya → Dosyaya Kaydet seçeneğini seçin, WaveSurvival klasörünüze gidin ve yeri WaveSurvival.rbxlx olarak kaydedin. Başlangıç deposunun .gitignore dosyası, .rbxlx dosyalarını Git'ten zaten hariç tutar.
3. Studio'yu açık tutun. Script Sync ve MCP için buna ihtiyacınız olacak.

Adım 5: Script Sync beta sürümünü etkinleştirin

Script Sync bir beta özelliğidir, bu yüzden kullanmadan önce etkinleştirmeniz gerekir.

1. Studio'da Dosya → Beta Özellikler seçeneğini seçin.
2. Script Sync'i bulun, etkinleştirin ve Kaydet'e tıklayın.
3. İstendiğinde Studio'yu yeniden başlatın.

Adım 6: Script Sync'i bağlayın

Script Sync'i her proje için bir kez bağlayarak her Studio hizmetini disk üzerindeki eşleşen klasöre bağlarsınız.

1. Explorer'da ServerScriptService'e sağ tıklayın.
2. Script Sync → Senkronize Et seçeneğini seçin, ardından WaveSurvival klasörünüze göz atın.
3. ReplicatedStorage ve StarterPlayerScripts için de tekrarlayın.

Bu klasörlerde oluşturduğunuz herhangi bir .luau dosyası artık otomatik olarak Studio'da betik olarak görünür.

Adım 7: Script Sync'i doğrulayın

Editörünüzün sohbet panelinde ajanınızı şu şekilde yönlendirin:

Studio'da Explorer'ı kontrol edin. ServerScriptService altında Test'in göründüğünü görmelisiniz. MCP bağlandığında daha derin bir, ajana dayalı kontrol gerçekleştireceksiniz.

Adım 8: MCP bağlantısını etkinleştirin

Studio MCP sunucusu, AI ajanın Studio ile doğrudan etkileşimde bulunmasını sağlar; oyun ağacını okuma, nesneler oluşturma, betikler çalıştırma ve çıktıyı kontrol etme gibi işlemleri gerçekleştirir. Script Sync'in ulaşamadığı her şeyi kapsar, örneğin StarterGui ve StarterPack.

1. Studio'da, sağ üstteki Asistan butonunu kullanarak Asistan penceresini açın.
2. ⋯ → MCP Sunucularını Yönet seçeneğine tıklayın.
3. MCP'nin etkin olduğunu onaylayın.
4. Hızlı bağlantı altında Cursor veya Visual Studio Code'u etkinleştirin.

Eğer editörünüzü Studio açıkken yüklediyseniz, bağlantıyı kurmak için Studio'yu, editörünüzü veya her ikisini de yeniden başlatmanız gerekebilir. Daha fazla ayrıntı için Roblox Studio MCP sunucusuna bağlanın sayfasına bakın.

Adım 9: MCP bağlantısını doğrulayın

Ajanınızı şu şekilde yönlendirin:

Komutu onaylamanız veya MCP aracını bir izin listesine eklemeniz gerekebilir. Yeni bir Baseplate şablonu için yanıt, varsayılan Camera, Terrain, Baseplate ve SpawnLocation'ı tanımlar ve henüz başka içerik olmadığını onaylar.

Adım 10: Uçtan uca kontrol gerçekleştirin

Ajanınızı tüm ayarları bir kerede doğrulaması için yönlendirin:

Studio'da izleyin ve ajanın çıktıyı doğrulamak için bir oyun testi başlattığını göreceksiniz.

Adım 11: Git'e taahhüt edin

Artık temiz, çalışan bir yapılandırmaya sahipsiniz, bu da taahhüt etmek için iyi bir an. Terminalinizden:

git add .
git commit -m "Script sync connected and MCP verified"

Sonraki adımlar

Projeniz artık Studio ile senkronize, AI ajanın doğrudan onunla iletişim kurabiliyor ve değişiklikleri ve ilerlemeyi takip etmek için bir Git deponuz var.

Buradan itibaren, ajanın bir dalga hayatta kalma oyunu inşa etmesi için başlangıç projesinden WAVE_SURVIVAL.md dosyasını bağlam olarak kullanabilirsiniz. Oyunu bir test edilmiş aşama aşama inşa etmek için eşlik eden videoyu takip edin.