Guides / Troubleshooting

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

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

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/
        └── tags/
            └── function/
                └── load.json

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

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

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

لقد أدى هذا إلى تعطيل العديد من الحزم والعديد من الدروس التعليمية:

الحزمة التي تستخدم الأسماء بصيغة الجمع تُحمّل — وتظهر في /datapack list — ولكنها لا تفعل شيئًا، وهو وضع الفشل الأكثر إرباكًا في المجموعة. بقيت tags/ بصيغة الجمع، وكذلك 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. مدرجة ومفعلة ولكنها خاملة — pack_format خاطئ، أو أسماء مجلدات بصيغة الجمع.
4. /reload واقرأ الدردشة. تظهر أخطاء بناء الجملة في الوظائف هناك، وليس بصمت.

مضغوطة أم لا

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

وضع الخادم

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

قم بتجميع حزمة بأسماء المجلدات الحالية، وpack.mcmeta صالح، وعلامة تحميل موصولة بالفعل، ثم قم بتنزيلها جاهزة للإسقاط، باستخدام Datapack Studio.

Datapack Studio →