كيف تصنع plugin اقتصاد لـ Minecraft

خطوة بخطوة

1. 1.حدّد طبيعة الـ plugin

   إمّا أن يكون هو الاقتصاد (يخزّن الأرصدة ويسجّل نفسه كاقتصاد Vault)، وإمّا أن يستخدم اقتصاداً موجوداً عبر Vault (متجر، مكافآت على الرؤوس، plugin وظائف). تحتاج معظم الخوادم إلى واحد من كل نوع، لا إلى اقتصادين.

2. 2.اختر الخادم والإصدار

   اكتب برنامج الخادم وإصداره، مثل Paper 1.21.4. يُبنى الـ plugin وفق API هذا الإصدار ومستوى Java الخاص به.

3. 3.اكتب قائمة الأوامر والقواعد

   /balance و/pay <player> <amount> و/baltop، وأوامر إدارية مثل /eco give|take|set. أضف الرصيد الابتدائي واسم العملة والخانات العشرية والحد الأدنى للدفع.

4. 4.اختر مكان حفظ الأرصدة

   SQLite لخادم واحد، وMySQL إذا كان على عدة خوادم مشاركة الأرصدة نفسها. يجب أن تصمد الأموال أمام إعادة التشغيل والأعطال، لذا لا تُحفظ في الذاكرة وحدها أبداً.

5. 5.دع Codexe يكتبه ويبنيه

   صف الـ plugin واذكر Vault صراحةً ليُضاف كاعتمادية. يكتب Codexe كود Java وplugin.yml وconfig.yml، ويجمّعه ويصلح أخطاء البناء قبل أن يصبح المشروع Ready.

6. 6.اختبر المدفوعات داخل اللعبة

   اضغط «جرّبه الآن» وانضم إلى الخادم التجريبي. ادفع بين حسابين، وجرّب مبالغ كبيرة جداً أو سالبة أو ليست أرقاماً، ثم أعد التشغيل وتأكد أن الأرصدة ما زالت موجودة.

7. 7.ثبّته

   ضع Vault وملف .jar الخاص بك في مجلد plugins/ على الخادم وأعد تشغيله. احذف أي plugin اقتصاد آخر، أو حدّد أيّها يجب أن يستخدمه Vault.

أين يقع Vault في الصورة

Vault جسر وليس اقتصاداً. يطبّق plugin الاقتصاد واجهة Economy الخاصة بـ Vault ويسجّلها في مدير الخدمات على الخادم؛ وتطلبها الـ plugins الأخرى عبر getServer().getServicesManager().getRegistration(Economy.class) وتستدعي دوالّ مثل getBalance وwithdrawPlayer وdepositPlayer.

لذلك لا يحتاج plugin المتجر أبداً إلى معرفة الاقتصاد الذي تشغّله. في plugin.yml استخدم depend: [Vault] إذا كان الـ plugin لا يعمل بدونه، أو softdepend إذا كان Vault اختيارياً. لا تلزم Vault API إلا للتجميع؛ أما Vault نفسه فيُثبَّت على الخادم.

قرارات تكتبها في الطلب

• تنسيق المال: اسم العملة بالمفرد والجمع، والرمز، وعدد الخانات العشرية.
• الحدود: الرصيد الابتدائي، والحد الأقصى للرصيد، وهل يمكن أن تصبح الأرصدة سالبة.
• اللاعبون غير المتصلين: هل يعمل /pay و/eco على لاعبين غير متصلين.
• السجل: سجل للمعاملات في قاعدة البيانات أو في ملف، ليتمكن الطاقم من مراجعة النزاعات.
• كسب المال: قتل الوحوش، أو مكافآت وقت اللعب، أو بيع العناصر، أو الأوامر الإدارية فقط.

أين تحفظ الأرصدة

مثال على وصف

"plugin اقتصاد لـ Paper 1.21.4 باسم Coins يسجّل نفسه كاقتصاد Vault. الأوامر /balance [player]، و/pay <player> <amount> بحد أدنى 1، و/baltop لأفضل 10، و/eco give|take|set للاعبين الذين لديهم coins.admin. يبدأ اللاعبون الجدد بـ 100 coin. خانتان عشريتان. تُسجَّل كل دفعة مع التاريخ والمرسل والمستلم والمبلغ. تُحفظ الأرصدة في SQLite. أسماء العملة وكل الرسائل في config.yml."

يستخدم Codexe قاعدة SQLite افتراضياً ما لم تطلب غيرها. وإذا طلبت MySQL، يُكتب الـ plugin مع إعداد storage-type، ويمنحه الخادم التجريبي قاعدة بيانات MySQL خاصة به أثناء التجربة.

أسئلة