سكريبت المصعد في FiveM: دليل إعداد Agency-Elevator 2026

ما هو سكريبت FiveM Elevator؟

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

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

لخوادم لعب الأدوار الجادة، المجمعات السكنية، مباني المستشفيات، مقرات الشرطة، مكاتب ناطحات السحاب، مواقف السيارات، سكريبت مصعد جيد ليس رفاهية. إنه الفرق بين مبنى يشعر بالحياة وآخر يبدو كدعم مجوف. في 2026، أصبح Agency-Elevator من Agency Scripts الحل المجتمعي المجاني المفضل، ويغطي هذا الدليل كل ما تحتاج لمعرفته لتشغيله على خادمك.

لماذا تحتاج إلى Agency-Elevator

هناك عدد قليل من سكربتات المصاعد المنتشرة في منتديات مجتمع FiveM وGitHub، لكن معظمها يعاني من مشكلة أو أكثر خطيرة: كود قديم يتعطل على إصدارات FiveM الحديثة، عدم صيانة نشطة، إحداثيات طوابق مشفرة، عدم وجود لوحة NUI، أو تعامل سيء مع الرسوم المتحركة يؤدي إلى اختراق اللاعبين للهندسة.

Agency-Elevator was built to solve all of those problems cleanly. It is actively maintained by the Agency Scripts team, fully documented, and, crucially, completely free. You can grab it directly from the Tebex store at no cost, no strings attached. Here is why it stands out:

• دعم متعدد الطوابق: حدد عدد الطوابق التي يحتويها مبناك. لا يوجد حد صارم مدمج في السكربت.
• رسوم متحركة سلسة: يستخدم السكريبت تحركات GTA V الأصلية وعمليات نقل موقع محسوبة بعناية حتى لا يرى اللاعبون قفزات موقع مزعجة.
• لوحة اختيار الطابق في NUI: تراكب متصفح نظيف وخفيف الوزن يعرض الطابق الحالي ويسمح للاعبين بالنقر أو الضغط لاختيار وجهتهم.
• المؤثرات الصوتية: تتضمن أصوات رنين المصعد، فتح/إغلاق الباب، وحركة البيئة بشكل افتراضي.
• قابل للتكوين بالكامل: كل مبنى، كل عمود مصعد، كل إحداثية طابق، كل تسمية طابق، كلها معرفة في ملف واحد Config.lua الملف مع تعليقات موثقة جيدًا.
• غير مرتبط بإطار محدد: يعمل مع QBCore و ESX والإعدادات المستقلة تمامًا. لا يعتمد على إطار عمل بشكل افتراضي.
• تكلفة صفرية: مجاني، لا دفع، لا ضمان، لا اشتراك Tebex مطلوب بخلاف حساب مجاني.

تحليل عميق للميزات

مباني متعددة الطوابق

يتم تعريف كل مصعد في Agency-Elevator كإدخال جدول في التكوين. تحدد منطقة الزناد (حيث يقف اللاعب لاستدعاء المصعد)، ثم تسرد كل طابق باسمه، وإحداثيات الوجهة (x, y, z, heading)، وخيارًا لتقييد الوصول. يمكنك تعريف مصاعد لأي عدد من المباني في مورد واحد، مثل المستشفى، مقر الشرطة، مجمع الشقق، برج الكازينو، وكلها تُدار من مكان واحد.

لوحة NUI

عندما يدخل اللاعب منطقة تفعيل المصعد، يظهر لوحة NUI عائمة تتلاشى تدريجياً. تسرد جميع الطوابق المتاحة مع تسمياتها (مثل "الطابق الأرضي"، "الطابق الثاني، الشقق"، "سطح المبنى"). ينقر اللاعبون على وجهتهم أو يتنقلون باستخدام لوحة المفاتيح. تم تصميم اللوحة لتتناسب مع لغة تصميم Agency Scripts لكنها قابلة للتخصيص بالكامل عبر ملفات NUI HTML/CSS إذا أردت مطابقة علامة خادمك التجارية.

الحركات والصوت

Agency-Elevator plays a door-close animation and sound when a floor is selected, then smoothly teleports the player to the destination floor after a configurable delay. On arrival, the door-open sound plays and the panel disappears. All animation and sound timings are configurable in Config.lua حتى تتمكن من ضبط الإحساس ليتناسب مع سرعة مصعد المبنى الخاص بك.

قيود الوصول

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

مناطق تفعيل قابلة للتكوين

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

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

الخطوة 1: تحميل Agency-Elevator

توجه إلى قائمة Tebex على agency-script.tebex.io/package/7285036 وأضف Agency-Elevator إلى سلة التسوق الخاصة بك. إنه مجاني، فقط أكمل عملية الدفع بطلب إجمالي صفر. ستتلقى رابط تنزيل عبر نظام تسليم Tebex (مرتبط بحساب CFX الخاص بك أو مقدم كتنزيل مباشر).

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

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

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

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

ensure agency-elevator

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

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

الخطوة 5: بدء الخادم

أعد تشغيل خادمك (أو استخدم refresh + start agency-elevator في وحدة تحكم الخادم). اقترب من أي منطقة تفعيل مصعد داخل اللعبة ويجب أن تظهر لوحة NUI. تحقق من وحدة تحكم الخادم لأي رسائل خطأ إذا لم تظهر اللوحة، معظم المشاكل هي عدم تطابق الإحداثيات في التكوين.

مثال Config.lua

فيما يلي مثال تمثيلي لتكوين Agency-Elevator. قم بتعديل الإحداثيات لتتناسب مع خريطة خادمك وداخل المباني:

-- Agency-Elevator: Config.lua

Config = {}

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

-- Show floor markers on the minimap
Config.ShowBlips = false

-- Default floor label shown when no floor is selected
Config.DefaultFloorLabel = "Select Floor"

-- Elevator transition delay in milliseconds (door close → teleport)
Config.TransitionDelay = 1500

-- Enable NUI debug mode (shows borders on the panel)
Config.Debug = false

-- Define your elevators
Config.Elevators = {
    {
        name = "Mission Row PD - Elevator",
        -- Zone where players stand to call the elevator
        trigger = { x = 441.6, y = -982.3, z = 30.7, radius = 1.5 },
        floors = {
            { label = "Ground Floor",    coords = { x = 441.6, y = -982.3, z = 30.7,  h = 90.0 } },
            { label = "2nd Floor",       coords = { x = 441.6, y = -982.3, z = 34.7,  h = 90.0 } },
            { label = "3rd Floor",       coords = { x = 441.6, y = -982.3, z = 38.7,  h = 90.0 } },
            {
                label = "Roof Access",
                coords = { x = 441.6, y = -982.3, z = 50.7, h = 90.0 },
                -- Restrict to police jobs only
                jobRestrict = { "police", "sheriff" },
            },
        },
    },
    {
        name = "Alta Apartments - Elevator",
        trigger = { x = -268.4, y = -955.8, z = 31.2, radius = 1.5 },
        floors = {
            { label = "Lobby",       coords = { x = -268.4, y = -955.8, z = 31.2, h = 0.0  } },
            { label = "Floor 2",     coords = { x = -268.4, y = -955.8, z = 35.2, h = 0.0  } },
            { label = "Floor 3",     coords = { x = -268.4, y = -955.8, z = 39.2, h = 0.0  } },
            {
                label = "Penthouse",
                coords = { x = -268.4, y = -955.8, z = 48.0, h = 0.0 },
                -- Restrict to players who own this item
                itemRestrict = "penthouse_key",
            },
        },
    },
}

توافق الإطار

الإعداد Config.Framework = "standalone" يجعل Agency-Elevator يعمل بدون أي اعتماد على QBCore أو ESX. اختيار الطابق ولوحة NUI تعملان بشكل مثالي في الوضع المستقل؛ الميزات الوحيدة التي تتطلب إطار عمل هي فحوصات الوظائف والقيود على العناصر في الطوابق الفردية. إذا قمت بتعيين Config.Framework = "qbcore" أو "esx"، السكربت يحمل الجسر المقابل لفحص وظائف اللاعبين وعناصر الجرد عند اختيار طابق مقيد.

التوثيق والدعم

توثيق كامل، يشمل جميع خيارات التكوين، نصائح الإحداثيات، تخصيص NUI، والأسئلة المتكررة متوفر في docs.agencyg.de/elevator. إذا واجهت مشاكل، فإن سيرفر Discord الخاص بـ Agency Scripts هو أسرع طريقة للحصول على دعم من المطور والمجتمع.

التسعير: مجاني تمامًا

Agency-Elevator carries a price tag of مجاني. لا توجد خدعة، لا قفل ضمان، لا اشتراك، لا مستوى بريميوم يفتح ميزات مخفية. النص الكامل مع جميع الميزات الموضحة في هذا المقال متاح مجانًا. هذه هي طريقة Agency Scripts في رد الجميل لمجتمع FiveM مع عرض جودة مجموعة Agency Scripts. تحصل على نفس جودة البناء والصيانة النشطة مثل السكربتات المدفوعة، دون أي تكلفة على الإطلاق.

للسياق: العديد من موارد المصاعد المماثلة في منتديات CFX إما غير مُصانة، مفتوحة المصدر، أو تفرض عدة يورو مقابل وظائف يوفرها Agency-Elevator مجانًا. إذا كنت تؤجل إضافة المصاعد إلى خادمك بسبب التكلفة أو مخاوف الجودة، فلا يوجد الآن سبب للانتظار.

من يجب أن يثبت Agency-Elevator؟

Agency-Elevator is the right choice for any FiveM server that has:

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

البدء الآن

التنزيل على بعد نقرة واحدة. زر قائمة Tebex، أكمل الدفع المجاني، اسقط المورد في خادمك، أضف ensure agency-elevator إلى server.cfg، قم بتكوين طوابقك، وانتهيت. عادة ما يستغرق الإعداد الكامل أقل من 15 دقيقة لمبنى واحد. الوثائق التفصيلية على docs.agencyg.de/elevator يرشدك خلال كل خيار إذا كنت بحاجة إلى إرشاد.