Bir Fabric modunu Minecraft 26.3'e taşımak

Fabric korku modum Araz'ı 2026 Eylül'ünde tek bir öğleden sonrada Minecraft 26.1.2'den 26.3'e taşıdım. Derleyici 56 hata verdi. Hepsi tekrar eden on API kalıbından çıktı ve hiçbiri tasarımda bir değişiklik gerektirmedi.

Bu yazı, işe başlarken elimde olmasını istediğim liste. Ne yeniden adlandırıldı, ne paket değiştirdi, yeni Loom hangi derleme araçlarını şart koşuyor. Modun kendisi değişmedi: Araz 1.0.0-beta.2'nin 26.3 derlemesi 26.1.2 derlemesiyle birebir aynı oynanıyor.

Aşağıdakilerin hepsi o tek gerçek porttan çıktı. Her satırı bir değişiklik günlüğüne değil, derlenen kaynak koda bakarak doğruladım. Senin modun API'nin başka bir bölümüne dokunuyor, o yüzden güvenmeden önce her satırı kendi derlemende sına.

Minecraft 26.1.2 ile 26.3 arasında Fabric modları için ne değişti?

Kırılmaların çoğu dört yerde toplanıyor: entity tipi sabitleri, tabela metni, renkli bloklar ve ganimet tabloları. Bunların bir kısmı aslında 26.2'de geldi ve ben 26.2'yi tamamen atlamıştım, yani 26.1.2'den doğrudan 26.3'e atlayınca iki sürümlük değişikliği aynı anda topluyorsun.

İki satır ayrıca dikkat istiyor. hurtMarked kaldırılması mob'larda sessizce geçiyor, çünkü entity tracker hızı nasılsa yolluyor; ama oyuncuda paketi kendin göndermezsen oyuncu hiç kıpırdamıyor. Renk koleksiyonu ise ad değişikliğini geçtikten sonra küçük bir kazanç: rastgele bir halı seçmek artık blok sabitleri arasında switch yazmak yerine Blocks.CARPET.white() veya Blocks.CARPET.lightGray() demek.

Minecraft 26.3 hangi Gradle ve Loom sürümlerini istiyor?

Minecraft 26.3 için eklenti sürümü Fabric Loom 1.18-SNAPSHOT ve bu da Gradle 9.7 ya da üstünü istiyor. Burada herhangi bir API ad değişikliğinden daha çok vakit kaybettim, çünkü hata mesajı wrapper'ı değil eklenti varyantlarını gösteriyor.

1.21.10 backport'u ise bambaşka bir derleme. net.fabricmc.fabric-loom-remap eklentisini loom.officialMojangMappings() ile kullanıyor, bütün mod bağımlılıkları modImplementation olarak tanımlanıyor ve Gradle JDK 21 ile çalışıyor. Birden fazla dal tutuyorsan derleme dosyalarını ayrı tut, hepsini tek bir betikle idare etmeye çalışma.

Portu bir öğleden sonrada nasıl yaptım

1. Projeyi kopyala, sonra derlemeyi güncelle

   26.1.2 klasörünü yeni bir klasöre kopyaladım ve eskisine hiç dokunmadım, çalışan bir geri dönüş noktası olarak duruyor. Sonra gradle.properties içinde minecraft_version, loader_version, loom_version ve fabric_api_version değerlerini yazdım, Gradle wrapper'ı 9.7.1'e çevirdim.

2. Bir kez derle ve hata listesinin tamamını oku

   İlk hatayı düzeltme. Derlemeyi çalıştır, patlamasına izin ver ve 56 satırın hepsini oku. Hataların neredeyse tamamı tekrar ediyor, yani liste daha hiçbir şeye dokunmadan kaç farklı kalıpla uğraştığını söylüyor.

3. Dosya dosya değil, kategori kategori düzelt

   Tüm kaynak ağacında tek seferde tek bir kalıbı hallettim: önce bütün EntityType. sabitleri, sonra bütün blocksMotion() çağrıları, sonra tabela metni, sonra halılar. Kalıp başına tek bir bul ve değiştir, dosya listesini tek tek gezmekten hem daha hızlı hem daha az hataya açık.

4. Derleyicinin göremediklerini kontrol et

   Derleyicinin kabul ettiği bir değişiklik çalışma zamanında hâlâ yanlış olabilir. Ganimet tablosu kurulumunu, mixin hedeflerini ve GeckoLib varlık yollarını elle kontrol ettim; bozuk bir kaynak yolu oyun onu gerçekten yükleyene kadar sessiz kalıyor.

5. İstemciyi aç, sonra veriyi karşılaştır

   Geliştirme istemcisini açtım, yeniden kurulan terk edilmiş kampa yürüdüm ve tabela metninin dört satırda da çizildiğini doğruladım, sonra üretilen ganimeti 26.1.2 derlemesiyle karşılaştırdım. Ganimet sayı sağlayıcılarındaki yanlış bir Holder'ı yakalayan tek adım bu.

26.3'te neler aynı kaldı

Hayatta kalanların listesi kırılanlardan çok daha uzun, bu iş zaten o yüzden bir hafta sonu değil bir öğleden sonra sürdü. Modun bunların üstünde duruyorsa büyük ölçüde rahatsın.

• NBT okuma ve yazma için ValueInput ve ValueOutput
• Özel ağ payload'ları ve StreamCodec
• Identifier alan SavedDataType, yani dünyaya yazılan kalıcı veri hiç dokunulmadan çalışmaya devam etti
• Entity render state mimarisi, GuiGraphicsExtractor ve HudElementRegistry
• Yaratıcı mod sekmelerine eşya eklemek için CreativeModeTabEvents
• Java 25 hedefleyen mixin'ler

Bir portun sessizce bir şeyi bozmadığını nasıl anlarsın?

Temiz bir derleme, kaynaklar ve çalışma zamanı davranışı hakkında hiçbir şey kanıtlamıyor. Araz'da üç şey derleyiciden geçip oyun içinde bozuk kalabiliyor, o yüzden her portta bunları elle kontrol ediyorum.

• Tabelalar. SignText artık dörder satırlık iki liste istiyor. Yanlış liste uzunluğu derleme hatası olarak değil, yaratığın yatağının yanına diktiği kayıt tabelalarında boş satır olarak görünüyor.
• Ganimet. Sayı sağlayıcıları paket değiştirdi ve Holder alıyor, o yüzden derlendi diye güvenmek yerine gerçekten ne düştüğünü 26.1.2 derlemesiyle karşılaştırıyorum.
• Yalnız istemci kodu. Eşya aktivasyonu game renderer'dan oyuncunun üstüne taşındı ve bölünmüş source set'lerde bir istemci mixin'i fabric.mod.json içinde {"config": ..., "environment": "client"} biçiminde tanımlanmazsa geliştirme sunucusu açılışta çöküyor.

Araz hangi Minecraft sürümlerini destekliyor?

2026 Eylül'ü itibarıyla Araz 1.0.0-beta.2 Minecraft 26.3, 26.1.2, 1.21.10 ve 1.20.1 için çıkıyor. Dördü de yalnız Fabric. Forge ya da NeoForge derlemesi yok ve planlanmıyor. Fabric API ve GeckoLib zorunlu; Simple Voice Chat, Mod Menu ve Cloth Config isteğe bağlı. Mod sayfası spicesfire.com/araz adresinde.

Dört dalı birden ayakta tutmak ucuz, çünkü oynanış kodu hepsinde aynı. Araz'ın 26.3 sürüm notlarında kullanıcıyı ilgilendiren tek bir düzeltme var, mod dosyasından eksik kalan yumurta dokusu; gerisi tamamen iç yapı. Derlemeler Modrinth ve CurseForge üzerinde, port sorularını da Discord üzerinden yanıtlıyorum.

Bu portun sana anlatmadıkları

Bu notlar 2026 Eylül'ünde tek bir modun tek bir portundan çıktı. Araz özel bir yaratık, blok entity'leri, eşyalar, ganimet, mixin'ler ve bir GeckoLib renderer kullanıyor, yani API'nin geniş bir bölümüne dokunuyor. Dünya üretimine ise hiç dokunmuyor: terk edilmiş kamp ve portal kalıntısı, yığın üretimi sırasında değil oyuncu yaklaşınca inşa ediliyor. Modun arazi, biyom ya da yapı üretiyorsa bu yazı seni kapsamıyor.