إضافة Minecraft PlayerPoints

🔌 حول PlayerPoints

PlayerPoints هو إضافة Minecraft توفّر نظام عملة قائمًا على النقاط للخوادم. يوفّر API لكي تتمكن الإضافات الأخرى من التكامل مباشرةً، ويقدّم روابط تكامل اختيارية مع الإضافات الشائعة، كما يتضمن دعم التخزين المعتمد على SQL.

🎯 الهدف

تم تصميم PlayerPoints ليقدّم للخوادم اقتصادًا ثانويًا خفيفًا (النقاط) يمكن منحه أو إنفاقه أو الاستعلام عنه بواسطة إضافات أخرى. وهو يحل الحاجة إلى نظام نقاط/عملة بسيط وقابل للبرمجة النصية دون الحاجة إلى إضافة اقتصاد مالي كاملة.

⚙️ المميزات

• نظام عملة قائم على النقاط لحسابات اللاعبين.
• API عامة لتقرأ الإضافات الأخرى النقاط وتعدّلها.
• دعم SQL للتخزين الدائم (يذكر المستودع دعم SQL).
• روابط تكامل اختيارية مع Vault وPlaceholderAPI.
• ينشئ مجلد بيانات خاصًا به عند التشغيل الأول ويخزن ملفات الإعدادات/البيانات هناك.

🧩 لمن هذا المنتج

• خوادم Survival وSMP التي تريد عملة نقاط ثانوية.
• الخوادم التي تحتاج API بسيطة لمطوري الإضافات لمنح نقاط اللاعبين أو التحقق منها.
• الخوادم التي تفضّل التكامل الاختياري مع Vault/PlaceholderAPI.

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

• منح النقاط كمكافآت للـ minigames أو المهام.
• استخدام النقاط كعملة لشراء العناصر التجميلية أو صلاحيات الخادم عبر إضافة أخرى.
• قراءة النقاط لإنشاء أنظمة الرتب، ولوحات الصدارة، أو تتبع التقدم.

⚙️ التثبيت

📥 الإعداد

• حمّل ملف jar الخاص بالإضافة من المورد الرسمي وضع ملف jar داخل مجلد plugins/ الخاص بخادمك.
• شغّل الخادم. عند أول تشغيل، سيقوم PlayerPoints بإنشاء مجلد plugins/PlayerPoints الذي يحتوي على ملفات الإعدادات والبيانات.
• تأكد من تحميل الإضافة عبر التحقق من رسائل PlayerPoints في وحدة تحكم الخادم.

📦 المتطلبات

• لا توجد متطلبات مطلوبة.
• اختياري: Vault (رابط تكامل اختياري) وPlaceholderAPI (رابط تكامل اختياري).

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

• تذكر المصادر الرسمية التوافق مع Spigot وتفرعاته؛ ويُنصح باستخدام Paper. لا يتم دعم CraftBukkit.
• يذكر المشروع دعم إصدارات Minecraft 1.8.8 وما بعدها.
• الإضافة مفتوحة المصدر بموجب ترخيص GPL-3.0 وتوفّر API للتكامل بواسطة إضافات أخرى.

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

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