إضافة Minecraft EconomyAPI
معلومات عن EconomyAPI والخوادم التي تم العثور عليها فيها
🔌 حول EconomyAPI
EconomyAPI هو مكوّن أساسي للاقتصاد وتطبيق API طوّره في الأصل onebone. يتم نشره وتوزيعه لأنظمة خوادم Bedrock/PocketMine-style (متغيرات PocketMine/Nukkit)، وهو مخصص لتوفير backend عملة مشتركة وطرائق برمجية يمكن للبلاجنات الأخرى استدعاؤها.
🎯 الهدف
يوفّر EconomyAPI نظام عملة مركزيًا بحيث يمكن لمطوّري الإضافات قراءة أرصدة اللاعبين وتعديلها، وتسجيل الأحداث المرتبطة بالاقتصاد، والسماح لمديري الخادم بإتاحة أوامر اقتصادية أساسية للاعبين. وهو يحل مشكلة حاجة عدة إضافات إلى تطبيقات اقتصاد منفصلة عبر تقديم طبقة API موحّدة.
⚙️ الميزات
- يوفّر طرائق API برمجية للاستعلام عن الرصيد وتحديثه (تشمل الأمثلة في الوثائق مُدخلًا بأسلوب getInstance).
- يوفّر أوامر اقتصاد موجهة للاعبين مثل balance وpay وتعديلات المال للإدارة.
- يطلق أحداثًا وhooks يمكن للبلاجنات الأخرى الاستماع إليها لمعالجة المعاملات.
- يُستخدم على نطاق واسع كاعتمادية/مكوّن أساسي لإضافات وامتدادات الاقتصاد الأخرى الخاصة بـ PocketMine/Nukkit.
🧩 لمن هو مخصص
- مطورو الخوادم والإضافات الذين يحتاجون إلى backend اقتصاد مشترك على برمجيات خوادم Bedrock بنمط PocketMine/Nukkit.
- مسؤولو خوادم Bedrock الصغيرة إلى المتوسطة التي تعتمد على أنظمة إضافات تتكامل مع EconomyAPI.
🏗️ أمثلة استخدام
- إضافة متجر أو سوق تقرأ أرصدة اللاعبين وتخصمها عبر استدعاءات EconomyAPI.
- إضافة مزاد أو مكافآت تمنح عملة عبر استدعاء طرائق add/reduce الخاصة بالـ API.
- شبكات خوادم تُضمّن إضافات addon تتوقع مزود اقتصاد موحدًا.
⌨️ الأوامر
| Command | Description | Permission | Access |
|---|---|---|---|
/mymoney | اعرض رصيدك الحالي. | economyapi.command.mymoney | لاعب |
/seemoney | اعرض رصيد لاعب آخر. | economyapi.command.seemoney | إداري |
/pay | ادفع للاعب آخر. | غير محدد | لاعب |
/givemoney | امنح المال للاعب. | economyapi.command.givemoney | إداري |
/takemoney | اسحب المال من لاعب. | economyapi.command.takemoney | إداري |
/setmoney | عيّن رصيد اللاعب. | economyapi.command.setmoney | إداري |
/topmoney | اعرض لوحة صدارة الأرصدة الأعلى. | economyapi.command.topmoney | لاعب |
(تم أخذ الأوامر وعُقد الصلاحيات أعلاه من قوائم الموارد المنشورة لـ PocketMine/Nukkit؛ وقد يختلف التوفر الفعلي بحسب build/fork.)
🔐 الصلاحيات
| Permission | Description | Default |
|---|---|---|
economyapi | عقدة الصلاحية الأساسية لميزات EconomyAPI. | غير محدد |
economyapi.command | العقدة الأساسية لأوامر الاقتصاد. | غير محدد |
economyapi.command.mymoney | يسمح باستخدام /mymoney. | غير محدد |
economyapi.command.seemoney | يسمح بعرض أرصدة اللاعبين الآخرين. | غير محدد |
economyapi.command.givemoney | يسمح بإعطاء المال (بمستوى المشرف في كثير من التوزيعات). | op |
economyapi.command.takemoney | يسمح بأخذ المال (بمستوى المشرف في كثير من التوزيعات). | op |
economyapi.command.setmoney | يسمح بتعيين رصيد اللاعب (بمستوى المشرف في كثير من التوزيعات). | op |
economyapi.command.topmoney | يسمح بعرض لوحة صدارة الأرصدة. | غير محدد |
⚙️ التثبيت
📥 الإعداد
- حمّل النسخة الرسمية من الإضافة المناسبة لتوزيعة خادمك (PocketMine/Poggit أو build مجتمعي لـ Nukkit).
- ضع ملف الإضافة الذي تم تنزيله في مجلد
plugins/الخاص بالخادم. - أوقف الخادم ثم شغّله من جديد (إعادة تشغيل) وتحقق من مخرجات الكونسول للتأكد من تحميل الإضافة.
(قد يختلف تنسيق الحزمة الدقيق حسب التوزيعة وbuild؛ اتبع خطوات التثبيت الخاصة بالتوزيعة المختارة.)
🧠 ملاحظات تقنية
- يتم توزيع EconomyAPI في عدة builds/forks ضمن بيئتي PocketMine وNukkit؛ وقد تتضمن الإصدارات المختلفة أوامر أو نقاط دخول API مختلفة قليلًا.
- يوفّر البلاجن أنماط وصول برمجية تستخدمها إضافات أخرى (تُظهر الأمثلة في الوثائق المجتمعية استدعاءات مثل
EconomyAPI::getInstance()أوEconomyAPI.getInstance().addMoney(...)). - في بعض الأوقات تم تصنيف البلاجن في قنوات التوزيع بسبب مشكلات الأداء أو الصيانة؛ لذا يُنصح بأخذ حالة الصيانة الحالية والبدائل المتوافقة في الاعتبار عند نشره على الخوادم الإنتاجية.
🤝 متى تكون هذه الإضافة مفيدة
إذا كان خادمك أو نظام الـ add-on الخاص بك يتوقع مزود اقتصاد مشتركًا لخوادم Bedrock/PocketMine/Nukkit-style، فإن EconomyAPI يقدم API واسع الاستخدام ومجموعة من أوامر اللاعبين الأساسية التي تتكامل معها العديد من الإضافات الأخرى.
PocketMine-MP Server٣52.28- PocketMine-MP Server١51.56
- Minecraft: PE Server٣47.8
- Minecraft: PE Server٢46.33
- Minecraft: PE Server٣45.63
- DaggerMC - Lifesteal Beta٠42.15
- Moan Moan SMP٠40.15
- \u00a76Billion MC٠36.75
- Minecraft: PE Server٠11.03
تعرض صفحة إضافة EconomyAPI الخوادم التي وجد نظام المراقبة هذه الإضافة عليها، والمنصات والإصدارات التي تظهر معها.
قد تضيف الإضافات أوامر، اقتصادا، حماية، صلاحيات، ألعابا مصغرة، تكاملات أو آليات أخرى. يعتمد الدور الفعلي لـ EconomyAPI على إعداد كل خادم.
تُنشأ البيانات تلقائيا من الردود التقنية للخوادم. إذا كان الخادم يخفي قائمة الإضافات، فقد لا يظهر في هذا القسم حتى إذا كان يستخدم EconomyAPI.
استخدم قائمة الخوادم التي تحتوي على EconomyAPI لمقارنة المشاريع، التحقق من الإصدارات المتوافقة أو العثور على أمثلة لاستخدام الإضافة في الخوادم العامة.