إضافة Minecraft VotingPlugin

🔌 حول VotingPlugin

VotingPlugin هو إضافة Minecraft تعمل كأداة متقدمة لمتابعة التصويت وإدارة المكافآت. يستقبل إشعارات التصويت من خدمات التصويت الخارجية (عبر Votifier أو مستمعين مشابهين) ويطبّق مكافآت وإعلانات وتتبعًا قابلًا للتخصيص بدرجة عالية على الخادم.

🎯 الهدف

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

⚙️ الميزات

• مكافآت تصويت قابلة للتخصيص لكل موقع تصويت، ومكافآت تراكمية لكل لاعب (صوّت X مرات للحصول على مكافأة).
• خيارات للإعلان والبث عند وصول أصوات جديدة.
• تتبع أفضل المصوتين ومكافآت اختيارية لهم.
• توافق مع PlaceholderAPI (يوفر placeholders للعرض داخل اللعبة).
• دعم محرر خارجي لتبسيط الإعدادات المعقدة.
• تطوير نشط مع الحفاظ على المصدر والإصدارات في مستودع عام.

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

• أصحاب الخوادم والمديرون الذين يستخدمون التصويت في قوائم الخوادم لجذب الزيارات ويريدون مكافآت تلقائية.
• خوادم SMP و Survival التي تستخدم التصويت للمكافآت وزيادة تفاعل اللاعبين.
• الشبكات التي تقبل الأصوات عبر مستمعين من نوع Votifier وتحتاج إلى نظام مكافآت مركزي.

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

• منح اللاعبين عنصرًا أو مكافأة عملة في كل مرة يصوتون فيها على موقع.
• منح مكافأة خاصة بعد وصول اللاعب إلى عدد محدد من الأصوات.
• الحفاظ على لوحة صدارة شهرية ومنح جوائز لأفضل المصوتين.

📥 التثبيت

📥 الإعداد

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

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

• Votifier (أو أي مستمع إشعارات تصويت آخر) مطلوب لتسليم التصويتات الخارجية.
• يتم دعم PlaceholderAPI للـ placeholders إذا كنت تحتاج إلى التكامل مع لوحات الصدارة أو الدردشة أو الواجهات الرسومية.

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

• المنصة المؤكدة: Spigot.
• تشمل إصدارات Minecraft الرئيسية التي تم اختبارها الإدخالات التي يعرضها المشروع (مثل: 1.17، 1.18، 1.19، 1.20، 1.21)؛ كما يسرد المشروع أيضًا إصدارًا رئيسيًا native أقدم.
• الشفرة المصدرية ومتتبع المشكلات متاحان للعامة في مستودع المشروع.

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

إذا كنت بحاجة إلى نظام قابل للتخصيص لتحويل أصوات قوائم الخوادم الخارجية إلى مكافآت وإعلانات ولوحات صدارة داخل اللعبة، فإن VotingPlugin يقدم حلاً غنيًا بالميزات ومُدارًا بنشاط للخوادم المتوافقة مع Spigot.