# Final HUD v1.0.0

Final HUD ist ein anpassbares FiveM HUD für ESX mit integriertem Fahrzeug-HUD, CarPlay, stufenloser Sprachreichweite und eigenem `/hud`-Editor.

## Installation

1. Den Ordner `final_hud` in den Resources-Ordner legen.

2. Andere HUD-Ressourcen deaktivieren, wenn sie dieselben GTA-HUD-Komponenten oder die Minimap verändern.

3. In der `server.cfg` eintragen:

```cfg

ensure final_hud

```

## Befehle

- `/hud` öffnet den HUD-Editor.

- `/togglehud` blendet das HUD ein oder aus.

- `/cinematic` aktiviert oder deaktiviert den Cinematic-Modus.

- `/resethud` setzt Layout und Einstellungen zurück.

- `/carplay` öffnet oder schließt den CarPlay-Mausmodus im Fahrzeug.

## Standard-Steuerung

- `B` Sicherheitsgurt

- `Y` Tempomat

- `Pfeil links` Blinker links

- `Pfeil rechts` Blinker rechts

- `Pfeil runter` Warnblinker

- `CAPSLOCK` CarPlay-Mausmodus

- `ALT + Mausrad` Sprachreichweite stufenlos ändern

FiveM speichert KeyMappings clientseitig. Bereits vom Spieler geänderte Tasten können deshalb von den Standardwerten in der `config.lua` abweichen.

## Adaptive Ansicht

Wenn die adaptive Ansicht im `/hud`-Menü aktiviert ist:

- Ausdauer erscheint beim Sprinten oder wenn sie nicht voll ist.

- Sauerstoff erscheint nur unter Wasser.

- Stress erscheint erst ab einem relevanten Wert.

- Rüstung wird bei `0` ausgeblendet.

- Munition erscheint bei gezogener Waffe nur beim Zielen, Schießen oder Nachladen.

## Sprachreichweite

Mit `ALT + Mausrad` kann die pma-voice-Reichweite stufenlos zwischen den in `Config.VoiceRange` eingestellten Grenzen verändert werden. Während der Änderung wird die Reichweite als animierter Kreis in der Spielwelt angezeigt. Die gewählte Reichweite kann per KVP gespeichert werden.

## CarPlay

CarPlay ist direkt in das HUD integriert und benötigt kein xSound.

- Positionsgebundene Musik am Fahrzeug

- YouTube-Links und direkte browserfähige Audio-Links

- Lautstärke, Pause, Fortsetzen und Stop

- Nächste Tankstelle als GPS-Ziel

- Nächster Shop als GPS-Ziel

- Fahrzeug-Schnellmenü für Motor, Licht, Warnblinker, Verriegelung, Türen, Motorhaube, Kofferraum und Fenster

- Passagiere können Media und Navigation verwenden

- Fahrzeugsteuerungen können mit `Config.CarPlay.Vehicle.DriverOnlyControls` auf den Fahrer beschränkt werden

Tankstellen und Shops werden unter `Config.CarPlay.Places` gepflegt.

## Serverlogo und Branding

Ein eigenes Logo kann unter zum Beispiel `html/img/server_logo.png` abgelegt werden.

```lua

Config.Branding = {

    ServerName = 'MEIN SERVER',

    HudTitle = 'SERVER HUD',

    HudSubtitle = 'PLAYER CUSTOMIZER',

    UseImage = true,

    ImagePath = 'img/server_logo.png',

    FallbackText = 'MS',

    UseOnPlayerCard = true,

    UseOnCarPlay = true,

    UseOnEditor = true

}

```

Wenn das Bild fehlt oder `UseImage = false` gesetzt ist, wird automatisch `FallbackText` verwendet.

## Bargeld / ox_inventory

Das HUD kann Bargeld sowohl aus ESX als auch als `ox_inventory`-Item lesen. Standardmäßig steht die Erkennung auf `auto`:

```lua

Config.Money = {

    CashType = 'auto',

    CashItem = 'money',

    OxInventoryResource = 'ox_inventory'

}

```

- `auto`: nutzt `ox_inventory`, wenn die Resource läuft und der Export verfügbar ist, sonst ESX.

- `esx`: nutzt ausschließlich normales ESX-Bargeld.

- `ox_inventory`: nutzt das konfigurierte Inventory-Item als Bargeld.

Der Bankwert bleibt unabhängig davon der normale ESX-Account `bank`.

## Unterstützt

- ESX automatische Erkennung

- ESX-Bargeld und ox_inventory-Bargelditems

- `esx_status` für Hunger, Durst und optional Stress

- `pma-voice` für Sprachreichweite und Funkstatus

- Native FiveM Fahrzeugdaten

- RP-Name über ESX

- Spielerbezogene HUD-Einstellungen über KVP

- Import und Export von HUD-Einstellungen

## Events und Exports

```lua

TriggerEvent('nik:final_hud:setStatus', 'stress', 35)

TriggerEvent('nik:final_hud:notify', {

    title = 'Final HUD',

    message = 'Nachricht',

    type = 'info'

})

exports['final_hud']:SetStatus('stress', 35)

exports['final_hud']:SetVisible(true)

exports['final_hud']:Notify({

    title = 'Final HUD',

    message = 'Nachricht',

    type = 'info'

})

```

## HUD-Editor

Im `/hud`-Menü können Verhalten, Module, Layout, Farben, Transparenz und Import/Export eingestellt werden. Die Sprachleiste ist fest an den Map-/Statusrahmen gekoppelt und wird deshalb nicht mehr frei im Layout-Modus verschoben.

- Mikrofon-Mute mit visueller STUMM-Anzeige; Standardtaste M, über FiveM Key Bindings änderbar.

- Bei stummgeschaltetem Mikrofon wird der Sprachreichweiten-Effekt rot dargestellt.

## PMA Voice

Das HUD ist für das originale `pma-voice` ausgelegt. Die Voice-Anbindung ist bereits so vorbereitet, dass eine zukünftige kompatible FINAL-Development-Erweiterung durch Austausch der `pma-voice`-Ressource verwendet werden kann. Die vorhandenen HUD-Einstellungen bleiben dabei erhalten.