Agency-Hud: Designprinzipien für das HUD, das sich jeder FiveM-Server wünscht

Das HUD-Problem

Das Standard-HUD von FiveM ist ein Desaster. Spieler haben am Ende ein halbes Dutzend widersprüchlicher Overlays, die um Platz auf dem Bildschirm konkurrieren, keine einheitliche Designsprache und wichtige Informationen, die unter dekorativem Schnickschnack begraben sind. Auf jedem Server, auf dem wir gespielt haben, gab es dasselbe Problem: zu viel HUD, zu wenig Übersicht. Agency-Hud wurde entwickelt, um das zu beheben.

Informationshierarchie

Wir haben HUD-Elemente in drei Ebenen unterteilt. Ebene eins ist immer sichtbar: Gesundheit, Rüstung, Hunger, Durst. Ebene zwei wird kontextabhängig angezeigt: Tacho beim Fahren, Sprachreichweitenanzeige beim Sprechen. Ebene drei ist bei Bedarf verfügbar: Minimap-Umschalter, Jobstatus, Inventar. Jede Ebene hat ihr eigenes visuelles Gewicht und wird sauber ein- und ausgeblendet. Nichts konkurriert um Aufmerksamkeit, außer es ist gerade wichtig.

Barrierefreiheit integriert

Ein Modus mit hohem Kontrast, anpassbare Größen und für Farbenfehlsichtigkeit geeignete Statusanzeigen sind direkt enthalten. 2026 ist das keine Option mehr: Zu deinen Spielern gehören Menschen mit unterschiedlichen Sehbedürfnissen, und ein professionelles HUD berücksichtigt das. Serverbesitzer können diese Standardeinstellungen für ihre Community anpassen.

Leistung bei Fahrzeug-Spawns

Die größte Leistungsfalle bei HUDs ist das Neuzeichnen während umfangreicher Fahrzeug- oder NPC-Spawns. Agency-Hud verwendet ein einzelnes Renderziel mit inkrementellen Updates. Wir zeichnen nur die geänderten Elemente neu, nicht das gesamte Overlay. Bei einem Überfall-Event auf einem Server mit 64 Spielern hat das HUD in unseren Benchmarks nur ein Zehntel der Leistung vergleichbarer Alternativen beansprucht.

Anpassung ohne Chaos

Serverbesitzer können jedes HUD-Element verschieben, Farbschemata austauschen und bestimmte Elemente über eine einzige Konfigurationsdatei ausblenden. Wir bieten aber bewusst weder einen Theme-Marktplatz noch eine Verschiebung durch einzelne Nutzer an: Das HUD, das du gestaltest, sehen alle Spieler. So bleibt die Designsprache deines Servers einheitlich. Einheitlichkeit ist ein Feature.

Installation & Einrichtung

Agency-Hud hat keine Datenbankabhängigkeit. Lade es von Tebex herunter, verschiebe den Ordner in dein resources-Verzeichnis und füge ensure agency-hud in server.cfg hinzu. Die Resource erkennt dein Framework automatisch und ruft die Werte für Gesundheit, Rüstung, Hunger und Durst aus den passenden Quellen ab. Bei standalone-Setups bestehen die Daten-Hooks aus vier config-Funktionen.

Wenn du ein bestehendes HUD ersetzt, deaktiviere zuerst das alte. Die meisten HUD-Konflikte entstehen, wenn zwei Resources gleichzeitig im selben Bildschirmbereich angezeigt werden. Agency-Hud verwendet keine fest codierten Bildschirmbereiche. Alle Positionen sind konfigurierbar, sodass es bei Bedarf mit bestimmten Overlays von Drittanbietern zusammenarbeiten kann.

Konfigurationsoptionen

Die config.lua deckt Layout-, Darstellungs- und Leistungseinstellungen ab:

• Elementpositionen, X/Y-Position und Ankerpunkt für jedes HUD-Element einzeln.
• Skalierung, globaler Skalierungsfaktor und individuelle Skalierungsoptionen für jedes Element. Nützlich für Nutzer von Ultrawide-Monitoren.
• Farbschema, Primär-, Warn- und kritische Farben für Statusanzeigen. Standardmäßig wird die türkisfarbene Farbpalette von Agency verwendet.
• Modus mit hohem Kontrast, vorkonfiguriertes Farbschema, optimiert für Spieler mit geringer Kontrastempfindlichkeit.
• Farbenblind-Modus, Voreinstellungen für Deuteranopie, Protanopie und Tritanopie bei den Farben der Statusanzeigen.
• Bedingungen für Stufe zwei, lege genau fest, unter welchen Bedingungen jedes kontextbezogene Element angezeigt wird (Tacho, Sprachchat-Anzeige usw.).
• Minimap-Verhalten, immer sichtbar, bei Bewegung einblenden oder nur manuell einblenden.
• Aktualisierungsrate, wie häufig das HUD nach Wertänderungen sucht. Standard: 250ms (ausgewogen für die Leistung).

Framework-Kompatibilität

Agency-Hud wird mit Datenadaptern für QBCore und ESX geliefert. Für standalone musst du config-Funktionen für Gesundheit, Rüstung, Hunger, Durst, Sprachreichweite und Jobdaten implementieren. Die Darstellungsebene, das Animationssystem, die Stufenlogik und die Barrierefreiheitsmodi sind vollständig frameworkunabhängig. Für einen Frameworkwechsel musst du nur den Datenadapter austauschen, nicht die Resource neu installieren.

Warum das für Roleplay wichtig ist

Das HUD ist das einzige UI-Element, das immer auf dem Bildschirm zu sehen ist. Anders als ein Smartphone oder Tablet, das ein Spieler gezielt öffnet, ist das HUD ständig präsent. Es befindet sich am Rand der Wahrnehmung und beeinflusst jeden Moment des Spiels. Ein schlecht gestaltetes HUD belastet das Spielerlebnis ständig. Ein gutes HUD ist unsichtbar: Es ist da, wenn es gebraucht wird, und verschwindet, wenn nicht. Es fordert nie Aufmerksamkeit, die es sich nicht verdient hat.

Der zentrale Designgedanke ist die gestaffelte Sichtbarkeit. Stufe eins (immer sichtbar, klein) zeigt Spielern, was sie ständig wissen müssen: „Sterbe ich gerade, habe ich Hunger, bin ich gepanzert?“ Stufe zwei (kontextbezogen, wird bei bestimmten Bedingungen angezeigt) zeigt Spielern, was sie gerade wissen müssen: „Wie schnell fahre ich, ist mein Mikrofon eingeschaltet?“ Stufe drei (bei Bedarf) zeigt Spielern, was sie gelegentlich wissen müssen: „Wie ist mein Jobstatus, was ist in meinem Schnellzugriff-Inventar?“

Barrierefreiheit ist bei Agency-Hud kein nachträglicher Gedanke, sondern ein grundlegender Bestandteil, denn ein erheblicher Teil der Gaming-Bevölkerung hat eine Form von Farbsehschwäche. Ein HUD, das für farbenblinde Spieler unlesbar ist, ist nicht nur ein UX-Fehler, sondern auch ein Barrierefreiheitsproblem, das echte Menschen auf deinem Server betrifft. Die Voreinstellungen anzubieten, kostet nichts und bedeutet den Spielern, die darauf angewiesen sind, viel.

Häufig gestellte Fragen

Können Spieler ihr HUD-Layout selbst anpassen?

Nein, das ist beabsichtigt. Die Serverbesitzer kontrollieren das HUD-Layout, nicht die Spieler. Das ist eine Entscheidung zugunsten eines einheitlichen Erscheinungsbilds: Ein Server, auf dem jeder Spieler ein anderes HUD-Layout hat, hat keine einheitliche visuelle Identität. Wenn du begrenzte Anpassungsmöglichkeiten anbieten möchtest (Minimap umschalten, Größe anpassen), kannst du diese Optionen als Ingame-Befehle bereitstellen, die in eine Spielereinstellungstabelle schreiben.

Ersetzt Agency-Hud die standardmäßige FiveM-Minimap?

Ja. Es zeigt eine eigene Minimap in einem Canvas-Element mit konfigurierbarem Zoom und Wegpunktanzeige an. Die native Minimap wird beim Start der Resource ausgeblendet. Wenn du bestimmte Funktionen der nativen Minimap beibehalten musst (manche Anticheat-Tools greifen darauf zu), gibt es eine Config.UseNativeMinimap = true Option, die die native Karte unter den anderen Elementen von Agency-Hud wieder einblendet.

Wie sieht die Leistung auf stark bevölkerten Servern aus?

Agency-Hud nutzt Delta-Rendering und zeichnet nur HUD-Elemente neu, deren Werte sich seit dem letzten Frame geändert haben. Auf einem ausgelasteten Server mit 128 Spielern dauert ein typischer HUD-Zeichenaufruf pro Frame 0.01-0.03ms. Der Benchmark-Vergleich in unserer Dokumentation zeigt, dass das unter identischen Bedingungen 3-5x weniger ist als bei den meisten alternativen HUDs.

Kann ich eigene HUD-Elemente für serverspezifische Mechaniken hinzufügen?

Ja. Verwende exports['agency-hud']:RegisterElement(id, options) um eigene Anzeigen hinzuzufügen. Übergib eine Render-Funktion, die Agency-Hud während seiner Zeichenschleife aufruft. Deine eigenen Elemente werden automatisch in das Stufensystem integriert und übernehmen das Farbschema des Servers.

Voraussetzungen

• FiveM-Server (QBCore, ESX oder standalone)
• cfx.re-Konto mit gültiger Agency-Hud-Lizenz
• Keine Datenbankabhängigkeit
• Optional: ox_lib (für UI-Komponenten, mit Fallback)