معرفات الكتل والعناصر والكيانات: مساحات الأسماء، وحالات الكتل، والاختلافات بينها
المعرّف ليس دائمًا هو الاسم الذي يُطلق على العنصر، ومعرّف الكتلة ليس هو نفسه معرّف العنصر الخاص بها. قواعد التسمية، وعمليات إعادة التسمية التي تُعطّل الأوامر القديمة، ومكان تواجد الحالات.
كل أمر يفشل برسالة "عنصر غير معروف" (Unknown item) أو "كتلة غير معروفة" (Unknown block) هو مشكلة في المعرّف، والقواعد أكثر دقة من مجرد "أحرف صغيرة مع شرطات سفلية".
مساحة الاسم ليست اختيارية في البيانات
minecraft:diamond_sword
my_pack:custom_swordتسمح لك الأوامر بحذف minecraft: — /give @s diamond_sword يعمل. ملفات JSON لا تسمح بذلك. جدول غنائم (loot table) أو وصفة (recipe) تحتوي على diamond_sword مجردة تفشل، وأحيانًا بصمت. اكتب مساحة الاسم في كل مكان وستختفي المشكلة.
معرف الكتلة ومعرف العنصر شيئان مختلفان
بعض الكتل ليس لها عنصر، وبعض العناصر تضع كتلة مختلفة:
| العنصر | الكتلة الموضوعة |
|---|---|
minecraft:wheat_seeds | minecraft:wheat |
minecraft:redstone | minecraft:redstone_wire |
minecraft:string | minecraft:tripwire |
minecraft:flower_pot | minecraft:flower_pot، لكن المتغيرات المزروعة هي كتل منفصلة |
| — | minecraft:water، minecraft:fire، minecraft:air ليس لها عنصر |
/setblock يأخذ معرف الكتلة. /give يأخذ معرف العنصر. استخدام المعرّف الخاطئ هو المصدر الأكثر شيوعًا لرسالة "هذا المعرّف غير موجود" (that id does not exist) بينما الشيء موجود بوضوح.
حالات الكتل توجد بين قوسين مربعين
/setblock ~ ~ ~ oak_stairs[facing=east,half=top,waterlogged=true]الحالات هي خصائص للكتلة، وليست للعنصر — لا يمكنك إعطاء درج مُدوّر مسبقًا، لأن الدوران يُقرر عند الوضع. الخصائص غير المحددة تأخذ قيمها الافتراضية.
waterlogged يوقع الناس في الخطأ: إنه موجود على السلالم، والألواح، والأسوار، وعشرات غيرها، وتعيين كتلة بدونه يزيل الماء الذي كان موجودًا.
عمليات إعادة التسمية التي تُعطّل الأوامر القديمة
تغيرت حفنة من المعرفات وأصبحت القديمة ببساطة غير معروفة الآن:
| القديم | الحالي |
|---|---|
grass | short_grass |
grass_path | dirt_path |
scute | turtle_scute |
sign | oak_sign والأصدقاء |
grass هو المؤلم، لأن grass_block لا يزال موجودًا وهو شيء مختلف. الأوامر القديمة التي تستخدم grass للنبات تستهدف الآن لا شيء بصمت.
معرفات الكيانات
يمكن التنبؤ بها في الغالب، مع استثناءات: minecraft:snow_golem وليس snowman، minecraft:mooshroom وليس mushroom_cow، وكل قذيفة هي كيان خاص بها — minecraft:arrow، minecraft:spectral_arrow، minecraft:trident.
الكيانات التي هي تقنيًا كيانات كتل (block entities) — الصناديق، القواديس (hoppers)، اللافتات (signs) — لا تظهر في قائمة الكيانات ولا يمكن /summonها. يتم وضعها ككتل وتعديلها باستخدام /data.
العلامات تتفوق على القوائم
#minecraft:planks #minecraft:logs #minecraft:wool
#minecraft:doors #minecraft:beds #minecraft:swordsحيثما يقبل أمر أو JSON علامة (tag)، فإن استخدامها يبقى فعالاً حتى لو أضافت Mojang أنواع خشب جديدة. ترميز جميع معرفات الألواح الثمانية لا يفعل ذلك.
ابحث عن كل معرف كتلة وعنصر وكيان، مع حالات الكتل والعلامات التي ينتمي إليها كل منها، في متصفح معرفات الكتل والعناصر والكيانات.