# FAQ & Fehlerbehebung

## FJX CarHUD - FAQ & Fehlerbehebung

### 📝 Häufig gestellte Fragen

#### Allgemeine Fragen

**Was ist FJX CarHUD?**\
FJX CarHUD ist ein vollständig konfigurierbares, performanceoptimiertes FiveM HUD, das Geschwindigkeiten, Statusanzeigen und visuelle Elemente für Fahrzeuge anzeigt. Es ist mit allen Frameworks kompatibel und kann ohne Abhängigkeiten genutzt werden.

**Funktioniert es mit meinem Framework?**\
Ja, FJX CarHUD funktioniert mit jedem Framework (ESX, QBCore, vRP, QBus oder andere) ohne zusätzliche Konfiguration.

**Kann ich das HUD anpassen?**\
Ja, alle Farben, Größen, Positionen, Texte und Animationen sind über die `config.lua` vollständig anpassbar.

**Kann ich das HUD umschalten oder deaktivieren?**\
Ja, über die konfigurierbare Taste (Standard: F7) oder durch Anpassung der Position/Anzeige in der `config.lua`.

**Ist die Ressource leistungsoptimiert?**\
Ja, das HUD aktualisiert sich nur nach dem eingestellten Refresh-Intervall und läuft clientseitig, um Serverressourcen minimal zu belasten.

***

#### 🔧 Anpassungsfragen

**Wie ändere ich die Farben?**\
Ändere `Config.GradientColors` und `Config.TextColor` in der `config.lua`.

**Wie ändere ich Größe & Form der Bar?**\
Passe `Config.BarWidth`, `Config.BarHeight`, `Config.BorderRadius` und `Config.FontSize` an.

**Wie ändere ich die HUD-Position?**\
Nutze `Config.Position` und `Config.Margin` für die Positionierung auf dem Bildschirm.

**Wie passe ich MaxSpeed und RefreshRate an?**\
Ändere `Config.MaxSpeed` für die maximale Geschwindigkeit der Anzeige und `Config.RefreshRate` für die Aktualisierungsrate.

**Wie kann ich die Toggle-Taste ändern?**\
Passe `Config.ToggleKey` in der `config.lua` an.

***

#### ⚠️ Fehlerbehebung

**HUD wird nicht angezeigt**

* Prüfe, ob das Script korrekt in der `server.cfg` aktiviert ist (`ensure fjx_carhud`)
* Prüfe die Client-Konsole (F8) auf Fehler
* Stelle sicher, dass das Fahrzeug bewegt wird (HUD nur bei Fahrzeugen aktiv)

**Farben oder Layout werden falsch angezeigt**

* Überprüfe die CSS-Werte in `config.lua`
* Stelle sicher, dass alle Werte in korrektem Format (px, %, rgba, #hex) angegeben sind

**HUD aktualisiert sich nicht flüssig**

* Reduziere `Config.RefreshRate` für flüssigere Updates
* Prüfe, ob `Config.MaxSpeed` korrekt gesetzt ist

**Toggle-Funktion funktioniert nicht**

* Prüfe, ob `Config.ToggleKey` korrekt gesetzt ist
* Stelle sicher, dass keine anderen Ressourcen die gleiche Taste überschreiben

***

#### 💡 Leistungsoptimierung

* Deaktiviere komplexe Farbverläufe oder Schatten, falls Performance leidet
* Erhöhe `Config.RefreshRate`, um CPU-Last zu reduzieren
* Nutze die HUD-Anzeige nur im Fahrzeugmodus

***

#### 📞 Support

**Discord Support:** [**https://discord.gg/7uwQwp3NeP**](https://discord.gg/7uwQwp3NeP)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://fjx.gitbook.io/fjx-docs/car-hud/faq-and-fehlerbehebung.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.