Agency-Blackmarket التصديرات وواجهة البرمجة
نظام سوق سوداء متكامل بدعم إطارَي عمل (QBCore/ESX)، ويضم نظام سمعة من 5 مستويات، وأحداث تخفيضات خاطفة متغيّرة، وآليات.
01الأحداث
| الاسم | الجهة | الوصف |
|---|---|---|
blackmarket:client:openMenu | Client | Opens the black market dealer main menu for the player. |
blackmarket:client:closeMenu | Client | Closes any open black market menus for the player. |
blackmarket:client:openLaunderingMenu | Client | Opens the money laundering submenu. |
blackmarket:client:showNotification | Client | Displays a styled black market notification (title, message, type, duration). |
blackmarket:server:checkAccess | Server | Checks whether the calling player can access the black market and replies with reputation data. |
blackmarket:server:completeBuy | Server | Finalises a purchase after the client minigame succeeds. |
blackmarket:server:sellItem | Server | Triggers the sell flow with optional minigame and cooldown handling. |
blackmarket:server:completeSell | Server | Finalises a sale after the client minigame succeeds. |
blackmarket:server:launderMoney | Server | Launders dirty_money/markedbills into clean cash with fees and possible extortion. |
+من المفيد معرفته
تدرج هذه الصفحة جميع الأحداث المتاحة في Agency-Blackmarket التي يمكن للموارد الأخرى تشغيلها للتكامل مع ميزاته. يتم توفير أحداث على جانب العميل وجانب الخادم، مما يسمح للمطورين بالتفاعل مع القوائم، ومعالجة عمليات الشراء والبيع، أو تشغيل تدفقات الغسيل. استخدم هذه الأحداث لتوسيع تفاعلات السوق السوداء أو لأتمتة العمليات من سكريبتاتك الخاصة حسب الحاجة.
- أحداث التفاعل على جانب العميل
- تتيح لك أحداث العميل مثل blackmarket:client:openMenu و blackmarket:client:closeMenu و blackmarket:client:openLaunderingMenu فتح أو إغلاق القوائم الرئيسية أو قوائم الغسيل للاعب برمجياً. يمكنك أيضاً عرض إشعارات منسقة باستخدام blackmarket:client:showNotification لتقديم ردود مخصصة.
- معالجة المعاملات على جانب الخادم
- تشمل أحداث الخادم blackmarket:server:checkAccess لفحوصات السمعة، و blackmarket:server:completeBuy و blackmarket:server:completeSell لإنهاء المعاملات بعد الألعاب المصغرة، و blackmarket:server:sellItem لبدء تدفق البيع. استخدم هذه للتحكم في الوصول ومعالجة عمليات الشراء أو البيع بأمان.
- تكامل غسيل الأموال
- يسمح حدث blackmarket:server:launderMoney للسكريبتات الأخرى ببدء عملية الغسيل لـ dirty_money أو markedbills. يتعامل هذا الحدث مع التحويل، ويطبق الرسوم المكونة، ويمكن أن يشغل منطق الابتزاز إذا تم إعداده. قم بالتكامل معه لأتمتة أو تخصيص سيناريوهات الغسيل.
?الأسئلة المتكررة
هل أحتاج إلى إضافة أي تبعيات قبل استخدام هذه الأحداث؟
يتطلب Agency-Blackmarket إما QBCore أو ESX، ويتم اكتشافهما تلقائياً. التبعيات الاختيارية مثل Agency-Notify و Agency-Progressbar و qb-target يمكن أن تحسن التجربة لكنها ليست إلزامية لاستخدام الأحداث المدرجة في هذه الصفحة.
هل هناك أي exports متاحة، أم فقط أحداث؟
حالياً، يوفر Agency-Blackmarket التكامل من خلال أحداث العميل والخادم فقط. لا توجد exports معرفة في هذا الإصدار، لذا يجب على الموارد الأخرى استخدام الأحداث المدرجة للتفاعل مع نظام السوق السوداء.
ماذا يجب أن أتحقق منه إذا لم يتم تشغيل حدث كما هو متوقع؟
تأكد من أن Agency-Blackmarket تم تشغيله بشكل صحيح باستخدام ensure Agency-Blackmarket في server.cfg الخاص بك وأن سكريبتاتك تقوم بتشغيل الأحداث بالمعلمات الصحيحة. كما تحقق من أن خادمك يعمل على إطار عمل مدعوم وأن جميع التبعيات المطلوبة مثبتة.
هل يمكنني تقييد الوصول إلى أحداث أو ميزات معينة؟
يتم إدارة التحكم في الوصول بواسطة منطق السكريبت الداخلي، مثل فحوصات السمعة عبر blackmarket:server:checkAccess. لتقييد الميزات بشكل أكبر، نفذ فحوصات إضافية في سكريبتاتك الخاصة قبل تشغيل هذه الأحداث.