ब्लॉग पर वापस
Scripts6 मिनट पढ़ें

Agency-Hud: ऐसा FiveM HUD बनाने का डिज़ाइन नज़रिया, जैसा हर सर्वर चाहता है

Agency-Hud खिलाड़ियों को ज़रूरी जानकारी देता है, बिना स्क्रीन पर अनावश्यक शोर बढ़ाए। जानें, हमने इसे किस तरह बनाया।

Agency Scripts

Agency Scripts के संस्थापक और प्रमुख डेवलपर

HUD समस्या

डिफ़ॉल्ट FiveM HUD एक आपदा है। खिलाड़ियों के पास आधा दर्जन विरोधाभासी ओवरले होते हैं जो स्क्रीन स्पेस के लिए लड़ते हैं, कोई सुसंगत दृश्य भाषा नहीं होती, और महत्वपूर्ण जानकारी सजावटी तत्वों के नीचे दब जाती है। हर सर्वर जिसमें हम शामिल हुए, उसमें यही समस्या थी: बहुत अधिक HUD, पर्याप्त स्पष्टता नहीं। Agency-Hud इसे ठीक करने के लिए मौजूद है।

सूचना पदानुक्रम

हमने HUD तत्वों को तीन स्तरों में विभाजित किया। पहला स्तर हमेशा दिखाई देता है: स्वास्थ्य, कवच, भूख, प्यास। दूसरा स्तर संदर्भानुसार दिखता है: ड्राइविंग के दौरान वाहन स्पीडोमीटर, बोलते समय वॉइस रेंज संकेतक। तीसरा स्तर मांग पर होता है: मिनीमैप टॉगल, नौकरी की स्थिति, इन्वेंटरी। प्रत्येक स्तर का अपना दृश्य भार होता है और साफ़-सुथरे तरीके से इन और आउट एनिमेट होता है। जब तक जरूरी न हो, कोई भी ध्यान आकर्षित करने के लिए प्रतिस्पर्धा नहीं करता।

सुलभता अंतर्निहित

हाई-कंट्रास्ट मोड, कॉन्फ़िगर करने योग्य आकार, और रंग-अंधता सुरक्षित स्थिति संकेत बॉक्स से ही उपलब्ध हैं। यह 2026 में वैकल्पिक नहीं है, आपके खिलाड़ी विभिन्न दृष्टि आवश्यकताओं वाले लोग होंगे और एक पेशेवर HUD उन्हें समायोजित करता है। सर्वर मालिक अपनी समुदाय के लिए इन डिफ़ॉल्ट सेटिंग्स को टॉगल कर सकते हैं।

वाहन स्पॉन के तहत प्रदर्शन

सबसे बड़ा HUD प्रदर्शन जाल भारी वाहन या NPC स्पॉन के दौरान पुनः ड्राइंग है। Agency-Hud एकल रेंडर टारगेट का उपयोग करता है जिसमें डेल्टा अपडेट होते हैं, हम केवल उन हिस्सों को पुनः ड्रॉ करते हैं जो बदले हैं, पूरे ओवरले को नहीं। 64-प्लेयर सर्वर पर एक हीस्ट इवेंट के दौरान, HUD ने हमारे बेंचमार्क में तुलनीय विकल्पों की तुलना में दसवां हिस्सा लागत ली।

बिना अव्यवस्था के कस्टमाइज़ेशन

सर्वर मालिक हर HUD तत्व को पुनःस्थित कर सकते हैं, रंग योजनाओं को बदल सकते हैं, और एक ही कॉन्फ़िग फ़ाइल से विशिष्ट हिस्सों को छिपा सकते हैं। लेकिन हम जानबूझकर थीम मार्केटप्लेस या उपयोगकर्ता-पक्ष की स्थिति नहीं भेजते, आप जो HUD बनाते हैं वही हर खिलाड़ी देखता है, जो आपके सर्वर की दृश्य भाषा को सुसंगत रखता है। सुसंगतता एक विशेषता है।

इंस्टॉलेशन & सेटअप

Agency-Hud में डेटाबेस की कोई निर्भरता नहीं है। Tebex से डाउनलोड करें, फ़ोल्डर को अपनी resources डायरेक्टरी में डालें और जोड़ें ensure agency-hud को server.cfg. रिसोर्स आपका फ्रेमवर्क स्वतः पहचानता है और स्वास्थ्य, कवच, भूख, और प्यास के मान उपयुक्त स्रोतों से खींचता है। standalone सेटअप के लिए, डेटा हुक चार config फ़ंक्शन हैं।

यदि आप मौजूदा HUD को बदल रहे हैं, तो पहले पुराने को अक्षम करें। अधिकांश HUD संघर्ष दो संसाधनों द्वारा एक ही स्क्रीन क्षेत्र में एक साथ ड्रॉ करने के कारण होते हैं। Agency-Hud में कोई हार्डकोडेड स्क्रीन क्षेत्र नहीं हैं, सभी स्थान कॉन्फ़िगर करने योग्य हैं, इसलिए यह आवश्यक होने पर विशिष्ट तृतीय-पक्ष ओवरले के साथ सह-अस्तित्व में रह सकता है।

कॉन्फ़िगरेशन विकल्प

यह config.lua लेआउट, दृश्य, और प्रदर्शन सेटिंग्स को कवर करता है:

  • तत्व की स्थिति , प्रत्येक HUD एलिमेंट के लिए X/Y स्थिति और एंकर पॉइंट व्यक्तिगत रूप से।
  • स्केल , वैश्विक स्केल फैक्टर और प्रति-तत्व स्केल ओवरराइड। अल्ट्रावाइड मॉनिटर उपयोगकर्ताओं के लिए उपयोगी।
  • कलर स्कीम", स्थिति संकेतकों के लिए प्राथमिक, चेतावनी, और गंभीर रंग। डिफ़ॉल्ट Agency के टील-आधारित पैलेट का पालन करता है।
  • हाई कंट्रास्ट मोड", पूर्व-निर्धारित रंग सेट जो कम कंट्रास्ट संवेदनशीलता वाले खिलाड़ियों के लिए अनुकूलित है।
  • कलरब्लाइंड मोड , स्टेटस इंडिकेटर रंगों के लिए ड्यूटेरनोपिया, प्रोटानोपिया, और ट्रिटानोपिया प्रीसेट।
  • स्तर दो की शर्तें , प्रत्येक संदर्भ तत्व (स्पीडोमीटर, वॉइस इंडिकेटर, आदि) को दिखाने की सटीक शर्तें परिभाषित करें।
  • मिनीमैप व्यवहार , हमेशा चालू, मूवमेंट पर टॉगल, या मैनुअल टॉगल केवल।
  • अपडेट दर , HUD कितनी बार मान परिवर्तनों के लिए पोल करता है। डिफ़ॉल्ट: 250ms (प्रदर्शन के लिए संतुलित)।

फ्रेमवर्क संगतता

Agency-Hud में QBCore और ESX डेटा अडैप्टर शामिल हैं। standalone के लिए, हेल्थ, आर्मर, भूख, प्यास, वॉइस रेंज और जॉब डेटा के लिए config फ़ंक्शन लागू करें। रेंडरिंग लेयर, एनिमेशन सिस्टम, टियर लॉजिक और एक्सेसिबिलिटी मोड पूरी तरह फ़्रेमवर्क से स्वतंत्र हैं। फ़्रेमवर्क बदलने के लिए केवल डेटा अडैप्टर बदलना पड़ता है, रिसोर्स को दोबारा इंस्टॉल करने की ज़रूरत नहीं।

क्यों यह रोलप्ले के लिए महत्वपूर्ण है

HUD वह एक UI तत्व है जो हमेशा स्क्रीन पर रहता है। फोन या टैबलेट के विपरीत जिसे खिलाड़ी जानबूझकर खोलता है, HUD परिवेशीय है, यह धारणा के किनारे पर रहता है और गेमप्ले के हर क्षण को प्रभावित करता है। एक खराब डिज़ाइन किया गया HUD हर खिलाड़ी के अनुभव पर लगातार कर है। एक अच्छा HUD अदृश्य होता है: जब आवश्यक हो मौजूद, जब न हो गायब, कभी भी बिना अर्जित ध्यान के लिए प्रतिस्पर्धा नहीं करता।

टियरड दृश्यता दृष्टिकोण मुख्य डिजाइन अंतर्दृष्टि है। टियर एक (हमेशा दिखाई देने वाला, छोटा) खिलाड़ियों को लगातार वह बताता है जो उन्हें जानना आवश्यक है: "क्या मैं मर रहा हूँ, क्या मैं भूखा हूँ, क्या मैं कवच पहने हूँ?" टियर दो (संदर्भात्मक, शर्त पर प्रकट) खिलाड़ियों को वह बताता है जो उन्हें स्थिति अनुसार जानना आवश्यक है: "मैं कितनी तेज़ी से जा रहा हूँ, क्या मेरा माइक्रोफोन चालू है?" टियर तीन (मांग पर) खिलाड़ियों को वह बताता है जो उन्हें कभी-कभी जानना आवश्यक है: "मेरी नौकरी की स्थिति क्या है, मेरी त्वरित पहुँच इन्वेंटरी में क्या है?"

Agency-Hud में सुलभता एक बाद की सोच नहीं है, यह एक प्रथम श्रेणी की चिंता है क्योंकि गेमिंग आबादी का एक महत्वपूर्ण हिस्सा रंग दृष्टि में किसी न किसी प्रकार का अंतर रखता है। एक HUD जो रंग अंध खिलाड़ियों के लिए पढ़ने योग्य नहीं है, केवल UX विफलता नहीं है; यह एक सुलभता विफलता है जो आपके सर्वर पर वास्तविक लोगों को प्रभावित करती है। प्रीसेट्स प्रदान करना कुछ भी खर्च नहीं करता और उन खिलाड़ियों के लिए बहुत मायने रखता है जिन्हें इसकी आवश्यकता है।

अक्सर पूछे जाने वाले प्रश्न

क्या प्लेयर्स अपनी खुद की HUD लेआउट कस्टमाइज़ कर सकते हैं?

नहीं, यह जानबूझकर है। सर्वर मालिक HUD लेआउट नियंत्रित करते हैं; खिलाड़ी नहीं। यह एक सामंजस्य निर्णय है: ऐसा सर्वर जहां हर खिलाड़ी का HUD अलग होता है, वह एक सामंजस्यपूर्ण दृश्य पहचान वाला सर्वर नहीं होता। यदि आप सीमित खिलाड़ी विकल्प (मिनिमैप टॉगल, आकार स्केल) देना चाहते हैं, तो ये विकल्प इन-गेम कमांड के रूप में उपलब्ध कराए जा सकते हैं जो खिलाड़ी पसंद तालिका में लिखते हैं।

क्या Agency-Hud डिफ़ॉल्ट FiveM मिनीमैप को बदलता है?

हाँ। यह एक कैनवास एलिमेंट पर अपना मिनीमैप रेंडर करता है जिसमें कॉन्फ़िगर करने योग्य ज़ूम और वेपॉइंट डिस्प्ले होता है। नेटिव मिनीमैप रिसोर्स स्टार्ट पर छुपा दिया जाता है। यदि आपको विशिष्ट नेटिव मिनीमैप व्यवहारों को बनाए रखना है (कुछ एंटीचीट टूल्स इसमें हुक करते हैं), तो एक Config.UseNativeMinimap = true विकल्प जो Agency-Hud के अन्य तत्वों के तहत मूल नक्शा को पुनः सक्षम करता है।

भीड़ वाले सर्वरों पर प्रदर्शन कैसा रहता है?

Agency-Hud डेल्टा रेंडरिंग का इस्तेमाल करता है, यह केवल उन HUD एलिमेंट को दोबारा ड्रॉ करता है जिनकी वैल्यू पिछले फ़्रेम के बाद बदली हो। 128-प्लेयर वाले व्यस्त सर्वर पर, आम तौर पर HUD का ड्रॉ कॉल हर फ़्रेम में 0.01-0.03ms लेता है। हमारे डॉक्यूमेंटेशन में बेंचमार्क तुलना दिखाती है कि समान परिस्थितियों में यह ज़्यादातर दूसरे HUD की तुलना में 3-5x कम है।

क्या मैं सर्वर-विशिष्ट मैकेनिक्स के लिए कस्टम HUD तत्व जोड़ सकता हूँ?

हाँ। उपयोग करें exports['agency-hud']:RegisterElement(id, options) कस्टम संकेतक जोड़ने के लिए। एक रेंडर फ़ंक्शन पास करें जिसे Agency-Hud अपने ड्रॉ लूप के दौरान कॉल करता है। आपके कस्टम तत्व टियर सिस्टम में भाग लेते हैं और सर्वर के रंग योजना का स्वचालित रूप से सम्मान करते हैं।

आवश्यकताएँ

  • FiveM सर्वर (QBCore, ESX, या standalone)
  • वैध Agency-Hud लाइसेंस के साथ cfx.re खाता
  • कोई डेटाबेस निर्भरता नहीं
  • वैकल्पिक: ox_lib (UI घटकों के लिए, फॉलबैक के साथ)

मेल खाता स्क्रिप्ट

आपके सर्वर के लिए तैयार, अपडेट शामिल हैं।

शुरू करने के लिए तैयार?

हमारी शॉप से स्क्रिप्ट लें, या सपोर्ट, अपडेट और आगे आने वाली चीज़ों की झलक के लिए Discord से जुड़ें।