Universal Modder, yapay zekâ kodlama ajanlarının PC oyunları için mod araştırmasına, geliştirmesine ve test etmesine yardımcı olan açık kaynaklı bir araç setidir. Becerileri, Python ile yazılmış um komut satırı aracını, oyunlara özgü çalışma notlarını ve içerik üretimi için fal bağlantısını bir araya getirir. Bu rehberdeki asıl proje, GitHub'daki rehan-remade/universal-modder deposudur (İngilizce).

Sahip olduğunuz bir oyunda küçük bir değişiklikle başlayın: motoru ve mod yükleyicisini belirleyin, test kaydını yedekleyin, geçici görselle bir işlev geliştirin ve çalışan oyunda kontrol edin. “Universal” adı yaklaşımın kapsamını anlatır; her oyun ve sürüm için uyumluluk garantisi değildir.

Kaynaklar 9 Ekim 2026'da, 8370faa commit'i ve 0.2.0 paket sürümü üzerinden kontrol edildi. Rehber, belgelere ve kaynak koda dayanır. Örnek modları çalıştırmadık ve OmniaKey ile tüm süreci test etmedik. Dış kaynaklar İngilizcedir.

Araç setinde neler var?

Projenin README dosyası şu bileşenleri ayırır:

Bileşen	Görevi	Ayrıca gerekenler
Ajan becerileri	Araştırma, geliştirme, içerik hazırlama ve test adımlarını yönlendirmek	Modele erişimi çalışan bir kodlama ajanı
`um` CLI	Kurulumları incelemek, sprite işlemek, kayıt yedeklemek ve video kaydına yardımcı olmak	İlgili yerel bağımlılıklar ve oyun araçları
Ortak bilgi tabanı	Önceki projelerin sürümlerini, yöntemlerini ve hatalarını kaydetmek	Kurulu oyun sürümünüzde doğrulama
fal bağlantısı	Görsel, 3D, ses veya video üretimi istemek	Ayrı fal anahtarı ve kullanım bütçesi

Depo; Claude Code, Codex, Cursor, Gemini CLI, Copilot ve OpenCode için kurulum yolları sunar. Bunlar ajan bağlantılarıdır; bütün oyun işlemlerinin her işletim sisteminde çalıştığı anlamına gelmez. Windows oyunlarını kontrol eden araçlar doğrudan Windows'u veya WSL üzerinden kullanımı hedefler.

Claude Code'a nasıl kurulur?

README, Git, Python 3.10 veya üstü ve ffmpeg ister; uv kullanımını önerir. 3D modelleri sprite görüntülerine dönüştürmek için Blender gerekir. Önce hedeflediğiniz iş akışının araçlarını hazırlayın.

Şu iki komutu Claude Code içinde sırayla girin:

text

/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modder

Bunlar kabuk komutları değil, Claude Code eklenti komutlarıdır. Etkinleştirmeden önce kaynağı ve istenen izinleri inceleyin. Başka bir ajan kullanıyorsanız asıl README'deki ilgili yöntemi izleyin.

Proje, eklenti ve klonlanan depo üzerinden kullanım için CLI başlatıcısı sağlar. Ayrı bir terminal um komutunu bulamıyorsa belgelenen bağımsız kurulum şöyledir:

bash

uv tool install git+https://github.com/rehan-remade/universal-modder
um --help

Bu işlem CLI'yi depodan kurar; ajanı veya fal hesabını tek başına yapılandırmaz. Komutları kaynaklarla karşılaştırdık, ancak bu yazı için çalıştırmadık.

Dosyaları değiştirmeden önce oyunu inceleyin

Terraria yerine oyunun adını veya kurulum klasörünü yazın:

bash

um scan --list
um kb search "Terraria"
um scan "Terraria" --json

Oyun inceleme rehberine göre tarayıcı dosyaları okuyarak motor işaretlerini, kurulu yükleyicileri, kayıt konumlarını ve olası yöntemleri bildirir. Kütüphanede görünmeyen bir oyun için klasör yolu doğrudan verilebilir.

Tarama, planlama için veri sağlar; güvenlik veya destek belgesi değildir. Koruma yazılımı oyun klasörünün dışında bulunabilir, başlatıcı da motor tespitini yanıltabilir. Güncel topluluk yükleyicisi belgelerini ve oyunun mod politikasını ayrıca kontrol edin.

Ajandan oyun ve yükleyici sürümünü, kayıt ve günlük yollarını, planlanan değişiklikleri ve geri yükleme yöntemini MODDING_PLAN.md içinde yazmasını isteyin. İlerlemeyi MODLOG.md ile kaydedin. Fikri uygulayabiliyorsa yerleşik bir yükleyiciyi veya resmî mod arayüzünü tercih edin.

İlk istek ve tamamlanma ölçütleri

Küçük ve gözle görülür bir özellik seçin. Aşağıdaki metin bu rehber için hazırlanmış bir istek örneğidir; test edilmiş bir mod değildir.

Yerel Terraria test ortamımda, kurulu tModLoader sürümüne uygun yeni bir dekoratif eşya planla. Önce oyunu ve yükleyiciyi incele. Geçici görseller ve gözden çıkarılabilir bir test dünyası kullan. Dosyaları değiştirmeden önce etkilenecek yolları, yedekleme ve geri yükleme adımlarını listele. Eşyayı nasıl edineceğimi, oyunda nasıl kontrol edeceğimi ve modu nasıl kaldıracağımı açıkla. Ücretli içerik üretmeden veya bir şey yayımlamadan önce bana sor.

Projenin ana iş akışı, kapsamı büyütmeden önce geçici içerikle küçük bir işlevi tamamlamayı önerir. Bunu beş kontrole dönüştürebilirsiniz:

Yüklenme: Oyun doğru yükleyiciyle açılır ve günlükte mod tanımlanır.
Görünürlük: Eşya veya değişiklik belirlenen test sahnesinde görünür.
Davranış: Sonuç isteğe uyar; yalnızca derlemenin başarılı olması yetmez.
Kayıt: Test dünyasını kaydedip yeniden açmak beklenen sonucu verir.
Geri dönüş: Modu kapatıp yedeği geri yüklemek ortamı beklenen duruma getirir.

Son sprite'lara, sese ve tanıtım videosuna bundan sonra zaman ayırın. Üretilmiş bir görsel veya başarılı derleme, tek başına oyun içi uyumluluğu kanıtlamaz.

Hangi oyunlar için örnek var?

Örnekleri sürüm koşulları olan başlangıç noktaları olarak değerlendirin. Yazarların belgelenmiş testleri, sizin bilgisayarınızdaki testlerin yerine geçmez.

Terraria / tModLoader: Fal Arsenal'in kaynak aldığı çalışma Terraria 1.4.4 ve tModLoader 2026.07 ile tek oyunculu ortamda yapılmıştır. README, çok oyunculu modun test edilmediğini açıkça belirtir. Ayrı bir dünya kullanın.
Age of Empires II DE: Medeniyet örneği, üretilen görselleri ve sprite dönüşümünü içerir. Mevcut bir medeniyetin yerini alır; sınırsız yeni medeniyet yuvası eklenebildiğini göstermez.
Minecraft × GTA V: Çalışan iki oyunu GTA V hikâye modunda birleştirir. Belgelenen test, Steam üzerindeki GTA V Legacy sürümünün 3889 numaralı derlemesinde yapılmıştır. Bunu GTA Online'a veya başka sürümlere genellemeyin.

Kanıtı şu sırayla değerlendirin: motor rehberi → oyun ve sürümü belirtilen örnek → kendi oyun içi testiniz. Unity veya Unreal için rehber bulunması, o motoru kullanan her oyunun desteklendiğini göstermez.

Ücretsiz mi, fal gerekli mi?

Araç setinin kaynak kodu MIT lisanslıdır. Tam bir projede yine de üç maliyet kalemi olabilir: kodlama modeli erişimi, içerik üretimi, derleme ve test için yerel donanım veya araçlar.

fal'ın modele ve ayarlara göre değişen ayrı model ücretleri vardır. Kimlik doğrulama belgesi, FAL_KEY değişkenini kullanır. Gerçek anahtarı, ajanı başlattığınız ortamda gizli tutarak ayarlayın. Aşağıdaki değerler yer tutucudur.

Bash veya Zsh için:

bash

export FAL_KEY="YOUR_FAL_API_KEY"

Windows PowerShell için:

powershell

$env:FAL_KEY = "YOUR_FAL_API_KEY"

OmniaKey anahtarı da dâhil olmak üzere kodlama modelinin kimlik bilgisi fal anahtarı değildir. Eklentiyi kurmak faturaları birleştirmez. Toplu üretimi onaylamadan önce modeli ve üretim sayısını kontrol edin. Anahtarları mod dosyalarına veya yayımlanan arşivlere koymayın.

Geçici veya kendi hazırladığınız görsellerle başlayabilirsiniz. İçerik rehberi, fal anahtarı olmadan yerel ComfyUI sunucusundan görsel almak için um comfy yolunu da açıklar. Hazır görsel tarifleri fal'ın bütün ses, 3D ve video akışının yerine geçmez. Yerel donanımı ve modelleri ayrıca hazırlamanız gerekir.

İlk deneme başarısız olursa

Her seferinde yalnızca bir katmanı değiştirin:

um bulunamıyor: Oyun yükleyicisinden önce terminal PATH ayarını ve bağımsız CLI kurulumunu kontrol edin.
Oyun algılanmıyor: Kurulum klasörünü verin ve taramayı güncel topluluk belgeleriyle karşılaştırın.
fal kimlik doğrulaması başarısız: Ajan sürecinin doğru hesaba ait FAL_KEY değerini aldığını kontrol edin. Ajan oturumunun açılması fal bağlantısını doğrulamaz.
Derleme başarılı ama mod yüklenmiyor: İçeriği yeniden üretmeden önce sürümlere, kurulum yoluna ve yükleyici günlüğüne bakın.
Görsel oyunda bozuk: Görsel istemini değiştirmeden önce boyutları, saydamlığı, kare düzenini ve yönü kontrol edin.

Hata günlüğünü ve hatayı üreten en küçük örneği proje notlarına kaydedin. Sonraki deneme böylece somut bir durumu sınayabilir.

Çevrimiçi kullanım ve paylaşım

Projenin kullanım sınırlarına uyun: sahip olduğunuz oyunlar, tercihen çevrimdışı testler veya kontrolünüzdeki izinli ortamlar; anti-cheat, DRM ve sahiplik kontrollerini aşmadan çalışma. Proje, korumalı çevrimiçi istemcilere kod enjeksiyonunu reddeder. Özel sunucu kullanmak istemci korumalarını veya yayıncı kısıtlamalarını ortadan kaldırmaz.

Paylaşmadan önce oyunun şartlarını ve içerik ile araç lisanslarını inceleyin. Araç setinin MIT lisansı, oyun dosyalarını, çıkarılmış içerikleri veya tersine derlenmiş kaynak kodu dağıtma hakkı vermez. Kendi çalışmanızı, kurulum adımları, test edilen sürümler ve kaldırma yöntemiyle yayımlayın.

Model bağlantısı için Claude Code bağlantı rehberine ve güncel OmniaKey fiyatlarına bakın. Bu bağlantıyı fal'dan ayrı yapılandırın, ardından gerçek mod sürecini kendi ortamınızda doğrulayın.

Universal Modder rehberi