أدلة / استكشاف الأخطاء وإصلاحها

حزمة البيانات لا تُحمَّل؟ بنية المجلدات والأسماء الثلاثة التي يجب أن تتطابق

حزمة البيانات التي لا تظهر في /datapack list تعاني من مشكلة في المسار، لا في الكود. إليك الشجرة الدقيقة، وقاعدة النطاق، والمجلدات التي تغيّرت أسماؤها.

2026-07-03

/datapack list لا يُظهر شيئًا، أو يُظهر الحزمة كمعطّلة. في الغالبية العظمى من الحالات يكون ملف JSON سليمًا والمجلدات هي الخاطئة.

الشجرة

world/datapacks/my_pack/
├── pack.mcmeta
└── data/
    ├── my_namespace/
    │   ├── function/         one .mcfunction per file
    │   ├── recipe/
    │   ├── loot_table/
    │   ├── advancement/
    │   └── predicate/
    └── minecraft/
        └── tags/
            └── function/
                └── load.json

ثلاثة أسماء يجب أن تتوافق، وواحد منها ليس بديهيًا:

1. pack.mcmeta في جذر الحزمة — بجانب data/، وليس داخله.
2. data/<namespace>/ — النطاق الخاص بك، بأحرف صغيرة، بلا مسافات. يصبح هذا البادئة في my_namespace:my_function.
3. أسماء مجلدات الفئات، التي تغيّرت وهي السبب المعتاد.

أُعيدت تسمية المجلدات إلى صيغة المفرد

هذا كسر الكثير من الحزم والكثير من الشروحات:

الحزمة التي تستخدم أسماء الجمع تُحمَّل — تظهر في /datapack list — ولا تفعل شيئًا على الإطلاق، وهذا هو أكثر أنماط الفشل إرباكًا في هذه المجموعة. بقي tags/ بصيغة الجمع، لكن المجلدات داخله صارت مفردة مع كل ما سواه — tags/functions/ أصبح الآن tags/function/. نعم، هذا تناقض.

تشغيل شيء تلقائيًا

وسمتان خاصتان:

data/minecraft/tags/function/load.json   → runs once on load/reload
data/minecraft/tags/function/tick.json   → runs every tick

لاحظ data/minecraft/، وليس النطاق الخاص بك — الوسم ينتمي إلى Minecraft، والدوال التي يشير إليها تنتمي إليك:

{ "values": ["my_namespace:setup"] }

التشخيص بالترتيب

1. /datapack list — إذا لم تكن الحزمة مدرجة إطلاقًا، فإن pack.mcmeta مفقود، أو تالف البنية، أو في مستوى أعمق بمقدار واحد.
2. مدرجة لكن معطّلة — /datapack enable "file/my_pack". انتبه إلى بادئة file/ وعلامات الاقتباس.
3. مدرجة ومفعّلة لكنها خاملة — أسماء مجلدات بصيغة الجمع، أو وسم تحميل في نطاقك الخاص بدلًا من minecraft.
4. /reload واقرأ السجل (logs/latest.log، أو مخرجات المشغّل). الدالة التي بها خطأ نحوي تُسقَط هناك مع "Failed to load function …"؛ أما الدردشة فتقول فقط إن إعادة التحميل انتهت.

مضغوطة أم لا

كلاهما يعمل. المضغوطة تعني pack.mcmeta في جذر ملف zip، تمامًا كما في حزم الموارد. صيغة المجلد أسهل أثناء التطوير لأن /reload يلتقط التعديلات دون إعادة الضغط.

الموضع على السيرفر

على السيرفر يكون المسار <world>/datapacks/، حيث <world> هي قيمة level-name في server.properties — وليس جذر السيرفر. إسقاط الحزمة في مجلد السيرفر هو أكثر خطأ شائع من جانب السيرفر.

جمّع حزمة بأسماء المجلدات الحالية وpack.mcmeta صالح، ثم نزّلها جاهزة للإسقاط، عبر Datapack Studio — وضع وسم التحميل في data/minecraft/tags/function/، كما هو موضح أعلاه.

Datapack Studio →