أخطاء أوامر ماينكرافت في الإصدار 1.21: إصلاح نتائج التنفيذ غير المتوقعة

عندما يفشل أمرٌ ما في ماينكرافت جافا الإصدار 1.21، أو يبدو أنه لا يُحدث أي تغيير، أو يتصرف بشكلٍ مختلف في نافذة الدردشة، أو كتلة الأوامر، أو حزمة البيانات، قم بتصحيحه بترتيبٍ مُتّسق: سجّل الملاحظات الدقيقة، واختبر أقصر أمر، وتحقق من مُنفِّذه وموقعه، ثم افحص المُحدِّدات، والنتائج، وملفات حزمة البيانات. تُساعد هذه الطريقة في عزل أخطاء أوامر ماينكرافت الشائعة دون تغيير عدة أشياء في وقتٍ واحد.

ملاحظة: الأمثلة أدناه خاصة بإصدار جافا. يستخدم إصدار بيدروك أوامر وسلوكيات إضافات مختلفة. قد تختلف إصدارات تصحيح ماينكرافت 1.21.x والإصدارات اللاحقة، لذا تحقق من إصدار اللعبة المحدد قبل نسخ الصيغة إلى عالم آخر.

قم بمطابقة العرض مع السبب المحتمل

الخطوة 1: اقرأ الخطأ بدقة وجرّب أحد الأوامر

انسخ نص الأمر والخطأ بالكامل قبل إجراء أي تغيير. تشير رسالة الخطأ باللون الأحمر عادةً إلى أن ماينكرافت لم تتمكن من تحليل الأمر. أما الأمر الذي يتم تحليله ولكنه لا يُظهر أي أهداف، فغالبًا ما يكون به مشكلة في المُحدِّد أو السياق. وقد يكون الأمر الناجح الذي لا يُحدث تغييرًا واضحًا في العالم قد نُفِّذ على هدف أو موقع أو حالة مختلفة عن المقصود.

في إصدار جافا، اعرض ملاحظات الدردشة باستخدام الأمر /gamerule sendCommandFeedback true`. إذا كانت مخرجات كتلة الأوامر مخفية، فقم بتمكينها باستخدام الأمر /gamerule commandBlockOutput true`. تُظهر هذه القواعد الملاحظات، لكنها لا تُفعّل مُسجِّل أوامر مُفصَّلًا مُنفصلًا. اختبر الأمر في الدردشة أولًا كلما أمكن، ثم انقله إلى كتلة أو دالة بعد التأكد من عمله.

في حالة السلاسل الطويلة /execute، يُنصح بتقليصها إلى مرحلة واحدة في كل مرة: تأكيد asالمُنفِّذ، وإضافة الأوامر atفقط إذا كان الموقع مهمًا، وإضافة شرط if"أو" unless، وإنهاء runالعملية بأمر واحد. في لغة جافا، runيُعرِّف الأمر المراد تنفيذه؛ وهو ليس أمرًا على مستوى النظير يُمكن تكراره لإضافة أوامر إضافية.

الخطوة الثانية: التحقق من هوية من يقوم بتشغيل الأمر ومكانه

يُعد سياق التنفيذ سببًا شائعًا لنتائج أوامر ماينكرافت غير المتوقعة. /execute asيُغيّر هذا الأمر مُنفِّذ الأمر /execute at، ويُغيّر سياق الموضع والدوران والأبعاد. تُؤدّي هذه الأوامر الفرعية وظائف مُختلفة.

على سبيل المثال، يتحقق أمر جافا هذا من وجود زومبي ضمن ثمانية مربعات من كل لاعب، ثم يتم تشغيله sayكلاعب ذلك:

/execute as @a at @s if entity @e[type=minecraft:zombie,distance=..8,limit=1] run say Zombie nearby

إذا تم تشغيل مُحدِّد مشابه من وحدة تحكم الخادم، فقد لا يكون موقعه الابتدائي هو موقع اللاعب. يستخدم كتلة الأوامر موقع الكتلة، وترث الدالة السياق من مُستدعيها. استخدم هذا الخيار at @sعندما يكون المُنفِّذ الحالي كيانًا، ويكون موقع هذا الكيان هو نقطة المرجع المقصودة. تحقق أيضًا من البُعد وما إذا كان الهدف موجودًا في أجزاء مُحمَّلة؛ إذ لا يمكن لمُحدِّد الكيانات العثور على هدف غير مُتاح.

الخطوة 3: تضييق نطاق المحددات وإثبات شروط لوحة النتائج

ابدأ بكيان واحد معروف، ثم أضف وسيطات المُحدِّد واحدًا تلو الآخر. يُعدّ المُحدِّد البسيط @e[type=minecraft:zombie,limit=1,sort=nearest]أسهل في الفهم من المُحدِّد الواسع @e. أضف وسيطًا مُحدِّدًا distanceمُحدَّدًا عندما يكون النطاق مهمًا، واستخدم وسيطًا مُحدَّدًا مُتعمَّدًا limitعندما تكون هناك حاجة إلى مُطابقة واحدة أو بضع مُطابقات فقط. لا يُعدّ المُحدِّد الواسع خطأً بالضرورة، ولكن كل كيان مُطابق قد يُنشئ سياق تنفيذ آخر؛ وقد تجعل عمليات التحديد الكبيرة أو المُتداخلة الدوال المُعقَّدة مُكلفة أو تُؤدِّي إلى تجاوز حدود الأوامر.

بالنسبة لشرط النتيجة، قم بإنشاء الهدف مرة واحدة وأعطِ اللاعب التجريبي قيمة معروفة قبل إضافة الشرط إلى سلسلة أكبر:

• /scoreboard objectives add debug dummyيُنشئ الهدف. إذا كان موجودًا بالفعل، فاستمر في استخدامه بدلاً من اعتبار تلك الرسالة سببًا لإعادة إنشائه.
• /scoreboard players set @s debug 1يُعطي اللاعب الذي يُشغّل الأمر قيمة اختبار.
• /execute if score @s debug matches 1 run say Score check passedيؤكد ذلك أن الهدف والحامل والمقارنة يعملون معًا.

إذا استمر فشل التحقق، فتأكد من صحة تهجئة الكلمة واستخدام الأحرف الكبيرة والصغيرة، ومن صاحب النتيجة، وما إذا كان اللاعب الذي تتوقعه هو من يُنفذ الأمر. @sقد لا يشير الأمر الصادر من كتلة الأوامر أو وحدة التحكم إلى نفس اللاعب الذي يشير إليه في المحادثة.

الخطوة 4: تحقق من مسارات حزمة بيانات Java 1.21 وأعد تحميل الحالة

غيّر إصدار Java 1.21 أسماء العديد من مجلدات حزم البيانات من صيغة الجمع إلى صيغة المفرد. على وجه الخصوص، يوجد ملف الدالة في المسار المحدد data/<namespace>/function/<path>.mcfunction، وتستخدم وسوم الدوال الصيغة data/minecraft/tags/function/. قد تحتوي حزمة منسوخة من إصدار أقدم على المسار functionsأو tags/functions، مما قد يجعل الدالة المكتوبة بشكل صحيح تبدو وكأنها مفقودة.

على سبيل المثال، data/example/function/start.mcfunctionيتم استدعاء الدالة باستخدام /function example:start. بعد تعديل الحزمة، شغّل /reload، ثم /datapack list enabled. تأكد من إدراج الحزمة، وأن مساحة الاسم تتطابق مع استدعاء الدالة، وأن كل اسم مجلد وملف يتطابق مع المسار. تحقق من صحة البيانات pack.mcmetaبصيغة JSON، واستخدم تنسيق الحزمة المدعوم من قِبل الإصدار 1.21.x المحدد بدلاً من نسخ رقم من حزمة أقدم.

فحصان للتوافق يمنعان الإصلاحات المضللة.

قد تفشل أمثلة NBT القديمة للعناصر في الإصدار 1.21

نقل إصدار Java 1.20.5 بيانات تكديس العناصر من العديد من حقول NBT القديمة إلى مكونات البيانات المهيكلة، ويرث الإصدار 1.21 هذا التركيب. لذلك، قد يتم تحليل الأمثلة القديمة /give، /itemمثل جداول الغنائم أو الشروط، بشكل مختلف أو قد تفشل عند نسخها دون تغيير. استخدم تركيب المكون لخصائص العناصر المدعومة؛ واستخدم custom_dataبيانات العناصر المخصصة بدلاً من افتراض أن كل علامة عنصر قديمة لا تزال صالحة.

يمكن أن يتوسع تنفيذ الوظيفة أو يتوقف عند حدود معينة.

يمكن للمحددات المتداخلة أن تضاعف السياقات: فتشغيل أمر ما execute as @e at @e، على سبيل المثال، قد يُنشئ العديد من التركيبات. كما أن الدوال التكرارية أو منطق كتلة الأوامر المتكرر قد يستهلك حدود عمل الأوامر. اجعل المحدد ضيقًا قدر الإمكان، وقسّم المنطق الكبير إلى دوال صغيرة، وأضف شرطًا يوقف تكرار العمل في النهاية. لا تفترض أن النتيجة الجزئية تعني أن اللعبة تجاهلت بقية الأمر الصحيح نحويًا.

قبل أن تعيد الأمر إلى العالم

• أعد اختبار الأوامر المدمرة في عالم منسوخ أو قابل للاستبدال.
• قم بتغيير متغير واحد في كل مرة واحتفظ برسالة الخطأ الأولى.
• استخدم أمرًا مرئيًا غير ضار sayللتحقق من المنفذ والموقع قبل تغيير الكتل أو الكيانات.
• تحقق من مستوى الإذن عندما يعمل أمر ما كمشغل في الدردشة ولكنه يفشل من وظيفة الخادم أو كتلة الأوامر.
• قارن إصدار اللعبة ونسختها بالضبط مع مصدر الأمر الذي نسخته.

مراجع ماينكرافت الرسمية

تُفصّل ملاحظات إصدار Java Edition 1.21 الرسمية عمليات إعادة تسمية مجلدات حزم البيانات، بما في ذلك تغيير اسم المجلدات functionsإلى functionو tags/functions. وتصف ملاحظات إصدار Java Edition 1.20.5 الرسميةtags/function عملية ترحيل مكونات العناصر. بينما تشرح ملاحظات إصدار Java Edition 1.20.3 حدود تنفيذ الدوال وتوسيع السياق. هذه المراجع خاصة بإصدار Java Edition؛ لذا يُرجى مراجعة ملاحظات الإصدار الخاصة بالإصدار الذي تستخدمه.