Pepper HUD

Cleanes, modernes HUD mit 3 Stilen und Ingame-Editor – ESX & QBCore.

Überblick

Pepper HUD zeigt alles, was Spieler brauchen – Status, Geld, Job, Kompass, Munition und einen Tacho mit Gurt und Tempomat. Jeder Spieler richtet es über /hud selbst ein: Stil (Ringe, Balken, Pillen), Farben, Größe, sichtbare Elemente und Position. Gespeichert wird lokal pro Spieler, eine Datenbank ist nicht nötig.

Features

• 3 umschaltbare Stile – Ringe, Balken und Pillen
• Ingame-Menü /hud mit Live-Vorschau: Stil, Akzentfarbe, Farbmodus, Größe, Deckkraft, jedes Element ein-/ausschaltbar
• Elemente mit der Maus frei verschieben, gespeichert pro Spieler
• Leben, Rüstung, Hunger, Durst, Ausdauer, Sauerstoff, Sprachchat (pma-voice und SaltyChat) inklusive Funk
• Bargeld, Bank, Schwarzgeld (ESX) mit Plus/Minus-Animation, Job und Rang, Spieler-ID, Uhrzeit
• Kompass mit Straße und Gebiet, Munitionsanzeige
• Tacho mit Drehzahl, Gang, Tank, Motorzustand, Licht und Verriegelung (km/h oder mph)
• Gurt mit Herausschleudern bei Unfällen und Tempomat
• Kinomodus und eckige oder runde Minimap
• Anzeige nur bei Bedarf (z. B. Rüstung nur, wenn du welche hast)
• Optional (ab der nächsten Version, im Code schon enthalten): Wetter und Temperatur mit Pepper Weather, Sauberkeit der Kleidung mit Pepper Laundry
• Sendet nur geänderte Werte an die Oberfläche
• Deutsch und Englisch; Config, Locales und Framework-Bridge offen

Voraussetzungen

Installation

1. Ressource aus dem Cfx.re Portal (https://portal.cfx.re/assets/granted-assets) herunterladen.
2. Nach resources/[pepper]/pepper_hud entpacken. Den Ordnernamen pepper_hud nicht umbenennen – Escrow und Exports (exports.pepper_hud:…) hängen am Namen.
3. In der server.cfg nach dem Framework (und ggf. Voice- und Tank-Script) starten:

   ensure es_extended   # bzw. qb-core
   ensure esx_status    # nur ESX
   ensure pma-voice     # optional
   ensure pepper_hud
   

4. Andere HUDs deaktivieren (esx_hud, qb-hud, ps-hud …), sonst überlagern sich zwei HUDs.
5. Nur QBCore: Gurt/Tempomat aus qb-smallresources abschalten oder Config.Seatbelt.enabled / Config.Cruise.enabled auf false setzen.
6. Englische Texte: Config.Locale = 'en' in config/config.lua. Eine Datenbank oder Items gibt es nicht.

Erster Test

1. Einloggen – unten erscheinen Status-Anzeigen, oben rechts Geld, Job, ID und Uhrzeit.
2. /hud eingeben: Stil auf Balken umstellen und eine andere Akzentfarbe wählen – die Vorschau ändert sich sofort.
3. In ein Auto steigen und B drücken (Gurt-Klick), dann ab 30 km/h Y für den Tempomat; Bremsen beendet ihn.
4. /cinema eingeben – HUD und Minimap verschwinden, schwarze Balken erscheinen; noch einmal /cinema zum Beenden.
5. Nach einem Reconnect sind deine /hud-Einstellungen noch da.

Konfiguration

Das sind Server-Vorgaben – vieles davon können Spieler über /hud für sich ändern (lokal auf ihrem PC gespeichert, pro Server). Neue Spieler starten mit Config.Defaults.

Allgemein

Befehle und Tasten

Config.Commands = { menu = 'hud', cinema = 'cinema', seatbelt = 'seatbelt', cruise = 'cruise' }
Config.Keys = { seatbelt = 'B', cruise = 'Y', cinema = '' }

Die Tasten sind Standardwerte; Spieler ändern sie unter Einstellungen → Tastenbelegung → FiveM.

Gurt und Tempomat

Minimap, Tank und Leistung

Config.GetFuel = function(vehicle)
    local state = Entity(vehicle).state.fuel
    if type(state) == 'number' then return state end
    return GetVehicleFuelLevel(vehicle)
end

Menü-Rechte und Startwerte

Nutzung im Spiel

Im Layout-Modus des Menüs ziehst du Elemente mit der Maus an eine beliebige Stelle; Zurücksetzen stellt das Standard-Layout wieder her. Der Gurt gilt nicht für Motorräder, Fahrräder, Boote, Helikopter, Flugzeuge und Züge. Der Tempomat geht nur als Fahrer; Bremsen, Handbremse oder deutliches Langsamerwerden beenden ihn.

Befehle und Rechte

Rechte (ACE/Gruppen) gibt es keine; was Spieler ändern dürfen, steuerst du über Config.Menu. Die Befehlsnamen änderst du in Config.Commands.

Exports und Events

Alle Exports laufen auf dem Client:

exports.pepper_hud:setVisible(false)
if exports.pepper_hud:isSeatbeltOn() then … end

FAQ

Zwei HUDs auf dem Bildschirm – was tun?

Deaktiviere andere HUDs (esx_hud, qb-hud, ps-hud …) in der server.cfg. Es darf nur ein HUD laufen.

Zwei Gurte oder Tempomaten (QBCore)?

Schalte sie in qb-smallresources ab oder setze Config.Seatbelt.enabled / Config.Cruise.enabled auf false.

Hunger und Durst bleiben leer (ESX)?

Unter ESX braucht Pepper HUD esx_status für Hunger und Durst. Starte es vor pepper_hud.

Geld, Job und Hunger fehlen komplett?

Dann wurde kein Framework erkannt (in der F8-Konsole steht ein Hinweis). Starte pepper_hud nach es_extended bzw. qb-core oder setze Config.Framework fest auf 'esx' oder 'qbcore'.

Der Tank zeigt immer 0 oder 100?

Passe Config.GetFuel an dein Tank-Script an, z. B. return exports['LegacyFuel']:GetFuel(vehicle).

Die Minimap sieht falsch aus?

Ein anderes Script steuert die Minimap – setze Config.Minimap.managed = false, dann fasst das HUD sie nicht an.

Spieler können den Stil oder die Farben nicht ändern?

Prüfe Config.Menu (allowStyle, allowColors, allowLayout). Gesperrte Bereiche werden immer auf die Vorgabe aus Config.Defaults gesetzt.

Wo werden die Spieler-Einstellungen gespeichert?

Lokal auf dem PC des Spielers (KVP), pro Server. Eine Datenbank wird nicht benötigt.

Welche Voice-Systeme werden unterstützt?

pma-voice und SaltyChat – beide werden automatisch erkannt (Config.Voice = 'auto'). Mit 'none' blendest du die Sprachanzeige aus.

Wie blende ich das HUD für mein Handy- oder Kamera-Script aus?

Ruf auf dem Client exports.pepper_hud:setVisible(false) und danach setVisible(true) auf.

Wie ändere ich die Farben für alle neuen Spieler?

Config.Defaults.accent und colorMode setzen die Startwerte, Config.Colors die Farben der einzelnen Anzeigen, Config.AccentPresets die Auswahl im Farbwähler. Spieler mit eigenen Einstellungen behalten ihre Wahl.

Wie binde ich ein eigenes Status- oder Geldsystem an?

Die Bridge-Dateien bridge/client/esx.lua und bridge/client/qbcore.lua sind offen. Dort liest das HUD Geld, Job und Status – passe die Events bzw. Abfragen an dein System an.

Wie update ich Pepper HUD?

Neue Version aus dem Cfx.re Portal laden, config/config.lua und geänderte Bridge- oder Sprachdateien sichern und den Ordner ersetzen. Die Spieler-Einstellungen bleiben erhalten. Änderungen stehen in der CHANGELOG.md im Ressourcen-Ordner.

Support

Fragen oder Fehler? Öffne ein Ticket in unserem Discord: https://discord.gg/6NaFJWKDYu – verknüpfe deinen Kauf vorher mit /verify.

Permanent auf dem Dev-Server von Pepper Scripts getestet.

Changelog

Aktuelle Version 1.0.0 (erste Version). In Arbeit: optionale Wetter-Anzeige mit Pepper Weather und Kleidungs-Anzeige mit Pepper Laundry. Alle Änderungen stehen in der CHANGELOG.md im Ressourcen-Ordner.

Fehler gefunden? Melde ihn im Discord.