MyEconomy

التوثيق · v1.2

التثبيت والبدء

المتطلبات

سيرفر Paper 1.21+ (أو مشتق). يُنصح بـ Vault للتكامل مع الإضافات الأخرى (متاجر، وظائف، إلخ). اختياري: PlaceholderAPI, DecentHolograms, MyCore.

التثبيت خطوة بخطوة

  1. حمّل MyEconomy.jar من صفحة التحميلات.
  2. ضع الملف في مجلد plugins/ للسيرفر.
  3. أعد تشغيل السيرفر (أو نفّذ /reload إن سمح المضيف).
  4. عند أول تشغيل يُنشأ plugins/MyEconomy/config.yml تلقائياً.

التحقق

في اللعبة اكتب /balance (أو /bal). إن كان الملحق محمّلاً ستظهر رصيدك. اللاعبون الجدد يحصلون على رصيد ابتدائي في الإعدادات.

أول خطوات

أوامر أساسية: /balance أو /bal لرؤية الرصيد، /pay <لاعب> <مبلغ> لإرسال نقود، /ecomenu لفتح القائمة. خصّص العملة والتصنيفات في config.yml.

مثال إعداد

مقطع من config.yml للعملة والرصيد الابتدائي:

currency:
  name: "coins"
  symbol: ""
  decimals: 2
starting-balance:
  amount: 100.0
  welcome-message: "&aYou received &e{amount} {currency} &a!"

الأوامر

أوامر اللاعب

أمرالوصفالاختصارات
/balance [لاعب]عرض الرصيدbal, money
/pay <لاعب> <مبلغ>إرسال نقودsend
/baltop [weekly|monthly]ترتيب الأغنىtopbalance, topbal
/ecomenuفتح قائمة الاقتصادmoneymenu, economy, market, prices
/transactions [لاعب] [صفحة]سجل المعاملاتhistory, tx

أوامر الأدمن

/eco <give|take|set|reset> <لاعب> [مبلغ] — منح، سحب، تعيين أو إعادة تعيين رصيد اللاعب.

الصلاحيات

  • myeconomy.player — أوامر اللاعب (balance, pay, baltop, menu, transactions)
  • myeconomy.balance.others — رؤية رصيد الآخرين
  • myeconomy.admin — أوامر /eco
  • myeconomy.admin.hologram — إدارة الهولوغرامات

الإعدادات (config.yml)

عام

general.language — اللغة (en, fr, es, de، إلخ). general.prefix — بادئة الرسائل. general.debug — رسائل التصحيح.

العملة

currency.name, currency.singular, currency.plural, currency.symbol, currency.decimals, currency.display-format (name أو symbol), currency.short-format (1.5K, 1.2M).

الرصيد الابتدائي

starting-balance.amount — المبلغ للاعبين الجدد. starting-balance.welcome-message — رسالة الترحيب (placeholders: {amount}, {currency}).

الدفع (/pay)

pay.enabled, pay.min-amount, pay.max-amount, pay.tax-percentage, pay.require-confirmation-above, pay.allow-self-pay, pay.quick-amounts.

التصنيفات

rankings.top-size. أسبوعي: rankings.weekly.enabled, reset-day, rewards.positions. شهري: rankings.monthly (نفس الهيكل).

الأمان

security.max-transactions-per-minute, transaction-cooldown, max-balance, min-balance, allow-negative-balance.

قاعدة البيانات

database.type — yaml, mysql أو sqlite. ثم database.mysql أو database.sqlite.

الهولوغرامات (DecentHolograms)

holograms.enabled, update-interval, format.title-global, format.line-format (placeholders: {rank}, {player}, {balance}, {currency}).

الميزات

اقتصاد كامل

عملة قابلة للتخصيص (اسم، رمز، عشرات)، رصيد ابتدائي، سجل معاملات.

التصنيفات

تصنيف عام وأسبوعي وشهري مع مكافآت تلقائية (أفضل 1، 2، 3). إعادة ضبط قابلة للإعداد (يوم الأسبوع أو الشهر).

قائمة GUI

/ecomenu — واجهة لعرض الرصيد، إرسال نقود (مبالغ سريعة)، عرض التصنيفات.

التكاملات

  • Vault — واجهة اقتصاد للإضافات الأخرى
  • PlaceholderAPI — Placeholders (رصيد، رتبة، إلخ)
  • DecentHolograms — هولوغرامات التصنيف
  • MyCore — أحداث وواجهة برمجية
  • دار مزادات (ضرائب، تتبع المعاملات)

الأمان

حد المعاملات في الدقيقة، فترة انتظار، حد أقصى للرصيد، تأكيد للمبالغ الكبيرة.