Agency-Hud: Her Sunucunun Gerçekten İstediği FiveM HUD İçin Tasarım Felsefesi

HUD Sorunu

Varsayılan FiveM HUD bir felakettir. Oyuncular ekran alanı için birbiriyle çelişen yarım düzine kaplama, tutarsız bir görsel dil ve gereksiz süslemelerin altına gömülmüş kritik bilgilerle baş başa kalır. Katıldığımız her sunucuda aynı sorun vardı: çok fazla HUD, çok az netlik. Agency-Hud bu sorunu çözmek için var.

Bilgi Hiyerarşisi

HUD ögelerini üç seviyeye ayırdık. Birinci seviye her zaman görünür: can, zırh, açlık, susuzluk. İkinci seviye duruma bağlı olarak gösterilir: araç kullanırken hız göstergesi, konuşurken ses menzili göstergesi. Üçüncü seviye isteğe bağlıdır: mini harita açıp kapatma, meslek durumu, envanter. Her seviyenin kendi görsel ağırlığı vardır ve ekrana sorunsuz bir şekilde girip çıkar. O an önemli olmadığı sürece hiçbir şey dikkat dağıtmaz.

Dahili Erişilebilirlik

Yüksek kontrast modu, yapılandırılabilir boyutlandırma ve renk körlerine uygun durum göstergeleri kullanıma hazır olarak gelir. Bu 2026 yılında bir seçenek değildir, oyuncularınız arasında çeşitli görsel ihtiyaçları olan kişiler bulunacaktır ve profesyonel bir HUD onlara uyum sağlar. Sunucu sahipleri toplulukları için bu varsayılanları açıp kapatabilir.

Araç Spawn Sırasında Performans

En büyük HUD performans tuzağı, yoğun araç veya NPC oluşumu sırasında yeniden çizim yapmaktır. Agency-Hud, delta güncellemelerine sahip tek bir render hedefi kullanır, tüm arayüzü değil yalnızca değişen kısımları yeniden çizeriz. 64 oyunculu bir sunucuda soygun etkinliği sırasında gerçekleştirdiğimiz kıyaslamalarda bu HUD, benzer alternatiflerin onda biri kadar kaynak tüketti.

Kaos Olmadan Özelleştirme

Sunucu sahipleri tek bir yapılandırma dosyasından her HUD ögesini yeniden konumlandırabilir, renk şemalarını değiştirebilir ve belirli parçaları gizleyebilir. Ancak kasıtlı olarak bir tema pazarı veya kullanıcı tarafı konumlandırma sunmuyoruz: Oluşturduğunuz HUD, her oyuncunun gördüğü HUD'dır ve bu da sunucunuzun görsel dilini tutarlı kılar. Tutarlılık bir özelliktir.

Kurulum & Yapılandırma

Agency-Hud veritabanı bağımlılığına sahip değildir. Tebex'ten indirin, klasörü resources dizininize atın ve şunu ekleyin: ensure agency-hud kime server.cfg. Resource, framework'ünüzü otomatik olarak algılar ve can, zırh, açlık ile susuzluk değerlerini uygun kaynaklardan çeker. Standalone kurulumlar için veri kancaları dört yapılandırma fonksiyonudur.

Mevcut bir HUD'ı değiştiriyorsanız önce eskisini devre dışı bırakın. Çoğu HUD çakışması, iki kaynağın aynı anda ekranın aynı bölgesine çizim yapmasından kaynaklanır. Agency-Hud sabit kodlanmış ekran bölgelerine sahip değildir, tüm konumlar yapılandırılabilir, bu nedenle gerektiğinde belirli üçüncü taraf katmanlarıyla bir arada çalışabilir.

Yapılandırma Seçenekleri

The config.lua düzen, görsel ve performans ayarlarını kapsar:

• Öğe pozisyonları, Her HUD ögesi için ayrı ayrı X/Y konumu ve sabitleme noktası.
• Ölçek, genel ölçek faktörü ve öge başına ölçek geçersiz kılmaları. Ultra geniş monitör kullanıcıları için faydalıdır.
• Renk şeması, durum göstergeleri için birincil, uyarı ve kritik renkler. Varsayılan olarak Agency'nin camgöbeği tabanlı paletini izler.
• Yüksek kontrast modu, düşük kontrast hassasiyetine sahip oyuncular için optimize edilmiş, önceden yapılandırılmış renk seti.
• Renk körlüğü modu, durum göstergesi renkleri için deuteranopi, protanopi ve tritanopi ön ayarları.
• İkinci kademe koşulları, her bir bağlamsal ögenin (hız göstergesi, ses göstergesi vb.) tam olarak hangi koşullarda gösterileceğini tanımlayın.
• Minimap davranışı, her zaman açık, harekette aç/kapat veya yalnızca manuel aç/kapat.
• Güncelleme sıklığı, HUD'ın değer değişikliklerini ne sıklıkla sorgulayacağı. Varsayılan: 250ms (performans için dengelenmiş).

Framework Uyumluluğu

Agency-Hud, QBCore ve ESX veri bağdaştırıcılarıyla birlikte gelir. Standalone için can, zırh, açlık, susuzluk, ses menzili ve meslek verilerine yönelik config fonksiyonlarını uygulayın. Render katmanı, animasyon sistemi, aşama mantığı ve erişilebilirlik modları tamamen framework bağımsızdır. Framework değiştirmek, resource'u yeniden yüklemeyi değil, yalnızca veri bağdaştırıcısını değiştirmeyi gerektirir.

Roleplay İçin Bu Neden Önemli

HUD, ekranda sürekli bulunan tek arayüz öğesidir. Oyuncunun bilerek açtığı bir telefon veya tabletin aksine HUD ortamın bir parçasıdır: algının sınırında yaşar ve oyunun her anını etkiler. Kötü tasarlanmış bir HUD, her oyuncunun deneyimini sürekli baltalar. İyi bir HUD ise görünmezdir: gerektiğinde vardır, gerekmediğinde kaybolur ve hak etmediği bir ilgiyi asla çekmeye çalışmaz.

Kademeli görünürlük yaklaşımı, temel tasarım anlayışıdır. Birinci kademe (her zaman görünür, küçük), oyunculara sürekli bilmeleri gerekenleri söyler: "ölüyor muyum, aç mıyım, zırhım var mı?" İkinci kademe (bağlamsal, duruma göre görünür), oyunculara duruma göre bilmeleri gerekenleri söyler: "ne kadar hızlı gidiyorum, mikrofonum açık mı?" Üçüncü kademe (isteğe bağlı), oyunculara ara sıra bilmeleri gerekenleri söyler: "meslek durumum nedir, hızlı erişim envanterimde ne var?"

Agency-Hud içinde erişilebilirlik sonradan akla gelen bir detay değil, birinci sınıf bir önceliktir; çünkü oyuncu kitlesinin önemli bir bölümünde bir tür renk görme farklılığı vardır. Renk körü oyuncular için okunamayan bir HUD yalnızca bir UX hatası değil, sunucunuzdaki gerçek insanları etkileyen bir erişilebilirlik sorunudur. Hazır ayarları sunmak hiçbir maliyet getirmez ve bunlara ihtiyaç duyan oyuncular için çok şey ifade eder.

Sıkça Sorulan Sorular

Oyuncular kendi HUD düzenlerini özelleştirebilir mi?

Hayır, bu kasıtlıdır. HUD düzenini sunucu sahipleri kontrol eder, oyuncular değil. Bu bir tutarlılık kararıdır: her oyuncunun farklı bir HUD düzenine sahip olduğu bir sunucu, tutarlı bir görsel kimlikten yoksundur. Oyunculara sınırlı seçenekler sunmak isterseniz (minimap'i açıp kapatma, boyutu ölçeklendirme), bu seçenekler bir oyuncu tercih tablosuna yazan oyun içi komutlar olarak sunulabilir.

Agency-Hud varsayılan FiveM minimap'inin yerini alır mı?

Evet. Yapılandırılabilir yakınlaştırma ve rota noktası gösterimi ile kendi minimap'ini bir canvas ögesi üzerinde işler. Yerel minimap, resource başlatıldığında gizlenir. Belirli yerel minimap davranışlarını korumanız gerekirse (bazı anticheat araçları buna bağlanır), bir Config.UseNativeMinimap = true Agency-Hud'ın diğer öğelerinin altında yerel haritayı yeniden etkinleştiren seçenek.

Kalabalık sunucularda performans nasıl korunur?

Agency-Hud delta render kullanır, yalnızca son kareden bu yana değerleri değişen HUD öğelerini yeniden çizer. 128 oyunculu kalabalık bir sunucuda tipik HUD draw call süresi kare başına 0.01-0.03 ms sürer. Belgelerimizdeki benchmark karşılaştırması, bunun aynı koşullar altında çoğu alternatif HUD'a göre 3-5 kat daha düşük olduğunu göstermektedir.

Sunucuya özel mekanikler için özel HUD ögeleri ekleyebilir miyim?

Evet. Şunu kullanın: exports['agency-hud']:RegisterElement(id, options) özel göstergeler eklemek için. Agency-Hud'ın çizim döngüsü sırasında çağıracağı bir render fonksiyonu iletin. Özel öğeleriniz kademe sistemine dahil olur ve sunucunun renk düzenine otomatik olarak uyum sağlar.

Gereksinimler

• FiveM sunucusu (QBCore, ESX veya standalone)
• geçerli Agency-Hud lisansına sahip cfx.re hesabı
• Veritabanı bağımlılığı yok
• İsteğe bağlı: ox_lib (UI bileşenleri için, geri dönüş mekanizması mevcuttur)