Kodlama Kafesi 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 kafesinin nasıl bağlanacağını göstermektedir.

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

Adım 1: Gereksinimleri 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 Cursor gibi seçeneklerdir. Cursor, AI asistanını entegre şekilde sunarken, VS Code'un Claude Code gibi bir eklentiye ihtiyacı vardır. Her ikisi de burada iyi çalışmaktadır, bu yüzden tercih ettiğinizi kullanın.
2. Roblox Studio - Bunu create.roblox.com'dan indirin.
3. Git - Bunu git-scm.com'dan 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, eklentiye göre değişir. Claude Code için aktivite ç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 şekildedir.
   • 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 yerleşimini ve yalnızca projenizin önemli kısımlarını Git'in taahhüt etmesini sağlayan bir .gitignore dosyasını sağlar. Manuel kurulumun çoğu sizin için yapılmıştır.

1. Başlangıç deposunu indirin ve çıkarın. Zaten WaveSurvival adlı 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'sı ve dalga yönetimi gibi sunucu betiklerini tutar.
   • ReplicatedStorage/ hem sunucu hem de istemcinin kullanabileceği paylaşılmış modülleri tutar.
   • StarterPlayerScripts/ her oyuncu için çalışan istemci betiklerini tutar.

Her klasör içindeki .gitkeep dosyaları, Git'in klasörleri boşken bile takip edebilmesi 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ği olduğundan, kullanmadan önce etkinleştirmeniz gerekir.

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

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

Her proje için yalnızca bir kez Script Sync bağlayarak her Studio hizmetini disk üzerindeki karşılık gelen klasöre ilişkilendirin.

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

Bu klasörlerde oluşturduğunuz herhangi bir .luau dosyası artık Studio'da otomatik olarak yapılandırma 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 Testin belirmesi gerekir. MCP bağlandığında daha derin, ajan destekli bir 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ına olanak tanır; oyun ağacını okur, nesneler oluşturur, betikler çalıştırır ve çıktıyı kontrol eder. StarterGui ve StarterPack gibi Script Sync'in ulaşamadığı her şeyi kapsar.

1. Studio'da, sağ üst köşedeki Asistan butonunu kullanarak Asistan penceresini açın.
2. ⋯ → MCP Sunucularını Yönet seçeneğine tıklayın.
3. MCP'nin etkinleştirildiğini 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ı kurabilmek için Studio'yu, editörünüzü veya her ikisini birden yeniden başlatmanız gerekebilir. Daha fazla ayrıntı için Roblox Studio MCP sunucusuna bağlanın kısmını inceleyin.

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. Temiz 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ştir

Ajanınıza tüm kurulumu bir defada doğrulamasını isteyin:

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 sahip olduğunuz için bu, taahhüt etmek için iyi bir zaman. Terminalinizden:

git add .
git commit -m "Script sync bağlandı ve MCP doğrulandı"

Sonraki adımlar

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

Buradan sonra, ajanın bir dalga hayatta kalma oyunu inşa etmesi için başlangıç projesinden WAVE_SURVIVAL.md dosyasını bağlam olarak kullanabilirsiniz. Oyun bir deneme aşamasında inşa edilirken eşlik eden videoyu takip edin.