Guides / Troubleshooting

.mrpack dosyalarını normal mod paketi zip'ine dönüştürme — ve neden çıkarıcılar başarısız oluyor?

.mrpack bir mod arşivi değil, bir manifest dosyasıdır. Sıkıştırmayı açtığınızda bir JSON dosyası ve hiç jar dosyası bulamazsınız. İşte içinde ne olduğu ve bir dönüştürücünün ne yapması gerektiği.

2026-07-09

Bir .mrpack dosyasının adını .zip olarak değiştirin, açın ve neredeyse hiçbir şey bulamazsınız: bir modrinth.index.json, belki bir overrides/ klasörü. Modlar eksik. Bu bir bozulma değil — formatın tasarlandığı gibi çalışmasıdır.

İçinde ne var

modrinth.index.json     the manifest: name, version, loader, and a list of downloads
overrides/              config files, resource packs, anything not on Modrinth

Manifestteki her giriş şöyle görünür:

{
  "path": "mods/sodium.jar",
  "hashes": { "sha1": "…", "sha512": "…" },
  "downloads": ["https://cdn.modrinth.com/data/…/sodium.jar"],
  "fileSize": 812345
}

Paket, dosyaları değil, referansları içerir. Bu yüzden 40 modluk bir paket 200 KB boyutundadır ve bu yüzden her genel çıkarıcı "başarısız olur" — çıkarılacak bir şey yoktur.

Bir dönüştürmenin yapması gerekenler

1. modrinth.index.json dosyasını okuyun.
2. Her girişi CDN URL'sinden getirin.
3. Manifestteki sha512'ye göre her dosyayı doğrulayın. Bunu atlamak, bozuk veya değiştirilmiş bir jar dosyasının

bir pakete nasıl girdiğidir.

1. Her birini path konumuna yerleştirin.
2. overrides/ dosyasını üzerine kopyalayın — geçersiz kılmalar kazanır, amaçları budur.
3. Sonucu sıkıştırın.

Adım 3, dönüştürücülerin sessizce atladığı adımdır. Eşleşmeyen bir hash, indirmenin kesildiğini veya dosyanın değiştiğini gösterir; yine de yüklemek, yükleme sırasında yanlış moda işaret eden bir hata ile çöken bir paket üretir.

Neden hiç yapmalı

• mrpack'i tanımayan başlatıcılar. ATLauncher, MultiMC ve manuel kurulumlar

jar dosyalarının olduğu bir klasör ister.

• Sunucu tarafı. Sunucu barındırıcıları neredeyse hiçbir zaman bir .mrpack kabul etmez;

modlar klasörünü isterler.

• Çevrimdışı kurulum. Dönüştürüldükten sonra, paketin artık CDN'ye ihtiyacı kalmaz.

env alanı istemci ve sunucuya karar verir

Her dosya şunları içerir:

"env": { "client": "required", "server": "unsupported" }

Bir sunucu paketi, sunucu tarafında unsupported olarak işaretlenmiş her şeyi atlamalıdır — çoğunlukla gölgelendiriciler, mini haritalar ve HUD modları. Tam istemci modları klasörünü bir sunucuya kopyalamak, başlangıçta bir render sınıfına işaret eden bir çökmenin olağan nedenidir.

Diğer yöne gitmek

Bir klasörden bir .mrpack oluşturmak tersidir ve bir tuzağı vardır: Modrinth'te olmayan hiçbir mod bir manifest girişi olamaz. Bu modlar overrides/mods/ içine gitmelidir, bu da paketi büyütür ancak çalışmasını sağlar. Bu modları sessizce düşürmek, temiz bir şekilde kurulan ancak içeriği eksik olan bir paket üretir.

Hash doğrulaması ve env ayrımı ele alınarak her iki yönde de dönüştürme işlemini Kaynak Paketi Zip Araçları sayfasında bulabilirsiniz.

Kaynak paketi zip araçları →