Guides / Building & Resources

Bir Bedrock dış görünüş paketi dört dosyadan oluşur ve iki hata modu sessizdir

Farklı olması gereken iki UUID, isteğe bağlı olmayan bir dil dosyası ve noktalama işaretlerini kaldıran dış görünüş anahtarları – böylece 'Dış Görünüşüm!' ve 'Dış Görünüşüm?' hatasız tek bir dış görünüş haline gelir.

2026-08-01

Bir .mcpack, farklı bir uzantıya sahip bir zip dosyasıdır ve içinde bir dış görünüş paketi tam olarak dört tür dosya gerektirir:

manifest.json      a header and a skin_pack module, each with its own UUID
skins.json         one entry per skin: texture, geometry, and a KEY
texts/en_US.lang   the display names — skins.json holds only keys
*.png              the textures themselves

Dört dosyanın üçünü doğru yapmak kolaydır. İlginç hataların hepsi aralarındaki ilişkiden kaynaklanır.

İki UUID farklı olmalı

manifest.json, header dosyasında bir UUID ve skin_pack modülünde başka bir UUID taşır:

{
  "format_version": 1,
  "header":  { "name": "…", "uuid": "…", "version": [1, 0, 0] },
  "modules": [ { "type": "skin_pack", "uuid": "…", "version": [1, 0, 0] } ]
}

Bunlar iki ayrı kimliktir – paket ve paketin içindeki şey – ve her ikisi için de tek bir değeri yeniden kullanmak, derleme sırasında hiçbir şikayet olmasa bile gerçek bir hatadır.

İkinci, daha incelikli bir sonuç vardır: aynı UUID'lerle yeniden içe aktarma, aynı paket olarak kabul edilir ve Minecraft, zaten sahip olduğu kopyayı sessizce tutar. Bir paketi düzenlemek, aynı tanımlayıcılarla yeniden oluşturmak ve yeniden içe aktarmak hiçbir şey yapmamış gibi görünür. Bu sayfadaki her derleme tam da bu nedenle yeni UUID'ler alır, bu yüzden düzenlenmiş bir paketi yeniden içe aktarmak, eskisini yeniden zip'lemek yerine yeni bir indirme gerektirir.

Dil dosyası isteğe bağlı değildir

skins.json asla bir görünen ad içermez. Bir anahtar içerir ve texts/en_US.lang bu anahtarı metne eşler:

skinpack.<PackKey>=My Pack
skin.<PackKey>.<SkinKey>=My First Skin

Paketi dil dosyası olmadan gönderirseniz hiçbir hata oluşmaz – her dış görünüş oyunda sadece ham anahtarı altında görünür. Bu, elle birleştirilmiş bir paketin geçerli olmasına rağmen bozuk görünmesinin en yaygın nedenidir.

Anahtarlar noktalama işaretlerini kaldırır ve kopyalar birleşir

Bir anahtar alfasayısal olmalıdır. Diğer her şey kaldırılır:

İlk iki satır tuzaktır. Bir insan tarafından farklı adlandırılan iki dış görünüş tek bir anahtar haline gelir ve yinelenen bir anahtar hata vermez – oyunda sessizce tek bir dış görünüşe dönüşür. On iki dış görünüş yüklersiniz, on bir tane alırsınız ve hangisinin kaybolduğunu size kimse söylemez.

Buradaki oluşturucu, daha önce kullandığı herhangi bir anahtara bir sayaç ekleyerek buna karşı savunma yapar, böylece ikinci MySkin, MySkin1 olur. Bir paketi elle birleştiriyorsanız bilmeye değer: ihtiyacınız olan kontrol, yazdığınız adlarda değil, çıkarılmış adlardadır.

Tamamen noktalama işaretlerinden oluşan bir ad hiçbir şey bırakmaz, bu nedenle Skin artı listedeki konumuna geri döner.

İnce dış görünüşler doğru geometri dizgesine ihtiyaç duyar

Her giriş bir model adlandırır ve iki tane vardır:

• geometry.humanoid.custom — klasik, 4 piksellik kollar
• geometry.humanoid.customSlim — ince, 3 piksellik kollar

Bunu yanlış yapmak, Alex oranlarına sahip bir dış görünüşün Steve'in bloklu kollarıyla ortaya çıkmasının olağan nedenidir. Doku iyidir; istenen modeldir. Paket oluşturucu bunu dördüncü kol sütununu örnekleyerek çıkarır, ancak elle yazılmış bir skins.json bunu açıkça belirtmek zorundadır ve iki dizge sonda dört karakter farklıdır.

Girişler ayrıca "type": "free" taşır ve bir pelerin, aynı girişten referans alınan isteğe bağlı ekstra bir PNG'dir – pelerin ayrı bir indirme olarak değil, dış görünüş paketinin içinde seyahat eder.

Deri paketi oluşturucu →