Guides / Troubleshooting

pack.mcmeta: pack_format sayıları ve "uyumsuz" uyarısı

Tek bir yanlış tam sayı, Minecraft'ın paketinizin üzerini griye boyamasına neden olur. İşte format-sürüm eşleşmesi, tüm bu sorunu önleyen supported_formats aralığı ve dosyanın nerede bulunması gerektiği.

2026-07-08

"Paketim uyumsuz görünüyor" şikayetlerinin neredeyse tamamı, küçük bir dosyadaki tek bir sayıdan kaynaklanır.

Dosya

{
  "pack": {
    "pack_format": 46,
    "description": "My pack"
  }
}

Tam olarak pack.mcmeta olarak adlandırılmalı ve zip'in kök dizininde bulunmalıdır — assets/ veya data/'nın yanında, zip'in içindeki bir klasörün içinde değil. İçerik yerine kapsayan klasörü sıkıştırmak, en yaygın ikinci hatadır ve yanlış format numarasıyla aynı şekilde görünür.

Kaynak paketleri ve veri paketleri farklı sayılar kullanır

İnsanları yanıltan kısım burası: iki sayaç yıllar önce ayrıldı ve birbirinin yerine kullanılamaz. Bir kaynak paketi numarası kullanan bir veri paketi, numara "güncel" olsa bile gri renkte görünür.

Her sürümde güncelliğini yitiren bir tabloyu ezberlemek yerine, hedeflediğiniz sürüm için bir vanilla paketten numarayı okuyun — veya bir jeneratörün doldurmasına izin verin.

supported_formats gerçek çözümdür

Tek bir tam sayıyı sabitlemek, paketin bir sonraki sürümde bozulması anlamına gelir. Bir aralık ise bozulmaz:

{
  "pack": {
    "pack_format": 46,
    "supported_formats": { "min_inclusive": 42, "max_inclusive": 99 },
    "description": "My pack"
  }
}

pack_format birincil bildirim olarak kalır; supported_formats, oyunun uyarı vermeden kabul ettiği aralığı genişletir. Sadece doku veya tarif ekleyen bir paket için — ki bu çoğu pakettir — geniş bir aralık dürüsttür, çünkü içinde hiçbir şey sürümler arasında gerçekten bozulmaz.

Açıklama metin bileşenlerini alır

"description": [
  { "text": "My pack ", "color": "gold" },
  { "text": "v2", "color": "gray", "italic": true }
]

Bölüm işareti kodları (§6) hala çalışır, ancak JSON formu, kontrol karakterlerini kaldıran araçlar aracılığıyla kopyala-yapıştır işleminden sağ çıkar.

Katmanlar (Overlays), aynı anda birden fazla sürümü desteklemek için

"overlays": { "entries": [
  { "formats": { "min_inclusive": 42, "max_inclusive": 45 }, "directory": "older" }
] }

Paket kökündeki older/ klasörü yalnızca bu formatlarda kullanılır. Bu, iki zip göndermek yerine, farklı model formatlarına sahip iki sürümü tek bir indirme ile desteklemenin yoludur.

Hızlı teşhis

Sondaki bir virgül geçersiz JSON'dur ve bir hata mesajı yerine "hiç listelenmiyor" durumunu üretir.

pack.mcmeta Generator kullanarak paket türünüz ve hedef sürümünüz için geçerli bir dosya oluşturun — supported_formats doldurulmuş olarak.

pack.mcmeta oluşturucu →