Agency Docs
QBESXStandalone

Agency-Minerjob V2 التصديرات وواجهة البرمجة

وظيفة تعدين لـ FiveM على QBCore أو Qbox أو ESX أو كنظام مستقل بالكامل، في ثلاثة مواقع: محجر Davis Quartz، ومنجم قديم في.

v2.0.0مدفوع5 صفحات

01تصديرات العميل

التصديرالوصف
OpenMenu(page)يفتح القائمة، مثلاً من قائمة شعاعية أو تطبيق هاتف. الصفحة هي overview (الافتراضية)، market، tools، smelter، cutting أو contracts.
CloseMenu()يغلق القائمة ويعيد التحكم بالماوس إلى اللعبة.
IsMenuOpen()تكون قيمته True أثناء فتح القائمة.
IsWorking()تكون قيمته True أثناء تنقيب اللاعب أو قطعه جوهرة.
GetLevel()مستوى التنقيب لدى اللاعب.

02تصديرات الخادم

التصديرالوصف
GetLevel(source)مستوى التنقيب لدى لاعب، ويكون 0 إذا كان اللاعب غير معروف.
GetProgress(source)المستوى والتقدم بالتنسيق { level, xp, need, pct, max }.
AddXp(source, amount)يضيف XP، بما في ذلك الارتقاء بالمستوى ورسالة الإشعار. يعيد true عند العثور على اللاعب.
SetLevel(source, level)يضبط المستوى بين 1 وأعلى مستوى، ويبدأه عند 0 XP.
GetStats(source)ما أنجزه اللاعب حتى الآن: { mined, smelted, cut, broken, sold, earned, contracts }.
GetPrice(item)سعر السوق الحالي للعنصر الواحد.

03الأحداث

الاسمالجهةالوصف
agency-minerjob:minedالخادميُطلق على الخادم بعد إتمام عملية تنقيب مدفوعة، مع source وitem وcount ومنطقة التنقيب. استخدم AddEventHandler للاستماع إليه، مثلاً للمهام أو الإحصائيات.
agency-minerjob:soldالخادميُطلق على الخادم بعد عملية بيع، مع source وitem وcount وإجمالي المبلغ المدفوع.
agency-minerjob:contractالخادميُطلق على الخادم عند تسليم عقد، مع source وitem وcount والأجر.

+من المفيد معرفته

يتيح Agency-Minerjob V2 استخدام exports وأحداث الخادم، لتتمكن المهام والإنجازات والهواتف وأدوات الإدارة من قراءة المستويات والأسعار، ومنح XP، والاستجابة للتعدين والمبيعات والعقود.

المستويات وXP
تقرأ GetLevel وGetProgress مستوى اللاعب على الخادم وتغيّرانه، كما تقرأ AddXp وSetLevel المستوى وتغيّرانه. تعرض AddXp رسالة الارتقاء بالمستوى كما يحدث عند التعدين.
الإحصائيات والأسعار
تعرض GetStats ما استخرجه اللاعب وصهره وقطّعه وكسّره وباعه وكسبه وسلّمه. تقرأ GetPrice سعر السوق الحالي لأي عنصر.
أحداث الخادم
يتم إطلاق agency-minerjob:mined وagency-minerjob:sold وagency-minerjob:contract على الخادم بعد دفع المكافأة. استمع إليها باستخدام AddEventHandler؛ فهي للإبلاغ فقط، إذ تم دفع المكافأة بالفعل.

?الأسئلة المتكررة

كيف أفتح القائمة من القائمة الدائرية؟

استدعِ exports['Agency-Minerjob']:OpenMenu() على جهة العميل، أو مرّر صفحة مثل 'market' أو 'contracts' لفتح تلك الصفحة مباشرة.

ما زلت عالقًا بعد هذه الصفحة؟ فريق الدعم يتولّى الأمر من هنا.