Guides / Building & Resources

Özel tablolar ve diskler için iki paket gerekiyor ve bunlardan birini kurmak en yaygın hatadır

Veri paketi içeriği kaydeder; kaynak paketi dokuyu ve sesi sağlar. Tek başına veri paketi, gösterecek hiçbir şey olmadan kaydeder. Ayrıca 4×4 sınırı ve disk uzunluğunun neden kozmetik bir şey olmadığı.

2026-08-01

Tablolar ve müzik diskleri, modern Java'da gerçek kayıt öğeleridir, bu da vanilya olanları değiştirmek yerine onları ekleyebileceğiniz anlamına gelir. Eklediğiniz hiçbir şey mevcut bir tabloyu veya diski yerinden etmez.

Buradaki sorun, içeriğin iki farklı paket türüne bölünmüş olması ve her birinin tek başına işe yaramaz olmasıdır.

Nereye ne gider

Veri paketi öğeyi kaydeder:

data/<ns>/painting_variant/<id>.json    asset_id, width, height, title, author
data/<ns>/jukebox_song/<id>.json        sound_event, description, length, comparator

Kaynak paketi gördüğünüz ve duyduğunuz şeyi sağlar:

assets/<ns>/textures/painting/<id>.png
assets/<ns>/sounds/<id>.ogg
assets/<ns>/sounds.json

Yalnızca veri paketini kurarsanız, içerik başarıyla kaydedilir — var olur, /give onu bulur ve sadece doku ve ses olmaz. Bu, doğrudan bir hatadan çok daha kafa karıştırıcı bir sonuçtur ve özel bir tablonun "çalışmamasının" olağan nedenidir. Bu sayfadaki araç, ayrılmamaları için her ikisini de tek bir zip içinde gönderir.

İki pack.mcmeta dosyasına dikkat edin. Bunlar ayrı kimliklere sahip ayrı paketlerdir; her ikisini de barındıran birleşik bir format yoktur.

Kayıt kimlikleri dosya adlarından daha katıdır

Bir kimlik yalnızca a-z, 0-9, _, . ve - içerebilir. Başka herhangi bir şey olursa paket yüklenemez — bozuk olan tek giriş değil, paketin tamamı. Büyük harfler ve boşluklar insanları yanıltan iki şeydir, çünkü her ikisi de sürüklediğiniz dosya adında tamamen normaldir.

Tablolar: 1×1'den 4×4'e

Vanilya boyutları 1 × 1'den 4 × 4 bloğa kadar değişir ve on altı olası şekil sunar. Bu aralığın dışındaki bir varyant yine de işlenir — oyun onu reddetmez — ancak oyuncuların beklediği boyutta bir duvara asılamaz, bu nedenle normal bir yapıda etkili bir şekilde yerleştirilemez.

Boyut, JSON'da blok cinsinden width ve height olarak belirtilir. PNG'den çıkarılmaz, bu nedenle dokusu kare olan 3 × 1'lik bir tablo, gerilmiş olarak görüntülenen geçerli bir dosyadır.

Disk uzunluğu bir etiket değildir

length_in_seconds iki şeyi yönlendirir: müzik kutusu zamanlaması ve karşılaştırıcı rampası (comparator ramp) — çalan bir müzik kutusundan bir karşılaştırıcının okuduğu sinyal, parçanın belirtilen süresi boyunca yükselir.

Bu nedenle, yanlış bir uzunluk kozmetik bir hata değildir. 200 saniyelik bir parçayı 100 saniye olarak belirtirseniz, karşılaştırıcı rampasını yarıda bitirir, bu da bir diskin bitişine ayarlanmış herhangi bir redstone devresini sessizce bozar. Bu araç, tam da bu nedenle, sizden yazmanızı istemek yerine dosyanın gerçek süresini okur.

Parçalar ayrıca "stream": true içinde sounds.json ile yazılır. Müzik uzundur ve tam bir parçayı çalmadan önce belleğe yüklemek takılmalara neden olur — akış (streaming), disk uzunluğundaki her şey için doğru varsayılan, kısa bir ses efekti için ise yanlış olandır.

Özel tablo ve müzik plağı ekleyici →