QBESXStandalone
Agency-Repairkit V2 التصديرات وواجهة البرمجة
ضرر واقعي للمركبات وأربعة أطقم إصلاح لـ FiveM، على QBCore أو QBox أو ESX أو بشكل مستقل بالكامل.
v2.0.0مدفوع5 صفحات
01تصديرات العميل
| التصدير | الوصف |
|---|---|
IsRepairing() | يُرجع true طالما أن اللاعب المحلي يعمل على مركبة، على سبيل المثال لإبقاء القائمة الخاصة بك مغلقة. |
GetVehicleCondition(vehicle) | نسبة المحرك والهيكل والخزان المئوية، حالة الإطارات، مستوى الاتساخ، مستوى الضرر، وما إذا كان الخزان يسرّب. بدون وسيط، تُقرأ المركبة التي يجلس فيها اللاعب. |
OpenMenu() | يفتح قائمة /arepairkit، على سبيل المثال من تطبيق هاتف أو قائمة دائرية. |
CloseMenu() | يغلق القائمة ويعيد التحكم بالماوس إلى اللعبة. |
IsMenuOpen() | يرجع true طالما القائمة مفتوحة. |
02تصديرات الخادم
| التصدير | الوصف |
|---|---|
UseKit(source, kit) | يبدأ طقما لأحد اللاعبين كما لو تم استخدام العنصر، مع كل عمليات التحقق. يُرجع true، أو false مع السبب. يُستخدَم لأنظمة الجرد والمتاجر المخصصة. |
GiveKit(source, kit, amount) | يضيف أطقما إلى جرد أحد اللاعبين عبر نظام الجرد المكتشَف. يُرجع true عند النجاح. |
IsRepairing(source) | القيمة true طالما كان ذلك اللاعب يعمل على مركبة. |
GetKits() | كل طقم مُعد مع عنصره وتسميته ونوع عمله ومدته. |
useKit(event, item, inventory, slot, data) | تصدير عنصر ox_inventory. تشير إدخالات العناصر في install/ox_inventory.lua إليه؛ وهو غير مخصص للاستدعاء المباشر. |
03الأحداث
| الاسم | الجهة | الوصف |
|---|---|---|
agency-repairkit:repaired | الخادم | يُطلَق على السيرفر مع (source, netId, kit) بعد انتهاء الإصلاح واستهلاك الطقم بالكامل. مفيد للسجلات أو المدفوعات أو تقدم الوظيفة. |
agency-repairkit:client:repaired | العميل | يُطلَق على جهاز اللاعب القائم بالإصلاح مع (netId, kit) عند اكتمال الإصلاح. |
agency-repairkit:client:damageLevel | العميل | يُطلَق على جهاز السائق مع (level, vehicle) عند تغيّر مستوى الضرر: ok أو light أو medium أو heavy أو critical. |
+من المفيد معرفته
يمكن للموارد الأخرى بدء الأطقم، ومنحها، والاستعلام عمّا إذا كان اللاعب يعمل، وقراءة حالة المركبة. تُبلغ ثلاثة أحداث عن الإصلاحات المكتملة وتغيّرات مستوى الضرر.
- بدء الأطقم من كودك الخاص
- يشغّل UseKit(source, kit) نفس الفحوصات التي يخضع لها عنصر المخزون: المسافة، والوظيفة، وفترة الانتظار، والعنصر نفسه. وهذه هي الطريقة لربط مخزون مخصص أو NPC تابع لمتجر.
- الاستجابة للإصلاحات
- يُطلَق الحدث agency-repairkit:repaired على الخادم بعد استهلاك الطقم، ويحمل معه اللاعب ومعرّف شبكة المركبة والطقم، وذلك مثلاً لدفع أجرة ميكانيكي أو لتسجيل العملية.
?الأسئلة المتكررة
هل يمكن لواجهة HUD الخاصة بي عرض مستوى الضرر؟
نعم. استمع إلى agency-repairkit:client:damageLevel على جانب العميل، أو استدعِ GetVehicleCondition للحصول على حالة المحرك والهيكل والخزان والإطارات والمستوى في أي وقت.