AI + Thrixel ile Roblox'ta Oyun Nasıl Yapılır?

Başlamadan önce Roblox Studio'yu yükleyin ve bir Roblox hesabı hazırlayın.

1. VS Code ile Rojo'yu yükleyin

1. Visual Studio Code'u (VS Code) yükleyin.
2. VS Code için Rojo - Roblox Studio Sync uzantısını yükleyin.
3. VS Code'da File > Open Folder yolunu izleyip oyun için boş bir klasör açın.
4. Komut paletini açmak için Ctrl + Shift + P (Mac'te Cmd + Shift + P) tuşlarına basın. “Rojo” yazın ve Rojo: Open Menu seçeneğini seçin.
5. Menü Rojo'nun yüklü olmadığını söylüyorsa Install Rojo now seçeneğine tıklayın.
6. Install Roblox Studio Plugin seçeneğine tıklayın. Studio açıksa yeniden başlatın. Ardından Rojo, Studio'nun Plugins sekmesinde görünmelidir.

2. Build World becerisini ekleyin

Oturum açın

Beceriyi yüklemeden önce Thrixel'de oturum açın. Komut tüm ajanlar için aynıdır ve uv gerektirir. uv yüklü değilse işletim sisteminize uygun komutu terminalde çalıştırın:

curl -LsSf https://astral.sh/uv/install.sh | sh

irm https://astral.sh/uv/install.ps1 | iex

Aşağıdaki oturum açma komutunu çalıştırın. Tarayıcı sayfası açıldığında Thrixel hesabınızı bağlamak için Approve düğmesine tıklayın.

uvx thrixel-mcp@latest login

Build World'ü yükleyin

Aşağıdan kodlama ajanınızı seçin. Build World için hem yönergeleri sağlayan beceri hem de varlık üretme araçlarını sağlayan Thrixel MCP sunucusu gerekir.

claude plugin marketplace add thrixel/build-world
claude plugin install thrixel@thrixel

codex plugin marketplace add thrixel/build-world
codex plugin add thrixel@thrixel

{
  "mcpServers": {
    "thrixel": {
      "type": "stdio",
      "command": "uvx",
      "args": ["thrixel-mcp@latest"]
    }
  }
}

git clone https://github.com/thrixel/build-world ~/.thrixel/build-world
mkdir -p ~/.cursor/skills
ln -s ~/.thrixel/build-world/skills/build-world ~/.cursor/skills/build-world

git clone https://github.com/thrixel/build-world "$HOME\.thrixel\build-world"
New-Item -ItemType Directory -Force "$HOME\.cursor\skills" | Out-Null
New-Item -ItemType Junction -Path "$HOME\.cursor\skills\build-world" -Target "$HOME\.thrixel\build-world\skills\build-world"

gemini mcp add -s user --trust thrixel uvx -- thrixel-mcp@latest
gemini skills install https://github.com/thrixel/build-world --path skills/build-world

Build World kurulum kılavuzu, elle yükleme, güncellemeler ve mevcut kurulumları da ele alır.

3. Roblox Studio'yu ayarlayın

Ajanın Studio'da kod çalıştırabilmesi ve oyunun ekran görüntülerini alabilmesi için Studio'nun MCP sunucusunu etkinleştirin.

1. Roblox Studio'yu açın ve yeni bir Baseplate oluşturun. Böylece oyunun dünyasını içeren Roblox dosyası olan bir place oluşturulur.
2. Pencerenin en sağ üst köşesindeki Assistant simgesine tıklayın.
3. Assistant panelinde … > Settings > Manage MCP Servers yolunu açın. Enable Studio as MCP server seçeneğini açın. Yeşil gösterge sunucunun çalıştığını doğrular.

4. Roblox API anahtarı oluşturun

Rojo, 3D model dosyalarını eşitlemez. Ajan modelleri ayrı olarak yüklemek için bir Roblox API anahtarı kullanır.

1. Creator Hub kimlik bilgileri sayfanıza gidin ve Create API Key düğmesine tıklayın.
2. Access Permissions altında Assets API sistemini ekleyin. Sahip olarak kendi hesabınızı seçip Read ve Write izinlerini etkinleştirin.
3. Accepted IP Addresses altında 0.0.0.0/0 ekleyin veya IP kısıtlamalarını kapatın. Bu alan boş bırakılırsa yüklemeler tamamlanamaz.
4. Bu anahtar tüm IP adreslerinden erişime izin verdiği için 30 gün gibi kısa bir geçerlilik süresi belirleyin.
5. Save düğmesine tıklayıp anahtarı kopyalayın. Anahtar yalnızca bir kez gösterilir.
6. Anahtarı oyun klasöründeki roblox_api_key.txt adlı dosyaya kaydedin. Bu dosyayı Git'e eklemeyin.

5. Sunucuyu çalıştırın

Sunucuyu VS Code'dan başlatın

1. VS Code'da Ctrl + Shift + P (Mac'te Cmd + Shift + P) ile komut paletini açın. “Rojo” yazıp Rojo: Open Menu seçeneğini seçin.
2. Klasörde Rojo projesi yoksa Create one now seçeneğine tıklayın. Rojo, default.project.json dosyasını ve oyunun başlangıç klasörlerini ekler.
3. Projects in this workspace altında oynat simgesinin yanındaki proje adına tıklayın.

VS Code'un sağ alt köşesindeki bildirim, sunucunun localhost üzerinde 34872 portunu dinlediğini doğrular. Durdurmak için Rojo menüsünü açıp projeye tekrar tıklayın. Sunucu çalışırken oynat simgesi durdur simgesine dönüşür.

Roblox Studio'yu sunucuya bağlayın

1. Roblox Studio'daki Baseplate place'ine dönün.
2. Plugins sekmesini açıp Rojo düğmesine tıklayın.
3. Sunucu farklı bir port bildirmediyse adresi localhost, portu 34872 olarak bırakın.
4. Connect düğmesine tıklayın.
5. “Sync changes for project” altında Rojo'nun place üzerinde yapacağı değişiklikleri inceleyip Accept düğmesine tıklayın.

Rojo penceresinde artık proje adı, sunucu adresi ve Disconnect düğmesi görünür. Studio bağlanmıştır ve değişiklik almaya hazırdır.

Studio bağlanamıyorsa tarayıcıda http://localhost:34872/ adresini açın. Rojo durum sayfası sunucunun çalıştığını doğrular.

6. Oyununuzu geliştirin

Thrixel Cubes

Thrixel, 3D varlık üretimi için Cubes ücretlendirir. Toplam maliyet, kullanılan işlemlere ve oyundaki varlık sayısına bağlıdır. Bazı işlemler sabit ücretlidir; diğerleri kullanıma göre ölçülür ve çalıştıktan sonra ücretlendirilir. Tam bir oyun geliştirmek, kodlama ajanının plan limitlerinin de önemli bir bölümünü tüketebilir. Büyük bir projeye başlamadan önce bakiyenizi kontrol edin ve güncel ücretleri Thrixel'in web sitesinden inceleyin.

Build World'ü çalıştırın

1. Kodlama ajanını Rojo projesinin bulunduğu klasörde açın.
2. Mesajınıza ajanınızın Build World komutuyla başlayın:

   Ajan	Komut
   Claude Code	/thrixel:build-world
   Codex	$build-world
   Cursor	/build-world
   Gemini CLI	/build-world

3. Komuttan sonra oyunu tarif edin. Becerinin doğru motoru kullanması için “Roblox” ifadesini ekleyin.
4. Ajanın ikinci bir sunucu başlatmaması için Rojo'nun zaten çalıştığını ve portunu belirtin.

Codex'te $build yazıp beceri seçiciden build-world becerisini seçin, ardından oyun açıklamasını ekleyin.

/thrixel:build-world Roblox'ta yüzen adalarda geçen bir engelli parkur oyunu yap. Rojo ve Studio eklentisi zaten ayarlandı, Rojo bu klasörü 34872 portunda sunuyor; başka sunucu başlatma.

Roblox Studio'da değişiklikleri kabul edin

Onay, Rojo'nun ilk bağlantısında verilir. Bağlantıdan sonra Rojo, ajan değişiklikleri diske kaydeder kaydetmez eşitler.

• Bağlanırken: Rojo dosyalar ile place arasındaki farkları listeler. Uygulamak için Accept, bağlantıyı iptal etmek için Abort düğmesine tıklayın. Fark yoksa onay istemeden bağlanır.
• Ajan çalışırken: Yeni ve düzenlenen betikler Studio'da otomatik görünür. Studio kapatıldıysa veya bağlantı kesildiyse ajan istediğinde Connect düğmesine yeniden tıklayın. Ajan Rojo'yu kendisi yeniden bağlayamaz.
• Değişiklikleri incelemek için: Rojo penceresinde son değişiklik zamanına tıklayarak View changes görünümünü açın. Uygulanan değişiklikler listelenir ve başarısız olanlar işaretlenir. Rojo değişiklikleri Studio'nun geri alma geçmişine de kaydedilir.

Bir grup değişikliği eşitlemeden önce incelemek için Rojo penceresindeki Settings bölümünü açıp Confirmation Behavior ayarını Always yapın. Disconnect düğmesine tıklayın, ajanın bitirmesini bekleyin ve değişiklikleri birlikte incelemek için Connect düğmesine tıklayın. Bu inceleme bağlantı sırasında yapılır. Etkin bağlantı sırasında kaydedilen değişiklikler yine otomatik eşitlenir.

İki işlem elle yapılmalıdır:

• İçe aktarılanları kaydedin. Rojo betikleri ve nesne örneklerini eşitler. Ajan 3D modelleri ayrı yükleyip ReplicatedStorage.Assets içine eklediğinden bu modeller proje dosyalarında saklanmaz. Onları korumak için Studio'da File > Save seçeneğini kullanın.
• Eşitlenen betikleri proje dosyalarında düzenleyin. Rojo'nun iki yönlü eşitlemesi varsayılan olarak kapalıdır. Studio'da bu betiklerde yapılan düzenlemeler dosyalara aktarılmaz ve üzerlerine yazılabilir.

7. Oyununuzu yayımlayın

Oyun paylaşılmaya hazır olduğunda Studio'da File > Publish to Roblox seçeneğini kullanın.