أدلة / البناء والموارد

لوحات مخصصة وأقراص موسيقية دون استبدال الأصلية

أصبح كلاهما سجلات حزم بيانات (datapack registries)، لذا يمكنك إضافة لوحات جديدة بدل الكتابة فوق الأصلية. إليك الملفين اللذين يحتاجه كل منهما وقاعدة الأبعاد التي يجب أن تتبعها اللوحات.

2026-06-18

الطريقة القديمة للحصول على لوحة مخصصة كانت الكتابة فوق paintings_kristoffer_zetterstrand.png وفقدان لوحة أصلية. الآن أصبحت اللوحات وأقراص الموسيقى سجلات (registries)، لذا تضيف بدل أن تستبدل.

اللوحات تحتاج ملفين

مدخل حزمة بيانات يعرّف اللوحة:

data/<namespace>/painting_variant/my_art.json

{
  "asset_id": "my_pack:my_art",
  "width": 2,
  "height": 2,
  "title": { "text": "My Art" },
  "author": { "text": "Me" }
}

وحزمة موارد توفر الصورة:

assets/my_pack/textures/painting/my_art.png

width وheight بوحدات المكعبات، ويجب أن تطابق الخامة تلك النسبة. ترسم النسخة الأصلية 16 بكسل لكل مكعب، لذا لوحة 2×1 تكون 32×16 — لكن 64×32 تعمل بنفس الجودة. إذا أخطأت في النسبة فستمتد الصورة؛ لا يوجد ضبط تلقائي.

الأحجام الأصلية من 1×1 حتى 4×4. الأحجام الأكبر تعمل لكنها تحتاج جدارًا مطابقًا.

جعلها قابلة للحصول

إضافة النوع لا تضعها في اللعبة. هناك طريقان:

• وسم التوزيع — أضفها إلى #minecraft:placeable ليصبح عنصر لوحة عادي عشوائيًا من نوعها.
• مباشرةً — /give @p painting[entity_data={id:"minecraft:painting",variant:"my_pack:my_art"}]

معظم صانعي الخرائط يريدون الثاني: لوحة محددة، لا عشوائية.

أقراص الموسيقى تحتاج ثلاثة

data/<namespace>/jukebox_song/my_song.json

{
  "sound_event": { "sound_id": "my_pack:music/my_song" },
  "description": { "text": "My Artist - My Song" },
  "length_in_seconds": 154,
  "comparator_output": 12
}

بالإضافة إلى sounds.json الذي يربط معرّف الصوت بملف، بالإضافة إلى .ogg نفسه:

assets/my_pack/sounds.json
assets/my_pack/sounds/music/my_song.ogg

ثلاثة تفاصيل مهمة:

• يجب أن يكون length_in_seconds صحيحًا. فهو يحدد متى يتوقف صندوق الموسيقى — الجسيمات، ومخرجه من الريدستون، والصوت الذي يُقطع عند تلك النقطة. مدة طويلة جدًا تعني صمتًا في النهاية؛ وقصيرة جدًا تقطع المقطع.
• comparator_output من 0 إلى 15 وهو ما تقرأه المقارنة. النسخة الأصلية فيها 22 قرصًا و15 قيمة فقط، لذا سبعة أزواج تتشارك قيمة بالفعل؛ اختر قيمة لا يستخدمها أي قرص يجب أن تميّزه دوائر الريدستون لديك.
• بثّ ملف ogg. استخدم "stream": true في sounds.json لأي شيء بطول مقطوعة موسيقية.

ثم أعطها:

/give @p music_disc_13[jukebox_playable="my_pack:my_song"]

أي عنصر قرص يصلح كحامل — المكوّن هو ما يحدد ما يُشغَّل.

لماذا هذا أفضل من الكتابة فوق الأصلية

حزمة تستبدل أصول النسخة الأصلية تتعارض مع كل حزمة أخرى تفعل الشيء نفسه، وتتعطل عندما تعيد Mojang تسمية ملف. إضافات السجلات لها نطاق أسماء (namespaced)، لذا تتعايش حزمتان تضيفان لوحات. وهي أيضًا الطريقة الوحيدة التي تصمد عند ترقية الإصدار دون تعديل.

ابنِ أنواع اللوحات وأغاني صندوق الموسيقى والتمائم ورموز الدردشة التعبيرية في ملف موارد جاهز واحد باستخدام صانعو حزم المحتوى المخصص.

منشئو حزم المحتوى المخصص →