إضافة Minecraft LuckPerms

🔌 حول LuckPerms

LuckPerms هو plugin أذونات لـ Minecraft يوفّر إدارة منظّمة للصلاحيات عبر المجموعات وعُقد المستخدمين والسياقات. وهو مصمم لمسؤولي الخوادم والمطورين الذين يحتاجون إلى نظام مرن وقابل للتدقيق للتحكم فيما يمكن للاعبين والأدوار فعله على الخوادم المفردة وإعدادات تعدد الخوادم.

🎯 الهدف

الهدف الأساسي من هذا plugin هو توحيد التعامل مع الصلاحيات: تعيين الصلاحيات للمستخدمين أو المجموعات، إدارة الوراثة، وتطبيق قواعد خاصة بالسياق (مثلًا حسب العالم أو الخادم). كما يوفّر واجهة API عامة للمطورين لكي تتمكن الإضافات والتكاملات الأخرى من قراءة بيانات الصلاحيات وتعديلها.

⚙️ الميزات

• إنشاء المجموعات وإدارة صلاحيات المستخدمين الأفراد.
• عُقد صلاحيات تراعي السياق (العوالم، الخوادم، وسياقات أخرى).
• وراثة المجموعات والتحكم في الوزن/الأولوية لترتيب المجموعات.
• محرر ويب للتعديل المرئي على الصلاحيات والمجموعات.
• عدة أنظمة تخزين وخيارات لمزامنة البيانات عبر الشبكات.
• API Java عام لتكامل الإضافات واستخدام المطورين.
• دعم متعدد المنصات عبر عدة تطبيقات لخوادم Minecraft.

🧩 لمن هو مخصص

• مالكو الخوادم والمسؤولون الذين يحتاجون إلى إدارة قوية للصلاحيات.
• مشغلو الشبكات الذين يديرون إعدادات proxy/back-end ويحتاجون إلى صلاحيات متزامنة.
• مطورو الإضافات الذين يريدون API مستقرة لقراءة الصلاحيات أو تعديلها.

🏗️ حالات استخدام مثالّية

• تحديد مجموعات staff وmoderator وplayer مع مجموعات صلاحيات مختلفة.
• تطبيق صلاحيات مؤقتة على اللاعبين (مثل وصول VIP مؤقت) باستخدام expiry nodes.
• مزامنة تغييرات الصلاحيات عبر خوادم back-end ضمن شبكة proxy.

⌨️ الأوامر

هذا الوصف لا يتضمن تفاصيل الأوامر لأن القوائم التفصيلية للأوامر موثقة في الوثائق الرسمية للمشروع.

🔐 Permissions

هذا الوصف لا يدرج عُقد الصلاحيات بشكل صريح؛ إذ يوثق المشروع عُقد الصلاحيات والقيم الافتراضية في وثائقه الرسمية.

⚙️ التثبيت

📥 الإعداد

• حمّل ملف jar الرسمي للـ plugin الخاص بالمنصة التي تستخدمها.
• ضع ملف jar داخل مجلد plugins/ الخاص بخادمك.
• أعد تشغيل الخادم وتحقق من وحدة التحكم للتأكد من تحميل plugin بنجاح.

📦 الاعتماديات

• لا توجد اعتماديات وقت التشغيل مذكورة هنا. استخدم الوثائق الرسمية لتأكيد التكاملات الاختيارية.

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

• يوفّر المشروع الرسمي نسخًا خاصة بكل منصة وAPI Java عامة.
• يدعم المشروع عدة أنظمة تخزين ويقدّم ميزات مزامنة الشبكة.
• يتم توزيع هذا plugin تحت رخصة open-source متساهلة.

🤝 متى يكون هذا plugin مفيدًا

إذا كنت تحتاج إلى إدارة صلاحيات مركزية تراعي السياق مع API للتكاملات وخيارات للتخزين/المزامنة متعددة الخوادم، فإن LuckPerms يوفّر هذه الإمكانات ضمن مشروع open-source تتم صيانته.