Architecture Mod Rehberi: 2026'da Kurulum ve Ayarlama

Kerem Aydın·7 Temmuz 2026·⏱4 dk

Architecture Mod (çoğunlukla Architectury API kastedilir), geliştiricilerin Forge, Fabric ve NeoForge yükleyicilerinde aynı anda çalışan modlar oluşturmasına olanak tanıyan bir aracı kütüphanedir. Oyuncular için bu, seçilen platformdan bağımsız olarak aynı popüler modları (örneğin JEI, JourneyMap veya teknoloji modları) kullanabilme ve çapraz platform eklentileri kurabilme anlamına gelir. 2026 yılında kurulum, yükleyicinize uygun doğru API sürümünü indirip mods klasörüne eklemekten ibarettir.

Architectury API Nedir ve Neden Gereklidir?

Minecraft ekosisteminde uzun süre bir ayrılık vardı: modlar ya Forge için ya da Fabric için yazılıyordu. Bu durum, her iki platformdaki en iyi modlarla bir derleme oluşturmak isteyen oyuncular için sorun yaratıyordu.

Architectury API, ortak bir soyutlama katmanı sağlayarak bu sorunu çözer.

Oyuncular için: "Çapraz platform" olarak işaretlenen veya Architectury gerektiren modları, Forge sürümü varsa Fabric sunucunuzda çalışmayacağından endişe etmeden kurabilirsiniz.
Derlemeler için: Farklı ekosistemlerden içerikleri karıştırmanıza olanak tanır (ilgili portların mevcut olması koşuluyla).

Önemli: Architectury API tek başına oyuna yeni bloklar veya eşyalar eklemez. Bu teknik bir kütüphanedir. Eğer özellikle inşaat için (merdivenler, kemerler, dekorasyon) modlar arıyorsanız, çapraz platform uyumluluğu için sıklıkla Architectury kullanan Macaw's Bridges, Chisel veya Supplementaries gibi modlara ihtiyacınız var.

Sürüm ve Yükleyici Seçimi (2026)

2026 yılına gelindiğinde, Minecraft'ın standart sürümleri 1.21.x ve 1.20.1 LTS (Uzun Süreli Destek) dalları haline geldi. Seçim hedeflerinize bağlıdır:

Yükleyici	Özellikler	Kime Uygun
Fabric	Hafif, hızlı yükleme, istemci optimizasyonları (Sodium, Iris) için idealdir.	FPS'e değer verenler ve oyunun modern sürümlerini kullananlar için.
NeoForge	Forge'un halefi, ağır teknoloji modlarıyla yüksek uyumluluk sağlar.	Endüstriyel modlar ve büyü içeren karmaşık derlemeler için.
Forge	Klasik tercih, ancak yeni sürümlerde yavaş yavaş yerini NeoForge'a bırakıyor.	NeoForge portlarının bulunmadığı eski derlemeler (1.12.2–1.20.1) için.

İndirilecek dosya nasıl seçilir:

Yükleyicinizi belirleyin (Fabric/NeoForge/Forge).
Minecraft'ın tam sürümünü öğrenin (örneğin, 1.21.4).
Yükleyicinize karşılık gelen etikete sahip dosyayı indirin. Dosyalar genellikle architectury-12.3.4-fabric.jar veya architectury-12.3.4-neoforge.jar şeklinde adlandırılır.

Architecture Mod Adım Adım Kurulum

Kurulum süreci tüm modern launcherlar (Prism, GDLauncher, CurseForge, resmi launcher) için standartlaştırılmıştır.

Adım 1: Ortam Hazırlığı

Seçtiğiniz yükleyiciyle (Fabric/NeoForge) birlikte gerekli Minecraft profilinin kurulu olduğundan emin olun. Gerekli klasörlerin oluşturulması için oyunu bir kez başlatın, ardından kapatın.

Adım 2: Dosyayı İndirme

Resmi depolara (Modrinth veya CurseForge) gidin. Architectury API'yi bulun.

Oyun sürümüne göre filtreleyin.
Yükleyiciniz için dosyayı seçin.

Kontrol etmeden üçüncü taraf agregatör sitelerinden dosya indirmeyin. Resmi kaynaklar virüs içermemesini ve sürümlerin güncel olmasını garanti eder.

Adım 3: Kurulum

Minecraft örneğinin (instance) klasörünü açın.
mods klasörüne gidin.
İndirilen .jar dosyasını bu klasöre taşıyın.
Mod ek bağımlılıklar gerektiriyorsa (örneğin, Fabric için Cloth Config API), bunları da indirip ekleyin. Genellikle launcherlar bunu otomatik olarak bildirir.

Adım 4: Kontrol

Minecraft'ı başlatın. "Modlar" (Mods) menüsüne girin. Listede Architectury API bulunmalıdır. Oyun başlangıçta çöküyorsa, günlüklerde (logs/latest.log) ClassNotFoundException veya ModDependencyException hatalarını kontrol edin.

Ayarlama ve Çakışma Çözümü

Kütüphanenin ana menüde kendi ayarları yoktur, ancak bağımlı modların çalışması için kritiktir.

Kurulumda Sık Karşılaşılan Hatalar

Yükleyici Sürüm Uyuşmazlığı
- Belirti: Oyun başlangıçta hemen çöker.
- Çözüm: Fabric için olan sürümü NeoForge'da (veya tam tersi) çalıştırmaya çalışıyorsunuz. Dosya uzantısının ve adının yükleyicinizle eşleştiğinden emin olun.
Cloth Config API Eksikliği (Fabric için)
- Belirti: Bağımlılık hatası ile çökme.
- Çözüm: Fabric tabanlı birçok Architectury modu Cloth Config API gerektirir. Bunu indirip mods klasörüne koyun.
Kopya Çakışması
- Belirti: Duplicate mod ID hatası.
- Çözüm: Aynı içeriği sağlayan iki farklı modu veya farklı derlemelere sahip iki Architectury sürümünü kurup kurmadığınızı kontrol edin. Sadece en güncel sürümü bırakın.

Optimizasyon İpucu: Fabric kullanıyorsanız, Architectury modlarıyla birlikte her zaman Sodium (grafik) ve Lithium (oyun mantığı) kurun. Architectury bunlarla çakışmaz ve derleme çok daha akıcı çalışır.

SSS: Sıkça Sorulan Sorular

S: Architectury, Forge/Fabric API'den nasıl farklıdır? C: Bu bir yerine geçme değil, bir üst yapıdır. Mod kodunun, her yükleyici için ayrı ayrı yeniden yazılmadan oyun işlevlerine evrensel şekilde erişmesini sağlar.

S: Architectury sunucuya kurulmalı mı? C: Evet, sunucuda kurulu modlardan en az biri onu gerektiriyorsa kurulmalıdır. Sunucuya bağlanan istemcilerin de ilgili mod sürümüne sahip olması gerekir.

S: Architectury kurulu olmasına rağmen mod neden çalışmıyor? C: Modun kendi sürümünü kontrol edin. Minecraft 1.20.1 için derlenmiş bir mod, doğru API ile bile 1.21'de çalışmaz. Oyun sürümleri tam olarak eşleşmelidir.

S: Güvenli sürüm nereden indirilir? C: Sadece Modrinth veya CurseForge kullanın.

Sonuç

2026 yılında Architectury API, çapraz platform mod geliştirmesi için fiili standart haline geldi. Bu kütüphanenin doğru kurulması, yükleyici savaşlarından bağımsız olarak büyük miktarda kaliteli içeriğe erişim sağlar. Altın kural şudur: Her zaman mod sürümü, oyun sürümü ve yükleyici türünü karşılaştırın. Tek bir yanlış dosya seçimi derlemenizin çalışmamasına neden olur.