Minecraft Sunucusuna Resource Pack Ekleme

Minecraft sunucusuna resource pack ekleme işlemi üç adımdan oluşur: paketin .zip dosyasını doğrudan indirilebilir bir adrese yüklemek, dosyanın SHA-1 özetini üretmek ve bu iki değeri server.properties dosyasındaki resource-pack ile resource-pack-sha1 satırlarına yazmak. Sunucu yeniden başlatıldıktan sonra bağlanan her oyuncuya paket otomatik olarak önerilir; isterseniz require-resource-pack=true ile zorunlu hâle getirebilirsiniz.

Bu rehberde doku paketini sıfırdan paketlemeyi, barındırma seçeneklerini, hash üretmeyi, zorunlu paket davranışını, güncelleme sırasında herkesin takıldığı önbellek sorununu ve “Failed to download resource pack” hatasının gerçek sebeplerini adım adım anlatıyoruz. Anlatılanlar Minecraft 26.2 “Chaos Cubed” dâhil tüm modern sürümler için geçerlidir; sunucu yazılımınızın Paper, Purpur, Spigot ya da vanilla olması bu ayarları değiştirmez.

Resource Pack Dosyasını Doğru Biçimde Hazırlama#

Sunucuya göndereceğiniz paket, kök dizininde pack.mcmeta dosyası bulunan bir ZIP arşivi olmalıdır. En sık yapılan hata paketin bulunduğu klasörü sıkıştırmaktır: bu durumda ZIP’in kökünde pack.mcmeta değil bir klasör adı görünür ve istemci paketi geçersiz sayar.

Doğru arşiv yapısı şöyledir:

pack.zip
 ├── pack.mcmeta
 ├── pack.png            (isteğe bağlı, 128x128 önizleme görseli)
 └── assets/
     └── minecraft/
         ├── textures/
         ├── models/
         ├── sounds/
         └── font/

pack.mcmeta dosyası, paketin hangi oyun sürümüyle uyumlu olduğunu bildiren küçük bir JSON dosyasıdır. pack_format değeri her Minecraft sürümüyle değişir; hedeflediğiniz sürümün karşılığını mutlaka doğrulayın. 1.20.2’den itibaren tek bir sayı yerine aralık belirtebilirsiniz:

{
  "pack": {
    "description": "Batihost Sunucu Doku Paketi",
    "pack_format": 55,
    "supported_formats": { "min_inclusive": 46, "max_inclusive": 80 }
  }
}

Arşivi oluştururken dikkat edilecekler#

• Dosya ve klasör adlarında Türkçe karakter, boşluk veya büyük harf kullanmayın; oyun kaynak yollarını küçük harfle çözer.
• Arşivi .zip olarak üretin. .rar ve .7z desteklenmez.
• Kullanmadığınız dokuları paketten silin. Vanilla dokularla birebir aynı dosyaları paketin içinde tutmanın hiçbir faydası yok, sadece boyutu şişirir.
• Paket içinde __MACOSX veya Thumbs.db gibi artık dosyalar kalmasın.

Paketi Barındırma: Doğrudan İndirme Bağlantısı Şart#

Minecraft istemcisi bir tarayıcı değildir. Verdiğiniz adrese GET isteği atar ve gelen yanıtın doğrudan ZIP içeriği olmasını bekler. Ara sayfa, reklam, “indirme birazdan başlayacak” ekranı ya da oturum çerezi isteyen bir servis kullanırsanız paket asla inmez.

Kendi alan adınız üzerinden yayınlamak istiyorsanız web hosting hesabınızın public_html dizinine bir pack klasörü açıp dosyayı oraya yüklemeniz yeterli. cPanel dosya yöneticisiyle veya WinSCP/FileZilla ile yükleyebilirsiniz. Adresin HTTPS olması için SSL sertifikasını kurmayı ihmal etmeyin; sertifikası geçersiz olan adresten paket inmez.

Sunucu tarafında doğru MIME türü#

Bazı web sunucuları .zip dosyasını yanlış içerik türüyle sunar. Nginx kullanıyorsanız aşağıdaki gibi bir konum bloğu hem türü hem de önbelleği doğru ayarlar:

location /pack/ {
    root /var/www/html;
    types { application/zip zip; }
    add_header Cache-Control "public, max-age=604800";
    autoindex off;
}

SHA-1 Hash Oluşturma ve Neden Zorunlu Sayılmalı#

resource-pack-sha1 alanı teknik olarak boş bırakılabilir, ama boş bırakmayın. Hash iki işi birden yapar: indirilen dosyanın bozulmadan geldiğini doğrular ve istemcinin paketi önbellekten mi yoksa yeniden mi indireceğine karar vermesini sağlar. Hash olmadan istemci paketi her girişte yeniden indirebilir; bu hem oyuncuyu bekletir hem bant genişliğinizi tüketir.

Hash’i paketi yükledikten sonra, sunucuya konan dosyanın son hâli üzerinden üretin.

1. Windows tarafında hash üretme#

   Komut istemini açıp dosyanın bulunduğu dizinde şu komutu çalıştırın:

   certutil -hashfile pack.zip SHA1

   PowerShell kullanıyorsanız Get-FileHash pack.zip -Algorithm SHA1 komutu da aynı sonucu verir. Çıktıdaki boşlukları temizleyip 40 karakteri tek parça hâlinde alın.

2. Linux tarafında hash üretme#

   sha1sum /var/www/html/pack/pack.zip

   Çıktının ilk sütunu 40 karakterlik SHA-1 özetidir. Dosya adını kopyalamayın, yalnızca hash değerini alın.

3. Uzaktaki dosyanın hash’ini doğrulama#

   Yüklediğiniz dosyanın gerçekten aynı dosya olduğundan emin olmak için sunucudan indirip tekrar hesaplayın:

   curl -sL https://ornek.com/pack/pack.zip | sha1sum

   İki değer aynı çıkmıyorsa yükleme sırasında dosya bozulmuş ya da web sunucusu farklı bir içerik döndürüyor demektir.

server.properties Ayarları#

Sunucuyu durdurun, kök dizindeki server.properties dosyasını açın ve aşağıdaki satırları düzenleyin. Sunucu çalışırken yapılan düzenlemeler kapanışta üzerine yazılır.

resource-pack=https://ornek.com/pack/pack-v3.zip
resource-pack-sha1=9c1f7a4be2d0c58a6e3b90f21d47ac8351b6e0d2
resource-pack-prompt={"text":"Sunucumuzun özel doku paketi. Kabul etmeden oynayamazsınız.","color":"gold"}
require-resource-pack=true
resource-pack-id=

Bu dosyadaki diğer tüm anahtarların ne işe yaradığını server.properties tam ayar listesi sayfasında bulabilirsiniz. Değişiklikten sonra sunucuyu yeniden başlatın; konsol komutlarıyla yapılan reload bu ayarları tazelemez.

Zorunlu Paket Kullanmak Mantıklı mı?#

require-resource-pack=true ayarı, özel item modelleri, kendi GUI’si ya da özel font kullanan sunucular için gereklidir. Paketi olmayan oyuncu, custom model data ile üretilmiş bir eşyayı sadece “boyalı kitap” olarak görür ve sunucu deneyimi bozulur.

Buna karşılık zorunlu paket, ilk giriş sırasında ek bir engel oluşturur. Pratikte işe yarayan yaklaşım şudur:

resource-pack-prompt alanına yazdığınız JSON metin bileşeni, kabul ekranındaki açıklamayı değiştirir. Bu alan geçerli bir JSON olmalıdır; tırnak işaretlerini kaçırırsanız sunucu açılışta uyarı basar ve varsayılan metni gösterir. Türkçe karakter kullanabilirsiniz, dosyanın UTF-8 kaydedildiğinden emin olun.

Paketi Güncelleme ve Önbellek Sorunu#

Doku paketini güncelleyip aynı adrese aynı adla yüklerseniz, oyuncuların bir kısmı yeni paketi görmez. İstemci, indirdiği paketleri hash değerine göre saklar; adres ve hash aynı kaldığı sürece yeniden indirme yapmaz.

Doğru güncelleme akışı şu şekildedir:

1. Yeni sürüme farklı bir dosya adı verin#

   pack-v3.zip yerine pack-v4.zip gibi. Eski dosyayı bir süre daha sunucuda bırakın; bağlantı kopan oyuncular eski adresi yeniden deneyebilir.

2. Yeni SHA-1 değerini üretin#

   sha1sum pack-v4.zip

3. İki satırı birlikte güncelleyip yeniden başlatın#

   resource-pack ve resource-pack-sha1 satırlarını aynı anda değiştirin. Sadece birini değiştirmek, en sık görülen “paket indirilemedi” hatasının kaynağıdır.

Eklentilerle Gelişmiş Kullanım#

server.properties tek bir global paket tanımlar. Dünyaya, gruba ya da oyuncuya göre farklı paket göndermek istiyorsanız eklenti tarafına geçmeniz gerekir. Paper API’si Player nesnesi üzerinden paket gönderme metotları sunar; bu sayede bir eklenti, oyuncu belirli bir dünyaya girdiğinde farklı bir paket yollayabilir.

Tipik kullanım senaryoları:

• Mini oyun başına paket: Oyuncu lobiden arena dünyasına geçtiğinde arenaya özel paket gönderilir.
• Yetki grubuna göre paket: LuckPerms grubuna bağlı olarak VIP oyunculara ek kozmetik doku paketi verilir.
• Menü ve arayüz paketleri: Özel GUI dokuları yalnızca ilgili menüyü açan oyunculara yüklenir.

Kendi paket yönetim eklentinizi yazmak isterseniz Java ile Minecraft eklentisi geliştirme rehberi başlangıç için yeterli temeli veriyor. Hazır çözümler için 2026 eklenti listesine bakabilirsiniz.

Bedrock ve Geyser tarafı#

Geyser ile Bedrock oyuncularını kabul eden bir sunucu işletiyorsanız, Java biçimindeki resource pack Bedrock istemcilerine hiçbir şey ifade etmez. Bedrock için ayrı bir paket hazırlanır ve Geyser’ın packs klasörüne konur. İki platformda görsel bütünlük istiyorsanız paketi iki formatta üretmeyi baştan planlayın. Bedrock tarafındaki kurulum ayrıntıları için Minecraft PE / Bedrock sunucu kurulumu sayfasına bakın.

Sık Karşılaşılan Hatalar ve Çözümleri#

Sunucu konsolunda görünen istisnaları okumakta zorlanıyorsanız Minecraft sunucu hataları ve çözümleri sayfası genel bir teşhis akışı sunuyor.

Bant Genişliği ve Donanım Tarafı#

Resource pack, oyun sunucusunun değil web sunucusunun yükünü artırır. 30 MB’lık bir paketi günde 500 kez indirmek yaklaşık 15 GB trafik demektir. Paketi oyun sunucunuzla aynı makinede yayınlıyorsanız bu trafik oyun portuyla aynı hattı paylaşır ve yoğun saatlerde ping’i etkileyebilir.

Pratik öneri: paketi ayrı bir web hosting hesabından ya da sunucunun ayrı bir sanal ana bilgisayarından servis edin, 1 Gbit port kullanın. Oyun sunucusu tarafında ise doku paketi RAM tüketimini artırmaz; asıl belirleyici oyuncu sayısı ve eklenti yüküdür.

Minecraft’ın ana tick döngüsü tek çekirdekte çalıştığı için çekirdek sayısı değil saat hızı belirleyicidir; bu yüzden yüksek frekanslı Ryzen işlemciler tercih edilir. Ayrıntılı seçim kriterleri için Minecraft sunucusu için doğru donanım seçimi sayfasına bakabilir, hazır paketleri Minecraft sunucu paketleri sayfasından karşılaştırabilirsiniz.

Özetle#

Resource pack eklemek teknik olarak iki satırlık bir iştir, ama işi bozan ayrıntılar bellidir: paketin ZIP kökünde pack.mcmeta bulunmalı, adres doğrudan dosyaya gitmeli, SHA-1 değeri boşluksuz ve dosyanın son hâline ait olmalı, güncelleme yaparken dosya adı ile hash birlikte değişmelidir. Zorunlu paket kullanacaksanız boyutu düşük tutun; 50 MB üzerindeki paketler yeni oyuncu kaybettirir.

Kurulumu tamamladıktan sonra farklı bir hesapla sunucuya girip paketin gerçekten indiğini ve uygulandığını test edin. Sorun yaşarsanız önce adresi gizli sekmede, sonra hash’i curl … | sha1sum ile doğrulayın; vakaların büyük çoğunluğu bu iki kontrolde çözülür.