Minepacks هي إضافة Minecraft تضيف حقائب ظهر افتراضية (خزائن اللاعبين) إلى خوادم Bukkit/Spigot/Paper. وهي تمنح اللاعبين مساحة تخزين شخصية إضافية يمكن الوصول إليها عبر الأوامر أو عناصر اختصار، مع الحفاظ على NBT الخاص بالعناصر ودعم سلوك قابل للتخصيص.

🎯 الهدف

Minepacks تحل الحاجة إلى تخزين إضافي للاعبين دون تعديل مخازن vanilla أو إضافة تعديلات على جهة العميل. وهي موجهة لمسؤولي الخوادم الذين يريدون حقائب ظهر تتحكم بها الصلاحيات، وتبقى دائمة، مع أحجام قابلة للتخصيص وواجهات تخزين مختلفة.

⚙️ المميزات

أحجام الحقائب تتحكم بها الصلاحيات (عدة مستويات للحجم).
التقاط تلقائي للعناصر عندما يمتلئ مخزون اللاعب (قابل للتخصيص).
عنصر اختصار للوصول السريع إلى الحقيبة (يمكن تعطيله).
عدة واجهات تخزين: ملفات مسطحة، SQLite، MySQL.
دعم متعدد اللغات (ملفات اللغات مرفقة).
فلتر عناصر لحظر عناصر محددة من التخزين.
يحافظ على NBT الخاص بالعناصر (أي عنصر يمكن تخزينه في صندوق يمكن تخزينه في الحقيبة).
يدعم معالجة تغيير الاسم/UUID للحسابات التي تم نقلها.
ملف JAR واحد متوافق مع العديد من إصدارات Minecraft المدعومة.
تكامل اختياري مع PCGF PluginLib (يضيف وظائف API).
API عامة للمطورين ومحدّث تلقائي.

🧩 لمن هذا مخصص

خوادم Survival وSMP التي تريد توسيع مساحة تخزين اللاعبين.
الخوادم العامة أو الخاصة التي تحتاج إلى مستويات مخزون تعتمد على الصلاحيات.
الخوادم التي تتطلب خزائن لاعبين دائمة معتمدة على قاعدة بيانات.
مطورو الإضافات الذين يحتاجون إلى API لدمج الحقائب.

🏗️ حالات استخدام مثال

منح المتبرعين أحجام حقائب أكبر عبر مجموعات الصلاحيات.
توفير مخزون ثانوي صغير ودائم للاعبين (مثل الأدوات أو كتل البناء).
استخدام تخزين MySQL للاحتفاظ بالحقائب عبر شبكة من الخوادم.

⌨️ الأوامر

الأمر	الوصف	الصلاحية	الوصول
`/backpack help`	يعرض جميع أوامر هذه الإضافة.	غير محدد	لاعب
`/backpack`	يفتح حقيبة ظهر اللاعب.	`backpack.use`	لاعب
`/backpack clean`	يزيل جميع العناصر من حقيبة ظهر اللاعب.	`backpack.clean`	لاعب
`/backpack clean <playername>`	يزيل جميع العناصر من حقيبة ظهر لاعب آخر.	`backpack.clean.other`	مسؤول
`/backpack <playername>`	يعرض حقيبة ظهر لاعب آخر.	`backpack.others`	مسؤول

🔐 الصلاحيات

الصلاحية	الوصف	الافتراضي
`backpack.use`	يسمح للاعب بفتح حقيبته.	غير محدد
`backpack.fullpickup`	يسمح بالتقاط العناصر تلقائيًا إلى الحقائب عندما يمتلئ المخزون (يجب تفعيل الميزة في config).	غير محدد
`backpack.size.1`	يمنح حقيبة ظهر صغيرة جدًا (مستوى الحجم 1).	غير محدد
`backpack.size.2`	يمنح حقيبة ظهر 2*9.	غير محدد
`backpack.size.3`	يمنح حقيبة ظهر 3*9.	غير محدد
`backpack.size.4`	يمنح حقيبة ظهر 4*9.	غير محدد
`backpack.size.5`	يمنح حقيبة ظهر 5*9.	غير محدد
`backpack.size.6`	يمنح حقيبة ظهر 6*9.	غير محدد
`backpack.clean`	يسمح للاعب بتنظيف حقيبة ظهره الخاصة.	غير محدد
`backpack.clean.other`	يسمح بتنظيف حقائب ظهر اللاعبين الآخرين.	غير محدد
`backpack.others`	يسمح بفتح حقائب ظهر اللاعبين الآخرين.	غير محدد
`backpack.others.edit`	يسمح بتعديل حقائب ظهر اللاعبين الآخرين.	غير محدد
`backpack.keepOnDeath`	يسمح للاعب بالاحتفاظ بالعناصر الموجودة في حقيبة ظهره عند الموت.	غير محدد
`backpack.noCooldown`	يتجاوز فترة الانتظار قبل فتح حقيبة الظهر.	غير محدد

⚙️ التثبيت

📥 الإعداد

حمّل ملف JAR الرسمي للإضافة وضعه في مجلد plugins/ الخاص بخادمك.
أعد تشغيل الخادم وتحقق من سجلّات الخادم للتأكد من أن Minepacks قد تم تحميله.
إذا كنت تخطط لاستخدام تخزين MySQL أو SQLite، فقم بتكوين واجهة التخزين عبر ملفات إعدادات الإضافة.

📦 المتطلبات

اختياري: PCGF PluginLib (يتيح ميزات API إضافية). إذا لم يكن موجودًا، فهناك نسخة مستقلة متاحة.

🧠 ملاحظات تقنية

برمجيات الخادم المؤكدة المدعومة: Bukkit وSpigot وPaper.
متطلب التشغيل: Java 8.
تدعم الإضافة عدة واجهات تخزين (Files وSQLite وMySQL) وتضم ملفات متعددة اللغات.
يوفر Minepacks API للمطورين؛ وتتوفر نسخة مستقلة للخوادم التي لا تستخدم PCGF PluginLib.
المشروع منشور تحت GPL-3.0.

🤝 متى تكون هذه الإضافة مفيدة

إذا كنت تحتاج إلى تخزين إضافي للاعبين يتحكم به عبر الصلاحيات مع دعم دائم لقواعد البيانات وإمكانية الوصول إلى API للمطورين، فإن Minepacks يوفر حقائب قابلة للتخصيص، وواجهات تخزين، ودعمًا للغات دون الحاجة إلى تعديلات على جهة العميل.

خوادم تستخدم Minepacks