QBESXStandalone
Agency-Blackmarket V2 التصديرات وواجهة البرمجة
سوق سوداء حيّة لـ FiveM على QBCore أو Qbox أو ESX أو بشكل مستقل تمامًا (standalone).
v2.0.0مدفوع6 صفحات
01تصديرات العميل
| التصدير | الوصف |
|---|---|
OpenMenu() | يفتح قائمة /ablackmarket، مثلًا من قائمة دائرية أو من تطبيق هاتف. تنطبق عليها الفحوصات نفسها التي تنطبق على الأمر. |
CloseMenu() | يغلق القائمة ويعيد التحكم بالماوس إلى اللعبة. |
IsMenuOpen() | يُرجع true ما دامت قائمة السوق السوداء مفتوحة، عند تاجر أو في أي مكان. |
02تصديرات الخادم
| التصدير | الوصف |
|---|---|
GetReputation(source) | نقاط سمعة اللاعب، و0 للاعب الذي لا يملك أيًّا منها بعد. |
SetReputation(source, value) | يضبط سمعة اللاعب على قيمة ثابتة، ولا تنزل أبدًا عن 0. يُرجع true عند النجاح. |
AddReputation(source, amount) | يضيف سمعة، أو ينقصها بقيمة سالبة. يُعلَن المستوى الجديد للاعب ولتطبيق Companion. يُرجع true عند النجاح. |
GetLevel(source) | يُرجع قيمتين: رقم مستوى اللاعب (من 1 إلى 5 افتراضيًا) واسمه. |
AddCredit(source, amount) | يضيف رصيد تاجر يستطيع اللاعب إنفاقه في عملية الشراء أو الطلب التالية. يُرجع true عند النجاح. |
RelocateDealer(dealerId) | ينقل التاجر فورًا إلى موقع آخر من مواقعه. يُرجع true إذا انتقل. |
SendDealerAway(dealerId, minutes) | يختفي التاجر لعدد الدقائق المحدد ثم يظهر في موقع آخر من مواقعه، كما يحدث بعد زيارة الشرطة. |
IsDealerPresent(dealerId) | true ما دام التاجر واقفًا في أحد مواقعه ولم يغادر. |
StartFlashSale(minutes) | يبدأ تخفيضات خاطفة على عناصر عشوائية. من دون تحديد الدقائق تُستخدم المدة من Config.FlashSale. |
03الأحداث
| الاسم | الجهة | الوصف |
|---|---|---|
agency-blackmarket:deal | الخادم | يُطلق على الخادم مع (source, kind, data) بعد كل صفقة. قيمة kind هي buy أو sell أو launder أو order أو pickup أو job، وتحتوي data على تفاصيل الصفقة، مثل التاجر والعناصر والمجموع. |
agency-blackmarket:dealerMoved | الخادم | يُطلق على الخادم مع (dealerId, pos, reason) عندما يغيّر التاجر موقعه. قيمة reason هي rotate أو return أو admin أو export. |
agency-blackmarket:flashSale | الخادم | يُطلق على الخادم مع (items, minutes) عند بدء التخفيضات الخاطفة. يربط items كل عنصر مخفّض بنسبة خصمه المئوية. |
+من المفيد معرفته
يقدّم Agency-Blackmarket V2 تصديرات وأحداثًا لكي تمنح سكربتاتك الخاصة السمعة والرصيد، وتتحكم في التجار، وتتفاعل مع الصفقات.
- السمعة والرصيد
- تقرأ GetReputation وSetReputation وAddReputation وGetLevel مكانة اللاعب وتغيّرها، ويدفع AddCredit رصيد تاجر. وتأخذ معرّف الخادم للاعب متصل.
- التجار والتخفيضات الخاطفة
- تتحكم RelocateDealer وSendDealerAway وIsDealerPresent في التجار عبر المعرّف من Config.Dealers، ويبدأ StartFlashSale التخفيضات من حدث خاص بك.
- الأحداث
- يُطلق agency-blackmarket:deal بعد كل صفقة، وagency-blackmarket:dealerMoved بعد كل انتقال، وagency-blackmarket:flashSale عند بدء التخفيضات. الثلاثة تُطلق على الخادم فقط، ويمكن استخدامها للسجلات أو أدوات الشرطة أو مهامك الخاصة.
?الأسئلة المتكررة
كيف أفتح القائمة من قائمتي الدائرية؟
استدعِ exports['Agency-Blackmarket']:OpenMenu() على العميل. تنطبق الفحوصات نفسها التي تنطبق على الأمر، بما في ذلك العنصر من Config.Menu.item.