RoCode dokümantasyonu

RoCode nedir

RoCode (RoCode.app), Roblox Studio'da kod yazan bir yapay zeka ajanıdır. rocode.app'teki bir web sohbetinde bir özellik anlatırsın. Ardından Roblox Creator Store'daki ücretsiz RoCode plugin'i ajanın adımlarını açık olan oyununda uygular: bir adımın ihtiyaç duyduğu nesneleri ve scriptleri okur, Luau kodunu yazar, Script, LocalScript, ModuleScript ve diğer instance'ları oluşturur ya da düzenler ve bitirmeden önce scriptlerinin derlendiğini Studio içinde kontrol eder.

DeepSeek V4 Flash, GLM 5.3 Flash, Claude Sonnet 5.5, Claude Opus 5.5 ve GPT-6 Astra, RoCode'un kendi talimatları ve Studio araçlarıyla OpenRouter üzerinden çalıştırdığı üçüncü taraf modellerdir. RoCode'un kendi modeli yok.

RoCode (rocode.app), VS Code eklentisi Roo Code değildir; RoCodes.gg ya da rocode.org da değildir.

Gereksinimler

Gerekmeyenler: masaüstü uygulaması, komut satırı, yapılandırma dosyaları, bir MCP sunucusu ya da Roblox şifren. RoCode Roblox şifreni asla sormaz.

Plugin'i kurmak ve sohbetle eşleştirmek

Adım adım kurulum ve bağlantı

1. Ücretsiz hesap aç. rocode.app'e e-posta kodu, Google, Roblox ya da Discord ile giriş yap.
2. Plugin'i kur. Creator Store'daki RoCode plugin'ini aç ve kur. Kurulu plugin'ler Studio'nun Plugins sekmesinde görünür. Studio'nun plugin yöneticisinde RoCode, RoCode AI olarak görünür.
3. İzinleri ver. Studio sorduğunda relay.rocode.app'e HTTP isteklerine ve Script Injection'a izin ver. Aşağıdaki tablo nedenini anlatıyor.
4. Bir oyun aç, Roblox Studio'da: üzerinde çalıştığın bir oyun ya da yeni bir Baseplate.
5. Sohbeti aç. rocode.app/chat'i bir masaüstü tarayıcıda aç. Studio, RoCode'a giriş yaptığın ya da bağladığın Roblox hesabıyla oturum açmışsa kendiliğinden bağlanır (plugin 3.9.13 ya da üstü). Sohbette Connect Studio görünürse tıkla.
6. Ya da bir eşleştirme kodu kullan. Studio kendiliğinden bağlanmazsa RoCode paneli 8 karakterlik bir kod gösterir; görmüyorsan Use a pairing code'a tıkla. Sohbetteki Connect to Roblox Studio kartına kodu yaz ve Connect'e bas.
7. Studio'da onayla. Bir koddan sonra RoCode paneli hesabını gösteren bir onay satırı gösterir. Orada Connect'e (ya da Allow'a) bas. En fazla 2 dakika bekler, sonra yeni bir kod gösterir.

Plugin'in istediği Studio izinleri

Bir Studio ayarı isteğe bağlı ve senin işin: Enable Studio Access to API Services. Studio'da data store ile kaydetmeyi test etmek için gerekir ve RoCode bunu senin yerine değiştiremez. Studio'da File > Experience Settings > Security aç, ayarı etkinleştir ve Save'e tıkla. Oyunun önce yayınlanmış olması gerekir. Studio bundan sonra canlı oyunla aynı data store'ları kullanır, bu yüzden Roblox bunu sadece ayrı bir test kopyasında açmanı öneriyor.

Eşleştirme nasıl çalışır

27 Eylül 2026'dan beri açık bir sohbet, aynı ağdaki herhangi bir Studio'yu artık bağlamıyor. Studio ya tek kullanımlık 8 karakterlik kodla ya da sadece RoCode hesabına bağlı Roblox hesabıyla oturum açmışsa bağlanır. Daha fazla ayrıntı İngilizce dokümantasyonda.

İlk çalıştırman

Bağlı bir Studio olana kadar sohbet mesaj göndermez: gönder butonu kapalı kalır ve üzerine gelince Connect the plugin first gösterir. Studio bağlanınca bir değişiklik anlat.

İyi bir ilk prompt yaz

• Her seferinde bir özellik. Tek mesajda bütün bir oyundan daha iyi çalışır.
• Ne olması gerektiğini söyle, sıradan kelimelerle. Sınıf adlarını ya da scriptlerin nereye gittiğini bilmen gerekmez.
• Önemli olanı göster. Değiştirmek istediğin script gibi bir Studio nesnesinin tam yolunu eklemek için mesaj kutusuna / yaz. + butonuyla her modelde mesaj başına en fazla 12 metin dosyası (toplam 20.000 karakter) ve en fazla 4 görsel de ekleyebilirsin.
• Sadece bir soru mu? Mesaj kutusunu Ask'e çevir, oyununda hiçbir şey değişmez.
• Ya da sesle söyle. Mikrofon butonu prompt'unu kaydeder; metin mesaj kutusunda görünür, düzenleyip gönderebilirsin.

Bizim yazdığımız örnek bir prompt. Araç adları gerçek, ama bir çalıştırmanın ne yaptığı oyununa bağlı. Plugin 3.9 ya da üstüyle RoCode kısa bir testi kendisi yapabilir; sonucu test etmek için Studio'da her zaman Play'e basabilirsin.

RoCode şeyleri nereye koyar

Çalışırken gördüklerin

• Adım adım bir kayıt. Sohbet her adımı aracın adıyla gösterir. Her okuma ve her silme yoluyla birlikte görünür.
• Ne kadar sürer. Göreve, oyununun büyüklüğüne ve modele bağlı. Bir çalıştırma en fazla 80 model turu ya da 5 saat sürebilir. Sohbet, çalışırken bir çalıştırmanın kullandığı kredileri gösterir.
• Sonraki prompt'un sırada bekleyebilir. Bir çalıştırma sürerken sonraki prompt'unu sıraya koyabilirsin. Aynı anda en fazla 3 çalıştırman olabilir.
• Test sırasında düzenleme yok. Bir değişiklik sırası geldiğinde süren bir test varsa RoCode önce testi durdurur, senin başlattığın bir test de dahil. Studio 20 saniye sonra hâlâ Play'deyse hiçbir şeyi değiştirmez ve Stop'a basmanı ister.

Durdurmak ve devam etmek

Bir çalıştırmayı istediğin zaman durdurabilirsin. Bir çalıştırma bir hata ya da kullanım sınırı yüzünden yarıda kalırsa o ana kadar yapılan değişiklikler kalır ve Continue kaldığı yerden devam eder. Durdurduğun çalıştırmalar durdukları yere kadar sayılır. Bir çalıştırma bizim tarafımızdaki bir sorun yüzünden başarısız olursa kredileri otomatik olarak bakiyene geri döner.

Build ve Ask modları

Her mesaj iki moddan birinde çalışır. Build varsayılan moddur ve oyununu değiştirir. 9 Ekim 2026'da eklenen Ask, oyununla ilgili soruları cevaplar ve hiçbir şeyi değiştirmez.

Mod değiştirmek için mesaj kutusunun altındaki çubukta mod seçiciye tıkla ve Ask ya da Build'i seç. Seçim o tarayıcıda hatırlanır, bu yüzden bir değişiklik göndermeden önce seçiciye bak. Ask da oyununu okuduğu için bağlı bir Studio ister. Ask bir düzeltme önerdiğinde Build'e geç ve değişikliği iste.

Kontroller, Output ve geri alma

Check Script bir scripti Studio içindeki Luau derleyicisinden geçirir. Bir derleme hatası satırı ve sütunuyla geri gelir. Ayrıca task.wait(), task.spawn() ve task.delay() yerine wait(), spawn() ve delay(), loadstring, bir ModuleScript'i göstermeyen bir require ya da var olmayan bir GetService adı gibi riskli kalıplar için uyarır. Tip kontrolü yapmaz, lint yapmaz ve kodunu çalıştırmaz; yani derleme hatalarını ve bazı riskli kalıpları yakalar, mantık hatalarını değil. Bir kontrol başarısız olursa RoCode bir başkası geçene kadar bitiremez; iki denemeden sonra bitirebilir ve neyin hâlâ başarısız olduğunu söyler.

Testlerindeki hatalar. RoCode, Studio'nun Output'unu sadece bir adım istediğinde okur, genellikle Check Output ile. Senin bulduğun bir sorunu düzeltmek için: Studio'da Play'e bas ve sorunu yeniden oluştur, RoCode'a neyin bozulduğunu söyle (önce Stop'a basabilirsin: son testinin Server ve Client satırları saklanır), Output'u okuyup scripti düzenlemesine izin ver ve onaylamak için yeniden Play'e bas.

Kısa test. Plugin 3.9 ya da üstüyle bir Build çalıştırması en fazla 30 saniyelik bir test için Play'e basabilir, sunucu ve istemcinin hata ve uyarılarını toplayabilir ve testi durdurabilir. Bunu çalıştırma başına en fazla iki kez yapar, artı kendi düzeltmesini kontrol etmek için bir kez. Plugin 3.9.11 ya da üstüyle bir test karakteri yürür, zıplar ve parçalara basar, 3.9.15 ya da üstüyle de tuşlara basar, ekrandaki butonlara tıklar ve yazı yazar. Sonra şeylerin olduğunu kontrol eder ve her kontrolü geçti ya da kaldı olarak raporlar. Oyunun eğlenceli olup olmadığını bilemez.

Görsel kontrol. Plugin 3.9.14 ya da üstüyle görünür bir şey kuran bir Build çalıştırması, bitirmeden önce Studio'da düzenleme modunda ekran görüntüleri alır ve bir yapay zeka modeli havada duran ya da zemine gömülü parçalar, boşluklar veya yanlış ölçek gibi belirgin sorunları arar, böylece ajan gerçek olanları düzeltir. Sohbet ekran görüntülerini göstermez ve RoCode onları saklamaz.

Geri alma. RoCode, Studio'da her değişiklik grubundan önce ve sonra bir geri alma noktası koyar, yani Studio açık kaldığı sürece Ctrl+Z (Mac'te ⌘Z) işini grup grup geri alır. Bir çalıştırma genelde birkaç gruptan oluşur. Sohbetteki Revert butonu sadece konuşmayı geri sarar, Studio'yu değil.

Silmeler. 9 Ekim 2026'dan beri RoCode bir nesneyi sadece onu aynı sohbette daha önce kendisi oluşturduysa, mesajın onu kaldırmayı ya da yeniden kurmayı istiyorsa ya da sana sorup evet dediysen siler. Plugin 3.8.5 ya da üstüyle silinen bir nesne yok edilmez: ServerStorage içindeki RoCodeTrash klasörüne gider; bu klasör son 30 çalıştırmanın silinenlerini tutar (en fazla 25.000 nesne). Ayrıntılar Deletions (İngilizce) bölümünde.

Modeller, krediler ve planlar

Kredi nedir. Bir kredi, bir çalıştırmanın hesaplama maliyetini ölçer. Daha güçlü modeller ve daha uzun çalıştırmalar daha fazla kullanır. Mevcut ücretlerle gelişmiş bir görev yaklaşık 4 kredi, standart bir görev (DeepSeek V4 Flash) yaklaşık 0,4 kredi kullanır. Bu da Pro ile ayda yaklaşık 35 gelişmiş ya da 350 standart görev, Studio ile yaklaşık 80 ya da 750, Ultra ile yaklaşık 125 ya da 1.200 eder. Uzun görevler daha fazla kullanır. Ücretsiz modelle 1 kredi bir ya da iki küçük göreve yeter.

• Tüm planlarda 27 aracın hepsi var. Ücretli planlar daha fazla model, kendi OpenRouter anahtarını ve günlük sınırsızlık ekler; çalıştırmaları sırada Starter'dan önce gelir. Ücretli planlar ayrıca DeepSeek V4 Flash ile günde 2 ücretsiz kredi alır.
• Ücretsiz krediler için RoCode Discord'una katılmak gerekmez, ödeme yapmak için de gerekmez.
• Starter kredileri her gün 00:00 UTC'de yenilenir; aylık planlarınki her ay ödemen işlendiğinde, yıllık planlarınki de 30 günde bir. Plan kredileri birikmez.
• Her planda kredi paketleri: 4,99 $'a 50 kredi, 19,99 $'a 220, 49,99 $'a 580 ve 99,99 $'a 1.200. Hiç sona ermez.
• Ödemeyi satıcı kaydı olarak Paddle yönetir. RoCode kart bilgisi saklamaz. 18 yaşından küçüksen satın almadan önce kart sahibine sor.
• Yenilemeler ve paketler dahil her ödemeden sonra 14 gün içinde, hangi sebeple olursa olsun, nerede yaşarsan yaşa tam iade. paddle.net üzerinden ya da Paddle makbuzunu yanıtlayarak istenir. Bir iadeden sonra yeni planlar, yükseltmeler ve paketler 60 gün boyunca beklemeye alınır.

Yükseltmeler, plan değişiklikleri ve tam karşılaştırma fiyatlar sayfasında (İngilizce).

Güvenlik: RoCode neye erişir ve nasıl geri alınır

• Sadece RoCode sunucusu. Plugin'in kendi istekleri şifreli bir bağlantı üzerinden sadece relay.rocode.app'e gider. Studio'nun kendisi, Insert Model'in yerleştirdiği Creator Store modellerini yüklemek ve plugin 3.9.13 ya da üstüyle oturum açtığı Roblox adını sorgulamak için Roblox ile iletişim kurar.
• Şifren asla. RoCode Roblox şifreni asla sormaz ve oyun dosyanı asla yüklemez.
• Tek Studio penceresi. Hesabına aynı anda sadece bir Studio penceresi bağlıdır. Bir adım istediğinde RoCode o pencerede açık olan oyundaki herhangi bir nesneyi ya da scripti okuyabilir; okuduğu şey OpenRouter üzerinden modeli barındıran sağlayıcıya gider.
• Yayınlama ya da harcama yok. Plugin'de oyununu yayınlayacak ya da kaydedecek, asset yükleyecek ya da Robux harcayacak kod yok. Insert Model sadece Creator Store'da zaten var olan, senin kelimelerinle ya da verdiğin bir asset ID veya bağlantıyla bulunan asset'leri yerleştirir ve bir modelin getirdiği scriptleri kaldırır.
• Salt okunur mod. Ask sadece 10 okuma aracını kullanabilir ve RoCode sunucusu oyununu değiştirecek her aracı Studio'ya ulaşmadan reddeder.
• Anahtarın. Kendi OpenRouter anahtarını eklersen, kaydedilmeden önce AES-256-GCM ile şifrelenir.
• Ödeme. Ödeme Paddle checkout'unda yapılır, yani kartını bir RoCode formuna değil Paddle'a girersin.

RoCode'u kim işletiyor: Birleşik Krallık'ta RoCode adıyla faaliyet gösteren bireysel bir tüccar (koşullara (İngilizce) bak); e-posta support@rocode.app. Gizlilikle ilgili her şey Privacy and security bölümünde (İngilizce).

Sınırlar ve RoCode'un yapmadıkları

RoCode'un bugün yapmadıkları

• Oyununun eğlenceli olup olmadığına karar vermek ya da kendi kısa testleri dışında onu senin yerine oynamak.
• Oyunun çalışırken ekran görüntüsü almak. Görsel kontrol sadece bir Build çalıştırmasının kurduğunu, düzenleme modunda yakalar.
• Terrain'i elle şekillendirmek ya da boyamak. Üretilen bir scriptle Terrain (tepeler, dağlar, göller, nehirler, adalar ve plajlar) kurabilir; elle rötuşlar sana kalır.
• Mesh, doku ya da animasyonu sıfırdan üretmek. Bunun yerine Insert Model, Creator Store'da zaten var olan modelleri yerleştirir: senin kelimelerinle bulduklarını ya da verdiğin asset ID veya bağlantıyla bir model, decal veya mesh.
• Oyununu yayınlamak ya da kaydetmek veya Roblox web sitesinde deneyim ayarlarını değiştirmek.
• Tek bir cümleden bitmiş ve dengelenmiş bir oyun kurmak.
• Telefonda çalışmak.

Ayrıca game pass, developer product, asset yükleme ya da API Services'i açmak için araçları yok. 27 aracın, 12 hazır yapının ve 7 arayüz düzeninin tam listesi The 27 tools (İngilizce) bölümünde, tüm sınırlar da Limits (İngilizce) bölümünde.

Sorun giderme

Kurulum sorunlarının çoğu bunlardan biridir. Seninki değilse destek verilen yer olan RoCode Discord'unda sor. Tüm durumlar Troubleshooting (İngilizce) bölümünde.

Sık sorulan sorular

Kaynaklar ve ek okumalar

• RoCode'un tam dokümantasyonu (İngilizce). 27 araç, gizlilik ve tüm sınırlar
• Roblox Creator Store'da RoCode plugin'i. bu sayfanın anlattığı plugin
• Fiyatlar (İngilizce). tüm planlar, kredi paketleri ve iadeler
• Kullanım koşulları (İngilizce)
• Roblox Creator Docs: Data stores (İngilizce). Studio'nun API Services erişimini açmak