إضافة Minecraft PvPManager

🔌 حول PvPManager

PvPManager هو إضافة Minecraft لإدارة سلوك القتال بين اللاعبين وقواعد الخادم المتعلقة بالقتال. يجمع بين تبديل PvP، ووسم القتال، ومنع combat-log، وحماية اللاعبين الجدد، وعدة سلوكيات عند القتل/إعادة الظهور في إضافة واحدة قابلة للتخصيص وموجهة لمسؤولي الخوادم.

🎯 الهدف

الهدف الأساسي من PvPManager هو توفير تحكم مركزي وقابل للتخصيص في تفاعلات PvP والحالات الخاصة المرتبطة بالقتال، بحيث يمكن لمالكي الخوادم فرض قواعد متسقة (تبديل PvP، معاقبة combat logging، حماية القادمين الجدد، التحكم في مكافآت/عقوبات القتل، وإدارة قيود القتال).

⚙️ الميزات

• تبديل PvP لكل لاعب، أو لكل عالم، أو بشكل عام.
• نظام وسم القتال مع مؤقتات قابلة للتخصيص ومؤشرات مرئية (action bar/boss bar).
• منع combat-log مع عقوبات قابلة للتخصيص (إسقاط inventory، إسقاط armor/exp، عقوبة مالية، قتل اللاعب، بث/تسجيل الأحداث).
• حماية اللاعبين الجدد وحماية أثناء respawn/teleport.
• منع border-hopping (منع الهروب إلى المناطق الآمنة أثناء وجود الوسم) ومشغلات anti kill-abuse.
• تعطيل الأفعال أثناء القتال (fly، تغيير gamemode، الأوامر، enderpearls، وضع البلوكات، إلخ).
• خيارات التعامل مع inventory (الاحتفاظ، الإسقاط، أو نقل الإسقاطات إلى القاتل) ودعم auto-soup.
• مكافآت/عقوبات مالية وأوامر قابلة للتنفيذ عند القتل.
• تكامل مع PlaceholderAPI ودعم لإضافات المناطق (WorldGuard، Towny) وCitizens؛ وتكاملات اختيارية لسلوكيات محددة.
• قياس الاستخدام وإرسال البيانات عبر bStats.

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

• خوادم Survival وSMP التي تحتاج إلى قواعد PvP قابلة للتخصيص.
• الخوادم التي تتطلب حماية من combat logging وسلامة onboarding للاعبين الجدد.
• المسؤولون الذين يريدون قواعد قتل/مكافآت مدمجة وتبديل PvP بسيطًا دون عدة إضافات منفصلة.

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

• تفعيل حماية اللاعبين الجدد في الجلسات الأولى والسماح بـ PvP فقط بعد وقت قابل للتخصيص.
• وسم اللاعبين أثناء القتال ومنعهم من استخدام teleport أو الأوامر أو دخول المناطق الآمنة حتى ينتهي الوسم.
• معاقبة اللاعبين الذين يخرجون أثناء القتال بإسقاط inventory أو تطبيق عقوبة يحددها الخادم.
• مكافأة القاتلين بالمال تلقائيًا أو تنفيذ أوامر مخصصة عند القتل.

⌨️ الأوامر

ملاحظات: الأوامر المدرجة مأخوذة من التوثيق الرسمي للإضافة وصفحة الموارد. تمت توثيق عقد الصلاحيات لكل أمر من قبل المشروع، لكنها غير معروضة هنا.

⚙️ التثبيت

📥 الإعداد

• حمّل ملف JAR الرسمي للإضافة من صفحة التوزيع الخاصة بها لمنصتك.
• ضع ملف JAR في مجلد plugins/ على خادم متوافق مع Spigot/Paper.
• أعد تشغيل الخادم وتحقق من سجلات console للتأكد من تحميل الإضافة.

📦 المتطلبات

• PlaceholderAPI (تكامل اختياري لـ placeholders).
• تتوفر تكاملات مع إضافات المناطق وNPC مثل WorldGuard وTowny وCitizens (اختياري، تُستخدم عند توفرها).

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

• برمجيات الخادم المدعومة المؤكدة تشمل Spigot وPaper؛ كما أن دعم Folia مذكور أيضًا من قبل المشروع.
• توفر الإضافة API للمطورين وتنشر builds dev للاختبار.
• ينشر المشروع الشيفرة المصدرية وتتبع المشاكل في مستودعه العام ويستخدم bStats للقياس.
• تمت تجربة إصدارات عديدة من Minecraft؛ ويجب على مالكي الخوادم مراجعة توثيق الإضافة لمعرفة التوافق الدقيق مع إصدار خادم محدد.

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

PvPManager مفيد عندما تحتاج إلى إضافة واحدة قابلة للتخصيص للتعامل مع تبديل PvP وcombat tagging وعقوبة combat-log وحماية اللاعبين الجدد دون تجميع عدة إضافات منفصلة. فهو يركز قواعد PvP الشائعة ويوفر أوامر للمسؤولين وتكاملات لتكييف السلوك مع إعدادات خوادم مختلفة.