Claude Code ile Neredeyse Her Oyuna Nasıl Mod Yapılır?

Eskiden bir oyuna mod yapmak için programlama bilgisi, oyun motorunun nasıl çalıştığını anlama ve grafikleri kendiniz oluşturabilme becerisi gerekiyordu. Artık bu işin bir kısmını bir yapay zekâ ajanına devredebilirsiniz. Claude Code için universal-modder eklentisi, ajana oyunun motorunu tanımayı, doğru mod yükleyiciyi seçmeyi, kod yazmayı, sprite üretmeyi ve sonucu çalışan oyunda test etmeyi öğretiyor. Bu rehberde eklentinin nasıl çalıştığını, nasıl kurulacağını ve onunla ilk modunuzu nasıl oluşturacağınızı anlatacağız.

universal-modder, yapay zekâ ajanının neredeyse tüm PC oyunları için mod oluşturmasına yardımcı olan ücretsiz bir Claude Code eklentisidir. Rehan tarafından geliştirilen eklenti, GitHub üzerinde açık kaynaklı bir proje olarak sunuluyor ve MIT Lisansı ile dağıtılıyor. Yazının yazıldığı sırada güncel sürüm 0.2.0. Daha önce universal-modder’ın oyun içinde doğrudan nasıl varlık ürettiğini, kod yazdığını ve modları test ettiğini ele almıştık.

Claude Code kendi başına kod yazabilir, ancak belirli bir oyunun yapısının nasıl olduğunu veya topluluğunun genellikle hangi mod yükleyiciyi kullandığını kendiliğinden bilemez. Eklenti bu boşluğu dolduruyor. Ajanın kullanımına farklı motorlara yönelik talimatlar içeren bir dizi beceri, oyunlarla çalışmak için um adlı komut satırı aracı ve sprite, doku, 3B model ve ses üretebilen fal hizmeti sunuyor.

Eklenti, favori oyununa özel bir eşya, düşman veya mekanik eklemek isteyen ama programlama bilmeyen oyunculara da oyun kodunu inceleyip doğru işlevleri bulmak için yardım arayan yeni mod yapımcılarına da fayda sağlayabilir.

Eklentiyi kurmadan önce, sizin için kod yazacak yapay zekâ ajanını indirip yüklemeniz gerekiyor. Bu örnekte söz konusu ajan Claude Code.

Claude Code, Anthropic’in terminalde çalışan yapay zekâ destekli kodlama ajanıdır. Bilgisayarınızdaki dosyaları okuyup oluşturabilir, komut çalıştırabilir ve kod yazabilir. Kullanmak için Pro, Max, Team veya Enterprise gibi ücretli bir Claude aboneliğine ya da API faturalandırması etkinleştirilmiş bir Claude Console hesabına ihtiyacınız var.

Sistem gereksinimleri:

Mod yapmanız muhtemel oyunların çoğu Windows’ta çalışıyor. Ayrıca oyun başlatma, ekran görüntüsü alma ve video kaydetme gibi bazı eklenti araçları özellikle Windows için tasarlanmış. Bu nedenle rehberin geri kalanında Windows kurulum sürecine odaklanacağız.

Resmî Git web sitesine gidip yükleyiciyi indirin ve çalıştırın. Kurulum boyunca varsayılan ayarları değiştirmeden ilerleyebilirsiniz. Git iki nedenle gerekiyor: Claude Code, Git ile birlikte gelen Git Bash kabuğunu kullanıyor; eklentinin kendisi de GitHub’dan indiriliyor.

Başlat düğmesine sağ tıklayın ve Terminal ya da Windows PowerShell’i seçin. Pencereye irm https://claude.ai/install.ps1 | iex yapıştırıp Enter’a basın. macOS ve Linux’ta terminali açıp curl -fsSL https://claude.ai/install.sh | bash komutunu çalıştırın. Kurulum tamamlandıktan sonra terminali kapatıp yeni bir pencere açın. Kullanmak istediğiniz proje klasörüne gidin ve claude komutuyla Claude Code’u başlatın. Kurulumu claude --version komutuyla doğrulayabilirsiniz; yüklü sürüm numarası görüntülenmelidir. Bir sorun çıkarsa claude doctor komutunu çalıştırın; program eksik olanları bildirir.

İleride oluşturacağınız modlar için ayrı bir klasör açın; örneğin C:\mods. Ajan kodlarını, varlıklarını ve çalışma günlüğünü buraya kaydedecek. Bu klasörde bir terminal açıp claude komutuyla Claude Code’u başlatın. İlk çalıştırmada program sizden bir renk teması ve giriş yöntemi seçmenizi ister. Claude aboneliğini veya Console kimlik doğrulamasını seçin. Yetkilendirme için tarayıcıda bir sayfa açılacak. Giriş yapıp erişim izni verin ve terminale geri dönün. Son olarak Claude Code, geçerli klasöre güvenip güvenmediğinizi soracak. Onaylayınca mesaj giriş alanı görünür.

Eklentiyi kurmadan önce, araç zincirinde kullanılan programları yüklemeniz iyi olur. Ardından eklentiyi Claude Code’a ekleyip varlık üretim hizmeti için bir API anahtarı sağlamanız yeterli.

Araç zincirinde şu bileşenler kullanılıyor:

Windows’ta bu programların tümünü yerleşik winget paket yöneticisi üzerinden kurabilirsiniz. Bir terminal açıp aşağıdaki komutları sırayla çalıştırın:

Kurulumdan sonra terminali yeniden başlatın. Her şeyin doğru yüklendiğinden emin olmak için python --version, uv --version ve ffmpeg -version komutlarını çalıştırın.

Claude Code’u mod klasörünüzde başlatıp eklenti pazar yerini ekleyen komutu girin: /plugin marketplace add rehan-remade/universal-modder. Ardından eklentiyi /plugin install universal-modder\@universal-modder komutuyla kurun. Program hangi kapsamı kullanmak istediğinizi soracak. Eklentinin her klasörde kullanılabilmesi için User’ı seçin. Kurulumdan sonra Claude Code’un iletisini kontrol edin. Eklentinin bileşenlerinin yeniden yüklenmesi gerekiyorsa /reload-plugins komutunu çalıştırın. Claude Desktop kullanıyorsanız yerel bir Code oturumu açın, giriş alanının yanındaki + simgesine tıklayın ve Plugins > Add plugin yolunu izleyin. universal-modder pazar yerini ekleyip eklentiyi kurun ve istediğiniz kurulum kapsamını seçin.

fal; modlar için gereken görselleri, varlıkları, modelleri ve diğer kaynakları üreten bir hizmettir. Eklenti API anahtarı olmadan da çalışır, ancak ajan kendi başına sprite, model veya ses üretemez. Hizmet ücretlidir: her üretim bakiyenizden düşer; 3B model ve video üretimi en pahalı işlemler arasındadır. fal.ai adresine gidip hesap oluşturun ve bakiyenize para ekleyin. Ardından API keys sayfasını açıp yeni bir anahtar oluşturun ve kopyalayın. Anahtar yalnızca bir kez gösterildiği için hemen kaydedin. Sonra FAL_KEY ortam değişkenini kullanarak anahtarı sisteme tanıtın. Windows’ta terminalde aşağıdaki komutu çalıştırıp yer tutucuyu kendi anahtarınızla değiştirin: setx FAL_KEY your_key.

macOS ve Linux’ta export FAL_KEY=your_key satırını \~/.bashrc ya da \~/.zshrc dosyasına ekleyin. Ardından terminali yeniden başlatın. Anahtarı, proje klasöründe FAL_KEY=your_key satırını içeren bir .env dosyasına da koyabilirsiniz. um aracı anahtarı buradan okuyabilir; ancak Claude Code’daki fal MCP sunucusu anahtarı yalnızca ortam değişkeninden okur.

Eklentide iki tür komut bulunuyor: Claude Code içinde eğik çizgi komutuyla çağrılan beceriler ve ajanın terminalde çalıştırdığı um aracı komutları. Bunları ezberlemeniz gerekmiyor. Çoğu durumda ne istediğinizi günlük dille anlatmanız yeterli; ajan uygun beceriyi kendisi seçer. Yine de komutları bilmek, ajanın ne yaptığını anlamanıza yardımcı olur.

Tüm becerilerde eklenti öneki kullanılır; örneğin /universal-modder:mod-any-game. İsteğinizi beceri adının hemen ardından yazabilirsiniz.

İşleyişi, örnek olarak bir Terraria modu üzerinden anlatalım. Terraria, ilk modunuz için iyi bir seçim; çünkü hile karşıtı koruması yok, tModLoader Steam’de resmî olarak bulunuyor ve oyun devasa bir mod ekosistemine sahip. Ayrıca en iyi Terraria modları hakkındaki derlememize de göz atabilirsiniz. universal-modder’ın bilgi tabanında oyunla ilgili ayrıntılı notlar zaten bulunuyor. Belirli araçlar değişse de süreç diğer oyunlarda temelde aynı.

Başlamadan önce oyunu Steam’den satın alıp yüklediğinizden emin olun. Ardından Steam mağazasındaki ücretsiz tModLoader uygulamasını bulun ve kütüphanenize ekleyin. Mod yükleyici, oyun olmadan çalışmaz; ajan da oyunun size ait olma denetimini atlamaz. Klasörlerini oluşturabilmesi için tModLoader’ı bir kez elle başlatıp kapatın. C:\mods\terraria-boomerang gibi bir proje klasörü oluşturun, orada terminal açın ve claude komutuyla Claude Code’u başlatın.

Ana beceriyi çağırıp görevi hemen açıklayın. İsteğiniz ne kadar net olursa ajanın o kadar az ek soru sorması gerekir: /universal-modder:mod-any-game Steam’deki Terraria sürümü için, oyuncuya dönmeden önce düşmanlar arasında dört kez seken bir bumerang ekleyen mod yap. Sprite’ları oyunun görsel tarzına uygun şekilde fal üzerinden üret. Ajan ayrıntıları netleştirip tamamlanmış sayılması için nelerin gerektiğini soracaktır. Genellikle bu, oyunda çalışan bir mod ve 20-45 saniyelik bir video anlamına gelir. Video istemiyorsanız en başta belirtin. Proje klasöründe MODLOG.md adlı bir çalışma günlüğü oluşturulur.

Mod yüklüyken oyunu ilk kez başlatmadan önce ajan, um backup create komutuyla kayıtlarınızın yedeğini alır. Ayrıca -tmlsavedirectory parametresini kullanarak ayrı bir kayıt klasörü ayarlar. Böylece asıl karakterleriniz ve dünyalarınız olduğu gibi kalır. Ekran görüntülerinin ve tıklama koordinatlarının tutarlı olması için oyunu sabit boyutlu bir pencereye alır. Projenin bitmesini bekleyip sonucu kendiniz test edin. Ajan çalışan modun tamamını kendi başına oluşturmuş olacak.

Eklentinin, siz isteseniz bile ajanın çiğnemeyeceği katı kuralları var. Sınırları önceden bilmek için mod oluşturmadan önce bu kuralları okuyun. Eklenti şunları yapmaz:

Bir oyun klasörüne mod yükleyici kurmadan, fare ve klavyenin denetimini almadan ya da herhangi bir içerik yayımlamadan önce ajan izin ister. Windows Kayıt Defteri’ni değiştirmeden önce araç, ilgili anahtarın yedeğini oluşturur.