إضافة Minecraft PermissionsEx

🔌 حول PermissionsEx

PermissionsEx (PEX) هو إضافة Minecraft توفر إدارة كاملة للإذونات والمجموعات للخوادم وشبكات البروكسي. يوفّر API للمطورين، ويدعم تطبيقات متعددة للمنصات، وهو مصمم ليكون قابلاً للتوسعة عبر backends مختلفة لقاعدة البيانات وموائمات للمنصات.

🎯 الهدف

PermissionsEx مخصص لمديري الخوادم ومطوري الإضافات الذين يحتاجون إلى تحكم دقيق في عقد الإذونات، وتسلسلات المجموعات، والاستعلام عن الإذونات أثناء التشغيل. وهو يستهدف إعدادات الخادم الواحد وكذلك شبكات متعددة الخوادم/البروكسي من خلال توفير builds خاصة بالمنصة ونواة مستقلة عن طريقة التنفيذ.

⚙️ المميزات

• تعيين دقيق لعقد الإذونات وإدارة المجموعات.
• API برمجية للإضافات للاستعلام عن الإذونات وتعديلها أثناء التشغيل.
• معمارية datastore قابلة للإضافة (تدعم إضافة أو تنفيذ backends جديدة).
• تطبيقات متعددة للمنصات (Bukkit/Spigot/Paper، Sponge، BungeeCord/Waterfall، Velocity، Fabric).
• ملفات build متاحة للتثبيتات الخاصة بكل منصة وملفات تطوير للاستخدام كمكتبة.

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

• مشغلو الخوادم الذين يحتاجون إلى مجموعات أذونات منظمة وinheritance.
• الشبكات التي تستخدم البروكسي (BungeeCord/Waterfall، Velocity) وتحتاج إلى نظام أذونات متسق عبر خوادم الـ backend.
• مطورو الإضافات الذين يحتاجون إلى API لقراءة أو تعديل بيانات الإذونات برمجيًا.

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

• إنشاء مجموعات مبنية على الأدوار (admin، moderator، builder، default) مع مجموعات أذونات مختلفة.
• شبكة معتمدة على البروكسي تستخدم builds للمنصة من أجل التعامل المتسق مع الإذونات عبر خوادم الـ backend.
• مطور يدمج التحقق من الإذونات في إضافات مخصصة عبر API الخاصة بـ PEX.

⚙️ التثبيت

📥 الإعداد

• احصل على build الرسمي للمنصة (ينتج المشروع ملفات .jar للمنصات المدعومة).
• ضع ملف .jar في مجلد plugins/ الخاص بخادمك في خوادم Bukkit/Spigot/Paper وما شابهها (أو في مجلد الإضافة/الـ mod المناسب للمنصات الأخرى).
• أعد تشغيل الخادم وراقب كونسول الخادم للتأكد من أن الإضافة تم تحميلها وأنها أنشأت مجلدات الإعدادات/البيانات الخاصة بها.

📦 المتطلبات

• لا توجد متطلبات runtime افتراضية مطلوبة في المستودع الأساسي؛ وتتوفر builds خاصة بالمنصة. (لا تفترض أن إضافات أخرى مطلوبة إلا إذا نصّ build أو التوثيق الذي اخترته على ذلك.)

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

• يوفر المشروع نواة modular وتطبيقات خاصة بالمنصة؛ ويتم توزيعه كملفات منفصلة لمنصات الخوادم والبروكسي المختلفة.
• تتوفر ملفات API و Maven/Gradle للمطورين الذين يرغبون في تضمين مكونات PEX في مشاريع أخرى.
• تم الحفاظ على المستودع المصدر علنًا ويضم tracker للمشكلات وموارد توثيق للإعداد والتطوير.

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

إذا كنت تحتاج إلى نظام أذونات يفصل المنطق الأساسي عن تطبيقات المنصة ويوفر API للمطورين، فإن PermissionsEx مفيد لأنه يقدم builds خاصة بالمنصة، وقابلية توسعة للـ datastore، ووصولًا برمجيًا إلى بيانات الإذونات.