Agency-Hud: فلسفة التصميم لواجهة HUD في FiveM التي يريدها كل خادم فعليًا

The HUD Problem

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

تسلسل المعلومات

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

إمكانية الوصول مدمجة

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

الأداء تحت ظهور المركبات

أكبر فخ لأداء HUD هو إعادة الرسم أثناء ظهور مركبات أو NPC بكثافة. يستخدم Agency-Hud هدف عرض واحد مع تحديثات دلتا، نعيد رسم الأجزاء التي تغيرت فقط، وليس التراكب بأكمله. على خادم 64 لاعبًا خلال حدث سرقة، كلفنا HUD عُشر ما كلفته البدائل المماثلة في اختباراتنا.

التخصيص بدون فوضى

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

التثبيت & الإعداد

Agency-Hud has no database dependency. Download from Tebex, drop the folder into your resources directory, and add ensure agency-hud إلى server.cfg. يكتشف المورد إطار العمل الخاص بك تلقائيًا ويسحب قيم الصحة، الدرع، الجوع، والعطش من المصادر المناسبة. للإعدادات المستقلة، الخطافات هي أربع دوال في config.

إذا كنت تستبدل HUD موجودًا، قم بتعطيل القديم أولاً. معظم تعارضات HUD تحدث بسبب رسم موردين لمنطقة شاشة واحدة في نفس الوقت. Agency-Hud لا يحتوي على مناطق شاشة مبرمجة صلبة، كل المواقع قابلة للتكوين، لذا يمكنه التعايش مع تراكبات طرف ثالث محددة إذا لزم الأمر.

خيارات التكوين

ال config.lua يغطي التخطيط، المرئي، وإعدادات الأداء:

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

توافق الإطار

Agency-Hud ships with QBCore and ESX data adapters. For standalone, implement config functions for health, armor, hunger, thirst, voice range, and job data. The rendering layer, animation system, tier logic, and accessibility modes are entirely framework-agnostic. Switching frameworks only requires swapping the data adapter, not reinstalling the resource.

لماذا هذا مهم للعب التمثيلي

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

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

إمكانية الوصول ليست فكرة لاحقة في Agency-Hud، بل هي اهتمام من الدرجة الأولى لأن جزءًا كبيرًا من مجتمع اللاعبين يعاني من نوع ما من اختلاف في رؤية الألوان. HUD غير قابل للقراءة للاعبين المصابين بعمى الألوان ليس مجرد فشل في تجربة المستخدم؛ إنه فشل في إمكانية الوصول يؤثر على أشخاص حقيقيين على خادمك. تقديم الإعدادات المسبقة لا يكلف شيئًا وله أهمية كبيرة للاعبين الذين يحتاجونها.

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

هل يمكن للاعبين تخصيص تخطيط HUD الخاص بهم؟

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

هل يستبدل Agency-Hud خريطة FiveM المصغرة الافتراضية؟

نعم. يعرض خريطته المصغرة الخاصة على عنصر canvas مع تكبير قابل للتكوين وعرض نقاط الطريق. يتم إخفاء الخريطة المصغرة الأصلية عند بدء المورد. إذا كنت بحاجة للحفاظ على سلوكيات معينة للخريطة المصغرة الأصلية (بعض أدوات مكافحة الغش تتصل بها)، هناك Config.UseNativeMinimap = true خيار يعيد تمكين الخريطة الأصلية تحت عناصر Agency-Hud الأخرى.

كيف يكون الأداء على الخوادم المزدحمة؟

Agency-Hud uses delta rendering, it only redraws HUD elements whose values have changed since the last frame. On a crowded 128-player server, the typical HUD draw call takes 0.01-0.03ms per frame. The benchmark comparison in our documentation shows this is 3-5x lower than most alternative HUDs under identical conditions.

هل يمكنني إضافة عناصر HUD مخصصة لآليات خاصة بالخادم؟

نعم. استخدم exports['agency-hud']:RegisterElement(id, options) لإضافة مؤشرات مخصصة. مرر دالة رسم تستدعيها Agency-Hud خلال حلقة الرسم الخاصة بها. تشارك عناصر واجهتك المخصصة في نظام المستويات وتحترم نظام ألوان الخادم تلقائيًا.

المتطلبات

• خادم FiveM (QBCore، ESX، أو مستقل)
• حساب cfx.re مع ترخيص Agency-Hud صالح
• لا اعتماد على قاعدة بيانات
• اختياري: ox_lib (لمكونات واجهة المستخدم، يحتوي على بديل)