PlugManX هو إضافة Minecraft لإدارة الإضافات أثناء التشغيل على خوادم Bukkit/Spigot. يوفّر أوامر داخل اللعبة ومن خلال الـ console لفحص الإضافات المثبتة، والتحكم في دورة حياتها (enable/disable/load/unload/reload/restart)، وإنشاء قوائم إضافات لأغراض التصحيح أو التدقيق.

🎯 الهدف

هذه الإضافة مخصّصة لمسؤولي الخوادم والمطورين الذين يحتاجون إلى إدارة إضافات الخادم أو تصحيحها دون إجراء إعادة تشغيل كاملة للخادم. وهي في الأساس إضافة أدوات ومرافق للصيانة واستكشاف المشكلات.

⚙️ المميزات

تفعيل الإضافات وتعطيلها وإعادة تشغيلها (disable+enable)، وتحميلها، وإعادة تحميلها (unload+load)، وإلغاء تحميلها أثناء التشغيل.
عرض قائمة الإضافات المثبتة ترتيبًا أبجديًا، مع إمكانية إظهار الإصدارات.
عرض معلومات مفصلة عن الإضافة (الإصدار، المؤلفون، الأوامر، إلخ).
عرض الأوامر المسجّلة بواسطة إضافة ومعرفة أي إضافة تملك أمرًا معيّنًا.
إكمال تلقائي لاسم الإضافة والأمر.
تفريغ قائمة الإضافات والإصدارات إلى ملف.
التحقق مما إذا كانت الإضافة محدثة مقارنةً بمورد عبر الإنترنت (تم توثيق سلوك فحص التحديثات بواسطة المشروع).
دعم الصلاحيات عبر عقد الأوامر؛ وبشكل افتراضي تتطلب الأوامر صلاحيات المشغّل.

🧩 لمن هذا مخصص

مسؤولو الخوادم والمشغّلون الذين يحتاجون إلى التحكم في الإضافات بشكل فوري.
خوادم التطوير أو الاختبار حيث تحدث تغييرات متكررة على الإضافات.
خوادم Survival/SMP الصغيرة إلى المتوسطة أو الخوادم الخاصة حيث تكون إعادة التشغيل مزعجة.

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

يقوم مسؤول بتعطيل إضافة تسبب مشاكل دون إعادة تشغيل الخادم لاستعادة الاستقرار.
يقوم مطوّر بتحميل ملف jar لإضافة جديدة إلى خادم اختبار بينما يبقى اللاعبون متصلين.
إنشاء ملف تفريغ بأسماء الإضافات وإصداراتها للمساعدة في استكشاف الأخطاء أو حصر مكونات الخادم.

⌨️ الأوامر

الأمر	الوصف	الصلاحية	الوصول
`/plugman help`	عرض معلومات المساعدة.	`plugman.help`	Admin
`/plugman list [-v]`	عرض قائمة الإضافات بترتيب أبجدي. استخدم `-v` لإظهار الإصدارات.	`plugman.list`	Admin
`/plugman info [plugin]`	عرض معلومات حول إضافة.	`plugman.info`	Admin
`/plugman dump`	تفريغ أسماء الإضافات وإصداراتها إلى ملف.	`plugman.dump`	Admin
`/plugman usage [plugin]`	عرض الأوامر التي سجلتها إضافة.	`plugman.usage`	Admin
`/plugman lookup [command]`	العثور على الإضافة التي تم تسجيل أمر لها.	`plugman.lookup`	Admin
`/plugman enable [plugin	all]`	تفعيل إضافة.	`plugman.enable` / `plugman.enable.all`
`/plugman disable [plugin	all]`	تعطيل إضافة.	`plugman.disable` / `plugman.disable.all`
`/plugman restart [plugin	all]`	إعادة تشغيل (disable/enable) إضافة.	`plugman.restart` / `plugman.restart.all`
`/plugman load [plugin]`	تحميل إضافة.	`plugman.load`	Admin
`/plugman reload [plugin	all]`	إعادة تحميل (unload/load) إضافة.	`plugman.reload` / `plugman.reload.all`
`/plugman unload [plugin]`	إلغاء تحميل إضافة.	`plugman.unload`	Admin
`/plugman check [plugin	all] -f`	التحقق مما إذا كانت الإضافة محدثة.	`plugman.check` / `plugman.check.all`

🔐 الصلاحيات

الصلاحية	الوصف	الافتراضي
`plugman.admin`	يسمح باستخدام جميع أوامر PlugMan.	op
`plugman.update`	يسمح للمستخدم برؤية رسائل التحديث.	op
`plugman.help`	يسمح باستخدام أمر المساعدة.	op
`plugman.list`	يسمح باستخدام أمر list.	op
`plugman.info`	يسمح باستخدام أمر info.	op
`plugman.dump`	يسمح باستخدام أمر dump.	op
`plugman.usage`	يسمح باستخدام أمر usage.	op
`plugman.lookup`	يسمح باستخدام أمر lookup.	op
`plugman.enable`	يسمح باستخدام أمر enable.	op
`plugman.enable.all`	يسمح باستخدام أمر enable all.	op
`plugman.disable`	يسمح باستخدام أمر disable.	op
`plugman.disable.all`	يسمح باستخدام أمر disable all.	op
`plugman.restart`	يسمح باستخدام أمر restart.	op
`plugman.restart.all`	يسمح باستخدام أمر restart all.	op
`plugman.load`	يسمح باستخدام أمر load.	op
`plugman.reload`	يسمح باستخدام أمر reload.	op
`plugman.reload.all`	يسمح باستخدام أمر reload all.	op
`plugman.unload`	يسمح باستخدام أمر unload.	op
`plugman.check`	يسمح باستخدام أمر check.	op
`plugman.check.all`	يسمح باستخدام أمر check all.	op

⚙️ التثبيت

📥 الإعداد

حمّل ملف PlugManX الرسمي .jar وضعه في مجلد plugins/ الخاص بالخادم.
أعد تشغيل الخادم لتحميل الإضافة وتأكيد ظهور رسائل بدء التشغيل في الـ console.

🧾 الإعدادات

يوفّر المشروع ملف config.yml ضمن الموارد الخاصة به؛ وتقوم الإضافة بكتابة ملف إعدادات أو استخدامه عند التشغيل الأول.

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

يتم توزيع المشروع تحت رخصة MIT.
الأوامر وعقد الصلاحيات موثقة من قبل المشروع؛ وبشكل افتراضي تتطلب العقد صلاحيات المشغّل.
يتم الحفاظ على مستودع المشروع وملفات الإعدادات في المستودع المصدري للإضافة.
تقوم الإضافة بإجراء عمليات أثناء التشغيل قد تؤثر على حالة الإضافة؛ وقد يؤدي استخدام عمليات unload/load أثناء التشغيل إلى عدم استقرار مع بعض الإضافات، وعادةً ما يُنصح به للإدارة والتصحيح أكثر من الخوادم الإنتاجية عالية التوافر.

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

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

خوادم تستخدم PlugManX