Guides / Commands & Data

شاشات الحوار: بناء قوائم حقيقية بدون تعديل

تمنحك حوارات حزم البيانات نافذة مناسبة مع مدخلات وأزرار. إليك شكل JSON، وكيف يقوم الزر بتشغيل أمر، وكيف يقارن بحيلة قائمة الكتاب.

2026-06-17

كانت قوائم الخادم تُكتب في كتب ذات صفحات قابلة للنقر، أو واجهة مستخدم (GUI) لصندوق محاكية بإطارات العناصر. استبدلت الحوارات كليهما بشاشة فعلية.

ما هو الحوار

ملف JSON في حزمة بيانات يصف نافذة:

data/<namespace>/dialog/welcome.json

{
  "type": "minecraft:notice",
  "title": { "text": "Welcome" },
  "body": [{ "type": "minecraft:plain_message",
             "contents": { "text": "Pick a class to begin." } }],
  "action": { "label": { "text": "Continue" } }
}

ثم /dialog show @p my_pack:welcome.

الأنواع

multi_action هو الأداة الأساسية — إنه أداة اختيار الفئة، والمتجر، وقائمة الانتقال.

الأزرار تشغل الأوامر

{ "label": { "text": "Warp to spawn" },
  "action": { "type": "minecraft:run_command", "command": "/spawn" } }

مثل clickEvent في الدردشة، يتم تشغيل هذا بواسطة اللاعب الناقر، بمستوى صلاحياته. الزر الذي يستدعي أمرًا مخصصًا للمشغلين فقط لا يفعل شيئًا للاعب العادي. الحل القياسي هو هدف trigger: يشغل الزر /trigger warp set 1 وتقوم دالة تعمل بشكل دوري بالجزء المتميز.

المدخلات

"inputs": [
  { "type": "minecraft:text", "key": "name", "label": { "text": "Your name" }, "max_length": 16 },
  { "type": "minecraft:boolean", "key": "pvp", "label": { "text": "Enable PvP" } },
  { "type": "minecraft:single_option", "key": "class", "options": [
      { "id": "mage", "display": { "text": "Mage" } },
      { "id": "rogue", "display": { "text": "Rogue" } } ] }
]

تصل القيم كـ وسائط ماكرو للدالة التي يستدعيها الزر، لذا فإن الدالة المستقبلة هي ماكرو:

$say Welcome $(name), you chose $(class)

البادئة $ على السطر و $(key) للاستبدال. هذه هي آلية الربط بأكملها، وهي ما يجعل الحوارات مفيدة حقًا بدلاً من كونها مجرد زينة.

لماذا يتفوق هذا على حيلة الكتاب

• إنها شاشة، لذا فهي توقف الإدخال بدلاً من الجلوس في سجل الدردشة.
• المدخلات موجودة بالفعل. يمكن للكتاب أن يقدم روابط فقط.
• لا يتطلب أي عنصر. لا يوجد شيء يمكن فقده أو إسقاطه أو تكراره.
• يغلق بشكل نظيف ولا يمكن التمرير للعودة إليه.

الشيء الوحيد الذي لا تزال الكتب تفعله بشكل أفضل هو القراءة المطولة — جسم الحوار ليس مكانًا جيدًا لثلاث صفحات من القصص.

أنماط نقاط الطريق

تغطي نفس الأداة نقاط الطريق في شريط تحديد المواقع (locator-bar waypoints)، وهي سجل حزمة بيانات منفصل يتحكم في لون العلامة والرمز الرسومي (sprite) المعروض للاعب أو الموضع المتتبع. مفيد لعلامات الفريق حيث قد يكون شريط الزعيم (bossbar) تدخليًا للغاية.

قم ببناء شاشات حوار بمدخلات وأزرار، وخصص أنماط نقاط الطريق، في منشئ مدخلات الحوار وأنماط نقاط الطريق.

منشئ الحوارات وأنماط نقاط الطريق →