سكريبت مفاتيح المركبات FiveM: دليل Agency-Vehiclekeys 2026

المشكلة مع الوصول الافتراضي للمركبات في FiveM

خارج الصندوق، يسمح GTA V و FiveM لأي لاعب بدخول وقيادة أي مركبة بدون قيود. لا توجد مفاتيح، لا آليات ملكية، ولا عواقب للقفز إلى سيارة غريب والقيادة بعيدًا. بالنسبة للخوادم العادية هذا بالكاد يهم، لكن لأي مجتمع لعب أدوار جاد هذا السلوك الافتراضي يكسر الانغماس بشكل أساسي. تصبح كل سيارة تاكسي جماعي. يفقد سرقة المركبات كل معناها. ركن سيارتك قرب البنك أثناء قيامك بوظيفة يصبح مقامرة ضد لاعبين آخرين يستغلون الفرصة.

نص مفاتيح المركبات FiveM يحل هذه المشكلة على مستوى الإطار. يربط الملكية والمفاتيح الفيزيائية بكل مركبة يتم إنشاؤها أو شراؤها على الخادم، مما يتطلب من اللاعبين امتلاك المفتاح الصحيح في مخزونهم لفتح، تشغيل، وقيادة السيارة. المركبات بدون مفتاح تكون مقفلة، ويحاول اللاعب الدخول إليها يُرفض ببساطة. لقيادة سيارة لا تملكها، تحتاج إما إلى استعارة المفتاح، استخدام ميكانيكي التوصيل الساخن، أو فتح القفل. هذه الآليات الثلاث معًا تحول التفاعل مع المركبات من حدث غير مهم إلى طبقة ذات معنى من الاحتكاك في الدور.

في عام 2026، يعد Agency-Vehiclekeys الخيار المميز للخوادم التي تريد تنفيذ هذا النظام بشكل نظيف، مع تكامل عميق مع QBCore و ESX، ولعبة مصغرة مثيرة للسرقة، وسعر منخفض لمرة واحدة. يغطي هذا الدليل كل ما تحتاج لمعرفته.

ما يقدمه Agency-Vehiclekeys

Agency-Vehiclekeys is built around five core feature pillars that together make vehicle ownership feel real:

1. العناصر الرئيسية المادية

عندما يولد اللاعب أو يشتري مركبة، يتم وضع عنصر مفتاح فريد في مخزونه. هذا العنصر هو الطريقة الوحيدة لفتح وتشغيل تلك المركبة المحددة، مرتبط بمعرف الشبكة أو اللوحة الخاصة بالمركبة. يمكن تسليم المفتاح فعلياً إلى لاعب آخر، إسقاطه، تخزينه في مخزن، أو فقدانه. إذا فقدت مفتاحك، لا يمكنك تشغيل سيارتك بدون استخدام فك التوصيل الساخن أو الاتصال بصانع الأقفال (وظيفة ميكانيكي يمكنك تكوينها). هذا القرار التصميمي الوحيد، بتحويل المفاتيح إلى عناصر مخزون حقيقية، يخلق سلسلة من سيناريوهات لعب الأدوار الأصيلة التي لا يمكن لـ FiveM الافتراضي دعمها.

2. مشاركة المفتاح

يتيح نظام مشاركة المفاتيح لمالك المركبة إنشاء مفتاح مكرر وتسليمه لأي لاعب آخر. هذا ضروري للمركبات المشتركة الملكية، سيارات العائلة، ورش الميكانيكا التي تحتاج لتحريك المركبات، وفرق المجرمين التي تشارك سيارة هروب. تتم المشاركة من خلال تفاعل بسيط داخل اللعبة، استهدف اللاعب، اختر "Give Vehicle Key"، ويظهر المفتاح المكرر في مخزونهم. يحتفظ المالك بمفتاحه؛ يحصل المستلم على نسخة تعمل تمامًا مثل الأصلية. يمكن للمالكين أيضًا إلغاء جميع المفاتيح المشتركة في أي وقت، مما يمنع أي شخص كان لديه وصول سابق.

3. لعبة مصغرة للسرقة

عندما يحاول اللاعب دخول مركبة مغلقة لا يملك مفتاحها، يُعرض عليه خيار فك التوصيل الساخن. يتضمن Agency-Vehiclekeys لعبة مصغرة أنيقة لفك التوصيل الساخن في واجهة NUI، تحدي مطابقة الأسلاك بزمن محدد يتطلب مهارة اللاعب بدلاً من رمية نرد بسيطة. إكمال اللعبة المصغرة بنجاح يشغل السيارة لكنه يطلق أحداثاً على الخادم يمكن للسكريبتات الأخرى الربط بها: تنبيه مالك السيارة، إعلام مركز شرطة، تسجيل الحادث في MDT. يمكن تكوين صعوبة ووقت اللعبة المصغرة بالكامل، ويمكنك تعيين مستويات صعوبة مختلفة بناءً على فئة المركبة (السيارات الاقتصادية أسهل، السيارات الفائقة أصعب).

4. نظام Lockpick

يغطي نظام فتح الأقفال خطوة فتح الباب بشكل منفصل عن تشغيل الأسلاك. يمكن للاعب الذي يحمل عنصر مفتاح فتح في مخزونه محاولة فتح قفل باب مركبة. هذا شرط مسبق لدخول المركبة عند التشغيل السريع، تفتح الباب ثم تشغل الأسلاك لتشغيل المحرك. يحتوي فتح الأقفال على لعبة صغيرة خاصة به ومعدل نجاح قابل للتكوين وفرصة استهلاك العنصر. محاولات فتح القفل الفاشلة قد تكسر المفتاح (قابل للتكوين) وترسل إشعارًا اختياريًا للاعبين أو الشرطة القريبين. هذه العملية ذات الخطوتين، فتح القفل ثم تشغيل الأسلاك، تجعل سرقة المركبات محفوفة بالمخاطر وتستغرق وقتًا، تمامًا كما يجب أن تكون في لعب الأدوار الجاد.

5. تكامل عميق مع QBCore و ESX

Agency-Vehiclekeys integrates directly with QBCore inventory (ox_inventory compatible) and ESX inventory out of the box. Key items appear as proper inventory objects with icons and metadata. Vehicle ownership ties into QBCore's vehicle ownership database (player_vehicles) ونسخة ESX المكافئة. عندما يستعيد اللاعب سيارته من الوكالة أو الحجز، يتم إنشاء مفتاحه تلقائيًا ووضعه في مخزونه. جميع الإشعارات، تأكيدات القفل/الفتح، تنبيهات التوصيل الساخن، محاولات فتح القفل، استخدم نظام الإشعارات الأصلي لإطار عملك حتى تتطابق مع بقية واجهة خادمك.

ميزات إضافية

بعيداً عن الركائز الخمس الأساسية، يتضمن Agency-Vehiclekeys عدة آليات لتحسين جودة الحياة:

• رسوم متحركة القفل/الفتح: تؤدي الشخصية حركة واقعية للوصول عند قفل أو فتح مركبة، مع صوت نقرة مسموع.
• القفل القريب: قفل وفتح من مسافة قابلة للتكوين باستخدام مفتاح اختصار أو خيار قائمة دائرية، لا حاجة للوقوف بجانب الباب مباشرة.
• إنذار المركبة: اختياريًا، قم بتشغيل إنذار السيارة عند محاولة فتح القفل أو تشغيل الأسلاك الساخنة. يجذب الإنذار انتباه اللاعبين القريبين ويمكنه إخطار المالك عبر إشعار هاتفي (إذا تم تثبيت Agency Phone).
• المركبات المعفاة من الوظائف: حدد قائمة بمركبات الوظائف (سيارات الشرطة، سيارات الإسعاف، شاحنات السحب) المعفاة من نظام المفاتيح، حيث يمكن للضباط دخول مركبات الوظيفة بحرية دون الحاجة إلى عنصر مفتاح.
• تكامل الحجز: عندما تُحجز مركبة، يتم إبطال المفتاح المرتبط بها تلقائياً. عند استرجاع المركبة من الحجز، يتم إنشاء مفتاح جديد.
• تصدير API: واجهة برمجة تطبيقات تصدير نظيفة تسمح للنصوص الأخرى بالتحقق من ملكية المفاتيح، إنشاء المفاتيح برمجيًا، أو إلغاء المفاتيح، مفيدة لنصوص الميكانيكي، نصوص الوكالات، وتكاملات الوظائف المخصصة.

التثبيت: خطوة بخطوة

الخطوة 1: شراء Agency-Vehiclekeys

توجه إلى shop.agencyg.de/en/products/vehiclekeys وأكمل عملية الشراء لمرة واحدة لـ €7.99. بعد إتمام الشراء تحصل على وصول للتحميل عبر بوابة متجر Agency Scripts. لا اشتراك، لا تجديد، تملكها بشكل دائم.

الخطوة 2: وضع المورد

استخرج الأرشيف الذي تم تنزيله وضع agency-vehiclekeys المجلد داخل resources الدليل (أو مجلد فرعي مثل resources/[scripts]/).

الخطوة 3: الإضافة إلى server.cfg

افتح ال server.cfg وأضف سطر التأكد بعد موارد الإطار والمخزون الخاصة بك:

ensure agency-vehiclekeys

الخطوة 4: تكوين Config.lua

مفتوح agency-vehiclekeys/config/Config.lua وحدد إطار العمل ونظام الجرد وتفضيلات الميزات الخاصة بك. انظر المثال أدناه لتكوين تمثيلي.

الخطوة 5: إضافة عناصر المفاتيح إلى مخزونك

إذا كنت تستخدم QBCore أو ESX، أضف تعريف العنصر المفتاح إلى ملف العناصر المشتركة لديك. يتم توفير تعريف العنصر الدقيق في الوثائق على docs.agencyg.de/vehiclekeys. بالنسبة لمستخدمي ox_inventory، أضف العنصر إلى items.lua الخاص بك بدلاً من ذلك.

الخطوة 6: إعادة التشغيل والاختبار

أعد تشغيل خادمك. استدعِ مركبة، تحقق من مخزونك لعنصر المفتاح، اقفل المركبة، ابتعد، عد، وحاول الدخول إليها بدون المفتاح. ثم اختبر تسليم المفتاح إلى لاعب آخر، تفاعل فتح القفل، ولعبة تشغيل الأسلاك الساخنة.

مثال Config.lua

فيما يلي تكوين تمثيلي يعرض أهم الخيارات في Agency-Vehiclekeys:

-- Agency-Vehiclekeys: Config.lua

Config = {}

-- Framework: "qbcore" or "esx"
Config.Framework = "qbcore"

-- Inventory system: "qb-inventory", "ox_inventory", or "esx"
Config.Inventory = "ox_inventory"

-- Item name for vehicle keys in your inventory
Config.KeyItem = "vehicle_key"

-- Item name for lockpicks
Config.LockpickItem = "lockpick"

-- Distance (metres) from which player can lock/unlock their vehicle
Config.LockDistance = 8.0

-- Enable vehicle alarm on hotwire/lockpick attempt
Config.EnableAlarm = true
Config.AlarmDuration = 30  -- seconds

-- Hotwire mini-game settings
Config.Hotwire = {
    enabled    = true,
    timeLimit  = 20,         -- seconds to complete mini-game
    difficulty = "medium",   -- "easy", "medium", "hard"
    -- Per-class overrides (GTA vehicle class numbers)
    classOverrides = {
        [6]  = "easy",   -- off-road: easier
        [7]  = "hard",   -- supercars: harder
        [14] = "hard",   -- military: very difficult
    },
}

-- Lockpick settings
Config.Lockpick = {
    enabled          = true,
    breakChance      = 0.25, -- 25% chance lockpick breaks on failure
    alertPolice      = true, -- send notification to online police on attempt
    alertRadius      = 30.0, -- metres within which police are notified
}

-- Job-exempt vehicles (these jobs can enter any vehicle without a key)
Config.ExemptJobs = { "police", "ambulance", "mechanic", "tow" }

-- Notification system: "qb", "esx", "okok", "ox"
Config.NotifySystem = "qb"

-- Enable export API for other scripts to interact with the key system
Config.EnableExports = true

توافق الإطار والمخزون

Agency-Vehiclekeys supports the following combinations out of the box:

• QBCore + qb-inventory: تكامل كامل، تظهر المفاتيح في واجهة مخزون QBCore، تزامن ملكية المركبة مع player_vehicles
• QBCore + ox_inventory: تكامل كامل، المفاتيح معروضة كعناصر ox مع بيانات وصفية، متوافقة مع جميع ميزات ox_inventory
• ESX + مخزون ESX: تكامل كامل، المفاتيح في نظام مخزون ESX، الملكية متزامنة مع جدول مركبات ESX

إذا كنت تستخدم نظام جرد مختلف، فإن واجهة برمجة التطبيقات للتصدير وقاعدة الكود المفتوحة بلغة Lua تجعل من السهل إضافة جسر مخصص. الوثائق تتضمن قالب جسر.

التوثيق

الوثائق الكاملة، كل خيارات التكوين، تعريفات عناصر الجرد، مرجع API للتصدير، إعدادات استثناء الوظائف، والأسئلة الشائعة متوفرة على docs.agencyg.de/vehiclekeys. يتم تحديث الوثائق مع كل إصدار وتشمل تعريفات العناصر للنسخ القابلة للنسخ واللصق لـ QBCore وESX وox_inventory.

التسعير: 5.99€ دفعة واحدة

Agency-Vehiclekeys costs €7.99 كدفعة واحدة لمرة واحدة من خلال متجر Agency Scripts. لا يوجد اشتراك، لا تجديد، لا رسوم لكل خادم. ادفع مرة واحدة وامتلكه للأبد، جميع التحديثات المستقبلية للإصدار الرئيسي الحالي مشمولة بدون تكلفة إضافية. بأقل من ستة يورو، هذا أحد أكثر سكربتات FiveM المميزة فعالية من حيث التكلفة في السوق. نظام مفاتيح المركبات المماثل من مطور آخر بنموذج اشتراك سيكلف ذلك في شهر واحد فقط؛ Agency-Vehiclekeys يمنحك نفس الجودة أو أفضل بسعر لمرة واحدة ينفقه معظم مالكي الخوادم على القهوة في أسبوع.

من يجب أن يستخدم Agency-Vehiclekeys؟

Agency-Vehiclekeys is the right choice for:

• خوادم RP الجادة الذين يريدون أن يكون لامتلاك المركبة وزن حقيقي، لا مزيد من القفز إلى أي سيارة تراها
• مجتمعات RP الإجرامية الذين يريدون ميكانيكيات فتح السيارات وسرقتها الحقيقية التي تجعل سرقة المركبات نشاطًا مهاريًا ومحفوفًا بالمخاطر
• الخوادم التي لديها معارض سيارات، التكامل السلس يعني أن توليد المفاتيح يتم تلقائيًا عند نقطة البيع.
• خوادم RP الشرطة ، تنبيهات الإنذار وإشعارات الشرطة عند محاولات فتح الأقفال/تشغيل الأسلاك تخلق سيناريوهات استجابة حقيقية
• خوادم QBCore و ESX البحث عن حل مفاتيح جاهز، مُدار جيدًا ويحترم اتفاقيات الأطر الحالية

الملخص

مفاتيح المركبات هي آلية أساسية لأي سيرفر يأخذ اللعب التمثيلي على محمل الجد. يقدم Agency-Vehiclekeys الحزمة الكاملة، عناصر مفاتيح مادية، مشاركة المفاتيح، لعبة مصغرة تعتمد على المهارة لفتح الأسلاك، نظام قفل من مرحلتين، إنذارات المركبات، وتكامل عميق مع الأُطُر، مقابل تكلفة لمرة واحدة تبلغ 7.99 يورو. هو، موضوعيًا، من أعلى المشتريات قيمة التي يمكنك القيام بها لسيرفرك على FiveM. زر المتجر، احصل عليه، وحول طريقة عمل المركبات على سيرفرك اليوم.