QBESXStandalone

Agency-Vehiclekeys V2 التثبيت

مفاتيح مركبات شاملة لـ FiveM على QBCore أو Qbox أو ESX أو بنظام مستقل تمامًا.

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

اشترِ من المتجر العودة إلى القائمة

01التثبيت

1ضع Agency-Vehiclekeys في مجلد resources
2أضف ensure Agency-Vehiclekeys إلى server.cfg، بعد إطار العمل وoxmysql ونظام المخزون
3أوقف سكربتات المفاتيح الأخرى مثل qb-vehiclekeys. يتعرف السكربت على أحداث المفاتيح الخاصة بها، لذا تستمر الكراجات والمتاجر في العمل
4أدوات فتح الأقفال: تتوفر لدى معظم خوادم QBCore أداتا lockpick وadvancedlockpick مسبقًا، وإلا فراجع install/items_qbcore.lua أو install/items_ox_inventory.lua أو install/items_esx.sql
5اختياري: أضف add_ace group.admin agency.vehiclekeys.admin allow لإتاحة علامتَي Admin وSettings في /keys
6التحديث من V1: استبدل المجلد القديم واستخدم config.lua الجديد. تُنقل المفاتيح التي وُزعت في V1 (simple_carkeys_shared) عند التشغيل الأول

02المتطلبات

لا حاجة إلى أي تبعية
QBCore أو QBox أو ESX (اختياري، يعمل بدونها في الوضع المستقل)
oxmysql (اختياري، بدونه تُحفظ المفاتيح في مخزن القيم والمفاتيح الخاص بالخادم)
نظام مخزون لأدوات فتح الأقفال (اختياري: ox_inventory وqs-inventory وqb-inventory وتفرعاته أو ESX)
نظام إرسال بلاغات (اختياري: ps-dispatch أو cd_dispatch أو qs-dispatch أو rcore_dispatch أو core_dispatch أو tk_dispatch أو lb-tablet)
Agency-Notify (اختياري، لعرض الرسائل بالمظهر الكلاسيكي لـ V1)

03ملف SQL

اختياري: ينشئ المورد هذه الجداول بنفسه عند بدء التشغيل. استورد هذا الملف فقط إذا كنت تُعدّ قاعدة البيانات يدويًا:

-- Agency Vehiclekeys V2
-- Optional: the script creates this table by itself on the first start when
-- oxmysql runs. Run it by hand only if your database user may not create tables.

CREATE TABLE IF NOT EXISTS `agency_vehiclekeys` (
    `plate`      VARCHAR(16)  NOT NULL,
    `identifier` VARCHAR(96)  NOT NULL,
    `kind`       VARCHAR(12)  NOT NULL DEFAULT 'shared',
    `holder`     VARCHAR(64)  NULL DEFAULT NULL,
    `granted_by` VARCHAR(96)  NULL DEFAULT NULL,
    `model`      VARCHAR(32)  NULL DEFAULT NULL,
    `created`    INT UNSIGNED NOT NULL DEFAULT 0,
    PRIMARY KEY (`plate`, `identifier`),
    KEY `identifier` (`identifier`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

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

يعمل Agency-Vehiclekeys V2 مباشرة بعد سطر ensure. هناك خمس نقاط يجدر التحقق منها قبل التشغيل الأول: سكربتات المفاتيح الأخرى، وعناصر فتح الأقفال، وقاعدة البيانات، والمسؤولون ومفاتيح الوظائف، والترقية من V1.

السكربتات الرئيسية الأخرى: أوقف qb-vehiclekeys وqbx_vehiclekeys والسكربتات المشابهة، لأن تشغيل سكربتين للمفاتيح على السيارات نفسها سيؤدي إلى تعارضهما. يتعرّف السكربت على أحداث المفاتيح، لذا تستمر الكراجات والمتاجر في العمل. إذا كان أحد السكربتات يستدعي exports['qb-vehiclekeys']:HasKeys(plate) على العميل، فلا يلزم سوى تغيير الاسم إلى Agency-Vehiclekeys.
أغراض فتح الأقفال: تحدّد Config.Lockpick.items أسماء الأغراض، وهي افتراضيًا advancedlockpick وlockpick. لدى معظم خوادم QBCore كلا الغرضين. تحتوي الملفات install/items_qbcore.lua وinstall/items_ox_inventory.lua وinstall/items_esx.sql على الإدخالات اللازمة لأنظمة الجرد الأخرى. يؤدي استخدام الغرض من الجرد إلى بدء محاولة، ويؤدي الضغط على H إلى الأمر نفسه.
قاعدة البيانات: مع oxmysql، تُحفظ المفاتيح في جدول agency_vehiclekeys، الذي ينشئه السكربت تلقائيًا. أما عند عدم استخدام oxmysql، فتُحفظ في مخزن المفاتيح والقيم الخاص بالخادم. لا تحتاج إلى install/agency_vehiclekeys.sql إلا إذا لم يكن مسموحًا لمستخدم قاعدة البيانات بإنشاء الجداول.
مفاتيح المشرفين والوظائف: المشرفون هم اللاعبون الذين لديهم ACE agency.vehiclekeys.admin أو المجموعة group.admin أو group.superadmin، أو إحدى المجموعات المحددة في Config.AdminGroups. في الخوادم المستقلة، تُحدّد مفاتيح الوظائف عبر أذونات ACE، مثل add_ace group.police agency.vehiclekeys.police allow.
التحديث من V1: استبدل المجلد القديم بالجديد واستخدم config.lua الجديد، لأن إعدادات V1 غير متوافقة. تُنقل المفاتيح من simple_carkeys_shared عند التشغيل الأول. يظل G يقفل السيارة، ونُقل تشغيل المحرك من M إلى U، كما يظل الأمران /givekey و/removekey يعملان.

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

ما أنظمة الجرد المدعومة لأغراض فتح الأقفال؟

ox_inventory وqs-inventory وqb-inventory وتفرعاته، ونظام جرد ESX، ويُكتشف النظام تلقائيًا باستخدام Config.Inventory = 'auto'. يمكن للخوادم المستقلة التي لا تستخدم نظام جرد ربط نظامها الخاص باستخدام Config.Standalone.itemCount وremoveItem، أو السماح للاعبين بفتح الأقفال من دون غرض.

يستخدم الكراج لدي جدولًا خاصًا للمركبات المملوكة. ماذا أفعل؟

اضبط Config.OwnedVehicles على الجدول وأعمدته الخاصة بالمالك ولوحة السيارة. افتراضيًا، تُستخدم player_vehicles مع citizenid (QBCore وQbox)، وowned_vehicles مع owner (ESX).