إضافة Minecraft AxRewards

🔌 حول AxRewards

AxRewards هو إضافة Minecraft توفر نظام مكافآت خفيفًا وقابلًا للتخصيص. يحدد مديرو الخادم المكافآت مع فترات تهدئة (cooldowns) عشوائية، ويعرضونها في واجهات GUI قابلة للتعديل، وينفذون أوامر الاستلام عندما يطالب اللاعبون بالمكافآت. يتم الحفاظ على المشروع بواسطة Artillex-Studios ويتضمن تخزينًا معتمدًا على قاعدة بيانات ودعمًا لعدة خوادم.

🎯 الغرض

يحُل AxRewards الحاجة الشائعة إلى مكافآت لاعبين مجدولة أو قابلة للتكرار (مثل مكافآت تسجيل الدخول اليومية أو الأسبوعية) مع توفير فترات تهدئة مرنة، وقفلًا عبر الصلاحيات، وعرضًا عبر GUI. وهو مخصص للخوادم التي تريد نظام مكافآت متكاملًا وقابلًا للتخصيص دون الحاجة إلى أنظمة تخزين مؤقت خارجية.

⚙️ المميزات

• مكافآت قابلة للتخصيص مع فترات تهدئة عشوائية (محددة بالثواني).
• قوائم GUI قابلة للتعديل لعرض المكافآت؛ يمكن لعناصر GUI إظهار حالات مختلفة (قابلة للاستلام / غير قابلة للاستلام / بلا صلاحية).
• تخزين قاعدة بيانات مع دعم H2 وSQLite وMySQL وPostgreSQL.
• دعم عدة خوادم دون الحاجة إلى Redis.
• GUI يتم تحديثه تلقائيًا (يُعاد تحديثه دوريًا دون الحاجة إلى إعادة فتحه).
• إمكانية قفل المكافآت خلف الصلاحيات (يمكن أن تتطلب كل مكافأة صلاحية).
• إجراءات الاستلام تُنفذ كقائمة من أوامر الخادم (تدعم placeholder %player%).
• تكامل PlaceholderAPI ودعم عدة صيغ للألوان.

🧩 لمن هو مخصص

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

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

• تقديم مكافأة تسجيل دخول يومية تمنح عناصر أو تنفذ أوامر عند استلامها.
• توفير مكافآت VIP أسبوعية مقيدة تتطلب صلاحية رتبة للاستلام.
• تشغيل مكافآت قائمة على الأوامر تمنح المال أو العناصر أو تنفذ أوامر خادم مخصصة باستخدام %player%.

⌨️ الأوامر

(فقط الأوامر المؤكدة في التوثيق الرسمي مُدرجة.)

⚙️ التثبيت

📥 الإعداد

• حمّل ملف JAR الخاص بالإضافة وضعه في مجلد plugins/ الخاص بخادمك إذا كان الخادم متوافقًا مع Bukkit/Spigot/Paper.
• شغّل الخادم أو أعد تشغيله حتى تتمكن الإضافة من إنشاء مجلدات البيانات وملفات الإعداد.
• يتم وضع ملفات الإعداد والقوائم داخل مجلد الإضافة (مثلًا plugins/AxRewards/menus).

📦 الاعتمادات

• PlaceholderAPI (تكامل اختياري للـ placeholders) — دعم مؤكد.

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

• نُظم قواعد البيانات المؤكدة: H2 وSQLite وMySQL وPostgreSQL.
• تدعم الإضافة PlaceholderAPI وصيغ الألوان الشائعة (بما في ذلك MiniMessage وصيغ legacy).
• يتم تحديث الـ GUI تلقائيًا (auto-updating) دون حاجة اللاعبين إلى إعادة فتحه.
• تحدد المكافآت فترة التهدئة بالثواني؛ ضبط فترة التهدئة إلى -1 يجعل المكافأة لا تُحدَّث أبدًا.
• المشروع مفتوح المصدر ومرخص تحت MIT.
• تشمل برمجيات الخادم والمواضيع المدعومة المؤكدة: Bukkit وSpigot وPaper وFolia.
• المتطلب المؤكد: بيئة Java حديثة (توضح ملاحظات المشروع أن Java 21 أو أعلى للإصدارات الحديثة).

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

إذا كنت تحتاج إلى نظام مكافآت قابل للتخصيص، ومدعوم بواجهة GUI، مع تخزين دائم ودعم عبر عدة خوادم، فإن AxRewards يوفر قوائم قابلة للتعديل، ومعالجة فترات التهدئة، وإجراءات استلام قائمة على الأوامر مع التكامل مع PlaceholderAPI وقواعد البيانات الشائعة.