إضافة Minecraft AxVaults

🔌 حول AxVaults

AxVaults هو إضافة Minecraft خفيفة الوزن ومبنية على الصلاحيات، توفر خزائن افتراضية لكل لاعب (تخزين). تتم صيانة المشروع بواسطة Artillex-Studios، وهو مصمم لتخزين أي عنصر (بما في ذلك العناصر التي تحتوي على NBT)، ومنع النسخ، وتوفير وصول إداري لعرض الخزائن وتعديلها.

🎯 الهدف

يعالج AxVaults الحاجة إلى تخزين لاعب دائم ومعزول يعمل مع العناصر المخصصة وبيانات NBT، مع السعي لتجنب استغلالات النسخ. وهو مخصص للخوادم التي تريد خزائن قابلة للضبط ومتحكمًا بها عبر الصلاحيات كبديل أو مكمل للصناديق المادية.

⚙️ المميزات

• وصول إلى الخزائن يعتمد على الصلاحيات باستخدام nodes بالشكل axvaults.vault.<number>.
• عدد غير محدود من خانات الخزائن لكل لاعب (محدود عمليًا بحدود integer).
• تخزين آمن مع NBT: يتم حفظ العناصر بصيغة ثنائية للحفاظ على بيانات العناصر المخصصة.
• حماية من dupe حسب التصميم (تخزين يديره الإضافة بدلًا من تسلسل العناصر الخام).
• واجهة/قائمة اختيار للتنقل بين صفحات الخزائن مع دعم pagination.
• نظام blacklist لمنع وضع عناصر محددة داخل الخزائن.
• أيقونات قابلة للتخصيص تتيح للاعبين اختيار أيقونات الخزائن.
• أدوات إدارية لعرض خزائن اللاعبين وتعديلها، بما في ذلك الوصول للاعبين غير المتصلين للطاقم.
• دعم قواعد البيانات H2 وSQLite كخلفيات للتخزين.

🧩 لمن هذه الإضافة

• خوادم Survival وSMP التي تحتاج إلى تخزين خاص لكل لاعب.
• الخوادم التي تستخدم عناصر مخصصة أو صناديق crate وتحتاج إلى تخزين آمن مع NBT.
• الخوادم المُدارة إداريًا والتي تحتاج إلى وصول الطاقم لفحص أو تعديل خزائن اللاعبين.

🏗️ أمثلة على الاستخدام

• منح اللاعبين عددًا ثابتًا من الخزائن عبر الصلاحيات (مثلًا axvaults.vault.1 وaxvaults.vault.5).
• استخدام قائمة الاختيار لتمكين اللاعبين من فتح صفحات خزائن مختلفة بسرعة.
• منع مفاتيح الصناديق crate أو عناصر الاقتصاد الأخرى من التخزين في الخزائن باستخدام blacklist.
• يسترجع الطاقم خزينة لاعب أو يضبطها بينما يكون هذا اللاعب غير متصل.

🔐 الصلاحيات

⚙️ التثبيت

📥 الإعداد

• نزّل ملف jar الرسمي للإضافة وضعه في مجلد plugins/ على خادمك لخوادم Bukkit/Spigot/Paper.
• أعد تشغيل الخادم وتحقق من console الخادم للتأكد من تحميل الإضافة.
• اضبط الصلاحيات (امنح nodes axvaults.vault.<number> حسب الحاجة) باستخدام إضافة الصلاحيات لديك.

📦 المتطلبات

• لا توجد متطلبات runtime مطلوبة افتراضيًا (لا توجد إضافات مطلوبة مؤكدة). تستخدم الإضافة خلفيات التخزين الخاصة بها.

🧾 الإعدادات

• تستخدم الإضافة خلفيات تخزين قابلة للضبط (تم توثيق H2 وSQLite كخيارين مدعومين).
• يمكن ضبط blacklist وإعدادات الأيقونات وصفوف تخزين الخزائن (راجع التوثيق الرسمي للتفاصيل).

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

• تتم صيانة مستودع المشروع والموارد الرسمية بواسطة Artillex-Studios.
• تعلن الإضافة عن دعم تخزين H2 وSQLite.
• يمكن للمشرفين الوصول إلى خزائن اللاعبين غير المتصلين (الوصول الإداري غير المتصل موثق).
• تذكر الإضافة أنها dupe-proof حسب التصميم وتخزن العناصر بصيغة ثنائية للحفاظ على NBT.
• تأكد من متطلبات Java وإصدارات الخوادم المدعومة من ملاحظات الإصدار الرسمية قبل النشر.

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

إذا كنت تحتاج إلى تخزين افتراضي آمن مع NBT، ومتحكم به عبر الصلاحيات، للاعبين مع أدوات فحص للطاقم وتخزين بسيط معتمد على قواعد البيانات (H2/SQLite)، فإن AxVaults يقدم حلًا مركّزًا دون الحاجة إلى تبعيات إضافية.