QBESXStandalone
Agency-Shops التصديرات وواجهة البرمجة
كل متجر 24/7 وLTD وRob's Liquor ومتجر أجهزة وAmmu-Nation ومحطة وقود على الخريطة في سكربت واحد لـ FiveM.
v1.0.0مدفوع5 صفحاتاعتبارًا من October 19, 2026, 20:00 CEST
01تصديرات العميل
| التصدير | الوصف |
|---|---|
GetFuel(vehicle) | مستوى وقود المركبة من 0 إلى 100، بنفس الطريقة التي يعيدها LegacyFuel. |
SetFuel(vehicle, level) | يحدد مستوى وقود المركبة، من 0 إلى 100. |
02تصديرات الخادم
| التصدير | الوصف |
|---|---|
GetOwner(id) | معرف المالك واسم مالك المتجر أو محطة الوقود، أو nil عندما لا يملكه أحد. |
AddStock(id, item, amount) | يضيف قطعاً إلى مخزون متجر مملوك، حتى Config.Ownership.MaxStock. يعيد true عند النجاح. |
AddFuelStock(id, litres) | يضيف لترات إلى خزان محطة وقود مملوكة، حتى Config.GasStations.MaxFuel. يعيد true عند النجاح. |
GetBalance(id) | الأموال الموجودة في سجل متجر أو محطة وقود مملوكة، أو nil. |
03الأحداث
| الاسم | الجهة | الوصف |
|---|---|---|
agency-shop:server:purchased | الخادم | ينطلق مع (source, storeId, items, total, account) بعد إتمام عملية الشراء. يسرد items ما تم تسليمه وtotal هو المبلغ المدفوع، حتى لا يضطر سكربت الإحصائيات أو المهام إلى إجراء استعلام دوري. |
agency-shop:server:shoplift | الخادم | ينطلق مع (source, storeId, value, coords) عندما يخرج لاعب من متجر ومعه بضائع غير مدفوعة في السلة أو عربة التسوق. مع Config.Dispatch.System = 'event' يكون هذا هو التنبيه الوحيد، لتتمكن سكربتات البلاغات الخاصة بك من التقاطه. |
+من المفيد معرفته
يوفر Agency-Shops بعض دوال exports وحدثين للخادم server events، حتى تتمكن سكربتات الوقود والإمداد والإرسال والإحصائيات الخاصة بك من العمل مع المتاجر.
- مستوى الوقود
- يعمل GetFuel و SetFuel في العميل مثل استدعاءات LegacyFuel، بمستوى من 0 إلى 100. السكربتات المصممة لـ LegacyFuel تحتاج فقط إلى تغيير اسم المورد.
- الملاك والمخزون
- يقرأ GetOwner و GetBalance المتجر أو محطة الوقود المملوكة عبر id الخاص بها. يضيف AddStock و AddFuelStock قطعًا أو لترات، على سبيل المثال من سكربت الإمداد أو الوظائف الخاص بك.
- الأحداث
- يتم إطلاق agency-shop:server:purchased بعد كل عملية شراء مع اللاعب والمتجر والعناصر والمجموع والحساب. ويتم إطلاق agency-shop:server:shoplift عندما يخرج لاعب ومعه بضائع غير مدفوعة.
?الأسئلة المتكررة
كيف يمكنني معرفة مالك المتجر؟
في جانب الخادم استدعِ exports['Agency-Shops']:GetOwner(id). يعيد المعرف واسم المالك، أو nil عندما يكون المتجر غير مملوك.
كيف أرسل تنبيه شرطة خاصًا بي عند سرقة المتجر؟
عيّن Config.Dispatch.System = 'event' واستمع إلى agency-shop:server:shoplift. يمنحك ذلك اللاعب و id الخاص بالمتجر وقيمة البضائع والإحداثيات.