# FAQ & Fehlerbehebung

## FJX SpeedLimit - FAQ & Fehlerbehebung

### 📝 Häufig gestellte Fragen

#### Allgemeine Fragen

**Was ist FJX SpeedLimit?**\
FJX SpeedLimit ist ein vollständig konfigurierbares, performanceoptimiertes FiveM Skript, das aktuelle Geschwindigkeitsbegrenzungen auf Straßen visuell anzeigt. Es funktioniert mit allen Frameworks und benötigt keine Abhängigkeiten.

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

**Kann ich eigene Straßen und Limits hinzufügen?**\
Ja, du kannst weitere Straßen in `Config.StreetSpeedLimits` hinzufügen und ein entsprechendes Limit zuweisen. Beispiel:

```lua
Config.StreetSpeedLimits["Neue Straße"] = 50
```

**Kann ich neue Tempolimit-Bilder hinzufügen?**\
Ja, neue Bilder können im Ordner `html/img/` abgelegt werden. Achte darauf, dass der Dateiname in `Config.SpeedImages` korrekt hinterlegt wird. Beispiel:

```lua
Config.SpeedImages[90] = "90.png"
```

**Kann ich die Anzeige deaktivieren oder umschalten?**\
Ja, du kannst das HUD über ein eigenes Command (`/street`) oder durch Anpassungen in der `config.lua` steuern.

**Ist die Ressource leistungsoptimiert?**\
Ja, die Anzeige aktualisiert sich nur nach dem eingestellten `UpdateInterval` und läuft clientseitig, um Serverressourcen minimal zu belasten.

***

### 🔧 Anpassungsfragen

**Wie ändere ich die Wartezeit für die Anzeige?**\
Passe `Config.WaitForTime` (in Millisekunden) an, um die Verzögerung vor der Anzeige zu verändern.

**Wie ändere ich das Update-Intervall?**\
Passe `Config.UpdateInterval` (in Millisekunden) an. Niedrigere Werte = flüssiger, höhere Werte = weniger Performance-Last.

**Wie passe ich Notification-Systeme an?**

* `Config.NotificationSystem` kann auf `"esx"`, `"qb"`, `"mythic"`, `"custom"`, `"native"` oder `"disabled"` gesetzt werden.
* Für `"custom"` das Event in `Config.CustomNotificationEvent` hinterlegen.
* Dauer, Typ und Titel lassen sich in `Config.NotificationSettings` anpassen.

**Wie ändere ich die Position und Größe der Anzeige?**

* `Config.DisplayPosition` legt die Position (bottom, top, left, right) fest.
* `Config.DisplaySize` legt Breite und Höhe der Anzeige fest.
* `Config.FadeSpeed` steuert die Geschwindigkeit des Ein-/Ausblendens.

***

### ⚠️ Fehlerbehebung

**Anzeige wird nicht angezeigt**

* Prüfe, ob das Script korrekt in `server.cfg` aktiviert ist (`ensure fjx_speedlimit`)
* Prüfe die Client-Konsole (F8) auf Fehler
* Stelle sicher, dass du dich auf einer Straße befindest, die in `Config.StreetSpeedLimits` hinterlegt ist

**Falsche Bilder oder Layout-Probleme**

* Prüfe, ob die Bilddateien korrekt im Ordner `html/img/` liegen
* Prüfe, ob die Pfade in `Config.SpeedImages` korrekt hinterlegt sind
* Überprüfe CSS-Werte in `config.lua` (z. B. px, %, rgba, #hex)

**Notification wird nicht angezeigt**

* Prüfe, ob das gewählte Notification-System korrekt gesetzt ist
* Bei `"custom"`: Stelle sicher, dass das Event existiert und korrekt getriggert wird

**Updates laufen nicht flüssig**

* Reduziere `Config.UpdateInterval` für flüssigere Updates
* Prüfe, ob die Anzeige korrekt auf die Straßen reagiert

***

### 💡 Leistungsoptimierung

* Erhöhe `Config.UpdateInterval`, um CPU-Last zu reduzieren
* Deaktiviere unnötige Notifications, falls Performance leidet
* Halte die Anzahl der aktiven Straßen und Bilder überschaubar für maximale Performance

***

### 📞 Support

* Discord Support: <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/speedlimit/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.